oidc

Configure and verify Vault OIDC integration with Keycloak using HAL commands.

29|8|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/hashimiche/hal --skill oidc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oidc
Source: https://github.com/hashimiche/hal/tree/main/internal/skills/data/vault/oidc
Command: npx skills add https://github.com/hashimiche/hal --skill oidc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deploy, verify, and troubleshoot Vault's OIDC integration with Keycloak for local development labs and demos, enabling seamless SSO and identity management.

Core Features & Use Cases

  • Configure the OIDC auth method in Vault and map Keycloak groups to Vault identity groups
  • Verify configuration and roles using Vault commands and Keycloak settings
  • Troubleshoot common issues such as redirect URIs, discovery URL, and group mappings for a smooth demo

Quick Start

Initiate the lab by enabling Vault OIDC with HAL using hal vault oidc enable, then verify with vault read auth/oidc/config

Frequently Asked Questions about oidc

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

FAQPage Schema
How do I configure Vault OIDC with Keycloak for SSO?

Configure Vault OIDC with Keycloak by enabling the auth method via HAL commands, mapping Keycloak groups to Vault identity groups, and verifying the setup using vault read auth/oidc/config.

What's the best way to troubleshoot Vault OIDC login flows with Keycloak?

Troubleshoot Vault OIDC login flows by verifying redirect URIs, checking the discovery URL configuration, and validating group mappings between Keycloak and Vault identity groups for a smooth demo.

Do I need specific ports for Vault and Keycloak to set up OIDC?

Vault OIDC setup requires Vault accessible at 127.0.0.1:8200 and Keycloak accessible at port 8081 to successfully configure and verify the local development SSO integration.

Can I reset Vault OIDC configurations after enabling them?

Vault OIDC configurations can be reset using HAL commands hal vault oidc enable, update, and disable to manage, modify, or remove the Keycloak SSO integration during local development.

How does mapping Keycloak groups to Vault identity groups work?

Mapping Keycloak groups to Vault identity groups links external identity provider roles to internal policies, enabling seamless SSO access control and identity management within the local Vault environment.

Why does my Vault OIDC redirect URI fail during Keycloak SSO setup?

Vault OIDC redirect URI failures occur when the configured callback endpoint does not match Keycloak's client settings, requiring verification of discovery URLs and group mappings to resolve.