Configurar a rede virtual gerenciada para projetos do Microsoft Foundry

Este artigo explica como configurar uma rede virtual gerenciada para o recurso Foundry. Uma rede virtual gerenciada simplifica e automatiza o isolamento de rede provisionando uma rede virtual gerenciada por Microsoft que protege a computação subjacente do serviço Agents em seus projetos do Foundry.

Quando você o habilita, esse limite de rede gerenciada protege o tráfego de rede de saída dos Agentes e o modo de isolamento escolhido controla todo o tráfego. Você pode criar os pontos de extremidade privados necessários para serviços de Azure dependentes e aplicar as regras de rede necessárias.

Você obtém um padrão seguro sem exigir que você crie ou mantenha sua própria rede virtual. Essa rede gerenciada restringe o que seus Agentes podem acessar, ajudando a impedir a exfiltração de dados, enquanto ainda permite conectividade com recursos aprovados do Azure.

A rede virtual gerenciada agora dá suporte aos serviços Prompt e Hosted Agent com a nova API de Respostas e no novo portal do Foundry. As regiões com suporte atualmente para rede virtual gerenciada com o novo serviço de Agente e o novo portal do Foundry são as seguintes: Leste dos EUA, Leste dos EUA 2, Leste do Japão, França Central, Norte dos Emirados Árabes Unidos, Sul do Brasil, Espanha Central, Alemanha Centro-Oeste, Norte da Itália, Centro-Sul dos EUA, Leste da Austrália, Suécia Central, Leste do Canadá, Norte da África do Sul, Oeste dos EUA, Oeste dos EUA 3, Sul da Índia e Sul do Reino Unido.

Antes de continuar, considere as limitações da oferta e examine os pré-requisitos.

Entender os modos de isolamento

Ao habilitar o isolamento de rede virtual gerenciada, você cria uma rede virtual gerenciada para a conta do Foundry, criada no locatário Microsoft. Qualquer novo Agente criado em seus projetos usa automaticamente a rede virtual gerenciada para tráfego de saída. A rede virtual gerenciada pode usar pontos de extremidade privados para recursos do Azure usados por seus Agentes, como o Armazenamento do Azure, o Azure Cosmos DB e a Pesquisa de IA do Azure .

Existem três modos de configuração para o tráfego de saída da rede virtual gerenciada:

O diagrama de arquitetura a seguir mostra uma rede gerenciada no allow internet outbound modo.

O diagrama de arquitetura a seguir mostra uma rede gerenciada no allow only approved outbound modo.

Depois de configurar uma rede virtual gerenciada do Foundry para permitir saída da Internet, você não poderá reconfigurar o recurso como desabilitado. Da mesma forma, depois de configurar um recurso de rede virtual gerenciado para permitir apenas a saída aprovada, você não poderá reconfigurar o recurso para permitir a saída da Internet.

Pré-requisitos

Antes de seguir as etapas deste artigo, verifique se você tem os seguintes pré-requisitos:

• Uma assinatura Azure. Se você não tiver uma assinatura Azure, crie uma conta gratuita antes de começar.

• CLI do Azure versão 2.86.0 ou posterior. Necessário para criar regras de saída da rede gerenciada.

  Nota

  O az cognitiveservices account managed-network grupo de comandos está em versão prévia e pode ser alterado.

• Os provedores de recursos Microsoft.Network, Microsoft.KeyVault, Microsoft.CognitiveServices, Microsoft.Storage, Microsoft.Search e Microsoft.ContainerService registrados para sua assinatura de Azure. Para obter mais informações, consulte Registrar provedor de recursos.

• Permissões para implantar um recurso de rede gerenciado. Foundry Account Owner e necessário ter acesso ao escopo de recursos do Foundry para criar uma conta e um projeto no Foundry. Owner ou Role Based Access Administrator são necessários para atribuir RBAC aos recursos necessários. Foundry User no escopo do projeto é necessário para criar e desenvolver agentes.

  Importante

  As funções RBAC do Foundry foram renomeadas recentemente. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager eram anteriormente chamados de Usuário do Azure AI, Proprietário do Azure AI, Proprietário da conta do Azure AI e Gerente de Projeto do Azure AI. Você ainda pode ver os nomes anteriores em alguns lugares enquanto essa mudança de nome está sendo implementada. Os IDs das funções e as permissões principais não são alterados com a mudança de nome.

• Cota suficiente para todos os recursos em sua região de Azure de destino. Se você não passar parâmetros, esse modelo criará um recurso do Foundry, um projeto do Foundry, Azure Cosmos DB para NoSQL, Pesquisa de IA do Azure  e Armazenamento do Azure conta.

Limitações

Considere as seguintes limitações antes de habilitar o isolamento de rede gerenciado para o recurso Foundry.

1. Você pode implantar um recurso do Foundry de rede gerenciada de três maneiras:
2. Modelo do bíceps na pasta 18-managed-virtual-network em foundry-samples
3. Modelo do Terraform na pasta 18-managed-virtual-network em foundry-samples
4. az rest e comandos da CLI do Azure az cognitiveservices. Mais informações sobre CLI do Azure suporte neste artigo abaixo.
5. No momento, a interface do usuário do portal do Azure não dá suporte à criação da rede gerenciada. Use a CLI do Azure, az rest, ou os modelos do Bicep ou do Terraform em vez disso.
6. Depois de criar o recurso Foundry, atribua à identidade gerenciada do recurso Foundry a função interna Azure AI Enterprise Network Connection Approver (ID da função: b556d68e-0be0-4f35-a333-ad7ee1ce17ea) para garantir que o ponto de extremidade privado necessário para o recurso Foundry seja criado e aprovado.
7. Não é possível desabilitar o isolamento de rede virtual gerenciado depois de habilitá-lo. Não há nenhum caminho de atualização da configuração de rede virtual personalizada para a rede virtual gerenciada. Uma redistribuição do recurso Foundry é necessária. A exclusão do recurso Foundry exclui a rede virtual gerenciada.
8. O suporte para rede virtual gerenciada está apenas nas seguintes regiões: Leste dos EUA, Leste dos EUA 2, Leste do Japão, França Central, Norte dos Emirados Árabes Unidos, Sul do Brasil, Espanha Central, Centro-Oeste da Alemanha, Norte da Itália, Centro-Sul dos EUA, Leste da Austrália, Suécia Central, Leste do Canadá, Norte da África do Sul, Oeste dos EUA, Oeste dos EUA 3, Sul da Índia e Sul do Reino Unido. Suporte de região adicional a ser seguido em breve.
9. Se você precisar de acesso privado a recursos locais para seu recurso do Foundry, use o Gateway de Aplicativo para configurar o acesso local. A mesma configuração com um ponto de extremidade privado para o Gateway de Aplicativo e a configuração de pools de back-end é suportada. O Gateway de Aplicativo agora oferece suporte ao tráfego L4 e L7 em GA.
10. Se você criar regras de saída FQDN enquanto a rede virtual gerenciada estiver no modo Permitir Apenas Saídas Aprovadas, será criado um Firewall Gerenciado do Azure, que inclui custos associados ao Firewall. Para obter mais informações sobre preços, consulte Preços. As regras de saída do FQDN dão suporte apenas às portas 80 e 443.
11. Você não pode trazer seu próprio Firewall do Azure para a rede virtual gerenciada. Um firewall gerenciado é criado automaticamente para sua conta do Foundry quando você usa o modo permitir somente saída aprovada .
12. Você não pode reutilizar o mesmo firewall gerenciado para várias contas do Foundry. Cada conta do Foundry cria seu próprio firewall gerenciado quando você usa o modo Permitir Somente Saída Aprovada.
13. Se você criar novos projetos em seu recurso foundry que tenha a rede virtual gerenciada habilitada, será necessário recriar o host de funcionalidade do projeto também para garantir que o projeto esteja usando os recursos BYO e a rede gerenciada. Mais instruções estão no README para a configuração da rede gerenciada no foundry-samples repository.

Implantar o modo de isolamento de rede virtual gerenciado

Para iniciar a implantação de um recurso do Foundry de rede virtual gerenciada, siga as etapas na seção seguinte.

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

Para obter mais detalhes sobre os parâmetros necessários para a implantação de rede virtual gerenciada, consulte Microsoft. CognitiveServices/accounts/managedNetworks.

Verificar a implantação de rede virtual gerenciada

Após a conclusão da implantação, verifique se a rede virtual gerenciada está configurada corretamente.

Gerenciar regras de saída

Após a implantação, você pode adicionar, atualizar, listar e remover regras de saída para controlar quais destinos sua rede gerenciada pode alcançar. São suportados os seguintes tipos de regras de saída:

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
      }
    }
  }'

Para obter mais detalhes sobre os parâmetros necessários para regras de saída de rede virtual gerenciadas, consulte Microsoft. CognitiveServices/accounts/managedNetworks/outboundRules.

Selecione Firewall do Azure versão

Para a rede virtual gerenciada, um Firewall do Azure é provisionado automaticamente quando você adiciona uma regra FQDN de saída no modo 'Permitir somente saída aprovada'.

O SKU padrão é Standard para o Firewall. Em vez disso, você pode selecionar a SKU Básica para reduzir o custo se recursos avançados não forem necessários. Para obter mais informações sobre preços, consulte Preços. Depois de selecionar um SKU de firewall na implantação, você não poderá alterá-lo após a implantação. Como esse é um firewall gerenciado, o firewall não está no seu ambiente ou sob seu controle. A única configuração que você pode controlar é a SKU do firewall.

Pontos de extremidade privados

Ao habilitar uma rede virtual gerenciada, você pode criar pontos de extremidade privados gerenciados para que os agentes possam acessar com segurança os recursos Azure necessários sem usar a Internet pública. Esses pontos de extremidade privados fornecem uma conexão isolada e privada baseada em IP da rede gerenciada para serviços como Storage, Pesquisa de IA e outras dependências usadas em seus projetos do Foundry. Ao contrário das redes virtuais gerenciadas pelo cliente, os pontos de extremidade privados gerenciados no Foundry não expõem uma interface de rede ou uma configuração de sub-rede ao cliente. Microsoft gerencia totalmente a conectividade baseada em IP privado e não a representa como uma NIC na assinatura do cliente.

Os recursos a seguir dão suporte a pontos de extremidade privados da rede gerenciada. Você deve usar a CLI para criar endpoints privados.

• Microsoft Foundry (Serviços de IA)
• Gateway de Aplicativo do Azure (conecta-se aos recursos locais usando o tráfego L4 ou L7)
• Gerenciamento de API do Azure (dá suporte apenas à camada Clássica sem injeção de VNet e à camada Standard V2 com integração de rede virtual)
• Pesquisa de IA do Azure 
• Registro de Contêiner do Azure
• Azure Cosmos DB
• Azure Data Factory
• Banco de Dados do Azure para MariaDB
• Banco de Dados do Azure para MySQL
• Servidor Único do Banco de Dados do Azure para PostgreSQL
• Servidor Flexível do Banco de Dados do Azure para PostgreSQL
• Azure Databricks
• Hubs de Eventos do Azure
• Azure Key Vault
• Azure Machine Learning
• Cache do Azure para Redis
• SQL Server do Azure
• Armazenamento do Azure
• Aplicativo Azure Insights (por meio do Azure Monitor Link Privado Scope)

Ao criar um ponto de extremidade privado gerenciado da rede virtual gerenciada do Foundry para um recurso de destino de propriedade do cliente, a identidade gerenciada do recurso do Foundry deve ter as permissões corretas nesse recurso de destino para criar e aprovar conexões de endpoint privado. Esse requisito garante que a Foundry esteja explicitamente autorizada a estabelecer um link seguro e privado para o recurso.

Para simplificar esse requisito, atribua a função Azure AI Enterprise Network Connection Approver (ID da função: b556d68e-0be0-4f35-a333-ad7ee1ce17ea) à identidade gerenciada da conta do Foundry. Essa função inclui as permissões necessárias para os serviços da Azure usados com mais frequência e normalmente fornece acesso suficiente para o Foundry criar e aprovar pontos de extremidade privados em seu nome. Depois de aprovar a conexão, a Foundry gerencia totalmente o ponto de extremidade privado e não requer nenhuma configuração adicional do cliente.

Regras de saída obrigatórias

No modo Permitir Apenas Saída Aprovada da rede virtual gerenciada, o sistema cria algumas regras de saída necessárias para recursos como o serviço Agente. Essas regras incluem os seguintes destinos:

• Ponto de extremidade privado para o seu recurso do Cosmos DB
• Ponto de extremidade privado para sua conta de armazenamento
• Ponto de extremidade privado para o seu recurso de Pesquisa com IA
• Marca de serviço para AzureActiveDirectory

Regras de saída para cada cenário

Se você implantar o Foundry com rede virtual gerenciada no modo Permitir somente saída aprovada, talvez seja necessário adicionar as seguintes regras de FQDN de saída para garantir que o tráfego de saída seja permitido. A lista a seguir mostra FQDNs (nomes de domínio totalmente qualificados) confiáveis e tags de serviço para a criação de regras de saída, dependendo do cenário ou do recurso no Foundry.

Preços

O recurso de rede virtual gerenciada do Foundry é gratuito. No entanto, você é cobrado pelos seguintes recursos que a rede virtual gerenciada usa:

• Link Privado do Azure - A solução depende de Link Privado do Azure para pontos de extremidade privados que protegem as comunicações entre a rede virtual gerenciada e os recursos de Azure. Para obter mais informações sobre preços, consulte Link Privado do Azure preços.

• Regras de saída do FQDN – você implementa regras de saída do FQDN usando Firewall do Azure. Se você usar regras FQDN de saída, serão cobrados encargos adicionais para o Firewall do Azure em sua fatura. Uma versão padrão de Firewall do Azure é usada por padrão. Você pode selecionar a versão Básica. O firewall não será criado até que você adicione uma regra FQDN de saída.

Para obter mais informações sobre preços Azure, consulte Link Privado Pricing e Firewall do Azure Pricing.

Comparar redes gerenciadas e personalizadas (BYO)

Selecione o modo de isolamento de rede de saída correto para você, dependendo das suas necessidades de rede e limitações em sua empresa.

Para obter mais informações sobre a configuração de injeção de rede virtual para Agentes e as limitações, consulte Configurar uma rede virtual personalizada para Agentes.

Limpar recursos

Para limpar o recurso Foundry da rede virtual gerenciada, exclua o recurso Foundry. Essa ação também exclui a rede virtual gerenciada.

Solucionando problemas

1. Falha ao criar o CapHost
   • Exclua o recurso com falha do CapHost e reimplante o modelo.
2. Regra FQDN não aplicada
   • Confirme se o SKU do firewall está provisionado e verifique se as portas estão limitadas a 80 ou 443.
3. Conflitos de ponto de extremidade privado
   • Remova qualquer configuração de ponto de extremidade de serviço e use apenas o ponto de extremidade privado.

Conteúdo relacionado

• Configurar uma rede virtual personalizada para agentes
• Configure o isolamento de rede para Microsoft Foundry