Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoAnálise · No radarAWS Machine Learning Blog→ original

Agentes do AWS AgentCore agora acessam Keycloak em rede fechada com CA corporativa

Os agentes do Amazon Bedrock AgentCore agora conseguem obter tokens de provedores de login corporativos, como Keycloak e PingFederate, que ficam escondidos em uma rede privada. Basta guardar o arquivo PEM público com o certificado da autoridade certificadora (CA) interna no Secrets Manager ou no S3 e indicá-lo no credential provider. Por meio do VPC Lattice, o AgentCore Identity usa esse arquivo para validar o certificado do IdP, e o código do agente não muda. Assim, é possível conectar agentes a uma autorização que já está em operação.

Processado por IA de AWS Machine Learning Blog; editado por Hamidun News
Agentes do AWS AgentCore agora acessam Keycloak em rede fechada com CA corporativa
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 #1Arquivo da CA ≤ 16 KB, apenas certificados raiz ou intermediários
Dado-chave #2Funciona somente com IdPs privados via VPC Lattice
Dado-chave #3A métrica EarliestCertificateDaysToExpiry, do CloudWatch, acompanha o prazo de validade da CA

Muitas empresas mantêm o próprio provedor de login (IdP), como Keycloak ou PingFederate, em uma rede fechada, com o certificado HTTPS emitido por uma autoridade certificadora (CA) interna. As nuvens públicas não conhecem essa autoridade por padrão. Enquanto eram dois ou três agentes, quase ninguém se preocupava com isso. Quando eles começam a acessar APIs internas, a pergunta "como o agente vai obter um token no nosso IdP" passa a ser a primeira da lista. A AWS resolveu essa questão no Amazon Bedrock AgentCore Identity: o serviço agora oferece suporte a CAs privadas.

Como funciona

Imagine um agente no AgentCore Runtime que precisa acessar uma wiki interna protegida pelo Keycloak. O Keycloak fica na sua VPC, atrás de um Application Load Balancer interno, e o balanceador usa um certificado do AWS Private CA. O agente pede um token ao AgentCore Identity, que se comunica com o IdP por meio do Amazon VPC Lattice. Nesse caminho, ele compara o certificado do balanceador com a sua CA e obtém o token via OAuth 2.0.

O certificado da CA é um arquivo público em formato PEM, sem a chave privada. Ele é guardado no AWS Secrets Manager ou no Amazon S3 e indicado nas configurações do credential provider (campo certificateConfigurations). O serviço usa esse arquivo para validar os endereços de discovery, JWKS e de tokens. A confiança é concedida à autoridade certificadora, e não a um certificado de servidor específico, por isso não é preciso atualizar o provider quando esse certificado é renovado. Agentes em cenários machine-to-machine, on-behalf-of e de usuário funcionam sem mudanças no código.

No exemplo da AWS, o certificado do IdP é emitido pelo ACM, com o nome do host do documento de discovery no SAN, e depois a CA é exportada com o comando aws acm-pca get-certificate-authority-certificate. Antes de enviar o arquivo, vale verificá-lo com o openssl: a flag CA:TRUE, o prazo de validade e a cadeia até o IdP (o esperado é Verify return code: 0). O novo provider recebe primeiro o status CREATING e depois READY. Se aparecer CREATE_FAILED, o motivo está em failureReason. O erro mais comum é enviar o certificado do servidor no lugar do certificado da CA.

Limitações que convém conhecer de antemão

  • Funciona somente com IdPs privados: é necessário informar privateEndpoint, caso contrário a requisição é rejeitada.
  • O arquivo pode ter no máximo 16 KB e conter apenas certificados raiz ou intermediários dentro do prazo de validade.
  • Cada provider tem uma única fonte de certificado. Várias CAs devem ser colocadas no mesmo arquivo PEM.
  • O segredo e o provider precisam estar na mesma região, e o segredo também na mesma conta. O objeto do S3 pode ficar em outra conta, desde que bucketOwnerAccountId esteja informado.
  • O recurso depende do VPC Lattice e só está disponível nas regiões em que o AgentCore Identity oferece suporte a IdPs privados.
  • Listas de revogação (CRL) e OCSP não são verificadas. Se a chave do certificado do servidor vazar, a confiança continua até o certificado expirar ou até você remover a CA do arquivo.

Rotação e proteção

O serviço lê o certificado somente na criação ou na atualização do provider. Se você alterou o arquivo no armazenamento, chame UpdateOauth2CredentialProvider e não se esqueça de passar certificateConfigurations, senão o provider deixa de confiar na sua CA. Para trocar de autoridade sem interrupções, a AWS recomenda colocar a CA antiga e a nova no mesmo arquivo PEM, atualizar o provider, reemitir o certificado do IdP na nova autoridade e, por fim, deixar apenas a nova CA e atualizar o provider mais uma vez.

O prazo de validade da CA deve ser monitorado. O AgentCore publica no CloudWatch a métrica EarliestCertificateDaysToExpiry, com as dimensões ProviderName, ProviderArn e TokenVault. Ao criar o alarme, informe as três. Quando o prazo expirar, as requisições de token deixam de funcionar.

O que precisa de proteção não é o sigilo do certificado, e sim a integridade do local onde ele fica armazenado. Se um invasor trocar o arquivo ou adicionar uma CA estranha, na próxima atualização ele poderá se passar pelo seu IdP. Por isso, as permissões de escrita (s3:PutObject, secretsmanager:PutSecretValue) devem ficar apenas com a equipe do IdP, e a leitura do arquivo, com as roles que criam e atualizam os providers. O artigo traz exemplos de bucket policy e de resource policy para o segredo, com proibição explícita de escrita para todos, exceto a role do administrador do IdP.

O que fazer

Se os seus agentes acessam um IdP interno, essa opção dispensa expor o provedor na internet e evita gambiarras que desativam a verificação de TLS. Configure o VPC Lattice com antecedência, restrinja a escrita no armazenamento que guarda a CA e crie um alarme para o prazo de validade.

História

Perguntas frequentes sobre a notícia

Como funciona?

Imagine um agente no AgentCore Runtime que precisa acessar uma wiki interna protegida pelo Keycloak. O Keycloak fica na sua VPC, atrás de um Application Load Balancer interno, e o balanceador usa um certificado do AWS Private CA. O agente pede um token ao AgentCore Identity, que se comunica com o IdP por meio do Amazon VPC Lattice. Nesse caminho, ele compara o certificado do balanceador com a sua CA e obtém o token via OAuth 2.0. O certificado da CA é um arquivo público em formato PEM, sem a chave privada.

O que se sabe sobre Limitações que convém conhecer de antemão?

Funciona somente com IdPs privados: é necessário informar privateEndpoint, caso contrário a requisição é rejeitada. O arquivo pode ter no máximo 16 KB e conter apenas certificados raiz ou intermediários dentro do prazo de validade. Cada provider tem uma única fonte de certificado. Várias CAs devem ser colocadas no mesmo arquivo PEM. O segredo e o provider precisam estar na mesma região, e o segredo também na mesma conta. O objeto do S3 pode ficar em outra conta, desde que bucketOwnerAccountId esteja informado.

O que se sabe sobre Rotação e proteção?

O serviço lê o certificado somente na criação ou na atualização do provider. Se você alterou o arquivo no armazenamento, chame UpdateOauth2CredentialProvider e não se esqueça de passar certificateConfigurations, senão o provider deixa de confiar na sua CA. Para trocar de autoridade sem interrupções, a AWS recomenda colocar a CA antiga e a nova no mesmo arquivo PEM, atualizar o provider, reemitir o certificado do IdP na nova autoridade e, por fim, deixar apenas a nova CA e atualizar o provider mais uma vez.

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.
✦ Private AI Builders Community · Vibe Club

Ship AI Faster with Founders, Engineers & Weekly Architecture Reviews

Inside Vibe Club (hamidun.com/club) — weekly live masterminds with Zhemal Khamidun, Tech Radar, full LMS access, and 370+ production Claude Code skills.

Join Vibe Club →Explore Hamidun Academy
O que você acha?
Carregando comentários…