Início 23/11Turma 3 ao vivo de Vibe Coding & Agentes de IA: 3 semanas, 9 aulas ao vivoTurma 3 (23/11) →
LançamentoAnálise · No radarAWS Machine Learning Blog→ original

AWS mostra como liberar agentes do Bedrock para APIs privadas por meio de um firewall central

Em grandes empresas, a equipe de rede é dona de todas as sub-redes, e o tráfego entre VPCs precisa passar por um firewall central. A AWS mostrou uma arquitetura em que o AgentCore Gateway acessa APIs fechadas e servidores MCP por meio de um resource gateway do VPC Lattice, hospedado na conta da equipe de rede. Requisições e respostas passam pelo Transit Gateway e são inspecionadas pelo firewall nos dois sentidos. A arquitetura foi testada em us-east-1, com três contas.

Processado por IA de AWS Machine Learning Blog; editado por Hamidun News
AWS mostra como liberar agentes do Bedrock para APIs privadas por meio de um firewall central
Fonte: AWS Machine Learning Blog. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalAWS Machine Learning Blog ↗
Editor-chefe
Dado-chave #1O firewall enxerga metadados e SNI, mas não o conteúdo das requisições: o TLS é de ponta a ponta
Dado-chave #2O próprio ALB valida o token do cliente com jwt-validation, e tokens de terceiros recebem 401
Dado-chave #3Sem a regra para as chaves JWKS, o ALB respondia HTTP 500 e o agente via uma falha do MCP

Cedo ou tarde, os agentes corporativos esbarram não no modelo, mas na rede. O agente precisa chamar uma API REST interna ou um servidor MCP, mas a equipe de rede é dona de todas as VPCs e sub-redes, e qualquer tráfego entre elas precisa passar por um firewall central, na ida e na volta. A AWS publicou uma análise detalhada de como conciliar essa exigência com o Amazon Bedrock AgentCore Gateway.

Qual é o problema

O AgentCore Gateway tem dois modos de acesso a destinos privados. No modo gerenciado, o próprio AgentCore cria um resource gateway do VPC Lattice na conta do Gateway. Isso funciona quando a conta pode ser dona das próprias sub-redes. No modo autogerenciado, conforme descrito na documentação, o resource gateway é colocado em sub-redes com acesso direto ao backend, e não há previsão de inspeção entre o Gateway e a ferramenta. Se as sub-redes pertencem à equipe de rede e o firewall é obrigatório, nenhuma das duas opções serve.

A solução da AWS é o modo autogerenciado com uma mudança: o resource gateway é criado e mantido pela conta de rede. Para ele, reserva-se uma VPC e sub-redes próprias, que não são cedidas a ninguém e não abrigam backends. As sub-redes são roteadas para o Transit Gateway, que encaminha o tráfego pela VPC de inspeção até o ALB interno ou o endpoint execute-api na conta da equipe responsável pela ferramenta. A resposta volta pelo mesmo caminho.

Como funciona

Para cada backend, cria-se uma resource configuration, que é compartilhada com a conta do AgentCore via AWS RAM. Ao criar o destino, o AgentCore a associa à sua própria service network no VPC Lattice, e a conexão então chega às interfaces de rede do resource gateway na sua VPC. Esse trecho é operado pela AWS; a partir dele, valem as suas rotas e o seu firewall. Por isso, não é preciso conectar a conta do AgentCore ao Transit Gateway.

O firewall precisa de duas regras. A primeira libera a porta 443 das sub-redes do resource gateway para a VPC das ferramentas. A segunda permite que o ALB consulte o provedor de identidade para obter as chaves de assinatura (JWKS), apenas a partir das sub-redes do ALB e apenas para o nome de host necessário. Nos testes, sem a segunda regra, o ALB retornava HTTP 500, e o agente recebia um erro na chamada do MCP. Para provar que as respostas realmente passam pelo firewall, os autores adicionaram uma regra que bloqueia o sentido contrário: as chamadas ficavam penduradas até o timeout, e os logs registravam pacotes descartados. Depois que a regra foi removida, tudo voltou a funcionar.

Quem valida os tokens é o lado da ferramenta. No ALB interno, cada regra com forward recebe a ação jwt-validation, e o client_id é vinculado ao app client do Gateway, para que tokens de outros clientes do mesmo user pool sejam rejeitados. Nos testes, requisições sem token, com token de outro provedor e com token de outro cliente receberam 401 antes de chegar ao backend.

Nesses casos, o agente via apenas "An internal error occurred", então a causa deve ser buscada nos access logs do ALB. Para APIs REST privadas do API Gateway, é preciso um authorizer em cada método (a chave de API não autentica quem faz a chamada) e uma política de endpoint que restrinja o acesso da API às contas aprovadas.

Limitações e conclusão

A arquitetura deixa claros os seus pontos fracos. Não há inspeção de conteúdo: o TLS vai do Gateway até o ALB, o firewall enxerga os metadados do fluxo e o SNI, e os corpos das requisições aparecem apenas nos logs do Gateway, do AWS WAF e do ALB. Alguns trechos do caminho não passam pelo firewall: o caminho do agente até o interface endpoint, o caminho do Gateway até o resource gateway e as requisições de token aos provedores. Por fim, com client credentials, a ferramenta vê apenas a identidade do próprio Gateway, e o usuário específico só pode ser reconstituído a partir dos claims do JWT de entrada nos logs do Gateway.

A conclusão prática para as equipes de plataforma e de segurança é definir os papéis com antecedência. A equipe de rede é dona do resource gateway, das rotas e das regras do firewall. A equipe da ferramenta responde pelo ALB, pelo certificado (o SAN precisa coincidir com o nome de host do destino) e pelo app client.

A equipe de agentes cria o Gateway e um destino para cada API ou servidor MCP. Uma nova ferramenta em um ALB já conectado não exige mudanças na rede: basta atualizar a especificação OpenAPI ou sincronizar o servidor MCP. Duas configurações do resource gateway não podem ser alteradas depois da criação (Ipv4AddressesPerEni e ResourceConfigDnsResolution), então escolha-as desde o início.

Os templates do CloudFormation e os scripts de teste estão no repositório do post, mas a arquitetura é melhor encarada como uma referência, a ser adaptada à estrutura de contas de cada empresa.

História

Perguntas frequentes sobre a notícia

O que se sabe sobre Qual é o problema?

O AgentCore Gateway tem dois modos de acesso a destinos privados. No modo gerenciado, o próprio AgentCore cria um resource gateway do VPC Lattice na conta do Gateway. Isso funciona quando a conta pode ser dona das próprias sub-redes. No modo autogerenciado, conforme descrito na documentação, o resource gateway é colocado em sub-redes com acesso direto ao backend, e não há previsão de inspeção entre o Gateway e a ferramenta.

Como funciona?

Para cada backend, cria-se uma resource configuration, que é compartilhada com a conta do AgentCore via AWS RAM. Ao criar o destino, o AgentCore a associa à sua própria service network no VPC Lattice, e a conexão então chega às interfaces de rede do resource gateway na sua VPC. Esse trecho é operado pela AWS; a partir dele, valem as suas rotas e o seu firewall. Por isso, não é preciso conectar a conta do AgentCore ao Transit Gateway. O firewall precisa de duas regras.

O que se sabe sobre Limitações e conclusão?

A arquitetura deixa claros os seus pontos fracos. Não há inspeção de conteúdo: o TLS vai do Gateway até o ALB, o firewall enxerga os metadados do fluxo e o SNI, e os corpos das requisições aparecem apenas nos logs do Gateway, do AWS WAF e do ALB. Alguns trechos do caminho não passam pelo firewall: o caminho do agente até o interface endpoint, o caminho do Gateway até o resource gateway e as requisições de token aos provedores.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
O que você acha?
Carregando comentários…