Data flow: Activating a BlackBerry
Dynamics app for the first time on a device
BlackBerry
Dynamics
app for the first time on a deviceThis data flow describes how data travels when a
BlackBerry
Dynamics
app is activated on a device and no other BlackBerry
Dynamics
app (including the BlackBerry UEM Client
) has been activated yet.
- An administrator performs the following actions:
- Assigns one or moreBlackBerry Dynamicsapps to a user.
- Issues activation credentials (access key, activation password, or QR code) or using a third-party identity provider, and sends them to the user or instructs the user to generate credentials fromBlackBerry UEM Self-Service.
- The user performs the following actions:
- Installs the app on the device.
- Obtains and enters the provided activation credentials.
- TheBlackBerry Dynamicsapp performs the following actions:
- The app registers itself with theBlackBerry Dynamics NOCand receives an ID thatUEMcan later use to confirm with theBlackBerry Dynamics NOCthat the app was successfully activated.
- Obtains theUEMaddress using one of the following methods:
- If the user manually entered the credentials, the app fetches the address from theBlackBerry Infrastructure.
- If the user scanned a QR Code, the app receives the address from the QR code.
- Connects toUEMthrough theBlackBerry Infrastructureand establishes an end-to-end encrypted session withUEMusing the EC-SPEKE protocol.This session can only be decrypted by theUEMinstance that issued the activation credentials.
- Sends the activation request over the secured session.
- UEMverifies the activation request and sends encrypted activation response to the app. The activation response includes data required by the app to communicate withUEM, including a client certificate, master session key, list ofBlackBerry Proxyinstances, and trusted certificate authorities.UEMconnects to theBlackBerry Dynamics NOCand notifies it that theBlackBerry Dynamicsapp (as identified by the unique ID from step 3) is successfully activated.
- The app prompts the user to set a password. Since the activatedBlackBerry Dynamicsapp has been registered with theBlackBerry Dynamics NOC, it can now be used as the easy activation delegate to activate subsequentBlackBerry Dynamicsapps on the device.