Keycloak Invalid token issuer in dockerの解決方法【2025年最新版】

エラーの概要・症状

KeycloakをDocker環境で使用している際に、「Invalid token issuer」というエラーメッセージが表示されることがあります。このエラーは、特に認証トークンが無効であるか、予期しないトークン発行者から発行されている場合に発生します。

このエラーが表示される主な状況は、アプリケーションがKeycloakから発行されたトークンを検証する際に、トークンの発行者（issuer）が期待されるものと一致しない場合です。具体的には、次のような症状が見られます。

ユーザーはこれにより、アプリケーションの利用が制限され、業務に影響を及ぼす可能性があります。このため、迅速な対応が求められます。

「Invalid token issuer」エラーが発生する原因はいくつかあります。以下に主要な原因を挙げて、それぞれの技術的背景を説明します。

トークン発行者の不一致 Keycloakでは、トークンの発行者（issuer）が設定されています。この値は、クライアントアプリケーションがトークンを検証する際に比較されます。Docker環境では、IPアドレスやホスト名の不一致により、トークンが無効と判定されることがあります。
SSL/TLSの設定 KeycloakがSSL/TLSを使用している場合、クライアント側でも同様の設定が必要です。SSLが無効になっていると、トークンが有効であっても、通信が安全でないと判断されることがあります。
環境変数の設定ミス DockerでKeycloakを実行する際、環境変数（特に auth-server-url）が正しく設定されていないと、トークンの発行者が異なると認識されることがあります。
Dockerコンテナ間の通信設定 コンテナ同士の通信が適切に設定されていない場合、トークンの検証が失敗することがあります。特に、異なるネットワーク間での通信が必要な場合は注意が必要です。
アプリケーションの設定ミス クライアントアプリケーションの設定が不正確な場合、正しいトークンでも無効と判断されることがあります。これには、クライアントIDやシークレットの設定が含まれます。

以下は、最も効果的な解決方法です。この方法では、Keycloakの設定を見直し、適切な環境変数やSSL設定を行います。