Conferir as configurações do Privileged Access Manager

Como leitor de configurações do Privileged Access Manager, você pode conferir as configurações do Privileged Access Manager de uma organização, pasta ou projeto.

Antes de começar

Para receber as permissões necessárias para visualizar as configurações do Privileged Access Manager, peça ao administrador para conceder a você os seguintes papéis do IAM na organização, pasta ou projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para visualizar 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 acessar as configurações do Privileged Access Manager:

  • Para conferir as configurações:
    • privilegedaccessmanager.settings.get
    • privilegedaccessmanager.settings.fetchEffective

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Ver configurações

Console

  1. Acesse a página Privileged Access Manager.

    Acessar o Privileged Access Manager

  2. Selecione a organização, a pasta ou o projeto em que você quer ver as configurações do Privileged Access Manager.

  3. Clique na guia Configurações.

A página Configurações mostra os detalhes das configurações do Privileged Access Manager para o recurso selecionado.

REST

Você pode conferir as seguintes configurações de um recurso:

  • Configurações individuais definidas diretamente no recurso.

  • Configurações efetivas definidas no recurso ou herdadas do recurso pai.

    Ver configurações individuais de um recurso

    O método getSettings da API Privileged Access Manager mostra as configurações do Privileged Access Manager.

    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 para o qual você quer recuperar as configurações, 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 códigos de pastas e organizações são numéricos, como 123456789012.

    Método HTTP e URL: 

    GET https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

    
{
  "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": "\"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md\"",
  "name": "SCOPE/locations/global/settings",
  "serviceAccountApproverSettings": {
    "enabled": true
  },
  "updateTime": "2025-05-18T10:10:10.101010101Z"
}

    Ver configurações efetivas em um recurso

    O método fetchEffectiveSettings da API Privileged Access Manager mostra as configurações do Privileged Access Manager.

    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 para o qual você quer recuperar as configurações, 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 códigos de pastas e organizações são numéricos, como 123456789012.

    Método HTTP e URL: 

    GET https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global:effectiveSettings

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

    {
  "emailNotificationSettings": {
    "customNotificationBehavior": {
      "adminNotifications": {
        "notifyGrantActivated": "true",
        "notifyGrantActivationFailed": "true",
        "notifyGrantEnded": "true",
        "notifyGrantExternallyModified": "true"
      },
      "approverNotifications": {
        "notifyPendingApproval": "true"
      },
      "requesterNotifications": {
        "notifyEntitlementAssigned": "true",
        "notifyEntitlementUpdated": "true",
        "notifyGrantActivated": "true",
        "notifyGrantActivationFailed": "true",
        "notifyGrantEnded": "true",
        "notifyGrantExpired": "true",
        "notifyGrantExternallyModified": "true",
        "notifyGrantRevoked": "true"
      }
    }
  },
  "parent": "SCOPE/locations/global",
  "serviceAccountApproverSettings": {}
}

A seguir