Mit Unified Access Policies (UAPs) können Sie den Zugriff aufGoogle Cloud -Ressourcen gewähren und verweigern. Im Gegensatz zu Zulassungs- und Ablehnungsrichtlinien können Sie mit UAPs den Zugriff in derselben Richtlinie gewähren und verweigern, was die Richtlinienverwaltung vereinfacht. UAPs sind auch wiederverwendbar, d. h., Sie können dieselbe UAP auf mehrere Ressourcen anwenden.
So funktionieren Unified Access Policies
Wenn Sie in IAM Zugriff gewähren oder verweigern möchten, müssen Sie angeben, wer was für welche Ressource tun darf oder nicht.
In UAPs geben Sie an, wer was tun darf oder nicht, indem Sie UAP-Regeln erstellen. Jede Regel enthält eine Liste von Hauptkonten, eine Liste von Rollen und Berechtigungen sowie einen Effekt. Der Effekt (Zulassen oder Ablehnen) gibt an, ob den aufgeführten Hauptkonten die Rollen und Berechtigungen in der Regel gewährt werden oder ob sie die Berechtigungen in der Regel nicht verwenden dürfen. Sie können bis zu 100 Regeln in einer einzelnen UAP haben.
Wenn Sie angeben möchten, für welche Ressource eine UAP den Zugriff steuert, verwenden Sie eine UAP-Bindung, um die UAP an eine Ressource zu binden. Sie können eine einzelne UAP an bis zu 5 Ressourcen binden. An eine einzelne Ressource können bis zu 5 Richtlinien gebunden sein.
Anwendungsfälle
In IAM gibt es mehrere Richtlinientypen, mit denen Sie den Zugriff zulassen und ablehnen können:
- Wenn Sie Zugriff gewähren möchten, können Sie Zulassungsrichtlinien oder UAP-Zulassungsregeln verwenden.
- Wenn Sie den Zugriff verweigern möchten, können Sie Ablehnungsrichtlinien oder UAP-Ablehnungsregeln verwenden.
Wenn Sie bereits Zulassungs- oder Ablehnungsrichtlinien zur Zugriffssteuerung verwenden, empfehlen wir, diese Richtlinien weiterhin zu verwenden. Diese Richtlinientypen werden auch in Policy Troubleshooter unterstützt, was die Ursachenanalyse von Zugriffsfehlern erleichtert.
Verwenden Sie UAPs in folgenden Fällen:
- Sie richten eine neue Organisation ein und möchten UAPs verwenden, um den Zugriff in Ihrer Organisation zu steuern.
- Sie möchten eine detaillierte Zugriffssteuerung mit UAP-Bedingungen einrichten.
Unified Access Policy-Regeln
UAPs bestehen aus Zulassungs- und Ablehnungsregeln. Diese Regeln enthalten die folgenden Komponenten:
Eine Auswirkung: Gibt an, ob die Regel den Zugriff gewährt oder verweigert. Regeln, die Zugriff gewähren, werden als Zulassungsregeln bezeichnet. Regeln, die den Zugriff verweigern, werden als Ablehnungsregeln bezeichnet.
Eine Gruppe von Hauptkonten: Die Hauptkonten, z. B. Nutzer, Gruppen oder Dienstkonten, die Sie in die Regel aufnehmen möchten. In Zulassungsregeln wird diesen Hauptkonten Zugriff gewährt. In Ablehnungsregeln wird diesen Hauptkonten der Zugriff verweigert.
Eine Liste der Rollen und Berechtigungen: Die Rollen und Berechtigungen, die Sie in die Regel aufnehmen möchten. In Zulassungsregeln werden diese Berechtigungen gewährt. In Ablehnungsregeln werden diese Berechtigungen abgelehnt.
Optional: Ein Bedingungsausdruck: Ein IAM-Bedingungsausdruck, der die Bedingungen angibt, die erfüllt sein müssen, damit die Regel angewendet wird. Weitere Informationen finden Sie auf dieser Seite unter Bedingungen in UAPs.
Hauptkonten in Unified Access Policy-Regeln
Wenn Sie Hauptkonten angeben möchten, die in die Regel aufgenommen werden sollen, definieren Sie Folgendes:
- Eingeschlossene Hauptkonten: Die Hauptkonten, die Sie in die Regel aufnehmen möchten.
- Ausgeschlossene Hauptkonten: Die Hauptkonten, die Sie von der Regel ausschließen möchten, auch wenn sie sich in einer Gruppe in der Liste der eingeschlossenen Hauptkonten befinden.
Mit diesen beiden Listen können Sie genau angeben, welche Hauptkonten Sie in die Regel aufnehmen möchten. Angenommen, Sie erstellen eine Zulassungsregel, um Nutzern in example.com Zugriff zu gewähren. Wenn Sie allen Mitgliedern der Gruppe all@example.com mit Ausnahme des Nutzers reduced-access@example.com Zugriff gewähren möchten, fügen Sie all@example.com der Liste der eingeschlossenen Hauptkonten und reduced-access@example.com der Liste der ausgeschlossenen Hauptkonten hinzu.
Rollen und Berechtigungen in Unified Access Policy-Regeln
Wenn Sie eine genaue Liste der Berechtigungen erstellen möchten, die Sie in die Regel aufnehmen möchten, definieren Sie Folgendes:
- Enthaltene Berechtigungen: Die Berechtigungen, die Sie in die Regel aufnehmen möchten.
- Ausgeschlossene Berechtigungen: Die Berechtigungen, die Sie nicht in die Regel aufnehmen möchten, auch wenn sie in einer Rolle oder Berechtigungsgruppe in der Liste der eingeschlossenen Berechtigungen enthalten sind.
Wenn Sie der Liste der enthaltenen oder ausgeschlossenen Berechtigungen Berechtigungen hinzufügen möchten, können Sie auf Folgendes verweisen:
Berechtigungen: Einzelne Berechtigungsnamen im Format des voll qualifizierten Domainnamens (FQDN). Beispiel:
cloudresourcemanager.googleapis.com/projects.getRollen (nur Zulassungsregeln): Vordefinierte Rollennamen, z. B.
roles/logging.logsViewer. Wenn Sie einen Rollennamen in eine Regel aufnehmen, enthält die Regel alle Berechtigungen in dieser Rolle. Eine Liste aller Berechtigungen in einer Rolle finden Sie in der Referenz zu Rollen und Berechtigungen.In der UAP-JSON-Datei wird diesen Namen immer
role:vorangestellt, z. B.role:roles/logging.logsViewer.Rollen sind nur in Zulassungsregeln zulässig. Benutzerdefinierte Rollen werden in Regeln nicht unterstützt.
Berechtigungsgruppen: Berechtigungssätze, z. B.
aiplatform.googleapis.com/*.*. Berechtigungsgruppen sind Sätze von Berechtigungen, die einem bestimmten Muster entsprechen. Es gibt einige Einschränkungen für die Berechtigungsgruppen, auf die Sie verweisen können, und die in diesen Gruppen enthaltenen Berechtigungen. Weitere Informationen finden Sie auf dieser Seite unter Berechtigungsgruppen.
Berechtigungsgruppen
Berechtigungsgruppen sind Sätze von Berechtigungen, die einem bestimmten Muster entsprechen. Mit einer Berechtigungsgruppe können Sie mehrere zugehörige Berechtigungen gewähren oder ablehnen, z. B. alle Berechtigungen für einen einzelnen Dienst ablehnen oder alle Berechtigungen gewähren, die mit einem bestimmten Verb enden.
Berechtigungsgruppen funktionieren in Zulassungs- und Ablehnungsregeln unterschiedlich. In den folgenden Abschnitten wird erläutert, wie Sie Berechtigungsgruppen in den einzelnen Regeltypen verwenden.
Berechtigungsgruppen in Zulassungsregeln
Wenn Sie eine Berechtigungsgruppe in einer Zulassungsregel identifizieren möchten, ersetzen Sie einen oder mehrere Abschnitte eines Berechtigungsnamens durch einen Platzhalter (*). Die Berechtigungen, die jede Gruppe enthält, hängen von der Position des Platzhalters ab:
SERVICE_FQDN/RESOURCE.*: Enthält alle Berechtigungen für die angegebene Ressource.SERVICE_FQDN/*.*: Enthält alle Berechtigungen für den angegebenen Dienst.SERVICE_FQDN/*.VERB: Enthält alle Berechtigungen für einen Dienst, die mit dem angegebenen Verb enden.*/*.VERB: Enthält alle Berechtigungen, die mit dem angegebenen Verb enden.*: Enthält alle Berechtigungen. Dieser Wert ist nur zulässig, wenn eingeschlossene Berechtigungen aufgeführt werden, nicht ausgeschlossene Berechtigungen.
Berechtigungsgruppen enthalten nur die Berechtigungen, die in benutzerdefinierten Rollen unterstützt werden. Andere Berechtigungen sind nicht enthalten, auch wenn sie dem angegebenen Format entsprechen.
Informationen dazu, welche Berechtigungen in benutzerdefinierten Rollen unterstützt werden, finden Sie unter Unterstützungsstufen für Berechtigungen in benutzerdefinierten Rollen.
Die auf dieser Seite aufgeführten Berechtigungen haben nicht dasselbe Format wie die Berechtigungen in UAPs:
- Benutzerdefinierte Rollen verwenden das Format
v1für Berechtigungsnamen, alsoSERVICE_ID.RESOURCE.VERB. - UAPs verwenden das Format für voll qualifizierte Domainnamen für Berechtigungsnamen, also
SERVICE_FQDN/RESOURCE.VERB.
Die Werte für SERVICE_ID und SERVICE_FQDN sind jedoch in der Regel ähnlich. In den meisten Fällen ist der Wert von SERVICE_FQDN der Wert von SERVICE_ID aus der v1 API, gefolgt von .googleapis.com. Die Berechtigung zum Löschen einer Rolle kann beispielsweise so geschrieben werden:
v1-Format:iam.roles.delete- Format des voll qualifizierten Domainnamens:
iam.googleapis.com/roles.delete
Sie können diese Ähnlichkeit nutzen, um zwischen den beiden Formaten zu übersetzen, wenn Sie Berechtigungsgruppen für Zulassungsregeln prüfen.
Es gibt einige Ausnahmen von dieser Regel. Diese Ausnahmen finden Sie in der Liste der in Ablehnungsrichtlinien unterstützten Berechtigungen. Suchen Sie im Filterfeld nach IAM v1 API.
Berechtigungsgruppen in Ablehnungsregeln
Ablehnungsregeln unterstützen nur bestimmte Berechtigungsgruppen. Unterstützte Berechtigungsgruppen sind unter In Ablehnungsrichtlinien unterstützte Berechtigungen aufgeführt. Die Kennungen für die unterstützten Berechtigungsgruppen ersetzen einen oder mehrere Abschnitte eines Berechtigungsnamens durch einen Platzhalter (*). Welche Berechtigungen die einzelnen Gruppen enthalten, hängt von der Position des Platzhalters ab:
SERVICE_FQDN/RESOURCE.*: Verweigert alle Berechtigungen für die angegebene Ressource.SERVICE_FQDN/*.*: Verweigert alle Berechtigungen für den angegebenen Dienst.SERVICE_FQDN/*.VERB: Verweigert alle Berechtigungen für einen Dienst, die mit dem angegebenen Verb enden.
Berechtigungsgruppen umfassen alle aktuellen und zukünftigen Berechtigungen, die dem angegebenen Muster entsprechen. Angenommen, Sie verwenden die Berechtigungsgruppe example.googleapis.com/exampleResource.*, um einem Nutzer alle Berechtigungen für den Ressourcentyp exampleResource zu verweigern. Wenn example.googleapis.com eine neue Berechtigung für den Ressourcentyp exampleResource hinzufügt, z. B. example.googleapis.com/exampleResource.newPermission, wird dem Nutzer die neue Berechtigung automatisch verweigert.
Platzhalter können nur in unterstützten Berechtigungsgruppen verwendet werden. Die Verwendung von Platzhaltern in anderen Berechtigungsnamen in Ablehnungsregeln wird nicht unterstützt.
Unified Access Policies erstellen
Sie können UAPs in einem Projekt, Ordner oder einer Organisation erstellen. Die Ressource, in der Sie die UAP erstellen, wird zum übergeordneten Element der UAP. Die UAP hat jedoch erst dann Auswirkungen, wenn Sie die UAP anwenden.
Das übergeordnete Element des UAP wird im Namen des UAP angezeigt. Richtliniennamen haben das Format RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID, wobei die Platzhalter Folgendes darstellen:
RESOURCE_TYPE: Der Ressourcentyp, für den die UAP erstellt wurde. Dieser Wert ist entwederprojects,foldersoderorganizations.RESOURCE_ID: Die ID der Ressource, in der die UAP erstellt wurde.POLICY_ID: Die alphanumerische ID des UAP.
Wenn Sie beispielsweise eine UAP example-policy im Projekt example-project erstellen, ist die übergeordnete Ressource dieser UAP example-project und der Name der UAP lautet projects/example-project/locations/global/accessPolicies/example-policy.
Wo Unified Access Policies erstellt werden
Das übergeordnete Element einer UAP hat keine Auswirkungen auf die Ressourcen, auf die Sie die UAP anwenden können. Sie wirkt sich jedoch darauf aus, wer die Berechtigung hat, die UAP aufzurufen und zu bearbeiten. Damit die richtigen Nutzer die Berechtigung haben, die entsprechenden UAPs aufzurufen und zu bearbeiten, empfehlen wir, eine übergeordnete Ressource auszuwählen, die den Umfang der UAP am besten widerspiegelt.
Wenn Sie beispielsweise eine UAP auf Ihre Organisation anwenden möchten, empfehlen wir, die UAP in der Organisation zu erstellen.
Richtlinien auf Ressourcen anwenden
Wenn Sie eine UAP anwenden möchten, erstellen Sie eine Bindung. In jeder Bindung werden ein UAP und eine Ressource angegeben, an die der UAP gebunden werden soll. Nachdem Sie die Bindung erstellt haben, werden die Regeln in der UAP für diese Ressource sowie für alle Nachfolgerelemente dieser Ressource wirksam.
Angenommen, Sie haben eine UAP, compute-access-management. Diese UAP gewährt der Gruppe compute-users@example.com die Rolle „Compute-Bearbeiter“ (roles/compute.editor) und verweigert allen Nutzern außer compute-users@example.com die Berechtigungen compute.googleapis.com/instances.*.
Ohne Bindungen hat diese UAP keine Auswirkungen.
Diese UAP soll für alle Ressourcen in Ihrer Organisation example.com gelten. Daher erstellen Sie eine Bindung, die die UAP compute-access-management an example.com anhängt. Nachdem Sie die Bindung erstellt haben, hat die UAP die folgenden Auswirkungen:
- Mitglieder von
compute-users@example.comkönnen die Berechtigungen der Rolle „Compute-Bearbeiter“ verwenden, um auf Ressourcen inexample.comzuzugreifen. - Alle Nutzer, die nicht Mitglied von
compute-users@example.comsind, können keine instanzbezogenen Berechtigungen für den Zugriff auf Ressourcen inexample.comverwenden.
Unterstützte Ressourcen
In der folgenden Tabelle sind die Ressourcen aufgeführt, an die Sie UAPs binden können. Jede Zeile enthält Folgendes:
- Der Ressourcentyp
- Das Format der IDs für diese Ressource
- Die Resource Manager-Ressource (Projekt, Ordner oder Organisation), die Bindungen für diesen Ressourcentyp übergeordnet ist
| Ressource | Ressourcen-ID | Übergeordnete Ressource der Bindungen |
|---|---|---|
| Resource Manager-Projekte | //cloudresourcemanager.googleapis.com/projects/PROJECT_ID |
Das Projekt in der Bindung |
| Resource Manager-Ordner | //cloudresourcemanager.googleapis.com/folders/FOLDER_ID |
Der Ordner in der Bindung |
| Resource Manager-Organisationen | //cloudresourcemanager.googleapis.com/organizations/ORG_ID |
Die Organisation in der Bindung |
| KI-Anwendungen in der Agent Registry | //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID |
Das übergeordnete Projekt der Anwendung |
| Network Services API-Agent-Gateways | //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID |
Das übergeordnete Projekt des Gateways |
Erstellen von Bindungen deaktivieren
Wenn Sie das Erstellen von Bindungen in Ihrer Organisation deaktivieren möchten, können Sie die Einschränkung der Organisationsrichtlinie iam.managed.disableAccessPolicyBinding in Ihrer Organisation erzwingen. Diese Einschränkung verhindert, dass Hauptkonten in Ihrer Organisation Bindungen für UAPs erstellen.
Informationen zum Aktivieren oder Deaktivieren dieser Einschränkung finden Sie unter Verwaltete Einschränkungen in einer Organisationsrichtlinie verwenden.
Übernahme von Richtlinien
Wenn Sie eine UAP an ein Projekt, einen Ordner oder eine Organisation binden, wird diese UAP über die Ressourcenhierarchie übernommen.
Die Ressourcenhierarchie besteht aus der Organisation (Stamm) ganz oben, gefolgt von Ordnern (optional) für die Gruppierung und dann Projekten, die dienstspezifische Ressourcen wie virtuelle Compute Engine-Maschinen und Cloud Storage-Buckets enthalten.
In dieser Hierarchie sind Projekte, Ordner und Organisationen übergeordnete Ressourcen. Mit anderen Worten: Es handelt sich um Ressourcen, die andere Ressourcen enthalten:
- Projekte enthalten dienstspezifische Ressourcen.
- Ordner enthalten andere Ordner, Projekte und die Ressourcen der Projekte.
- Organisationen enthalten Ordner, Projekte und die Ressourcen der Projekte.
Die Ressourcen, die eine übergeordnete Ressource enthält, sind die Nachfolgerelemente dieser Ressource.
Wenn Sie eine UAP an eine übergeordnete Ressource binden, gilt diese UAP für die übergeordnete Ressource und für alle untergeordneten Ressourcen dieser Ressource. Mit anderen Worten: Die UAP wird von den Nachfolgern der Ressource übernommen.
Mit der Richtlinienübernahme können Sie Richtlinien mit einer einzigen Bindung auf große Ressourcensätze anwenden. Angenommen, Sie erstellen eine UAP, die taylor@example.com die Rolle „Compute Engine-Administrator“ (roles/compute.admin) zuweist. Die UAP verweigert noam@example.com außerdem die Berechtigung compute.googleapis.com/instances.delete.
Diese UAP soll für alle Ressourcen in Ihrer Organisation (example.com) gelten. Dazu binden Sie diese UAP an Ihre Organisationsressource. Nachdem Sie die UAP an die Organisation gebunden haben, wird sie von allen Ressourcen in dieser Organisation übernommen.
Das Binden des UAP an die Organisation hat folgende Auswirkungen:
taylor@example.comkann die Berechtigungen der Rolle „Compute Engine-Administrator“ verwenden, um auf alle Ressourcen inexample.comzuzugreifen.noam@example.comkann die Berechtigungcompute.googleapis.com/instances.deletefür keine Ressource inexample.comverwenden, auch wenn eine UAP für eine untergeordnete Ressource Zugriff gewährt.
Wenn eine UAP auf weniger Ressourcen angewendet werden soll, können Sie die UAP an eine niedrigere Ebene der Ressourcenhierarchie binden, z. B. an ein Projekt oder eine unterstützte dienstspezifische Ressource.
Organisationsübergreifende Bindungen
Sie können keine organisationsübergreifende Bindung für ein UAP erstellen. Eine organisationsübergreifende Bindung ist eine Bindung, die eine UAP in einer Organisation an eine Ressource in einer anderen Organisation bindet.
IAM löscht regelmäßig alle vorhandenen organisationsübergreifenden Bindungen. Organisationsübergreifende Bindungen 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-projectin der Organisationexample.com. - Sie erstellen einen UAP im Projekt
example-projectund binden ihn anexample-project. - Sie verschieben
example-projectvonexample.comnachcymbalgroup.com.
In diesem Fall wird durch das Verschieben des Projekts eine organisationsübergreifende Bindung erstellt. Das liegt daran, dass die UAP in example.com an eine Ressource 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 UAPs haben, die an Ressourcen in ihrer Organisation gebunden sind.
Bindungen für gelöschte Unified Access Policies
In der Regel müssen Sie Bindungen für einen UAP löschen, bevor Sie den UAP löschen. Versuche, eine UAP mit vorhandenen Bindungen zu löschen, führen zu einem Fehler.
Wenn Sie jedoch eine UAP löschen möchten, ohne vorhandene Bindungen zu löschen, können Sie die UAP zwangsweise löschen.
Wenn Sie eine UAP zwangsweise löschen, wird sie aus allen Ressourcen entfernt, an die sie gebunden ist. Alle Bindungen, die auf die UAP verweisen, werden schließlich gelöscht. Bis sie gelöscht werden, werden die Bindungen jedoch weiterhin auf die maximale Anzahl von Bindungen angerechnet, die sich auf eine einzelne Ressource beziehen können.
Bedingungen in Unified Access Policies
Mit IAM-Bedingungen können Sie eine bedingte, attributbasierte Zugriffssteuerung für Google Cloud -Ressourcen definieren und durchsetzen. In UAPs können Sie einzelnen Regeln Bedingungen hinzufügen, um zu steuern, wann diese Regel angewendet wird. Sie können UAP-Bindungen keine Bedingungen hinzufügen.
Bedingungen bestehen aus einem Titel, einer Beschreibung und einem booleschen Ausdruck. Wenn die Auswertung des Ausdrucks für die Anfrage true ergibt, gilt die Regel für die Anfrage. Wenn sie als false ausgewertet wird, gilt die Regel nicht für die Anfrage.
Verschiedene Dienste bieten unterschiedliche Attribute und Funktionen, mit denen Sie Bedingungsausdrücke schreiben können. Wenn Sie einer Regel Bedingungen hinzufügen, stellen Sie der Bedingung immer den Namen des Dienstes voran, dessen Attribute und Funktionen Sie verwenden. Sie können einer Regel mehrere Bedingungen hinzufügen, aber eine einzelne Bedingung kann keine Attribute aus verschiedenen Diensten kombinieren.
Wenn Sie beispielsweise eine Bedingung hinzufügen, die ein von IAM bereitgestelltes Attribut verwendet, stellen Sie der Bedingung iam.googleapis.com voran:
"conditions": {
"iam.googleapis.com": {
"title": "CONDITION_TITLE",
"description": "CONDITION_DESCRIPTION",
"expression": "CONDITION_EXPRESSION"
}
}
Informationen zum Erstellen von UAP-Regeln mit Bedingungen finden Sie unter UAPs erstellen und anwenden.
Anwendbare Berechtigungen für Bedingungsattribute
Einige dienstspezifische Attribute gelten nur für Anfragen, die bestimmte Berechtigungen umfassen. Das Attribut eventarc.googleapis.com message.id gilt beispielsweise nur für Anfragen, die die Berechtigung eventarc.googleapis.com/messageBuses.publish erfordern.
Sie können diese Attribute nur in Regeln verwenden, die die entsprechende Berechtigung enthalten. Wenn Sie versuchen, das Attribut in einer Regel ohne die entsprechende Berechtigung zu verwenden, schlägt die Erstellung der UAP fehl.
Unterstützte Bedingungsattribute
Die folgenden Attribute werden in UAP-Regeln unterstützt:
| Dienst | Attribut | Anwendbare Berechtigungen | Weitere Informationen |
|---|---|---|---|
iam.googleapis.com (Vorabversion) |
Ressourcen-Tags | Beliebig | Attribut „Ressourcen-Tags“ |
eventarc.googleapis.com (Vorabversion) |
Nachrichten | eventarc.googleapis.com/messageBuses.publish |
Eventarc-Nachrichtenattribute |
iap.googleapis.com (GA) |
Ziele | iap.googleapis.com/resources.egressViaIAP |
Attribute für Identity-Aware Proxy-Ziele |
Nächste Schritte
- Weitere Informationen zum Erstellen und Anwenden von UAPs
- Informationen zum Aufrufen vorhandener UAPs