After a principal has successfully requested a grant against an entitlement and it is active, principals with the correct permissions can revoke the grant. Grants that don't have an active status can't be revoked.
Before you begin
Make sure you have enabled Privileged Access Manager and set up permissions for it.
Revoke grants using the Google Cloud console
To revoke a specific grant made against an entitlement, complete the following instructions:
Go to the Privileged Access Manager page.
Select the organization, folder, or project you want to revoke grants in.
Click the Grants tab, followed by the Grants for all users tab. This contains all grants across all requesters, the grant statuses, and their associated entitlement details.
In the table, click
More options in the same row as a grant you want to revoke.To revoke an active grant, click Revoke grant.
To revoke all active grants made against an entitlement, complete the following instructions:
Go to the Privileged Access Manager page.
Click the Entitlements tab, followed by the Entitlements for all users tab. Here you can find the available entitlements, the roles they grant, and their valid requesters and approvers.
In the table, click
More options in the same row as an entitlement you want to revoke the grants for.Click Revoke all grants.
Revoke grants programmatically
gcloud
The
gcloud beta pam grants revoke
command revokes an active grant.
Before using any of the command data below, make the following replacements:
GRANT_ID
: The ID of the grant you want to revoke. You can retrieve the ID by viewing grants.ENTITLEMENT_ID
: The ID of the entitlement that the grant belongs to.REVOKE_REASON
: Why the grant has been revoked.RESOURCE_TYPE
: Optional. The resource type that the entitlement belongs to. Use the valueorganization
,folder
, orproject
.RESOURCE_ID
: Used withRESOURCE_TYPE
. The ID of the Google Cloud project, folder, or organization that you want to manage entitlements for. Project IDs are alphanumeric strings, likemy-project
. Folder and organization IDs are numeric, like123456789012
.
Execute the following command:
Linux, macOS, or Cloud Shell
gcloud beta pam grants revoke \ GRANT_ID \ --entitlement=ENTITLEMENT_ID \ --reason="REVOKE_REASON" \ --location=global \ --RESOURCE_TYPE=RESOURCE_ID
Windows (PowerShell)
gcloud beta pam grants revoke ` GRANT_ID ` --entitlement=ENTITLEMENT_ID ` --reason="REVOKE_REASON" ` --location=global ` --RESOURCE_TYPE=RESOURCE_ID
Windows (cmd.exe)
gcloud beta pam grants revoke ^ GRANT_ID ^ --entitlement=ENTITLEMENT_ID ^ --reason="REVOKE_REASON" ^ --location=global ^ --RESOURCE_TYPE=RESOURCE_ID
You should receive a response similar to the following:
auditTrail: accessGrantTime: '2024-04-05T00:29:16.703069535Z' accessRemoveTime: '2024-04-05T00:29:55.815041079Z' createTime: '2024-04-05T00:27:43.822053968Z' justification: unstructuredJustification: Renaming a file to mitigate issue #312 name: projects/my-project/locations/global/entitlements/ENTITLEMENT_ID/grants/GRANT_ID privilegedAccess: gcpIamAccess: resource: //cloudresourcemanager.googleapis.com/projects/my-project resourceType: cloudresourcemanager.googleapis.com/Project roleBindings: - role: roles/storage.admin requestedDuration: 2700s requester: [email protected] state: REVOKED timeline: events: - eventTime: '2024-04-05T00:27:44.014277946Z' requested: expireTime: '2024-04-06T00:27:44.014277946Z' - approved: actor: [email protected] reason: Access allowed under existing policy eventTime: '2024-04-05T00:29:14.921828714Z' - eventTime: '2024-04-05T00:29:14.921763008Z' scheduled: scheduledActivationTime: '2024-04-05T00:29:14.921763008Z' - activated: {} eventTime: '2024-04-05T00:29:16.703069535Z' - eventTime: '2024-04-05T00:29:55.815041079Z' revoked: actor: [email protected] reason: Revoking due to new access policy
REST
The Privileged Access Manager API's
revokeGrant
method revokes an active grant.
Before using any of the request data, make the following replacements:
SCOPE
: The organization, folder, or project that the entitlement is in, in the format oforganizations/ORGANIZATION_ID
,folders/FOLDER_ID
, orprojects/PROJECT_ID
. Project IDs are alphanumeric strings, likemy-project
. Folder and organization IDs are numeric, like123456789012
.ENTITLEMENT_ID
: The ID of the entitlement that the grant belongs to.GRANT_ID
: The ID of the grant you want to revoke. You can retrieve the ID by viewing grants.REVOKE_REASON
: The reason the grant was revoked.
HTTP method and URL:
POST https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/entitlements/ENTITLEMENT_ID/grants/GRANT_ID:revoke
Request JSON body:
{ "reason": "REVOKE_REASON" }
To send your request, expand one of these options:
You should receive a JSON response similar to the following:
{ "name": "projects/my-project/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.privilegedaccessmanager.v1beta.OperationMetadata", "createTime": "2024-03-06T23:07:48.716396505Z", "target": "projects/my-project/locations/global/entitlements/ENTITLEMENT_ID/grants/GRANT_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1beta" }, "done": false }
To check on the progress of a revoke operation, you can send a
GET
request to the following endpoint:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID
Send a GET
request to the following endpoint to list all
operations:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations