Using Deep Links To Apply A PIN On Android Devices

This article explains how to use deep links (intents) to automatically configure the NowSignage Android application with an authentication PIN. It is intended for integrators and device management systems (MDM) such as SOTI, ADB, or any tool capable of sending intents to Android devices.

Intent Format:

General Scheme

JSON Format

The JSON payload should include the pin_code to configure the device. Note: The PIN in examples is illustrative; replace it with the actual screen PIN.

Important: The JSON must be URL-encoded before including it in the deep link.

Commands to Send the Intent:

1. SOTI (Send Intent)

2. ADB (Android Debug Bridge)

3. Open from an Android Browser

If the device allows opening deep links from a browser:

Rules for pin_code:

• Must be 5 to 8 characters long.

• Can include letters and numbers only (a-z, A-Z, 0-9).

• No spaces or special characters allowed.

Valid Intent Examples

Expected Behaviour in the App

1. The app receives the intent with the pin_code.

2. It validates the format and checks the code against the server.

3. If the PIN is correct, the screen configures automatically.

4. If the PIN is incorrect, an error message is displayed.