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.
- 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.
- 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.
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.
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%