Managing AirWatch configuration

You can provide custom settings to automate the setup of HCL Connections for AirWatch by using the Custom Settings feature provided by AirWatch.

Account credentials

  1. On your AirWatch administration portal, navigate to your organization. Click Groups and Settings > All Settings > Apps > Settings and Policies > Settings > Custom Settings.
  2. Set Custom Settings to enabled.

Each setting is a key=value pair, and each one must be separated by a new line. AirWatch supports a number of variable substitutions, which can be included in the value portion of the setting to provide dynamic value support. Clicking the ‘+’ icon next to the Custom Settings field displays the choices that are possible, all using the brace characters { }. For example, com.ibm.mobile.connections.user={EmailAddress}.

Note: These parameters are optional, and if they are not provided, HCL Connections for AirWatch chooses the default value, or if a default value is not applicable, it prompts you for the value. If these settings are modified after their initial deployment, the updated settings are distributed to any managed client and HCL Connections for AirWatch will accept the updated values.
Table 1. AirWatch Configuration Keys
Key Value Details
com.ibm.mobile.connections.user

The user ID for the 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.connections.password

The account password.

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.connections.serverURL The account URL for the HCL Connections server.
com.ibm.mobile.connections.serverName The label of the account.
com.ibm.mobile.connections.AllowRemoveAccount

You can specify whether users can delete accounts without logging into the accounts. This setting 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 by 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

You can set the HCL Connections for AirWatch 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 is global and cannot be set for individual accounts. It overrides the setting for ThemeColor that is specified in the mobile configuration on the HCL Connections server.
com.ibm.mobile.connections.ForegroundColor This setting is global and cannot be set for individual accounts. You can customize the HCL Connections for AirWatch app theme color by using com.ibm.mobile.connections.ThemeColor. With his key you can customize the color of the text and icons that are displayed on backgrounds that have the theme color.

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.
Note: This key is supported only on iOS.
com.ibm.mobile.connections.useSecureBrowser The value can be true or false. Set to false to completely disable the use of the AirWatch Browser. Set to true to use AirWatch Browser for any non-Connections host URLs.
com.ibm.mobile.connections.secureBrowserPattern The value is a regular expression pattern for a URL’s host name. If useSecureBrowser is true and this secureBrowserPattern expression is set, HCL Connections for AirWatch compares the host name of the web link that was pressed to this regular expression pattern. If the host name matches this expression, the AirWatch Browser is used. If not, a native or third-party browser can be used.
com.ibm.mobile.connections.RememberPassword Indicates whether users can enable the RememberPassword or not.
com.ibm.mobile.connections.InactivityTimeout The length of inactivity in the application, in minutes, after which users are required to re-authenticate with the server.

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.connections.user
The user ID for the accounts.
com.ibm.mobile.connections.password
The user's password.

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

com.ibm.mobile.connections.user.1
The user ID for the account.
com.ibm.mobile.connections.password.1
The account password.
Note: To create an account, you must have a server URL and user ID for the account. The server parameter would be com.ibm.mobile.connections.serverUrl.1. To have multiple accounts, you must have parameters with an appended suffix that identifies the index of the account to which the property would apply (.1, .2, and so on). All parameters with the same suffix apply to the same account.

For example, to create three accounts that share credentials, use the following parameters:

  • 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={EnrollmentUserId}
Note: See the AirWatch administration console to get the full list of substitution variables.