Konfigurera hanterat virtuellt nätverk för Microsoft Foundry-projekt

Den här artikeln beskriver hur du konfigurerar ett hanterat virtuellt nätverk för din Foundry-resurs. Hanterat virtuellt nätverk effektiviserar och automatiserar nätverksisolering för din Foundry-resurs genom att etablera ett Microsoft hanterat virtuellt nätverk som skyddar agenttjänstens underliggande beräkning i dina Foundry-projekt. När den är aktiverad skyddas agenternas utgående nätverkstrafik av den här hanterade nätverksgränsen, och det isoleringsläge som du väljer styr all trafik. Du kan skapa de privata slutpunkter som krävs för beroende Azure tjänster och tillämpa de nödvändiga nätverksreglerna, vilket ger dig ett säkert standardvärde utan att du behöver skapa eller underhålla ditt eget virtuella nätverk. Det här hanterade nätverket begränsar vad dina agenter kan komma åt, vilket förhindrar dataexfiltrering samtidigt som anslutningen till godkända Azure resurser tillåts.

Det hanterade virtuella nätverket har nu stöd för prompt- och värdbaserade agenttjänster med det nya svars-API:et och i den nya Foundry-portalen. De aktuella regioner som stöds för hanterat virtuellt nätverk med den nya agenttjänsten och den nya Foundry-portalen är följande: USA, östra, USA, östra 2, Japan, östra, Frankrike, centrala, Förenade Arabemiraten, norra, Brasilien, södra, Spanien, centrala, Tyskland, västra centrala, Italien, norra, USA, södra centrala, Australien, östra, Sverige, centrala, Kanada, östra, Sydafrika, norra, USA, västra, USA, västra 3, Södra Indien och Storbritannien, södra. Ytterligare regionstöd att följa snart.

Innan du fortsätter bör du överväga begränsningarna i erbjudandet och granska förutsättningarna.

Förstå isoleringslägen

När du aktiverar funktionen för isolering av hanterade virtuella nätverk, skapar du ett hanterat virtuellt nätverk för Foundry-kontot, skapat i Microsoft-klienten. Alla nya agenter som du skapar i dina projekt använder automatiskt det hanterade virtuella nätverket för utgående trafik. Det hanterade virtuella nätverket kan använda privata slutpunkter för Azure resurser som dina agenter använder, till exempel Azure Storage, Azure Cosmos DB och Azure AI-sökning.

Det finns två olika konfigurationslägen för utgående trafik från det hanterade virtuella nätverket:

Följande arkitekturdiagram visar ett hanterat nätverk i allow internet outbound läge.

Följande arkitekturdiagram visar ett hanterat nätverk i allow only approved outbound läge.

När du har konfigurerat ett hanterat virtuellt nätverk Foundry för att tillåta utgående Internet kan du inte konfigurera om resursen till inaktiverad. När du har konfigurerat en hanterad virtuell nätverksresurs så att den endast tillåter godkänd utgående trafik kan du inte konfigurera om resursen för att tillåta utgående Internet.

Förutsättningar

Innan du följer stegen i den här artikeln kontrollerar du att du har följande förutsättningar:

• En Azure-abonnemang. Om du inte har en Azure prenumeration skapar du ett kostnadsfritt konto innan du börjar.
• Azure CLI installerat på version 2.86.0. Krävs för att skapa utgående regler från det hanterade nätverket.
• Microsoft.Network, Microsoft.KeyVault, Microsoft.CognitiveServices, Microsoft.Storage, Microsoft.Search och Microsoft.ContainerService resursproviders registrerade för din Azure-prenumeration. Mer information finns i Registrera resursprovider.
• Behörigheter för att distribuera en hanterad nätverksresurs. Azure AI Account Owner på Foundry-resursens omfång krävs för att skapa ett Foundry-konto och projekt. Owner eller Role Based Access Administrator krävs för att tilldela RBAC till de resurser som krävs. Azure AI User i projektomfånget krävs för att skapa och bygga agenter.
• Tillräcklig kvot för alla resurser i målregionen Azure. Om inga parametrar skickas skapar den här mallen en Foundry-resurs, Foundry-projekt, Azure Cosmos DB för NoSQL, Azure AI-sökning och Azure Storage konto.

Begränsningar

Tänk på följande begränsningar innan du aktiverar hanterad nätverksisolering för din Foundry-resurs.

1. Du kan distribuera en foundry-resurs för hanterade nätverk på tre sätt.
2. Bicep-mall finns i mappen 18-managed-virtual-network i foundry-samples
3. Terraform-mall i mappen 18-managed-virtual-network i foundry-samples
4. Azure CLI-kommandon az cognitiveservices och az rest. Mer information om Azure CLI stöd i den här artikeln nedan.
5. Det finns inget stöd för Azure Portal användargränssnitt för att skapa det hanterade nätverket ännu. Stöd kommer snart.
6. När din Foundry-resurs har skapats kontrollerar du att du har tilldelat Foundry-resursens hanterade identitet den inbyggda rollen Azure AI Enterprise Network Connection Approver (roll-ID: b556d68e-0be0-4f35-a333-ad7ee1ce17ea) för att säkerställa att den privata slutpunkten som krävs för Foundry-resursen skapas och godkänns.
7. Du kan inte inaktivera isolering av hanterade virtuella nätverk när du har aktiverat det. Det finns ingen uppgraderingssökväg från anpassad konfiguration av virtuella nätverk till hanterat virtuellt nätverk. En omfördelning av Foundry-resurser krävs. När du tar bort foundry-resursen tas det hanterade virtuella nätverket bort.
8. Stöd för hanterade virtuella nätverk finns endast i följande regioner: USA, östra, USA, östra 2, Japan, östra, Frankrike, centrala, Förenade Arabemiraten, norra, Brasilien, södra, Spanien, centrala, Tyskland, centrala, Italien, norra, USA, södra centrala, Australien, östra, Sverige, centrala, Kanada, östra, Sydafrika, norra, USA, västra, USA, västra 3, Södra Indien och Storbritannien, södra. Ytterligare regionstöd att följa snart.
9. Om du behöver privat åtkomst till lokala resurser för din Foundry-resurs använder du Application Gateway för att konfigurera lokal åtkomst. Samma konfiguration med en privat slutpunkt till Application Gateway och konfigurering av backendpooler stöds. Både L4- och L7-trafik stöds nu med Application Gateway i GA.
10. Om du skapar utgående FQDN-regler när det hanterade virtuella nätverket är i Tillåt endast godkänd utgående-läge, skapas en hanterad Azure Firewall, och detta medför associerade brandväggskostnader. Mer information om priser finns i Priser. Utgående FQDN-regler stöder endast portarna 80 och 443.
11. Du kan inte ta med egna Azure Firewall till det hanterade virtuella nätverket. En hanterad brandvägg skapas automatiskt för ditt Foundry-konto när du använder läget Tillåt endast godkänd utgående trafik .
12. Du kan inte återanvända samma hanterade brandvägg för flera Foundry-konton. Varje Foundry-konto skapar en egen hanterad brandvägg när du använder läget Tillåt endast godkänd utgående trafik .
13. Om du skapar nya projekt i din Foundry-resurs och har ett aktiverat hanterat virtuellt nätverk, behöver du återskapa projektfunktionens värd för att se till att projektet använder Bring Your Own-resurserna och det hanterade nätverket. Fler instruktioner finns i README för konfiguration av hanterat nätverk i foundry-samples-lagringsplatsen.

Distribuera hanterat virtuellt nätverksisoleringläge

Kom igång med att distribuera en foundry-resurs för ett hanterat virtuellt nätverk genom att följa stegen nedan.

az rest --method PUT \
  --url "https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.CognitiveServices/accounts/{account-name}?api-version=2025-10-01-preview" \
  --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=2025-10-01-preview" \
  --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

Mer information om de parametrar som krävs för distribution av hanterade virtuella nätverk finns i Microsoft. CognitiveServices/accounts/managedNetworks.

Verifiera distribution av hanterat virtuellt nätverk

När distributionen är klar kontrollerar du att det hanterade virtuella nätverket är korrekt konfigurerat.

Hantera regler för utgående trafik

Efter distributionen kan du lägga till, uppdatera, lista och ta bort regler för utgående trafik för att styra vilka mål som ditt hanterade nätverk kan nå. Följande regeltyper för utgående trafik stöds:

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 \
  --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 '{"serviceResourceId":"/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.Storage/storageAccounts/{storage-name}","subresourceTarget":"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=2025-10-01-preview" \
  --body '{
    "properties": {
      "type": "PrivateEndpoint",
      "destination": {
        "serviceResourceId": "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.DocumentDB/databaseAccounts/{cosmosdb-account-name}",
        "subresourceTarget": "Sql",
        "sparkEnabled": false
      }
    }
  }'

Mer information om de parametrar som krävs för regler för utgående hanterade virtuella nätverk finns i Microsoft. CognitiveServices/accounts/managedNetworks/outboundRules.

Välj Azure Firewall version

För det hanterade virtuella nätverket etableras en Azure Firewall automatiskt när du lägger till en utgående FQDN-regel i Tillåt endast godkänt utgående läge.

Standard-SKU:n är Standard för brandväggen. Du kan välja Basic SKU i stället för lägre kostnad om avancerade funktioner inte krävs. Mer information om priser finns i Priser. När du har valt en brandväggs-SKU vid distributionen kan du inte ändra den efter distributionen. Eftersom det här är en hanterad brandvägg finns brandväggen inte i din klientorganisation eller under din kontroll. Den enda inställning som du kan styra är brandväggs-SKU:n.

Privata slutpunkter

När du aktiverar ett hanterat virtuellt nätverk kan du skapa hanterade privata slutpunkter så att agenter på ett säkert sätt kan nå nödvändiga Azure resurser utan att använda det offentliga Internet. Dessa privata slutpunkter tillhandahåller en isolerad, privat IP-baserad anslutning från det hanterade nätverket till tjänster som Lagring, AI Search och andra beroenden som används i dina Foundry-projekt. Till skillnad från kundhanterade virtuella nätverk exponerar hanterade privata slutpunkter i Foundry inte ett nätverksgränssnitt eller en undernätskonfiguration för kunden. Den privata IP-baserade anslutningen hanteras helt av Microsoft och representeras inte som ett nätverkskort i kundens prenumeration.

Följande resurser stöder privata slutpunkter från det hanterade nätverket. Du måste använda CLI för att skapa privata slutpunkter.

• Microsoft Foundry (AI Services)
• Azure Application Gateway (ansluter till dina lokala resurser med hjälp av L4- eller L7-trafik)
• Azure API Management (stöder endast den klassiska nivån utan VNet-inmatning och Standard V2-nivån med integrering av virtuellt nätverk)
• Azure AI-sökning
• Azure Container Registry
• Azure Cosmos DB
• Azure Data Factory
• Azure Database for MariaDB
• Azure Database for MySQL
• Azure Database for PostgreSQL Enserverlösning
• Azure Database for PostgreSQL Flexibel Server
• Azure Databricks
• Azure Event Hubs
• Azure Key Vault
• Azure Machine Learning
• Azure Cache for Redis
• Azure SQL Server
• Azure Storage
• Azure Application Insights (via Azure Monitor Private Link Scope)

När du skapar en hanterad privat slutpunkt från det foundry-hanterade virtuella nätverket till en kundägd målresurs måste Foundry-resursens hanterade identitet ha rätt behörighet för målresursen för att skapa och godkänna privata slutpunktsanslutningar. Det här kravet säkerställer att Foundry uttryckligen har behörighet att upprätta en säker, privat länk till resursen.

För att förenkla det här kravet tilldelar du rollen Azure AI Enterprise Network Connection Approver (roll-ID: b556d68e-0be0-4f35-a333-ad7ee1ce17ea) till Foundry-kontots hanterade identitet. Den här rollen innehåller nödvändiga behörigheter för de vanligaste Azure tjänster och ger vanligtvis tillräcklig åtkomst för Foundry för att skapa och godkänna privata slutpunkter för din räkning. När du har godkänt anslutningen hanterar Foundry fullständigt den privata slutpunkten och kräver ingen ytterligare kundkonfiguration.

Obligatoriska regler för utgående trafik

I läget Tillåt endast godkänd utgående trafik i det hanterade virtuella nätverket skapas några obligatoriska regler för utgående trafik för funktioner som agenttjänsten. Den innehåller följande:

• Privat anslutningspunkt för Cosmos DB-resursen
• Privat slutpunkt till ditt lagringskonto
• Privat slutpunkt för din AI Search-resurs
• ServiceTag till AzureActiveDirectory
• ServiceTag till AzureMachineLearning (för utvärderingskatalogen)

Regler för utgående trafik per scenario

Om du distribuerar Foundry med hanterat virtuellt nätverk i läget Tillåt endast godkänd utgående trafik kan du behöva lägga till följande utgående FQDN-regler för att säkerställa att utgående trafik tillåts. Nedan visas listan över betrodda fullständigt kvalificerade domännamn (FQDN) för att skapa utgående regler för beroende på scenario eller funktion i Foundry.

Prissättning

Funktionen Foundry managed virtual network (Gjutererat hanterat virtuellt nätverk) är kostnadsfri. Du debiteras dock för följande resurser som det hanterade virtuella nätverket använder:

• Azure Private Link – Lösningen förlitar sig på Azure Private Link för privata slutpunkter som skyddar kommunikationen mellan det hanterade virtuella nätverket och Azure resurser. Mer information om priser finns i Azure Private Link prissättning.

• Utgående FQDN-regler – Du implementerar utgående FQDN-regler med hjälp av Azure Firewall. Om du använder utgående FQDN-regler lägger du till avgifter för Azure Firewall till din fakturering. En standardversion av Azure Firewall används som standard. Du kan välja grundläggande version. Brandväggen skapas inte förrän du lägger till en utgående FQDN-regel.

Mer information om Azure prissättning finns i Private Link Pricing and Azure Firewall Pricing.

Jämförelse av hanterade och anpassade BYO-nätverk

Välj rätt utgående nätverksisoleringsläge beroende på dina nätverksbehov och begränsningar i företaget.

Mer information om konfiguration av inmatning av virtuella nätverk för agenter och begränsningar finns i Konfigurera ett anpassat virtuellt nätverk för agenter.

Rensa resurser

För att rensa din hanterade virtuella nätverksresurs Foundry, ta bort Foundry-resursen. Den här åtgärden tar också bort det hanterade virtuella nätverket.

Felsökning

1. Det gick inte att skapa CapHost
   • Ta bort den felaktiga CapHost-resursen och distribuera om mallen.
2. FQDN-regeln tillämpas inte
   • Bekräfta att brandväggs-SKU:n har tillhandahållits och kontrollera att portarna har begränsats till 80 eller 443.
3. Konflikter med privata slutpunkter
   • Ta bort alla tjänstslutpunktskonfigurationer och använd endast privat slutpunkt.

Relaterat innehåll

• Konfigurera ett anpassat virtuellt nätverk för agenter
• Konfigurera nätverksisolering för Microsoft Foundry