Sovrain
  1. Documentation
  2. Your organization

Reference

Limits

Lifetimes, rate limits, sizes, counts and retention periods in Sovrain.

Every fixed number in Sovrain, by kind. Where an admin or the operator can change one, the row says so. Settings an admin can change are on Organization settings and Application settings.

KB, MB and GB here mean KiB (1024 bytes), MiB and GiB.

ItemLifetime
Sovrain session60 days from sign-in. No idle timeout.
Fresh sign-in for sensitive changes5 minutes. A form opened within them can be sent up to 30 minutes later.
Second step after the password5 minutes
Password reset link sent by the person15, 30 or 60 minutes, as set under Account recovery (default 30)
Link to reset two-step sign-in by emailSame as the password reset link
Password reset link created by an admin24 hours
Second step proven during a reset10 minutes
Invitation link7 days
Email verification link and code7 days
Code to resume paused emails24 hours; lifts the pause for 24 hours
Backup import key24 hours

Tokens

TokenLifetime
OpenID Connect authorization code60 seconds, single use
ID token5 minutes
Access token1 hour
Access token of a delegated sign-in5 minutes
Refresh tokenUntil the Sovrain session ends (at most 60 days); single use
Logout token2 minutes
SAML assertionValid from 30 seconds before to 5 minutes after it is issued
SAML request clock skew±5 minutes
Admin API device code10 minutes; poll every 5 seconds
Admin API access token10 minutes
Admin API grant30 days after the last refresh; at most 90 days after approval

Rate limits

Counted per client IP address unless noted. Each budget refills in full at the end of its period. Over a limit, pages show Too many attempts and programs get 429.

WhatLimit
Sign-in, password change, account deletion20 per 15 minutes; sign-in also per typed login name or email
Second step at sign-in and during a reset60 per 15 minutes
Second step, per pending sign-in5 per 5 minutes
Wrong second steps, per account10 per hour
Adding a second step60 per hour
Password reset request5 per 15 minutes; also per typed login name or email
Setting a new password from a reset link20 per 15 minutes
Registration and accepting an invitation10 per hour
Organization address check during registration120 per 15 minutes
Email verification code, resume code10 per hour each
Invitation emails200 per hour; per IP address in the admin pages, per admin in the Admin API
Re-entering the password for a backup5 wrong per 15 minutes
Export1 per organization per 60 seconds
Import1 per organization per 5 minutes
OpenID Connect authorization300 per minute
OpenID Connect token300 per minute
OpenID Connect userinfo600 per minute
OpenID Connect sign-out120 per minute
Device authorization20 per minute
Token revocation30 per minute
Device code entry10 per 5 minutes
SAML single sign-on and logout300 per minute
Admin API600 per minute, per grant
Delegation account choice120 per minute
Delegation second step60 per 15 minutes
Delegation people search120 per minute, per person
Creating or changing delegations30 per 5 minutes per person; 300 per 5 minutes per admin

There is no account lockout after wrong passwords; only these limits apply.

Emails

ItemLimit
Verification and password reset emails to one address5 per hour. The sixth request sends one We’ve paused emails to your address notice per hour; further emails are dropped.
Delegation emails to one address30 per hour
Sign-in-as-you alerts to a delegation owner30 per hour; then one notice

Accounts, groups and attributes

ItemLimit
Users and groups per organizationNo limit
Login name3 to 32 characters from a-z 0-9 . _ - (stored in lower case); people invited by email have their address, up to 254 characters, as typed
Email address3 to 254 characters
PasswordAt least 8 characters, at most 72 bytes (longer is refused, not cut). No other rules.
Display name, first name, last nameNo limit
Custom attribute nameAt most 64 characters
Custom attribute descriptionAt most 256 characters
Custom attribute valueNo limit
Invitation batch100 entries, each at most 254 characters
Pasted invitation list1 MB, lines of at most 64 KB; upload at most 1 MB
Bulk group change2000 groups × 500 users
Members changed at once10,000
Pasted member list1000 entries, 200,000 characters
Undo of a membership changeUp to 500 people
Authenticator apps per account5
Security keys and passkeys per account10 together
Backup codes10 per set

Applications

ItemLimit
Applications per organizationNo limit
Application slug2 to 63 characters from a-z 0-9 -
Redirect URIs, post-logout redirect URIsNo limit on number or length
Custom claim nameAt most 64 characters
Back-channel logout calls per sign-out20 applications; one attempt each; 3 seconds to connect, 5 seconds in total
Front-channel logout frames per sign-out20
SAML request64 KB encoded, 128 KB inflated; POST body 256 KB
SAML XML64 levels, 100,000 elements, 128 attributes per element
SAML Default RelayState80 bytes
SAML RequestedAuthnContext16 references
SP metadata document2 MB; URL fetch 10 seconds
SCIM token8192 characters
SCIM request10 seconds; response at most 4 MB
SCIM mappings200
SCIM scope5000 groups and 5000 users
SCIM group name in the application255 characters
SCIM reconciliation50,000 entries, 45 seconds

Organization

ItemLimit
Organization address (slug)2 to 63 characters from a-z 0-9 -; 148 reserved words
Custom domains1
Brand icon128 KB, PNG or SVG
Application name, title prefix40 characters
Form body64 KB, except uploads
Backup file to import50 MB
Password manager storage1 GB per organization (default; operator setting IDP_VAULT_BLOBS_ORG_QUOTA)
Password manager attachment8 MB, checked in the browser; the operator setting IDP_VAULT_BLOBS_BLOB_LIMIT can lower the limit the server accepts, but not raise this one
Password manager entry256 KB; 16 KB of search index

Retention

DataKept
Application activity (sign-in events per application)90 days
SCIM jobs30 days
Ended OpenID Connect and SAML sessions30 days
Admin API call records1 day
Delegation eventsKept; the IP address is cleared after 90 days
Security events, mail log, backup historyNot deleted by age
Removed users (admin Remove)Kept in the database and in exports