App configuration details for MaaS360 MTD app

The supported app configurations by iOS and Android for the MaaS360® MTD app.

The information that is provided in the respective app configurations is described in the following list.

Title

The title for the parameter that is displayed in the app configuration within the IBM® MaaS360 Portal.
Configuration Key

The case-sensitive value to specify the parameter when it is typed in or within XML.
Description

A description of the parameter usage.
Required or Optional

Indicates whether this parameter is required for device protection.
Value Type

Indicates the data type value of the parameter like string, integer, or Boolean.
Sample Value

One or more sample values of the parameter.
Supported Platforms

The list of support-operating systems like Android or iOS.
Notes

Extra notes on the parameter if applicable.

Make sure that you do not override the following app configuration keys. These keys are case-sensitive if an XML configuration is used.

defaultchannel

The following table provides information about the defaultchannel parameter.

Table 1. Table description - defaultchannel
Item	Details
Title	Default Channel or Default Acceptor
Configuration Key	`defaultchannel`
Description	Identifies the environment that is used by the customer.
Required or Optional	Required
Value Type	String
Sample Value	`https://m3.mtd.maas360.com/api/acceptor/v1/srx`
Supported Platforms	Android OS Apple OS

The following table provides information about the tenantid parameter.

Table 2. Table description - tenantid
Item	Details
Title	Tenant or Tenant ID
Configuration Key	`tenantid`
Description	Identifies the customer's account (tenant).
Required or Optional	Required
Value Type	String
Sample Value	`81b72679-ddd6-4a9f-bcfd-845e71347671`
Supported Platforms	Android OS Apple OS

The following table provides information about the MDMDeviceID parameter.

Table 3. Table description - MDMDeviceID
Item	Details
Title	MDM Device ID
Configuration Key	`MDMDeviceID`
Description	A variable to inform the MTD app of the MDM Device ID value for the device.
Required or Optional	Required
Value Type	String
Sample Value	`%csn%` or `%deviceid%`
Supported Platforms	Android OS Apple OS

The following table provides information about the tracking_id_1 parameter.

Table 4. Table description - tracking_id_1
Item	Details
Title	Tracking ID 1
Configuration Key	`tracking_id_1`
Description	Any variable that the MDM supports to add more information to the device and threat information in the MTD app, for instance, username, email, or unique name.
Required or Optional	Optional
Value Type	String
Sample Value	`account id` or `billing id`
Supported Platforms	Android OS Apple OS
Description	Any variable that the MDM supports to add more information to the device and threat information in the MTD app, for instance, username, email, or unique name.

The following table provides information about the tracking_id_2 parameter.

Table 5. Table description - tracking_id_2
Item	Details
Title	Tracking ID 2
Configuration Key	`tracking_id_2`
Description	Any variable that the MDM supports to add more information to the device and threat information in the MTD app, for instance, username, email, or unique name.
Required or Optional	Optional
Value Type	String
Sample Value	`MAASENROLLMENTSTATUS:ENROLLED`
Supported Platforms	Android OS Apple OS

The following table provides information about the display_eula parameter.

Table 6. Table description - display_eula
Item	Details
Title	Display EULA
Configuration Key	`display_eula`
Description	Typically set to `no`. This variable controls the display of the End-User License Agreement (EULA) on MTD app activation.
Required or Optional	Recommended but optional
Value Type	String
Sample Value	`no`
Supported Platforms	Android OS
Notes	If you do not use this key, the default displays the End User License Agreement (EULA).

The following table provides information about the zerotouch parameter.

Table 7. Table description - zerotouch
Item	Details
Title	Zero Touch Activation
Configuration Key	`zerotouch`
Description	This parameter delays the permission request for the user when the app is opened. The user sees the threat information before any permission requests.
Required or Optional	Optional
Value Type	For Android or iOS, either Boolean or String.
Sample Value	`true`
Supported Platforms	Android OS Apple OS
Notes	`False` is the default setting. This variable is supported in IBM MaaS360 MTD 5.4 or later.

The following table provides information about the disable_user_override_thirdparty_vpn parameter.

Table 8. Table description - disable_user_override_thirdparty_vpn
Item	Details
Title	Disable User Override of Third-Party VPN
Configuration Key	`disable_user_override_thirdparty_vpn`
Description	Set this value to enable or disable the override of a third-party VPN. Set the value to `true` and the third-party VPN takes priority.
Required or Optional	Optional
Value Type	Boolean
Sample Value	`false`
Supported Platforms	Android OS Apple OS
Notes	`False` is the default setting. When this parameter is disabled, if any third-party VPN is running (for instance, MTD is running in Android for Work profile or a corporate VPN), when you turn on the MTD VPN, then, This parameter continually disables the corporate VPN (by enabling the MTD VPN) until the user disables the MTD VPN. In this case, when another VPN connecting on the device disconnects the MTD VPN and the MTD app becomes active, the MTD VPN disconnects the third-party VPN. Enables the MTD VPN in the personal profile, which can result in both the personal and work profile VPNs running. Note: A personal VPN must run even if another corporate VPN is running on the work side. When this parameter is enabled, and the MTD app wakes (for example, from a background task), the MTD VPN does not disconnect the third-party VPN on the device. It checks to see whether any VPN is connected. If connected, the MTD app does not connect the MTD VPN. If not connected, the MTD app automatically reconnects the MTD VPN.