Principal Access Boundary-Richtlinien

Mit PAB-Richtlinien (Principal Access Boundary) können Sie die Ressourcen definieren, auf die Hauptkonten zugreifen können.

Andere zugriffsbezogene Richtlinien wie Zulassungs- und Ablehnungsrichtlinien sind an Ressourcen angehängt. Diese Richtlinien legen fest, wer auf die Ressource zugreifen darf, an die sie angehängt sind. Im Gegensatz dazu sind Principal Access Boundary-Richtlinien an Hauptkontogruppen angehängt und steuern, was die Hauptkonten in der Hauptkontogruppe tun dürfen.

Mit Principal Access Boundary-Richtlinien können Sie beispielsweise verhindern, dass Ihre Hauptkonten auf Ressourcen in anderen Organisationen zugreifen. So können Sie Phishing-Angriffe oder Daten-Exfiltration verhindern.

Funktionsweise von Principal Access Boundary-Richtlinien

Standardmäßig sind Hauptkonten berechtigt, auf alle Google Cloud -Ressourcen zuzugreifen. Das bedeutet, dass ein Hauptkonto auf eine Ressource zugreifen kann, wenn eine Zulassungsrichtlinie dem Hauptkonto Zugriff auf eine Ressource gewährt und keine Ablehnungsrichtlinien diesen Zugriff blockieren.

Mit Principal Access Boundary-Richtlinien können Sie die Ressourcen definieren, auf die ein Hauptkonto zugreifen darf. Wenn ein Hauptkonto nicht berechtigt ist, auf eine Ressource zuzugreifen, ist sein Zugriff auf diese Ressource eingeschränkt, unabhängig von den ihm zugewiesenen Rollen. Weitere Informationen dazu, wie Sie mit Principal Access Boundary-Richtlinien die Ressourcen definieren, auf die ein Hauptkonto zugreifen darf, finden Sie unter Zulässige Ressourcen definieren.

Principal Access Boundary-Richtlinien blockieren nur Zugriffsversuche, die unterstützte Berechtigungen betreffen. Wenn eine Principal Access Boundary-Richtlinie eine Berechtigung nicht blockieren kann, können Hauptkonten diese Berechtigung verwenden, um auf jede Ressource zuzugreifen, unabhängig von den Richtlinien, denen sie unterliegen. Weitere Informationen finden Sie unter Berechtigungen, die von Principal Access Boundary-Richtlinien blockiert werden können.

Anwendungsfälle

Principal Access Boundary-Richtlinien sind in folgenden Fällen nützlich:

  • Verhindern, dass Hauptkonten auf Ressourcen zugreifen, die Ihnen nicht gehören
  • Bestimmte Hauptkontotypen wie Dienstkonten auf bestimmte Projekte beschränken

Detaillierte Beispiele für die Verwendung von Principal Access Boundary-Richtlinien in solchen Situationen finden Sie unter Beispielanwendungsfälle für Principal Access Boundary-Richtlinien.

Komponenten von Principal Access Boundary-Richtlinien

Principal Access Boundary-Richtlinien bestehen aus einzelnen Regeln. In jeder Regel wird eine Reihe von Ressourcen definiert, auf die Hauptkonten zugreifen dürfen. Jede Richtlinie kann bis zu 500 Regeln enthalten.

Richtlinien enthalten auch andere Informationen, einschließlich Metadaten und Konfigurationsdetails. Weitere Informationen finden Sie unter Struktur einer Principal Access Boundary-Richtlinie.

Nachdem Sie eine Principal Access Boundary-Richtlinie erstellt haben, wenden Sie diese Richtlinie auf Hauptkontogruppen an, indem Sie Richtlinienbindungen erstellen. Alle Hauptkonten in diesen Hauptkontensätzen unterliegen dann dieser Principal Access Boundary-Richtlinie. Das bedeutet, dass sie auf die in der Richtlinie aufgeführten Ressourcen zugreifen dürfen. Sie können eine Principal Access Boundary-Richtlinie an eine beliebige Anzahl von Hauptkontogruppen binden.

Sie können in Ihrer Organisation bis zu 1.000 Principal Access Boundary-Richtlinien erstellen.

Berechtigungen, die von Principal Access Boundary-Richtlinien blockiert werden

Principal Access Boundary-Richtlinien können alle Berechtigungen blockieren, die in der Erzwingungsversion der Richtlinie enthalten sind. Wenn eine Principal Access Boundary-Richtlinie eine Berechtigung blockieren kann, kann sie verhindern, dass nicht berechtigte Hauptkonten diese Berechtigung für den Zugriff auf Ressourcen verwenden.

Sie geben die Erzwingungsversion einer Richtlinie an, wenn Sie die Richtlinie erstellen. Wenn Sie die Erzwingungsversion aktualisieren, werden die Berechtigungen aktualisiert, die von der Richtlinie blockiert werden können. Eine vollständige Liste der Berechtigungen, die von den einzelnen Erzwingungsversionen blockiert werden, finden Sie in der Referenz zu Erzwingungsversionen.

Wenn eine Principal Access Boundary-Richtlinie eine Berechtigung nicht blockieren kann, hat die Richtlinie keine Auswirkungen darauf, ob Hauptkonten die Berechtigung verwenden können. Mit anderen Worten: IAM kann die Richtlinie für Zugriffsversuche mit dieser Berechtigung nicht erzwingen.

Angenommen, einem Hauptkonto, Lee (lee@example.com), wird die Rolle „Dataflow-Entwickler“ (roles/dataflow.developer) zugewiesen. Diese Rolle enthält die Berechtigung dataflow.googleapis.com/jobs.snapshot, mit der Lee Snapshots von Dataflow-Jobs erstellen kann. Lee unterliegt außerdem einer Principal Access Boundary-Richtlinie, die den Zugriff auf Ressourcen außerhalb von example.com verhindert. Wenn diese Principal Access Boundary-Richtlinie die Berechtigung dataflow.jobs.snapshot jedoch nicht blockieren kann, kann Lee weiterhin Snapshots von Dataflow-Jobs in Organisationen außerhalb von example.com erstellen.

Erzwingungsversionen verwalten

In regelmäßigen Abständen werden in IAM neue Erzwingungsversionen hinzugefügt, die zusätzliche Berechtigungen blockieren können. Jede neue Version kann auch alle Berechtigungen der vorherigen Version blockieren.

Wenn Sie die Berechtigungen in einer neuen Erzwingungsversion blockieren möchten, müssen Sie Ihre Principal Access Boundary-Richtlinien aktualisieren, um die neue Version zu verwenden.

Wenn Sie möchten, dass die Erzwingungsversion einer Richtlinie automatisch aktualisiert wird, wenn neue Versionen veröffentlicht werden, können Sie beim Erstellen der Richtlinie den Wert latest verwenden. Wir empfehlen jedoch nicht, diesen Wert zu verwenden, da dies dazu führen kann, dass Hauptkonten unerwartet den Zugriff auf Ressourcen verlieren.

Richtlinien, die latest für die Versionsnummer verwenden, verwenden die Standarderzwingungsversion. Die Standardversion für die Erzwingung ist in der Regel die neueste Version. Es kann jedoch bis zu vier Wochen dauern, bis eine neue Version zur Standardversion für die Erzwingung wird. Informationen dazu, welche Erzwingungsversion die Standardversion ist, finden Sie in der Referenz zu Erzwingungsversionen.

Die Standardversion für die Erzwingung wird auch für neue Principal Access Boundary-Richtlinien verwendet, für die keine Versionsnummer angegeben ist.

Zulässige Ressourcen definieren

Hauptkonten können von einer beliebigen Anzahl von Principal Access Boundary-Richtlinien betroffen sein oder diesen unterliegen. Zusammen definieren diese Richtlinien die Ressourcen, auf die das Hauptkonto zugreifen darf.

Principal Access Boundary-Richtlinien sind additiv. Das bedeutet, dass die Ressourcen, auf die ein Hauptkonto zugreifen darf, die Vereinigungsmenge aller Ressourcen in allen Principal Access Boundary-Richtlinien sind, denen das Hauptkonto unterliegt. Mit anderen Worten: Wenn eine einzelne Principal Access Boundary-Richtlinie einem Hauptkonto den Zugriff auf eine Ressource ermöglicht, ist es berechtigt, auf die Ressource zuzugreifen, unabhängig von den anderen Principal Access Boundary-Richtlinien, denen es unterliegt.

Wenn für ein Hauptkonto keine Principal Access Boundary-Richtlinien gelten, kann es auf alle Google Cloud -Ressourcen zugreifen.

In den folgenden Abschnitten wird beschrieben, wie Sie die Gruppe von Ressourcen anpassen, auf die ein Hauptkonto zugreifen darf.

Zulässige Ressourcen hinzufügen

Es gibt mehrere Möglichkeiten, einem Hauptkonto Zugriff auf eine Ressource zu gewähren, auf die es nicht zugreifen darf:

Infrage kommende Ressourcen entfernen

Es gibt mehrere Möglichkeiten, einem Hauptkonto den Zugriff auf eine Ressource zu verweigern, auf die es zugreifen darf.

Suchen Sie zuerst alle Principal Access Boundary-Richtlinien, die für das Hauptkonto gelten und die Ressource enthalten. Je nach den gefundenen Richtlinien können Sie dann eine der folgenden Optionen auswählen:

  • Wenn das Hauptkonto keinen Principal Access Boundary-Richtlinien unterliegt, erstellen Sie eine neue Principal Access Boundary-Richtlinie, die nur die Ressourcen enthält, auf die das Hauptkonto zugreifen darf. Binden Sie diese Richtlinie dann an eine Hauptkontogruppe, die das Hauptkonto enthält.

    Nachdem Sie die Richtlinie angewendet haben, kann das Hauptkonto nicht mehr auf alle Ressourcen zugreifen, sondern nur noch auf die in der Richtlinie aufgeführten Ressourcen.

  • Wenn das Hauptkonto bereits einer oder mehreren Principal Access Boundary-Richtlinien unterliegt, müssen Sie dafür sorgen, dass keine der Principal Access Boundary-Richtlinien, denen es unterliegt, die Ressource enthält. Eine detaillierte Anleitung finden Sie unter Ressourcen reduzieren, auf die Hauptkonten zugreifen können.

    Während dieses Vorgangs müssen Sie dafür sorgen, dass das Hauptkonto immer mindestens einer Principal Access Boundary-Richtlinie unterliegt. Andernfalls kann das Hauptkonto möglicherweise auf alle Ressourcen zugreifen.

Principal Access Boundary-Richtlinien und im Cache gespeicherte Ressourcen

Bestimmte Google Cloud -Dienste speichern öffentlich sichtbare Ressourcen im Cache. Cloud Storage speichert beispielsweise öffentlich lesbare Objekte im Cache.

Ob eine Principal Access Boundary-Richtlinie verhindern kann, dass nicht berechtigte Hauptkonten eine öffentlich sichtbare Ressource aufrufen, hängt davon ab, ob die Ressource im Cache gespeichert ist:

  • Wenn die Ressource im Cache gespeichert ist, können Principal Access Boundary-Richtlinien nicht verhindern, dass Hauptkonten die Ressource aufrufen.
  • Wenn die Ressource nicht im Cache gespeichert ist, verhindert die Principal Access Boundary, dass nicht berechtigte Hauptkonten die Ressource aufrufen.

In allen Fällen verhindern Principal Access Boundary-Richtlinien weiterhin, dass nicht berechtigte Hauptkonten öffentlich sichtbare Ressourcen ändern oder löschen.

Google-eigene Ressourcen

Damit Entwickler Google Cloud -Dienste wie BigQuery und Cloud Workstations verwenden können, stellt Google Cloud öffentliche Ressourcen von Google bereit. BigQuery bietet beispielsweise öffentliche Datasets, die Sie in Ihre Anwendungen einbinden können. Diese öffentlichen Ressourcen werden in einer Google-eigenen Organisation (Google Cloud ) mit der ID 433637338589 gehostet. Diese Organisation wird auch zum Verwalten von Mandantenprojekten für Dienste wie Cloud Workstations verwendet.

Hauptkonten, für die Principal Access Boundary-Richtlinien gelten, verlieren den Zugriff auf diese öffentlichen Ressourcen, es sei denn, Sie gewähren ihnen Zugriff auf Ressourcen in der Google-eigenen Organisation.

Damit Hauptkonten auf Ressourcen in der Google-eigenen Organisation zugreifen können, fügen Sie die folgende Regel zu einer Principal Access Boundary-Richtlinie hinzu, die für die Hauptkonten gilt:

{
  "description": "Make principals eligible to access Google-owned public resources",
  "resources": [
    "//cloudresourcemanager.googleapis.com/organizations/433637338589"
  ],
  "effect": "ALLOW"
}

Alternativ können Sie eine neue Principal Access Boundary-Richtlinie mit dieser Regel erstellen und sie an den relevanten Hauptkontosatz binden.

Bewertung von Principal Access Boundary-Richtlinien

Wenn ein Hauptkonto versucht, auf eine Ressource zuzugreifen, wertet IAM die relevanten Principal Access Boundary-Richtlinien aus, um festzustellen, ob der Zugriffsversuch blockiert werden soll. Eine Richtlinie ist relevant, wenn das Hauptkonto, das den Zugriffsversuch unternimmt, der Richtlinie unterliegt.

Principal Access Boundary-Richtlinien können den Zugriff nur blockieren oder nicht blockieren. Sie können keinen Zugriff gewähren. Nur Zulassungsrichtlinien können Hauptkonten tatsächlich Zugriff auf Ressourcen gewähren. Informationen dazu, wie sich verschiedene Richtlinientypen auf den Zugriff von Hauptkonten auf Ressourcen auswirken, finden Sie unter Richtlinientypen.

IAM blockiert den Zugriff nicht, wenn eine der folgenden Bedingungen zutrifft:

  • Das Hauptkonto unterliegt keinen Principal Access Boundary-Richtlinien.
  • Die relevanten Principal Access Boundary-Richtlinien können die Berechtigung in der Anfrage nicht blockieren.
  • Eine Principal Access Boundary-Richtlinie berechtigt das Hauptkonto, auf die Ressource zuzugreifen.

IAM blockiert den Zugriff, wenn das Hauptkonto mindestens einer Principal Access Boundary-Richtlinie unterliegt, aber keine der relevanten Richtlinien dem Hauptkonto den Zugriff auf die Ressource gewährt.

Fail-Closed-Bewertung

Principal Access Boundary-Richtlinien schlagen fehl. Das bedeutet, dass IAM den Zugriff des Hauptkontos auf die Ressource verhindert, wenn bei der Auswertung einer Principal Access Boundary-Richtlinie ein Fehler auftritt.

Der häufigste Grund für einen Fehler bei der Auswertung von Principal Access Boundary-Richtlinien durch IAM ist, dass die Details eines Hauptkontos noch im System propagiert werden. Dies ist am wahrscheinlichsten bei neu erstellten Nutzern der Fall. Um dieses Problem zu beheben, sollte das neue Hauptkonto warten und später noch einmal versuchen, auf die Ressource zuzugreifen.

Principal Access Boundary-Richtlinien auf Hauptkontogruppen anwenden

Wenn Sie eine Principal Access Boundary-Richtlinie auf einen Hauptkontosatz anwenden möchten, erstellen Sie eine Richtlinienbindung, in der sowohl die Principal Access Boundary-Richtlinie, die Sie anwenden möchten, als auch der Hauptkontosatz, auf den Sie sie anwenden möchten, angegeben sind. Durch diese Richtlinienbindung wird die Richtlinie an die Hauptkontogruppe gebunden.

Nachdem Sie eine Richtlinie an einen Hauptkontensatz gebunden haben, können die Hauptkonten in diesem Hauptkontensatz nur auf die Ressourcen zugreifen, die in den Principal Access Boundary-Richtlinien aufgeführt sind, denen sie unterliegen.

Sie können eine Principal Access Boundary-Richtlinie an eine beliebige Anzahl von Hauptkontogruppen binden. An jede Hauptkontogruppe können bis zu zehn Principal Access Boundary-Richtlinien gebunden werden.

Sie können nur Bindungen für vorhandene Principal Access Boundary-Richtlinien erstellen. Der Versuch, eine Bindung für eine gelöschte Principal Access Boundary-Richtlinie zu erstellen, schlägt fehl. Wenn Sie vor Kurzem eine Principal Access Boundary-Richtlinie gelöscht haben, können Sie manchmal eine Bindung erstellen, die jedoch keine Auswirkungen hat. IAM bereinigt diese Bindungen automatisch.

Informationen zum Verwalten von Principal Access Boundary-Richtlinien finden Sie unter Principal Access Boundary-Richtlinien erstellen und anwenden.

Unterstützte Hauptkontogruppen

In der folgenden Tabelle sind die Arten von Hauptkontogruppen aufgeführt, an die Sie Principal Access Boundary-Richtlinien binden können. Jede Zeile enthält Folgendes:

  • Der Typ der Hauptkontogruppe
  • Die Hauptkonten in diesem Typ von Hauptkontogruppe
  • Das Format der IDs für diesen Typ von Hauptkontogruppe
  • Die Resource Manager-Ressource (Projekt, Ordner oder Organisation), die Richtlinienbindungen für diesen Typ von Hauptkontogruppe enthält
Hauptkontogruppe Details Übergeordnete Ressource der Richtlinienbindungen
Mitarbeiteridentitätspool

Enthält alle Identitäten im angegebenen Workforce Identity-Pool.

Format: //iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID

Die Organisation, die den Workforce Identity-Pool enthält
Workload Identity-Pool

Enthält alle Identitäten im angegebenen Workload Identity-Pool.

Format: //iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/WORKLOAD_POOL_ID

Das Projekt, das den Workload Identity-Pool enthält
Google Workspace-Domain

Enthält alle Identitäten in der angegebenen Google Workspace-Domain.

Format: //iam.googleapis.com/locations/global/workspace/CUSTOMER_ID

Sie können Ihre Kundennummer mit den folgenden Methoden ermitteln:

Die Organisation, die mit der Google Workspace-Domain verknüpft ist
Hauptkontogruppe des Projekts

Enthält alle Dienstkonten, Workload Identity-Pools und Agent-Identitäten im angegebenen Projekt.

Format: //cloudresourcemanager.googleapis.com/projects/PROJECT_ID

Das Projekt
Hauptkontogruppe des Ordners

Enthält alle Dienstkonten, alle Workload Identity-Pools und alle Agent-Identitäten in allen Projekten im angegebenen Ordner.

Format: //cloudresourcemanager.googleapis.com/folders/FOLDER_ID

Der Ordner
Hauptkontogruppe der Organisation

Enthält die folgenden Identitäten:

  • Alle Identitäten in allen Domains, die mit Ihrer Google Workspace-Kundennummer verknüpft sind
  • Alle Workforce Identity-Pools in Ihrer Organisation
  • Alle Dienstkonten, Workload Identity-Pools und Agent-Identitäten in allen Projekten der Organisation

Format: //cloudresourcemanager.googleapis.com/organizations/ORGANIZATION_ID

Das Unternehmen
KI-Agentenidentitäten

Alle KI-Agentenidentitäten in der Trust-Domain des angegebenen Projekts. Standardmäßig enthält die Vertrauensdomäne eines Projekts alle Agentenidentitäten im Projekt.

Formate:

  • //agents.global.org-ORGANIZATION_ID.system.id.goog/attribute.container/projects/PROJECT_NUMBER
  • //agents.global.proj-PROJECT_NUMBER.system.id.goog/attribute.container/projects/PROJECT_NUMBER
Das Projekt

Richtlinienübernahme und Hauptkontogruppen

Principal Access Boundary-Richtlinien werden an Hauptkontogruppen angehängt, nicht an Ressourcen. Daher werden sie nicht wie Zulassungs- und Ablehnungsrichtlinien über die Ressourcenhierarchie übernommen.

Hauptkontosätze für Ordner und Organisationen enthalten jedoch immer alle Hauptkonten in den Hauptkontosätzen ihrer untergeordneten Elemente. Wenn ein Hauptkonto beispielsweise im Hauptkontosatz eines Projekts enthalten ist, ist es auch in den Hauptkontosätzen aller übergeordneten Ordner oder Organisationen enthalten.

Beispiel: Eine Organisation, example.com. Diese Organisation ist mit der Domain example.com verknüpft und hat die folgenden Ressourcen:

Ressourcenhierarchie für example.com

Ressourcenhierarchie für example.com

  • Eine Organisation, example.com
  • Ein Projekt, project-1, das ein untergeordnetes Element der Organisation ist
  • Ein Ordner, folder-a, der ein untergeordnetes Element der Organisation ist
  • Zwei Projekte, project-2 und project-3, die folder-a untergeordnet sind

Die Hauptkontensätze dieser Ressourcen enthalten die folgenden Identitäten:

Hauptkontogruppe Google Workspace-Identitäten in der Domain example.com Pools von Mitarbeiteridentitätsföderation in example.com Dienstkonten, Workload Identity-Pools und Agent-Identitäten in project-1 Dienstkonten, Workload Identity-Pools und Agent-Identitäten in project-2 Dienstkonten, Workload Identity-Pools und Agent-Identitäten in project-3
Hauptkonto für example.com festgelegt
Hauptkonto für folder-a festgelegt
Hauptkonto für project-1 festgelegt
Hauptkonto für project-2 festgelegt
Hauptkonto für project-3 festgelegt

Daher sind die folgenden Hauptkonten von den folgenden Principal Access Boundary-Richtlinien betroffen:

  • Eine Google Workspace-Identität in der Domain example.com befindet sich in der Hauptkontogruppe für example.com und ist von Principal Access Boundary-Richtlinien betroffen, die an diese Hauptkontogruppe gebunden sind.

  • Ein Dienstkonto in project-1 befindet sich in den Hauptkontogruppen für project-1 und example.com und ist von Principal Access Boundary-Richtlinien betroffen, die an eine dieser Hauptkontogruppen gebunden sind.

  • Eine Agentenidentität in project-3 befindet sich in den Hauptkontogruppen für project-3, folder-a und example.com und ist von Principal Access Boundary-Richtlinien betroffen, die an eine dieser Hauptkontogruppen gebunden sind.

Bedingte Richtlinienbindungen für Principal Access Boundary-Richtlinien

Sie können Bedingungsausdrücke in Richtlinienbindungen für Principal Access Boundary-Richtlinien verwenden, um weiter einzugrenzen, für welche Hauptkonten die Richtlinie gilt.

Bedingungsausdrücke für Richtlinienbindungen bestehen aus einer oder mehreren Anweisungen, die durch bis zu 10 logische Operatoren (&&, || oder !) verbunden sind. Jede Anweisung drückt eine attributbasierte Kontrollregel aus, die für die Richtlinienbindung gilt und letztendlich bestimmt, ob die Richtlinie angewendet wird.

Sie können die Attribute principal.type und principal.subject in Bedingungen für Richtlinienbindungen verwenden. Andere Attribute werden nicht unterstützt.

  • Das Attribut principal.type bezieht sich auf den Typ des Hauptkontos, das die Anfrage gestellt hat, z. B. ein Dienstkonto oder eine Agentenidentität. Sie können Bedingungen mit diesem Attribut verwenden, um zu steuern, für welche Typen von Hauptkonten eine Principal Access Boundary-Richtlinie gilt.

    Wenn Sie beispielsweise den folgenden Bedingungsausdruck zu einer Bindung für eine Principal Access Boundary-Richtlinie hinzufügen, gilt die Richtlinie nur für Dienstkonten:

    principal.type == 'iam.googleapis.com/ServiceAccount'
    
  • Das Attribut principal.subject bezieht sich auf die Identität des Hauptkontos, das die Anfrage gestellt hat, z. B. cruz@example.com. Sie können Bedingungen mit diesem Attribut verwenden, um genau zu steuern, für welche Hauptkonten eine Principal Access Boundary-Richtlinie gilt.

    Wenn Sie beispielsweise den folgenden Bedingungsausdruck zu einer Bindung für eine Principal Access Boundary-Richtlinie hinzufügen, gilt die Richtlinie nicht für den Nutzer special-admin@example.com:

    principal.subject != 'special-admin@example.com'
    

Weitere Informationen zu den Werten, die Sie für diese Bedingungen verwenden können, finden Sie in der Referenz zu Bedingungsattributen.

Ein Beispiel für die Verwendung dieser Bedingungen in Ihren Principal Access Boundary-Richtlinien finden Sie unter Dienstkonten für den Zugriff auf Ressourcen in einem einzelnen Projekt berechtigen.

Organisationsübergreifende Richtlinienbindungen

Sie können keine organisationsübergreifende Richtlinienbindung für eine Principal Access Boundary-Richtlinie erstellen. Eine organisationsübergreifende Richtlinienbindung ist eine Richtlinienbindung, die eine Richtlinie in einer Organisation an einen Hauptkontosatz in einer anderen Organisation bindet.

IAM löscht regelmäßig alle vorhandenen organisationsübergreifenden Richtlinienbindungen. Organisationsübergreifende Richtlinienbindungen können auftreten, wenn Sie ein Projekt von einer Organisation in eine andere verschieben. Betrachten Sie beispielsweise die folgende Situation:

  • Sie haben das Projekt example-project in der Organisation example.com.
  • Hauptkonten in example-project sollen auf Ressourcen in example.com zugreifen können. Dazu erstellen Sie in example.com eine Principal Access Boundary-Richtlinie, die Hauptkonten den Zugriff auf Ressourcen in example.com ermöglicht, und binden diese Richtlinie an den Hauptkontosatz für example-project.
  • Sie verschieben example-project von example.com nach cymbalgroup.com.

In diesem Fall wird durch das Verschieben des Projekts eine organisationsübergreifende Richtlinienbindung erstellt. Das liegt daran, dass die Principal Access Boundary-Richtlinie in example.com an eine Hauptkontogruppe in cymbalgroup.com gebunden ist. Wenn Sie die Bindung nicht manuell löschen, wird sie von IAM irgendwann automatisch gelöscht. Durch das Löschen dieser Bindung wird sichergestellt, dass cymbalgroup.com-Administratoren Zugriff auf alle Principal Access Boundary-Richtlinien haben, die an ihre Hauptkonten gebunden sind.

Struktur einer Principal Access Boundary-Richtlinie

Eine Principal Access Boundary-Richtlinie ist eine Sammlung von Metadaten und Details zur Principal Access Boundary-Richtlinie. Die Metadaten enthalten Informationen wie den Namen der Richtlinie und den Zeitpunkt, zu dem die Richtlinie erstellt wurde. In den Richtliniendetails wird definiert, was die Richtlinie bewirkt, z. B. auf welche Ressourcen die betroffenen Hauptkonten zugreifen dürfen.

Mit der folgenden Principal Access Boundary-Richtlinie können die Hauptkonten, die der Richtlinie unterliegen, beispielsweise auf die Ressourcen in der Organisation mit der ID 0123456789012 zugreifen.

{
  "name": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
  "displayName": "Example policy",
  "annotations": {
    "example-key": "example-value"
  },
  "createTime": "2024-01-02T15:01:23Z",
  "updateTime": "2024-01-02T15:01:23Z",
  "details": {
    "rules": [
      {
        "description": "Example principal access boundary policy rule",
        "resources": [
          "//cloudresourcemanager.googleapis.com/organizations/0123456789012"
        ],
        "effect": "ALLOW"
      }
    ],
    "enforcementVersion": "4"
  }
}

In den folgenden Abschnitten werden die Felder in den Metadaten und Details einer Principal Access Boundary-Richtlinie beschrieben.

Metadaten

Principal Access Boundary-Richtlinien enthalten die folgenden Metadaten:

  • name: Der Name der Principal Access Boundary-Richtlinie. Dieser Name hat das Format organizations/ORGANIZATION_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID, wobei ORGANIZATION_ID die numerische ID der Organisation ist, in der die Principal Access Boundary-Richtlinie erstellt wurde, und PAB_POLICY_ID die alphanumerische ID der Principal Access Boundary-Richtlinie ist.
  • uid: Eine eindeutige ID, die der Principal Access Boundary-Richtlinie zugewiesen ist.
  • etag: Eine Kennung für den aktuellen Status der Richtlinie. Dieser Wert ändert sich, wenn Sie die Richtlinie aktualisieren. Um widersprüchliche Aktualisierungen zu vermeiden, muss der Wert etag mit dem in IAM gespeicherten Wert übereinstimmen. Wenn die etag-Werte nicht übereinstimmen, schlägt die Anfrage fehl.
  • displayName: Ein menschenlesbarer Name für die Principal Access Boundary-Richtlinie.
  • annotations: Optional. Eine Liste benutzerdefinierter Schlüssel/Wert-Paare. Mit diesen Annotationen können Sie der Richtlinie zusätzliche Metadaten hinzufügen, z. B. wer die Richtlinie erstellt hat oder ob die Richtlinie von einer automatisierten Pipeline bereitgestellt wurde. Weitere Informationen zu Annotationen finden Sie unter Annotationen.
  • createTime: Der Zeitpunkt, zu dem die Principal Access Boundary-Richtlinie erstellt wurde.
  • updateTime: Der Zeitpunkt, zu dem die Principal Access Boundary-Richtlinie zuletzt aktualisiert wurde.

Details

Jede Principal Access Boundary-Richtlinie enthält ein details-Feld. Dieses Feld enthält die Principal Access Boundary-Regeln und die Erzwingungsversion:

  • rules: Liste der Principal Access Boundary-Regeln, die die Ressourcen definieren, auf die die betroffenen Hauptkonten zugreifen dürfen. Jede Regel enthält die folgenden Felder:

    • description: Eine menschenlesbare Beschreibung der Regel.
    • resources: Eine Liste der Resource Manager-Ressourcen (Projekte, Ordner und Organisationen), auf die Hauptkonten zugreifen dürfen sollen. Alle Hauptkonten, die dieser Richtlinie unterliegen, können auf diese Ressourcen zugreifen.

      Jede Principal Access Boundary-Richtlinie kann in allen Regeln der Richtlinie auf maximal 500 Ressourcen verweisen.

    • effect: Die Beziehung, die Hauptkonten zu den im Feld resources aufgeführten Ressourcen haben. Der einzige Effekt, den Sie in Principal Access Boundary-Regeln angeben können, ist "ALLOW". Durch diese Beziehung sind die Hauptkonten berechtigt, auf die in der Regel aufgeführten Ressourcen zuzugreifen.

  • enforcementVersion: Die Erzwingungsversion, die von IAM bei der Durchsetzung der Richtlinie verwendet wird. Die Version der Principal Access Boundary-Richtlinie bestimmt, welche Berechtigungen die Principal Access Boundary-Richtlinie blockieren kann.

    Weitere Informationen zum Festlegen und Verwalten von Erzwingungsversionen finden Sie auf dieser Seite unter Erzwingungsversionen verwalten.

Struktur einer Richtlinienbindung

Eine Richtlinienbindung für eine Principal Access Boundary-Richtlinie enthält den Namen einer Richtlinie, den Namen des Hauptkontosatzes, an den die Richtlinie gebunden werden soll, und Metadaten, die die Richtlinienbindung beschreiben. Sie kann auch Bedingungen enthalten, die die genauen Hauptkonten ändern, für die die Richtlinie gilt.

Mit der folgenden Richtlinienbindung wird beispielsweise die Richtlinie example-policy an alle Hauptkonten in der Organisation example.com mit der ID 0123456789012 gebunden. Die Richtlinienbindung enthält auch eine Bedingung, die verhindert, dass die Richtlinie für das Hauptkonto super-admin@example.com erzwungen wird.

{
  "name": "organizations/0123456789012/locations/global/policyBindings/example-policy-binding",
  "uid": "buid_01234567890123456789", 
  "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
  "displayName": "Example policy binding",
  "annotations": {
    "example-key": "example-value"
  },
  "target": {
    "principalSet": "//cloudresourcemanager.googleapis.com/organizations/0123456789012"
  },
  "policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
  "policy": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
  "policyUid": "puid_0123456789012345678",
  "condition": {
    "title": "Exempt principal",
    "description": "Don't enforce the policy for super-admin@example.com",
    "expression": "principal.subject != 'super-admin@example.com'"
  },
  "createTime": "2024-01-02T17:00:16Z",
  "updateTime": "2024-01-02T17:00:16Z"
}

Jede Richtlinienbindung enthält die folgenden Felder:

  • name: Der Name der Richtlinienbindung. Dieser Name hat das Format RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID, wobei RESOURCE_TYPE/RESOURCE_ID der Typ und die ID der übergeordneten Ressource der Richtlinienbindung und BINDING_ID die alphanumerische ID der Richtlinienbindung ist.
  • uid: Eine eindeutige ID, die der Richtlinienbindung zugewiesen ist.
  • etag: Eine Kennung für den aktuellen Status der Richtlinie. Dieser Wert ändert sich, wenn Sie die Richtlinie aktualisieren. Um widersprüchliche Aktualisierungen zu vermeiden, muss der Wert etag mit dem in IAM gespeicherten Wert übereinstimmen. Wenn die etag-Werte nicht übereinstimmen, schlägt die Anfrage fehl.
  • displayName: Ein menschenlesbarer Name für die Richtlinienbindung.
  • annotations: Optional. Eine Liste benutzerdefinierter Schlüssel/Wert-Paare. Mit diesen Annotationen können Sie der Richtlinienbindung zusätzliche Metadaten hinzufügen, z. B. wer die Richtlinienbindung erstellt hat oder ob die Richtlinienbindung von einer automatisierten Pipeline bereitgestellt wurde. Weitere Informationen zu Annotationen finden Sie unter Annotationen.
  • target: Die Hauptkontogruppe, an die die Richtlinie gebunden werden soll. Der Wert hat das Format {"principalSet": PRINCIPAL_SET}, wobei PRINCIPAL_SET die ID der Hauptkontogruppe ist, an die Sie die Richtlinie binden möchten.

    An jedes Ziel können bis zu zehn Richtlinien gebunden werden.

  • policyKind: Der Richtlinientyp, auf den sich die Richtlinienbindung bezieht. Bei Richtlinienbindungen für Principal Access Boundary-Richtlinien ist dieser Wert immer PRINCIPAL_ACCESS_BOUNDARY.

  • policy: Die Principal Access Boundary-Richtlinie, die an die Ziel-Hauptkontogruppe gebunden werden soll.

  • policyUid: Eine eindeutige ID, die der Principal Access Boundary-Richtlinie zugewiesen ist, auf die im Feld policy verwiesen wird.

  • condition: Optional. Ein logischer Ausdruck, der sich darauf auswirkt, für welche Hauptkonten die Richtlinie von IAM erzwungen wird. Wenn die Bedingung „true“ ergibt oder nicht ausgewertet werden kann, erzwingt Identity and Access Management die Richtlinie für das Hauptkonto, das die Anfrage stellt. Wenn die Bedingung als „false“ ausgewertet wird, erzwingt Identity and Access Management die Richtlinie für das Hauptkonto nicht. Weitere Informationen finden Sie auf dieser Seite unter Principal Access Boundary und Bedingungen.

  • createTime: Der Zeitpunkt, zu dem die Richtlinienbindung erstellt wurde.

  • updateTime: Der Zeitpunkt, zu dem die Richtlinienbindung zuletzt aktualisiert wurde.

Nächste Schritte