Configuring the AirWatch browser

Activities, Blogs, Status updates, and other HCL Connections data visible within the HCL Connections for AirWatch app can contain http or https web links. By default, pressing on one of these web links opens a web view within the HCL Connections for AirWatch app. There is no configuration needed to use the AirWatch browser as a stand-alone app. However, it is possible to have web links open in the AirWatch browser when using the HCL Connections Mobile for AirWatch app.

Configuration keys

Use the following configuration keys as part of custom settings to configure the AirWatch browser for use.

Note: Ensure that the AirWatch browser is deployed from the App catalog.
Table 1. AirWatch Browser Configuration Keys
Key Details
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 the 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. Default value is ".*", meaning that all URLs match the pattern. If useSecureBrowser is true and this secureBrowserPattern expression is set, HCL Connections for AirWatch compares the hostname of the web link that was pressed to this regular expression pattern. If the hostname matches this expression, the AirWatch browser is used. If not, the URL opens inside the Connections app by using an embedded web view.

Example Scenarios

  1. You want users to use the AirWatch browser for all web URLs contained within the HCL Connections for AirWatch app.

    Action: You must set the custom setting configuration key com.ibm.mobile.connections.useSecureBrowser=true and deploy this configuration key to the HCL Connections for AirWatch app.

  2. You want users to use the AirWatch browser when using HCL Connections for AirWatch to open any link with the company's domain name, "mycompany.com", but you want websites from any other domain to use the web view built into HCL Connections for AirWatch.

    Action: You must set the following configuration keys within the HCL Connections for AirWatch custom settings and deploy this profile to the HCL Connections for AirWatch app:

    • com.ibm.mobile.connections.useSecureBrowser=true
    • com.ibm.mobile.connections.secureBrowserPattern=.*.mycompany.com

There are many variations possible by specifying a regular expression to determine which domains are opened with the AirWatch Browser. Here are a few examples:

  • Match anything that uses the mycompany.com or greenwell.com domain: com.ibm.mobile.connections.secureBrowserPattern=.*.(mycompany|greenwell).com
  • Match anything that uses the mycompany.com or greenwell.org domain: com.ibm.mobile.connections.secureBrowserPattern=.*.mycompany.com|.*.greenwell.org
  • Match anything that uses the mycompany.com domain except for a couple of specific websites within this domain, site1.mycompany.com, and site2.mycompany.com: com.ibm.mobile.connections.secureBrowserPattern=(?!site1.mycompany.com)(?!site2.mycompany.com)(.*.mycompany.com)
Note: The "match anything" or wildcard expression must be specified as ".*" and not '*'.