1. はじめに
業務 API や MCP サーバーを IP allowlist で保護していると、Foundry Agent Service を接続する際に「どの Azure IP を許可すればよいのか」という問題が生じます。NAT Gateway を関連付けたはずなのに、API 側のログに別の IP が現れることもあります。
この記事では、実行主体・実行環境・宛先を分け、BYO VNet での固定 IP 設計と診断を整理します。Microsoft 管理の Managed VNet は対象外です。
確認範囲: 公式ドキュメント・サンプルに基づく設計ガイドです。実 Azure へのデプロイ、IP 実測、MCP の E2E 接続は未実施です。コマンドは構成例であり、実行結果ではありません。エージェント種別・ツール・作成時期による対応差は実装前に再確認してください。
2. Foundry MCP と Agent Service の通信経路を整理する
2.1 Foundry MCP Server の企業アプリは「利用者が Foundry を操作する」ため
**Foundry MCP Server(public preview)**は Microsoft がホストするサービスです。VS Code などの MCP クライアントから https://mcp.ai.azure.com に接続し、Entra ID でサインインして Foundry の操作を行います。公式の開始手順では、利用者の権限を使う OBO(On-Behalf-Of)フローが説明されています。[^mcp-start][^mcp-security]
次の Application ID は秘密情報ではなく、Microsoft の Foundry MCP Server の識別子です。Enterprise Application はそのテナント内の Service Principal に対応します。テナント固有の Object ID と Application ID は区別してください。[^mcp-security][^entra-app]
Endpoint: https://mcp.ai.azure.com
Application ID: fcdfa2de-b65b-4b54-9a1c-81c8a18282d9
公式のセキュリティガイドは、必要に応じて次のコマンドで Service Principal をテナントに作成する手順を示しています。まず存在を確認し、未作成の場合だけ、テナントの権限・承認手順に従って作成します。[^mcp-security]
az ad sp show --id fcdfa2de-b65b-4b54-9a1c-81c8a18282d9 \
--query "{displayName:displayName, appId:appId, objectId:id}"
# 未作成の場合のみ、権限を持つ管理者が実行
az ad sp create --id fcdfa2de-b65b-4b54-9a1c-81c8a18282d9
これは 独自の App registration と client secret を作って MCP サーバーへ渡す作業ではありません。公式の VS Code 手順では利用者がサインインし、Entra ID、OBO、対象リソースの RBAC で制御します。企業アプリ作成だけで操作権限は付きません。Conditional Access と必要な RBAC は別々に設定します。[^mcp-start][^mcp-security]
一方、独自の MCP サーバーの OAuth 設定や、独自の confidential client を実装する場合の資格情報要件は別問題です。「MCP なら常に client secret 不要」と一般化しないでください。
この hosted Foundry MCP Server 自体は network isolation に対応しておらず、Foundry の public endpoint に接続します。private-only な Foundry への操作経路として、Agent Service の VNet Injection を流用できるわけではありません。非公開環境の操作には、到達可能なネットワークからの SDK / REST や適切に設計した独自 MCP を検討し、接続のためだけに公開アクセスを緩めないようにします。[^mcp-security]
2.2 Agent Service が外部 MCP・API を呼ぶ経路は別に確認する
次は、エージェントがツールとして業務 API や MCP サーバーを呼ぶ経路です。現在の networking deep dive は、BYO VNet 構成のツール呼び出しを single-tenant data proxy 経由で説明しています。Hosted agent 自身の outbound は Micro VM の NIC を使い、ツール呼び出しは data proxy を使うという違いもあります。[^network-deep-dive]
| 通信 | 主に確認するもの |
|---|---|
| MCP クライアント → Foundry MCP | サインイン、企業アプリ、Conditional Access、Foundry の RBAC |
| アプリ → Foundry endpoint | Foundry の public / private 入口、Private DNS、利用権限 |
| Agent → 外部 MCP / API | ツールの実行場所、data proxy、VNet Injection、宛先認証 |
| 自前アプリが function を実行 | そのアプリのホスト環境・サブネット・出口 IP |
「エージェントが function を選択し、手元のアプリが実際の HTTP 要求を送る」構成なら、固定するのはそのアプリの出口です。Foundry に NAT を用意しても、別ホストからの要求には効きません。
図の中央は Internet 向けの SNAT、下段は private 宛先への要求です。NAT はルーターの次ホップではなく、サブネットへの関連付けで適用します。Foundry 全体を利用者 VNet 内へ移す図ではありません。[^network-deep-dive][^nat-overview]
3. IP allowlist が必要なときのアーキテクチャ
3.1 既定 public egress の観測 IP を固定値として扱わない
Foundry のネットワーク選択肢は、public egress、BYO VNet、Managed VNet に分かれます。Foundry に Private Endpoint を付けるだけでは入口が private になるだけで、public egress は分離されません。[^network-options]
本記事で確認した公式資料には、既定 public egress について、外部 API の allowlist 用に保証された Foundry Agent Service 専用の固定 IP 一覧はありません。次の値を代用品にしない設計を推奨します。
- Foundry の endpoint 名を DNS 解決して得た 宛先 IP
- 一度のテストで観測した、固定保証を確認していない 送信元 IP
- エージェントの実行主体を限定できると確認していない、広い Azure IP 範囲
固定 IP が契約条件なら、自分で管理する出口に対象通信を通すことを設計の前提にします。NAT Gateway はサブネットから Internet への outbound を Public IP に SNAT するサービスで、受信リスナーや利用者認証の代わりにはなりません。[^nat-overview]
3.2 宛先と統制要件で構成を選ぶ
BYO VNet で対象通信を injection する前提で、次から選びます。
- public API への固定 IP 接続: Standard NAT Gateway を関連付け、NAT の Public IP / prefix を宛先で許可
- public API の宛先統制・監査: UDR → Azure Firewall へ集約し、実際に SNAT する出口の Public IP を許可
- private API / MCP への接続: private frontend / Private Endpoint 等への到達性を用意し、実際の private IP / agent subnet CIDR を許可
NAT は出口 IP の集約、Firewall は宛先制御・検査にも使います。両者を組み合わせた最終 IP は経路と SNAT 構成次第です。0.0.0.0/0 を Firewall 等の virtual appliance に送る UDR は、そのサブネットの NAT による Internet 接続より優先されます。[^nat-overview]
すべてのツールが VNet を通る保証はありません。network isolation に非対応のツールや public 経路を使うツールもあるため、対象ツールの対応を確認してから構成を選びます。[^network-options]
4. Application Gateway で「Foundry からだけ」に制限する
4.1 IP 制限は Foundry のアプリケーション ID 判定ではない
本記事で確認した公式資料では、Application Gateway に指定するだけで Agent Service の正当な呼び出しを識別する 「Foundry only」の組み込み判定や専用 service tag は確認できません。service tag は IP 範囲のグループであり、利用者の Foundry account・project・agent の認証を意味しません。[^service-tags]
次の 2 パターンを使い分けます。
- Private Application Gateway: 専用 App Gateway subnet の NSG で、agent subnet CIDR → private frontend の HTTPS を許可し、それ以外を拒否します。peering・DNS・経路と、到着する送信元を確認します。
- Public Application Gateway: NSG または WAF custom rule で、NAT / Firewall の Public IP 以外を拒否します。NAT を共有する他ワークロードも同じ IP に見える点に注意します。
Application Gateway は専用サブネットを必要とし、NSG の制約は通常デプロイと private deployment で異なります。必要な基盤通信・health probe を残し、利用者向け listener の制限と分けて設定してください。[^appgw-infra]
WAF を使うなら、たとえば RemoteAddr / IPMatch で許可リスト外を Block する設計を検討します。Prevention mode で動作を確認し、許可 IP に対する custom Allow が後続の managed rule 検査をスキップする点にも注意します。単に Allow ルールを追加するだけでは、許可リスト外を拒否できません。[^appgw-waf]
リバースプロキシや Firewall が途中にある場合、入口で見える送信元は変わり得ます。バックエンドに届いた X-Forwarded-For だけで判断せず、信頼するプロキシ境界と Gateway 側のアクセスログも照合します。
4.2 より厳密な限定には認証・認可を併用する
IP は経路を限定しても、特定のエージェントの身元までは保証しません。APIM または API 側で、署名、issuer、audience、期限、必要な roles / scopes、許可する呼び出し主体を検証します。APIM には Entra token を検証する validate-azure-ad-token ポリシーがあります。[^apim-token]
呼び出し側では、対象ツールが対応する Managed Identity / Entra token 等の認証を構成します。ネットワーク接続できることと、そのツールが必要な token を取得・提示できることは別確認です。MCP の認証境界の設計は、関連記事の Azure AI Gateway で API を MCP サーバー化する:認証方式とユーザー単位の設定ガイド も参照してください。
5. Standard NAT Gateway で出口 IP を固定する手順
5.1 先に Foundry の injection とサブネットを確定する
- Foundry の公式 private networking 手順で BYO VNet / VNet Injection を構成します。Hosted agents では account 作成時に injection を含める必要があり、既存 account へ後付けできると想定しません。[^private-network]
- Foundry が参照する agent subnet の完全な resource ID を記録します。Private Endpoint subnet とは別で、
Microsoft.App/environmentsに委任します。複数の Foundry resource で agent subnet を共有しません。[^private-network] - アドレスは保守的に RFC 1918 の非重複範囲を使い、本番では
/24を出発点として必要容量を検討します。サブネット容量・ツールの対応・DNS・必須 outbound を先に確認します。[^network-deep-dive]
公式サンプルの 15 は network-secured Standard Agent の基本構成、19 は VNet 内の MCP / OpenAPI 等のツールを含む構成です。15 だけで private ツールの設定まで完了すると考えず、シナリオに合わせて選びます。[^sample-basic][^sample-tools]
5.2 agent subnet に NAT を関連付ける
以下は、既に対応する BYO VNet / agent subnet があり、権限とプラットフォーム要件を確認済みの場合の Bash + Azure CLI の例です。値を置き換え、対象 subscription を確認してから実行してください。NAT と Public IP は VNet と同じリージョンに作成します。既存の NAT 関連付けがある場合は上書きせず、変更計画を先に確認します。[^nat-overview][^cli-nat][^cli-subnet]
RG="<vnet-resource-group>"
LOCATION="<azure-region>"
VNET="<vnet-name>"
AGENT_SUBNET="<agent-subnet-name>"
NAT="<nat-gateway-name>"
PIP="<public-ip-name>"
az account show --query "{subscription:name, id:id}" -o table
az network vnet subnet show -g "$RG" --vnet-name "$VNET" -n "$AGENT_SUBNET" \
--query "{id:id, delegations:delegations[].serviceName, natGateway:natGateway.id}"
az network public-ip create -g "$RG" -n "$PIP" --location "$LOCATION" \
--sku Standard --allocation-method Static
az network nat gateway create -g "$RG" -n "$NAT" --location "$LOCATION" \
--sku Standard --public-ip-addresses "$PIP"
az network vnet subnet update -g "$RG" --vnet-name "$VNET" -n "$AGENT_SUBNET" \
--nat-gateway "$NAT"
az network public-ip show -g "$RG" -n "$PIP" --query ipAddress -o tsv
最後に得た IP を宛先の allowlist に登録し、実際の Agent の対象ツールから、新規接続で要求を送って宛先ログの送信元と突き合わせます。NAT に複数 Public IP や prefix を割り当てた場合は、一つだけではなく使用され得る全範囲を許可します。[^nat-overview]
この例は Internet 向け通信の固定化です。private 宛先、別ホストで実行される function、injection 非対象の通信まで NAT の IP に変換する手順ではありません。
6. NAT Gateway の IP で出ていかないときのチェックリスト
6.1 まず「同じ要求」を追跡する
agent / project、ツール名、宛先 FQDN、時刻、request ID と、宛先で観測した TCP 接続元 IPを照合します。Cloud Shell・PC・別 VM からの curl 成功は Agent の経路を証明しません。未到達なら DNS・TLS・NSG・認証エラーから調べます。
- 実行主体: Agent のツール、Hosted agent 自身のコード、自前 function 実行アプリ、Foundry MCP のどれか。
- injection の適用: account の実構成・ツールの対応を確認。Foundry の Private Endpoint だけで出口は変わりません。
- 関連付け先: Foundry の agent subnet ID と一致するか。PE / App Gateway subnet だけに NAT を付けていませんか。
- ACA-backed 環境種別: Workload profiles 環境か。legacy Consumption-only は NAT 非対応。名前や料金プランだけで判定しません。
- NAT SKU / Public IP: ACA 統合は StandardV2 非対応。Standard と Public IP の関連付けを確認します。
- DNS / 経路: private IP なら Public NAT は使いません。UDR → Firewall / VPN / ExpressRoute なら、その先の SNAT を追います。
- NSG / restricted egress: 業務 API と Entra ID 等の基盤通信を許可し、private subnet に明示的な出口を用意したか。
- 新規 TCP 接続: NAT 追加前の keep-alive / connection pool を再利用せず、安全に接続を再確立したか。
- 観測位置: 中継プロキシの IP と元の接続元を区別し、NAT の Public IP 全範囲を許可したか。
環境種別・SKU は ACA の公式ネットワーク資料、UDR と新規接続の挙動は NAT の公式資料に基づきます。Foundry のツール経路は data proxy を含むため、「NAT が付いている」という一点だけで正常と判断しないことが重要です。[^aca-networking][^aca-vnet][^nat-overview][^nat-manage][^network-deep-dive]
6.2 サブネット・NAT・経路を読み取り確認する
次のクエリで、委任・NAT・route table・NSG をまとめて確認します。defaultOutboundAccess: false は default outbound の無効化であり、それだけで NAT が利用不能という意味ではありません。明示的な出口と、必要な通信の許可を確認します。[^cli-subnet][^sample-basic]
az network vnet subnet show \
--resource-group "$RG" --vnet-name "$VNET" --name "$AGENT_SUBNET" \
--query "{id:id, delegations:delegations[].serviceName, natGateway:natGateway.id, routeTable:routeTable.id, nsg:networkSecurityGroup.id, defaultOutboundAccess:defaultOutboundAccess}"
az network nat gateway show -g "$RG" -n "$NAT" \
--query "{sku:sku, publicIps:publicIpAddresses[].id, publicPrefixes:publicIpPrefixes[].id}"
routeTable に ID が返った場合は、その ID を指定してルートを確認します。NAT Gateway 自体を UDR の next hop にする設定は不要です。[^nat-overview][^cli-route]
az network route-table show --ids "<route-table-resource-id>" \
--query "routes[].{name:name, prefix:addressPrefix, nextHop:nextHopType, nextHopIp:nextHopIpAddress}" \
-o table
6.3 ACA 環境種別は、参照先が本当に一致する場合だけ調べる
Foundry の公式サンプルは、Microsoft.App/environments への委任と Azure Container Apps(ACA)基盤の関係を説明しています。ただし現行 deep dive は Micro VM・data proxy も含む構造です。すべての Foundry 環境を、利用者が自由に変更できる通常の ACA environment と扱わないでください。[^sample-basic][^network-deep-dive]
ACA-backed の配置で、環境が自分の subscription に表示され、読み取り権限がある場合は次で調べられます。ACA_RG は VNet や Foundry と同じ resource group とは限りません。[^cli-aca]
ACA_RG="<container-apps-environment-resource-group>"
ENV="<environment-name>"
az containerapp env list -g "$ACA_RG" -o table
az containerapp env show -n "$ENV" -g "$ACA_RG" \
--query "{id:id, vnetConfig:properties.vnetConfiguration, workloadProfiles:properties.workloadProfiles, infraResourceGroup:properties.infrastructureResourceGroup}"
出力の vnetConfiguration.infrastructureSubnetId を、Foundry の agent subnet ID と照合します。同じ resource group にある無関係な ACA 環境を調べても診断になりません。一覧が空でも injection 不成立とは限らないため、Foundry の network configuration、権限、デプロイ情報を確認し、見えない管理基盤はサポートへ確認します。
判定時に混同しやすい点は次のとおりです。[^aca-networking][^aca-vnet]
- Workload profiles environment は NAT Gateway に対応し、その内部で Consumption profile を使用できます。「Consumption」という名前だけで非対応と判定しません。
- Consumption-only environment(legacy) は NAT Gateway 非対応です。さらに、こちらのサブネットは
Microsoft.App/environmentsへ委任しない仕様です。正しく委任された Foundry の subnet が、そのまま legacy 環境であると推定するのは不適切です。 workloadProfilesが空・取得不能という一点で環境種別を確定せず、実際の environment 設定とサブネットを確認します。- NAT Gateway の StandardV2 SKU と、ACA の Workload profiles 環境は別の分類です。ACA 統合では前者は非対応、後者が必要です。
Foundry の agent subnet に独自の ACA 環境を追加したり、プラットフォーム管理の infrastructure resource group 内の Load Balancer 等を手動変更したりしないでください。ACA の公式資料も管理リソースを変更しないよう注意しています。[^aca-vnet]
6.4 接続の再確立とプラットフォーム通信を確認する
Standard NAT Gateway を追加しても、既存接続は元の outbound 経路を使い続け、新規接続から NAT が使われます。MCP の長時間接続や HTTP connection pool を考慮し、アプリの正式な再接続手順を使って確認します。Foundry の管理基盤を強制的に再起動する必要がある、と読み替えないでください。[^nat-manage]
また、deny-by-default の NSG / Firewall では、業務 API の HTTPS だけを開けても足りません。Foundry の手順には control-{region}.identity.azure.net、{region}.login.microsoft.com、login.microsoftonline.com や AzureActiveDirectory service tag など、ID・プラットフォーム依存通信の確認が記載されています。これだけを完全な allowlist とせず、対象環境の Foundry / ACA の最新要件も照合します。[^private-network][^sample-basic]
解決しない場合は、account / project の resource ID、agent subnet ID、NAT SKU と Public IP、関連 UDR / NSG、ツール名、時刻・request ID、宛先で観測した接続元を整理して問い合わせます。token・client secret・業務データを診断資料へ混ぜないようにします。
7. まとめ
固定 IP の設計は、Foundry MCP の企業アプリ登録ではなく、実際に要求を送る実行主体とネットワーク経路の確認から始めます。
public な宛先には対応する BYO VNet / VNet Injection と Standard NAT Gateway、宛先統制も必要なら Firewall を検討します。private な宛先では CIDR・DNS・経路を確認し、NAT の Public IP が現れないこと自体を障害とは判断しません。
NAT が効かない場合は、対象通信、サブネット、ACA-backed 環境の種別、SKU、UDR、新規接続を順番に確認します。最後に、IP / CIDR 制限と Entra ID による認証・認可を併用し、「この経路から来た」と「この主体に操作を許可する」を分けて設計してください。
8. 参考情報
- Networking options for Foundry Agent Service — 入口・出口と BYO / Managed VNet の選択を見直す入口
- Deep dive into Foundry Agent Service networking — data proxy・Hosted / prompt agent とサブネット容量の詳説
- Set up private networking for Foundry Agent Service — private networking の構築と検証の公式手順
- How to configure network isolation for Microsoft Foundry — Private Link を含むネットワーク分離の全体像
- Microsoft Foundry: Standard Agent Setup with E2E Network Isolation (without Tools behind VNET) — 基本となる BYO VNet の構築サンプル
- Microsoft Foundry: Standard Agent Setup with E2E Network Isolation with Tools behind VNET — private な MCP 等のツールを含む構築サンプル
- What is Azure NAT Gateway? — SNAT と経路優先順位を学ぶ入口
[^mcp-start]: Get started using Foundry MCP Server with Visual Studio Code — Microsoft Learn(確認日: 2026-11-05)
[^mcp-security]: Explore Foundry MCP Server best practices and security guidance — Microsoft Learn(確認日: 2026-11-05)
[^entra-app]: Application and service principal objects in Microsoft Entra ID — Microsoft Learn(確認日: 2026-11-05)
[^network-options]: Networking options for Foundry Agent Service — Microsoft Learn(確認日: 2026-11-05)
[^network-deep-dive]: Deep dive into Foundry Agent Service networking — Microsoft Learn(確認日: 2026-11-05)
[^private-network]: Set up private networking for Foundry Agent Service — Microsoft Learn(確認日: 2026-11-05)
[^sample-basic]: Microsoft Foundry: Standard Agent Setup with E2E Network Isolation (without Tools behind VNET) — Microsoft Foundry GitHub(確認日: 2026-11-05)
[^sample-tools]: Microsoft Foundry: Standard Agent Setup with E2E Network Isolation with Tools behind VNET — Microsoft Foundry GitHub(確認日: 2026-11-05)
[^aca-networking]: Networking in an Azure Container Apps environment — Microsoft Learn(確認日: 2026-11-05)
[^aca-vnet]: Virtual network configuration — Microsoft Learn(確認日: 2026-11-05)
[^nat-overview]: What is Azure NAT Gateway? — Microsoft Learn(確認日: 2026-11-05)
[^nat-manage]: Manage a NAT gateway — Microsoft Learn(確認日: 2026-11-05)
[^service-tags]: Azure service tags overview for virtual network security — Microsoft Learn(確認日: 2026-11-05)
[^appgw-infra]: Application Gateway infrastructure configuration — Microsoft Learn(確認日: 2026-11-05)
[^appgw-waf]: Custom rules for Web Application Firewall v2 on Azure Application Gateway — Microsoft Learn(確認日: 2026-11-05)
[^apim-token]: Validate Microsoft Entra token — Microsoft Learn(確認日: 2026-11-05)
[^cli-nat]: az network nat gateway — Microsoft Learn(確認日: 2026-11-05)
[^cli-subnet]: az network vnet subnet — Microsoft Learn(確認日: 2026-11-05)
[^cli-route]: az network route-table — Microsoft Learn(確認日: 2026-11-05)
[^cli-aca]: az containerapp env — Microsoft Learn(確認日: 2026-11-05)






