Access control with IAM

This page describes the Identity and Access Management (IAM) roles required to configure VPC Service Controls.

Required roles

The following table lists the permissions and roles required to create and list access policies:

Action	Required permissions and roles
Create an organization-level access policy or scoped policies	Permission: accesscontextmanager.policies.create Role that provides the permission: VPC Service Controls Editor role (roles/accesscontextmanager.policyEditor)
List an organization-level access policy or scoped policies	Permission: accesscontextmanager.policies.list Roles that provides the permission: VPC Service Controls Editor role (roles/accesscontextmanager.policyEditor) VPC Service Controls Reader role (roles/accesscontextmanager.policyReader)

You can only create, list, or delegate scoped policies if you have those permissions at the organization level. After you create a scoped policy, you can grant permission to manage the policy by adding IAM bindings on the scoped policy.

Permissions granted at the organization-level apply to all access policies, including the organization-level policy and any scoped policies.

Note: Any Access Context Manager permissions granted on folders or projects have no effect on scoped policies as permissions can only be granted at the organization-level or on individual policies. The access control for scoped policies is independent of the projects or folders in their scopes.

The following predefined IAM roles provide the necessary permissions to view or configure service perimeters and access levels:

• Access Context Manager Admin (roles/accesscontextmanager.policyAdmin)
• Access Context Manager Editor (roles/accesscontextmanager.policyEditor)
• Access Context Manager Reader (roles/accesscontextmanager.policyReader)

To grant one of these roles, use the Google Cloud console or run one of the following commands in the gcloud CLI. Replace ORGANIZATION_ID with the ID of your Google Cloud organization.

Grant Manager Admin role to allow read-write access

gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member="user:[e-mail]" \
    --role="roles/accesscontextmanager.policyAdmin"

Grant Manager Editor role to allow read-write access

gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member="user:[e-mail]" \
    --role="roles/accesscontextmanager.policyEditor"

Grant Manager Reader role to allow read-only access

gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member="user:[e-mail]" \
    --role="roles/accesscontextmanager.policyReader"