This guide provides information on the usage and configuration of Airlock Browser, and also on developing web-based applications for Airlock Browser.
Airlock Browser for Android is compatible with devices running Android 5.0 (Lollipop) and above.
When launching Airlock Browser, the launchpad is displayed. The launchpad contains tiles, which are quick links to web application profiles that you create. (See Figure 1.) You look at creating web application profiles later in the guide.
Tapping or sliding the launchpad to the left reveals the web content. By tapping the ellipsis button in the bottom right hand corner of the main view, the application bar expands.
There is an address bar, and various toolbar and menu items. Tapping the address bar allows you to enter a URL or a search query.
NOTE: The buttons and menu items in the application bar and tab menu are completely customizable. A device administrator may re-order, remove, or add buttons according to requirements. You see how to achieve this later in this guide.
When the application bar is expanded, the tab headers are revealed at the top of the screen. You can switch between tabs by scrolling and tapping the desired tab. A favicon image for the page sits in each tab along with the page title and an SSL indicator that notifies the user of an secure SSL connection. A vertical ellipsis button reveals a set of commands available for the active tab. (See Figure 2.)
Tapping the Settings button in the application bar menu, displays the Settings screen. (See Figure 3.)
NOTE: All settings are exportable, as are web application profiles. You explore how to export the browser’s configuration, and even host the exported configuration on a server, to deliver browser settings to multiple devices.
The Settings screen offers various settings, and is divided into four sections:
NOTE: When first launching Airlock Browser, the app is in its non-locked-down state. All screens are visible, all settings are present on the Settings screen, and launchpad tiles are editable. However, upon setting an administration password, most settings are hidden on the Settings screen, launchpad tiles are no longer editable, and the screens available to the user are limited to those that you (as the administrator) allow in the application bar. You can decide which items, if any, are appropriate for your organization’s needs and should appear in the application bar and tab menu. We explore these aspects later in this guide.
In this section you explore the items in the General section of the Settings screen.
By default Airlock Browser selects its user interface language according to the devices language setting. You can, however, configure the language independently, which enables administration of the device to be performed in one language, while providing Airlock Browser’s interface to users of another language.
When you enter text into Airlock Browser’s address bar, if the text is unable to be converted to a URL, Airlock Browser performs a search using the specified search provider.
NOTE: Selecting the none option, from the Search using drop down box, disables the address bar search feature.
By default, Airlock Browser launches in full-screen mode; hiding the application bar and tab headers. Set the option to Normal to have the application bar and tab headers displayed at launch.
NOTE: The user is able to enable or disable full-screen mode using the Full Screen item in the application bar menu. To prevent this, remove the Full Screen item from the application bar menu via the Customize Menus item on the Appearance tab of the Settings screen.
To perform a back navigation of a web page, the user may either use Airlock Browser’s back button in its main toolbar or the user can tap the hardware back button in the operating system’s navigation bar. To prevent the hardware back button from navigating to the previous web page set the Hardware Back Button Action to None.
When Airlock Browser launches or is deactivated for 5 minutes, the launchpad is brought into view. To prevent this behavior, disable this option.
When switching between tabs, Airlock Browser does not stop playback of video on inactive tabs. Enable this option to prevent video playback when a tab is not the active tab.
The orientation lock appears when the device is rotated, and allows the user to temporarily prevent Airlock Browser from switching from, or to, landscape or portrait mode. On some devices, where the accelerator is malfunctioning or not properly configured, the orientation lock can be displayed incorrectly. This option allows you to prevent the orientation lock from showing.
This option allows you to disable the downloading of images when a web page loads, which may be useful in low bandwidth environments, or when a web application presents images that have a large file size.
When enabled, the Ad Blocker stops most web page ads from being displayed.
In this section you explore the items in the Security section of the Settings screen.
Ordinarily, the devices back button may be used to exit Airlock Browser. To prevent the app from exiting via the hardware back button, enable this option.
When Require Passcode at Launch is enabled, the user is presented with a passcode entry screen when the app launches or the app is deactivated for 5 minutes or longer. See Figure 4. This feature is commonly used when the device is being used by staff in a public or unrestricted environment.
When Require Passcode at Launch is enabled, the window for the app is secured. This means that there is no app preview when cycling through apps, and taking a screenshot of the app is disabled.
NOTE: The passcode is included in the exported configuration in an encrypted format. Thus, you are able to control the passcode for multiple devices using a hosted configuration file.
When you set a passcode for the browser, the Require Passcode at Launch is automatically enabled. You can, however, disable Require Passcode at Launch after a passcode is set.
NOTE: Do not confuse the Administration password with the passcode. The Administration password, set on the Administration screen, limits access to authorized administrators only. While the passcode limits access to authorized users only.
If the device has a hardware fingerprint reader, then Airlock Browser can be unlocked using a fingerprint, without requiring the user to enter the passcode.
NOTE: A passcode must be set to use the Fingerprint Reader unlock feature.
When enabled, this option causes Airlock Browser to re-open the pages that were open the last time it was running.
Some websites rely on knowing the GPS location of the device to provide, for example, navigation services. Disabling this option prevents web pages from accessing the location of the device.
When enabled, when sharing a page or image, it is added to the shared content section of the history screen.
Incognito mode prevents the browser from retaining the history of viewed pages. An incognito button can be placed in the application bar menu by using the menu customization option.
NOTE: When incognito mode is enabled pop-up windows are disabled.
When enabled, the browser prompts the user to save a password when it identifies a form submission with a password field. If the user agrees to saving the password, the password is stored in an encrypted form. When the user navigates to the same page, the browser will attempt to populate the password field.
Disabling this option prevents the saving of passwords.
NOTE: Web page passwords are not included when exporting the browser’s configuration.
This button deletes all saved web page passwords.
This button deletes all cookies.
URL rules determine which pages can or cannot be accessed by the browser. When navigating to a URL the list is evaluated from top to bottom. (See Figure 5.)
As soon as a match is found, the Allow or Deny rule is applied. Long press to change the order of a URL rule. Swipe a URL rule left or right to delete it. If you mistakenly delete a rule, use the undo button in the application bar to restore it. To create a new rule, tap the + button in the application bar.
Wildcards are supported by default. You may also specify more complex rules using regular expressions. To enable interpretation of the text as a regular expression, check the Regular Expression checkbox. For example, to specify URLs that belong to the example.com domain and all sub-pages you might use something like
NOTE: An allow rule is automatically created for the URL of active web application profile (defined in the Launchpad), and it takes precedence over the URL rules defined on the URL Rules screen.
In this section you see how to change theme options and customize menu and toolbars via the Appearance section of the Settings screen.
Depending on your organizations needs, you may wish to hide, show, or reorder some items in the browsers main application bar and tab menu.
The items that appear in the main application bar and tab menu are customizable. You can remove items, change their order, and even add new items.
To open the menu and toolbar editor, tap the Customize Menus button on the Appearance tab of the Settings screen.
There are three menus to choose from:
The main menu and toolbar are located together on the application bar. While the tab menu is located at the top of each browser tab. (See Figure 6.)
Choosing Main Toolbar from the Select Menu screen displays the Main Toolbar customization screen. (See Figure 7.)
A checkmark alongside an item indicates that it will be displayed. You can introduce new items to the toolbar, or remove items by unchecking them. Items can be reordered by long pressing and dragging the item to a new position in the list.
There are two required items that cannot be unchecked: the Expand button in the Main Toolbar and the Administration item in the Main Menu. The Expand button is required so that the user can open the application bar menu to get to the Administration button.
The Night Dimmer Level setting controls the how dark the screen is when the Night Dimmer is engaged via the main application bar menu. This setting is visible in lock-down mode to allow it to be adjusted in different lighting conditions.
The Launchpad’s background image can be replaced by an image better reflecting your organization’s branding.
To select a new image, tap the existing image. A file-picker dialog is displayed.
NOTE: When exporting Airlock Browser’s configuration, the Launchpad background image is included in the configuration. The image is optimized to limit the overall file size of the exported configuration file.
To restore the default Launchpad background image, tap the Reset button.
The following three configurable theme colors allow you create a look to the app that better represents your organization:
The three color settings also determine the appearance of other UI elements within the app, such as dialog boxes, screen backgrounds, and buttons.
The Browser Tab Background setting determines the theme type of the app. If Browser Tab Background is set to a light color (such as white or yellow), the app adopts a light theme. While a dark tone, results in a dark theme. If a light theme is in place, screen and dialog boxes are white and text is gray. Conversely, a dark theme causes dark backgrounds and white text.
NOTE: Airlock Browser attempts to ensure that text is always readable. For example, if you select a light color (such as white) as your Browser Tab Background, the text color is switched to gray.
NOTE: Selecting white as both the Accent Color and the Application Bar Background causes the browsers default accent color to be used in some parts of the user interface, where readability would be otherwise compromised.
In this section you explore the items on the Device tab of the Settings screen.
Airlock Browser can be configured remotely using an exported configuration file. The file is hosted on a server and can be used to configure multiple devices. We discuss this in greater detail in the following section: Configuring Lock-Down Mode with the Administration Screen
Changing the Configuration File URL causes the browser to immediately attempt to download the configuration file and import the configuration. If configuration importation succeeds, a success message is displayed.
When Airlock Browser is launched, and periodically thereafter, the browser automatically looks for a configuration file located at ‘<External Directory>/Enterprise/Browser/Config.brs’. If the Configuration File URL setting has not been modified in the app’s setting screen, then the Config.brs is automatically applied. By deploying this file using your MDM solution, you can easily configure multiple devices without needing to manually make any changes to your devices. In addition, a different Configuration File URL setting may be present in the imported Config.brs file. This allows you to instruct Airlock Browser to download its configuration file from a different location from then on.
Before Airlock Browser imports a configuration file it first verifies that the file’s last modified date is more recent than the date of the last import. If it is not, the configuration file is not automatically imported.
NOTE: Settings from an imported configuration file override any local settings applied using the settings screen.
The License Server API Key is a value that is assigned to you by Outcoder or a third-party representative. This key allows you to assign, unassign, and reassign licenses for devices within your organization. All devices in your organization should have the same License Server API Key.
You can set the value directly, using the License Server API Key field. Or, you can set this value by placing the key in a file on the device.
The file must be named ApiKey.txt and must have the following path: [External Storage Directory]/Enterprise/Browser/ApiKey.txt
TIP: You can find the location of the external storage directory by browsing to the IO example page on your device, and using the Get External Directory button.
Once you procure a license for Airlock Browser, there are two ways to apply the license. The first, is to automatically have the license applied by setting the correct License Server API Key on each device. You can then manage and distribute purchased licenses using the Outcoder License Manager.
Alternatively, if your device does not have internet access, you can manually import the license using the Import License button in Administration -> Manage License.
Airlock Browser allows configuration of vendor specific settings for devices manufactured by Bluebird, CipherLab, Honeywell, Panasonic, and Zebra. Different device types offer different options for their hardware.
When Airlock Browser is running on a supported device from any of the above manufacturers, the Vendor Configurations button on the Device tab of the Settings screen takes you to the device configuration specific to the device type. However, when running Airlock Browser on a device such as a tablet that is not manufactured by one of the above manufactures, tapping Vendor Configurations from the Device tab of the Settings screen displays a list of device vendors; allowing you to configure multiple device vendor configurations, and allowing you to support multiple device types within the one exported configuration file. (See Figure 8.)
TIP: An alternate way to create a configuration supporting multiple device vendors, is to export the configuration from one device manufacturer and import it to a device from another manufacturer. You can then configure the device from the second manufacturer, while still retaining the configuration for the first.
The list of available settings varies for each of the vendor device types.
The Device Configuration screen uses a tabbed interface. You can tap the tab header or swipe to switch between configuration categories.
NOTE: Multiple vendor specific configuration may be configured on the device. The correct vendor configuration is applied automatically depending on the device. In this way, you are able to support multiple device vendors using the same configuration file.
Configure barcode symbologies by tapping the Barcode Symbologies button. A list of supported symbologies is displayed. (See Figure 9.)
It may improve barcode scanning performance to disable those symbologies that will not be needed. Tap on a symbology to configure it.
NOTE: For information regarding each vendor specific setting, including barcode symbologies, please see the documentation supplied by the vendor.
Each symbology may be enabled or disabled. (See Figure 10.) When a symbology is disabled it appears dimmed-out in the Symbology Selection screen.
Vendor device configurations are included in the exported configuration file.
The Administration Screen provides a step-by-step guide on how to set up the browser for your organization. (See Figure 11.)
The first two steps direct you to create application profiles on the Launchpad and to configure the app via the Settings screen.
Step 3, Set a configuration password is important because, once set, Airlock Browser will require the user to enter the password to access the Administration screen. Other parts of the application are also placed in lock-down mode, such as the Settings screen; which displays only a subset of the settings.
NOTE: You may also decide to disable the Settings menu item in the application bar. In this case, the only way to open the Settings screen is via the Administration screen after entering the configuration password.
The final step, ‘Export the configuration’ saves the settings and web profiles to a file. The configuration file can then be imported to another device using the ‘Import Configuration’ item on the Administration screen. Alternatively, the configuration file can be hosted on a web server and automatically imported using the ‘Configuration file URL’ option on the Device tab of the Settings screen.
If you specify the ‘Configuration file URL’ option, Airlock Browser periodically checks for an updated configuration and automatically imports the configuration; thereby allowing you to easily configure multiple devices at once.
Tapping the Manage License item displays the Manage License screen. (See Figure 12.)
NOTE: The Manage License screen is used to manually import a license and is designed for scenarios where internet access is not available. The preferred method for applying licenses is with the Licium License Manager. The Licium License Manager (LLM) provides an easy way to distribute licenses for Outcoder products such as Airlock Browser. LLM allows you to assign, revoke, or reassign licenses to devices within your organisation. In addition, it provides you with a bird’s eye view of products installed on devices within your organisation, and gives you back control over license distribution.
The Manage License screen allows you to export the serial number of the product, which can be provided to Outcoder or your supplier to procure a license. You can use the Save button, to save the serial number to a file. The Copy button copies the serial to the devices clipboard. While the Share button allows you to select another app, such as an email client, to send the serial number to yourself or a third-party.
Once a license has been procured, you can import the license using the Import item on the Manage License screen.
Web application profiles (AKA applications) represent web sites. They allow you to define the behavior of Airlock Browser when navigating to pages within your organization. Each application is represented as a tile on the launchpad. Tapping on a tile applies the settings for that application and opens the Web Address in a new browser tab.
To create a new web application profile, tap the + tile on the launchpad. (See Figure 13.)
The Web Address edit box defaults to the URL of the current active tab.
To edit an existing web application profile, long press its tile in the launchpad. A menu appears allowing you to edit the tile or delete the tile. When a tile is deleted from the applications section in the launchpad, it is deleted from the device.
The web application profile includes a Title field, the Web Address (URL), a tile color option, and several other options that we now explore.
The following are the three available execution events:
If On Page Load is selected, the script is invoked on the web page as soon as the page has loaded.
If Before Barcode Wedge is selected, the script is invoked before text is inserted into a field.
NOTE: When Before Barcode Wedge is selected, the Keyboard Wedge option must be enabled in the Web Application Profile settings for the script to be invoked.
NOTE: To receive a notification when a barcode scan occurs, you can also use the On Page Load option to subscribe to the
onScanevent is described later in this guide.
If After Barcode Scan is selected, the script is invoked after a barcode scan is performed, regardless of the Keyboard Wedge option in the Web Application Profile settings.
If you have a legacy web application that was not designed for a mobile device, you may apply custom CSS to the page to improve its appearance and usability. Tap the CSS button on the Web Application Profile screen to display the CSS editor.
When a page loads, the CSS is applied.
Web applications often use a device’s User Agent to determine the capabilities of the device and how to render content. Sometimes it is useful to impersonate a different device to coerce the web application to render content in a particular manner.
To achieve this in Airlock Browser, paste a custom user agent into the User Agent field. The user agent is applied for the web application profile’s browser tab. Each web application profile’s user agent setting is applied independently.
In some scenarios it may make sense to limit the automatic rotation of the screen to portrait or landscape orientation. Some pages may not render well in landscape (or portrait). To lock the orientation for web application, set the Screen Rotation option to either Lock Portrait or Lock Landscape. By default, Screen Rotation is set to Dynamic, meaning that the device is free to rotate the screen depending on the orientation.
Sometimes web pages that were originally designed for the desktop and not for mobile devices may have text that is too small to read. To increase (or decrease) the size of the text for a page, use the Web Page Text Size option on the Application screen.
The Scan Insert Mode setting allows you to control the placement of text into the active input field. If set to Replace, scanned barcode text replaces all content within the active input field. If set to Prepend, barcode text is inserted at the beginning of the active input field. Append sees the barcode text appended to the existing content of the active input field.
Use the Prefix scanned data with and Postfix scanned data with options to prefix and postfix the scanned data with any text.
In addition to the Prefix and Postfix options, you can also emulate keyboard presses when a barcode is scanned. The Emulate keys on scan or Emulate keys after scan options allow you to define a set of space delimited key codes, which are sent to the web page as simulated key presses.
Some example key codes are: 59 for SHIFT, 61 for TAB, and 66 for ENTER. See here for a complete list of available key codes.
The on scan keys are emulated before scanned text has been set or emulated; and after scan keys are emulated after scanned text has been set or emulated.
NOTE: Emulate keys on scan and Emulate keys after scan options are independent of the Prefix and Postfix options. This is especially evident when using the Set Text population method. When Emulate keys on scan is used in combination with Set Text, the emulated text will be removed from the active input field.
The History screen displays a searchable list of pages URLs, grouped by day. (See Figure 17.)
To delete the history items, tap the bin icon in the application bar.
NOTE: To prevent access to the History screen, uncheck the History item on the Main Menu screen, located at Settings -> Appearance -> Customize Menus -> Main Menu.
The Bookmarks screen allows the user to edit bookmarks, delete bookmarks, and to create new bookmark folders. (See Figure 18.) Tapping a bookmark closes the Bookmarks screen and opens the bookmark in a new browser tab.
To delete bookmarks or folders, select the list icon in the toolbar. Checkboxes appear next to each bookmark and folder, allowing you to delete individual bookmarks or entire folders. If you mistakenly delete a bookmark or a bookmark folder, use the undo button, in the application bar menu, to restore the item or items.
NOTE: To prevent access to the Bookmarks screen, uncheck the Bookmarks item on the Main Menu screen, located at Settings -> Appearance -> Customize Menus -> Main Menu.
To create a new bookmark, select Add Bookmark from the main screen’s tab menu. The Add to Bookmarks dialog allows you to enter a name for the bookmark, which defaults to the page title. The URL is also editable.
You can choose to place the bookmark into an existing folder within the bookmarks screen, or leave the bookmark in the unsorted folder.