Skip to content

Security Settings

The Security tab has three sections: who may use passkeys, recovery codes, and brute force protection. Open Configuration → Security.

The Security tab

The Access section

  • Allowed Roles: Only these roles can add and use passkeys. Empty, the default, allows everyone. A user outside these roles loses the Passkeys page, and their saved passkeys stop signing them in.
  • Require a Passkey For: Users with these roles must add a passkey. During the grace period they see a reminder. After it, they can only reach their passkey page until they add one. Empty by default.
  • Grace Period (Days): Default 7. How long a required user may keep working without a passkey. 0 enforces at once.
  • Passkey-Only Sign In: Once users with these roles have a passkey, their password no longer signs them in. They use the passkey or a recovery code. Empty by default. Add your own passkey before you add your role.
  • Passkeys Per User: Default 5. Most people need one per device. 0 means no limit.

With the limit reached, Add a passkey disappears from the customer’s page and a note says how many are allowed. On the demo, the limit was set to 2 with two passkeys saved:

You can register up to 2 passkeys. Remove one to add another.

The Recovery Codes section

  • Recovery Codes: Ticked by default. Each user gets one-time codes after their first passkey, shown once. Only scrambled copies are stored. Needed for a safe passkey-only setup.
  • Codes Per User: Default 10, from 1 to 20. Each code works once. Users can create a new set at any time, which replaces the old one.

The Brute Force Protection section

  • Failed Attempts Limit: Default 5. Failed passkey or recovery code sign ins allowed from one IP address before it is locked out. 0 turns the lockout off.
  • Lockout Duration (Minutes): Default 15.
  • Behind a Proxy: Off by default. Reads the visitor’s IP address from proxy headers. Turn it on only when every visitor shows up in Activity with your proxy’s address, for example behind a load balancer.

A lockout covers passkey and recovery code sign ins only. The password form is not part of it.