7.7. 背景 - サーバーエンドポイント

ユーザーとアプリケーションは、フロントエンド URL を使用して、フロントチャネル経由で Red Hat build of Keycloak にアクセスします。フロントチャネルは、公開されているアクセス可能な通信チャネルです。たとえば、ブラウザーベースのフロー (ログインページへのアクセス、パスワードをリセットするためのリンクのクリック、トークンのバインド) は、フロントチャネルリクエストと見なすことができます。

フロントエンド URL 経由で Red Hat build of Keycloak にアクセスできるようにするには、hostname オプションを設定する必要があります。

bin/kc.[sh|bat] start --hostname my.keycloak.org

bin/kc.[sh|bat] start --hostname my.keycloak.org

バックエンドエンドポイントは、パブリックドメインまたはプライベートネットワークを通じてアクセスできるエンドポイントです。これらは、Red Hat build of Keycloak とクライアント (Red Hat build of Keycloak によって保護されたアプリケーション) 間の直接的なバックエンド通信に関連しています。このような通信は、リバースプロキシーを回避してローカルネットワーク経由で行われる可能性があります。このグループに属するエンドポイントの例としては、認可エンドポイント、トークンおよびトークンイントロスペクションエンドポイント、ユーザー情報エンドポイント、JWKS URI エンドポイントなどがあります。

hostname-backchannel-dynamic オプションのデフォルト値は false です。これは、バックチャネル URL がフロントチャネル URL と同じであることを意味します。次のオプションを設定することで、受信リクエストヘッダーからのバックチャネル URL の動的な解決を有効にできます。

bin/kc.[sh|bat] start --hostname https://my.keycloak.org --hostname-backchannel-dynamic true

bin/kc.[sh|bat] start --hostname https://my.keycloak.org --hostname-backchannel-dynamic true

hostname オプションは URL に設定する必要があることに注意してください。詳細は、以下の 「検証」 セクションを参照してください。

ベースフロントエンド URL と同様に、管理コンソールのリソースとエンドポイントのベース URL も設定できます。サーバーは、特定の URL を使用して管理コンソールと静的リソースを公開します。この URL は、リダイレクト URL、リソース (CSS、JS) のロード、管理 REST API などに使用されます。これは、hostname-admin オプションを設定することで実行できます。

bin/kc.[sh|bat] start --hostname https://my.keycloak.org --hostname-admin https://admin.my.keycloak.org:8443

bin/kc.[sh|bat] start --hostname https://my.keycloak.org --hostname-admin https://admin.my.keycloak.org:8443

繰り返しますが、hostname オプションは URL に設定する必要があります。詳細は、以下の 「検証」 セクションを参照してください。