keycloak-oidc

Configure Keycloak OIDC clients, realms, and role mappings for SSO.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/MassimilianoPili/claude-code-config --skill keycloak-oidc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: keycloak-oidc
Source: https://github.com/MassimilianoPili/claude-code-config/tree/main/skills/keycloak-oidc
Command: npx skills add https://github.com/MassimilianoPili/claude-code-config --skill keycloak-oidc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the complex process of integrating various applications with Keycloak for Single Sign-On (SSO), managing authentication flows, and securing access.

Core Features & Use Cases

  • OIDC Client Configuration: Set up new OIDC clients, manage redirect URIs, and configure role mappings for granular access control.
  • SSO Debugging: Troubleshoot login failures, redirect loops, and token validation issues across different integration patterns.
  • Use Case: You need to integrate a new internal tool with your existing Keycloak setup for seamless user authentication. This Skill provides the patterns and configurations to achieve this efficiently.

Quick Start

Configure a new OIDC client for the 'my-app' service in the 'sol' Keycloak realm, ensuring it uses the Authorization Code flow with PKCE.

Frequently Asked Questions about keycloak-oidc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a Keycloak OIDC client for Single Sign-On?

Configuring a Keycloak OIDC client for Single Sign-On involves setting up the client within a realm, defining redirect URIs, and applying role mappings. This Skill provides the patterns to manage these OIDC identity provider configurations and secure authentication flows.

Why does my Keycloak SSO login fail with a redirect loop?

Keycloak SSO login failures and redirect loops often stem from mismatched redirect URIs or incorrect dual-URL patterns in self-hosted infrastructure. This Skill helps troubleshoot these validation issues across native OIDC, OAuth2 Proxy, and JWT bearer integration patterns.

What is the best way to integrate Keycloak OAuth2 Proxy with my internal application?

The best way to integrate Keycloak OAuth2 Proxy is by applying the correct OIDC identity provider configuration patterns for your realm. This Skill guides you through client registration and securing browser and API flows for diverse integration patterns.

Can I use JWT bearer authentication with Keycloak for my API security?

Yes, you can secure APIs using JWT bearer authentication with Keycloak by validating tokens issued from your realm. This Skill addresses configuring JWT bearer integration patterns and managing the necessary OIDC client setup for robust API security.

How do I set up Keycloak realm role mappings for granular access control?

Setting up Keycloak realm role mappings for granular access control requires configuring specific roles during your OIDC client registration. This Skill manages these role mappings to ensure correct authorization across your integrated applications.

Does Keycloak OIDC support dual-URL patterns for self-hosted infrastructure?

Yes, Keycloak OIDC supports dual-URL patterns for self-hosted infrastructure, addressing the distinct security flows required by browsers and APIs. This Skill specifically handles these self-hosted infrastructure challenges to ensure reliable SSO integration.