リクエストプロキシエージェント

Apidog リクエストプロキシエージェントは、適切なネットワーク環境を持つマシンにデプロイできます。これにより、Apidog クライアント、Web、または共有ドキュメントからのエンドポイントリクエストを、このエージェント経由でターゲットエンドポイントにルーティングできます。

この機能は、共有ドキュメント上のエンドポイントをデバッグする場合に特に便利です。クロスオリジンリソース共有（CORS）の問題の解決に役立ちます。環境ごとに特定のネットワーク要件があり、ローカル環境から直接デバッグできないシナリオに最適です。

前提条件

サーバー（Linux で実行されていることが望ましい）。

サーバーに Docker がインストールされていること（最低必須バージョン: 20.10.0。推奨バージョン: 20.10.13）。

リクエストプロキシエージェントは、チーム／組織レベルのリソースです。デプロイ後は、チームまたは組織内のすべてのプロジェクトで使用できます。Docker が有効なサーバーにエージェントをデプロイするには、次のコマンドを実行します。

デプロイ時に環境変数を使用して基本設定を構成できます。必要に応じて、次のオプションを使用してください。

環境変数	説明	例
SOURCE_IP_WHITELIST	許可する送信元 IP のリストです。カンマで区切ります（オペレーティングシステムの制限により、この変数は Linux でのみ使用でき、`--network=host` と併用する必要があります）。	--network=host -e SOURCE_IP_WHITELIST=134.34.4.3,123.333.33.0/24
SOURCE_IP_BLACKLIST	ブロックする送信元 IP のリストです。カンマで区切ります（オペレーティングシステムの制限により、この変数は Linux でのみ使用でき、`--network=host` と併用する必要があります）。	--network=host -e SOURCE_IP_BLACKLIST=134.34.4.3,123.333.33.0/24
DESTINATION_DOMAIN_WHITELIST	許可するターゲットドメイン名のリストです。カンマで区切ります。	-e DESTINATION_DOMAIN_WHITELIST=xxx.yyy.com,*.yyy.com
DESTINATION_DOMAIN_BLACKLIST	ブロックするターゲットドメイン名のリストです。カンマで区切ります。	-e DESTINATION_DOMAIN_BLACKLIST=xxx.yyy.com,*.yyy.com
DESTINATION_IP_WHITELIST	許可するターゲット IP のリストです。カンマで区切ります。	-e DESTINATION_IP_WHITELIST=134.34.4.3,123.333.33.0/24
DESTINATION_IP_BLACKLIST	ブロックするターゲット IP のリストです。カンマで区切ります。	-e DESTINATION_IP_BLACKLIST=134.34.4.3,123.333.33.0/24
ALLOW_PRIVATE_IP	内部 IP へのリクエストを許可します（boolean、デフォルトは false）。	-e ALLOW_PRIVATE_IP=false

INFO

Apidog リクエストプロキシエージェントはオープンソースであり、ニーズに合わせてさらにカスタマイズできます（例: カスタムヘッダーパラメータの追加）。ソースコードはこちらからアクセスできます。

Apidog リクエストプロキシエージェントが Docker 上で実行されたら、Apidog のチームリソースに追加できます。ポップアップウィンドウでサーバーのホスト情報（デフォルトポートは 9159）を入力し、保存をクリックします。その後、Apidog は接続を試行します。

接続に失敗した場合は通知が表示され、作成は許可されません。

接続に成功した場合、リクエストプロキシエージェントはチーム内に正常に作成されます。

エージェントがデプロイされ、Apidog で正常に接続されると、次の用途に使用できます。