La configuración de Privileged Access Manager (PAM) te permite automatizar los flujos de trabajo de aprobación y personalizar las preferencias de notificación por correo electrónico en organizaciones, carpetas y proyectos. Como administrador de la configuración de Privileged Access Manager, puedes habilitar las aprobaciones automatizadas para designar cuentas de servicio, identidades de agentes y identidades en grupos de identidades para cargas de trabajo como responsables de aprobación aptos para los derechos. También puedes desactivar los correos electrónicos en todo el recurso para eventos y personas específicas de Privileged Access Manager o inhabilitar todas las notificaciones. Las carpetas y los proyectos heredan la configuración a través de la jerarquía de recursos de forma predeterminada, a menos que configures una anulación.
Antes de comenzar
Para obtener los permisos que necesitas para establecer la configuración de Privileged Access Manager, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Configura los parámetros de tu proyecto, carpeta u organización:
Administrador de la configuración de PAM (
roles/privilegedaccessmanager.settingsAdmin) en tu organización -
Visualiza la configuración de tu proyecto, carpeta u organización:
Visualizador de la configuración de PAM (
roles/privilegedaccessmanager.settingsViewer) en tu proyecto, carpeta u organización
Estos roles predefinidos contienen los permisos necesarios para establecer la configuración de Privileged Access Manager. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para establecer la configuración de Privileged Access Manager:
-
Establece la configuración:
privilegedaccessmanager.settings.update -
Configuración de vistas:
-
privilegedaccessmanager.settings.get -
privilegedaccessmanager.settings.fetchEffective
-
Aprobaciones automatizadas
Console
Ve a la página Privileged Access Manager.
Selecciona la organización, la carpeta o el proyecto.
Haz clic en la pestaña Configuración. En la sección Fuente de configuración, la opción Heredar del elemento superior está seleccionada de forma predeterminada.
Para anular la configuración heredada del recurso superior en un recurso secundario, en la sección Aprobaciones automáticas, selecciona Anular herencia.
Para habilitar las aprobaciones automáticas, activa el botón de activación Habilitar la identidad del agente y la cuenta de servicio como responsables de aprobación y haz clic en Guardar.
gcloud
El comando
gcloud alpha pam settings update
configura un Privileged Access Manager adicional.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
RESOURCE_TYPE: Opcional Es el tipo de recurso para el que deseas actualizar la configuración. Usa el valororganization,folderoproject.RESOURCE_ID: Se usa conRESOURCE_TYPE. Es el ID del proyecto, la carpeta o la organización de Google Cloud para el que deseas administrar los derechos. Los IDs de proyecto son cadenas alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012.SA_AS_APPROVER: Es un valor booleano en el camposerviceAccountApproverSettingsque indica si las cuentas de servicio y las identidades de los agentes pueden aprobar otorgamientos. El valor predeterminado esfalse.- Si especificas el campo
serviceAccountApproverSettingscon un valor, ese parámetro de configuración se aplicará a tu recurso. - Si especificas el campo
serviceAccountApproverSettings, pero lo dejas vacío, se aplicará la configuración predeterminada a tu recurso. - Si no especificas el campo
serviceAccountApproverSettings, el recurso heredará la configuración del recurso superior.
Si inhabilitas este parámetro de configuración, no se aprobarán los otorgamientos que requieran aprobaciones de cuentas de servicio o identidades de agentes. Si tus derechos solo tienen cuentas de servicio o identidades de agente como aprobadores, esos derechos no son efectivos.
- Si especificas el campo
request.json: Es un archivo que contiene la configuración modificada. Para crear este archivo, obtén la configuración existente, guarda la respuesta en un archivo llamadorequest.jsony, luego, modifícalo para usarlo como el cuerpo de tu solicitud de actualización. Debes incluir la ETAG en el cuerpo para actualizar la versión más reciente de la configuración.
Guarda el siguiente código en un archivo llamado filename.yaml.
emailNotificationSettings: customNotificationBehavior: adminNotifications: grantActivated: NOTIFICATION_MODE_1 grantActivationFailed: DISABLED grantEnded: ENABLED grantExternallyModified: ENABLED approverNotifications: pendingApproval: NOTIFICATION_MODE_2 requesterNotifications: entitlementAssigned: ENABLED grantActivated: ENABLED grantExpired: NOTIFICATION_MODE_3 grantRevoked: ENABLED etag:'"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md"' name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings serviceAccountApproverSettings: enabled: SA_AS_APPROVER
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud alpha pam settings update \ --location=global \ --RESOURCE_TYPE=RESOURCE_ID \ --settings-file FILENAME.yaml
Windows (PowerShell)
gcloud alpha pam settings update ` --location=global ` --RESOURCE_TYPE=RESOURCE_ID ` --settings-file FILENAME.yaml
Windows (cmd.exe)
gcloud alpha pam settings update ^ --location=global ^ --RESOURCE_TYPE=RESOURCE_ID ^ --settings-file FILENAME.yaml
Deberías recibir una respuesta similar a la que figura a continuación:
Parsed [location] resource: RESOURCE_TYPE/RESOURCE_ID/locations/global
Request issued for: [global]
Updated location [global].
createTime: '2025-05-18T10:10:10.101010101Z'
emailNotificationSettings:
customNotificationBehavior:
adminNotifications:
grantActivated: ENABLED
grantActivationFailed: DISABLED
grantEnded: ENABLED
grantExternallyModified: ENABLED
approverNotifications:
pendingApproval: ENABLED
requesterNotifications:
entitlementAssigned: ENABLED
grantActivated: ENABLED
grantExpired: ENABLED
grantRevoked: ENABLED
etag: "ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md1"
name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings
serviceAccountApproverSettings:
enabled: true
updateTime: '2025-05-18T10:10:40.101010101Z'
REST
El método updateSettings de la API de Privileged Access Manager
configura un Privileged Access Manager adicional.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
SCOPE: Es la organización, la carpeta o el proyecto para el que deseas actualizar la configuración, en el formatoorganizations/ORGANIZATION_ID,folders/FOLDER_IDoprojects/PROJECT_ID. Los IDs de proyecto son cadenas alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012.UPDATED_FIELDS: Es una lista separada por comas de los campos que se deben actualizar en la configuración. Por ejemplo,emailNotificationSettings,serviceAccountApproverSettingsPara actualizar todos los campos que se pueden modificar, establece la máscara de actualización en
*.SA_AS_APPROVER: Es un valor booleano en el camposerviceAccountApproverSettingsque indica si las cuentas de servicio y las identidades de los agentes pueden aprobar otorgamientos. El valor predeterminado esfalse.- Si especificas el campo
serviceAccountApproverSettingscon un valor, ese parámetro de configuración se aplicará a tu recurso. - Si especificas el campo
serviceAccountApproverSettings, pero lo dejas vacío, se aplicará la configuración predeterminada a tu recurso. - Si no especificas el campo
serviceAccountApproverSettings, el recurso heredará la configuración del recurso superior.
Si inhabilitas este parámetro de configuración, no se aprobarán los otorgamientos que requieran aprobaciones de cuentas de servicio o identidades de agentes. Si tus derechos solo tienen cuentas de servicio o identidades de agente como aprobadores, esos derechos no son efectivos.
- Si especificas el campo
request.json: Es un archivo que contiene la configuración modificada. Para crear este archivo, obtén la configuración existente, guarda la respuesta en un archivo llamadorequest.jsony, luego, modifícalo para usarlo como el cuerpo de tu solicitud de actualización. Debes incluir la ETAG en el cuerpo para actualizar la versión más reciente de la configuración.
Método HTTP y URL:
PATCH https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings?updateMask=UPDATED_FIELDS
Cuerpo JSON de la solicitud:
{
"emailNotificationSettings": {
"customNotificationBehavior": {
"adminNotifications": {
"grantActivated": "NOTIFICATION_MODE_1",
"grantActivationFailed": "DISABLED",
"grantEnded": "ENABLED",
"grantExternallyModified": "ENABLED"
},
"approverNotifications": {
"pendingApproval": "NOTIFICATION_MODE_2"
},
"requesterNotifications": {
"entitlementAssigned": "ENABLED",
"grantActivated": "ENABLED",
"grantExpired": "NOTIFICATION_MODE_3",
"grantRevoked": "ENABLED"
}
}
},
"etag": "\"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md\"",
"name": "SCOPE/locations/global/settings",
"serviceAccountApproverSettings": {
"enabled": SA_AS_APPROVER
}
}
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "SCOPE/locations/global/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.privilegedaccessmanager.v1beta.OperationMetadata",
"createTime": "2024-03-25T01:55:02.544562950Z",
"target": "SCOPE/locations/global/settings",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v1beta"
},
"done": false
}
Para verificar el progreso de una operación de actualización, puedes enviar una
solicitud GET al siguiente extremo:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID
Envía una solicitud GET al siguiente extremo para enumerar todas las
operaciones:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations
Terraform
Puedes usar Terraform para establecer la configuración de Privileged Access Manager. Para obtener más información, consulta google_privileged_access_manager_settings en la documentación de Terraform.
Personaliza las preferencias de notificación
Console
Ve a la página Privileged Access Manager.
Selecciona la organización, la carpeta o el proyecto.
Haz clic en la pestaña Configuración.
En la sección Notificaciones, la opción Heredar del elemento superior está seleccionada de forma predeterminada.
En la siguiente tabla, se muestran las preferencias de notificación predeterminadas:
Evento Administrador Solicitante Responsable de aprobación Derecho asignado - ✓ - El otorgamiento requiere aprobación - - ✓ Se activaron los otorgamientos ✓ ✓ - Se rechazan los otorgamientos - ✓ - Las concesiones vencieron - ✓ - Finalizaron los otorgamientos ✓ ✓ - Se revocan los otorgamientos - ✓ - Los otorgamientos se modifican de forma externa ✓ ✓ - No se pudo completar la activación de los otorgamientos ✓ ✓ - Para anular la herencia de la configuración del elemento superior, activa el botón de activación Enviar notificaciones para los siguientes eventos.
Para inhabilitar las notificaciones del evento y el rol de PAM requeridos, desmarca las casillas de verificación correspondientes y haz clic en Guardar.
Para inhabilitar todas las notificaciones, desmarca Enviar notificaciones para los siguientes eventos y haz clic en Guardar.
gcloud
El comando
gcloud alpha pam settings update
configura un Privileged Access Manager adicional.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
RESOURCE_TYPE: Opcional Es el tipo de recurso para el que deseas actualizar la configuración. Usa el valororganization,folderoproject.RESOURCE_ID: Se usa conRESOURCE_TYPE. Es el ID del proyecto, la carpeta o la organización de Google Cloud para el que deseas administrar los derechos. Los IDs de proyecto son cadenas alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012.NOTIFICATION_MODE: En el campoemailNotificationSettings, usaENABLEDpara enviar notificaciones por correo electrónico del evento oDISABLEDpara evitarlas.- Si especificas el campo
emailNotificationSettingscon un valor, ese parámetro de configuración se aplicará a tu recurso. - Si especificas el campo
emailNotificationSettings, pero lo dejas vacío, se aplicará la configuración predeterminada a tu recurso. - Si no especificas el campo
emailNotificationSettings, el recurso heredará la configuración del recurso superior.
- Si especificas el campo
request.json: Es un archivo que contiene la configuración modificada. Para crear este archivo, obtén la configuración existente, guarda la respuesta en un archivo llamadorequest.jsony, luego, modifícalo para usarlo como el cuerpo de tu solicitud de actualización. Debes incluir la ETAG en el cuerpo para actualizar la versión más reciente de la configuración.
Guarda el siguiente código en un archivo llamado filename.yaml.
emailNotificationSettings: customNotificationBehavior: adminNotifications: grantActivated: NOTIFICATION_MODE_1 grantActivationFailed: DISABLED grantEnded: ENABLED grantExternallyModified: ENABLED approverNotifications: pendingApproval: NOTIFICATION_MODE_2 requesterNotifications: entitlementAssigned: ENABLED grantActivated: ENABLED grantExpired: NOTIFICATION_MODE_3 grantRevoked: ENABLED etag:'"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md"' name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings serviceAccountApproverSettings: enabled: SA_AS_APPROVER
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud alpha pam settings update \ --location=global \ --RESOURCE_TYPE=RESOURCE_ID \ --settings-file FILENAME.yaml
Windows (PowerShell)
gcloud alpha pam settings update ` --location=global ` --RESOURCE_TYPE=RESOURCE_ID ` --settings-file FILENAME.yaml
Windows (cmd.exe)
gcloud alpha pam settings update ^ --location=global ^ --RESOURCE_TYPE=RESOURCE_ID ^ --settings-file FILENAME.yaml
Deberías recibir una respuesta similar a la que figura a continuación:
Parsed [location] resource: RESOURCE_TYPE/RESOURCE_ID/locations/global
Request issued for: [global]
Updated location [global].
createTime: '2025-05-18T10:10:10.101010101Z'
emailNotificationSettings:
customNotificationBehavior:
adminNotifications:
grantActivated: ENABLED
grantActivationFailed: DISABLED
grantEnded: ENABLED
grantExternallyModified: ENABLED
approverNotifications:
pendingApproval: ENABLED
requesterNotifications:
entitlementAssigned: ENABLED
grantActivated: ENABLED
grantExpired: ENABLED
grantRevoked: ENABLED
etag: "ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md1"
name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings
serviceAccountApproverSettings:
enabled: true
updateTime: '2025-05-18T10:10:40.101010101Z'
REST
El método updateSettings de la API de Privileged Access Manager
configura un Privileged Access Manager adicional.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
SCOPE: Es la organización, la carpeta o el proyecto para el que deseas actualizar la configuración, en el formatoorganizations/ORGANIZATION_ID,folders/FOLDER_IDoprojects/PROJECT_ID. Los IDs de proyecto son cadenas alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012.UPDATED_FIELDS: Es una lista separada por comas de los campos que se deben actualizar en la configuración. Por ejemplo,emailNotificationSettings,serviceAccountApproverSettingsPara actualizar todos los campos que se pueden modificar, establece la máscara de actualización en
*.NOTIFICATION_MODE: En el campoemailNotificationSettings, usaENABLEDpara enviar notificaciones por correo electrónico del evento oDISABLEDpara evitarlas.- Si especificas el campo
emailNotificationSettingscon un valor, ese parámetro de configuración se aplicará a tu recurso. - Si especificas el campo
emailNotificationSettings, pero lo dejas vacío, se aplicará la configuración predeterminada a tu recurso. - Si no especificas el campo
emailNotificationSettings, el recurso heredará la configuración del recurso superior.
- Si especificas el campo
request.json: Es un archivo que contiene la configuración modificada. Para crear este archivo, obtén la configuración existente, guarda la respuesta en un archivo llamadorequest.jsony, luego, modifícalo para usarlo como el cuerpo de tu solicitud de actualización. Debes incluir la ETAG en el cuerpo para actualizar la versión más reciente de la configuración.
Método HTTP y URL:
PATCH https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings?updateMask=UPDATED_FIELDS
Cuerpo JSON de la solicitud:
{
"emailNotificationSettings": {
"customNotificationBehavior": {
"adminNotifications": {
"grantActivated": "NOTIFICATION_MODE_1",
"grantActivationFailed": "DISABLED",
"grantEnded": "ENABLED",
"grantExternallyModified": "ENABLED"
},
"approverNotifications": {
"pendingApproval": "NOTIFICATION_MODE_2"
},
"requesterNotifications": {
"entitlementAssigned": "ENABLED",
"grantActivated": "ENABLED",
"grantExpired": "NOTIFICATION_MODE_3",
"grantRevoked": "ENABLED"
}
}
},
"etag": "\"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md\"",
"name": "SCOPE/locations/global/settings",
"serviceAccountApproverSettings": {
"enabled": SA_AS_APPROVER
}
}
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "SCOPE/locations/global/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.privilegedaccessmanager.v1beta.OperationMetadata",
"createTime": "2024-03-25T01:55:02.544562950Z",
"target": "SCOPE/locations/global/settings",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v1beta"
},
"done": false
}
Para verificar el progreso de una operación de actualización, puedes enviar una
solicitud GET al siguiente extremo:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID
Envía una solicitud GET al siguiente extremo para enumerar todas las
operaciones:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations
Terraform
Puedes usar Terraform para establecer la configuración de Privileged Access Manager. Para obtener más información, consulta google_privileged_access_manager_settings en la documentación de Terraform.