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
Vai alla pagina Privileged Access Manager.
Seleziona l'organizzazione, la cartella o il progetto.
Fai clic sulla scheda Impostazioni. Nella sezione Origine impostazioni, l'opzione Eredita dall'elemento principale è selezionata per impostazione predefinita.
Per eseguire l'override delle impostazioni ereditate dalla risorsa padre su una risorsa figlio, nella sezione Approvazioni automatiche, seleziona Esegui l'override dell'ereditarietà.
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 valoreorganization,folderoproject.RESOURCE_ID: utilizzato conRESOURCE_TYPE. L'ID del progetto, della cartella o dell'organizzazione Google Cloudper cui vuoi gestire i diritti. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012.SA_AS_APPROVER: un valore booleano nel camposerviceAccountApproverSettingsche indica se i service account e le identità degli agenti sono autorizzati ad approvare le concessioni. Il valore predefinito èfalse.- Se specifichi il campo
serviceAccountApproverSettingscon un valore, l'impostazione viene applicata alla risorsa. - Se specifichi il campo
serviceAccountApproverSettingsma 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.
- Se specifichi il campo
request.json: un file contenente le impostazioni modificate. Per creare questo file, recupera le impostazioni esistenti, salva la risposta in un file denominatorequest.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 formatoorganizations/ORGANIZATION_ID,folders/FOLDER_IDoprojects/PROJECT_ID. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012.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 camposerviceAccountApproverSettingsche indica se i service account e le identità degli agenti sono autorizzati ad approvare le concessioni. Il valore predefinito èfalse.- Se specifichi il campo
serviceAccountApproverSettingscon un valore, l'impostazione viene applicata alla risorsa. - Se specifichi il campo
serviceAccountApproverSettingsma 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.
- Se specifichi il campo
request.json: un file contenente le impostazioni modificate. Per creare questo file, recupera le impostazioni esistenti, salva la risposta in un file denominatorequest.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
Vai alla pagina Privileged Access Manager.
Seleziona l'organizzazione, la cartella o il progetto.
Fai clic sulla scheda Impostazioni.
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 ✓ ✓ - Per eseguire l'override dell'ereditarietà delle impostazioni dall'elemento principale, attiva l'opzione Invia notifiche per i seguenti eventi.
Per disattivare le notifiche per l'evento e la persona PAM richiesti, deseleziona le caselle di controllo corrispondenti e fai clic su Salva.
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 valoreorganization,folderoproject.RESOURCE_ID: utilizzato conRESOURCE_TYPE. L'ID del progetto, della cartella o dell'organizzazione Google Cloudper cui vuoi gestire i diritti. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012.NOTIFICATION_MODE: Nel campoemailNotificationSettings, utilizzaENABLEDper inviare email di notifica per l'evento oDISABLEDper impedirne l'invio.- Se specifichi il campo
emailNotificationSettingscon un valore, l'impostazione viene applicata alla risorsa. - Se specifichi il campo
emailNotificationSettingsma 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.
- Se specifichi il campo
request.json: un file contenente le impostazioni modificate. Per creare questo file, recupera le impostazioni esistenti, salva la risposta in un file denominatorequest.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 formatoorganizations/ORGANIZATION_ID,folders/FOLDER_IDoprojects/PROJECT_ID. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012.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 campoemailNotificationSettings, utilizzaENABLEDper inviare email di notifica per l'evento oDISABLEDper impedirne l'invio.- Se specifichi il campo
emailNotificationSettingscon un valore, l'impostazione viene applicata alla risorsa. - Se specifichi il campo
emailNotificationSettingsma 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.
- Se specifichi il campo
request.json: un file contenente le impostazioni modificate. Per creare questo file, recupera le impostazioni esistenti, salva la risposta in un file denominatorequest.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.