Edge UI にローカル IP アドレスへのアクセスを許可する

Edge for Private Cloud v4.17.09

Edge UI がローカル IP アドレスにアクセスしようとする場所はいくつかあります。次のローカル IP アドレスはプライベート空間を表すか、外部ユーザーに公開すべきでない保護リソースを表します。

  • Edge UI の Trace ツールを使用すると、指定した URL に対して API リクエストを送受信できます。Edge コンポーネントが他の内部サービスと一緒にホストされているデプロイ シナリオの場合、悪意のあるユーザーが Trace ツールの機能を悪用してプライベート IP アドレスにリクエストを送信する可能性があります。
  • OpenAPI 仕様に基づいて API プロキシを作成するとき。この仕様では、API のベースパス、パス、動詞、ヘッダーなどを記述します。仕様では、悪意のあるユーザーがプライベート IP アドレスを参照するプロキシのベースパスを指定できます。
  • ローカル ファイル システム上にある WSDL ファイルから API プロキシを作成するとき。

セキュリティ上の理由から、デフォルトでは Edge UI からプライベート IP アドレスを参照することはできません。プライベート IP アドレスのリストには次のようなものがあります。

  • ループバック アドレス(127.0.0.1 または localhost)
  • サイトのローカル アドレス(IPv4 - 10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 の場合)
  • 任意のローカル アドレス(localhost に解決される任意のアドレス)

Edge UI からプライベート IP アドレスにアクセスできるようにするには、次のトークンを設定します。

  • Trace ツールの場合、conf_apigee-base_apigee.feature.enabletraceforinternaladdresses プロパティがデフォルトで無効になっています。これを true に設定すると、Trace ツールからプライベート IP アドレスにアクセスできます。
  • OpenAPI 仕様では、conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses プロパティがデフォルトで無効になっています。これを true に設定すると、OpenAPI からプライベート IP アドレスにアクセスできます。
  • WSDL ファイルの場合、conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses プロパティがデフォルトで無効になっています。これを true に設定すると、プライベート IP アドレスから WSDL ファイルをアップロードできます。

これらのプロパティを true に設定するには:

  1. エディタで ui.properties ファイルを開きます。ファイルが存在しない場合は作成します。
    > vi、/opt/apigee/customer/application/ui.properties
  2. 次のプロパティを true に設定します。
    conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
    conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses="true"
    conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses="true"
  3. 変更を ui.properties に保存します。
  4. プロパティ ファイルの所有者を「apigee」ユーザーにします。
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Edge UI を再起動します。
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

これで、Edge UI からローカル IP アドレスにアクセスできるようになります。