Skip to content

Intelligence SDK Allowed Apps

Intelligence SDK Allowed Apps

The control configuration (UEM SDK Custom Settings) KVP IntelSDKAllowedApps (Allowed Apps lists) is a JSON Array which can be used to control which apps can report DEX Data. - If the current app’s ID matches one of the IDs in the IntelSDKAllowedApps array, DEX data collection and transmission will be enabled for that app (assuming DEX is opted in). - If the current app’s ID is not in the list, DEX data collection and transmission will be blocked for that app, even if DEX is otherwise enabled. - If the IntelSDKAllowedApps key is missing or the array is empty, all apps will be allowed to transmit DEX data (default behavior). - The SDK could dynamically start or stop DEX data transmission based on changes to this list when setSDKControlConfig is called. - If DEX is already opted in at the time the app has been allow listed, DEX data will start transmitting. - If DEX is opted out at the time the app has been allow listed, DEX will remain off until it is opted in.

Obtain your app ID from Omnissa Intelligence console. Please check Omnissa Intelligence SDK Data for Apps for more information.

How to Use

To inject this control configuration, use the API setSDKControlConfig offered through the Crittercism singleton. The control configuration is the UEM SDK Custom Settings and can be fetched from the UEM SDK. For more details on how to fetch the Custom Settings, see Workspace ONE UEM Custom Settings Integration for Intelligence SDK.

/**
* Sets the WS1 UEM SDK Control Config.
* IntelligenceSDK will parse for the following properties:
*  - IntelSDKAllowedApps: JSON Array of apps allowed to transmit DEX data to the UEM console. If not available,
*    IntelligenceSDK will default to allowing all apps to transmit data.
*  - DEXData: JSON containing the privacy configuration.
*  Apps / SDK's are expected to fetch the control config JSON string and call this API. In the case the control
*  config is not available, a null value should be passed for the config parameter.
*
* @param config Json String of the control config provided from the WS1 UEM SDK.
*/
public static void setSDKControlConfig(String config)

For more on this API, see: setSDKControlConfig.

Control Configuration Attributes

The following is a table of the Attributes that are currently parsed within the control config.

Configuration JSON Attributes Table

Flag Description Value Outcome Notes
IntelSDKAllowedApps JSON Array of Application IDs that are allowed to transmit DEX data to the UEM console. This value of this key (JSON object) is parsed only if CaptureDEXData is true.
MISSING All apps will transmit DEX data to the UEM console.
AVAILABLE Only the matching Application IDs within the array will be allowed to transmit DEX data to the UEM console.

Example Payload

  // Only the listed Android apps (App 1 and App 2) will be allowed to transmit DEX data.

  "IntelSDKAllowedApps": [
    "2b5a662e8c4d45fe9f8af99af509655b00555300",  // App 1 ID
    "84e3527ecb354764925d48345530c47f00555300"  // App 2 ID
  ]