Sovrain
  1. Documentation
  2. Get started

Reference

Glossary

The terms used in Get started, with what each means in Sovrain.

Terms in alphabetical order. Labels from the screens are in bold.

Access token
A short-lived token an application receives at sign-in and sends to the userinfo endpoint. Valid 1 hour. See OpenID Connect.
Admin, administrator
A member of the built-in group Admins. Has the admin pages and the Admin API.
All
The built-in group that everyone in the organization belongs to.
Application
A service people sign in to through Sovrain, or receive accounts in through SCIM. Types: OpenID Connect (SSO), SAML 2.0 (SSO) and Standalone SCIM (provisioning only).
Backup code
One of 10 single-use codes that replace the second step when the usual method is out of reach.
Claim
A named value in an OpenID Connect token, such as email or groups. See Claims and attributes.
Client ID, client secret
The identifier and the password of an OpenID Connect application. The secret is shown once.
Discovery document
The JSON at /.well-known/openid-configuration that lists an organization’s OpenID Connect endpoints and features.
Group
A set of people your admins manage. Groups give access to applications, and the password manager can share an entry with a group: each member you trust gets a copy.
Group access
The groups whose members may sign in to an application, each with an optional role.
ID token
The signed token that tells an OpenID Connect application who signed in. Valid 5 minutes.
Invitation
A link that lets a new person choose a password and join the organization. Valid 7 days.
Issuer
The address that identifies an organization as an OpenID Connect provider: https://acme.sovrain.net, or the primary custom domain.
Login name
The name a person signs in with, 3 to 32 characters, or the email address for people invited by email.
Member
Anyone in the organization. Members who are in neither Owners nor Admins have no admin rights.
Organization
A company’s space in Sovrain, with its own people, groups, applications and settings, at its own address.
Organization address
The acme in https://acme.sovrain.net. Chosen at registration; it cannot be changed.
Owner
A member of the built-in group Owners. Like an administrator, and also can import backups and reset other administrators’ sign-in.
PKCE
A protection for the authorization code (code_challenge and code_verifier, method S256). Required by default.
Redirect URI
The address Sovrain sends a person back to after OpenID Connect sign-in. Must be registered exactly.
Scope (OpenID Connect)
A name an application asks for to receive a set of claims: openid, profile, email, groups.
Second step, second factor
What a person shows after the password: a code from an authenticator app, a security key, a passkey or a backup code.
Slug
The short name of an application in its URLs and in the API, such as portal.
Two-step sign-in
Signing in with a password and a second step. See Two-step methods.
Userinfo
The OpenID Connect endpoint that answers claims about the person for an access token.