第18章 管理インターフェイスの設定

管理インターフェイスのポートを変更するには、Red Hat build of Keycloak のオプション http-management-port を使用します。

管理エンドポイントの接頭辞パスは異なる場合があるため、管理インターフェイスの相対パスを変更できます。これは、Red Hat build of Keycloak のオプション http-management-relative-path を介して実現できます。

たとえば、CLI オプション --http-management-relative-path=/management を設定すると、メトリクスおよびヘルスエンドポイントは /management/metrics および /management/health パスでアクセスされます。

相対パスが指定されると、ユーザーは Red Hat build of Keycloak がホストされているパスに自動的に リダイレクト されます。つまり、相対パスが /management に設定され、ユーザーが localhost:9000/ にアクセスすると、ページは localhost:9000/management にリダイレクトされます。

TLS がデフォルトの Red Hat build of Keycloak サーバーに設定されている場合、デフォルトでは管理インターフェイスには HTTPS 経由でアクセスすることができます。管理インターフェイスは、メインサーバーの場合のように両方ではなく、HTTP または HTTPS のいずれかでのみ実行できます。

管理 HTTP サーバーのさまざまな TLS パラメーターを設定するために、接頭辞 https-management-* が付いた特定の Red Hat build of Keycloak 管理インターフェイスオプションが提供されました。これらの機能は、メイン HTTP サーバーの対応する機能と類似します。詳細は、TLS の設定 を参照してください。これらのオプションが明示的に設定されていない場合、TLS パラメーターはデフォルトの HTTP サーバーから継承されます。

管理インターフェイスは、何も公開されていない場合は自動的にオフになります。現在、管理インターフェースでは、ヘルスチェックとメトリクスのみが公開されています。管理インターフェイス上での公開を無効にする場合は、Red Hat build of Keycloak プロパティー legacy-observability-interface を true に設定します。