MDM app configuration

Configuration settings for Mobile Device Management (MDM) apps.

If your MDM provider supports app-specific configuration, you can specify how the credentials for user accounts are configured. For more information about the MDM configurations that are supported by the Connections mobile app, see the Configuring Maas360 and Configuring MobileIron topics.

MDM app setting keys

The Connections mobile app supports the following MDM app configuration setting keys:

com.ibm.mobile.connections.serverURL
The account URL for the Connections server.
com.ibm.mobile.connections.serverName
The label of the account.
com.ibm.mobile.connections.AllowRemoveAccount

This key allows you to specify whether users can delete accounts without logging in to the accounts. This is useful for accounts that are set up by an MDM app and that a user is not going to use. Accounts that are set up by an MDM app cannot be deleted using the AllowRemoveAccount configuration property in the mobile-config.xml file. This key overrides what is specified on the server configuration and if you set the value to true, any account can be deleted.

Valid values are true and false. The default value is false, which prevents deleting accounts without logging in.

com.ibm.mobile.connections.ThemeColor
For MobileIron and MaaS360, this key allows you to set the Connections app theme colors.
The value is a 6 character string that represents a hexadecimal color code. The default value is blank.
Note: If a value is not specified for the ForegroundColor or ThemeColor property, the default app color is used.
This is a global setting that applies to all accounts, and cannot be set for individual accounts. This setting overrides the setting for ThemeColor that is specified in the mobile configuration on the Connections server.
This key is only supported on iOS and Android.
com.ibm.mobile.connections.ForegroundColor
For MobileIron and MaaS360, if you customize the Connections app theme color using com.ibm.mobile.connections.ThemeColor, this key allows you to customize the color of the text and icons that are displayed in areas where the theme color is shown.
The value is a 6 character string that represents a hexadecimal color code. The default value is blank.
Note: If a value is not specified for the ForegroundColor or ThemeColor property, the default app color is used.
This is a global setting that applies to all accounts, and cannot be set for individual accounts.
This key is only supported on iOS.
com.ibm.mobile.connections.useSecureBrowser
This key allows you to enable the Connections app to open non-Connections URLs in the MobileIron Web@Work app instead of using the browser embedded in the Connections app. This is helpful if your Connections content contains URLs that can only be accessed from the MobileIron Web@Work app. Valid values are true and false. The default value is false, which specifies opening non-Connections URLs in the browser embedded in the Connections app.
Note: This key is only supported for MobileIron. For MaaS360, set up the secure browser in the persona policy. See Configuring MaaS360 for more information.

Account credentials

You can specify credentials that apply to only one account or that apply globally to all accounts.

To specify credentials that apply to all accounts, use the following parameters:

com.ibm.mobile.user
The user ID for the accounts.
com.ibm.mobile.password
The user's password.

To specify credentials for a specific account, use the following parameters:

com.ibm.mobile.connections.user
The user ID for the account.
com.ibm.mobile.connections.password
The account password.
Note: To create an account, you must have a server URL and user ID for the account.

Substitution variables

With many MDM solutions that support app configuration, you can use substitution variables for the user ID and password. For more information about which substitution variables are supported, see your MDM provider's documentation.

You can create multiple accounts by appending a dot, followed by a unique number, to the end of the keys.

For example, to create three accounts that share credentials, use the following parameters:
Note: The $USERID$ variable is used by MobileIron and %email% is used by MaaS360.
com.ibm.mobile.connections.serverURL=http://server.com/mobile
com.ibm.mobile.connections.serverName="Test Account"
com.ibm.mobile.connections.serverURL.1=http://server2.com/mobile
com.ibm.mobile.connections.serverName.1="Server2 Account"
com.ibm.mobile.connections.serverURL.2=http://server3.com/mobile
com.ibm.mobile.connections.serverName.2="Server3 Account"
com.ibm.mobile.user=$USERID$
com.ibm.mobile.password=$PASSWORD$

To create two accounts with different user IDs, use the following parameters:

com.ibm.mobile.connections.serverURL=http://server.com/mobile
com.ibm.mobile.connections.serverName="Test Account"
com.ibm.moible.connections.user=TestUser1
com.ibm.mobile.connections.serverURL.1=http://server2.com/mobile
com.ibm.mobile.connections.serverName.1="My personal Account"
com.ibm.mobile.connections.user.1=%email%