Security
Password policy, lockout, session timeout, 2FA, magic-link login, and SSO enforcement.
Overview
Security settings control password rules, login lockout, session timeout, two-factor requirements, magic-link login, and which roles must use SSO.
Where it lives
Route: /admin/settings/security (admin.settings.security)
Open Admin → Users & Security → Security. Requires settings.manage.
Key settings
| Section | Settings |
|---|---|
| Password Policy | Minimum Password Length (6–128); Require uppercase and lowercase letters; Require number; Require special character |
| Login Security | Max Login Attempts; Lockout Duration (minutes) |
| Session | Session Timeout (minutes) (5–1440) |
| Two-Factor Authentication | Require 2FA for admin users; Require 2FA for all users |
| Passwordless Login | Email magic-link login — never bypasses 2FA |
| Single Sign-On Enforcement | Role checkboxes (excludes Owner) |
Save shows an inline confirmation (no full reload).
Stored settings
| Setting | Type | Default |
|---|---|---|
security.password_min_length | integer | 8 |
security.password_require_uppercase | boolean | false |
security.password_require_number | boolean | false |
security.password_require_special | boolean | false |
security.session_timeout | integer | 120 |
security.max_login_attempts | integer | 5 |
security.lockout_duration | integer | 15 |
security.require_2fa_admin | boolean | false |
security.require_2fa_all | boolean | false |
security.sso_enforced_roles | json | [] |
security.magic_link_enabled | boolean | false |
At a glance
| Setting | Description |
|---|---|
| Minimum Password Length | Minimum characters required (6–128, default 8) |
| Require uppercase and lowercase letters | Require mixed-case passwords |
| Require number | Require at least one number |
| Require special character | Require at least one special character |
| Max Login Attempts | Password attempts admitted per email and connection IP during the lockout window (default 5); success clears the counters |
| Lockout Duration (minutes) | How long a locked account waits (default 15) |
| Session Timeout (minutes) | Inactive sessions expire after this duration (5–1440, default 120) |
| Require 2FA for admin users | Require two-factor authentication for admin users |
| Require 2FA for all users | Require two-factor authentication for all users |
| Email magic-link login | Allow sign-in via a one-time emailed link (never bypasses 2FA) |
| SSO enforcement | Roles that must sign in with single sign-on (Owner excluded) |
Related
- API Tokens
- Integrations — SSO provider credentials