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:
-
Defina as configurações do projeto, da pasta ou da organização:
Administrador de configurações do PAM (
roles/privilegedaccessmanager.settingsAdmin) na organização -
Ver as configurações do projeto, da pasta ou da organização:
Leitor de configurações do PAM (
roles/privilegedaccessmanager.settingsViewer) no projeto, na pasta ou na organização
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
Acesse a página Privileged Access Manager.
Selecione a organização, a pasta ou o projeto.
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.
Para substituir as configurações herdadas do recurso pai em um recurso filho, na seção Aprovações automáticas, selecione Substituir herança.
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 valororganization,folderouproject.RESOURCE_ID: usada comRESOURCE_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, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012.SA_AS_APPROVER: um valor booleano no camposerviceAccountApproverSettingsque 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
serviceAccountApproverSettingscom 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.
- Se você especificar o campo
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 chamadorequest.jsone 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 deorganizations/ORGANIZATION_ID,folders/FOLDER_IDouprojects/PROJECT_ID. Os IDs do projeto são strings alfanuméricas, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012.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 camposerviceAccountApproverSettingsque 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
serviceAccountApproverSettingscom 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.
- Se você especificar o campo
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 chamadorequest.jsone 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
Acesse a página Privileged Access Manager.
Selecione a organização, a pasta ou o projeto.
Clique na guia Configurações.
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 ✓ ✓ - Para substituir a herança de configurações do pai, ative o botão Enviar notificações para os seguintes eventos.
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.
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 valororganization,folderouproject.RESOURCE_ID: usada comRESOURCE_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, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012.NOTIFICATION_MODE: No campoemailNotificationSettings, useENABLEDpara enviar e-mails de notificação do evento ouDISABLEDpara impedir o envio.- Se você especificar o campo
emailNotificationSettingscom 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.
- Se você especificar o campo
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 chamadorequest.jsone 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 deorganizations/ORGANIZATION_ID,folders/FOLDER_IDouprojects/PROJECT_ID. Os IDs do projeto são strings alfanuméricas, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012.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 campoemailNotificationSettings, useENABLEDpara enviar e-mails de notificação do evento ouDISABLEDpara impedir o envio.- Se você especificar o campo
emailNotificationSettingscom 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.
- Se você especificar o campo
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 chamadorequest.jsone 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.