Add Locker Custom Options

Created: Modified: Documentation

NOTE: This article applies to the Locker app (iOS) and Locker app (Android).

Administrators are able to add Locker Custom Options to their Workflows, unlocking additional functionality when deploying devices.

  • When Custom Options are set, they override what is set in AppConfig. When Custom Options are not set, the values in AppConfig are used.
  • Locker Custom Options are applied after the device is next checked in, when the device is locked and not actively performing any actions.
Supported Locker Custom Options

NOTE: Additional Locker Custom Options may be provided by Imprivata Support to tune behavior. For more information, contact support@imprivata.com.

Prerequisites

Take note of the following prerequisites:

  • Requires that your organization be enabled for Check Out.
Configure Locker Custom Options

Add Locker Custom Options to your devices by one of the following methods:

  • At a global level by an Admin > Check Out setting.
  • To multiple devices by adding the Locker Custom Options to your Workflow.
  • To a single device by its Device Details.
Add Locker Custom Options Globally
  1. In the MAM admin console, navigate to Admin > Check Out > Locker Custom Options, click Configure.
  2. In the Locker Custom Options field, enter the key/value pairs in JSON format and click Save.
    You can add several key/value pairs to your JSON in the following format:

JSON Syntax

 {
    "customOption1": "value1"
    "customOption2": "value2"
    "customOption3": "value3"
}

Example

 {    
    "DefaultDomain": "mydomain.onmicrosoft.com"
    "LiveActivityEnabled": true
}
Add Locker Custom Options to Multiple Devices

iOS and Android devices

To apply custom options to multiple devices at once, add the Custom Options action to a Workflow.

  1. In the MAM admin console, navigate to Workflows.
  2. Create a new Workflow, or edit an existing Workflow.
  3. Click Add an action > Advanced > Locker Custom Options.
  4. Enter the key/value pairs in JSON format and click Save.
  5. Click Save Workflow and Deploy.
Add Locker Custom Options to a Single Device

iOS and Android devices

To apply custom options to a single device:

  1. In the MAM admin console, navigate to Devices, and select the device from the Device List.
  2. In the Device Details dialog, click Custom Options.
  3. Click Edit, edit the JSON key/value pairs and click Save.