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
emailorgroups. 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-configurationthat 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
acmeinhttps://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_challengeandcode_verifier, methodS256). 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.