Dynamic and Fixed Placeholders for Android Applications

A managed configuration allows users to apply additional settings to supported Android applications. In addition, users can apply placeholders, also known as custom attributes or key value pairs, to expose specific device information. For example, these configurations can be used to identify devices out in the field with their console counterparts and to link devices with certain locations via their unique identifiers. 

Dynamic placeholders are also available for iOS applications.

In this article: 

• Supported Dynamic Placeholders
• Example Usage
• Applying a Managed Configuration
• More About Esper Knox Key

Requirements: 

• Android Esper Agent v8.00.0764+ 

Supported Dynamic Placeholders 

The following dynamic placeholders are supported on Android devices. You may need to discuss with your app developer about the values supported by your application. 

Example Usage 

The input configuration is a managed config.

Example Input

{
  "device_name": "${esper.deviceName}",
  "device_details": {
    "serial": "${esper.serialNumber}",
    "imei": "${esper.imei1}",
    "mac": "${esper.macAddress}"
  }
}

Example Output 

{
  "device_name": "ESP-ID-AAAAW",
  "device_details": {
    "serial": "SN123456789",
    "imei": "453551143250391",
    "mac": "00:1A:2B:3C:4D:5E"
  }
}

Applying a Managed Configuration 

Blueprint

In a blueprint, go to the Apps & Configuration section and click on the Android tab. In Manage Applications, add a new application or identify an existing one that supports managed configurations. Then click on the ellipsis button next to the application and select Managed Configuration. 

Then paste the configuration in the input box. 

Click on Apply Changes.  Then save and publish the blueprint. 

When you converge a device to that blueprint, the managed configuration will be applied to the application currently on the device or will be installed with the application. 

Individual Device Action

To apply dynamic placeholders to a single device, Click on the device in Devices & Groups and go to its Apps section. Locate the application and click on Manage to apply the dynamic placeholder values. 

Then press Apply Changes.

You can check the device’s details from the managed configuration section as well.

Remember to converge the device to update these values. Use dynamic placeholders with managed configurations to unlock further customization for your Android fleet.

More About Esper Knox Key 

The fixed placeholder Esper Knox key variable gives users access to Esper's Knox key so they can utilize Knox premium features through the console and API.

See Additional JSON Settings for a list of configurations.

Always use a new profileName when applying a new config. 

Managed Config Double Press Example

{
  "profileName": "KSP Side Key Double Press",
  "kpePremiumLicenseKey": "${esper.knoxKey}",
  "verboseMode": true,
  "doPolicies": {
    "doPoliciesIsControlled": true,
    "doDevControlKeyMapping": {
      "doDevControlKeyMappingIsControlled": true,
      "doDevControlKeyMappingGenericIsControlled": true
    }
  },
  "profileDevControlKeyMappingConfigurations": [
    {
      "profileDevControlKeyMapping": "SIDE_KEY_DOUBLE_PRESS",
      "profileDevControlKeyMappingPackageName": "com.sec.android.app.camera"
    }
  ]
}

Managed Config Double Press Response

{
  "profileName": "KSP Side Key Double Press",
  "kpePremiumLicenseKey": "KLM0****Y7F5",
  "verboseMode": true,
  "doPolicies": {
    "doPoliciesIsControlled": true,
    "doDevControlKeyMapping": {
      "doDevControlKeyMappingIsControlled": true,
      "doDevControlKeyMappingGenericIsControlled": true
    }
  },
  "profileDevControlKeyMappingConfigurations": [
    {
      "profileDevControlKeyMapping": "SIDE_KEY_DOUBLE_PRESS",
      "profileDevControlKeyMappingPackageName": "com.sec.android.app.camera"
    }
  ]
}

Managed Config Mac Randomization Example 

Enables Mac randomization. Requires a WPA security type. 

{
  "profileName": "Disable WiFi MAC Randomization",
  "kpePremiumLicenseKey": "${esper.knoxKey}",
  "verboseMode": true,
  "doPolicies": {
   "doPoliciesIsControlled": true,
   "doDevControls": {
    "doDevControlsWifi": {
     "doDevControlsWifiIsControlled": true,
     "doDevControlWifiConfiguration": true
    }
   }
  },
  "profileDevControlsWifiConfigs": [
   {
    "profileDevControlsWifiConfigNetworkName": "Andi Wi-Fi",
    "profileDevControlsWifiConfigSecurityType": "WPA",
    "profileDevControlsWifiConfigPassword": "password",
    "profileDevControlsWifiConfigSkipRandomization": true
   }
  ]
 }

Managed Config Mac Randomization Example 
Disables Mac randomization. Requires a WPA security type. 

{
    "profileName": "Enable WiFi MAC Randomization",
    "kpePremiumLicenseKey": "${esper.knoxKey}",
    "verboseMode": true,
    "doPolicies": {
      "doPoliciesIsControlled": true,
      "doDevControls": {
        "doDevControlsWifi": {
          "doDevControlsWifiIsControlled": true,
          "doDevControlWifiConfiguration": true
        }
      }
    },
    "profileDevControlsWifiConfigs": [
      {
        "profileDevControlsWifiConfigNetworkName": "Andi Wi-Fi",
        "profileDevControlsWifiConfigSecurityType": "WPA",
        "profileDevControlsWifiConfigPassword": "password",
        "profileDevControlsWifiConfigSkipRandomization": false
      }
    ]
  }

Learn more about Managed Applications Configurations from Android Developer Documentation.