Mit den Einstellungen für Privileged Access Manager (PAM) können Sie Genehmigungsworkflows automatisieren und die Einstellungen für E‑Mail-Benachrichtigungen für Organisationen, Ordner und Projekte anpassen. Als Administrator für Privileged Access Manager-Einstellungen können Sie automatisierte Genehmigungen aktivieren, um Dienstkonten, Agentenidentitäten und Identitäten in Workload Identity-Pools als berechtigte Genehmiger für Berechtigungen festzulegen. Sie können auch ressourcenweite E‑Mails für bestimmte Privileged Access Manager-Ereignisse und ‑Personas deaktivieren oder alle Benachrichtigungen deaktivieren. Ordner und Projekte übernehmen standardmäßig Einstellungen über die Ressourcenhierarchie, sofern Sie keine Überschreibung konfigurieren.
Hinweis
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren der Privileged Access Manager-Einstellungen benötigen:
-
Einstellungen für Ihr Projekt, Ihren Ordner oder Ihre Organisation konfigurieren: PAM Settings Admin (
roles/privilegedaccessmanager.settingsAdmin) für Ihre Organisation -
Einstellungen für Ihr Projekt, Ihren Ordner oder Ihre Organisation ansehen: PAM Settings Viewer (
roles/privilegedaccessmanager.settingsViewer) für Ihr Projekt, Ihren Ordner oder Ihre Organisation
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Konfigurieren von Privileged Access Manager-Einstellungen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Privileged Access Manager-Einstellungen zu konfigurieren:
-
Einstellungen konfigurieren:
privilegedaccessmanager.settings.update -
Einstellungen aufrufen:
-
privilegedaccessmanager.settings.get -
privilegedaccessmanager.settings.fetchEffective
-
Automatisierte Genehmigungen
Console
Rufen Sie die Seite Privileged Access Manager auf.
Wählen Sie die Organisation, den Ordner oder das Projekt aus.
Klicken Sie auf den Tab Einstellungen. Im Bereich Quelle der Einstellungen ist standardmäßig Von übergeordneter Organisationseinheit übernehmen ausgewählt.
Wenn Sie die von der übergeordneten Ressource übernommenen Einstellungen für eine untergeordnete Ressource überschreiben möchten, wählen Sie im Abschnitt Automatische Genehmigungen die Option Übernahme überschreiben aus.
Wenn Sie automatische Genehmigungen aktivieren möchten, aktivieren Sie die Option KI-Agenten-Identität und Dienstkonto als Genehmiger aktivieren und klicken Sie auf Speichern.
gcloud
Mit dem Befehl gcloud alpha pam settings update werden zusätzliche Privileged Access Manager-Einstellungen konfiguriert.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
RESOURCE_TYPE: Optional. Der Ressourcentyp, für den Sie die Einstellungen aktualisieren möchten. Verwenden Sie den Wertorganization,folderoderproject.RESOURCE_ID: Wird mitRESOURCE_TYPEverwendet. Die ID des Projekts, Ordners oder der Organisation in Google Cloud, für das bzw. die Sie Berechtigungen verwalten möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012.SA_AS_APPROVER: Ein boolescher Wert im FeldserviceAccountApproverSettings, der angibt, ob Dienstkonten und Agent-Identitäten Genehmigungen erteilen dürfen. Der Standardwert istfalse.- Wenn Sie für das Feld
serviceAccountApproverSettingseinen Wert angeben, wird diese Einstellung auf Ihre Ressource angewendet. - Wenn Sie das Feld
serviceAccountApproverSettingsangeben, aber leer lassen, werden die Standardeinstellungen auf Ihre Ressource angewendet. - Wenn Sie das Feld
serviceAccountApproverSettingsgar nicht angeben, übernimmt Ihre Ressource die Einstellungen der übergeordneten Ressource.
Wenn Sie diese Einstellung deaktivieren, werden die Erteilungen, die Genehmigungen von Dienstkonten oder KI-Agenten erfordern, nicht genehmigt. Wenn Ihre Berechtigungen nur Dienstkonten oder KI-Agenten-Identitäten als Genehmiger haben, sind diese Berechtigungen nicht wirksam.
- Wenn Sie für das Feld
request.json: Eine Datei mit den geänderten Einstellungen. Um diese Datei zu erstellen, rufen Sie die vorhandenen Einstellungen ab, speichern Sie die Antwort in der Dateirequest.jsonund ändern Sie sie dann so, dass sie als Text der Aktualisierungsanfrage verwendet werden kann. Sie müssen den ETAG im Text angeben, um die aktuelle Version der Einstellungen zu aktualisieren.
Speichern Sie den folgenden Inhalt in einer Datei mit dem Namen 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
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
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
Mit der Methode updateSettings der Privileged Access Manager API wird ein zusätzlicher Privileged Access Manager konfiguriert.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
SCOPE: Die Organisation, der Ordner oder das Projekt, für die bzw. den Sie die Einstellungen aktualisieren möchten, im Formatorganizations/ORGANIZATION_ID,folders/FOLDER_IDoderprojects/PROJECT_ID. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012.UPDATED_FIELDS: Eine durch Kommas getrennte Liste von Feldern, die in den Einstellungen aktualisiert werden müssen. Beispiel:emailNotificationSettings,serviceAccountApproverSettings.Wenn Sie alle Felder aktualisieren möchten, die geändert werden können, legen Sie die Aktualisierungsmaske auf
*fest.SA_AS_APPROVER: Ein boolescher Wert im FeldserviceAccountApproverSettings, der angibt, ob Dienstkonten und Agent-Identitäten Genehmigungen erteilen dürfen. Der Standardwert istfalse.- Wenn Sie für das Feld
serviceAccountApproverSettingseinen Wert angeben, wird diese Einstellung auf Ihre Ressource angewendet. - Wenn Sie das Feld
serviceAccountApproverSettingsangeben, aber leer lassen, werden die Standardeinstellungen auf Ihre Ressource angewendet. - Wenn Sie das Feld
serviceAccountApproverSettingsgar nicht angeben, übernimmt Ihre Ressource die Einstellungen der übergeordneten Ressource.
Wenn Sie diese Einstellung deaktivieren, werden die Gewährungen, für die Genehmigungen von Dienstkonten oder KI-Agenten-Identitäten erforderlich sind, nicht genehmigt. Wenn Ihre Berechtigungen nur Dienstkonten oder KI-Agenten-Identitäten als Genehmiger haben, sind diese Berechtigungen nicht wirksam.
- Wenn Sie für das Feld
request.json: Eine Datei mit den geänderten Einstellungen. Um diese Datei zu erstellen, rufen Sie die vorhandenen Einstellungen ab, speichern Sie die Antwort in der Dateirequest.jsonund ändern Sie sie dann so, dass sie als Text der Aktualisierungsanfrage verwendet werden kann. Sie müssen den ETAG im Text angeben, um die aktuelle Version der Einstellungen zu aktualisieren.
HTTP-Methode und URL:
PATCH https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings?updateMask=UPDATED_FIELDS
JSON-Text anfordern:
{
"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
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{
"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
}
Wenn Sie den Fortschritt eines Aktualisierungsvorgangs prüfen möchten, können Sie eine GET-Anfrage an den folgenden Endpunkt senden:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID
Senden Sie eine GET-Anfrage an den folgenden Endpunkt, um alle Vorgänge aufzulisten:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations
Terraform
Sie können Terraform verwenden, um Privileged Access Manager-Einstellungen zu konfigurieren. Weitere Informationen finden Sie in der Terraform-Dokumentation unter google_privileged_access_manager_settings.
Benachrichtigungseinstellungen anpassen
Console
Rufen Sie die Seite Privileged Access Manager auf.
Wählen Sie die Organisation, den Ordner oder das Projekt aus.
Klicken Sie auf den Tab Einstellungen.
Im Bereich Benachrichtigungen ist standardmäßig Von übergeordnetem Element übernehmen ausgewählt.
In der folgenden Tabelle sind die Standardeinstellungen für Benachrichtigungen aufgeführt:
Ereignis Admin Anforderer Genehmiger Berechtigung zugewiesen - ✓ - Erteilung erfordert Genehmigung - - ✓ Erteilungen sind aktiviert ✓ ✓ - Erteilungen werden abgelehnt - ✓ - Erteilungen sind abgelaufen - ✓ - Erteilungen beendet ✓ ✓ - Erteilungen werden widerrufen - ✓ - Erteilungen werden extern geändert ✓ ✓ - Aktivierung der Erteilung fehlgeschlagen ✓ ✓ - Wenn Sie die Übernahme der Einstellungen vom übergeordneten Element überschreiben möchten, aktivieren Sie die Option Benachrichtigungen für folgende Ereignisse senden.
Wenn Sie Benachrichtigungen für das erforderliche PAM-Ereignis und die erforderliche Persona deaktivieren möchten, entfernen Sie die entsprechenden Häkchen und klicken Sie auf Speichern.
Wenn Sie alle Benachrichtigungen deaktivieren möchten, entfernen Sie das Häkchen bei Benachrichtigungen für folgende Ereignisse senden und klicken Sie auf Speichern.
gcloud
Mit dem Befehl gcloud alpha pam settings update werden zusätzliche Privileged Access Manager-Einstellungen konfiguriert.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
RESOURCE_TYPE: Optional. Der Ressourcentyp, für den Sie die Einstellungen aktualisieren möchten. Verwenden Sie den Wertorganization,folderoderproject.RESOURCE_ID: Wird mitRESOURCE_TYPEverwendet. Die ID des Projekts, Ordners oder der Organisation in Google Cloud, für das bzw. die Sie Berechtigungen verwalten möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012.NOTIFICATION_MODE: Verwenden Sie im FeldemailNotificationSettingsden WertENABLED, um E‑Mail-Benachrichtigungen für das Ereignis zu senden, oderDISABLED, um dies zu verhindern.- Wenn Sie für das Feld
emailNotificationSettingseinen Wert angeben, wird diese Einstellung auf Ihre Ressource angewendet. - Wenn Sie das Feld
emailNotificationSettingsangeben, aber leer lassen, werden die Standardeinstellungen auf Ihre Ressource angewendet. - Wenn Sie das Feld
emailNotificationSettingsgar nicht angeben, übernimmt Ihre Ressource die Einstellungen der übergeordneten Ressource.
- Wenn Sie für das Feld
request.json: Eine Datei mit den geänderten Einstellungen. Um diese Datei zu erstellen, rufen Sie die vorhandenen Einstellungen ab, speichern Sie die Antwort in der Dateirequest.jsonund ändern Sie sie dann so, dass sie als Text der Aktualisierungsanfrage verwendet werden kann. Sie müssen den ETAG im Text angeben, um die aktuelle Version der Einstellungen zu aktualisieren.
Speichern Sie den folgenden Inhalt in einer Datei mit dem Namen 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
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
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
Mit der Methode updateSettings der Privileged Access Manager API wird ein zusätzlicher Privileged Access Manager konfiguriert.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
SCOPE: Die Organisation, der Ordner oder das Projekt, für die bzw. den Sie die Einstellungen aktualisieren möchten, im Formatorganizations/ORGANIZATION_ID,folders/FOLDER_IDoderprojects/PROJECT_ID. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012.UPDATED_FIELDS: Eine durch Kommas getrennte Liste von Feldern, die in den Einstellungen aktualisiert werden müssen. Beispiel:emailNotificationSettings,serviceAccountApproverSettings.Wenn Sie alle Felder aktualisieren möchten, die geändert werden können, legen Sie die Aktualisierungsmaske auf
*fest.NOTIFICATION_MODE: Verwenden Sie im FeldemailNotificationSettingsden WertENABLED, um E-Mail-Benachrichtigungen für das Ereignis zu senden, oderDISABLED, um dies zu verhindern.- Wenn Sie für das Feld
emailNotificationSettingseinen Wert angeben, wird diese Einstellung auf Ihre Ressource angewendet. - Wenn Sie das Feld
emailNotificationSettingsangeben, aber leer lassen, werden die Standardeinstellungen auf Ihre Ressource angewendet. - Wenn Sie das Feld
emailNotificationSettingsgar nicht angeben, übernimmt Ihre Ressource die Einstellungen der übergeordneten Ressource.
- Wenn Sie für das Feld
request.json: Eine Datei mit den geänderten Einstellungen. Um diese Datei zu erstellen, rufen Sie die vorhandenen Einstellungen ab, speichern Sie die Antwort in der Dateirequest.jsonund ändern Sie sie dann so, dass sie als Text der Aktualisierungsanfrage verwendet werden kann. Sie müssen den ETAG im Text angeben, um die aktuelle Version der Einstellungen zu aktualisieren.
HTTP-Methode und URL:
PATCH https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings?updateMask=UPDATED_FIELDS
JSON-Text anfordern:
{
"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
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{
"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
}
Wenn Sie den Fortschritt eines Aktualisierungsvorgangs prüfen möchten, können Sie eine GET-Anfrage an den folgenden Endpunkt senden:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID
Senden Sie eine GET-Anfrage an den folgenden Endpunkt, um alle Vorgänge aufzulisten:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations
Terraform
Sie können Terraform verwenden, um Privileged Access Manager-Einstellungen zu konfigurieren. Weitere Informationen finden Sie in der Terraform-Dokumentation unter google_privileged_access_manager_settings.