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 ulteriori informazioni 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 Google Cloud 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 Google Cloud 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 seguenti sostituzioni:

    • 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 seguenti sostituzioni:

    • 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 Google Cloud 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