Configuring the BlackBerry Dynamics SDK options

In an app security profile, set these options for the BlackBerry Dynamics SDK. (See Configuring app security profiles for general information about managing profiles.)

Click Policies, then click Create New App Security Profile or click on the name of an existing profile to edit it. If you're adding a new profile, give it a name.

On the policy details page, select the BlackBerry Dynamics SDK tab and enable the BlackBerry Dynamics SDK.

Configure App Details:

Proxy optionDetails
GD App Version

BlackBerry app entitlement version from BlackBerry UEM.

GD App ID

BlackBerry app entitlement ID from BlackBerry UEM. The general form of an entitlement ID is company_name.app_name, using reverse domain name form, for example, com.qwe.example.

Configure Advanced Settings & Troubleshooting:

Advanced optionDetails
Network Interception

Enable Network Interception to allow the BlackBerry SDKs and the app's native network routing to work together smoothly. This setting allows BlackBerry Dynamics to provide its security without interfering with specific app functionality.

Secure Storage

Enable Secure Storage to protect each piece of app data before saving it on the mobile device, shielding it from malware, rogue apps, and hackers who attack the device storage.

GD Library Mode

Choose the mode:

  • GD Enterprise Simulation (Android only): Suitable for development. Does not require a valid activation key to open the app, does not communicate directly with BlackBerry Dynamics servers, and the app cannot be run on a physical device, but you can verify proper execution and behavior of your BlackBerry Dynamics settings. See Using enterprise simulation mode (Android).
  • GD Enterprise: Suitable for production and deployment.
GD Console Logger Filter

Choose the severity level of activity messages to log. In order of increasing verbosity (where debug is the most verbose and error the least):

  • Error
  • Warning
  • Info
  • Debug
App launch applicationId rewrite(Android only) In certain circumstances, if an app is designed to launch another app with a hard-coded package name, the launch can fail because the app ID changes when integrated. In these cases, use this option to replace the original app ID of the target app with the GD App ID of the target app (as shown in BlackBerry UEM). The app security profile applied to the source app (the app that launches target apps) must include such an entry for each target app.

Click Save changes.

Enabling BlackBerry AppConfig

To enable the option for the BlackBerry AppConfig:

On the policy details page, select the BlackBerry AppConfig tab and enable it.

Click Save changes.

Notes about using BlackBerry AppConfig:

On the Blue Cedar Platform:

  • BlackBerry AppConfig requires BlackBerry Dynamics to be enabled. 

BlackBerry administrators:

Enabling BlackBerry Launcher

To include the BlackBerry Launcher library:

On the policy details page, select the BlackBerry Launcher tab and enable it.

Click Save changes.

Notes about using BlackBerry Launcher:

On the Blue Cedar Platform:

  • BlackBerry Launcher requires BlackBerry Dynamics to be enabled.
  • Enabling BlackBerry Launcher includes the BlackBerry Dynamics Launcher Library in BlackBerry-secured apps, which allows BlackBerry UEM administrators to enable the apps for the Launcher.

BlackBerry administrators, within BlackBerry UEM:

Choose your custom BlackBerry Dynamics app.

On the BlackBerry Dynamics tab, click on the version number in the version table (typically 1.0.0.0).

Expand and check Launchable Service, and Save.

For iOS apps, make sure the iOS Bundle ID is set correctly on the iOS tab.

For Android apps, make sure the Android package name is set correctly on the Android tab.

Click Save.

Enabling BlackBerry Persona

BlackBerry Persona is enabled by default. To disable or re-enable the option for BlackBerry Persona:

On the policy details page, select the BlackBerry Persona tab and enable or disable.

Click Save changes.

Notes about using BlackBerry Launcher:

Licensing note: BlackBerry Persona requires a separate licensing agreement with BlackBerry in addition to BlackBerry Dynamics. 

App signing note: On iOS, BlackBerry requires an "Access WiFi Information" capability to be in the provisioning profile, which is used when signing the integrated app.

A BlackBerry Dynamics app using BlackBerry Persona requires Location Services on the device. BlackBerry Persona can be enabled and disabled by UEM admins for users, and users can also change the Location Services setting on their devices once the app is installed and activated. 

If you submit the BlackBerry Dynamics app to the Apple App Store with the BlackBerry Persona feature integrated, please clarify:

  • The location data is being collected as an optional feature of the app.
  • The data is linked to a user’s identity, but is not used for tracking purposes.

On this page