Managing policy profiles

When you apply a policy to an app, you choose a profile that specifies the settings chosen for that policy. You can create as many profiles as you want.

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 the default Integrity and Posture profile

Click Apps > iOS or Android, choose any app, then click the Integrity and Posture settings gear.

Under Integrity and Posture 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 Diagnostics profile

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

Under Diagnostics 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 an app customization profile

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

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

The downloaded profile zip file contains a profile.json file as well as any image and translation strings files that are specified in the profile.

Example: Importing a EULA profile

Click Apps > iOS or Android, choose any app, then click the, click End User License Agreement settings gear.

Under End User License Agreement 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, named "Imported Profile" with a timestamp. You can edit the profile to change the name and any other settings.

Example: Exporting a master profile

Click Policies > Master MAP 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. 

Duplicating a profile

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

Example: Duplicating a Data Sharing profile

Click Apps, choose any app, then click the Data Sharing settings gear.

Under Data Sharing Profiles, click the Copy profile icon (double page) for the profile you want to copy.

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