Skip to main content

Manage OpenID providers

Learn how to manage OpenID providers through the Desk API.

For Desk integrations enabled with OpenID Bridge, the OpenID Connect providers resource allows for adding, updating and removing OpenID Connect providers in OpenID Bridge.

Bridge enables the acceptance of credentials for OpenID Connect login using the authorization code flow. See the OpenID Bridge docs for product and integration information.

Enable these endpoints​

Before the /api/openid-provider/v1 endpoints can be used to manage OpenID providers in OpenID Bridge, the Desk must be configured to enable these endpoints.

In the application.yaml file of Desk, add an entry for Bridge:

bridge:
  enabled: true
  url: { YOUR-BRIDGE-URL }
  token: { BRIDGE-TOKEN }
  api:
    url: ${YOUR-BRIDGE-URL}/api
    discoveryUrl: ${YOUR-BRIDGE-URL}/.well-known/openid-configuration

Once enabled, managing OpenID providers can be done directly through the Desk API by anyone with the OPENID_PROVIDER_EDIT permission, bypassing the need to use the OpenID Bridge endpoints.