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
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.
- 19 de nov. de 2026Participações da Amazon e do Google na Anthropic são avaliadas em US$308 bilhões no IPO a US$83 por ação
- 19 de nov. de 2026Nvidia registra receita recorde de US$ 115,8 bilhões, mas vale menos em relação ao lucro do que em qualquer momento desde 2012
- 19 de nov. de 2026AWS: cadeia de 10 agentes com 95% de confiabilidade cada entrega apenas 59,9% de sucesso
- 19 de nov. de 2026AWS descreve 3 esquemas para o agente de IA acessar o Snowflake: com a identidade da pessoa ou com uma conta compartilhada
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.
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.
O essencial da IA — uma vez por semana
Sete histórias que realmente importaram, escolhidas a dedo. Sem ruído nem releases.
Pronto! Verifique seu e-mail para a confirmação.