Add Locker Custom Options

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 Locker Custom Options are set, they override what is set in AppConfig. When Locker 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 MAM 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 MAM’s 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

Copy 
{
    "CustomOption1": "value1"
    "CustomOption2": "value2"
    "CustomOption3": "value3"
}

Example

Copy 
{    
    "DefaultDomain": "mydomain.onmicrosoft.com"
    "LiveActivityEnabled": true
}
IMPORTANT:

The key portion of Locker Custom Options key/value pairs are case-sensitive. The values may be case-insensitive.

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 MAM’s 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 to the devices.

Add Locker Custom Options to a Single Device

iOS and Android devices

To apply custom options to a single device:

  1. In MAM’s admin console, navigate to Devices, and select the device from the Device List. In the Device Details dialog, click Custom Options.

  2. Click Edit, enter the key/value pairs in JSON format and click Save.

  3. Click Deploy Workflow to deploy to the device.