Skip to main content

User management

The driver can manage PIN users directly on the 2N device from the Crestron Home app — add, edit and remove users, each with a PIN and an optional access schedule. When a user unlocks the door at the keypad, the driver attributes the Unlocked from keypad event to that user.

API account privileges

User management uses the 2N Directory API, so the API account you configured on the device needs directory / access-control privileges. Lock control does not depend on user management.

Limits

  • Up to 1000 users per device.
  • PIN length: 4–10 digits.
  • Users are managed from the standard Crestron Home lock user interface — nothing extra needs configuring on the 2N device.

Access schedules

Each user can be given one of the following schedule types, set per user in the Crestron Home app:

ScheduleMeaning
AlwaysNo time limits — access whenever the user enters their PIN.
TemporaryAccess only within a fixed start/stop window.
WeeklyAccess on a recurring weekly pattern.
Weekly with durationA recurring weekly pattern bounded by an overall start/stop window.

How weekly schedules are enforced

The 2N HTTP API cannot create device time profiles, so the driver does not rely on one. Instead it enforces a weekly schedule as the user's validity window on the device and rolls that window forward as each occurrence passes.

Because the 2N device enforces the expiry itself, access fails secure: if the Crestron processor goes offline, a user's window expires rather than staying open. The recurrence is stored by the driver, so schedules survive a restart.

Keypad access events

When a valid PIN is entered at the 2N keypad, the driver:

  • reports an Unlocked from keypad lock event, and
  • attributes it to the matching user by PIN, so the event shows who unlocked the door.