에이전트 ID 개요

에이전트 ID는 SPIFFE 표준을 기반으로 하는 각 에이전트에 강력하게 증명된 암호화 ID를 제공합니다. 에이전트 ID를 사용하면 에이전트가 자체적으로 또는 최종 사용자를 대신하여 MCP 서버, 클라우드 리소스, 엔드포인트, 기타 에이전트에 안전하게 인증할 수 있습니다. 에이전트 ID는 에이전트 자체 사용자 인증 정보와 에이전트 ID 인증 관리자를 사용합니다. 인증 관리자를 사용하여 API 키, OAuth 클라이언트 ID, OAuth 클라이언트 보안 비밀번호, 위임된 최종 사용자 OAuth 토큰을 획득, 관리, 보호하는 데 사용되는 특정 구성인 인증 제공자를 만들고 관리할 수 있습니다.

서비스 계정과 달리 에이전트 ID는 기본적으로 여러 워크로드에서 공유되지 않으며, 가장할 수 없고, 개발자가 수명이 긴 서비스 계정 키를 생성할 수 없습니다. Google Cloud에 대해 생성된 액세스 토큰은 토큰 도난을 방지하기 위해 에이전트의 고유한 X.509 인증서에 암호화 방식으로 바인딩됩니다.

에이전트 ID를 에이전트 게이트웨이 및 Gemini Enterprise와 함께 사용하면 Gemini Enterprise 커넥터에서 프로비저닝한 것과 같은 최종 사용자 사용자 인증 정보가 인증 관리자에 의해 암호화되고 게이트웨이에서 복호화되어 에이전트가 원시 사용자 인증 정보에 액세스할 수 없습니다.

다음 서비스는 에이전트 ID를 지원합니다.

Gemini Enterprise 에이전트 플랫폼 런타임 (에이전트 런타임)
Gemini Enterprise

인증 모델

다양한 도구 및 서비스로 인증하기 위해 에이전트 ID는 여러 인증 모델을 지원합니다. 에이전트가 사용하는 모델은 타겟 리소스에서 제공하는 인증 방법과 에이전트가 자체 권한으로 작동하는지 아니면 최종 사용자를 대신하여 작동하는지에 따라 다릅니다.

권한	인증 방법	대상 리소스	사용 사례 및 솔루션
사용자 위임 권한	OAuth 2.0 (3-legged) (미리보기)	외부 도구 및 서비스	상담사가 특정 사용자를 대신하여 행동하는 경우 (예: 사용자의 Jira 작업 또는 GitHub 저장소에 액세스하는 경우) 사용자 동의 및 토큰을 관리하기 위해 에이전트 ID 인증 관리자에서 3단계 OAuth 인증 공급자를 구성합니다. 자세한 내용은 인증 관리자를 사용하여 3-legged OAuth로 인증을 참고하세요.
상담사의 자체 권한	클라우드 기반 ID (에이전트 ID)	Google Cloud 서비스	Google Cloud 에서 호스팅되는 상담사가 자체 ID를 사용하여 다른 Google Cloud 서비스에 액세스해야 하는 경우 자세한 내용은 상담사의 자체 ID를 사용하여 인증을 참고하세요.
	OAuth 2.0 (2-legged) (미리보기)	외부 도구 및 서비스	OAuth를 지원하는 외부 서비스와의 머신 간 인증에 권장됩니다. 에이전트 ID 인증 관리자에서 2단계 OAuth 인증 공급자를 구성하여 클라이언트 사용자 인증 정보와 액세스 토큰을 처리합니다. 자세한 내용은 인증 관리자로 2단계 OAuth를 사용하여 인증을 참고하세요.
	API 키 (미리보기)	외부 도구 및 서비스	인증에 암호화 키 또는 비밀번호가 필요한 외부 서비스 Agent Identity 인증 관리자에서 API 키 인증 제공자를 구성하여 키를 안전하게 저장하고 관리합니다. 자세한 내용은 인증 관리자로 API 키를 사용하여 인증을 참고하세요.
	HTTP 기본 인증	외부 도구 및 서비스	일반 텍스트 비밀번호를 사용합니다. 이 방법은 권장되지 않습니다. API 키와 유사한 비밀번호를 저장할 수 있습니다. 자세한 내용은 인증 관리자로 API 키를 사용하여 인증을 참고하세요.

핵심 구성요소

에이전트 ID에는 안전한 인증 및 승인을 제공하는 데 도움이 되는 여러 주요 구성요소가 포함됩니다.

SPIFFE 기반 ID

각 에이전트에는 SPIFFE 표준에 따라 고유한 ID 문자열(SPIFFE ID)이 할당됩니다. 이 ID는 강력하게 증명되고, 에이전트의 수명 주기에 연결되며, 에이전트가 호스팅되는 리소스 URI에 직접 매핑됩니다.

ID는 다음 형식을 따릅니다.

spiffe://TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH

예를 들면 다음과 같습니다.

spiffe://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent

에이전트 ID가 IAM 허용 정책에 사용되면 주 구성원 식별자는 다음 형식을 따릅니다.

principal://TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH

예:

Vertex AI Agent Engine: principal://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent
Gemini Enterprise: principal://agents.global.org-123456789012.system.id.goog/resources/discoveryengine/projects/9876543210/locations/global/collections/default_collection/engines/my-test-agent

식별자는 다음을 사용합니다.

TRUST_DOMAIN: 조직의 트러스트 도메인입니다 (예: agents.global.org-123456789012.system.id.goog).
SERVICE: Google Cloud 서비스의 약칭입니다 (예: aiplatform 또는 discoveryengine).
RESOURCE_PATH: 에이전트를 호스팅하는 리소스의 전체 경로입니다.

에이전트 자체가 주 구성원이므로 에이전트가 액세스할 수 있는 리소스를 제어하기 위해 이 식별자에 직접 권한을 부여합니다.

에이전트 사용자 인증 정보

에이전트 사용자 인증 정보는 에이전트 ID의 암호화 증명을 제공합니다. 시스템은 X.509 인증서와 Google Cloud 액세스 토큰을 지원합니다. X.509 인증서는 더 강력한 인증을 지원하기 위해 에이전트에서 자동 프로비저닝되고 관리됩니다.

에이전트 ID 인증 관리자

에이전트 ID 인증 관리자는 사용자 인증 정보를 보호하도록 설계된 사용자 인증 정보 보관소입니다. 이를 통해 상담사는 API 키 또는 OAuth 클라이언트 ID 및 보안 비밀을 사용하여 인증하거나 최종 사용자 액세스 토큰을 사용하는 OAuth 위임을 통해 사용자를 대신하여 인증할 수 있습니다. 인증 관리자 내에서 특정 서드 파티 애플리케이션의 인증 유형과 사용자 인증 정보를 정의하는 인증 제공업체를 구성합니다.

에이전트 ID 인증 관리자에 대한 액세스는 IAM에 의거하여 관리되며 에이전트는 자체 에이전트 SPIFFE ID를 사용하여 인증 관리자에 인증합니다. 모든 최종 사용자 액세스 이벤트는 상담사의 SPIFFE ID에도 귀속되므로 손쉽게 관리할 수 있습니다.

에이전트 ID 인증 관리자는 사용자 로그인 및 동의를 위한 대화상자를 여는 등 OAuth 사용자 인증 정보 획득을 자동화합니다. 또한 최종 사용자 액세스에 대한 가시성을 제공하고 액세스 취소를 허용하여 사용자 위임 권한에 대한 거버넌스를 개선합니다.

보안 및 거버넌스

에이전트 ID는 IAM, 주 구성원 액세스 경계 (PAB), VPC 서비스 제어와 같은 Google의 정책 시스템과 완전히 통합되어 보안과 거버넌스를 강화할 수 있습니다. 또한 감사 로깅과 통합되어 에이전트가 자체적으로 행동할 때와 최종 사용자를 대신하여 행동할 때 모두 책임감을 보장하고 명확한 감사 로그를 제공합니다.

컨텍스트 인식 액세스: 기본적으로 Google 관리 컨텍스트 인식 액세스 정책은 에이전트 ID 사용자 인증 정보를 보호하는 데 도움이 됩니다. 정책은 에이전트 게이트웨이 외에도 에이전트의 액세스 토큰을 인증하여 입증 가능한 소유권 증명 (DPoP)을 시행합니다. 또한 이 정책은 mTLS를 사용하여 에이전트 게이트웨이에 액세스하도록 강제합니다. 이렇게 하면 인증서 바인딩 토큰을 의도된 신뢰할 수 있는 런타임 환경에서만 사용할 수 있습니다.
IAM 통합: 표준 IAM 허용 정책 및 거부 정책 지원
주 구성원 액세스 경계 (PAB): PAB는 다른 권한과 관계없이 상담사가 액세스할 수 있는 리소스를 제한합니다.
VPC 서비스 제어: 인그레스 및 이그레스 규칙에서 에이전트 ID (미리보기)를 사용하여 서비스 경계로 보호되는 리소스에 대한 액세스를 허용하는 기능 지원

에이전트 ID 작동 방식

에이전트 ID는 보안을 강화하기 위해 설계된 워크플로를 통해 에이전트 작업을 인증하고 승인합니다.

ID 할당: 에이전트를 배포하면 Google Cloud에서 고유한 SPIFFE ID와 X.509 인증서를 할당합니다. 각 X.509 인증서는 24시간 동안 유효하며 Google Cloud 보안을 유지하기 위해 자동으로 최신 상태로 유지됩니다.
사용자 인증 정보 획득: 에이전트가 사용자 인증 정보를 획득하는 방법은 액세스하려는 항목에 따라 다릅니다. 다음은 몇 가지 예입니다.
- 액세스 Google Cloud 서비스: 에이전트가 바인드된 액세스 토큰을 요청합니다. 이 토큰은 토큰 도난을 방지하기 위해 에이전트의 고유한 X.509 인증서에 암호화 방식으로 바인딩됩니다. 자세한 내용은 보안 및 거버넌스를 참고하세요.
- 외부 도구 액세스: 에이전트는 에이전트 ID 인증 관리자를 사용하여 인증 제공업체에서 필요한 사용자 인증 정보 (예: API 키 또는 OAuth 토큰)를 가져옵니다. 인증 관리자는 사용자 위임 권한과 상담사의 자체 권한을 모두 지원합니다.

에이전트 ID의 이점

에이전트 ID는 표준 서비스 계정보다 보안을 강화합니다.

강력한 격리: 서비스 계정과 달리 에이전트 ID는 기본적으로 여러 워크로드에서 공유되지 않으며, 가장할 수 없고, 개발자가 장기 서비스 계정 키를 생성할 수 없습니다.
사용자 인증 정보 보안: 기본 컨텍스트 인식 액세스 정책으로 바운드 토큰을 재생할 수 없게 되어 토큰 도용 및 계정 탈취를 방지할 수 있습니다. 에이전트 ID를 에이전트 게이트웨이 및 Gemini Enterprise와 함께 사용하면 Gemini Enterprise 커넥터에서 프로비저닝한 것과 같은 최종 사용자 사용자 인증 정보가 인증 관리자에 의해 암호화되고 게이트웨이에서 복호화되므로 에이전트가 원시 사용자 인증 정보에 액세스할 수 없습니다.
최소 권한 접근 방식: 과도한 권한이 부여된 에이전트를 제거하기 위해 공유 서비스 계정 대신 에이전트별 ID를 제공합니다.
마찰 감소: 복잡한 OAuth 흐름을 자동화하고 API 키를 관리하여 도구 통합을 간소화합니다.
모니터링 가능성 개선: 명확한 감사 로그를 제공합니다. 상담사가 사용자를 대신하여 조치를 취하면 로그에 상담사와 사용자의 ID가 모두 표시됩니다.

제한사항

Cloud Storage 기존 버킷 역할: 에이전트 ID에 기존 버킷 역할 (예: storage.legacyBucketReader)을 부여할 수 없습니다.