Sign In with an Identity Provider
Dexter signs people in through any OpenID Connect (OIDC) provider. It has presets for Okta, Microsoft Entra ID, Google, and Auth0, and Other OIDC covers any provider that publishes a standard discovery document.
The local admin account from the install keeps working alongside the providers you add.
Step 1: Register Dexter in the provider
-
In Dexter, open Admin > Identity providers, click Add provider, and pick the provider.
The first step of the form shows the Redirect URI to register,
https://<HOST>/auth/callback/<CONNECTION_ID>, with a copy button.<CONNECTION_ID>comes from the display name and is fixed once you save. -
In the provider, register Dexter as a confidential web client with that redirect URI:
-
Okta: create an OIDC Web Application.
-
Entra ID: add an app registration with a Web platform.
-
Google: create an OAuth client of type Web application.
-
Auth0: create a Regular Web Application.
-
Any other provider: register a confidential OIDC client.
-
-
Copy the provider’s client ID and client secret.
Step 2: Add the provider in Dexter
Back in the form:
-
Enter a Display name. It labels the sign-in button.
-
Enter the Issuer URL, and click Test connection to check that Dexter can read the provider’s discovery document. See Issuer URLs for each provider’s format.
-
Paste the Client ID and Client secret. To keep the secret out of Dexter’s settings, leave it empty: Dexter then reads it from the environment variable the form names.
-
When this is the first provider, Dexter also asks for an Admin email. Adding the first provider turns sign-in through providers on, so name who will be admin, comma-separated.
-
To make members of a provider group admins, turn on Read the groups claim, and under Advanced, list the groups in Admin groups.
-
Under Advanced, change the Email claim or Name claim only if the provider puts them under other names.
-
Click Add provider.
The sign-in screen shows a button for the provider. The provider’s card shows its redirect URI and status, for example Active · no sign-ins yet.
Issuer URLs
The issuer is the field most often set wrong. Dexter discovers the provider’s endpoints from it at sign-in.
| Provider | Issuer URL | Notes |
|---|---|---|
Okta |
Or the path of a custom authorization server. |
|
Entra ID |
Includes the tenant ID. Some tenants need |
|
The same issuer for every Google Workspace. |
||
Auth0 |
Keep the trailing slash. |
|
Other OIDC |
The provider’s issuer |
The provider must publish |