About profiles

A policy profile is a collection of settings that can be applied with a policy. For example, when you apply the BlackBerry Dynamics SDK policy to an app, you choose a BlackBerry Dynamics SDK profile that specifies the GD App ID, GD App Version, and other settings used by BlackBerry Dynamics.

The policy profile includes only the Blue Cedar Platform options. Use the BlackBerry Unified Endpoint Manager to configure app-level controls.

A master policy is a collection of individual policies. A master policy profile provides a streamlined way to apply the same set of policies to multiple apps. See Managing and using master policy profiles for details.

Use a signing profile to specify the app-signing parameters. Unlike a policy profile, which is a collection of settings that can be applied with a policy to integrate an app with security, a signing profile is a collection of code signing parameters. These parameters are different for iOS and Android signing. Signing profiles cannot be included in master policy profiles. See Using and configuring signing profiles for details.


Creating and editing a policy profile

Click Apps > iOS or Android, choose any app, then click the settings gear for a policy. The Policy details page appears.

  • To create a new profile, click Policyname Profile. The Policyname Profile details page appears.
  • To edit an existing profile, click the View/Edit profile icon (pencil) next to an existing profile. The Policyname Profile page appears.
  • To create a new profile based on an existing profile, click the Copy profile icon next to an existing profile. A new profile appears in the list, named with the original profile name, appended with "Copy n". Click the View/Edit profile icon to rename the new profile and edit any other options.

On the Policyname Profile details page, enter a profile name and description, then choose from the policy options to define the policy profile. See the appropriate policy documentation for descriptions of each policy's profile options.

When satisfied with your configuration, click Save changes. Click Reset to restore the configuration of the browser profile back to the previous version. 

Once you have saved a policy profile, it is available for that policy with any app.

Setting the default profile

The default profile for a specific policy is applied any time that policy is enabled, unless you specifically choose another profile.

On the policy details page, the current default profile has a bullet instead of a thumbtack icon in the Actions column. Click the thumbtack icon for a specific profile to set it as default.

Example: Setting a default Master profile

Click Apps > iOS or Android, choose any app, then click the Master Policy settings gear.

Under Master Profiles, click the default profile icon (thumbtack) for the desired profile. The thumbtack is replaced by a bullet.

Deleting a profile

If you no longer want to use a profile, you can delete it. Deleted profiles are not available in the profiles list and cannot be applied to an app. Deleting a profile doesn’t affect any apps you’ve already secured with the profile, however.

Deleted profiles cannot be recovered through the Policy Console.

Example: Deleting a BlackBerry Dynamics SDK profile

Click Apps > iOS or Android, choose any app, then click the BlackBerry Dynamics SDK settings gear.

Under BlackBerry Dynamics SDK Profiles, click the delete profile icon (red x) for the profile you want to delete.

The Policy Console confirms that you want to delete the profile. Click OK.

When confirming the deletion, the Policy Console displays a warning if the profile is set to default for that policy, or if the profile is used to secure an app.

Exporting a profile

You can export any of the policy profiles through the Policy Console.  

Export a policy profile to download a .zip file containing JSON-formatted profile information (profile.json) and additional assets (if any). Most exported policy profiles .zip files include a single profile file. These policy profiles include additional assets:

  • App Customization profiles may also include image files (logo and background image) and custom translation strings files (userStringsJson.json). 
  • Browser Configuration profiles include icons for hte Compass app and the Web App List.
  • End User License Agreement profiles include license agreement text files for each configured locale.
  • Master profiles include zip files for each individual policy profile included in the master profile.
  • Signing profiles include a keystore or provisioning profile.

You can use the export/import mechanism to copy a profile from one policy console to another, or to create a backup copy of a profile. 

Example: Exporting a master profile

Click Policies > Master Policy. 

Under Master Profiles, click the Export profile icon (↓) for the profile you want to download.

The downloaded master profile zip file contains a profile.json file as well as zip files for each individual profile specified in the profile. 

Example: Exporting a BlackBerry Dynamics SDK profile

Click Apps > iOS or Android, choose any app, then click the BlackBerry Dynamics SDK settings gear.

Under BlackBerry Dynamics SDK Profiles, click the Export profile icon (↓) for the profile you want to download.

The downloaded profile zip file contains a profile.json file.

Example: Importing a profile

Click Apps > iOS or Android, choose any app, then click the settings gear next to the appropriate policy.

Above the list of Policy Profiles, click Import Profile.

Use the Choose File button to select a zip file. 

After choosing a file, click Upload.

The uploaded profile is added to the profile list and is named "Imported Profile" with a timestamp. You can edit the profile to change the name and any other settings.

Duplicating a profile

To duplicate a profile on the same policy console, use the Copy profile action.

Example: Duplicating a profile

Click Apps, choose any app, then click the settings gear next to the appropriate policy.

In the policy profiles list, click the Copy profile icon (double page) for the profile you want to copy.

The new profile appears in the policy profiles list, named with the original profile name, appended with "Copy n". You can edit the profile to change the name.