Microsoft Foundry プロジェクトのマネージド仮想ネットワークを構成する

この記事では、Foundry リソースのマネージド仮想ネットワークを設定する方法について説明します。 マネージド仮想ネットワークは、Foundry プロジェクト内のコンピューティングの基になる Agents サービスをセキュリティで保護するMicrosoftマネージド仮想ネットワークをプロビジョニングすることで、ネットワークの分離を合理化および自動化します。

これを有効にすると、このマネージド ネットワーク境界によってエージェントの送信ネットワーク トラフィックがセキュリティで保護され、選択した分離モードによってすべてのトラフィックが制御されます。 依存するAzure サービスに必要なプライベート エンドポイントを作成し、必要なネットワーク 規則を適用できます。

独自の仮想ネットワークを構築または維持する必要なく、セキュリティで保護された既定値を取得します。 このマネージド ネットワークは、エージェントがアクセスできる内容を制限し、承認されたAzure リソースへの接続を引き続き許可しながら、データ流出を防ぐのに役立ちます。

マネージド仮想ネットワークでは、新しい Responses API と新しい Foundry ポータルで、Prompt サービスと Hosted Agent サービスがサポートされるようになりました。 新しいエージェント サービスと新しい Foundry ポータルで現在サポートされているマネージド仮想ネットワークのリージョンは 、米国東部、米国東部 2、東日本、フランス中部、アラブ首長国連邦北部、ブラジル南部、スペイン中部、ドイツ中西部、イタリア北部、米国中南部、オーストラリア東部、スウェーデン中部、カナダ東部、南アフリカ北部、米国西部、米国西部 3 です。 インド南部、英国南部。

続行する前に、オファリングの 制限 事項を検討し、前提条件を確認してください。

分離モードについて

マネージド仮想ネットワークの分離を有効にすると、Microsoft テナントに作成された Foundry アカウントのマネージド仮想ネットワークが作成されます。 プロジェクトでビルドする新しいエージェントは、送信トラフィックにマネージド仮想ネットワークを自動的に使用します。 マネージド仮想ネットワークは、エージェントが使用するAzureリソース (Azure Storage、Azure Cosmos DB、Azure AI 検索など) にプライベート エンドポイントを使用できます。

マネージド仮想ネットワークからの送信トラフィックには、次の 3 つの構成モードがあります。

次のアーキテクチャ図は、 allow internet outbound モードのマネージド ネットワークを示しています。

次のアーキテクチャ図は、 allow only approved outbound モードのマネージド ネットワークを示しています。

インターネット送信を許可するようにマネージド仮想ネットワーク Foundry を構成した後は、リソースを無効にするように再構成することはできません。 同様に、承認された送信のみを許可するようにマネージド仮想ネットワーク リソースを構成した後は、インターネット送信を許可するようにリソースを再構成することはできません。

前提 条件

この記事の手順に従う前に、次の前提条件があることを確認してください。

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

• Azure CLI バージョン 2.86.0 以降。 マネージド ネットワークから送信規則を作成するために必要です。

  メモ

  az cognitiveservices account managed-network コマンド グループはプレビュー段階であり、変更される可能性があります。

• Azure サブスクリプションに登録されている Microsoft.Network、Microsoft.KeyVault、Microsoft.CognitiveServices、Microsoft.Storage、Microsoft.Search、および Microsoft.ContainerService リソース プロバイダー。 詳細については、「 リソース プロバイダーの登録」を参照してください。

• マネージド ネットワーク リソースをデプロイするためのアクセス許可。 Foundry アカウントとプロジェクトを作成するには、Foundry リソース スコープの Foundry Account Ownerが必要です。 Owner または Role Based Access Administrator が必要なリソースに RBAC を割り当てるために必要です。 エージェントの作成と構築には、プロジェクト範囲の Foundry User が必要です。

  重要

  Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。 名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコア アクセス許可は、名前の変更によって変更されません。

• ターゲット Azure リージョン内のすべてのリソースに対する十分なクォータ。 パラメーターを渡さない場合、このテンプレートは Foundry リソース、Foundry プロジェクト、NoSQL、Azure AI 検索、Azure Storage アカウントのAzure Cosmos DBを作成します。

制限

Foundry リソースのマネージド ネットワーク分離を有効にする前に、次の制限事項を考慮してください。

1. マネージド ネットワーク Foundry リソースは、次の 3 つの方法でデプロイできます。
2. 18-managed-virtual-network in foundry-samples フォルダー内の Bicep テンプレート
3. 18-managed-virtual-network in foundry-samples フォルダー内の Terraform テンプレート
4. az rest と Azure CLI のコマンドaz cognitiveservices。 この記事のAzure CLIサポートの詳細については、以下を参照してください。
5. Azure ポータル UI では現在、マネージド ネットワークの作成はサポートされていません。 代わりに、Azure CLI、az rest、またはBicepまたは Terraform テンプレートを使用します。
6. Foundry リソースを作成したら、Foundry リソースのマネージド ID に Azure AI Enterprise Network Connection Approver の組み込みロール (ロール ID: b556d68e-0be0-4f35-a333-ad7ee1ce17ea) を割り当てて、Foundry リソースに必要なプライベート エンドポイントが作成および承認されるようにします。
7. マネージド仮想ネットワークの分離は、有効にした後で無効にすることはできません。 カスタム仮想ネットワークのセットアップからマネージド仮想ネットワークへのアップグレード パスはありません。 Foundry リソースの再デプロイが必要です。 Foundry リソースを削除すると、マネージド仮想ネットワークが削除されます。
8. マネージド仮想ネットワークのサポートは 、米国東部、米国東部 2、東日本、フランス中部、アラブ首長国連邦北部、ブラジル南部、スペイン中部、ドイツ西部、イタリア北部、米国中南部、オーストラリア東部、スウェーデン中部、カナダ東部、南アフリカ北部、米国西部、米国西部 3、インド南部、英国南部のみです。 近日中にサポートされる追加のリージョン。
9. Foundry リソースのオンプレミス リソースへのプライベート アクセスが必要な場合は、 Application Gateway を使用してオンプレミス アクセスを構成します。 Application Gateway へのプライベート エンドポイントを使用した同じセットアップとバックエンド プールの設定がサポートされています。 GA の Application Gateway では、L4 と L7 の両方のトラフィックがサポートされるようになりました。
10. マネージド仮想ネットワークが Allow Only Approved Outbound モードのときに FQDN 送信規則を作成すると、関連するファイアウォール コストを伴うマネージド Azure Firewallが作成されます。 価格の詳細については、「 価格」を参照してください。 FQDN 送信規則では、ポート 80 と 443 のみがサポートされます。
11. マネージド仮想ネットワークに独自のAzure Firewallを持ち込むことはありません。 許可された送信のみ許可するモードを使用すると、Foundry アカウントに対してマネージド ファイアウォールが自動的に作成されます。
12. 複数の Foundry アカウントに同じマネージド ファイアウォールを再利用することはできません。 許可されている送信のみモードを使用すると、各 Foundry アカウントごとに独自のマネージド ファイアウォールが作成されます。
13. マネージド仮想ネットワークが有効になっている Foundry リソース内に新しいプロジェクトを作成する場合は、プロジェクト機能ホストを再作成して、プロジェクトが BYO リソースとマネージド ネットワークを使用していることを確認する必要があります。 その他の手順については、 foundry-samples リポジトリのマネージド ネットワークセットアップ用の README を参照してください。

マネージド仮想ネットワーク分離モードをデプロイする

マネージド仮想ネットワーク Foundry リソースのデプロイを開始するには、次のセクションの手順に従います。

az rest --method PUT \
  --url "https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.CognitiveServices/accounts/{account-name}?api-version=2026-05-01" \
  --body '{
    "location": "{region}",
    "kind": "AIServices",
    "sku": { "name": "S0" },
    "identity": { "type": "SystemAssigned" },
    "properties": {
      "allowProjectManagement": true,
      "customSubDomainName": "{account-name}",
      "networkInjections": [
        {
          "scenario": "agent",
          "subnetArmId": "",
          "useMicrosoftManagedNetwork": true
        }
      ],
      "disableLocalAuth": false
    }
  }' \
  --headers "Content-Type=application/json"

az rest --method GET \
  --url "https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.CognitiveServices/accounts/{account-name}?api-version=2026-05-01" \
  --query "properties.provisioningState" -o tsv

az cognitiveservices account show \
  --resource-group {resource-group} \
  --name {account-name} \
  --query identity.principalId -o tsv

az role assignment create \
  --assignee-object-id {principal-id} \
  --assignee-principal-type ServicePrincipal \
  --role "b556d68e-0be0-4f35-a333-ad7ee1ce17ea" \
  --scope /subscriptions/{subscription-id}/resourceGroups/{resource-group}

az cognitiveservices account managed-network create \
  --resource-group {resource-group} \
  --name {account-name} \
  --managed-network allow_internet_outbound

az cognitiveservices account managed-network create \
  --resource-group {resource-group} \
  --name {account-name} \
  --managed-network allow_only_approved_outbound \
  --firewall-sku Standard

マネージド仮想ネットワークのデプロイに必要なパラメーターの詳細については、Microsoftを参照してください。CognitiveServices/accounts/managedNetworks。

マネージド仮想ネットワークのデプロイを確認する

デプロイが完了したら、マネージド仮想ネットワークが正しく構成されていることを確認します。

送信規則を管理する

デプロイ後、送信規則を追加、更新、一覧表示、削除して、マネージド ネットワークが到達できる宛先を制御できます。 次の送信規則の種類がサポートされています。

az cognitiveservices account managed-network outbound-rule set \
  --resource-group {resource-group} \
  --name {account-name} \
  --rule {rule-name} \
  --type fqdn \
  --destination "*.openai.azure.com"

az cognitiveservices account managed-network outbound-rule set \
  --resource-group {resource-group} \
  --name {account-name} \
  --rule {rule-name} \
  --type servicetag \
  --category UserDefined \
  --destination '{"serviceTag":"Storage","protocol":"TCP","portRanges":"443"}'

az cognitiveservices account managed-network outbound-rule set \
  --resource-group {resource-group} \
  --name {account-name} \
  --rule {rule-name} \
  --type privateendpoint \
  --destination "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.Storage/storageAccounts/{storage-name}" \
  --subresource-target blob

az cognitiveservices account managed-network outbound-rule list \
  --resource-group {resource-group} \
  --name {account-name}

az cognitiveservices account managed-network outbound-rule show \
  --resource-group {resource-group} \
  --name {account-name} \
  --rule {rule-name}

az cognitiveservices account managed-network outbound-rule bulk-set \
  --resource-group {resource-group} \
  --name {account-name} \
  --file rules.yaml

az cognitiveservices account managed-network outbound-rule remove \
  --resource-group {resource-group} \
  --name {account-name} \
  --rule {rule-name}

az rest --method PUT \
  --url "https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.CognitiveServices/accounts/{account-name}/managedNetworks/default/outboundRules/{rule-name}?api-version=2026-05-01" \
  --body '{
    "properties": {
      "type": "PrivateEndpoint",
      "destination": {
        "serviceResourceId": "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.DocumentDB/databaseAccounts/{cosmosdb-account-name}",
        "subresourceTarget": "Sql",
        "sparkEnabled": false
      }
    }
  }'

マネージド仮想ネットワークの送信規則に必要なパラメーターの詳細については、Microsoftを参照してください。CognitiveServices/accounts/managedNetworks/outboundRules。

Azure Firewallのバージョンを選択する

マネージド仮想ネットワークの場合、承認された送信のみ許可 モードで外部送信 FQDN 規則を追加すると、Azure Firewall が自動的にプロビジョニングされます。

既定の SKU は、ファイアウォールの Standard です。 高度な機能が必要ない場合は、代わりに Basic SKU を選択してコストを削減できます。 価格の詳細については、「 価格」を参照してください。 デプロイ時にファイアウォール SKU を選択すると、デプロイ後に変更することはできません。 これはマネージド ファイアウォールであるため、ファイアウォールはお使いのテナントまたはコントロールにありません。 制御できる唯一の設定は、ファイアウォール SKU です。

プライベート エンドポイント

マネージド仮想ネットワークを有効にすると、マネージド プライベート エンドポイントを作成して、エージェントがパブリック インターネットを使用せずに必要なAzure リソースに安全にアクセスできるようにします。 これらのプライベート エンドポイントは、マネージド ネットワークから、Storage、AI Search、Foundry プロジェクトで使用されるその他の依存関係などのサービスへの分離されたプライベート IP ベースの接続を提供します。 カスタマー マネージド仮想ネットワークとは異なり、Foundry のマネージド プライベート エンドポイントは、ネットワーク インターフェイスまたはサブネット構成を顧客に公開しません。 Microsoftはプライベート IP ベースの接続を完全に管理し、顧客のサブスクリプションでは NIC として表しません。

次のリソースは、マネージド ネットワークからのプライベート エンドポイントをサポートします。 CLI を使用してプライベート エンドポイントを作成する必要があります。

• Microsoft Foundry (AI サービス)
• Azure Application Gateway (L4 または L7 トラフィックを使用してオンプレミスのリソースに接続します)
• Azure API Management (VNet インジェクションのないクラシック 層と、仮想ネットワーク統合を備えた Standard V2 レベルのみをサポート)
• Azure AI 検索
• Azure Container Registry
• Azure Cosmos DB
• Azure Data Factory
• Azure Database for MariaDB
• Azure Database for MySQL
• PostgreSQL 単一サーバーのAzure Database
• Azure Database for PostgreSQL フレキシブル サーバー
• Azure Databricks
• Azure Event Hubs
• Azure Key Vault
• Azure Machine Learning
• Azure Cache for Redis
• Azure SQL Server
• Azure Storage
• Azure アプリケーション Insights (Azure Monitor Private Link スコープ経由)

Foundry マネージド仮想ネットワークから顧客所有のターゲット リソースにマネージド プライベート エンドポイントを作成する場合、 Foundry リソースのマネージド ID は、プライベート エンドポイント接続を作成して承認するために、そのターゲット リソースに対する適切なアクセス許可を持っている必要があります。 この要件により、Foundry にリソースへのセキュリティで保護されたプライベート リンクを確立する権限が明示的に付与されます。

この要件を簡略化するには、foundry アカウントのマネージド ID に Azure AI Enterprise Network Connection Approver ロール (ロール ID: b556d68e-0be0-4f35-a333-ad7ee1ce17ea) を割り当てます。 このロールには、最も一般的に使用されるAzure サービスに必要なアクセス許可が含まれており、通常は、Foundry がユーザーに代わってプライベート エンドポイントを作成および承認するための十分なアクセス権を提供します。 接続を承認すると、Foundry はプライベート エンドポイントを完全に管理し、追加の顧客構成は必要ありません。

必要な発信規則

マネージド仮想ネットワークの 承認された送信のみを許可 モードでは、エージェント サービスなどの機能に必要な送信規則がいくつか作成されます。 これらの規則には、次の宛先が含まれます。

• Cosmos DB リソースへのプライベート エンドポイント
• ストレージ アカウントへのプライベート エンドポイント
• AI Search リソースへのプライベート エンドポイント
• AzureActiveDirectory へのサービス タグ

シナリオごとの送信規則

マネージド仮想ネットワークを使用して Foundry を 承認済み送信 許可モードでデプロイする場合は、エグレス トラフィックが許可されるように、次の送信 FQDN 規則を追加することが必要になる場合があります。 次の一覧は、Foundry のシナリオまたは機能に応じて、送信規則を作成するための信頼できる完全修飾ドメイン名 (FQDN) とサービス タグを示しています。

価格

Foundry マネージド仮想ネットワーク機能は無料です。 ただし、マネージド仮想ネットワークで使用される次のリソースに対して課金されます。

• Azure Private Link - ソリューションは、マネージド仮想ネットワークとAzure リソース間の通信をセキュリティで保護するプライベート エンドポイントのAzure Private Linkに依存します。 価格の詳細については、「Azure Private Link pricing」を参照してください。

• FQDN 送信規則 - Azure Firewallを使用して FQDN 送信規則を実装します。 送信 FQDN 規則を使用する場合は、課金にAzure Firewallの料金を追加します。 既定では、Azure Firewallの標準バージョンが使用されます。 基本バージョンを選択できます。 送信 FQDN 規則を追加するまで、ファイアウォールは作成されません。

Azure価格の詳細については、Private Link価格およびAzure Firewall価格を参照してください。

マネージド ネットワークとカスタム (BYO) ネットワークを比較する

企業におけるネットワークのニーズと制限に応じて、適切な送信ネットワーク分離モードを選択します。

エージェントの仮想ネットワークインジェクションのセットアップと制限の詳細については、「エージェント のカスタム仮想ネットワークを構成する」を参照してください。

リソースのクリーンアップ

マネージド仮想ネットワーク Foundry リソースをクリーンアップするには、Foundry リソースを削除します。 このアクションにより、マネージド仮想ネットワークも削除されます。

トラブルシューティング

1. CapHost の作成に失敗しました
   • 問題のある CapHost リソースを削除し、テンプレートを再デプロイします。
2. FQDN 規則が適用されない
   • ファイアウォール SKU がプロビジョニングされていることを確認し、ポートが 80 または 443 に制限されていることを確認します。
3. プライベート エンドポイントの競合
   • サービス エンドポイント構成を削除し、プライベート エンドポイントのみを使用します。

関連コンテンツ

• エージェント用のカスタム仮想ネットワークを構成する
• Microsoft Foundry