Перейти к содержанию
Публикация AiManual

Как подключить Amazon Bedrock AgentCore Gateway к приватным API и MCP-серверам в hub-and-spoke сети с централизованной инспекцией трафика

Разбор паттерна AWS: VPC Lattice resource gateway в сетевом аккаунте, маршрутизация его подсетей через Transit Gateway и инспекция трафика между AgentCore Gatew

Коротко

Что будет в материале

  1. 01

    Задача: агент ходит к внутренним API, а сеть требует файрвол на каждом плече

  2. 02

    Как устроена архитектура: аккаунты, VPC Lattice и Transit Gateway

  3. 03

    Шесть ключевых решений паттерна

  4. 04

    Что паттерн не решает: ограничения и слепые зоны

В корпоративной hub-and-spoke сети запрос AI-агента к внутреннему API успевает пройти через несколько аккаунтов, прежде чем вернуть ответ. Amazon Bedrock AgentCore Gateway в такой схеме не может просто указать на DNS-имя внутреннего балансировщика: подсети, из которых он ходит, должны принадлежать сетевой команде, иначе файрвол не поставить на пути.

Рабочий ответ выглядит так. VPC Lattice resource gateway размещается в выделенном VPC сетевого аккаунта, его подсети подключаются к AWS Transit Gateway, а трафик между Gateway и приватными целями идёт через центральный файрвол в inspection VPC в обе стороны. Resource configuration шарится в аккаунт Gateway через AWS Resource Access Manager, таргет создаётся в self-managed режиме, публичный эндпоинт Gateway закрывается последним шагом.

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

Задача: агент ходит к внутренним API, а сеть требует файрвол на каждом плече

В крупных компаниях центральная сетевая команда владеет каждым VPC и каждой подсетью, а любой поток между VPC обязан пройти через центральный файрвол в обе стороны. Агент, который вызывает внутренний REST API или MCP-сервер через Amazon Bedrock AgentCore Gateway, подчиняется тем же правилам, что и остальные сервисы. Сам Amazon Bedrock AgentCore описывается как платформа для построения, подключения и оптимизации агентов в масштабе с любым фреймворком или моделью.

Отсюда и ограничение. Gateway не может сам выбрать подсети под свой вход в сеть: в модели с централизованным владением подсети для него выделяет сетевая команда, а маршруты до инструментов проходят через общий Transit Gateway. Любая попытка обойти это ломает схему инспекции.

Когда этот паттерн действительно нужен

Паттерн рассчитан на среду, в которой одновременно выполняются три условия.

  • Сетевой аккаунт владеет всеми VPC, подсетями и подключениями AWS Transit Gateway и шарит подсети приложений через AWS RAM.
  • Центральный файрвол в inspection VPC инспектирует трафик на входе и выходе каждой VPC.
  • Приложения управляют только своими ресурсами и security groups, а сетевую топологию не трогают.

Если хотя бы один пункт не выполняется, инструкция ниже окажется сложнее задачи. Ресурсная модель паттерна избыточна там, где одна команда владеет и агентом, и инструментами, и подсетями.

Авторы паттерна прямо оговаривают: это руководство, которое адаптируют под собственную архитектуру аккаунтов, а не готовый продукт с гарантией на любую сеть.

Почему managed mode и публичные эндпоинты не подходят

Для приватных эндпоинтов Gateway-таргетов есть два режима. В managed mode AgentCore сам создаёт resource gateway в подсетях, которыми владеет, и это несовместимо с моделью, где подсети принадлежат сетевому аккаунту: вход в сеть оказывается вне контура, который инспектирует файрвол.

Второй очевидный обход, internet-facing балансировщики с AWS WAF на каждый инструмент, выводит трафик из контролируемого периметра. WAF даёт правила уровня приложения, но запрос идёт через интернет, а не через вашу inspection VPC.

Рассматривались и промежуточные варианты: resource gateway в каждой VPC инструментов или один resource gateway в центральной endpoints VPC. Первый размазывает точки входа по командам-владельцам инструментов, второй смешивает агентский трафик с другими endpoint-сценариями. Выбран выделенный VPC в сетевом аккаунте: у сетевой команды остаётся один контролируемый вход, который маршрутизируется через Transit Gateway и попадает под файрвол.

Как устроена архитектура: аккаунты, VPC Lattice и Transit Gateway

Роли распределяются так. Management-аккаунт в AWS Organizations задаёт границы. Member-аккаунты содержат приложения, инструменты и сам Gateway. Сетевой аккаунт владеет VPC, подсетями, подключениями Transit Gateway и inspection VPC с файрволом. VPC приложений и VPC инструментов получают адресное пространство от сетевой команды через AWS RAM.

Resource gateway и resource configuration: кто за что отвечает

Два объекта VPC Lattice путают чаще всего, поэтому разделим их сразу.

  • Resource gateway - точка входа VPC Lattice в VPC: эластичные сетевые интерфейсы (ENI) в выбранных вами подсетях. Бэкенды видят адреса этих ENI как источник каждого соединения.
  • Resource configuration - объект, который именует один бэкенд за resource gateway: внутренний балансировщик либо DNS-имя и порт VPC endpoint. Именно его расшаривают между аккаунтами через AWS RAM.

Разделение важно для правил доступа. Security groups и файрвол настраиваются на адреса ENI resource gateway, а не на адреса, из которых работает AgentCore. Иначе правила придётся переписывать при каждом изменении платформы.

Путь трафика в обе стороны

Запрос идёт по цепочке: Gateway → resource configuration → ENI resource gateway в сетевом аккаунте → Transit Gateway → inspection VPC, где стоит файрвол → VPC инструмента. Ответ возвращается тем же маршрутом, и это принципиально: инспекция работает только тогда, когда обратный поток тоже проходит через inspection VPC.

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

Шесть ключевых решений паттерна

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

Выделенный VPC для resource gateway в сетевом аккаунте

Resource gateway живёт в отдельном VPC, который принадлежит сетевой команде. Это даёт контроль над подсетями и их маршрутами через Transit Gateway, сохраняет модель владения и упрощает подключение к inspection VPC. Если положить resource gateway в VPC приложения, сетевая команда теряет контроль над точкой входа, а приложение получает сетевой объект, которым не должно управлять.

Альтернативы с resource gateway в каждой VPC инструментов или в центральной endpoints VPC рассматривались и не выбраны. Причина не в производительности, а в сопровождении: число точек входа не должно расти вместе с числом инструментов.

Одна resource configuration на балансировщик и шаринг через AWS RAM

Resource configuration именует ровно один бэкенд: внутренний балансировщик либо DNS-имя и порт VPC endpoint. Одна конфигурация на балансировщик, шаринг через AWS RAM в аккаунт Gateway. Такой подход уменьшает число объектов, которые нужно сопровождать, и упрощает аудит: видно, какие бэкенды опубликованы и в какие аккаунты.

Практическая деталь: шарится именно resource configuration, а не resource gateway. Аккаунт Gateway получает ссылку на именованный бэкенд, а сетевой вход остаётся в сетевом аккаунте.

Правила файрвола только для нужных потоков

Источник соединения для бэкенда - адреса ENI resource gateway. От этого факта и строятся правила: разрешения на конкретный поток от Gateway к инструменту и на обратный ответ, без широких диапазонов «на всякий случай».

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

Валидация токена на внутреннем ALB или приватном API

Сетевая изоляция не заменяет аутентификацию. Проверку токена выполняет внутренний ALB или сам приватный API: файрвол принимает решения по метаданным соединения, а не по телу запроса, поэтому авторизацию он выполнить не может.

Граница самостоятельной настройки проходит здесь. Конфигурацию валидатора, набор проверяемых claims и политику отказа нужно согласовать с владельцем API: именно он решает, какие токены считаются достаточными для вызова инструмента. Если этот шаг пропустить, любой процесс внутри разрешённого сетевого потока получит доступ к инструменту без проверки прав.

Gateway-таргеты в self-managed режиме

В self-managed режиме resource gateway создаётся вручную, а таргету назначается resource configuration. Для этого паттерна режим обязателен: resource gateway живёт в сетевом аккаунте, а не в подсетях, которыми управляет AgentCore.

Последовательность такая: создать resource gateway в выделенном VPC → создать resource configuration на нужный бэкенд → расшарить её через AWS RAM в аккаунт Gateway → назначить resource configuration таргету. Ошибка на любом шаге проявляется одинаково: таргет не резолвится, и агент получает ошибку вызова вместо ответа инструмента. Как устроены таргеты на несколько источников сразу, разобрано в материале про мультиаккаунтный агент на AgentCore Gateway и MCP.

Приватный доступ к Gateway и закрытие публичного эндпоинта

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

Что паттерн не решает: ограничения и слепые зоны

Три ограничения стоит проговорить до того, как паттерн попадёт в архитектурный документ. Все они следуют из устройства сетевого периметра, а не из ошибок настройки.

TLS и отсутствие инспекции полезной нагрузки

Файрвол работает с метаданными соединения: адреса, порты, направление потока. Содержимое запроса и ответа остаётся внутри TLS, и этот паттерн его не раскрывает. Если требуется инспекция тела запроса, это отдельная задача со своими компромиссами, и решать её этим паттерном «как есть» нельзя: обещать проверку содержимого на основании факта прохождения трафика через inspection VPC было бы неверно.

Практический вывод: правила файрвола ограничивают, кто и куда может ходить, а не что именно передаётся. Разграничение по смыслу запроса переносится на уровень API и политик.

Участки пути без файрвола

Гарантия держится на полной маршрутизации через Transit Gateway. Если какое-то плечо идёт напрямую или таблица маршрутов в одной из VPC не отправляет ответ через inspection VPC, часть потока обходит инспекцию.

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

Нет идентичности конечного пользователя на инструменте

Инструмент видит соединение от resource gateway, а не конкретного человека: бэкенд получает адрес ENI как источник. Для разграничения доступа по пользователям нужна отдельная передача контекста и проверка на стороне API или MCP-сервера. В рамках паттерна это не решается, и полагаться на сетевую проверку токена как на модель авторизации нельзя.

Смежная тема, которую полезно держать в голове при проектировании: изоляция агентского кода в отдельном аккаунте с DNS Firewall и политиками VPC-эндпоинтов закрывает другие классы риска, включая эксфильтрацию через DNS. Сетевой паттерн и прикладная авторизация дополняют друг друга, а не заменяют.

Альтернативы и как выбрать режим подключения

Таблица ниже помогает быстро отсеять варианты, которые не подходят под вашу модель владения подсетями и требования к инспекции.

СитуацияПодходящий вариантКомпромисс
Аккаунт Gateway может владеть подсетями, которые достигают инструментовManaged modeAgentCore создаёт resource gateway сам; подсети входа оказываются под управлением платформы, а не сетевой команды
Трафик между Gateway и инструментами не требует центральной инспекцииSelf-managed режим, как описано в документацииКонтроль остаётся у вас, но файрвол на пути потока не гарантирован
Инструменты доступны по публичным эндпоинтамСтандартный Gateway targetНе нужны ни Transit Gateway, ни VPC Lattice, но трафик выходит за контролируемый периметр
Нужен один вход и полная инспекция в обе стороны под контролем сетевой командыResource gateway в выделенном VPC сетевого аккаунта (этот паттерн)Больше компонентов: отдельный VPC, подключение Transit Gateway, шаринг через AWS RAM, правила файрвола
Команды хотят владеть входом в свои VPC инструментовResource gateway в каждой VPC инструментовЧисло точек входа растёт вместе с числом сервисов, единый контроль слабеет
Нужно сократить количество VPCResource gateway в центральной endpoints VPCАгентский трафик смешивается с другими endpoint-сценариями
Инструмент уже опубликован в интернетеInternet-facing балансировщик с AWS WAF на каждый инструментWAF даёт правила уровня приложения, но поток идёт через интернет вне вашей inspection VPC

Развилка сводится к двум вопросам. Кто владеет подсетями, из которых Gateway ходит к инструментам. Обязан ли этот поток проходить через центральный файрвол в обе стороны. Если ответы «сетевой аккаунт» и «да», паттерн с выделенным VPC подходит. В остальных случаях смотрите на строки выше.

Отдельная ось - управление самим агентским трафиком. Если задача шире сетевого периметра и включает контроль моделей, лимиты и журналирование вызовов, полезно посмотреть на архитектуру LLM gateway с governance и guardrails. Это другой слой, он не конфликтует с сетевым паттерном.

Как воспроизвести и проверить: лаборатория, CloudFormation и границы применимости

Паттерн построен и протестирован в регионе US East (N. Virginia) us-east-1, в лаборатории с тремя member-аккаунтами и management-аккаунтом в AWS Organizations. Шаблоны AWS CloudFormation, тестовые скрипты, тестовые доказательства и справочные материалы (план адресации, полные проверки валидации, устранение неполадок, квоты) лежат в сопутствующем репозитории, ссылка на него есть в публикации AWS.

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

Что проверить перед внедрением

  • Сетевой аккаунт действительно владеет подсетями и подключениями AWS Transit Gateway, а приложениям подсети приходят через AWS RAM.
  • Inspection VPC с файрволом существует и пропускает трафик в обе стороны, а не только на вход.
  • Подсети resource gateway маршрутизируются через Transit Gateway в обе стороны, включая обратный поток от инструмента.
  • Resource configuration расшарена через AWS RAM именно в аккаунт Gateway, а таргет создан в self-managed режиме.
  • Валидация токена настроена на внутреннем ALB или приватном API, а политика согласована с владельцем инструмента.
  • Публичный эндпоинт Gateway закрыт, и агент проверен на работу исключительно через приватный путь.

Квоты и типовые ошибки разобраны в репозитории. Общий контекст рисков агентских внедрений, включая разделение контуров и защиту от prompt injection, собран в материале про слабые места ИИ-агентов в продакшене.

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

Подписаться на канал