Amazon Bedrock AgentCore Identity를 활용한 Amazon ECS 기반 보안 AI 에이전트 구축

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

프로덕션 환경의 AI 에이전트가 외부 서비스에 접근할 때 보안을 강화하기 위해 Amazon Bedrock AgentCore Identity를 활용하는 아키텍처를 제안합니다. Amazon ECS 상에서 실행되는 에이전트 워크로드와 세션 바인딩 서비스를 분리하여 독립적인 확장성과 보안성을 확보합니다. OAuth 2.0의 Authorization Code Grant 흐름을 구현하여 사용자 동의 기반의 최소 권한 액세스를 보장하며, ALB와 OIDC를 연계한 신원 검증 프로세스를 포함합니다. 이 방식은 CSRF 및 브라우저 스와핑 공격을 방지하고 에이전트가 사용자 대신 안전하게 행동할 수 있는 신뢰 체인을 구축합니다.

배경

AWS ECS 및 ALB에 대한 기본 지식, OAuth 2.0 및 OIDC 프로토콜의 작동 원리 이해, Python 및 FastAPI 프레임워크 사용 경험

대상 독자

AWS 환경에서 보안이 중요한 기업용 AI 에이전트를 구축하려는 클라우드 아키텍트 및 백엔드 개발자

의미 / 영향

이 아키텍처는 AI 에이전트가 단순한 챗봇을 넘어 실제 사용자의 권한을 가지고 외부 업무 시스템(Jira, Salesforce 등)과 상호작용할 때 필수적인 보안 표준을 제시합니다. 특히 엔터프라이즈 환경에서 요구되는 엄격한 신원 확인과 감사 추적 기능을 클라우드 네이티브 서비스로 구현할 수 있음을 보여줍니다.

섹션별 상세

AI 에이전트의 외부 서비스 접근 시 보안 위협을 방지하기 위해 AgentCore Identity를 독립적인 신원 관리 서비스로 활용합니다. 에이전트가 ECS, EKS, Lambda 등 다양한 환경에서 실행되더라도 외부 서비스 자격 증명을 안전하게 관리하고 토큰 저장소 역할을 수행합니다. 이를 통해 개발자는 복잡한 OAuth 흐름 구현 대신 에이전트 로직에 집중할 수 있으며, 중앙 집중식 보안 제어가 가능해집니다.

Amazon ECS 기반의 AgentCore Identity 보안 아키텍처 다이어그램 — Diagram사용자 요청이 ALB를 통해 인증되고 ECS 내의 에이전트 워크로드와 세션 바인딩 서비스로 전달되는 흐름을 보여줍니다. 외부 IDP(Entra ID) 및 서비스(GitHub)와의 연동 구조와 AgentCore Identity가 토큰을 관리하는 위치를 시각화합니다.

사용자 인증을 위해 Amazon ALB의 기본 OIDC 기능을 활용하여 인바운드 트래픽을 검증합니다. ALB는 Microsoft Entra ID와 같은 IDP와 통신하여 사용자를 인증하고, 서명된 JWT를 x-amzn-oidc-data 헤더에 담아 ECS 워크로드로 전달합니다. 에이전트는 이 헤더에서 sub 클레임을 추출하여 사용자를 고유하게 식별하고, 이를 AgentCore Identity의 워크로드 토큰 발급에 사용합니다.

세션 바인딩 기법을 도입하여 OAuth 인증 과정에서 발생할 수 있는 보안 취약점을 차단합니다. AgentCore Identity는 인증 흐름 상태를 추적하는 sessionURI를 생성하고, 사용자 브라우저가 최종적으로 고객 관리 서비스로 리다이렉트될 때 이를 검증합니다. 워크로드에서의 사용자 ID와 세션 바인딩 서비스에서의 사용자 ID가 일치하는지 암호학적으로 확인함으로써 공격자의 토큰 주입을 원천 봉쇄합니다.

python

agentcore = boto3.client("bedrock-agentcore", region_name=settings.identity_aws_region)
response = agentcore.get_workload_access_token_for_user_id(
    workloadName=settings.workload_identity_name,
    userId=user_id
)
workload_access_token = response["workloadAccessToken"]

사용자 ID를 기반으로 AgentCore Identity에서 워크로드 액세스 토큰을 획득하는 코드

AgentCore Identity를 활용한 OAuth 2.0 권한 부여 코드 승인 시퀀스 다이어그램 — Diagram사용자, 에이전트 워크로드, AgentCore Identity, 외부 권한 부여 서버 간의 17단계 상호작용 과정을 상세히 설명합니다. 특히 토큰이 없는 경우 사용자에게 인증 URL을 전달하고 세션을 바인딩하는 절차를 명확히 보여줍니다.

최소 권한 원칙을 준수하기 위해 각 에이전트 도구별로 필요한 OAuth 스코프를 개별적으로 선언합니다. 에이전트가 GitHub API를 호출할 때 전체 권한 대신 read:user와 같이 특정 도구에 필요한 범위만 요청하여 보안 노출을 최소화합니다. AgentCore Identity는 유효한 토큰이 없을 경우에만 사용자에게 권한 승인 URL을 반환하며, 획득된 토큰은 안전한 토큰 저장소에 보관되어 재사용됩니다.

python

@requires_access_token(
    provider_name=self.config.provider_name,
    scopes=scopes,
    auth_flow="USER_FEDERATION",
    workload_access_token=self.config.workload_access_token,
    session_binding_url=self.config.session_binding_url,
    on_auth_url=self._on_auth_url,
    region=self.config.aws_region,
)
async def make_request(*, access_token: str) -> Any:
    async with httpx.AsyncClient() as client:
        response = await client.get(
            f"{self.config.github_api_base}{endpoint}",
            headers={"Authorization": f"Bearer {access_token}"}
        )

데코레이터를 사용하여 외부 API 호출 시 필요한 OAuth 액세스 토큰을 자동으로 주입받는 예시

실무 Takeaway

에이전트 워크로드와 세션 바인딩 서비스를 분리하여 설계하면 보안 공격 표면을 줄이고 각 구성 요소를 독립적으로 확장할 수 있다.
ALB OIDC 흐름과 AgentCore Identity를 연동할 때 GetWorkloadAccessTokenForUserId API를 사용하면 JWT 서명 검증 호환성 문제를 해결할 수 있다.
에이전트 도구 클래스에서 Pydantic 모델을 반환 타입으로 사용하면 LLM이 도구의 출력 구조를 더 정확하게 이해하고 활용할 수 있다.

언급된 리소스

GitHubGitHub Repository - Secure AI Agents on ECS

API DocsAgentCore Identity Documentation

agentcore = boto3.client("bedrock-agentcore", region_name=settings.identity_aws_region) response = agentcore.get_workload_access_token_for_user_id( workloadName=settings.workload_identity_name, userId=user_id ) workload_access_token = response["workloadAccessToken"]

@requires_access_token( provider_name=self.config.provider_name, scopes=scopes, auth_flow="USER_FEDERATION", workload_access_token=self.config.workload_access_token, session_binding_url=self.config.session_binding_url, on_auth_url=self._on_auth_url, region=self.config.aws_region, ) async def make_request(*, access_token: str) -> Any: async with httpx.AsyncClient() as client: response = await client.get( f"{self.config.github_api_base}{endpoint}", headers={"Authorization": f"Bearer {access_token}"} )

Amazon Bedrock AgentCore Identity를 활용한 Amazon ECS 기반 보안 AI 에이전트 구축

핵심 요약

배경

대상 독자

의미 / 영향

섹션별 상세

실무 Takeaway

언급된 리소스

Amazon Bedrock AgentCore Identity를 활용한 Amazon ECS 기반 보안 AI 에이전트 구축

핵심 요약

배경

대상 독자

의미 / 영향

섹션별 상세

실무 Takeaway

언급된 리소스

관련 토론

댓글

관련 피드

관련 토론

댓글

관련 피드