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

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

管理エンドポイントの接頭辞パスが異なる可能性があるため、管理インターフェイスの相対パスを変更できます。Red Hat ビルドの Keycloak オプション http-management-relative-path を使用して実現できます。

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

User は、相対パスが指定されている場合に Keycloak の Red Hat ビルドがホストされるパスに自動的に リダイレクトされ ます。これは、相対パスが /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 に設定します。