Configurare le impostazioni di Privileged Access Manager

Le impostazioni di Privileged Access Manager (PAM) ti consentono di automatizzare i workflow di approvazione e personalizzare le preferenze di notifica via email per organizzazioni, cartelle e progetti. In qualità di amministratore delle impostazioni di Privileged Access Manager, puoi attivare le approvazioni automatiche per designare service account, identità degli agenti e identità nei pool di identità del workload come approvatori idonei per i diritti. Puoi anche disattivare le email a livello di risorsa per eventi e utenti specifici di Privileged Access Manager o disattivare tutte le notifiche. Per impostazione predefinita, le cartelle e i progetti ereditano le impostazioni tramite la gerarchia delle risorse, a meno che non configuri un override.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per configurare le impostazioni di Privileged Access Manager, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Configura le impostazioni per il progetto, la cartella o l'organizzazione: PAM Settings Admin (roles/privilegedaccessmanager.settingsAdmin) sulla tua organizzazione
  • Visualizza le impostazioni per il progetto, la cartella o l'organizzazione: PAM Settings Viewer (roles/privilegedaccessmanager.settingsViewer) sul progetto, sulla cartella o sull'organizzazione

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

Autorizzazioni obbligatorie

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

  • Configura le impostazioni: privilegedaccessmanager.settings.update
  • Impostazioni di visualizzazione:
    • privilegedaccessmanager.settings.get
    • privilegedaccessmanager.settings.fetchEffective

Approvazioni automatiche

Console

  1. Vai alla pagina Privileged Access Manager.

    Vai a Privileged Access Manager

  2. Seleziona l'organizzazione, la cartella o il progetto.

  3. Fai clic sulla scheda Impostazioni. Nella sezione Origine impostazioni, l'opzione Eredita dall'elemento principale è selezionata per impostazione predefinita.

  4. Per eseguire l'override delle impostazioni ereditate dalla risorsa padre su una risorsa figlio, nella sezione Approvazioni automatiche, seleziona Esegui l'override dell'ereditarietà.

  5. Per attivare le approvazioni automatiche, attiva l'opzione Abilita Agent Identity e service account come approvatori e fai clic su Salva.

gcloud

Il comando gcloud alpha pam settings update configura Privileged Access Manager aggiuntivi.

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

  • RESOURCE_TYPE: (Facoltativo) Il tipo di risorsa per cui vuoi aggiornare le impostazioni. Utilizza il valore organization, folder o project.
  • RESOURCE_ID: utilizzato con RESOURCE_TYPE. L'ID del progetto, della cartella o dell'organizzazione Google Cloudper cui vuoi gestire i diritti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • SA_AS_APPROVER: un valore booleano nel campo serviceAccountApproverSettings che indica se i service account e le identità degli agenti sono autorizzati ad approvare le concessioni. Il valore predefinito è false.
    • Se specifichi il campo serviceAccountApproverSettings con un valore, l'impostazione viene applicata alla risorsa.
    • Se specifichi il campo serviceAccountApproverSettings ma lo lasci vuoto, alla risorsa vengono applicate le impostazioni predefinite.
    • Se non specifichi affatto il campo serviceAccountApproverSettings, la risorsa eredita le impostazioni dalla risorsa padre.

    Se disattivi questa impostazione, le concessioni che richiedono approvazioni da service account o identità degli agenti non verranno approvate. Se i tuoi diritti hanno solo service account o identità degli agenti come approvatori, questi diritti non sono validi.

  • request.json: un file contenente le impostazioni modificate. Per creare questo file, recupera le impostazioni esistenti, salva la risposta in un file denominato request.json, quindi modificalo in modo da utilizzarlo come corpo della richiesta di aggiornamento. Devi includere l'ETAG nel corpo per aggiornare l'ultima versione delle impostazioni.

Salva i seguenti contenuti in un file denominato 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

Esegui questo comando:

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

Dovresti ricevere una risposta simile alla seguente:

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

Il metodo updateSettings dell'API Privileged Access Manager configura un Privileged Access Manager aggiuntivo.

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

  • SCOPE: l'organizzazione, la cartella o il progetto di cui vuoi aggiornare 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 ID organizzazione sono numerici, ad esempio 123456789012.
  • UPDATED_FIELDS: un elenco separato da virgole dei campi che devono essere aggiornati nelle impostazioni. Ad esempio, emailNotificationSettings,serviceAccountApproverSettings.

    Per aggiornare tutti i campi che possono essere modificati, imposta la maschera di aggiornamento su *.

  • SA_AS_APPROVER: un valore booleano nel campo serviceAccountApproverSettings che indica se i service account e le identità degli agenti sono autorizzati ad approvare le concessioni. Il valore predefinito è false.
    • Se specifichi il campo serviceAccountApproverSettings con un valore, l'impostazione viene applicata alla risorsa.
    • Se specifichi il campo serviceAccountApproverSettings ma lo lasci vuoto, alla risorsa vengono applicate le impostazioni predefinite.
    • Se non specifichi affatto il campo serviceAccountApproverSettings, la risorsa eredita le impostazioni dalla risorsa padre.

    Se disattivi questa impostazione, le concessioni che richiedono approvazioni da parte di service account o identità degli agenti non verranno approvate. Se i tuoi diritti hanno solo service account o identità degli agenti come approvatori, questi diritti non sono validi.

  • request.json: un file contenente le impostazioni modificate. Per creare questo file, recupera le impostazioni esistenti, salva la risposta in un file denominato request.json, quindi modificalo in modo da utilizzarlo come corpo della richiesta di aggiornamento. Devi includere l'ETAG nel corpo per aggiornare l'ultima versione delle impostazioni.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:


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


Per controllare l'avanzamento di un'operazione di aggiornamento, puoi inviare una richiesta GET al seguente endpoint:

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

Invia una richiesta GET al seguente endpoint per elencare tutte le operazioni:

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

Terraform

Puoi utilizzare Terraform per configurare le impostazioni di Privileged Access Manager. Per saperne di più, consulta google_privileged_access_manager_settings nella documentazione di Terraform.

Personalizza le preferenze di notifica

Console

  1. Vai alla pagina Privileged Access Manager.

    Vai a Privileged Access Manager

  2. Seleziona l'organizzazione, la cartella o il progetto.

  3. Fai clic sulla scheda Impostazioni.

  4. Nella sezione Notifiche, l'opzione Eredita dall'elemento principale è selezionata per impostazione predefinita.

    La tabella seguente mostra le preferenze di notifica predefinite:

    Evento Amministratore Richiedente Approvatore
    Diritto assegnato - ✓ -
    La concessione richiede l'approvazione - - ✓
    Le concessioni sono attivate ✓ ✓ -
    Concessioni negate - ✓ -
    Le concessioni sono scadute - ✓ -
    Concessioni terminate ✓ ✓ -
    Concessioni revocate - ✓ -
    Le concessioni vengono modificate esternamente ✓ ✓ -
    Attivazione delle concessioni non riuscita ✓ ✓ -
  5. Per eseguire l'override dell'ereditarietà delle impostazioni dall'elemento principale, attiva l'opzione Invia notifiche per i seguenti eventi.

  6. Per disattivare le notifiche per l'evento e la persona PAM richiesti, deseleziona le caselle di controllo corrispondenti e fai clic su Salva.

  7. Per disattivare tutte le notifiche, deseleziona Invia notifiche per i seguenti eventi e fai clic su Salva.

gcloud

Il comando gcloud alpha pam settings update configura Privileged Access Manager aggiuntivi.

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

  • RESOURCE_TYPE: (Facoltativo) Il tipo di risorsa per cui vuoi aggiornare le impostazioni. Utilizza il valore organization, folder o project.
  • RESOURCE_ID: utilizzato con RESOURCE_TYPE. L'ID del progetto, della cartella o dell'organizzazione Google Cloudper cui vuoi gestire i diritti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • NOTIFICATION_MODE: Nel campo emailNotificationSettings, utilizza ENABLED per inviare email di notifica per l'evento o DISABLED per impedirne l'invio.
    • Se specifichi il campo emailNotificationSettings con un valore, l'impostazione viene applicata alla risorsa.
    • Se specifichi il campo emailNotificationSettings ma lo lasci vuoto, alla risorsa vengono applicate le impostazioni predefinite.
    • Se non specifichi affatto il campo emailNotificationSettings, la risorsa eredita le impostazioni dalla risorsa padre.
  • request.json: un file contenente le impostazioni modificate. Per creare questo file, recupera le impostazioni esistenti, salva la risposta in un file denominato request.json, quindi modificalo in modo da utilizzarlo come corpo della richiesta di aggiornamento. Devi includere l'ETAG nel corpo per aggiornare l'ultima versione delle impostazioni.

Salva i seguenti contenuti in un file denominato 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

Esegui questo comando:

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

Dovresti ricevere una risposta simile alla seguente:

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

Il metodo updateSettings dell'API Privileged Access Manager configura un Privileged Access Manager aggiuntivo.

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

  • SCOPE: l'organizzazione, la cartella o il progetto di cui vuoi aggiornare 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 ID organizzazione sono numerici, ad esempio 123456789012.
  • UPDATED_FIELDS: un elenco separato da virgole dei campi che devono essere aggiornati nelle impostazioni. Ad esempio, emailNotificationSettings,serviceAccountApproverSettings.

    Per aggiornare tutti i campi che possono essere modificati, imposta la maschera di aggiornamento su *.

  • NOTIFICATION_MODE: Nel campo emailNotificationSettings, utilizza ENABLED per inviare email di notifica per l'evento o DISABLED per impedirne l'invio.
    • Se specifichi il campo emailNotificationSettings con un valore, l'impostazione viene applicata alla risorsa.
    • Se specifichi il campo emailNotificationSettings ma lo lasci vuoto, alla risorsa vengono applicate le impostazioni predefinite.
    • Se non specifichi affatto il campo emailNotificationSettings, la risorsa eredita le impostazioni dalla risorsa padre.
  • request.json: un file contenente le impostazioni modificate. Per creare questo file, recupera le impostazioni esistenti, salva la risposta in un file denominato request.json, quindi modificalo in modo da utilizzarlo come corpo della richiesta di aggiornamento. Devi includere l'ETAG nel corpo per aggiornare l'ultima versione delle impostazioni.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:


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


Per controllare l'avanzamento di un'operazione di aggiornamento, puoi inviare una richiesta GET al seguente endpoint:

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

Invia una richiesta GET al seguente endpoint per elencare tutte le operazioni:

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

Terraform

Puoi utilizzare Terraform per configurare le impostazioni di Privileged Access Manager. Per saperne di più, consulta google_privileged_access_manager_settings nella documentazione di Terraform.

Passaggi successivi