Mit Identity and Access Management (IAM) können Sie steuern, wer was in Knowledge Catalog (früher Dataplex Universal Catalog) tun 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 die Einhaltung von Vorschriften zu gewährleisten.
Der Wissenskatalog bietet mehrere vordefinierte IAM-Rollen mit jeweils einem bestimmten Satz von Berechtigungen, mit denen Nutzer Aktionen ausführen können. Sie können diese Rollen mit 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 Knowledge 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 Zugriffsrechte für Data Catalog-Einträge nicht automatisch auf Knowledge Catalog-Einträge übertragen. Sie müssen den Zugriff auf die Knowledge Catalog-Einträge explizit gewähren, bevor Sie sie verwenden können.
Knowledge Catalog-Rollen
Knowledge Catalog-IAM-Rollen enthalten eine oder mehrere Berechtigungen. Sie weisen den Hauptkonten Rollen zu, damit sie Aktionen für die Knowledge Catalog-Ressourcen in Ihrem Projekt ausführen können. Die Rolle „Dataplex Viewer“ enthält beispielsweise die Berechtigungen dataplex.*.get und dataplex.*.list, mit denen Nutzer Knowledge Catalog-Ressourcen in einem Projekt abrufen und auflisten können. Weitere Informationen finden Sie unter Knowledge Catalog-Berechtigungen.
Sie können Knowledge 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 Knowledge 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 Knowledge Catalog-Ressourcen:
| Rolle | Beschreibung |
|---|---|
| Dataplex-Administrator ( roles/dataplex.admin) |
Vollständiger Zugriff auf Knowledge Catalog-Ressourcen. |
| Dataplex-Bearbeiter ( roles/dataplex.editor) |
Bearbeitungszugriff auf Knowledge Catalog-Ressourcen. |
| Dataplex-Betrachter ( roles/dataplex.viewer) |
Lesezugriff auf Knowledge 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 Rollen für den Knowledge Catalog und die Berechtigungen für die einzelnen Rollen aufgeführt:
| 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 eintragbezogene Vorgänge.
- Gewährt vollständigen Zugriff auf Vorgänge im Zusammenhang mit Einstiegslinks.
- Gewährt Berechtigungen zum Hinzufügen von Aspekten zu Einträgen einiger Systemaspekttypen, z. B.
Schema,Generic,OverviewundContacts. - Erteilt Berechtigungen zum Hinzufügen von Aspekten zu Eintragslinks einiger Systemaspekttypen, z. B.
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 gewähren, in denen die Eintragstypen und Aspekttypen definiert sind. - Mit dieser Rolle können Sie alle verfügbaren Einstiegslinks mit den erforderlichen Aspekten erstellen.
- Mit dieser Rolle werden keine Berechtigungen zum Lesen von Einträgen erteilt, die aus Google Cloud -Ressourcen außerhalb des Wissenskatalogs erstellt wurden, z. B. BigQuery-Einträge, wenn die Methoden
LookupEntry,SearchEntriesoderModifyEntryverwendet werden. 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 mit der Rolle Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner) mit der MethodeGetEntrylesen oder den Eintrag mit der MethodeUpdateEntryändern.
Überlegungen zur Rolle
Keine Rolle gewährt Berechtigungen zum Hinzufügen oder Löschen von Knowledge Catalog-Einträgen aus systemdefinierten Eintragsgruppen wie
@bigqueryund@dataplex.Wenn Sie die Datenaspekte eines Eintrags aufrufen möchten, benötigen Sie neben den Berechtigungen zum Aufrufen des Eintrags auch Berechtigungen zum Lesen von Daten aus dem Quellasset, das der Eintrag repräsentiert. Wenn Sie die Berechtigung zum Ansehen eines Eintrags haben, aber nicht die Berechtigung zum Lesen der Daten für das Quellasset, können Sie trotzdem alle anderen Metadaten des Eintrags ansehen. Im Knowledge Catalog wird der Inhalt aller angehängten Datenaspekte jedoch ausgeblendet.
Mit den Rollen Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) und Dataplex Catalog Editor (roles/dataplex.catalogEditor) werden Berechtigungen zum Aufrufen benutzerdefinierter Einträge gewährt.Wenn Sie mit der Methode
SearchEntriesnach Einträgen suchen möchten, benötigen Sie mindestens eine der folgenden IAM-Rollen für das im API-Aufruf verwendete Projekt: 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
Um auf die Herkunft eines Knowledge Catalog-Eintrags zuzugreifen, benötigen Sie eine Betrachterrolle für die entsprechende Systemressource oder die Dataplex Catalog-Betrachterrolle (roles/dataplex.catalogViewer) für das Projekt, in dem der Knowledge 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-Betrachter“
Mit der Rolle „Data Lineage Viewer“ (roles/datalineage.viewer) können Sie die Herkunft des Knowledge Catalog in der Google Cloud -Konsole ansehen und Herkunftsinformationen mit der Data Lineage API lesen. Die Läufe und Ereignisse für einen bestimmten Prozess werden alle im selben Projekt wie der Prozess gespeichert. Bei automatisiertem Lineage werden die Prozesse, Ausführungen und Ereignisse in dem Projekt gespeichert, in dem der Job ausgeführt wurde, der den Lineage generiert hat. Das kann beispielsweise das Projekt sein, in dem ein BigQuery-Job ausgeführt wurde.
Wenn Sie die Herkunft von Assets ansehen möchten, benötigen Sie die Rolle „Data Lineage Viewer“ (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. Sie benötigen die Rolle für die folgenden Projekte:
- Das Projekt, in dem Sie den Datenursprung aufrufen (als aktives Projekt bezeichnet), d. h. das Projekt im Drop-down-Menü oben in der Google Cloud Console oder das Projekt, aus dem API-Aufrufe erfolgen. Dies ist in der Regel das Projekt, das die Ressourcen enthält, die Sie in Knowledge Catalog erstellen oder auf die Sie in anderen Google Cloud Systemen mit der API zugreifen.
- Die Projekte, in denen der Datenursprung aufgezeichnet wird (als Compute-Projekt bezeichnet). Die Herkunft wird in dem Projekt gespeichert, in dem der entsprechende Prozess ausgeführt wurde, wie oben beschrieben. Dieses Projekt kann sich von dem Projekt unterscheiden, in dem das Asset gespeichert ist, für das Sie den Datenursprung ansehen.
Um Asset-Metadaten aufzurufen, benötigen Sie dieselben Rollen, die auch für den Zugriff auf Metadateneinträge im Knowledge 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 ermöglichen (siehe Einzelne Rolle zuweisen oder widerrufen).
Rollen zum Ansehen von Asset-Metadaten beim Ansehen des Lineage-Diagramms
Wenn Sie Metadaten zu einem Asset aufrufen möchten, das im Knowledge Catalog gespeichert ist, benötigen Sie eine Betrachterrolle für die entsprechende Systemressource oder die Dataplex Catalog-Betrachterrolle (roles/dataplex.catalogViewer) für das Projekt, in dem der Knowledge Catalog-Eintrag gespeichert ist. Möglicherweise haben Sie über entsprechende Betrachterrollen Zugriff auf Assets im Herkunftsdiagramm oder in der Liste, aber nicht auf die Herkunft zwischen ihnen. Dies tritt auf, wenn Sie nicht die Rolle „Data Lineage-Betrachter“ (roles/datalineage.viewer) für das Projekt haben, in dem die Herkunft aufgezeichnet wurde.
In diesem Fall wird die Herkunft in der Data Lineage API und der Google Cloud -Konsole nicht angezeigt und es wird kein Fehler zurückgegeben. So wird verhindert, dass Informationen über das Vorhandensein von Herkunftsinformationen preisgegeben werden. Wenn die Herkunft eines Assets nicht angezeigt wird, bedeutet das also nicht, dass keine Herkunft vorhanden ist, sondern dass Sie möglicherweise nicht berechtigt sind, sie aufzurufen.
Metadatenrollen
Mit Metadatenrollen werden Berechtigungen zum Aufrufen und Aktualisieren von Metadaten wie Tabellenschemas gewährt.
| 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
Im Knowledge Catalog werden die folgenden IAM-Rollen definiert, die für alle von Knowledge Catalog verwalteten Ressourcen gelten. Weitere Informationen zu den Berechtigungen, die mit den einzelnen Rollen verknüpft sind, finden Sie in diesem Dokument im Abschnitt Vordefinierte Rollen.
| Rolle | Beschreibung |
|---|---|
| Dataplex-Dateninhaber ( roles/dataplex.dataOwner) |
Vollständiger Zugriff auf die verwaltete Ressource und ihre untergeordneten Elemente. Berechtigungen umfassen das Aktualisieren von Metadaten, das Erstellen untergeordneter Ressourcen und das Erteilen detaillierter Berechtigungen. |
| Dataplex-Datenleser ( roles/dataplex.dataReader) |
Lesezugriff auf Daten und Metadaten in der verwalteten Ressource und ihren untergeordneten Elementen. |
| Dataplex-Datenautor ( roles/dataplex.dataWriter) |
Schreibzugriff auf Daten in der verwalteten Ressource. Dazu gehört das Erstellen, Aktualisieren und Löschen von Daten, aber nicht von Metadaten. |
Nächste Schritte
- Benutzerdefinierte IAM-Rollen erstellen
- Rollen gewähren und verwalten
- IAM-Berechtigungen für den Wissenskatalog