Setting up your identity provider

Organizations can choose to set up their identity provider (IdP) for storing and authenticating the identities that their users use to log in to their systems and applications.

Redocly currently only supports connecting using the OpenID Connect (OIDC) identity provider for advanced functionality including RBAC and API gateway proxy integrations.

Set up Org Settings

In this task, organization owners set up their OIDC details, including the config URL, Client ID and Client Secret key for their organization in Redocly Workflows.

Log into Redocly Workflows and select Org Settings.
From the left, select Identity providers.
Under OpenID Connect, enter the following information:
- Configuration URL (.well-known) - The OpenID configuration URL for your identity provider. This is typically in the format https://{identity-provider-hostname}/.well-known/openid-configuration
- Client ID - Unique ID to identify Redocly with your IdP authorization server.
- Client Secret - Secret password that only Redocly and your IdP authorization server know.
Note: Organization owners can find out these details from their identity provider. For more information, see the Identity providers and OIDC configuration section.
Under Scopes, select email and profile to set your scope during authentication to authorize access.
Select Update OIDC Settings to save your changes.

Once you have configured your OIDC settings, you can set up access control to your:

Developer portal
Reference docs

Set up access control for your Developer portal

Using these instructions, you can set up access control to your Developer portal using the OIDC details. Organization owners can set up access control individually for as many portals as required.

In Redocly Workflows, select Portals.
Select the Portal you want to set up access control. The Portal Overview page is displayed.
Select Settings to view the Portal settings.
On the Settings page, from the left, select Access control.
Under the Access control section,
- Select Public and tick Allow login.
- Select OIDC from the dropdown.
Select Apply to save your settings.

You have now successfully set up access control for your Developer portal.

Set up access control for your Reference docs

Using these instructions, you can set up access control to your reference docs using the OIDC details. Organization owners can set up access control individually for as many reference docs as required.

In Redocly Workflows, select Reference Docs.
Select the Reference docs you want to set up access control. The Overview page is displayed.
Select Settings to view the Reference docs settings.
On the Settings page, from the left, select Access control.
Under the Production section, select OIDC Members only.
Select Apply to save your settings.