旧バージョンのドキュメントを参照しています。最新のドキュメントはこちらをご参照ください。

Kong Managerのネットワーク設定

デフォルト構成

デフォルトでは、Kong Manager は認証なしで起動し（ admin_gui_authを参照）、Kong Manager を処理する同じホストのポート 8001（デフォルトのポートを参照）で Admin API が利用可能であることを前提としています。

カスタム構成

Kong Manager の一般的な構成シナリオをいくつか示します。

専用KongノードからのKong Managerの提供

Kong Managerが専用のKongノード上にある場合、 Admin API への外部呼び出しを行う必要があります。admin_api_uriを Admin API の場所に設定します。

認証プラグインによる Kong Manager の保護

Kong Manager が認証プラグインで保護されており、専用ノード上にない場合、同じホスト上で Admin API を呼び出します。デフォルトでは、Admin API はローカルホストのポート 8001 と 8444 でリッスンします。必要に応じて admin_listen を変更するか、 admin_api_uri を設定します。

重要：本番環境でadmin_listenポートをインターネットに公開する必要がある場合は、 secure it with authentication.

Kong Managerの保護と専用ノードからの提供

Kong Managerが 保護され、専用ノードから提供される 場合、 admin_api_uriをAdmin APIの場所に設定します。

Admin APIへの接続

下表は、Kong ManagerのAdmin APIへの接続を構成する際に設定される（またはデフォルトで検証される）プロパティをまとめたものです。

認証が有効	ローカルAPI	リモートAPI	認証設定
有効	`admin_listen`	`admin_api_uri`	`admin_gui_auth`、 `enforce_rbac`、 `admin_gui_auth_conf`、 `admin_gui_session_conf`
いいえ	`admin_listen`	`admin_api_uri`	対象外

認証を有効にする

認証を有効にするには、以下のプロパティを設定します。

admin_gui_authを目的のプラグインに設定
admin_gui_auth_conf（任意）
admin_gui_session_confを希望の構成に設定
enforce_rbacの設定をon

重要: Kong Manager認証が有効になっている場合、権限ルールを適用するにはRBACを有効にする必要があります。ただし、Kong Managerにログインできる人は誰でもAdmin APIで利用可能な操作をすべて実行できます。

TLS証明書

デフォルトでは、Kong ManagerのURLがCAによって発行された証明書 なしで HTTPS経由でアクセスされた場合、最新のウェブブラウザが信頼しない自己署名証明書を受け取り、アプリケーションはAdmin API にアクセスできなくなります。

HTTPS経由でKong Managerを提供するには、信頼できる証明機関を使用してTLS証明書を発行します。そして次の手順のために、結果の.crtファイルと.keyファイルを準備します。

.crtおよび.keyファイルをKongノードの任意のディレクトリに移動します。
証明書とキーの絶対パスを admin_gui_ssl_cert と admin_gui_ssl_cert_key に指定します。

admin_gui_ssl_cert = /path/to/test.crt admin_gui_ssl_cert_key = /path/to/test.key
TLSを使用するには、admin_gui_urlの前にhttpsが付いていることを確認してください。例:

admin_gui_url = https://test.com:8445

https://localhostの使用

Kong Managerをローカルホストで提供する場合、HTTPをプロトコルとして使用する方が望ましい場合があります。RBACも使用している場合、admin_gui_session_confにcookie_secure=falseを設定します。localhostにHTTPを使用する理由は、localhostのTLS証明書を作成するには、より多くの労力と構成が必要であり、それを使用する理由がないかもしれないからです。TLSの適切なユースケースは、（1）ホスト間でデータが転送されている場合、または（2）混合コンテンツを含むアプリケーションをテストする場合（Kong Managerでは使用されません）。

外部CAは、誰も独自でlocalhostを所有せず、上位レベルドメイン（例：.com、.org）に根差しているわけでもないため証明書を提供することはできません。同様に、自己署名証明書は現代のブラウザでは信頼されません。その代わり、独自の証明書を発行できるプライベートCAを使用する必要があります。また、古い証明書によって、将来localhostへのアクセスを妨害されるのを回避するために、テスト後にSSLの状態が消去されているのを確実にしてください。