Activation

Infrastructure and enterprise activation
After a 
BlackBerry Dynamics
 app is installed on a user’s device, the user must activate the app in order to use it. The activation process registers the app with the management server and gives the app access to the full capabilities of the 
BlackBerry Dynamics
 platform. The activation process ensures that all end users are fully authorized and permitted to use the app.
Users can activate a 
BlackBerry Dynamics
 app manually using an access key provided by the administrator, by using the 
UEM Client
, or by using the Easy Activation feature described below.
For more information about activating 
BlackBerry Dynamics
 apps, see the Activation section in the GDAndroid class reference or GDiOS class reference and Managing BlackBerry Dynamics apps in the 
UEM Administration Guide
.
Easy Activation
 
Easy Activation simplifies the process of activating multiple 
BlackBerry Dynamics
 apps on a user’s device. With Easy Activation, a device user only needs to activate the first 
BlackBerry Dynamics
 app on their device using an access key or the 
UEM Client
; when the user installs additional 
BlackBerry Dynamics
 apps, the user can choose to delegate the activation process to the previously activated app. Any 
BlackBerry Dynamics
 app can be an activation delegate, but priority is given to the app that is configured as the authentication delegate.
Easy Activation is automatically enabled for all 
BlackBerry Dynamics
 apps that are produced by 
BlackBerry
. To enable Easy Activation for your custom 
BlackBerry Dynamics
 app, the 
UEM
 or standalone 
Good Control
 administrator must specify the app package ID (
Android
) or bundle ID (
iOS
) in the 
BlackBerry Dynamics
 app settings in the management console. Contact your organization’s administrator to provide this information. For instructions for specifying the package ID or bundle ID for an app, see Manage settings for a BlackBerry Dynamics app in the 
UEM Administration Guide
.
On the application side, Easy Activation is enabled by default by the 
BlackBerry Dynamics Runtime
.
For more information, see the Easy Activation section in the BlackBerry Dynamics Security White Paper.
Programmatic activation
The programmatic activation feature enables a 
BlackBerry Dynamics
 app to activate without any user interaction and without displaying activation prompts or progress screens. This can be useful when targeting your apps to a consumer audience or for developing apps for devices that have limited or no means of user input.
For more information about programmatic activation, see 
programmaticActivityInit
 in the BlackBerry Dynamics SDK for Android API Reference or 
programmaticAuthorize
 in the BlackBerry Dynamics SDK for iOS API Reference.
Note the following implementation details:
  • Decide whether you want users to specify a password to unlock a 
    BlackBerry Dynamics
     app after the initial activation. You can use programmatic activation while still requiring users to type a password to unlock the app. This setting is configured in a 
    BlackBerry Dynamics
     profile in 
    UEM
    .
  • To activate the app, your application server must use the BlackBerry Web Services REST APIs to retrieve the user credentials and to generate an access key. You may need to create a new 
    UEM
     user account or to lookup an existing user account. See the User resource in the BlackBerry Web Services REST API reference for the available REST APIs that can be used to create a user, lookup a user, and to generate an access key.
  • Pass the user credentials to the app and call 
    programmaticActivityInit
     or 
    programmaticAuthorize
     with the retrieved credentials, setting 
    ShowUserInterface
     to false.
  • For 
    Android
    , receive the broadcast event 
    GD_STATE_ACTIVATION_ACTION
     to track activation progress from 
    NotActivated
     to 
    InProgress
     to 
    Activated
    . You can choose to display a progress indicator during this short period.
  • For 
    iOS
    , observe 
    GDState.BBActivationState
     to track activation progress from 
    NotActivated
     to 
    InProgress
     to 
    Activated
    . You can choose to display a progress indicator during this short period.
  • Once activation completes, the user is prompted to set a password (unless you’ve configured the 
    BlackBerry Dynamics
     profile to not require a password). The app should wait for the 
    GD_STATE_AUTHORIZED_ACTION
     notification.
  • You can use 
    configureUI
     (Android/iOS) to customize the UI of the password screen (for example, with a custom logo and colors).