Mit der Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM) können Sie steuern, wer welche Aktionen in Dataplex Universal Catalog ausführen kann. Sie können das Sicherheitsprinzip der geringsten Berechtigung anwenden, um private Daten zu schützen, unbefugten Zugriff zu vermeiden, die Angriffsfläche zu verringern oder gesetzliche Bestimmungen einzuhalten.
Dataplex Universal Catalog bietet mehrere vordefinierte IAM-Rollen, die jeweils eine bestimmte Reihe von Berechtigungen enthalten, mit denen Nutzer Aktionen ausführen können. Sie können diese Rollen mithilfe einer IAM-Richtlinie zuweisen.
Für eine detailliertere Steuerung können Sie eine benutzerdefinierte IAM-Rolle erstellen, indem Sie bestimmte Berechtigungen auswählen und diese neue Rolle Nutzern zuweisen. Mit benutzerdefinierten Rollen können Sie ein Zugriffsmodell erstellen, das den Anforderungen Ihrer Organisation entspricht.
In diesem Dokument werden die vordefinierten und benutzerdefinierten IAM-Rollen beschrieben, die für Dataplex Universal Catalog relevant sind.
Eine ausführliche Beschreibung von IAM und seinen Funktionen finden Sie in der IAM-Dokumentation.
Wenn Sie Data Catalog verwenden, werden die Zugriffsberechtigungen für Data Catalog-Einträge nicht automatisch auf die Dataplex Universal Catalog-Einträge übertragen. Sie müssen den Zugriff auf die Dataplex Universal Catalog-Einträge explizit gewähren, bevor Sie sie verwenden.
Dataplex Universal Catalog-Rollen
Dataplex Universal Catalog-IAM-Rollen enthalten eine oder mehrere Berechtigungen. Sie weisen Hauptkonten Rollen zu, damit sie Aktionen für die Dataplex Universal Catalog-Ressourcen in Ihrem Projekt ausführen können. Die Rolle „Dataplex-Betrachter“ umfasst beispielsweise die Berechtigungen dataplex.*.get und dataplex.*.list, mit denen Nutzer Dataplex Universal Catalog-Ressourcen in einem Projekt abrufen und auflisten können. Weitere Informationen finden Sie unter Dataplex Universal Catalog
Berechtigungen.
Sie können Dataplex Universal Catalog-Rollen auf alle Ressourcen in der Diensthierarchie anwenden, einschließlich der folgenden:
- Projekte
- Lakes, Datenzonen und Assets
- Datenscans, Aufgaben und Umgebungen
- Eintragsgruppen, Eintragstypen, Eintragslinktypen, Aspekttypen und Glossare
- Datentaxonomien, Datenattribute und Datenattributbindungen
Vordefinierte Rollen für Dataplex Universal Catalog
Vordefinierte Rollen enthalten die Berechtigungen, die zum Ausführen einer Aufgabe oder einer Gruppe verwandter Aufgaben erforderlich sind.
Die folgenden Rollen bieten umfassenden Zugriff auf Dataplex Universal Catalog-Ressourcen:
| Rolle | Beschreibung |
|---|---|
| Dataplex-Administrator ( roles/dataplex.admin) |
Vollständiger Zugriff auf Dataplex Universal Catalog-Ressourcen. |
| Dataplex-Bearbeiter ( roles/dataplex.editor) |
Bearbeitungszugriff auf Dataplex Universal Catalog-Ressourcen. |
| Dataplex-Betrachter ( roles/dataplex.viewer) |
Lesezugriff auf Dataplex Universal Catalog-Ressourcen. |
| Dataplex-Entwickler ( roles/dataplex.developer) |
Ermöglicht das Ausführen von Arbeitslasten zur Datenanalyse. |
Die Rollen Dataplex-Administrator (roles/dataplex.admin), Dataplex-Bearbeiter (roles/dataplex.editor) und Dataplex-Betrachter (roles/dataplex.viewer) bieten keinen Zugriff auf Metadatenressourcen wie Eintragsgruppen, Einträge, Eintragslinks, Eintragstypen, Eintragslinktypen und Aspekttypen.
In der folgenden Tabelle sind die vordefinierten Dataplex Universal Catalog-Rollen und die Berechtigungen aufgeführt, die mit jeder Rolle verknüpft sind:
| Role | Permissions |
|---|---|
Dataplex Administrator( Full access to Dataplex Universal Catalog resources, except for catalog resources like entries and entry groups. |
|
Dataplex DataScan Administrator( Full access to DataScan resources. |
|
Dataplex Editor( Write access to Dataplex Universal Catalog resources, except for catalog resources like entries, entry groups, and glossaries. |
|
Dataplex Viewer( Read access to Dataplex Universal Catalog resources, except for catalog resources like entries, entry groups, and glossaries. |
|
Dataplex Aspect Type Owner( Grants access to creating and managing Aspect Types. Does not give the right to create/modify Entries. |
|
Dataplex Aspect Type User( Grants access to use Aspect Types to create/modify Entries with the corresponding aspects. |
|
Dataplex Binding Administrator( Full access on DataAttribute Binding resources. |
|
Dataplex Catalog Admin( Full access to catalog resources, including entries, entry groups, and glossaries. |
|
Dataplex Catalog Editor( Write access to catalog resources, including entries, entry groups, and glossaries. Cannot set IAM policies on resources. |
|
Dataplex Catalog Viewer( Read access to catalog resources, including entries, entry groups, and glossaries. Can view IAM policies on catalog resources. |
|
Dataplex Data Owner( Owner access to data. To be granted to Dataplex Universal Catalog resources Lake, Zone or Asset only. |
|
Dataplex Data Products Admin Beta( Full access to Data Products. |
|
Dataplex Data Products Consumer Beta( Restricted read access, intended for consumers of Data Products. |
|
Dataplex Data Products Editor Beta( Write access to Data Products. |
|
Dataplex Data Products Viewer Beta( Read access to Data Products. |
|
Dataplex Data Reader( Read only access to data. To be granted to Dataplex Universal Catalog resources Lake, Zone or Asset only. |
|
Dataplex DataScan Creator( Access to create new DataScan resources. |
|
Dataplex DataScan DataViewer( Read access to DataScan resources, including the results. |
|
Dataplex DataScan Editor( Write access to DataScan resources. |
|
Dataplex DataScan Viewer( Read access to DataScan resources, excluding the results. |
|
Dataplex Data Writer( Write access to data. To be granted to Dataplex Universal Catalog resources Lake, Zone or Asset only. |
|
Dataplex Developer( Allows running data analytics workloads in a lake. |
|
Dataplex Encryption Admin( Gives user permissions to manage encryption configurations. |
|
Dataplex Entry Group Exporter( Grants access to export this entry group for Metadata Job processing. |
|
Dataplex Entry Group Importer( Grants access to import this entry group for Metadata Job processing. |
|
Dataplex Entry Group Owner( Owns Entry Groups and Entries inside of them. |
|
Dataplex Entry and EntryLink Owner( Owns Metadata Entries and EntryLinks. |
|
Dataplex Entry Type Owner( Grants access to creating and managing Entry Types. Does not give the right to create/modify Entries. |
|
Dataplex Entry Type User( Grants access to use Entry Types to create/modify Entries of those types. |
|
Dataplex Metadata Feed Owner( Grants access to creating and managing Metadata Feeds. Does not give the right to create/modify Entry Groups. |
|
Dataplex Metadata Feed Viewer( Read access to Metadata Feed resources. |
|
Dataplex Metadata Job Owner( Grants access to creating and managing Metadata Jobs. Does not give the right to create/modify Entry Groups. |
|
Dataplex Metadata Job Viewer( Read access to Metadata Job resources. |
|
Dataplex Metadata Reader( Read only access to metadata within table and fileset entities and partitions. |
|
Dataplex Metadata Writer( Write and read access to metadata within table and fileset entities and partitions. |
|
Dataplex Security Administrator( Permissions configure ResourceAccess and DataAccess Specs on Data Attributes. |
|
Dataplex Storage Data Owner( Owner access to data. Should not be used directly. This role is granted by Dataplex to managed resources like Cloud Storage buckets, BigQuery datasets etc. |
|
Dataplex Storage Data Reader( Read only access to data. Should not be used directly. This role is granted by Dataplex to managed resources like Cloud Storage buckets, BigQuery datasets etc. |
|
Dataplex Storage Data Writer( Write access to data. Should not be used directly. This role is granted by Dataplex to managed resources like Cloud Storage buckets, BigQuery datasets etc. |
|
Dataplex Taxonomy Administrator( Full access to DataTaxonomy, DataAttribute resources. |
|
Dataplex Taxonomy Viewer( Read access on DataTaxonomy, DataAttribute resources. |
|
Service agent roles
Service agent roles should only be granted to service agents.
| Role | Permissions |
|---|---|
Dataplex Discovery BigLake Publishing Service Agent( Gives the Dataplex Discovery Service Agent permissions to use bigquery connection. |
|
Dataplex Discovery Publishing Service Agent( Gives the Dataplex Discovery Service Agent dataset create and get permissions. |
|
Dataplex Discovery Service Agent( Gives the Dataplex Discovery Service Agent bucket read permissions. |
|
Cloud Dataplex Service Agent( Gives the Dataplex service account access to project resources. This access will be used in data discovery, data management and data workload management. |
|
Rolle „Dataplex Entry and EntryLink Owner“
Die Rolle Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner) umfasst die folgenden Funktionen:
- Gewährt vollständigen Zugriff auf eintragsspezifische Vorgänge.
- Gewährt vollständigen Zugriff auf Vorgänge im Zusammenhang mit Eintragslinks.
- Gewährt Berechtigungen zum Hinzufügen von Aspekten zu Einträgen einiger Systemaspekttypen wie
Schema,Generic,OverviewundContacts. - Gewährt Berechtigungen zum Hinzufügen von Aspekten zu Eintragslinks einiger Systemaspekttypen wie
SchemaJoin. - Gewährt Berechtigungen zum Erstellen von Einträgen des Typs
GenericEntry. - Gewährt Berechtigungen zum Erstellen von Eintragslinks des Typs
schema-join. - Mit dieser Rolle können Sie einen Eintrag mit einem Eintragstyp und einem Aspekttyp erstellen, wobei der Eintragstyp und der Aspekttyp im selben Projekt wie der Eintrag definiert sind.
Andernfalls müssen Sie auch die Rollen Dataplex Entry Type User (
roles/dataplex.entryTypeUser) und Dataplex Aspect Type User (roles/dataplex.aspectTypeUser) für die Projekte zuweisen, in denen die Eintragstypen und Aspekttypen definiert sind. - Mit dieser Rolle können Sie alle verfügbaren Eintragslinks mit den erforderlichen Aspekten erstellen.
- Diese Rolle gewährt keine Berechtigungen zum Lesen von Einträgen, die aus
Ressourcen außerhalb von Dataplex Universal Catalog erstellt wurden, wie
z. B. BigQuery-Einträge, wenn die
LookupEntry,SearchEntries, oderModifyEntryMethoden verwendet werden. Google Cloud Wenn Sie diese Einträge lesen oder ändern möchten, benötigen Sie die entsprechenden Berechtigungen zum Lesen oder Aktualisieren von Metadaten für die Ressourcen des Quellsystems. Alternativ können Sie die Einträge auch nur mit der Rolle Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner) lesen, indem Sie die MethodeGetEntryverwenden, oder den Eintrag mit der MethodeUpdateEntryändern.
Überlegungen zu Rollen
Keine Rolle gewährt Berechtigungen zum Hinzufügen oder Löschen von Dataplex Universal Catalog-Einträgen aus systemdefinierten Eintragsgruppen wie
@bigqueryund@dataplex.Wenn Sie Datenaspekte ansehen möchten, die an einen Eintrag angehängt sind, benötigen Sie neben den Berechtigungen zum Ansehen des Eintrags auch Berechtigungen zum Lesen von Daten aus dem Quell-Asset das der Eintrag darstellt. Wenn Sie die Berechtigung zum Ansehen eines Eintrags haben, aber keine Berechtigungen zum Lesen von Daten für das Quell-Asset, können Sie trotzdem alle anderen Metadaten für den Eintrag ansehen. Dataplex Universal Catalog blendet jedoch den Inhalt aller angehängten Datenaspekte aus.
Die Rollen Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) und Dataplex Catalog Editor (roles/dataplex.catalogEditor) gewähren Berechtigungen zum Ansehen benutzerdefinierter Einträge.Wenn Sie mit der
SearchEntriesMethode nach Einträgen suchen möchten, benötigen Sie mindestens eine der folgenden IAM-Rollen für das Projekt, das in der API-Anfrage verwendet wird: Dataplex Catalog Admin (roles/dataplex.catalogAdmin), Dataplex Catalog Editor (roles/dataplex.catalogEditor) oder Dataplex Catalog Viewer (roles/dataplex.catalogViewer). Berechtigungen für Suchergebnisse werden unabhängig vom ausgewählten Projekt geprüft.
Vordefinierte Rollen für die Datenherkunft
Wenn Sie die Herkunft eines Dataplex Universal Catalog-Eintrags aufrufen möchten, benötigen Sie eine Betrachter
rolle für die entsprechende Systemressource
oder die Rolle „Dataplex Catalog Viewer“
(roles/dataplex.catalogViewer) für das Projekt, in dem der Dataplex Universal Catalog-Eintrag gespeichert ist.
In diesem Abschnitt werden die Rollen beschrieben, die für die Arbeit mit der Herkunft erforderlich sind.
| Role | Permissions |
|---|---|
Data Lineage Administrator( Grants full access to all resources in Data Lineage API |
|
Data Lineage Editor( Grants edit access to all resources in Data Lineage API |
|
Data Lineage Viewer( Grants read access to all resources in Data Lineage API |
|
Data Lineage Events Producer( Grants access to creating all resources in Data Lineage API |
|
Rolle „Lineage Viewer“
Mit der Rolle „Data Lineage Viewer“
(roles/datalineage.viewer) können Sie die Dataplex Universal Catalog
-Herkunft in der Google Cloud Console ansehen und Herkunftsinformationen mit der
Data Lineage API lesen. Die Ausführungen und Ereignisse für einen bestimmten Prozess werden im selben Projekt wie der Prozess gespeichert. Bei der automatischen Herkunft werden der Prozess, die Ausführungen
und Ereignisse in dem Projekt gespeichert, in dem der Job ausgeführt wurde, der die Herkunft generiert hat. Das kann beispielsweise das Projekt sein, in dem ein BigQuery-Job ausgeführt wurde.
Wenn Sie die Herkunft zwischen Assets ansehen möchten, benötigen Sie die Data Lineage Viewer
Rolle
(roles/datalineage.viewer) sowohl für das Projekt, in dem Sie die Herkunft ansehen
als auch für die Projekte, in denen die Herkunft aufgezeichnet wird. Insbesondere benötigen Sie die Rolle für die folgenden Projekte:
- Das Projekt, in dem Sie die Herkunft ansehen (bekannt als aktives Projekt), d. h. das Projekt im Drop-down-Menü oben in der Google Cloud Console oder das Projekt, von dem API-Aufrufe erfolgen. In der Regel ist dies das Projekt das die Ressourcen enthält, die Sie in Dataplex Universal Catalog erstellen oder auf die Sie in anderen Google Cloud Systemen mit der API zugreifen.
- Die Projekte, in denen die Herkunft aufgezeichnet wird (Compute-Projekt). Die Herkunft wird im Projekt gespeichert, in dem der entsprechende Prozess ausgeführt wurde, wie bereits beschrieben. Dieses Projekt kann sich von dem Projekt unterscheiden, in dem das Asset gespeichert ist, für das Sie die Herkunft ansehen.
Wenn Sie Asset-Metadaten ansehen möchten, benötigen Sie dieselben Rollen, die für den Zugriff auf Metadateneinträge in Dataplex Universal Catalog verwendet werden.
Weisen Sie je nach Anwendungsfall die Rolle „Data Lineage Viewer
“
(roles/datalineage.viewer) auf Ordner- oder Organisationsebene zu, um den
Zugriff auf die Herkunft zu gewährleisten (siehe Einzelne Rolle zuweisen oder widerrufen).
Rollen zum Ansehen von Asset-Metadaten beim Ansehen der Herkunft
Wenn Sie Metadaten zu einem Asset ansehen möchten, das in Dataplex Universal Catalog gespeichert ist, müssen Sie
eine Betrachterrolle für die entsprechende Systemressource oder die
Rolle „Dataplex Catalog Viewer“
(roles/dataplex.catalogViewer) für das Projekt haben, in dem der
Dataplex Universal Catalog-Eintrag gespeichert ist. Möglicherweise haben Sie über entsprechende Betrachterrollen Zugriff auf Assets im Herkunftsdiagramm oder in der Liste, aber keinen Zugriff auf die Herkunft zwischen ihnen. Das ist der Fall, wenn Sie die Rolle „Data Lineage
Viewer“
(roles/datalineage.viewer) nicht für das Projekt haben, in dem die Herkunft aufgezeichnet wurde.
In diesem Fall zeigen die Data Lineage API und Google Cloud dieConsole die Herkunft nicht an und geben keinen Fehler zurück. So wird verhindert, dass Informationen über die Existenz der Herkunft weitergegeben werden. Das Fehlen der Herkunft für ein Asset bedeutet daher nicht, dass keine Herkunft vorhanden ist, sondern dass Sie möglicherweise keine Berechtigungen zum Ansehen haben.
Metadatenrollen
Metadatenrollen gewähren Berechtigungen zum Ansehen und Aktualisieren von Metadaten wie Tabellenschemas.
| Rolle | Beschreibung |
|---|---|
| Autor von Dataplex-Metadaten ( roles/dataplex.metadataWriter) |
Ermöglicht das Aktualisieren der Metadaten einer Ressource. |
| Dataplex-Metadatenleser ( roles/dataplex.metadataReader) |
Ermöglicht das Lesen von Metadaten, z. B. zum Abfragen einer Tabelle. |
Datenrollen
Dataplex Universal Catalog definiert die folgenden IAM-Rollen, die für alle Ressourcen gelten, die von Dataplex Universal Catalog verwaltet werden. Weitere Informationen zu den Berechtigungen, die mit den einzelnen Rollen verknüpft sind, finden Sie im Abschnitt Vordefinierte Rollen in diesem Dokument.
| Rolle | Beschreibung |
|---|---|
| Dataplex-Dateninhaber ( roles/dataplex.dataOwner) |
Vollständiger Zugriff auf die verwaltete Ressource und ihre untergeordneten Ressourcen. Zu den Berechtigungen gehören das Aktualisieren von Metadaten, das Erstellen untergeordneter Ressourcen und das Gewähren detaillierter Berechtigungen. |
| Dataplex-Datenleser ( roles/dataplex.dataReader) |
Lesezugriff auf Daten und Metadaten in der verwalteten Ressource und ihren untergeordneten Ressourcen. |
| Dataplex-Datenautor ( roles/dataplex.dataWriter) |
Schreibzugriff auf Daten in der verwalteten Ressource. Dazu gehören das Erstellen, Aktualisieren und Löschen von Daten, aber nicht von Metadaten. |
Nächste Schritte
- Benutzerdefinierte IAM-Rollen erstellen
- Rollen gewähren und verwalten.
- Siehe die Dataplex Universal Catalog-IAM Berechtigungen.