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

Edge for Private Cloud v4.18.01

Edge UI がローカル IP アドレスにアクセスしようとする場所はいくつかあります。これらのローカル IP アドレスは、外部ユーザーに公開すべきでないプライベート リソースや保護されたリソースに対応している可能性があります。

  • Edge UI の Trace ツールには、指定された URL との間で API リクエストを送受信する機能があります。Edge コンポーネントが他の内部サービスと共同ホストされている特定のデプロイ シナリオでは、悪意のあるユーザーがプライベート IP アドレスにリクエストを送信して、Trace ツールの機能を不正使用する可能性があります。
  • 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 プロパティはデフォルトで無効になっています。Trace ツールがプライベート IP アドレスにアクセスできるようにするには、true に設定します。
  • OpenAPI 仕様の場合、conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses プロパティはデフォルトで無効になっています。プライベート IP アドレスへの OpenAPI アクセスを有効にするには、true に設定します。
  • WSDL ファイルの場合、conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses プロパティはデフォルトで無効になっています。プライベート IP アドレスからの WSDL ファイルのアップロードを有効にするには、true に設定します。

これらのプロパティを 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 アドレスにアクセスできるようになりました。