Visualizzare ed esportare le impostazioni di Privileged Access Manager

In qualità di visualizzatore delle impostazioni di Privileged Access Manager, puoi visualizzare le impostazioni di Privileged Access Manager per un'organizzazione, una cartella o un progetto. Puoi anche esportare le impostazioni in modo programmatico utilizzando Google Cloud CLI.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per visualizzare le impostazioni di Privileged Access Manager, chiedi all'amministratore di concederti i seguenti ruoli IAM nell'organizzazione, nella cartella o nel progetto:

  • Per visualizzare le impostazioni: PAM Settings Viewer (roles/privilegedaccessmanager.settingsViewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per visualizzare le impostazioni di Privileged Access Manager. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le impostazioni di Privileged Access Manager sono necessarie le seguenti autorizzazioni:

  • Per visualizzare le impostazioni:
    • privilegedaccessmanager.settings.get
    • privilegedaccessmanager.settings.fetchEffective

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Visualizza impostazioni

Console

  1. Vai alla pagina Privileged Access Manager.

    Vai a Privileged Access Manager

  2. Seleziona l'organizzazione, la cartella o il progetto per cui vuoi visualizzare le impostazioni di Privileged Access Manager.

  3. Fai clic sulla scheda Impostazioni.

La pagina Impostazioni mostra i dettagli delle impostazioni di Privileged Access Manager per la risorsa selezionata.

gcloud

Puoi visualizzare le seguenti impostazioni per una risorsa:

  • Impostazioni individuali impostate direttamente sulla risorsa.

  • Impostazioni effettive impostate sulla risorsa o ereditate dalla risorsa padre.

    Visualizzare le impostazioni individuali per una risorsa

    Il comando gcloud alpha pam settings describe visualizza le impostazioni di Privileged Access Manager.

    Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

    • RESOURCE_TYPE: (Facoltativo) Il tipo di risorsa per cui vuoi recuperare le impostazioni. Utilizza il valore organization, folder o project.
    • RESOURCE_ID: Utilizzato con RESOURCE_TYPE. L'ID del Cloud de Confiance progetto, della cartella o dell'organizzazione per cui vuoi gestire i diritti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Esegui questo comando:

    Linux, macOS o Cloud Shell

    gcloud alpha pam settings describe \
    --location=global \
    -- RESOURCE_TYPE=RESOURCE_ID \

    Windows (PowerShell)

    gcloud alpha pam settings describe `
    --location=global `
    -- RESOURCE_TYPE=RESOURCE_ID `

    Windows (cmd.exe)

    gcloud alpha pam settings describe ^
    --location=global ^
    -- RESOURCE_TYPE=RESOURCE_ID ^

    Dovresti ricevere una risposta simile alla seguente:

    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: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings
serviceAccountApproverSettings:
  enabled: true
updateTime: '2025-05-18T10:10:10.101010101Z'

    Visualizzare le impostazioni effettive di una risorsa

    Il comando gcloud alpha pam settings describe-effective visualizza le impostazioni di Privileged Access Manager.

    Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

    • RESOURCE_TYPE: (Facoltativo) Il tipo di risorsa per cui vuoi recuperare le impostazioni. Utilizza il valore organization, folder o project.
    • RESOURCE_ID: Utilizzato con RESOURCE_TYPE. L'ID del Cloud de Confiance progetto, della cartella o dell'organizzazione per cui vuoi gestire i diritti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Esegui questo comando:

    Linux, macOS o Cloud Shell

    gcloud alpha pam settings describe-effective \
    --location=global \
    --RESOURCE_TYPE=RESOURCE_ID \

    Windows (PowerShell)

    gcloud alpha pam settings describe-effective `
    --location=global `
    --RESOURCE_TYPE=RESOURCE_ID `

    Windows (cmd.exe)

    gcloud alpha pam settings describe-effective ^
    --location=global ^
    --RESOURCE_TYPE=RESOURCE_ID ^

    Dovresti ricevere una risposta simile alla seguente:

    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: RESOURCE_TYPE/RESOURCE_ID/locations/global
serviceAccountApproverSettings: {}

REST

Puoi visualizzare le seguenti impostazioni per una risorsa:

  • Impostazioni individuali impostate direttamente sulla risorsa.

  • Impostazioni effettive impostate sulla risorsa o ereditate dalla risorsa padre.

    Visualizzare le impostazioni individuali per una risorsa

    Il metodo getSettings dell'API Privileged Access Manager visualizza le impostazioni di Privileged Access Manager.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • SCOPE: l'organizzazione, la cartella o il progetto per cui vuoi recuperare le impostazioni, nel formato organizations/ORGANIZATION_ID, folders/FOLDER_ID o projects/PROJECT_ID. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Metodo HTTP e URL: 

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

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    
{
  "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"
}

    Visualizzare le impostazioni effettive di una risorsa

    Il metodo fetchEffectiveSettings dell'API Privileged Access Manager visualizza le impostazioni di Privileged Access Manager.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • SCOPE: l'organizzazione, la cartella o il progetto per cui vuoi recuperare le impostazioni, nel formato organizations/ORGANIZATION_ID, folders/FOLDER_ID o projects/PROJECT_ID. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Metodo HTTP e URL: 

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

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    {
  "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": {}
}

Esportare le impostazioni in modo programmatico utilizzando gcloud CLI

Il comando gcloud alpha pam settings export recupera ed esporta le impostazioni per una risorsa specifica.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • FILENAME: il nome del file in cui esportare i contenuti delle impostazioni.
  • RESOURCE_TYPE: (Facoltativo) Il tipo di risorsa a cui appartiene la risorsa corrispondente. Utilizza il valore organization, folder o project.
  • RESOURCE_ID: Utilizzato con RESOURCE_TYPE. L'ID del Cloud de Confiance progetto, della cartella o dell'organizzazione per cui vuoi gestire i diritti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud alpha pam settings export \
    --destination=FILENAME.yaml \
    --location=global \
    -- RESOURCE_TYPE=RESOURCE_ID

Windows (PowerShell)

gcloud alpha pam settings export `
    --destination=FILENAME.yaml `
    --location=global `
    -- RESOURCE_TYPE=RESOURCE_ID

Windows (cmd.exe)

gcloud alpha pam settings export ^
    --destination=FILENAME.yaml ^
    --location=global ^
    -- RESOURCE_TYPE=RESOURCE_ID

Dovresti ricevere una risposta simile alla seguente:

Exported [RESOURCE_TYPE/RESOURCE_ID/locations/global/settings] to FILENAME.yaml.

Passaggi successivi