Configura los parámetros de configuración de Privileged Access Manager

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:

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

  1. Ve a la página Privileged Access Manager.

    Ir a Privileged Access Manager

  2. Selecciona la organización, la carpeta o el proyecto.

  3. 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.

  4. Para anular la configuración heredada del recurso superior en un recurso secundario, en la sección Aprobaciones automáticas, selecciona Anular herencia.

  5. 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 valor organization, folder o project.
  • RESOURCE_ID: Se usa con RESOURCE_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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • SA_AS_APPROVER: Es un valor booleano en el campo serviceAccountApproverSettings que indica si las cuentas de servicio y las identidades de los agentes pueden aprobar otorgamientos. El valor predeterminado es false.
    • Si especificas el campo serviceAccountApproverSettings con 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.

  • 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 llamado request.json y, 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 formato organizations/ORGANIZATION_ID, folders/FOLDER_ID o projects/PROJECT_ID. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • UPDATED_FIELDS: Es una lista separada por comas de los campos que se deben actualizar en la configuración. Por ejemplo, emailNotificationSettings,serviceAccountApproverSettings

    Para 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 campo serviceAccountApproverSettings que indica si las cuentas de servicio y las identidades de los agentes pueden aprobar otorgamientos. El valor predeterminado es false.
    • Si especificas el campo serviceAccountApproverSettings con 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.

  • 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 llamado request.json y, 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

  1. Ve a la página Privileged Access Manager.

    Ir a Privileged Access Manager

  2. Selecciona la organización, la carpeta o el proyecto.

  3. Haz clic en la pestaña Configuración.

  4. 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 ✓ ✓ -
  5. Para anular la herencia de la configuración del elemento superior, activa el botón de activación Enviar notificaciones para los siguientes eventos.

  6. Para inhabilitar las notificaciones del evento y el rol de PAM requeridos, desmarca las casillas de verificación correspondientes y haz clic en Guardar.

  7. 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 valor organization, folder o project.
  • RESOURCE_ID: Se usa con RESOURCE_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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • NOTIFICATION_MODE: En el campo emailNotificationSettings, usa ENABLED para enviar notificaciones por correo electrónico del evento o DISABLED para evitarlas.
    • Si especificas el campo emailNotificationSettings con 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.
  • 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 llamado request.json y, 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 formato organizations/ORGANIZATION_ID, folders/FOLDER_ID o projects/PROJECT_ID. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • UPDATED_FIELDS: Es una lista separada por comas de los campos que se deben actualizar en la configuración. Por ejemplo, emailNotificationSettings,serviceAccountApproverSettings

    Para actualizar todos los campos que se pueden modificar, establece la máscara de actualización en *.

  • NOTIFICATION_MODE: En el campo emailNotificationSettings, usa ENABLED para enviar notificaciones por correo electrónico del evento o DISABLED para evitarlas.
    • Si especificas el campo emailNotificationSettings con 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.
  • 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 llamado request.json y, 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.

¿Qué sigue?