Skip to content

Single sign-on

People always sign in through ZITADEL. Your identity provider (IdP) is federated into it, so people use their company account.

  • Permission: Manage settings (settings:write).
  • An organization, not a personal workspace.
  • Your IdP’s issuer URL and client details (OIDC), or its metadata URL (SAML).
  1. Go to Devices & Access › Single sign-on and choose Add provider.
  2. Choose the Protocol: OpenID Connect or SAML 2.0.
  3. Enter the Issuer URL, Client ID and Client secret (optional), or the Metadata URL for SAML.
  4. Save.

EndpointWorks records the provider. EndpointWorks support then finishes the federation in ZITADEL. Test sign-in with one account before you tell everyone.

Replace secret rotates a stored client secret. Secrets are never shown again.

  1. Under the provider, choose Add mapping.
  2. Enter the IdP group and choose a role.

Everyone in that group gets the role at sign-in. The highest matching role wins. Mapping a group to Super admin asks you to type the group name to confirm.