IAM 통합 액세스 정책의 CEL 속성

이 문서에서는 에이전트 게이트웨이의 IAM 통합 액세스 정책 (UAP)에서 조건부 표현식을 작성할 때 사용할 수 있는 Common Expression Language (CEL) 속성 및 함수를 설명합니다.

UAP 개념에 대해 자세히 알아보려면 IAM UAP 개요를 참고하세요. UAP를 구성하는 방법을 알아보려면 IAM UAP 만들기를 참고하세요.

사용 가능한 CEL 속성

UAP에서 조건부 표현식으로 조건을 정의할 수 있습니다. 표현식에는 여러 하위 표현식이 포함될 수 있습니다. 각 관계형 하위 조건에서 사용하는 대상 리소스 유형에 따라 사용할 수 있는 속성이 결정됩니다.

예를 들어 다음 조건에서 하위 표현식 destination.unregistered.path.startsWith('/v1/statements')의 리소스 유형은 등록되지 않은 대상이고, 속성은 destination.unregistered.path이며, startsWith()는 CEL 함수입니다.

destination.unregistered.host == 'finance.example.com' &&
destination.unregistered.path.startsWith('/v1/statements')

다음 표에 설명된 속성은 각 리소스 유형에 사용할 수 있습니다.

대상 리소스 유형	속성	세부정보
에이전트 레지스트리	destination.is_registered	값 유형 불리언 지원 값 true, false 지원되는 작업 ==, !=
	destination.agent_registry.resource_type	값 유형 문자열 지원 값 'AGENT', 'ENDPOINT', 'MCP_SERVER', 'SKILL' 지원되는 작업 ==, !=, in
	destination.agent_registry.location	값 유형 문자열 지원 값 Google Cloud 위치 ID (예: 'global', 'us-central1') 지원되는 작업 ==, !=, in
	destination.agent_registry.project_id	값 유형 문자열 지원 값 Google Cloud 프로젝트 ID 지원되는 작업 ==, !=, in
에이전트	destination.agent_registry.agent.name	값 유형 문자열 지원 값 에이전트 리소스 이름(projects/PROJECT_ID/locations/LOCATION/agents/AGENT_NAME) 지원되는 작업 ==, !=, in
MCP 서버	destination.agent_registry.mcp_server.name	값 유형 문자열 지원 값 MCP 서버 리소스 이름(projects/PROJECT_ID/locations/LOCATION/mcpServers/MCP_SERVER_NAME) 지원되는 작업 ==, !=, in
	destination.agent_registry.mcp_server.method	값 유형 문자열 지원 값 MCP 메서드 이름 (예: 'tools', 'prompts', 'resources') 지원되는 작업 ==, !=, in
	destination.agent_registry.mcp_server.tool.name	값 유형 문자열 지원 값 도구 이름 (예: 'search_code', 'execute') 지원되는 작업 ==, !=, in
	destination.agent_registry.mcp_server.tool.annotations.read_only_hint	값 유형 불리언 지원 값 true, false 지원되는 작업 ==, !=
	destination.agent_registry.mcp_server.tool.annotations.destructive_hint	값 유형 불리언 지원 값 true, false 지원되는 작업 ==, !=
	destination.agent_registry.mcp_server.tool.annotations.idempotent_hint	값 유형 불리언 지원 값 true, false 지원되는 작업 ==, !=
	destination.agent_registry.mcp_server.tool.annotations.open_world_hint	값 유형 불리언 지원 값 true, false 지원되는 작업 ==, !=
	destination.agent_registry.mcp_server.prompt.name	값 유형 문자열 지원 값 프롬프트 이름 지원되는 작업 ==, !=, in
	destination.agent_registry.mcp_server.resource.name	값 유형 문자열 지원 값 리소스 이름 지원되는 작업 ==, !=, in
엔드포인트	destination.agent_registry.endpoint.name	값 유형 문자열 지원 값 엔드포인트 리소스 이름 (projects/PROJECT_ID/locations/LOCATION/endpoints/ENDPOINT_NAME) 지원되는 작업 ==, !=, in
등록되지 않은 대상	destination.unregistered.host	값 유형 문자열 지원 값 호스트 이름 (예: 'google.com', 'example.com') 지원되는 작업 ==, !=, in, .startsWith(), .endsWith(), .contains()
	destination.unregistered.path	값 유형 문자열 지원 값 요청 경로 (예: '/admin', '/api/v1') 지원되는 작업 ==, !=, in, .startsWith(), .endsWith(), .contains()
	destination.unregistered.method	값 유형 문자열 지원 값 HTTP 메서드 (예: 'get', 'post', 'put', 'delete') 지원되는 작업 ==, !=, in

다음 단계

• IAM UAP 만들기
• IAM UAP 관리
• IAM UAP 문제 해결