Configuring mobile apps

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

Procedure

  1. From the MCM app page click Admin > Mobile App Configuration > Manage Configurations and click Create App Configuration.Mobile App Configuration
  2. On the App Configuration page, complete the following steps:
    • Enter the app name.
    • Enter Bundle ID of the app.
      Note: You can find the Bundle ID from the app details in the Google Play Store or App Store.
    • Enter the configuration settings for Android, Apple, or both.
      • For an Android configuration, enter the configuration as a key-value pair in JSON format.
        Example 1
        The managed configuration in JSON format for configuring the Outlook app for Android:
        { 
      "managedConfiguration": { 
        "com.microsoft.outlook.EmailProfile.EmailAddress": "john.doe@hcl.com", 
        "com.microsoft.outlook.EmailProfile.EmailAccountName": "John Doe", 
        "com.microsoft.outlook.EmailProfile.ServerHostName": "outlook.office365.com", 
        "com.microsoft.outlook.EmailProfile.AccountDomain": "hcl" 
      } 
}
        Example 2
        The managed configuration in JSON format for configuring Okta Device Trust for Android: 
         "managedConfiguration": {
 "domainName": “example.okta.com”,
 "managementHint": "3zr7Q~vw4C16FS2bH8UfS 1gJ5cL6sj~x_U9PQ"}
      • 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:
        <dict>
    <key>ManagedAppConfiguration</key>
    <dict>
        <key>"com.microsoft.outlook.EmailProfile.EmailAddress"</key>
        <string>"john.doe@hcl.com"</string>
        <key>"com.microsoft.outlook.EmailProfile.EmailAccountName"</key>
        <string>"John Doe"</string>
        <key>"com.microsoft.outlook.EmailProfile.ServerHostName"</key>
        <string>"outlook.office365.com"</string>
        <key>"com.microsoft.outlook.EmailProfile.AccountDomain"</key>
        <string>"hcl"</string>
    </dict>
</dict>
        Example 2
        The managed configuration in JSON 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. Save is enabled only after you enter the required information.

Results

The app configurations are set for the specified app. You can add this app to the Appstore App Policy for further distribution to managed mobile devices.

What to do next

  • 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 targeted mobile 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.