통합 액세스 정책

통합 액세스 정책(UAP)을 사용하면Google Cloud 리소스에 대한 액세스 권한을 부여하고 거부할 수 있습니다. 허용 및 거부 정책과 달리 UAP를 사용하면 동일한 정책에서 액세스를 부여하고 거부할 수 있으므로 정책 관리가 간소화됩니다. UAP는 재사용할 수도 있습니다. 즉, 동일한 UAP를 여러 리소스에 적용할 수 있습니다.

통합 액세스 정책 작동 방식

IAM에서 액세스 권한을 부여하거나 거부하려면 누가 어떤 리소스에서 무엇을 수행할 수 있는지 또는 수행할 수 없는지 지정해야 합니다.

UAP에서는 UAP 규칙을 만들어 누가 무엇을 할 수 있는지 또는 할 수 없는지 지정합니다. 각 규칙에는 주 구성원 집합, 역할 및 권한 집합, 효과가 나열됩니다. 효과(허용 또는 거부)는 나열된 주 구성원에게 규칙의 역할 및 권한이 부여되는지 또는 규칙의 권한을 사용하지 못하게 하는지 여부를 지정합니다. 단일 UAP에 최대 100개의 규칙을 포함할 수 있습니다.

UAP가 액세스를 제어하는 리소스를 지정하려면 UAP 바인딩을 사용하여 UAP를 리소스에 바인딩합니다. 단일 UAP를 최대 5개의 리소스에 바인딩할 수 있습니다. 단일 리소스에는 최대 5개의 정책을 바인딩할 수 있습니다.

사용 사례

IAM에는 액세스를 허용하고 거부하는 데 사용할 수 있는 여러 정책 유형이 있습니다.

  • 액세스를 허용하려면 허용 정책 또는 UAP 허용 규칙을 사용하면 됩니다.
  • 액세스를 거부하려면 거부 정책 또는 UAP 거부 규칙을 사용하면 됩니다.

이미 허용 또는 거부 정책을 사용하여 액세스를 제어하고 있다면 해당 정책을 계속 사용하는 것이 좋습니다. 이러한 정책 유형은 정책 문제 해결 도구에서도 지원되므로 액세스 오류의 근본 원인을 더 쉽게 파악할 수 있습니다.

다음과 같은 상황에서 UAP를 사용하세요.

  • 새 조직을 설정하고 UAP를 사용하여 조직 전체의 액세스를 제어하려고 합니다.
  • UAP 조건을 사용하여 세분화된 액세스 제어를 설정하려고 합니다.

통합 액세스 정책 규칙

UAP는 허용 및 거부 규칙으로 구성됩니다. 이러한 규칙에는 다음 구성요소가 포함됩니다.

  • 효과: 규칙이 액세스를 허용하는지 또는 거부하는지 여부입니다. 액세스를 부여하는 규칙을 허용 규칙이라고 합니다. 액세스를 거부하는 규칙을 거부 규칙이라고 합니다.

  • 주 구성원 집합: 규칙에 포함할 주 구성원(예: 사용자, 그룹 또는 서비스 계정)입니다. 허용 규칙에서 이러한 주 구성원에게 액세스 권한이 부여됩니다. 거부 규칙에서 이러한 주 구성원은 액세스가 거부됩니다.

  • 역할 및 권한 목록: 규칙에 포함할 역할 및 권한입니다. 허용 규칙에서는 이러한 권한이 부여됩니다. 거부 규칙에서 이러한 권한은 거부됩니다.

  • 선택사항: 조건 표현식: 규칙이 적용되기 위해 true여야 하는 조건을 지정하는 IAM 조건 표현식입니다. 자세한 내용은 이 페이지의 UAP의 조건을 참조하세요.

통합 액세스 정책 규칙의 주 구성원

규칙에 포함할 주 구성원을 지정하려면 다음을 정의합니다.

  • 포함된 주 구성원: 규칙에 포함할 주 구성원입니다.
  • 제외된 주 구성원: 포함된 주 구성원 목록의 그룹에 속해 있더라도 규칙에서 제외하려는 주 구성원입니다.

이 두 목록을 사용하면 규칙에 포함할 주 구성원을 간결하게 지정할 수 있습니다. 예를 들어 example.com의 사용자에게 액세스 권한을 부여하는 허용 규칙을 만든다고 가정해 보겠습니다. reduced-access@example.com 사용자를 제외한 all@example.com 그룹의 모든 사용자에게 액세스 권한을 부여하려면 포함된 주 구성원 목록에 all@example.com를 추가하고 제외된 주 구성원 목록에 reduced-access@example.com를 추가합니다.

통합 액세스 정책 규칙의 역할 및 권한

규칙에 포함할 권한의 정확한 목록을 만들려면 다음을 정의합니다.

  • 포함된 권한: 규칙에 포함할 권한입니다.
  • 제외된 권한: 포함된 권한 목록의 역할 또는 권한 그룹에 있더라도 규칙에 포함하지 않으려는 권한입니다.

포함된 권한 또는 제외된 권한 목록에 권한을 추가하려면 다음 중 하나를 참조하면 됩니다.

  • 권한: 정규화된 도메인 이름(FQDN) 형식의 개별 권한 이름입니다. 예를 들면 cloudresourcemanager.googleapis.com/projects.get입니다.

  • 역할(허용 규칙만 해당): 사전 정의된 역할 이름(예: roles/logging.logsViewer) 규칙에 역할 이름을 포함하면 규칙에 해당 역할의 모든 권한이 포함됩니다. 역할의 모든 권한을 보려면 역할 및 권한 참조를 확인하세요.

    UAP JSON에서 이러한 이름은 항상 role:로 시작합니다(예: role:roles/logging.logsViewer).

    역할은 허용 규칙에서만 허용됩니다. 맞춤 역할은 규칙에서 지원되지 않습니다.

  • 권한 그룹: aiplatform.googleapis.com/*.*와 같은 권한 집합입니다. 권한 그룹은 지정된 패턴과 일치하는 권한 집합입니다. 참조할 수 있는 권한 그룹과 해당 그룹에 포함된 권한에는 몇 가지 제한사항이 있습니다. 자세한 내용은 이 페이지의 권한 그룹을 참조하세요.

권한 그룹

권한 그룹은 지정된 패턴과 일치하는 권한 집합입니다. 권한 그룹을 사용하여 관련 권한 집합을 부여하거나 거부할 수 있습니다. 예를 들어 단일 서비스에 대한 모든 권한을 거부하거나 특정 동사로 끝나는 모든 권한을 부여할 수 있습니다.

권한 그룹은 허용 규칙과 거부 규칙에서 다르게 작동합니다. 다음 섹션에서는 각 규칙 유형에서 권한 그룹을 사용하는 방법을 설명합니다.

허용 규칙의 권한 그룹

허용 규칙에서 권한 그룹을 식별하려면 권한 이름의 섹션 하나 이상을 와일드 카드 문자(*)로 바꿉니다. 각 그룹에 포함된 권한은 와일드 카드 위치에 따라 다릅니다.

  • SERVICE_FQDN/RESOURCE.*: 지정된 리소스의 모든 권한을 포함합니다.
  • SERVICE_FQDN/*.*: 지정된 서비스의 모든 권한을 포함합니다.
  • SERVICE_FQDN/*.VERB: 지정된 동사로 끝나는 서비스의 모든 권한을 포함합니다.
  • */*.VERB: 지정된 동사로 끝나는 모든 권한을 포함합니다.
  • *: 모든 권한을 포함합니다. 이 값은 제외된 권한이 아닌 포함된 권한을 나열할 때만 허용됩니다.

권한 그룹에는 커스텀 역할에서 지원되는 권한만 포함됩니다. 지정된 형식과 일치하더라도 다른 권한은 포함되지 않습니다.

맞춤 역할에서 지원되는 권한을 알아보려면 맞춤 역할의 권한 지원 수준을 참조하세요.

이 페이지에 나열된 권한은 UAP의 권한과 동일한 형식을 사용하지 않습니다.

  • 맞춤 역할은 권한 이름에 v1 형식을 사용합니다. 이 형식은 SERVICE_ID.RESOURCE.VERB입니다.
  • UAP는 권한 이름에 정규화된 도메인 이름 형식인 SERVICE_FQDN/RESOURCE.VERB을 사용합니다.

하지만 SERVICE_ID 및 SERVICE_FQDN 값은 일반적으로 비슷합니다. 대부분의 경우 SERVICE_FQDN 값은 v1 API의 SERVICE_ID 값 다음에 .googleapis.com가 오는 값입니다. 예를 들어 역할을 삭제할 수 있는 권한은 다음과 같은 방법으로 작성할 수 있습니다.

  • v1 형식: iam.roles.delete
  • 정규화된 도메인 이름 형식: iam.googleapis.com/roles.delete

이 유사성을 사용하여 허용 규칙의 권한 그룹을 검토할 때 두 형식 간에 변환할 수 있습니다.

이 규칙에는 몇 가지 예외가 있습니다. 이러한 예외를 보려면 거부 정책에서 지원되는 권한 목록을 검토하고 필터 필드에서 IAM v1 API을 검색하세요.

거부 규칙의 권한 그룹

거부 규칙은 특정 권한 그룹만 지원합니다. 지원되는 권한 그룹은 거부 정책에서 지원되는 권한에 나열되어 있습니다. 지원되는 권한 그룹의 식별자는 권한 이름의 섹션 하나 이상을 와일드 카드 문자(*)로 바꿉니다. 각 그룹에 포함된 권한은 와일드 카드 위치에 따라 다릅니다.

  • SERVICE_FQDN/RESOURCE.*: 지정된 리소스의 모든 권한을 거부합니다.
  • SERVICE_FQDN/*.*: 지정된 서비스의 모든 권한을 거부합니다.
  • SERVICE_FQDN/*.VERB: 지정된 동사로 끝나는 서비스의 모든 권한을 거부합니다.

권한 그룹에는 지정된 패턴과 일치하는 현재 및 미래의 모든 권한이 포함됩니다. 예를 들어 권한 그룹 example.googleapis.com/exampleResource.*를 사용하여 사용자가 exampleResource 리소스 유형에 대한 모든 권한을 거부한다고 가정해 보겠습니다. example.googleapis.com에서 example.googleapis.com/exampleResource.newPermission과 같은 exampleResource 리소스 유형에 대한 새로운 권한을 추가하면 사용자는 자동으로 새 권한을 거부합니다.

지원되는 권한 그룹에서만 와일드 카드를 사용할 수 있습니다. 거부 규칙의 다른 권한 이름에는 와일드 카드를 사용할 수 없습니다.

통합 액세스 정책 만들기

프로젝트, 폴더 또는 조직에서 UAP를 만들 수 있습니다. UAP를 만드는 리소스가 UAP의 상위 요소가 됩니다. 하지만 UAP를 적용하기 전까지는 UAP가 적용되지 않습니다.

UAP의 상위 요소는 UAP 이름에 표시됩니다. 정책 이름의 형식은 RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID입니다. 여기서 자리표시자는 다음을 나타냅니다.

  • RESOURCE_TYPE: UAP가 생성된 리소스의 유형입니다. 이 값은 projects, folders 또는 organizations입니다.
  • RESOURCE_ID: UAP가 생성된 리소스의 ID입니다.
  • POLICY_ID: UAP의 영숫자 ID입니다.

예를 들어 example-project 프로젝트에서 UAP example-policy를 만들면 해당 UAP의 상위 리소스는 example-project이고 UAP의 이름은 projects/example-project/locations/global/accessPolicies/example-policy입니다.

통합 액세스 정책을 만들 수 있는 위치

UAP의 상위 요소는 UAP를 적용할 수 있는 리소스에 영향을 주지 않습니다. 하지만 UAP를 보고 수정할 수 있는 권한이 있는 사용자에게는 영향을 미칩니다. 적절한 사용자가 적절한 UAP를 보고 수정할 수 있는 권한을 갖도록 하려면 UAP의 범위를 가장 잘 반영하는 상위 리소스를 선택하는 것이 좋습니다.

예를 들어 조직에 UAP를 적용하려면 조직에 UAP를 만드는 것이 좋습니다.

리소스에 정책 적용

UAP를 적용하려면 바인딩을 만듭니다. 각 바인딩은 UAP와 UAP를 바인딩할 리소스를 지정합니다. 바인딩을 만들면 UAP의 규칙이 해당 리소스와 해당 리소스의 하위 요소에 적용됩니다.

예를 들어 UAP compute-access-management가 있다고 가정해 보겠습니다. 이 UAP는 Compute 편집자 역할(roles/compute.editor)을 compute-users@example.com 그룹에 부여하고 compute-users@example.com을 제외한 모든 사용자에게 compute.googleapis.com/instances.* 권한을 거부합니다.

바인딩이 없으면 이 UAP는 아무런 영향을 미치지 않습니다.

이 UAP를 조직 example.com의 모든 리소스에 적용하려고 하므로 compute-access-management UAP를 example.com에 연결하는 바인딩을 만듭니다. 바인딩을 만든 후 UAP는 다음과 같은 효과를 가집니다.

  • compute-users@example.com의 구성원은 Compute 편집자 역할의 권한을 사용하여 example.com의 리소스에 액세스할 수 있습니다.
  • compute-users@example.com의 구성원이 아닌 모든 사용자는 인스턴스 관련 권한을 사용하여 example.com의 리소스에 액세스할 수 없습니다.

지원되는 리소스

다음 표에는 UAP를 바인딩할 수 있는 리소스가 나와 있습니다. 각 행에는 다음이 포함됩니다.

  • 리소스 유형
  • 해당 리소스의 ID 형식
  • 해당 유형의 리소스에 대한 바인딩을 보유하는 Resource Manager 리소스(프로젝트, 폴더 또는 조직)
리소스 리소스 ID 바인딩의 상위 리소스
Resource Manager 프로젝트 //cloudresourcemanager.googleapis.com/projects/PROJECT_ID 바인딩의 프로젝트
Resource Manager 폴더 //cloudresourcemanager.googleapis.com/folders/FOLDER_ID 바인딩의 폴더
Resource Manager 조직 //cloudresourcemanager.googleapis.com/organizations/ORG_ID 바인딩의 조직
Agent Registry AI 애플리케이션 //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID 애플리케이션의 상위 프로젝트
Network Services API Agent Gateway //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID 게이트웨이의 상위 프로젝트

바인딩 생성 사용 중지

조직에서 바인딩 생성을 사용 중지하려면 조직에서 iam.managed.disableAccessPolicyBinding 조직 정책 제약 조건을 시행하면 됩니다. 이 제약조건은 조직의 주 구성원이 UAP에 대한 바인딩을 만들지 못하도록 방지합니다.

이 제약 조건을 사용 설정 또는 사용 중지하는 방법은 조직 정책에서 관리형 제약 조건 사용을 참조하세요.

정책 상속

UAP를 프로젝트, 폴더 또는 조직에 바인딩하면 해당 UAP는 리소스 계층 구조를 통해 상속됩니다.

리소스 계층 구조는 맨 위에 조직(루트)이 있고, 그 아래에 그룹화를 위한 폴더(선택사항)가 있으며, 그 아래에 Compute Engine 가상 머신 및 Cloud Storage 버킷과 같은 서비스별 리소스가 포함된 프로젝트가 있습니다.

이 계층 구조에서 프로젝트, 폴더, 조직은 상위 리소스입니다. 즉, 다른 리소스를 포함하는 리소스입니다.

  • 프로젝트에는 특정 서비스 리소스가 포함됩니다.
  • 폴더에는 다른 폴더, 프로젝트, 프로젝트의 리소스가 포함됩니다.
  • 조직에는 폴더, 프로젝트, 프로젝트의 리소스가 포함됩니다.

상위 리소스에 포함된 리소스는 해당 리소스의 하위 요소입니다.

UAP를 상위 리소스에 바인딩하면 해당 UAP가 상위 리소스 및 해당 리소스의 모든 하위 요소에 적용됩니다. 즉, UAP는 리소스의 하위 요소에 의해 상속됩니다.

정책 상속을 사용하면 단일 바인딩으로 대규모 리소스 집합에 정책을 적용할 수 있습니다. 예를 들어 taylor@example.com에게 Compute Engine 관리자 역할(roles/compute.admin)을 부여하는 UAP를 만든다고 가정해 보겠습니다. 이 UAP는 noam@example.com에게 compute.googleapis.com/instances.delete 권한도 거부합니다.

이 UAP가 조직(example.com)의 모든 리소스에 적용되도록 하려고 합니다. 이를 위해 이 UAP를 조직 리소스에 바인딩합니다. UAP를 조직에 바인딩하면 UAP가 해당 조직의 모든 리소스를 통해 상속됩니다.

UAP를 조직에 바인딩하면 다음과 같은 효과가 있습니다.

  • taylor@example.com는 Compute Engine 관리자 역할의 권한을 사용하여 example.com의 모든 리소스에 액세스할 수 있습니다.
  • noam@example.com는 하위 리소스의 UAP가 액세스 권한을 부여하더라도 example.com의 리소스에 대해 compute.googleapis.com/instances.delete 권한을 사용할 수 없습니다.

UAP를 더 적은 리소스에 적용하려면 UAP를 리소스 계층 구조의 하위 수준(예: 프로젝트 또는 지원되는 서비스별 리소스)에 바인딩하면 됩니다.

조직 간 바인딩

UAP에는 조직 간 바인딩을 만들 수 없습니다. 조직 간 바인딩은 한 조직의 UAP를 다른 조직의 리소스에 바인딩하는 바인딩입니다.

IAM은 기존 조직 간 바인딩을 주기적으로 삭제합니다. 조직 간 바인딩은 한 조직에서 다른 조직으로 프로젝트를 이동할 때 발생할 수 있습니다. 예를 들어 다음 상황을 고려해보세요.

  • example.com 조직에 example-project 프로젝트가 있습니다.
  • example-project 프로젝트에서 UAP를 만들고 example-project에 바인딩합니다.
  • example-project는 example.com에서 cymbalgroup.com으로 이동합니다.

이러한 상황에서 프로젝트를 이동하면 조직 간 바인딩이 생성됩니다. 이는 example.com의 UAP가 cymbalgroup.com의 리소스에 바인딩되기 때문입니다. 바인딩을 수동으로 삭제하지 않으면 IAM이 결국 이를 자동으로 삭제합니다. 이 바인딩을 삭제하면 cymbalgroup.com 관리자가 조직의 리소스에 바인딩된 모든 UAP에 액세스할 수 있습니다.

삭제된 통합 액세스 정책의 바인딩

일반적으로 UAP를 삭제하기 전에 UAP의 바인딩을 삭제해야 합니다. 기존 바인딩이 있는 UAP를 삭제하려고 하면 오류가 발생합니다.

하지만 기존 바인딩을 삭제하지 않고 UAP를 삭제하려면 UAP를 강제로 삭제하면 됩니다.

UAP를 강제로 삭제하면 바인딩된 모든 리소스에서 삭제됩니다. UAP를 참조하는 모든 바인딩은 결국 삭제됩니다. 그러나 삭제될 때까지 바인딩은 단일 리소스를 참조할 수 있는 바인딩 수 한도에 포함됩니다.

통합 액세스 정책의 조건

IAM 조건을 사용하면 Google Cloud 리소스에 대한 조건부 속성 기반 액세스 제어를 정의하고 적용할 수 있습니다. UAP에서는 개별 규칙에 조건을 추가하여 해당 규칙이 적용되는 시점을 제어할 수 있습니다. UAP 바인딩에 조건을 추가할 수 없습니다.

조건은 제목, 설명, 불리언 표현식으로 구성됩니다. 요청에 대해 표현식이 true로 평가되면 규칙이 요청에 적용됩니다. false로 평가되면 규칙이 요청에 적용되지 않습니다.

서비스마다 조건 표현식을 작성하는 데 사용할 수 있는 속성과 함수가 다릅니다. 규칙에 조건을 추가할 때는 항상 속성과 함수를 사용하는 서비스의 이름을 조건 앞에 붙입니다. 규칙에 여러 조건을 추가할 수 있지만 단일 조건에서 여러 서비스의 속성을 혼합할 수는 없습니다.

예를 들어 IAM에서 제공하는 속성을 사용하는 조건을 추가하는 경우 조건 앞에 iam.googleapis.com를 추가합니다.

"conditions": {
  "iam.googleapis.com": {
    "title": "CONDITION_TITLE",
    "description": "CONDITION_DESCRIPTION",
    "expression": "CONDITION_EXPRESSION"
  }
}

조건이 있는 UAP 규칙을 만드는 방법은 UAP 만들기 및 적용을 참조하세요.

조건 속성에 적용되는 권한

일부 서비스별 속성은 특정 권한과 관련된 요청에만 적용됩니다. 예를 들어 eventarc.googleapis.com 속성 message.id은 eventarc.googleapis.com/messageBuses.publish 권한이 필요한 요청에만 적용됩니다.

관련 권한이 포함된 규칙에서만 이러한 속성을 사용할 수 있습니다. 관련 권한 없이 규칙에서 속성을 사용하려고 하면 UAP 생성이 실패합니다.

지원되는 조건 속성

UAP 규칙에서는 다음 속성이 지원됩니다.

서비스 속성 관련 권한 추가 정보
iam.googleapis.com(미리보기) 리소스 태그 모두 리소스 태그 속성
eventarc.googleapis.com(미리보기) 메시지 eventarc.googleapis.com/messageBuses.publish Eventarc 메시지 속성
iap.googleapis.com(GA) 대상 iap.googleapis.com/resources.egressViaIAP IAP(Identity-Aware Proxy) 대상 속성

다음 단계