# Access control with IAM

This page describes the Identity and Access Management (IAM) roles required to use
Access Approval.

## Required roles

The following sections mention the IAM roles and permissions
required to perform various actions with Access Approval. The sections
also provide instructions about granting the required roles.

### View Access Approval requests and configuration

The following table lists the IAM permissions required to view
Access Approval requests and configuration:

| Predefined IAM role | Required permissions and roles |
|---|---|
| ` roles/accessapproval.viewer ` | - accessapproval.requests.get - accessapproval.requests.list - accessapproval.serviceAccounts.get - accessapproval.settings.get - resourcemanager.projects.get - resourcemanager.projects.list |

To grant the Access Approval Viewer (`roles/accessapproval.viewer`)
role, do the following:

### Console


To grant this IAM role to yourself, do the following:

1. Go to the **IAM** page in the Google Cloud console.


   [Go to IAM](https://console.cloud.google.com/iam-admin/iam?supportedpurview=project)
2. In the **View by principals** tab, click **Grant access**.
3. In the **New principals** field in the right pane, enter your email address.
4. Click the **Select a role** field, and select the **Access Approval Viewer** role from the menu.
5. Click **Save**.

### gcloud

Run the following command:

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
      --member='user:EMAIL_ID' \
      --role='roles/accessapproval.viewer'

Replace the following:

- <var translate="no">ORGANIZATION_ID</var>: The organization ID.
- <var translate="no">EMAIL_ID</var>: The email ID of the user.

For more information about the command, see [gcloud organizations
add-iam-policy-binding](https://docs.cloud.google.com/sdk/gcloud/reference/organizations/add-iam-policy-binding).

### View and approve an Access Approval request

The following table lists the IAM permissions required to view
and approve an Access Approval request:

| Predefined IAM role | Required permissions and roles |
|---|---|
| `roles/accessapproval.approver` | - accessapproval.requests.approve - accessapproval.requests.dismiss - accessapproval.requests.get - accessapproval.requests.invalidate - accessapproval.requests.list - accessapproval.serviceAccounts.get - accessapproval.settings.get - resourcemanager.projects.get - resourcemanager.projects.list |

To grant the Access Approval Approver
(`roles/accessapproval.approver`) role, do the following:

### Console


To grant this IAM role to yourself, do the following:

1. Go to the **IAM** page in the Google Cloud console.


   [Go to IAM](https://console.cloud.google.com/iam-admin/iam?supportedpurview=project)
2. In the **View by principals** tab, click **Grant access**.
3. In the **New principals** field in the right pane, enter your email address.
4. Click the **Select a role** field, and select the **Access Approval Approver** role from the menu.
5. Click **Save**.

### gcloud

Run the following command:

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
      --member='user:EMAIL_ID' \
      --role='roles/accessapproval.approver'

Replace the following:

- <var translate="no">ORGANIZATION_ID</var>: The organization ID.
- <var translate="no">EMAIL_ID</var>: The email ID of the user.

### Update the Access Approval configuration

The following table lists the IAM permissions required to
update Access Approval configuration:

| Predefined IAM role | Required permissions and roles |
|---|---|
| `roles/accessapproval.configEditor` | - accessapproval.serviceAccounts.get - accessapproval.settings.delete - accessapproval.settings.get - accessapproval.settings.update - resourcemanager.projects.get - resourcemanager.projects.list |

To grant the Access Approval Config Editor
(`roles/accessapproval.configEditor`) role, do the following:

### Console


To grant this IAM role to yourself, do the following:

1. Go to the **IAM** page in the Google Cloud console.


   [Go to IAM](https://console.cloud.google.com/iam-admin/iam?supportedpurview=project)
2. In the **View by principals** tab, click **Grant access**.
3. In the **New principals** field in the right pane, enter your email address.
4. Click the **Select a role** field, and select the **Access Approval Config Editor** role from the menu.
5. Click **Save**.

### gcloud

Run the following command:

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
      --member='user:EMAIL_ID' \
      --role='roles/accessapproval.approver'

Replace the following:

- <var translate="no">ORGANIZATION_ID</var>: The organization ID.
- <var translate="no">EMAIL_ID</var>: The email ID of the user.

### Invalidate existing Access Approval requests

The following table lists the IAM permissions required to
invalidate existing Access Approval requests that have been approved:

| Predefined IAM role | Required permissions and roles |
|---|---|
| ` roles/accessapproval.invalidator ` | - accessapproval.requests.get - accessapproval.requests.list - accessapproval.serviceAccounts.get - accessapproval.settings.get - resourcemanager.projects.get - resourcemanager.projects.list |

To grant the Access Approval Invalidator
(`roles/accessapproval.invalidator`) role, do the following:

### Console


To grant this IAM role to yourself, do the following:

1. Go to the **IAM** page in the Google Cloud console.


   [Go to IAM](https://console.cloud.google.com/iam-admin/iam?supportedpurview=project)
2. In the **View by principals** tab, click **Grant access**.
3. In the **New principals** field in the right pane, enter your email address.
4. Click the **Select a role** field, and select the **Access Approval Invalidator** role from the menu.
5. Click **Save**.

### gcloud

Run the following command:

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
      --member='user:EMAIL_ID' \
      --role='roles/accessapproval.invalidator'

Replace the following:

- <var translate="no">ORGANIZATION_ID</var>: The organization ID.
- <var translate="no">EMAIL_ID</var>: The email ID of the user.

## What's next

- [Grant or revoke a single IAM role](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access#single-role)
- [Manage access to service accounts](https://docs.cloud.google.com/iam/docs/manage-access-service-accounts)