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 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

• Configure a Default Domain

• Configure Personalized Lock Screen using Live Activities

• Automatically Launch Apps after Checkout - Android

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

{
    "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 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.