MDM app configuration

Configuration settings for Mobile Device Management (MDM) apps.

Configuration settings

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

App configuration settings can be specified for individual accounts or globally for all accounts. Some configuration settings can be used across the mobile apps IBM Connections, IBM Connections Chat, IBM Connections Meetings, and IBM Verse. These settings use a prefix of "com.ibm.mobile" instead of "com.ibm.mobile.connections".

MDM app setting keys

Use the following keys to configure account information:

com.ibm.mobile.connections.serverURL
The account URL for the Connections server. This key is required to create an account.
com.ibm.mobile.connections.serverName
The label of the account. This key is optional. The default is to use the server host name.
com.ibm.mobile.user
com.ibm.mobile.connections.user
The user ID for the account. This key is required to create an account.
com.ibm.mobile.password
com.ibm.mobile.connections.password
The password for the user. This key is optional.

To configure multiple accounts, add a dot followed by a numeric suffix to the end of the key.

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. 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.1=http://server.com/mobile
com.ibm.mobile.connections.serverName.1="Test Account"
com.ibm.mobile.connections.serverURL.2=http://server2.com/mobile
com.ibm.mobile.connections.serverName.2="Server2 Account"
com.ibm.mobile.connections.serverURL.3=http://server3.com/mobile
com.ibm.mobile.connections.serverName.3="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.1=http://server.com/mobile
com.ibm.mobile.connections.serverName.1="Test Account"
com.ibm.moible.connections.user.1=TestUser1
com.ibm.mobile.connections.serverURL.2=http://server2.com/mobile
com.ibm.mobile.connections.serverName.2="My  personal Account"
com.ibm.mobile.connections.user.2=%email%

The following configuration settings apply either for individual accounts or globally for all accounts. To associate these settings with an account, add the same numeric suffix used to define the account. If the configuration settings should be applied globally to all accounts, don't specify a suffix.

com.ibm.mobile.connections.RememberPassword

This key allows users to save their log in password on the mobile device. When this key is set to true, users do not need to enter their passwords each time the IBM Connections app needs to authenticate with the IBM Connections server. To prevent passwords from being saved, set the key value to false. This forces users to enter a password each time the IBM Connections app needs to authenticate with the IBM Connections server.

com.ibm.mobile.connections.InactivityTimeout

A timeout value, in minutes, that results in users being logged out of the client if no activity has taken place for the time period that is defined in this property. When the user is logged out due to inactivity, that user is required to re-enter their password, even if the password is remembered by the app. Specifying a value of 0 results in users never being logged out due to inactivity.

com.ibm.mobile.RequireDevicePasscode
com.ibm.mobile.connections.RequireDevicePasscode

This key is only supported on iOS. This key requires that a device passcode is set before a user can log in to a Connections server. Device passcodes are required in order to enable the data protection encryption feature used by the Connections app.

When this key is set to true:
  1. A device passcode must be set before the user can log in to an account.
  2. If the passcode is removed from the device, data associated with accounts that have been previously used to log in will be wiped.
If your MDM deployment pushes out device configuration profiles to devices, it is suggested you setup a passcode profile to enforce setting of the passcode on the device. This configuration setting can be used if you only push out app configurations settings.

The following configuration settings are applied globally to all accounts.

com.ibm.mobile.connections.AllowRemoveAccount

This key allows you to specify whether users can delete accounts without logging in to the accounts. 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
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 setting overrides the setting for ThemeColor that is specified in the mobile configuration on the Connections server.
com.ibm.mobile.connections.ForegroundColor
This key is only supported on iOS. If you customize the IBM 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 setting overrides the setting for ForegroundColor that is specified in the mobile configuration on the IBM Connections server.
com.ibm.mobile.connections.useSecureBrowser

This key allows you to enable the IBM Connections app to open non-IBM Connections URLs in the MDM's secure web browser instead of using the browser embedded in the IBM Connections app. This is helpful if your IBM Connections content contains URLs that can only be accessed from the MDM secure browser. Valid values are true and false. The default value is false, which specifies opening non-IBM Connections URLs in the browser embedded in the IBM Connections app.

Note: This key is only required for MaaS360 if you want to set secureBrowserPattern. For MaaS360, if the secure browser is enabled in the persona policy then the Connections app will use it for all non-IBM Connections URLs without this key set. See Configuring MaaS360 for more information.
com.ibm.mobile.secureBrowserPattern
com.ibm.mobile.connections.secureBrowserPattern
This key controls which non-IBM Connections URLs are opened in the MDM's secure browser. The value is a regular expression. If the URL that the user is attempting to open matches the regular expression, then the URL will be opened in the MDM's secure browser. If it does not match, then the URL is opened in an internal web view within the Connections app.