App configuration

Admin users can define configuration settings for Android, Apple, and Windows apps that support managed configurations.

Before you begin

To configure app settings, ensure that the required app is added to the App Catalog.

Procedure

  1. From the MCM app page click Admin > App Configuration > Manage Configurations and click Create App Configuration.Mobile App Configuration
  2. On the App Configuration page, complete the following steps:
    • Name: Enter the name of the app.
    • Bundle ID / Product ID: Mandatory. Enter Bundle ID for the Android and Apple apps or Product ID for the Windows apps.
      Note: For Bundle ID of the Android and Apple apps, look up for the app details in the Google Play Store or Apple App Store. For Product ID of the Windows apps look up for the app details in the Windows Store.
    • Enter the configuration settings specific to Android, Apple, and Windows as necessary.
      • Android: For Android app configuration, enter the configuration as a key-value pair in JSON format.
        Example
        The managed configuration in JSON format for configuring Okta Device Trust for Android: 
         "managedConfiguration": {
 "domainName": “example.okta.com”,
 "managementHint": "3zr7Q~vw4C16FS2bH8UfS 1gJ5cL6sj~x_U9PQ"}
        Note: You can find the managed configuration of an Android app with the help of MDM debug tool.
      • Apple: For Apple configuration, enter the configuration in key-value pair in XML format.
        Example 1
        The managed configuration in XML format for configuring the Outlook app for Apple mobile devices:
        <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" http://www.apple.com/DTDs/PropertyList-1.0.dtd>
<plist version="1.0">
<dict>
  <key>com.microsoft.outlook.EmailProfile.EmailAccountName</key>
  <string>John Doe Email</string>
  <key>com.microsoft.outlook.EmailProfile.EmailAddress</key>
  <string>john.doe@hcl.com</string>
  <key>com.microsoft.outlook.EmailProfile.ServerHostName</key>
  <string>outlook.office365.com</string>
  <key>com.microsoft.outlook.EmailProfile.EmailUPN</key>
  <string>john.doe@hcl.com</string>
  <key>com.microsoft.outlook.EmailProfile.AccountType</key>
  <string>SMTP</string>
  <key>com.microsoft.outlook.EmailProfile.AccountDomain</key>
  <string>hcl</string>
</dict>
</plist>
        Example 2
        The managed configuration in XML format for configuring Okta Device Trust for Apple mobile devices:
        <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" http://www.apple.com/DTDs/PropertyList-1.0.dtd>
<plist version="1.0">
<dict>
  <key>OktaVerify.OrgUrl</key>
  <string>example.okta.com</string>
  <key>managementHint</key>
  <string><3zr7Q~vw4C16FS2bH8UfS 1gJ5cL6sj~x_U9PQ</string>
</dict>
</plist>%
      Note: Some apps do not support remote configuration. Refer to the software vendor's documentation for the app configuration keys. You can also use the MDM Debug tool to find the list of managed configuration properties.
  3. Click Save.
    Note: Save is enabled only after you enter the required information.

Results

The managed configurations are saved for the specified app.

What to do next

To include the saved managed configuration to your App Deployment Policy do the following:
  1. While selecting the app with managed configuration in the App Deployment policy, click the edit button corresponding to the app.
  2. Click the Configuration dropdown and select the name of the managed configuration that you want to apply to the selected app through the app deployment policy.
Note:
  • Before you deploy the app policy to a device, ensure that the pre-configured app is not installed and configured in a work profile on that device.
  • After you deploy the app policy, you can see that the app is installed on the enrolled target devices. You can verify the installation from the Play Store or App Store.
  • You can verify that all the managed properties that are deployed with the app policy are silently set to the application during installation.