Skip to main content

Identity provider setup

One page per identity provider, written for the customer's IdP admin. The DFE operator sends the admin the page for their IdP plus two values: the DFE console host and the provider name. The admin follows the page once and sends back the client credentials, the issuer and the group identifiers.

IdPPageDFE provider typeA group links on
Google Workspacegoogle.mdgoogleThe Cloud Identity group id, the part after groups/
Microsoft Entra IDentra.mdentra_idThe group's object id (a GUID)
Oktaokta.mdoktaThe group name the groups claim carries

Every page uses the same redirect URI, built from those two values:

https://<your DFE console host>/api/v1/auth/oidc/<provider-name>/callback

The operator creates the provider with POST /api/v1/auth/oidc-providers and links each DFE group by setting two fields in its group file: source_provider, the provider name, and source_id, the identifier from the table. A group file with a source_id and no source_provider loads unlinked, with a warning naming it in the engine log: no sign-in reaches it through that id. The provider model and the linking rules are in rbac.md, section 4.