OfficialToolConfig as code / DevOpsActive
terraform-provider-keycloak
keycloak/terraform-provider-keycloak ↗
Terraform provider for managing Keycloak resources.Keycloakリソースを管理するTerraform provider
- ★
- 956
- Forks
- 452
- Contributors
- 238
- Updated
- 2026-10-13
- KC
- —
- License
- Apache-2.0
What it can doできること6
- Manage Keycloak as Terraform resources — realms (keystores, events, localization, user profile, client policies), OIDC and SAML clients, client scopes and protocol mappers.KeycloakをTerraformリソースとして管理。realm(キーストア、イベント、ローカライズ、ユーザープロファイル、クライアントポリシー)、OIDC/SAMLクライアント、クライアントスコープ、プロトコルマッパー
- Manage users, groups, roles and memberships, organizations, required actions and default roles/groups.ユーザー、グループ、ロールと所属、Organization、Required Action、デフォルトロール/グループを管理
- Manage authentication flows, subflows, executions and their configs, plus flow bindings.認証フロー、サブフロー、Executionと設定、フローのバインドを管理
- Manage identity providers (generic OIDC/SAML, Google, GitHub, Microsoft, Facebook, OpenShift, Kubernetes, SPIFFE) and their mappers.IdP(汎用OIDC/SAML、Google、GitHub、Microsoft、Facebook、OpenShift、Kubernetes、SPIFFE)とマッパーを管理
- Manage LDAP user federation and its mappers, custom user federation, client authorization resources/policies/permissions and fine-grained admin permissions.LDAPユーザーフェデレーションとマッパー、カスタムフェデレーション、クライアント認可(リソース/ポリシー/パーミッション)、細粒度の管理者権限を管理
- Authenticate with client credentials (secret or signed JWT), password grant, a provided access token, and optionally an mTLS client certificate.クライアントクレデンシャル(シークレット/署名JWT)、パスワードグラント、事前発行のアクセストークンで認証でき、mTLSクライアント証明書も使える
What it cannot do / limitsできないこと・制約4
- Not a Keycloak extension — it runs from Terraform against the Admin API.Keycloak拡張ではなく、TerraformからAdmin APIを操作するツール
- Officially supports only the latest three minor Keycloak versions (older ones may still work).公式サポートは最新3つのマイナーバージョンのみ(それ以前も動く可能性はある)
- The legacy WildFly distribution needs
base_path = "/auth".旧WildFlyディストリビューションではbase_path = "/auth"の設定が必要 - No statically linked Alpine build since v2.0.0 (use the linux_amd64 build with
libc6-compat).v2.0.0以降、Alpine向けの静的リンクビルドは提供されない(libc6-compatを入れてlinux_amd64版を使う)
Requirements前提条件
- Terraform 0.13+ for automatic installation from the registry.Registryから自動インストールするにはTerraform 0.13以上
- A Keycloak client or user with suitable admin roles (e.g.
realm-admin, oradminin the master realm).適切な管理ロール(realm-admin、またはmaster realmのadminなど)を持つクライアントかユーザー - Migrating from
mrparkers/keycloakneedsterraform state replace-provider.mrparkers/keycloakからの移行はterraform state replace-providerで行う