Настройка управляемой виртуальной сети для проектов Microsoft Foundry

В этой статье объясняется, как настроить управляемую виртуальную сеть для ресурса Foundry. Управляемая виртуальная сеть упрощает и автоматизирует сетевую изоляцию для ресурса Foundry путем подготовки виртуальной сети, управляемой Microsoft, которая защищает базовые вычислительные ресурсы службы Агентов в проектах Foundry. При включении исходящий сетевой трафик агентов защищен этой управляемой сетевой границей и режим изоляции, который вы выбираете, управляет всем трафиком. Вы можете создать необходимые частные конечные точки для зависимых служб Azure и применить необходимые правила сети, предоставляя безопасное значение по умолчанию без необходимости создавать или поддерживать собственную виртуальную сеть. Эта управляемая сеть ограничивает доступ агентов, что помогает предотвратить утечку данных, позволяя подключаться к утвержденным Azure ресурсам.

Теперь управляемая виртуальная сеть поддерживает службы агента "Запрос" и "Размещенный агент" с новым API ответов и на новом портале Foundry. Текущие поддерживаемые регионы для управляемой виртуальной сети с новой службой агента и новым порталом Foundry: Восток США, Восток США 2, Восток Японии, Центральная Франция, ОАЭ Север, Юг Бразилии, Центральная Испания, Германия Запад Центральная, Север Италии, Южный Центральный США, Восток Австралии, Центральная Швеция, Восток Канады, Север ЮАР, Запад США, Запад США 3, Юг Индии и Юг Великобритании. Поддержка дополнительных регионов в ближайшее время.

Прежде чем продолжить, рассмотрите ограничения предложения и просмотрите предварительные требования.

Общие сведения о режимах изоляции

При включении изоляции управляемой виртуальной сети создается управляемая виртуальная сеть для учетной записи Foundry, созданная в клиенте Microsoft. Любой новый агент, который вы создаете в проектах, автоматически использует управляемую виртуальную сеть для исходящего трафика. Управляемая виртуальная сеть может использовать частные конечные точки для Azure ресурсов, используемых агентами, например служба хранилища Azure, Azure Cosmos DB и Поиск с использованием ИИ Azure.

Существует два разных режима конфигурации для исходящего трафика из управляемой виртуальной сети:

На следующей схеме архитектуры показана управляемая сеть в allow internet outbound режиме.

На следующей схеме архитектуры показана управляемая сеть в allow only approved outbound режиме.

После настройки управляемой виртуальной сети Foundry для разрешения исходящего трафика через Интернет невозможно перенастроить ресурс на отключенный. Аналогичным образом после настройки ресурса управляемой виртуальной сети разрешить только утвержденный исходящий трафик невозможно перенастроить ресурс, чтобы разрешить исходящий трафик через Интернет.

Необходимые условия

Перед выполнением действий, описанных в этой статье, убедитесь, что у вас есть следующие предварительные требования:

• Подписка Azure. Если у вас нет подписки Azure, создайте бесплатную учетную запись перед началом работы.

• Azure CLI установлен на версию 2.86.0. Требуется для создания правил исходящего трафика из управляемой сети.

• Microsoft.Network, Microsoft.KeyVault, Microsoft.CognitiveServices, Microsoft.Storage, Microsoft.Search и Microsoft.ContainerService поставщики ресурсов, зарегистрированные для подписки Azure. Дополнительные сведения см. в разделе "Регистрация поставщика ресурсов".

• Разрешения для развертывания управляемого сетевого ресурса. Foundry Account Owner в области ресурсов Foundry необходимо создать учетную запись и проект Foundry. Owner или Role Based Access Administrator необходимо для назначения RBAC требуемым ресурсам. Foundry User определение объема проекта необходимо для создания и развертывания агентов.

  Важно

  Недавно были переименованы роли RBAC в Foundry. Foundry User, Foundry Owner, Foundry Account Owner и Foundry Project Manager ранее назывались пользователь Azure AI, владелец Azure AI, владелец учетной записи Azure AI и руководитель проекта Azure AI. Пока новое название внедряется, в некоторых местах вы всё ещё можете видеть прежние названия. Идентификаторы ролей и основные разрешения не меняются из-за переименования.

• Достаточная квота для всех ресурсов в целевом Azure регионе. Если параметры не передаются, этот шаблон создает ресурс Foundry, проект Foundry, Azure Cosmos DB для NoSQL, Поиск с использованием ИИ Azure и учетную запись служба хранилища Azure.

Ограничения

Прежде чем включить управляемую сетевую изоляцию для ресурса Foundry, рассмотрите следующие ограничения.

1. Вы можете развернуть управляемый сетевой ресурс Foundry тремя способами.
2. Bicep шаблон в папке 18-managed-virtual-network в foundry-samples
3. Шаблон Terraform в папке 18-managed-virtual-network in foundry-samples
4. az rest и команды Azure CLI az cognitiveservices. Дополнительные сведения о поддержке Azure CLI в этой статье ниже.
5. Портал Azure пока не поддерживает пользовательский интерфейс для создания управляемой сети. Поддержка скоро появится.
6. ** После создания ресурса Foundry убедитесь, что вы назначили управляемую идентичность ресурса Foundry встроенной роли Azure AI Enterprise Network Connection Approver (идентификатор роли: b556d68e-0be0-4f35-a333-ad7ee1ce17ea), чтобы гарантировать создание и одобрение необходимой частной конечной точки для ресурса Foundry.
7. Вы не можете отключить изоляцию управляемой виртуальной сети после включения. Нет пути обновления из настраиваемой виртуальной сети для управляемой виртуальной сети. Требуется повторное развертывание ресурсов Foundry. Удаление ресурса Foundry удаляет управляемую виртуальную сеть.
8. Поддержка управляемой виртуальной сети находится только в следующих регионах: восточная часть США, восточная часть США2, Восточная Япония, Центральная Франция, Северная Бразилия, Южная Испания, Центральная Германия, Центральная Германия, Северная Италия, Восточная Часть США, Восточная Швеция, Восточная Канада, Западная часть США, Западная часть США 3, Южная Индия и Южная Великобритания. Поддержка дополнительных регионов в ближайшее время.
9. Если требуется частный доступ к локальным ресурсам для ресурса Foundry, используйте шлюз приложений для настройки локального доступа. Та же конфигурация с частной конечной точкой для шлюза приложений и настройкой пулов серверов поддерживается. Трафик L4 и L7 теперь поддерживается шлюзом приложений в общем доступе.
10. Если вы создаете правила исходящего доступа по полным доменным именам (FQDN), когда управляемая виртуальная сеть находится в режиме Allow Only Approved Outbound, создается управляемый Azure Брандмауэр, что влечет за собой соответствующие затраты на брандмауэр. Дополнительные сведения о ценах см. в разделе "Цены". Правила исходящего трафика по FQDN поддерживают только порты 80 и 443.
11. Вы не можете перенести собственные Брандмауэр Azure в управляемую виртуальную сеть. Управляемый брандмауэр автоматически создается для учетной записи Foundry при использовании режима "Разрешить только утвержденный исходящий трафик ".
12. Нельзя повторно использовать один управляемый брандмауэр для нескольких учетных записей Foundry. Каждая учетная запись Foundry создает собственный управляемый брандмауэр при использовании режима "Разрешить только утвержденный исходящий трафик".
13. Если вы создаете новые проекты в ресурсе Foundry с включенной поддержкой управляемой виртуальной сети, необходимо повторно создать управляющий хост проекта, а также убедиться, что проект использует собственные ресурсы (BYO) и управляемую сеть. Дополнительные инструкции приведены в readME для настройки управляемой сети в репозитории foundry-samples.

Развертывание режима изоляции управляемой виртуальной сети

Чтобы приступить к развертыванию ресурса 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-03-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-03-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 \
  --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=2026-03-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

Для управляемой виртуальной сети Брандмауэр Azure настраивается автоматически, когда вы добавляете правило исходящего трафика FQDN в режиме Разрешить только утвержденный исходящий трафик.

Номер SKU по умолчанию — "Стандартный" для брандмауэра. Вместо этого можно выбрать номер SKU "Базовый" для снижения затрат, если дополнительные функции не требуются. Дополнительные сведения о ценах см. в разделе "Цены". Выбрав номер SKU брандмауэра во время развертывания, его нельзя изменить после развертывания. Поскольку это управляемый брандмауэр, брандмауэр не находится у арендатора или под вашим контролем. Единственным параметром управления является номер SKU брандмауэра.

Частные конечные точки

При включении управляемой виртуальной сети можно создавать управляемые частные конечные точки, чтобы агенты могли безопасно получать доступ к необходимым Azure ресурсам без использования общедоступного Интернета. Эти частные конечные точки обеспечивают изолированное, частное IP-подключение из управляемой сети к службам, таким как хранилище, поиск ИИ и другие зависимости, используемые в проектах Foundry. В отличие от управляемых клиентом виртуальных сетей, управляемые частные конечные точки в Foundry не предоставляют конфигурацию сетевого интерфейса или подсети клиенту. Подключение на основе частного IP-адреса полностью управляется Microsoft и не представлено как сетевой адаптер в подписке клиента.

Следующие ресурсы поддерживают частные конечные точки из управляемой сети. Для создания частных конечных точек необходимо использовать интерфейс командной строки.

• Microsoft Foundry (службы ИИ)
• Шлюз приложений Azure (подключается к локальным ресурсам с помощью трафика L4 или L7)
• Azure API Management (поддерживает только классический уровень без внедрения виртуальной сети и уровня "Стандартный" версии 2 с интеграцией виртуальной сети)
• Поиск с использованием ИИ Azure
• Реестр контейнеров Azure (реестр контейнеров)
• Azure Cosmos DB
• Фабрика данных Azure
• База данных Azure для MariaDB
• База данных Azure для MySQL
• База данных Azure для PostgreSQL одиночный сервер
• База данных Azure для PostgreSQL — гибкий сервер
• Azure Databricks
• Центры событий Azure
• Azure Key Vault
• Машинное обучение Azure
• Кэш Azure для Redis
• Azure SQL Server
• служба хранилища Azure
• приложение Azure Insights (с помощью области охвата Azure Monitor Приватный канал)

При создании частной управляемой конечной точки из управляемой виртуальной сети Foundry в целевой ресурс, принадлежащий клиенту, управляемое удостоверение ресурса Foundry должно иметь правильные разрешения на этот целевой ресурс для создания и утверждения подключений частной конечной точки. Это требование гарантирует, что Foundry имеет явную авторизацию для создания безопасной приватной ссылки на ресурс.

Чтобы упростить это требование, назначьте роль Azure AI Enterprise Network Connection Approver (идентификатор роли: b556d68e-0be0-4f35-a333-ad7ee1ce17ea) управляемому удостоверению учетной записи Foundry. Эта роль включает необходимые разрешения для наиболее часто используемых служб Azure и обычно предоставляет достаточный доступ для Foundry для создания и утверждения частных конечных точек от вашего имени. После утверждения подключения Foundry полностью управляет частной конечной точкой и не требует дополнительной конфигурации клиента.

Обязательные правила исходящего трафика

В режиме допуска только утвержденного исходящего трафика управляемой виртуальной сетью создаются необходимые исходящие правила для таких функций, как служба агента. он включает в себя следующее:

• Частная конечная точка для ресурса Cosmos DB
• Частная конечная точка для вашего аккаунта хранения
• Приватная конечная точка для вашего ресурса AI-поиска
• ServiceTag в AzureActiveDirectory
• ServiceTag to AzureMachineLearning (для каталога оценок)

Правила исходящего трафика для каждого сценария

При развертывании Foundry с виртуальной сетью под управлением в режиме "Разрешить только утвержденный исходящий трафик" может потребоваться добавить следующие правила FQDN для исходящего трафика. Ниже приведен список доверенных полных доменных имен (FQDN) для создания правил исходящего трафика в зависимости от сценария или компонента в Foundry.

Цены

Функция управляемой виртуальной сети Foundry бесплатна. Однако плата взимается за следующие ресурсы, используемые управляемой виртуальной сетью:

• Приватный канал Azure. Решение использует Приватный канал Azure для частных конечных точек, которые защищают обмен данными между управляемой виртуальной сетью и ресурсами Azure. Дополнительные сведения о ценах см. в разделе цены на Приватный канал Azure.

• Правила исходящего трафика FQDN — вы реализуете правила исходящего трафика FQDN с помощью Брандмауэр Azure. Если вы используете правила полного доменного имени для исходящего трафика, это приведет к увеличению расходов на Брандмауэр Azure в ваших счетах. Стандартная версия Брандмауэр Azure используется по умолчанию. Вы можете выбрать базовую версию. Брандмауэр не создается, пока не будет добавлено правило по исходящим FQDN.

Дополнительные сведения о ценах Azure см. в разделе Цены на Приватный канал и Цены на Брандмауэр Azure.

Сравнение управляемой и настраиваемой сети (BYO)

Выберите правильный режим сетевой изоляции исходящего трафика в зависимости от потребностей сети и ограничений в вашей организации.

Дополнительные сведения о настройке внедрения виртуальной сети для агентов и ограничениях см. в разделе "Настройка настраиваемой виртуальной сети для агентов".

Очистка ресурсов

Чтобы очистить ресурс Foundry вашей управляемой виртуальной сети, удалите ресурс Foundry. Это действие также удаляет управляемую виртуальную сеть.

Устранение неполадок

1. Сбой при создании CapHost
   • Удалите неисправный ресурс CapHost и повторно разверните шаблон.
2. Правило FQDN не применяется
   • Проверьте, что SKU брандмауэра подготовлен, и убедитесь, что порты ограничены до 80 или 443.
3. Конфликты частного эндпоинта
   • Удалите любую конфигурацию конечной точки службы и используйте только частную конечную точку.

Связанное содержимое

• Настройка настраиваемой виртуальной сети для агентов
• Настройка сетевой изоляции для Microsoft Foundry