Skip to content

Add OIDC Provider to KeyCloak

Warning

This is not a complete recipe - it's an optional component of the Keycloak recipe, but has been split into its own page to reduce complexity.

Having an authentication provider is not much use until you start authenticating things against it! In order to authenticate against KeyCloak using OpenID Connect (OIDC), which is required for Traefik Forward Auth, we'll setup a client in KeyCloak...

Ingredients

Summary

Existing:

New:

  • The URI(s) to protect with the OIDC provider. Refer to the Traefik Forward Auth recipe for more information

Preparation

Create Client

Within the "Master" realm (no need for more realms yet), navigate to Clients, and then click Create at the top right:

Navigating to the add user interface in Keycloak

Enter a name for your client (remember, we're authenticating applications now, not users, so use an application-specific name):

Adding a client in KeyCloak

Configure Client

Once your client is created, set at least the following, and click Save

  • Access Type : Confidential
  • Valid Redirect URIs : <The URIs you want to protect>

Set KeyCloak client to confidential access type, add redirect URIs

Retrieve Client Secret

Now that you've changed the access type, and clicked Save, an additional Credentials tab appears at the top of the window. Click on the tab, and capture the KeyCloak-generated secret. This secret, plus your client name, is required to authenticate against KeyCloak via OIDC.

Capture client secret from KeyCloak

Summary

We've setup an OIDC client in KeyCloak, which we can now use to protect vulnerable services using Traefik Forward Auth. The OIDC URL provided by KeyCloak in the master realm, is https://<your-keycloak-url>/realms/master/.well-known/openid-configuration

Summary

Created:

  • Client ID and Client Secret used to authenticate against KeyCloak with OpenID Connect

Chef's Notes 📓

Tip your waiter (support me) 👏

Did you receive excellent service? Want to make your waiter happy? (..and support development of current and future recipes!) See the support page for (free or paid) ways to say thank you! 👏

Flirt with waiter (subscribe) 💌

Want to know now when this recipe gets updated, or when future recipes are added? Subscribe to the RSS feed, or leave your email address below, and we'll keep you updated. (double-opt-in, no monkey business, no spam either - check the archive for proof!)

Your comments? 💬