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

이 문서에서는 Agent Gateway의 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
값 유형 문자열
지원 값 Agent 리소스 이름(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

다음 단계