MDM app configuration
Configuration settings for Mobile Device Management (MDM) apps.
Configuration settings
App configuration settings can be specified for individual accounts or globally for all accounts.
If you are using AppConfig for iOS or Android Enterprise, then refer to those topics for more comprehensive configuration support.
Some configuration settings can be used across the mobile apps HCL Connections, HCL Connections Chat, HCL Connections Meetings, and HCL 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.
Leave this setting empty when using OAuth authentication. It is not possible to specify a user name (or password) in this environment.
- com.ibm.mobile.password
- com.ibm.mobile.connections.password
-
The password for the user. This key is optional.
Leave this setting empty when using OAuth authentication. It is not possible to specify a user name (or password) in this environment.
To configure multiple accounts, add a dot followed by a numeric suffix to the end of the key.
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$
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 login password on the mobile device. When this key is set to true, users have the option to save their password so they do not need to enter their passwords each time the HCL Connections app needs to authenticate with the HCL Connections server. To prevent passwords from being saved, set the key value to false. This forces users to enter a password each time the HCL Connections app needs to authenticate with the HCL 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:- A device passcode must be set before the user can log in to an account.
- If the passcode is removed from the device, data associated with accounts that have been previously used to log in will be wiped.
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.AllowExternalBrowserDomains
-
This key allows you to open supported http/s URLs in an external browser instead of the embedded browser in the HCL Connections application. Supported URLs are specified by the SupportedExternalBrowserDomains key.
Valid values are true and false . The default value is false , which opens the URLs in the embedded browser in the HCL Connections app.
Note: If the specified URL is a deep link or a universal link that is supported by a native application and is installed on the user's device, the URL is opened in the native application instead of an external browser. - com.ibm.mobile.connections.SupportedExternalBrowserDomains
-
This key specifies the domain/subdomain patterns for the websites that uses an external browser instead of the embedded browser within the HCL Connections mobile app. This value is applicable only when AllowExternalBrowserDomains is set to true.
Use a comma to separate multiple domain patterns. This key accepts wildcard subdomains ( * ) and can be specified only at the beginning. This key does not support Regular Expressions.
The following snippet shows an example how you can specify domain/subdomain rules:
- Ensure that the AllowExternalBrowserDomains key is set to
true if you want the supported URLs to open in an external browser
<AllowExternalBrowserDomains>true</AllowExternalBrowserDomains>
- Here www is a subdomain and hcl.com is the domain. Once you specify this rule, you would
be able to open any link that exactly matches domain and subdomain. For example you would be
allowed to open www.hcl.com/somepage.html but not
'somesubdomain.hcl.com
<SupportedExternalBrowserDomains>www.hcl.com</SupportedExternalBrowserDomains>
- Here is an example of using a wildcard * domain and using multiple domains. Using this
rule, the mobile user would launch an external browser when tapping any link that was part
of *.hcl.com or matched www.example.com exactly. For example, these
pages would all launch an external browser on the mobile device:
www.hcl.com/somepage.html, somesubdomain.hcl.comand
www.example.com.
<SupportedExternalBrowserDomains>*.hcl.com,www.example.com</SupportedExternalBrowserDomains>
- Ensure that the AllowExternalBrowserDomains key is set to
true if you want the supported URLs to open in an external browser
- com.ibm.mobile.connections.ThemeColor
- com.ibm.mobile.connections.ForegroundColor
- This key is only supported on iOS. If you customize the HCL 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.
- com.ibm.mobile.connections.useSecureBrowser
-
This key allows you to enable the HCL Connections app to open non-HCL Connections URLs in the MDM's secure web browser instead of using the browser embedded in the HCL Connections app. This is helpful if your HCL 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-HCL Connections URLs in the browser embedded in the HCL 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-HCL Connections URLs without this key set. See Configuring MaaS360 for Workplace Integration for more information. - com.ibm.mobile.secureBrowserPattern
- com.ibm.mobile.connections.secureBrowserPattern
- This key controls which non-HCL 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.
- com.ibm.mobile.connections.DefaultNavigationOrder
- This key controls the initial order of the Connections apps in the main app navigation. The
value is a list of Connection app identifiers. Valid values for the Connections apps are
updates, communities, files,
profiles, favorites, blogs,
forums, wikis, offlinefiles,
activities, and bookmarks. For
example,
Also, if you add application extensions, you can specify the application extension name in the list. This setting overrides the setting for DefaultNavigationOrder that is specified in the mobile configuration on the Connections server.com.ibm.mobile.connections.DefaultNavigationOrder.1=(updates,communities,files,profiles,favorites,blogs,forums,wikis, offlinefiles,activities,bookmarks)