Articleaws.amazon.com·2026년 11월 18일·0

Private certificate authority support in Amazon Bedrock AgentCore Identity

Quick Summary

Amazon Bedrock AgentCore Identity가 조직의 기존 사설 인증기관(CA)을 신뢰하도록 구성할 수 있게 되어, 에이전트가 사설 네트워크의 자격 증명 공급자(IdP)에 연결해 OAuth 2.0 액세스 토큰을 받을 수 있다.

Private certificate authority support in Amazon Bedrock AgentCore Identity 관련 대표 이미지

🖼️ 인포그래픽

Private certificate authority support in Amazon Bedrock AgentCore Identity 내용을 설명하는 본문 이미지

🖼️ 4컷 인포그래픽

Private certificate authority support in Amazon Bedrock AgentCore Identity의 핵심 내용을 4단계로 요약한 인포그래픽
Private certificate authority support in Amazon Bedrock AgentCore Identity 핵심 내용을 4단계로 압축한 4컷 인포그래픽

💡 한 줄 요약

Amazon Bedrock AgentCore Identity가 조직의 기존 사설 인증기관(CA)을 신뢰하도록 구성할 수 있게 되어, 에이전트가 사설 네트워크의 자격 증명 공급자(IdP)에 연결해 OAuth 2.0 액세스 토큰을 받을 수 있다.

📌 핵심 요약

  • AgentCore Identity는 Keycloak이나 PingFederate 같은 자체 호스팅 IdP의 디스커버리, JSON 웹 키 세트(JWKS), 토큰 엔드포인트가 제시하는 TLS 서버 인증서를 조직의 사설 CA 인증서로 검증한다.
  • 사설 CA를 사용하려면 privateEndpoint와 Amazon VPC Lattice가 필요하며, AgentCore Identity가 사설 IdP를 지원하는 AWS 리전에서만 이용할 수 있다. 머신 간 인증, 사용자 대신 수행하는 인증, 사용자 위임 인증을 쓰는 에이전트는 코드 변경 없이 이 기능을 이용할 수 있다.
  • 자격 증명 공급자 하나가 참조할 수 있는 인증서 원본은 AWS Secrets Manager의 시크릿 하나 또는 Amazon S3 객체 하나다. 크기가 16KB 이하인 PEM 파일에 유효기간 내의 루트 또는 중간 CA 공개 인증서를 여러 개 담을 수 있으며, CA 개인 키는 포함하지 않는다.
  • 인증서 원본은 자격 증명 공급자와 같은 AWS 리전에 있어야 한다. AWS Secrets Manager는 같은 계정의 문자열 시크릿만 허용하고, Amazon S3는 버킷 소유자 계정 ID와 접근을 허용하는 버킷 정책이 있으면 다른 계정의 객체도 지원한다.
  • AWS Private CA와 Keycloak을 사용한 예시에서는 서버 인증서에 디스커버리 문서의 각 호스트 이름을 포함한다. 같은 CA 아래에서 서버 인증서를 갱신할 때는 자격 증명 공급자를 수정할 필요가 없으며, AWS는 저장한 CA 인증서의 쓰기 권한을 IdP 운영팀으로 제한하도록 권고한다.

🧩 주요 포인트

  1. Amazon VPC Lattice가 사설 연결 경로를 제공하고, AgentCore Identity는 그 경로에서 CA 인증서와 호스트 이름을 확인해 연결 상대를 검증한다.
  2. 신뢰 기준은 개별 서버 인증서가 아니라 발급 CA이므로, 같은 CA에서 발급한 서버 인증서의 갱신과 자격 증명 공급자 설정 변경을 분리할 수 있다.
  3. 인증서 원본의 계정 제약과 읽기·쓰기 권한이 다르므로, 중앙 계정에서 IdP를 운영할 때는 Amazon S3의 교차 계정 조건과 IdP 운영팀의 변경 권한을 함께 고려해야 한다.

🧠 상세 정리

1. 기존 사설 CA를 이용한 IdP 검증

Keycloak이나 PingFederate를 사설 네트워크에서 직접 운영하는 조직은 보통 자체 인증기관이 발급한 TLS 서버 인증서를 사용한다. AWS가 발표한 지원 기능을 이용하면 조직이 이미 신뢰하는 CA의 공개 인증서를 Amazon Bedrock AgentCore Identity의 자격 증명 공급자에서 참조할 수 있다. AgentCore Identity는 이 인증서를 기준으로 IdP 설정을 조회하는 디스커버리 엔드포인트, JSON 웹 키 세트(JWKS) 엔드포인트, 토큰 엔드포인트의 서버 인증서를 검증한다. 신뢰 대상으로는 기업 내부 CA, 외부 업체의 사설 CA, 자체 서명 루트 CA를 사용할 수 있다. 본문에서 선택한 AWS Private CA와 Keycloak은 이 구성을 설명하기 위한 예시다.

2. 내부 위키에 접근하는 에이전트의 토큰 흐름

예시의 에이전트는 AgentCore Runtime에서 실행되며, Keycloak으로 보호된 내부 위키 API를 호출하기 위해 OAuth 2.0 액세스 토큰이 필요하다. IdP 연결 정보와 OAuth 클라이언트 자격 증명은 AgentCore Identity의 자격 증명 공급자가 보관한다. 에이전트가 토큰을 요청하면 AgentCore Identity는 Amazon VPC Lattice와 리소스 게이트웨이를 거쳐 VPC 내부의 로드 밸런서에 연결한다. 로드 밸런서가 제시한 서버 인증서를 등록된 CA로 검증한 뒤, Keycloak이 발급한 토큰을 에이전트에 돌려준다. 이처럼 인증서 검증을 AgentCore Identity가 담당하므로 머신 간 인증, 사용자 대신 수행하는 인증, 사용자 위임 인증을 쓰는 기존 에이전트는 코드를 바꿀 필요가 없다.

3. 사설 연결의 적용 조건과 읽기 권한

사설 CA 기능은 AgentCore Identity가 사설 IdP를 지원하는 AWS 리전에서 사용할 수 있으며, 자격 증명 공급자나 권한 부여자에 privateEndpoint가 있어야 한다. 예시의 전제는 VPC 안에서 동작하는 OpenID Connect(OIDC) 호환 IdP에 에이전트용 OAuth 클라이언트가 등록돼 있고, 서브넷과 보안 그룹, 프라이빗 호스팅 영역을 통해 IdP 호스트에 접근할 수 있다는 것이다. 인증서를 읽을 때 AgentCore Identity는 CreateOauth2CredentialProvider를 호출한 주체의 자격 증명을 사용한다. 따라서 그 주체에는 저장 위치에 따라 secretsmanager:GetSecretValue 또는 s3:GetObject 권한이 필요하다. 고객 관리형 AWS KMS 키로 시크릿이나 객체를 암호화한 경우에는 해당 키의 kms:Decrypt 권한도 필요하다.

4. 서버 인증서 발급과 호스트 이름의 일치

AWS Private CA로 루트 CA를 만드는 예시에서는 범용 모드를 선택한다. 단기 인증서 모드에서 발급할 수 있는 인증서의 유효기간은 7일 이하이기 때문이다. CA를 생성할 때 AWS Certificate Manager(ACM)에 갱신 권한을 부여하면 ACM이 IdP 서버 인증서 만료 전에 인증서를 갱신할 수 있다. AgentCore Identity는 연결할 호스트 이름도 확인하므로, 디스커버리 문서에 등장하는 각 호스트 이름이 서버 인증서의 주체 대체 이름(SAN)에 포함돼야 한다. 일반적인 Keycloak 배포에서는 디스커버리, JWKS, 토큰 엔드포인트가 호스트 이름 하나를 공유하며, 예시에서는 Keycloak 앞에 있는 내부 Application Load Balancer의 HTTPS 리스너에 서버 인증서를 연결한다. IdP가 이미 기업 CA에서 발급한 서버 인증서를 제시한다면 새로 발급할 필요 없이 기존 CA 인증서를 저장하는 단계부터 적용할 수 있다.

5. PEM 파일에 담을 인증서와 검증 기준

AgentCore Identity에 제공하는 PEM 파일에는 유효기간 내의 루트 또는 중간 CA 공개 인증서만 담으며, 파일 전체 크기는 16KB 이하여야 한다. 자격 증명 공급자마다 인증서 원본을 하나만 참조할 수 있으므로 여러 CA를 신뢰해야 한다면 해당 인증서들을 같은 파일에 넣는다. 본문은 저장 전에 인증서의 CA 표시와 만료일, 파일 크기를 확인하고, IdP에 연결할 수 있는 호스트에서 서버 인증서의 신뢰 체인이 해당 CA로 이어지는지도 검증하는 예를 제시한다. 파일이 유효한 CA 인증서를 담고 있는지와 그 CA로 실제 서버 인증서를 검증할 수 있는지는 각각 확인할 사항이다. 신뢰 체인이 유지되면 서버 인증서를 갱신할 때마다 저장된 CA 인증서나 자격 증명 공급자 설정을 바꿀 필요가 없다.

6. 인증서 저장 위치와 변경 권한

AWS Secrets Manager와 Amazon S3 중 어느 쪽을 사용하든 인증서 원본이 있는 AWS 리전은 자격 증명 공급자의 리전과 같아야 한다. Secrets Manager를 선택하면 같은 AWS 계정에 PEM 내용을 문자열 시크릿으로 저장한다. Amazon S3에서는 버킷 정책이 접근을 허용하고 버킷 소유자 계정 ID를 지정하면 다른 계정의 객체도 참조할 수 있어, 중앙 계정에서 IdP를 운영하는 조직에 적합하다. 소유자 계정 ID를 생략하면 AgentCore Identity는 버킷이 자격 증명 공급자와 같은 계정에 있다고 간주한다. 저장하는 인증서에는 CA 개인 키가 없지만, 그 내용을 바꾸면 어떤 CA를 신뢰할지가 달라지므로 AWS는 시크릿이나 객체에 대한 쓰기 권한을 IdP 운영팀에만 부여하도록 권고한다.

7. 자격 증명 공급자 구성과 CA 교체 설명의 범위

AgentCore 콘솔에서는 사용자 지정 OAuth 공급자에 IdP 디스커버리 URL과 클라이언트 정보를 입력하며, OAuth 클라이언트를 VPC에 연결한 뒤에 사설 CA 설정이 표시된다. 관리형 연결을 선택하면 AgentCore Identity가 VPC Lattice 리소스를 생성하고 관리하며, 자체 관리형 연결에서는 운영자가 관리하는 리소스 구성을 선택한다. 콘솔의 ‘Root certificate authority’ 항목은 이름과 달리 루트 CA와 중간 CA 인증서를 모두 허용한다. AWS CLI에서도 certificateConfigurations에 Secrets Manager 시크릿이나 S3 객체를 지정해 같은 자격 증명 공급자를 구성할 수 있다. 글의 도입부는 중단 시간을 최소화하는 CA 교체도 다룬다고 예고하지만, 제공된 본문은 자격 증명 공급자 구성 설명 도중에 끝나므로 구체적인 CA 교체 절차는 확인할 수 없다.

🧾 핵심 주장 / 시사점

  • 사설 IdP 연결에는 네트워크 도달성과 서버 신원 검증이 모두 필요하다. VPC Lattice로 IdP에 접근할 수 있어도 인증서의 호스트 이름과 신뢰 체인이 맞아야 TLS 검증을 통과한다.
  • 같은 CA 아래의 서버 인증서 갱신은 자격 증명 공급자 설정에 영향을 주지 않는다. CA 자체의 교체는 신뢰 기준이 달라지는 별도의 변경이다.
  • CA 인증서는 공개 정보지만 저장된 원본은 신뢰 대상을 결정한다. 따라서 인증서를 읽어 공급자를 생성하는 주체와 원본을 수정할 수 있는 IdP 운영팀은 서로 다른 권한을 갖는다.

✅ 액션 아이템

  • 사설 IdP 배포 리전의 지원 여부와 privateEndpoint 및 Amazon VPC Lattice 구성을 확인한다.
  • 16KB 이하인 PEM 파일에 유효한 루트 또는 중간 CA 공개 인증서만 포함됐는지, 서버 인증서가 디스커버리 문서의 각 호스트 이름과 일치하는지 확인한다.
  • AWS Secrets Manager와 Amazon S3의 계정 조건에 맞춰 저장 위치를 정하고, 인증서 원본의 쓰기 권한을 IdP 운영팀으로 제한한다.

❓ 열린 질문

  • 사용할 AWS 리전은 AgentCore Identity의 사설 IdP 연결을 지원하며, 해당 자격 증명 공급자에 privateEndpoint가 구성돼 있는가?
  • Keycloak의 디스커버리, JWKS, 토큰 엔드포인트가 사용하는 호스트 이름이 모두 서버 인증서에 포함돼 있는가?
  • 다른 계정의 Amazon S3 객체를 인증서 원본으로 사용할 경우 버킷 소유자 계정 ID와 접근을 허용하는 버킷 정책이 갖춰져 있는가?

관련 문서

공통 태그와 주제 흐름을 기준으로 같이 보면 좋은 문서를 이어서 제안합니다.