사용자가 액세스 권한을 부여할 수 있는 권한을 거부하면 승인되지 않은 권한 에스컬레이션을 방지하고 보안 제어를 강화할 수 있습니다. 이 문서에서는 이러한 권한을 식별하고 대부분의 사용자에 대해 이러한 권한을 차단하는 거부 정책을 만드는 방법을 설명합니다. 단, 신뢰할 수 있는 주 구성원에 대해서는 예외가 허용됩니다.
시작하기 전에
IAM API가 아직 사용 설정되지 않았으면 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할(roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할(roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기인증을 설정합니다.
이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.
콘솔
Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.
gcloud
Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.
Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Google Cloud CLI를 설치합니다.
외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.
선택사항: 거부 정책 개요를 읽어봅니다.
필요한 역할
거부 정책을 만드는 데 필요한 권한을 얻으려면 관리자에게 조직에 대한 거부 관리자(roles/iam.denyAdmin) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 거부 정책을 만드는 데 필요한 iam.denypolicies.create 권한이 포함되어 있습니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 가져올 수도 있습니다.
사용자가 액세스 권한을 부여할 수 있는 권한 식별
사용자가 액세스 권한을 부여하지 못하도록 거부 정책을 만들기 전에 거부할 권한을 결정합니다.
다음 권한을 통해 사용자는 액세스 권한을 부여할 수 있습니다.
setIamPolicy로 끝나는 권한 이러한 권한 중 가장 광범위하게 허용되는 권한은 Resource Manager 리소스에 대한 권한입니다. 이러한 리소스의 허용 정책은 모든 하위 리소스에 상속되기 때문입니다. 이러한 권한은 다음과 같습니다.cloudresourcemanager.googleapis.com/projects.setIamPolicycloudresourcemanager.googleapis.com/folders.setIamPolicycloudresourcemanager.googleapis.com/organizations.setIamPolicy
다른 리소스에도
setIamPolicy권한이 있습니다. 예를 들어 Compute Engine 인스턴스에는compute.googleapis.com/instances.setIamPolicy권한이 있습니다. 사용자가 이러한 리소스의 허용 정책을 수정하지 못하도록 하려면 거부 정책에 이러한 권한을 추가합니다.setIamPolicy로 끝나는 거부 가능한 권한의 전체 목록을 보려면 거부 정책에서 지원되는 권한으로 이동하여setIamPolicy을 검색하세요.사용자가 맞춤 역할을 수정할 수 있는
iam.googleapis.com/roles.update권한 이 권한이 있는 사용자는 맞춤 역할에 권한을 추가하여 자신 또는 다른 사용자에게 해당 권한을 부여할 수 있습니다.
통합 액세스 정책(UAP)을 수정하고 리소스에 바인딩할 수 있는 권한입니다. 이러한 권한은 다음과 같습니다.
iam.googleapis.com/accesspolicies.update권한: 사용자가 기존 UAP를 업데이트할 수 있습니다.createPolicyBinding로 끝나는 권한 이러한 권한은 UAP를 바인딩할 수 있는 모든 리소스에 존재합니다. 프로젝트, 폴더, 조직의 경우 이러한 권한은 다음과 같습니다.cloudresourcemanager.googleapis.com/projects.createPolicyBindingcloudresourcemanager.googleapis.com/folders.createPolicyBindingcloudresourcemanager.googleapis.com/organizations.createPolicyBinding
또는 조직에서
iam.managed.disableAccessPolicyBinding조직 정책 제약 조건을 적용하여 모든 사용자가 UAP를 리소스에 바인딩하지 못하도록 할 수 있습니다. 하지만 이 조직 정책은 사용자가 이미 리소스에 바인딩된 기존 UAP를 수정하는 것을 방지하지 않습니다.
액세스 변경 권한 거부
거부할 권한을 결정한 후에는 이러한 권한을 거부하는 조직의 거부 정책을 만듭니다.
콘솔
Google Cloud 콘솔에서 IAM 페이지의 거부 탭으로 이동합니다.
조직을 선택합니다.
거부 정책 만들기를 클릭합니다.
정책 이름 섹션에서 다음 중 하나를 수행하여 정책 ID를 정의합니다.
- 표시 이름 필드에 정책 표시 이름을 입력합니다. 이 필드를 작성하면 ID 필드가 자동으로 작성됩니다. 정책 ID를 변경하려면 ID 필드의 텍스트를 업데이트합니다.
- ID 필드에 정책 ID를 입력합니다.
거부 규칙 섹션에서 액세스 변경 권한을 차단하는 거부 규칙을 추가합니다.
거부된 주 구성원 필드에 액세스를 거부할 주 구성원을 추가합니다. 모든 사용자에 대한 액세스 변경 권한을 거부하려면
principalSet://goog/public:all값을 사용합니다. 사용할 수 있는 전체 값 목록은 거부 정책의 주 구성원 식별자를 참조하세요.예외 주 구성원 필드에 액세스 권한을 부여할 신뢰할 수 있는 주 구성원을 추가합니다. 사용할 수 있는 전체 값 목록은 거부 정책의 주 구성원 식별자를 참조하세요.
거부된 권한 섹션에 사용자가 액세스 권한을 부여할 수 있는 권한 식별에서 식별한 권한을 추가합니다.
선택사항: 이 규칙의 영향을 받는 리소스를 지정하는 거부 조건을 추가합니다. 예를 들어
prod태그 값이 있는 리소스에만 정책이 적용되도록 조건을 추가할 수 있습니다. 거부 조건에 대한 자세한 내용은 거부 정책의 조건을 참조하세요.
만들기를 클릭합니다.
gcloud
gcloud iam policies create 명령어는 리소스에 대한 거부 정책을 만듭니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
POLICY_ID: 거부 정책의 식별자입니다.-
ORG_ID: 거부 정책을 만들려는 조직의 숫자 ID입니다. -
POLICY_FILE: 설정하려는 거부 정책이 포함된 파일입니다. 거부 정책에 다음 형식을 사용합니다.{ "displayName": "POLICY_NAME", "rules": [ { "denyRule": { "deniedPrincipals": [ DENIED_PRINCIPALS ], "exceptionPrincipals": [ EXCEPTION_PRINCIPALS ], "deniedPermissions": [ ACCESS_CHANGE_PERMISSIONS ], DENIAL_CONDITION } } ] }
다음 값을 바꿉니다.
POLICY_NAME: 거부 정책의 표시 이름입니다.-
DENIED_PRINCIPALS: 액세스를 거부할 주 구성원입니다. 모든 사용자에 대한 액세스 변경 권한을 거부하려면"principalSet://goog/public:all"값을 사용합니다. 사용할 수 있는 전체 값 목록은 거부 정책의 주 구성원 식별자를 참조하세요. -
EXCEPTION_PRINCIPALS: 액세스 권한을 부여할 수 있는 신뢰할 수 있는 주 구성원입니다. 사용할 수 있는 전체 값 목록은 거부 정책의 주 구성원 식별자를 참조하세요. -
ACCESS_CHANGE_PERMISSIONS: 사용자가 액세스 권한을 부여할 수 있는 권한 식별에서 식별한 권한입니다. -
DENIAL_CONDITION: 선택사항. 이 규칙의 영향을 받는 리소스를 지정하는 거부 조건입니다. 예를 들어prod태그 값이 있는 리소스에만 규칙이 적용되도록 조건을 추가할 수 있습니다. 거부 조건에 대한 자세한 내용은 거부 정책의 조건을 참조하세요.
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud iam policies create POLICY_ID \ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID \ --kind=denypolicies \ --policy-file=POLICY_FILE
Windows(PowerShell)
gcloud iam policies create POLICY_ID ` --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ` --kind=denypolicies ` --policy-file=POLICY_FILE
Windows(cmd.exe)
gcloud iam policies create POLICY_ID ^ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ^ --kind=denypolicies ^ --policy-file=POLICY_FILE
성공하면 이 명령어는 출력을 반환하지 않습니다. 자세한 응답을 출력하려면 --format=json 플래그를 사용합니다.
REST
policies.createPolicy 메서드는 리소스에 대한 거부 정책을 만듭니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
-
ORG_ID: 거부 정책을 만들려는 조직의 숫자 ID입니다. POLICY_ID: 거부 정책의 식별자입니다.POLICY_NAME: 거부 정책의 표시 이름입니다.-
DENIED_PRINCIPALS: 액세스를 거부할 주 구성원입니다. 모든 사용자에 대한 액세스 변경 권한을 거부하려면"principalSet://goog/public:all"값을 사용합니다. 사용할 수 있는 전체 값 목록은 거부 정책의 주 구성원 식별자를 참조하세요. -
EXCEPTION_PRINCIPALS: 액세스 권한을 부여할 수 있는 신뢰할 수 있는 주 구성원입니다. 사용할 수 있는 전체 값 목록은 거부 정책의 주 구성원 식별자를 참조하세요. -
ACCESS_CHANGE_PERMISSIONS: 사용자가 액세스 권한을 부여할 수 있는 권한 식별에서 식별한 권한입니다. -
DENIAL_CONDITION: 선택사항. 이 규칙의 영향을 받는 리소스를 지정하는 거부 조건입니다. 예를 들어prod태그 값이 있는 리소스에만 규칙이 적용되도록 조건을 추가할 수 있습니다. 거부 조건에 대한 자세한 내용은 거부 정책의 조건을 참조하세요.
HTTP 메서드 및 URL:
POST https://iam.googleapis.com/v2/policies/cloudresourcemanager.googleapis.com%2Forganizations%2FORG_ID/denypolicies?policyId=POLICY_ID
JSON 요청 본문:
{
"displayName": "POLICY_NAME",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
DENIED_PRINCIPALS
],
"exceptionPrincipals": [
EXCEPTION_PRINCIPALS
],
"deniedPermissions": [
ACCESS_CHANGE_PERMISSIONS
],
DENIAL_CONDITION
}
}
]
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting/operations/89cb3e508bf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2026-10-31T19:06:12.455151Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "Deny access change permissions.",
"etag": "MTc3NDU4KjM4OZ0MzU5MjQ5OTI=",
"createTime": "2026-10-31T19:06:12.455151Z",
"updateTime": "2026-10-31T22:26:21.968687Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principalSet://goog/public:all"
],
"exceptionPrincipals": [
"principalSet://cloudresourcemanager.googleapis.com/organizations/1234567890123/type/ServiceAgent",
"principalSet://goog/group/iam-admins@example.com"
],
"deniedPermissions": [
"cloudresourcemanager.googleapis.com/projects.setIamPolicy",
"cloudresourcemanager.googleapis.com/folders.setIamPolicy",
"cloudresourcemanager.googleapis.com/organizations.setIamPolicy",
"iam.googleapis.com/accesspolicies.update",
"cloudresourcemanager.googleapis.com/projects.createPolicyBinding",
"cloudresourcemanager.googleapis.com/folders.createPolicyBinding",
"cloudresourcemanager.googleapis.com/organizations.createPolicyBinding"
],
"denialCondition": {
"title": "Only for prod resources",
"expression": "resource.matchTag('12345678/env', 'prod')"
}
}
}
]
}
}
응답은 장기 실행 작업을 식별합니다. 장기 실행 작업의 상태를 모니터링하여 완료 시점을 확인할 수 있습니다. 자세한 내용은 장기 실행 작업의 상태 확인을 참조하세요.
다음 단계
- 거부 정책 액세스 문제 해결 방법 알아보기
- 주 구성원 액세스 거부 자세히 알아보기