Skip to content
Cloud Governance Tools

Principal access boundary limiting the resources principals can access

Principal access boundary limiting the resources principals can access is a Google Cloud guardrail written in principal access boundary (PAB) policies. A principal access boundary policy lists the projects, folders and organizations principals are eligible to access, so a principal bound to it is blocked from other resources whatever roles it holds.

More data exfiltration guardrails ยท About Principal access boundary (PAB) policies

gcloud iam principal-access-boundary-policies create PAB_POLICY_ID \
--organization=ORG_ID --location=global \
--display-name=DISPLAY_NAME --details-rules=FILE_PATH.json \
--details-enforcement-version=ENFORCEMENT_VERSION

{
"description": "DESCRIPTION",
"resources": [
RESOURCES
],
"effect": "ALLOW"
}
Blocks
A principal access boundary policy lists the projects, folders and organizations principals are eligible to access, so a principal bound to it is blocked from other resources whatever roles it holds.
Breaks
Google documents that a policy only blocks permissions in its enforcement version, so an access attempt using a permission it cannot block is not stopped. (source)
Test before applying
Google lists Policy Simulator for Principal Access Boundary policies in its documentation, and Policy Troubleshooter examines Principal Access Boundary policies for a given principal, resource and permission. (source)
Mechanism
Principal access boundary (PAB) policies: Principal sets bound to the policy through a policy binding; blocks only permissions in the policy enforcement version.
Taken from
provider documentation, provider documentation

What the source says

"A list of Resource Manager resources (projects, folders, and organizations) that you want principals to be eligible to access." (read 10 Nov 2026).

On what it breaks: "If a Principal Access Boundary policy can't block a permission, then the policy has no effect on whether principals can use the permission."

Sources

  1. Principal access boundary limiting the resources principals can access, read 10 Nov 2026
  2. What it breaks, read 10 Nov 2026
  3. How to test it first, read 10 Nov 2026

Last reviewed 16 Nov 2026.