Configurar as configurações do Privileged Access Manager

As configurações do Privileged Access Manager (PAM) permitem automatizar fluxos de trabalho de aprovação e personalizar as preferências de notificação por e-mail em organizações, pastas e projetos. Como administrador de configurações do Privileged Access Manager, é possível ativar aprovações automáticas para designar contas de serviço, identidades de agentes e identidades em pools de Identidade da carga de trabalho como aprovadores qualificados para direitos. Também é possível desativar os e-mails em todo o recurso para eventos e personas específicos do Privileged Access Manager ou desativar todas as notificações. As pastas e os projetos herdam as configurações pela hierarquia de recursos por padrão, a menos que você configure uma substituição.

Antes de começar

Para receber as permissões necessárias para definir as configurações do Privileged Access Manager, peça ao administrador que conceda a você os seguintes papéis do IAM:

Esses papéis predefinidos contêm as permissões necessárias para definir as configurações do Privileged Access Manager. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para definir as configurações do Privileged Access Manager:

  • Defina as configurações: privilegedaccessmanager.settings.update
  • Configurações de visualização:
    • privilegedaccessmanager.settings.get
    • privilegedaccessmanager.settings.fetchEffective

Aprovações automatizadas

Console

  1. Acesse a página Privileged Access Manager.

    Acessar o Privileged Access Manager

  2. Selecione a organização, a pasta ou o projeto.

  3. Clique na guia Configurações. Na seção Origem das configurações, a opção Herdar da organização mãe é selecionada por padrão.

  4. Para substituir as configurações herdadas do recurso pai em um recurso filho, na seção Aprovações automáticas, selecione Substituir herança.

  5. Para ativar as aprovações automatizadas, ative o botão Ativar a identidade do agente e a conta de serviço como aprovadores e clique em Salvar.

gcloud

O comando gcloud alpha pam settings update configura mais recursos do Privileged Access Manager.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • RESOURCE_TYPE: opcional. O tipo de recurso em que você quer atualizar as configurações. Use o valor organization, folder ou project.
  • RESOURCE_ID: usada com RESOURCE_TYPE. O ID do projeto, da pasta ou da organização do Google Cloudem que você quer gerenciar os direitos de acesso. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e IDs da organização são numéricos, como 123456789012.
  • SA_AS_APPROVER: um valor booleano no campo serviceAccountApproverSettings que indica se as contas de serviço e as identidades de agente podem aprovar concessões. O valor padrão é false.
    • Se você especificar o campo serviceAccountApproverSettings com um valor, essa configuração será aplicada ao recurso.
    • Se você especificar o campo serviceAccountApproverSettings, mas deixá-lo vazio, as configurações padrão serão aplicadas ao recurso.
    • Se você não especificar o campo serviceAccountApproverSettings, o recurso vai herdar as configurações do recurso pai.

    Se você desativar essa configuração, as concessões que exigem aprovações de contas de serviço ou identidades de agente não serão aprovadas. Se os direitos tiverem apenas contas de serviço ou identidades de agente como aprovadores, eles não serão válidos.

  • request.json: um arquivo que contém as configurações modificadas. Para criar esse arquivo, peça as configurações atuais, salve a resposta em um arquivo chamado request.json e modifique-a para usar como o corpo da solicitação de atualização. É necessário incluir a ETAG no corpo para atualizar a versão mais recente das configurações.

Salve o conteúdo a seguir em um arquivo chamado 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

Execute o seguinte comando:

Linux, macOS ou 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

Você receberá uma resposta semelhante a esta:

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

O método updateSettings da API Privileged Access Manager configura um Privileged Access Manager adicional.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • SCOPE: a organização, a pasta ou o projeto com as configurações que você quer atualizar, no formato de organizations/ORGANIZATION_ID, folders/FOLDER_ID ou projects/PROJECT_ID. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e IDs da organização são numéricos, como 123456789012.
  • UPDATED_FIELDS: uma lista separada por vírgulas de campos que precisam ser atualizados nas configurações. Por exemplo, emailNotificationSettings,serviceAccountApproverSettings.

    Para atualizar todos os campos que podem ser modificados, defina a máscara de atualização como *.

  • SA_AS_APPROVER: um valor booleano no campo serviceAccountApproverSettings que indica se as contas de serviço e as identidades de agente podem aprovar concessões. O valor padrão é false.
    • Se você especificar o campo serviceAccountApproverSettings com um valor, essa configuração será aplicada ao recurso.
    • Se você especificar o campo serviceAccountApproverSettings, mas deixá-lo vazio, as configurações padrão serão aplicadas ao recurso.
    • Se você não especificar o campo serviceAccountApproverSettings, o recurso vai herdar as configurações do recurso pai.

    Se você desativar essa configuração, as concessões que exigem aprovações de contas de serviço ou identidades de agente não serão aprovadas. Se os direitos tiverem apenas contas de serviço ou identidades de agente como aprovadores, eles não serão válidos.

  • request.json: um arquivo que contém as configurações modificadas. Para criar esse arquivo, peça as configurações atuais, salve a resposta em um arquivo chamado request.json e modifique-a para usar como o corpo da solicitação de atualização. É necessário incluir a ETAG no corpo para atualizar a versão mais recente das configurações.

Método HTTP e URL:

PATCH https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings?updateMask=UPDATED_FIELDS

Corpo JSON da solicitação:

{
  "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 a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:


{
  "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 o progresso de uma operação de atualização, envie uma solicitação GET para o seguinte endpoint:

https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID

Envie uma solicitação GET para o endpoint a seguir e liste todas as operações:

https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations

Terraform

Use o Terraform para definir as configurações do Privileged Access Manager. Para mais informações, consulte google_privileged_access_manager_settings na documentação do Terraform.

Personalizar as preferências de notificação

Console

  1. Acesse a página Privileged Access Manager.

    Acessar o Privileged Access Manager

  2. Selecione a organização, a pasta ou o projeto.

  3. Clique na guia Configurações.

  4. Na seção Notificações, a opção Herdar do pai é selecionada por padrão.

    A tabela a seguir mostra as preferências de notificação padrão:

    Evento Administrador Solicitante Aprovador
    Direito atribuído - ✓ -
    A concessão requer aprovação - - ✓
    As concessões são ativadas ✓ ✓ -
    As concessões são negadas - ✓ -
    As concessões expiraram - ✓ -
    As concessões terminaram ✓ ✓ -
    As concessões foram revogadas - ✓ -
    As concessões são modificadas externamente ✓ ✓ -
    Falha na ativação das concessões ✓ ✓ -
  5. Para substituir a herança de configurações do pai, ative o botão Enviar notificações para os seguintes eventos.

  6. Para desativar as notificações do evento e da persona do PAM necessários, desmarque as caixas de seleção correspondentes e clique em Salvar.

  7. Para desativar todas as notificações, desmarque Enviar notificações para os seguintes eventos e clique em Salvar.

gcloud

O comando gcloud alpha pam settings update configura mais recursos do Privileged Access Manager.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • RESOURCE_TYPE: opcional. O tipo de recurso em que você quer atualizar as configurações. Use o valor organization, folder ou project.
  • RESOURCE_ID: usada com RESOURCE_TYPE. O ID do projeto, da pasta ou da organização do Google Cloudem que você quer gerenciar os direitos de acesso. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e IDs da organização são numéricos, como 123456789012.
  • NOTIFICATION_MODE: No campo emailNotificationSettings, use ENABLED para enviar e-mails de notificação do evento ou DISABLED para impedir o envio.
    • Se você especificar o campo emailNotificationSettings com um valor, essa configuração será aplicada ao recurso.
    • Se você especificar o campo emailNotificationSettings, mas deixá-lo vazio, as configurações padrão serão aplicadas ao recurso.
    • Se você não especificar o campo emailNotificationSettings, o recurso vai herdar as configurações do recurso pai.
  • request.json: um arquivo que contém as configurações modificadas. Para criar esse arquivo, peça as configurações atuais, salve a resposta em um arquivo chamado request.json e modifique-a para usar como o corpo da solicitação de atualização. É necessário incluir a ETAG no corpo para atualizar a versão mais recente das configurações.

Salve o conteúdo a seguir em um arquivo chamado 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

Execute o seguinte comando:

Linux, macOS ou 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

Você receberá uma resposta semelhante a esta:

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

O método updateSettings da API Privileged Access Manager configura um Privileged Access Manager adicional.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • SCOPE: a organização, a pasta ou o projeto com as configurações que você quer atualizar, no formato de organizations/ORGANIZATION_ID, folders/FOLDER_ID ou projects/PROJECT_ID. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e IDs da organização são numéricos, como 123456789012.
  • UPDATED_FIELDS: uma lista separada por vírgulas de campos que precisam ser atualizados nas configurações. Por exemplo, emailNotificationSettings,serviceAccountApproverSettings.

    Para atualizar todos os campos que podem ser modificados, defina a máscara de atualização como *.

  • NOTIFICATION_MODE: No campo emailNotificationSettings, use ENABLED para enviar e-mails de notificação do evento ou DISABLED para impedir o envio.
    • Se você especificar o campo emailNotificationSettings com um valor, essa configuração será aplicada ao recurso.
    • Se você especificar o campo emailNotificationSettings, mas deixá-lo vazio, as configurações padrão serão aplicadas ao recurso.
    • Se você não especificar o campo emailNotificationSettings, o recurso vai herdar as configurações do recurso pai.
  • request.json: um arquivo que contém as configurações modificadas. Para criar esse arquivo, peça as configurações atuais, salve a resposta em um arquivo chamado request.json e modifique-a para usar como o corpo da solicitação de atualização. É necessário incluir a ETAG no corpo para atualizar a versão mais recente das configurações.

Método HTTP e URL:

PATCH https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings?updateMask=UPDATED_FIELDS

Corpo JSON da solicitação:

{
  "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 a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:


{
  "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 o progresso de uma operação de atualização, envie uma solicitação GET para o seguinte endpoint:

https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID

Envie uma solicitação GET para o endpoint a seguir e liste todas as operações:

https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations

Terraform

Use o Terraform para definir as configurações do Privileged Access Manager. Para mais informações, consulte google_privileged_access_manager_settings na documentação do Terraform.

A seguir