In diesem Dokument wird beschrieben, wie Sie IAM-Rollen und -Berechtigungen (Identity and Access Management) verwenden, um den Zugriff auf Logdaten in der Logging API, dem Log-Explorer und der Google Cloud CLI zu steuern.
Übersicht
IAM-Berechtigungen und -Rollen bestimmen Ihre Fähigkeit, auf Logdaten in der Logging API, dem Log-Explorer und der Google Cloud CLI zuzugreifen.
Eine Rolle ist eine Sammlung von Berechtigungen. Sie können einem Hauptkonto Berechtigungen nicht direkt erteilen. Stattdessen weisen Sie ihm eine Rolle zu. Wenn Sie einem Hauptkonto eine Rolle zuweisen, erhält er alle mit ihr verknüpften Berechtigungen. Einem Hauptkonto können mehrere Rollen zugewiesen werden.
Wenn Sie Logging innerhalb einer Google Cloud Ressource wie einem Google Cloud Projekt, Ordner, Bucket oder einer Organisation verwenden möchten, muss ein Prinzipal eine IAM-Rolle mit den entsprechenden Berechtigungen haben.
Vordefinierte Rollen
IAM bietet vordefinierte Rollen, mit denen detaillierter Zugriff auf bestimmte Google Cloud -Ressourcen gewährt und unerwünschter Zugriff auf andere Ressourcen verhindert werden kann. Google Cloud erstellt und verwaltet diese Rollen und aktualisiert ihre Berechtigungen bei Bedarf automatisch, z. B. wenn Logging neue Funktionen hinzufügt.
In der folgenden Tabelle sind die vordefinierten Rollen für Logging aufgeführt. Für jede Rolle werden der Titel, die Beschreibung, die enthaltenen Berechtigungen und der Ressourcentyp der untersten Ebene angezeigt, für den die Rollen gewährt werden können. Sie können die vordefinierten Rollen auf Google Cloud Projektebene oder in den meisten Fällen auf einer beliebigen höheren Ebene in der Ressourcenhierarchie zuweisen. Wenn Sie die Rolle „Logs View Accessor“ auf eine Logansicht in einem Bucket beschränken möchten, verwenden Sie Ressourcenattribute für IAM-Bedingungen.
Eine Liste aller einzelnen Berechtigungen, die in einer Rolle enthalten sind, finden Sie unter Rollenmetadaten abrufen.
Role | Permissions |
---|---|
Logging Admin( Provides all permissions necessary to use all features of Cloud Logging. Lowest-level resources where you can grant this role:
|
|
Logs Bucket Writer( Ability to write logs to a log bucket. Lowest-level resources where you can grant this role:
|
|
Logs Configuration Writer( Provides permissions to read and write the configurations of logs-based metrics and sinks for exporting logs. Lowest-level resources where you can grant this role:
|
|
Log Field Accessor( Ability to read restricted fields in a log bucket. Lowest-level resources where you can grant this role:
|
|
Log Link Accessor( Ability to see links for a bucket. |
|
Logs Writer( Provides the permissions to write log entries. Lowest-level resources where you can grant this role:
|
|
Private Logs Viewer( Provides permissions of the Logs Viewer role and in addition, provides read-only access to log entries in private logs. Lowest-level resources where you can grant this role:
|
|
Cloud Logging Service Agent( Grants a Cloud Logging Service Account the ability to create and link datasets. |
|
SQL Alert Writer Beta( Ability to write SQL Alerts. |
|
Logs View Accessor( Ability to read logs in a view. Lowest-level resources where you can grant this role:
|
|
Logs Viewer( Provides access to view logs. Lowest-level resources where you can grant this role:
|
|
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Ihnen bei der Entscheidung helfen, welche Rollen für die Anwendungsfälle Ihrer Hauptkonten gelten.
Loggingrollen
Wenn ein Nutzer alle Aktionen in Logging ausführen soll, weisen Sie ihm die Rolle „Logging-Administrator“ (
roles/logging.admin
) zu.Wenn ein Nutzer Logkonfigurationen erstellen und ändern soll, weisen Sie ihm die Rolle „Autor von Logkonfigurationen“ (
roles/logging.configWriter
) zu. Mit dieser Rolle können Sie Folgendes erstellen oder ändern:Diese Rolle reicht nicht aus, um logbasierte Messwerte oder logbasierte Benachrichtigungsrichtlinien zu erstellen. Informationen zu den für diese Aufgaben erforderlichen Rollen finden Sie unter Berechtigungen für logbasierte Messwerte und Berechtigungen für logbasierte Benachrichtigungsrichtlinien.
Damit ein Nutzer Logs in den Buckets
_Required
und_Default
lesen oder die Seiten Log-Explorer und Loganalysen verwenden kann, weisen Sie ihm eine der folgenden Rollen zu:- Wenn Sie Zugriff auf alle Logs im
_Required
-Bucket und auf die Ansicht_Default
im_Default
-Bucket benötigen, weisen Sie die Rolle „Log-Betrachter“ (roles/logging.viewer
) zu. - Wenn Sie Zugriff auf alle Logs in den Buckets
_Required
und_Default
, einschließlich der Logs zum Datenzugriff, benötigen, weisen Sie die Rolle „Betrachter privater Logs“ (roles/logging.privateLogViewer
) zu.
- Wenn Sie Zugriff auf alle Logs im
Wenn ein Nutzer Logs in allen Logansichten eines Projekts lesen soll, weisen Sie ihm die IAM-Rolle
roles/logging.viewAccessor
für das Projekt zu.Wenn ein Nutzer nur Logs in einer bestimmten Logansicht lesen soll, haben Sie zwei Möglichkeiten:
Erstellen Sie eine IAM-Richtlinie für die Logansicht und fügen Sie dann eine IAM-Bindung für diese Richtlinie hinzu, die dem Hauptkonto Zugriff auf die Logansicht gewährt.
Weisen Sie dem Hauptkonto die IAM-Rolle
roles/logging.viewAccessor
für das Projekt zu, das die Logansicht enthält, aber fügen Sie eine IAM-Bedingung hinzu, um die Zuweisung auf die jeweilige Logansicht zu beschränken.
Informationen zum Erstellen von Log-Ansichten und zum Gewähren des Zugriffs finden Sie unter Log-Ansichten für einen Log-Bucket konfigurieren.
- Wenn Sie einem Nutzer Zugriff auf eingeschränkte
LogEntry
-Felder in einem bestimmten Log-Bucket gewähren möchten, weisen Sie ihm die Rolle „Zugriffsberechtigter für Logs-Feld“ (roles/logging.fieldAccessor
) zu. Weitere Informationen finden Sie unter Zugriff auf Feldebene konfigurieren.
Wenn ein Nutzer Logs mit der Logging API schreiben soll, weisen Sie ihm die Rolle „Log-Autor“ (
roles/logging.logWriter
) zu. Diese Rolle gewährt keine Berechtigungen zum Betrachten.Damit das Dienstkonto einer Senke Logs an einen Bucket in einem anderen Google Cloud Projekt weiterleiten kann, weisen Sie dem Dienstkonto die Rolle „Log-Bucket-Autor“ (
roles/logging.bucketWriter
) zu. Eine Anleitung zum Erteilen von Berechtigungen für ein Dienstkonto finden Sie unter Zielberechtigungen festlegen.
Rollen auf Projektebene
Um den meisten Google Cloud Diensten Lesezugriff zu gewähren, weisen Sie die Rolle „Betrachter“ (
roles/viewer
) zu.Diese Rolle enthält alle Berechtigungen der Rolle „Logbetrachter“ (
roles/logging.viewer
).Wenn Sie Bearbeiterzugriff auf die meisten Google Cloud Dienste gewähren möchten, weisen Sie die Rolle „Bearbeiter“ (
roles/editor
) zu.Diese Rolle umfasst alle Berechtigungen der Rolle „Loganzeige“ (
roles/logging.viewer
) sowie die Berechtigungen zum Schreiben von Logeinträgen, zum Löschen von Logs und zum Erstellen logbasierter Messwerte. Mit dieser Rolle können Nutzer jedoch keine Senken erstellen, keine Audit-Logs zum Datenzugriff im Bucket_Default
lesen und keine Logs in benutzerdefinierten Log-Buckets lesen.Um vollen Zugriff auf die meisten Google Cloud -Dienste zu gewähren, weisen Sie die Rolle „Inhaber“ (
roles/owner
) zu.
Rollen werden gewährt
Informationen zum Zuweisen von Rollen an Hauptkonten finden Sie unter Zugriff erteilen, ändern und entziehen.
Einem Nutzer können mehrere Rollen zugewiesen werden. Eine Liste der in einer Rolle enthaltenen Berechtigungen finden Sie unter Rollenmetadaten abrufen.
Wenn Sie versuchen, auf eine Google Cloud -Ressource zuzugreifen und nicht die erforderlichen Berechtigungen haben, wenden Sie sich an den Hauptkonto, der als Inhaber der Ressource aufgeführt ist.
Benutzerdefinierte Rollen
So erstellen Sie eine benutzerdefinierte Rolle mit Logging-Berechtigungen:
Wählen Sie für eine Rolle, die Berechtigungen für die Logging API gewährt, Berechtigungen unter API-Berechtigungen aus. Folgen Sie dann der Anleitung zum Erstellen einer benutzerdefinierten Rolle.
Wählen Sie für eine Rolle, die Berechtigungen zur Verwendung von Log-Explorer gewährt, aus Berechtigungsgruppen aus , die sind in Console-Berechtigungen und folgen Sie dann der Anleitung zum Erstellen einer Benutzerdefinierte Rolle.
Für eine Rolle, die Berechtigungen zur Verwendung von
gcloud logging
gewährt, finden Sie im Abschnitt Befehlszeilenberechtigungen auf dieser Seite Informationen. Folgen Sie dann der Anleitung zum Erstellen einer benutzerdefinierten Rolle.
Weitere Informationen zu benutzerdefinierten Rollen finden Sie unter Informationen zu benutzerdefinierten IAM-Rollen.
Cloud Logging-Berechtigungen
Die folgende Tabelle enthält eine Teilliste der Berechtigungen, die für bestimmte Funktionen von Cloud Logging erforderlich sind. Anhand dieser Tabelle können Sie die Berechtigungen ermitteln, die Sie für die Verwendung von Seiten wie dem Log-Explorer benötigen.
a.b.{x,y}
bedeutet in der Tabelle a.b.x
und a.b.y
.
Console-Aktivität | Erforderliche Berechtigung |
---|---|
Minimaler Lesezugriff | logging.logEntries.list |
Audit-Logs zum Datenzugriff ansehen | logging.privateLogEntries.list |
Logbasierte Messwerte ansehen | logging.logMetrics.{list, get} |
Senken ansehen | logging.sinks.{list, get} |
Log-Nutzung ansehen | logging.usage.get |
Logs herunterladen | logging.logEntries.{list, download}
Nur eine dieser Berechtigungen ist erforderlich, um Logs herunterzuladen. Rollen mit den Berechtigungen zum Herunterladen von Logs müssen auf Projektebene gewährt werden. Sie können keine Logs herunterladen, wenn eine Rolle mit diesen Berechtigungen in der IAM-Richtliniendatei einer Logansicht gewährt wird. |
Logbereiche auflisten und ansehen | logging.logScopes.{get, list} |
Standardlogbereich ansehen | observability.scopes.get |
Logs ausschließen | logging.exclusions.{list, create, get, update, delete}
Wenn Sie eine benutzerdefinierte Rolle erstellen, die Berechtigungen zum Verwalten von Ausschlussfiltern enthält, fügen Sie der Rolle die Berechtigungen |
Senken erstellen und verwenden | logging.sinks.{list, create, get, update, delete}
Beim Erstellen einer Senke müssen Sie dem Dienstkonto auch eine IAM-Rolle zuweisen, mit der es Logeinträge in das Ziel schreiben kann. Weitere Informationen finden Sie unter Zielberechtigungen festlegen. Nachdem Ihre Logeinträge an ein unterstütztes Ziel weitergeleitet wurden, wird der Zugriff auf die Logeinträge vollständig durch IAM-Berechtigungen und -Rollen für das Ziel gesteuert. |
Logbasierte Benachrichtigungen erstellen | Weitere Informationen finden Sie unter Erforderliche Rollen zum Erstellen und Verwenden von logbasierten Benachrichtigungsrichtlinien. |
Logbasierte Messwerte erstellen | logging.logMetrics.{list, create, get, update, delete}
Informationen zu anderen IAM-Rollen, die Sie zum Erstellen und Verwenden von logbasierten Messwerten benötigen, finden Sie unter Erforderliche Rollen zum Erstellen und Verwenden von logbasierten Messwerten. |
Private Abfragen speichern und verwenden | logging.queries.usePrivate logging.queries.{listShared,getShared} |
Freigegebene Abfragen speichern und verwenden | logging.queries.{share, getShared, updateShared, deleteShared,
listShared} |
Aktuelle Abfragen verwenden | logging.queries.{create, list} |
Logbereiche erstellen und verwalten | logging.logScopes.{create, delete, get, list, update} |
Standardmäßigen Logbereich festlegen und verwalten | observability.scopes.{get, update} |
Analytics-Datenansichten erstellen und verwalten | observability.analyticsViews.{create, delete, get, list, update} |
Verknüpfte Datasets erstellen und verwalten | logging.links.{create, delete, get, list}
Möglicherweise benötigen Sie zusätzliche IAM-Rollen, um das verknüpfte Dataset abzufragen. Mit diesen Berechtigungen erhalten Sie beispielsweise keinen Zugriff auf die BigQuery-Benutzeroberfläche. Weitere Informationen finden Sie unter BigQuery: Zugriffssteuerung mit IAM. |
Berechtigungen für die Befehlszeile
gcloud logging
-Befehle werden durch IAM-Berechtigungen gesteuert.
Um einen der gcloud logging
-Befehle zu verwenden, benötigen Principals die Berechtigung serviceusage.services.use
.
Ein Hauptkonto muss außerdem die IAM-Rolle haben, die der Ressource des Logs und dem Anwendungsfall entspricht. Weitere Informationen finden Sie unter Berechtigungen der Befehlszeilenschnittstelle.
Rollen, die zum Erstellen und Verwenden von logbasierten Messwerten erforderlich sind
Es folgt eine Zusammenfassung der allgemeinen Rollen und Berechtigungen, die ein Hauptkonto benötigt, um auf logbasierte Messwerte zuzugreifen:
Mit der Rolle Autor von Log-Konfigurationen (
roles/logging.configWriter
) können Hauptkonten logbasierte Messwerte auflisten, erstellen, abrufen, aktualisieren und löschen.Die Rolle Log-Betrachter (
roles/logging.viewer
) enthält Berechtigungen zum Aufrufen vorhandener Messwerte. Ein Prinzipal benötigt die Berechtigungenlogging.logMetrics.get
undlogging.logMetrics.list
, um vorhandene Messwerte aufzurufen.Die Rolle Monitoring-Betrachter (
roles/monitoring.viewer
) enthält die Berechtigungen zum Lesen von TimeSeries. Insbesondere benötigt ein Hauptkonto die Berechtigungmonitoring.timeSeries.list
, um Zeitachsendaten zu lesen.Die Rollen Logging-Administrator (
roles/logging.admin
), Projektbearbeiter (roles/editor
) und Projektinhaber (roles/owner
) enthalten die Berechtigungen zum Erstellen logbasierter Messwerte. Insbesondere benötigt ein Prinzipal die Berechtigunglogging.logMetrics.create
, um logbasierte Messwerte zu erstellen.
Zum Erstellen und Verwenden logbasierter Benachrichtigungsrichtlinien erforderliche Rollen
Zum Erstellen und Verwalten von logbasierten Benachrichtigungsrichtlinien benötigt ein Prinzipal die folgenden Logging- und Monitoring-Rollen und -Berechtigungen:
-
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von logbasierten Benachrichtigungsrichtlinien in Monitoring und zum Erstellen der zugehörigen Benachrichtigungsregeln in Logging benötigen:
-
Mitbearbeiter von Monitoring-Benachrichtigungsrichtlinien (
roles/monitoring.alertPolicyEditor
) -
Autor von Log-Konfigurationen (
roles/logging.configWriter
)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen von logbasierten Benachrichtigungsrichtlinien in Monitoring und zum Erstellen der zugehörigen Benachrichtigungsregeln in Logging erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um logbasierte Benachrichtigungsrichtlinien in Monitoring und die zugehörigen Benachrichtigungsregeln in Logging zu erstellen:
-
monitoring.alertPolicies.create
-
logging.notificationRules.create
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
-
Mitbearbeiter von Monitoring-Benachrichtigungsrichtlinien (
Wenn Sie Ihre Benachrichtigungsrichtlinie in der Google Cloud CLI erstellen, ist auch die folgende Rolle oder Berechtigung erforderlich:
-
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer
) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Erstellen einer Benachrichtigungsrichtlinie mit der Google Cloud CLI benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.Diese vordefinierte Rolle enthält die Berechtigung
serviceusage.services.use
, die zum Erstellen einer Benachrichtigungsrichtlinie mit der Google Cloud CLI erforderlich ist.Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Wenn in Ihrem Google Cloud -Projekt bereits Benachrichtigungskanäle vorhanden sind, können Sie Ihre Benachrichtigungsrichtlinie so konfigurieren, dass ein vorhandener Kanal verwendet wird. Dazu sind keine zusätzlichen Rollen oder Berechtigungen erforderlich. Wenn Sie jedoch einen Benachrichtigungskanal für Ihre logbasierte Benachrichtigungsrichtlinie erstellen müssen, ist die folgende Rolle oder Berechtigung erforderlich:
-
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring NotificationChannel Editor (
roles/monitoring.notificationChannelEditor
) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Erstellen eines Benachrichtigungschannels für eine logbasierte Benachrichtigungsrichtlinie benötigen.Diese vordefinierte Rolle enthält die Berechtigung
monitoring.notificationChannels.create
, die zum Erstellen eines Benachrichtigungschannels für eine logbasierte Benachrichtigungsrichtlinie erforderlich ist.
Berechtigungen für SQL-basierte Benachrichtigungsrichtlinien
SQL-basierte Benachrichtigungsrichtlinien werten die Ergebnisse einer SQL-Abfrage aus, die für Daten aus Gruppen von Logeinträgen ausgeführt wird. Informationen zu den Rollen, die zum Erstellen und Verwalten von SQL-basierten Benachrichtigungsrichtlinien erforderlich sind, finden Sie im Abschnitt Vorbereitung unter SQL-Abfrageergebnisse mit einer Benachrichtigungsrichtlinie überwachen.
Zugriffsbereiche in Logging
Zugriffsbereiche sind die Legacy-Methode zum Festlegen von Berechtigungen für die Dienstkonten in Ihren Compute Engine-VM-Instanzen.
Für die Logging API gelten folgende Zugriffsbereiche:
Zugriffsbereich | Erteilte Berechtigungen |
---|---|
https://www.googleapis.com/auth/logging.read | roles/logging.viewer |
https://www.googleapis.com/auth/logging.write | roles/logging.logWriter |
https://www.googleapis.com/auth/logging.admin | Uneingeschränkter Zugriff auf die Logging API |
https://www.googleapis.com/auth/cloud-platform | Uneingeschränkter Zugriff auf die Logging API sowie alle anderen aktivierten Google Cloud APIs |
Informationen zum Festlegen der Zugriffsebenen Ihrer Dienstkonten mit dieser Legacy-Methode finden Sie unter Zugriffsbereiche.