Интенсив 21–22.11 · БесплатноБесплатный 2-дневный интенсив по вайбкодингу 21–22 ноября в 16:00 МСК (Сб–Вс) · Живой Поток 3 стартует 23.11Записаться бесплатно →Поток 3 (23.11)
РелизРазбор · На радарAWS Machine Learning Blog→ оригинал

Агенты AWS AgentCore теперь ходят к закрытому Keycloak с корпоративным CA

Агенты Amazon Bedrock AgentCore теперь получают токены у корпоративных провайдеров входа вроде Keycloak и PingFederate, спрятанных в частной сети. Публичный PEM-файл с сертификатом внутреннего удостоверяющего центра (CA) кладёте в Secrets Manager или S3 и указываете в credential provider. Через VPC Lattice AgentCore Identity проверяет им сертификат IdP, код агента не меняется. Так агентов можно подключить к уже работающей авторизации.

AI-обработка оригинала AWS Machine Learning Blog; редакция Hamidun News
Агенты AWS AgentCore теперь ходят к закрытому Keycloak с корпоративным CA
Источник: AWS Machine Learning Blog. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникAWS Machine Learning Blog ↗
Главный редактор
Ключевой факт #1Файл CA ≤ 16 КБ, только корневые или промежуточные сертификаты
Ключевой факт #2Работает только с частными IdP через VPC Lattice
Ключевой факт #3Метрика CloudWatch EarliestCertificateDaysToExpiry следит за сроком CA

Многие компании держат собственный провайдер входа (IdP) — Keycloak или PingFederate — в закрытой сети, а его HTTPS-сертификат выпускает внутренний удостоверяющий центр (CA). Публичные облака такой центр по умолчанию не знают. Пока агентов было два-три, это мало кого волновало. Когда они начинают ходить во внутренние API, вопрос «как агент получит токен у нашего IdP» становится первым в списке. AWS закрыла его в Amazon Bedrock AgentCore Identity: сервис теперь поддерживает частные CA.

Как это устроено

Представьте агента на AgentCore Runtime, которому нужен доступ к внутренней вики, защищённой Keycloak. Keycloak стоит в вашей VPC за внутренним Application Load Balancer, а на балансировщике висит сертификат из AWS Private CA. Агент просит токен у AgentCore Identity, а тот обращается к IdP через Amazon VPC Lattice. Там он сверяет сертификат балансировщика с вашим CA и забирает токен по OAuth 2.0.

Сам CA-сертификат — это публичный файл в формате PEM без закрытого ключа. Его кладут в AWS Secrets Manager или Amazon S3 и указывают в настройках credential provider (поле certificateConfigurations). Сервис проверяет им адреса discovery, JWKS и токенов. Доверие выдаётся центру, а не конкретному серверному сертификату, поэтому при его продлении провайдер обновлять не нужно. Агенты с машинными, on-behalf-of и пользовательскими сценариями работают без изменений кода.

В примере AWS сертификат для IdP выпускают через ACM, указывая имя хоста из discovery-документа в SAN, затем экспортируют CA командой aws acm-pca get-certificate-authority-certificate. Перед загрузкой файл стоит проверить через openssl: флаг CA:TRUE, срок действия и цепочку до IdP (ожидается Verify return code: 0). Новый провайдер сначала получает статус CREATING, а затем READY. Если видите CREATE_FAILED, причина лежит в failureReason. Типичная ошибка — загрузить серверный сертификат вместо CA.

Ограничения, о которых лучше знать заранее

  • Работает только с частными IdP: нужен privateEndpoint, иначе запрос отклонят.
  • Файл не больше 16 КБ, только корневые или промежуточные сертификаты с действующим сроком.
  • На один провайдер приходится один источник сертификата. Несколько CA кладут в один PEM-файл.
  • Секрет и провайдер должны быть в одном регионе, а секрет ещё и в одном аккаунте. Объект S3 может лежать в другом аккаунте при указанном bucketOwnerAccountId.
  • Функция зависит от VPC Lattice и доступна только в регионах, где AgentCore Identity поддерживает частные IdP.
  • Списки отзыва (CRL) и OCSP не проверяются. Если ключ серверного сертификата утёк, доверие сохранится до истечения срока или пока вы не уберёте CA из файла.

Ротация и защита

Сервис читает сертификат только при создании или обновлении провайдера. Поменяли файл в хранилище — вызовите UpdateOauth2CredentialProvider и не забудьте передать certificateConfigurations, иначе провайдер перестанет доверять вашему CA. Для плавной смены центра AWS советует положить в один PEM-файл старый и новый CA, обновить провайдер, перевыпустить сертификат IdP у нового центра, а затем оставить только новый CA и обновить провайдер ещё раз.

Срок действия CA стоит мониторить. AgentCore публикует в CloudWatch метрику EarliestCertificateDaysToExpiry с измерениями ProviderName, ProviderArn и TokenVault. При создании алярма указывайте все три. Когда срок истечёт, запросы токенов перестанут работать.

Защищать нужно не секретность сертификата, а целостность хранилища. Если злоумышленник подменит файл или добавит чужой CA, то при следующем обновлении сможет выдать себя за ваш IdP. Поэтому права на запись (s3:PutObject, secretsmanager:PutSecretValue) дают только команде IdP, а читать файл должны роли, которые создают и обновляют провайдеры. В статье приведены примеры bucket policy и resource policy для секрета с явным запретом записи для всех, кроме роли IdP-администратора.

Что делать

Если ваши агенты ходят к внутреннему IdP, этот вариант избавляет от публикации провайдера в интернете и от обходных решений с отключением проверки TLS. Заранее настройте VPC Lattice, ограничьте запись в хранилище с CA и заведите алярм на срок действия.

Сюжет

Вопросы и ответы по материалу

Что известно по теме: как это устроено?

Представьте агента на AgentCore Runtime, которому нужен доступ к внутренней вики, защищённой Keycloak. Keycloak стоит в вашей VPC за внутренним Application Load Balancer, а на балансировщике висит сертификат из AWS Private CA. Агент просит токен у AgentCore Identity, а тот обращается к IdP через Amazon VPC Lattice. Там он сверяет сертификат балансировщика с вашим CA и забирает токен по OAuth 2.0. Сам CA-сертификат — это публичный файл в формате PEM без закрытого ключа.

Что известно по теме: ограничения, о которых лучше знать заранее?

Работает только с частными IdP: нужен privateEndpoint, иначе запрос отклонят. Файл не больше 16 КБ, только корневые или промежуточные сертификаты с действующим сроком. На один провайдер приходится один источник сертификата. Несколько CA кладут в один PEM-файл. Секрет и провайдер должны быть в одном регионе, а секрет ещё и в одном аккаунте. Объект S3 может лежать в другом аккаунте при указанном bucketOwnerAccountId.

Что известно по теме: ротация и защита?

Сервис читает сертификат только при создании или обновлении провайдера. Поменяли файл в хранилище — вызовите UpdateOauth2CredentialProvider и не забудьте передать certificateConfigurations, иначе провайдер перестанет доверять вашему CA. Для плавной смены центра AWS советует положить в один PEM-файл старый и новый CA, обновить провайдер, перевыпустить сертификат IdP у нового центра, а затем оставить только новый CA и обновить провайдер ещё раз. Срок действия CA стоит мониторить.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ Закрытый клуб практиков · Vibe Club

Внедряйте ИИ быстрее рынка вместе с инженерами и фаундерами

Внутри Vibe Club (hamidun.com/club): еженедельные живые мастермайнды и разборы архитектуры с Жемалом Хамидуном, закрытый Tech Radar, LMS и обновляемая база из 370+ боевых скиллов.

Вступить в Vibe Club →Тест-драйв Академии (72ч)
Что вы думаете?
Загружаем комментарии…