Privileged Access Manager-Einstellungen konfigurieren

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

  1. Rufen Sie die Seite Privileged Access Manager auf.

    Privileged Access Manager aufrufen

  2. Wählen Sie die Organisation, den Ordner oder das Projekt aus.

  3. Klicken Sie auf den Tab Einstellungen. Im Bereich Quelle der Einstellungen ist standardmäßig Von übergeordneter Organisationseinheit übernehmen ausgewählt.

  4. 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.

  5. 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 Wert organization, folder oder project.
  • RESOURCE_ID: Wird mit RESOURCE_TYPE verwendet. 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, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
  • SA_AS_APPROVER: Ein boolescher Wert im Feld serviceAccountApproverSettings, der angibt, ob Dienstkonten und Agent-Identitäten Genehmigungen erteilen dürfen. Der Standardwert ist false.
    • Wenn Sie für das Feld serviceAccountApproverSettings einen Wert angeben, wird diese Einstellung auf Ihre Ressource angewendet.
    • Wenn Sie das Feld serviceAccountApproverSettings angeben, aber leer lassen, werden die Standardeinstellungen auf Ihre Ressource angewendet.
    • Wenn Sie das Feld serviceAccountApproverSettings gar 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.

  • 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 Datei request.json und ä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 Format organizations/ORGANIZATION_ID, folders/FOLDER_ID oder projects/PROJECT_ID. Projekt-IDs sind alphanumerische Strings, wie my-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 Feld serviceAccountApproverSettings, der angibt, ob Dienstkonten und Agent-Identitäten Genehmigungen erteilen dürfen. Der Standardwert ist false.
    • Wenn Sie für das Feld serviceAccountApproverSettings einen Wert angeben, wird diese Einstellung auf Ihre Ressource angewendet.
    • Wenn Sie das Feld serviceAccountApproverSettings angeben, aber leer lassen, werden die Standardeinstellungen auf Ihre Ressource angewendet.
    • Wenn Sie das Feld serviceAccountApproverSettings gar 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.

  • 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 Datei request.json und ä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

  1. Rufen Sie die Seite Privileged Access Manager auf.

    Privileged Access Manager aufrufen

  2. Wählen Sie die Organisation, den Ordner oder das Projekt aus.

  3. Klicken Sie auf den Tab Einstellungen.

  4. 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 ✓ ✓ -
  5. Wenn Sie die Übernahme der Einstellungen vom übergeordneten Element überschreiben möchten, aktivieren Sie die Option Benachrichtigungen für folgende Ereignisse senden.

  6. 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.

  7. 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 Wert organization, folder oder project.
  • RESOURCE_ID: Wird mit RESOURCE_TYPE verwendet. 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, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
  • NOTIFICATION_MODE: Verwenden Sie im Feld emailNotificationSettings den Wert ENABLED, um E‑Mail-Benachrichtigungen für das Ereignis zu senden, oder DISABLED, um dies zu verhindern.
    • Wenn Sie für das Feld emailNotificationSettings einen Wert angeben, wird diese Einstellung auf Ihre Ressource angewendet.
    • Wenn Sie das Feld emailNotificationSettings angeben, aber leer lassen, werden die Standardeinstellungen auf Ihre Ressource angewendet.
    • Wenn Sie das Feld emailNotificationSettings gar nicht angeben, übernimmt Ihre Ressource die Einstellungen der übergeordneten Ressource.
  • 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 Datei request.json und ä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 Format organizations/ORGANIZATION_ID, folders/FOLDER_ID oder projects/PROJECT_ID. Projekt-IDs sind alphanumerische Strings, wie my-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 Feld emailNotificationSettings den Wert ENABLED, um E-Mail-Benachrichtigungen für das Ereignis zu senden, oder DISABLED, um dies zu verhindern.
    • Wenn Sie für das Feld emailNotificationSettings einen Wert angeben, wird diese Einstellung auf Ihre Ressource angewendet.
    • Wenn Sie das Feld emailNotificationSettings angeben, aber leer lassen, werden die Standardeinstellungen auf Ihre Ressource angewendet.
    • Wenn Sie das Feld emailNotificationSettings gar nicht angeben, übernimmt Ihre Ressource die Einstellungen der übergeordneten Ressource.
  • 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 Datei request.json und ä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.

Nächste Schritte