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プロパティはデフォルトで無効になっています。true に設定すると、プライベート IP アドレスへの OpenAPI アクセスが有効になります。 - WSDL ファイルの場合、
conf_apigee-base_apigee.feature.enablewsdlforinternaladdressesプロパティはデフォルトで無効になっています。プライベート IP アドレスからの WSDL ファイルのアップロードを有効にするには、true に設定します。
これらのプロパティを true に設定するには:
ui.propertiesファイルをエディタで開きます。ファイルが存在しない場合は作成します。vi /opt/apigee/customer/application/ui.properties
- 次のプロパティを true に設定します。
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true" conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses="true" conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses="true"
- 変更を
ui.propertiesに保存します。 - プロパティ ファイルが「apigee」ユーザーによって所有されていることを確認します。
chown apigee:apigee /opt/apigee/customer/application/ui.properties
- Edge UI を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Edge UI がローカル IP アドレスにアクセスできるようになりました。