1. Prerequisites

1.1 Custom Build

The general build of the Suprema Plugin is designed for standalone operation, prioritizing communication with the Cloud Link over OSDP/Wiegand communication
The typical authentication flow is as follows:

  1. The user authenticates at the device.

  2. The device sends user data to the Plugin.

  3. The Plugin forwards the user's credential(First, Active, and supported) to the Cloud Link.

  4. The Cloud Link verifies access rights for the credential and sends the result back to the Plugin.

  5. The Plugin returns the access result to the device, which then displays it (grant/deny).

A delay may occur at step #3 for the following reason:
If the device is not mapped to a Door, the Cloud Link will not generate an access decision result.
In this case, the OSDP sequence does not operate until the Plugin process times out and completes.

? Note: In Cloud Link–centric architectures, all access decisions are handled by the Cloud Link itself.
However, when using Suprema devices with a Mercury board, this behavior should be disabled, allowing the controller (Mercury) to perform access verification and decision instead.

1.2 Custom Firmware

When a Suprema device operates as an OSDP peripheral connected to a 3rd-party controller (such as a Mercury board), the standard firmware has the following limitations:

  • On Access Denied events, only an Exception Code is transmitted — card data is not included.
    → Use custom firmware if card data transmission is required.

  • User ID / Name display is not supported.

2. Configuration Guideline

2.1 Access Rule Setup 

  • Create an Access Rule named SUPREMA_WHITELIST. 

    (Config Tool _ Access Control _ Access Rule)


  • Map All Cardholders to this Access Rule.

    (Config Tool _ Access Control _ Cardholders)

2.2 Cardholder synchronization

  • Needs to click Sync now button 

  • Suprema devices do not need to be mapped to Doors.

  • However, Cloud Link mapping is required.

? Result: All active cardholders will be synchronized to all Suprema devices,
ensuring consistent operation even when the access decision is made at the controller side.