Informationen zum Audit-Logging von Resource Manager

In diesem Dokument werden die Audit-Logs beschrieben, die von Resource Manager als Teil von Cloud-Audit-Logs erstellt werden.

Übersicht

Google Cloud-Dienste schreiben Audit-Logs, aus denen in Bezug auf Ihre Google Cloud-Ressourcen hervorgeht, wer was wo und wann getan hat.

Ihre Google Cloud-Projekte enthalten nur die Audit-Logs für Ressourcen, die sich direkt im Google Cloud-Projekt befinden. Andere Google Cloud-Ressourcen wie Ordner, Organisationen und Rechnungskonten enthalten jeweils eigene Audit-Logs.

Eine allgemeine Übersicht über Cloud-Audit-Logs finden Sie unter Cloud-Audit-Logs. Detaillierte Informationen zum Format von Audit-Logs finden Sie unter Audit-Logs verstehen.

Verfügbare Audit-Logs

Für Resource Manager sind folgende Arten von Audit-Logs verfügbar:

• Audit-Logs zur Administratoraktivität

  Umfasst „Admin Write“-Vorgänge, die Metadaten oder Konfigurationsinformationen schreiben.

  Sie können Audit-Logs zu Administratoraktivitäten nicht deaktivieren.

• Audit-Logs zum Datenzugriff

  Umfasst „Admin Read“-Vorgänge“, die Metadaten oder Konfigurationsinformationen lesen. Umfasst auch „Data Read“- und „Data Write“-Vorgänge, die von Nutzern bereitgestellte Daten lesen oder schreiben.

  Um Datenzugriffs-Audit-Logs zu erhalten, müssen Sie sie explizit aktivieren.

Ausführlichere Beschreibungen der Audit-Logtypen finden Sie unter Arten von Audit-Logs.

Geprüfte Vorgänge

In der folgenden Tabelle ist zusammengefasst, welche API-Vorgänge dem jeweiligen Audit-Log-Typ in Resource Manager entsprechen:

Audit-Log-Kategorie	Resource Manager-Vorgänge
Administratoraktivitätenlogs (ADMIN_WRITE)	UpdateContactInfo v3: cloudresourcemanager.v3.organizations.setIamPolicy cloudresourcemanager.v3.folders.create cloudresourcemanager.v3.folders.delete cloudresourcemanager.v3.folders.move cloudresourcemanager.v3.folders.patch cloudresourcemanager.v3.folders.setIamPolicy cloudresourcemanager.v3.folders.undelete cloudresourcemanager.v3.projects.create cloudresourcemanager.v3.projects.delete cloudresourcemanager.v3.projects.move cloudresourcemanager.v3.projects.patch cloudresourcemanager.v3.projects.setIamPolicy cloudresourcemanager.v3.projects.undelete cloudresourcemanager.v3.tagBindings.create cloudresourcemanager.v3.tagBindings.delete cloudresourcemanager.v3.tagKeys.create cloudresourcemanager.v3.tagKeys.delete cloudresourcemanager.v3.tagKeys.patch cloudresourcemanager.v3.tagKeys.setIamPermissions cloudresourcemanager.v3.tagValues.create cloudresourcemanager.v3.tagValues.delete cloudresourcemanager.v3.tagValues.patch cloudresourcemanager.v3.tagValues.setIamPermissions v2beta1: cloudresourcemanager.v2beta1.folders.create cloudresourcemanager.v2beta1.folders.delete cloudresourcemanager.v2beta1.folders.move cloudresourcemanager.v2beta1.folders.update cloudresourcemanager.v2beta1.folders.setIamPolicy cloudresourcemanager.v2beta1.folders.undelete v2: cloudresourcemanager.v2.folders.create cloudresourcemanager.v2.folders.delete cloudresourcemanager.v2.folders.move cloudresourcemanager.v2.folders.update cloudresourcemanager.v2.folders.setIamPolicy cloudresourcemanager.v2.folders.undelete v1beta1: cloudresourcemanager.v1beta1.organizations.setIamPolicy cloudresourcemanager.v1beta1.organizations.update cloudresourcemanager.v1beta1.projects.create cloudresourcemanager.v1beta1.projects.delete cloudresourcemanager.v1beta1.projects.setIamPolicy cloudresourcemanager.v1beta1.projects.undelete cloudresourcemanager.v1beta1.projects.update v1: cloudresourcemanager.v1.folders.clearOrgPolicy cloudresourcemanager.v1.folders.setOrgPolicy cloudresourcemanager.v1.organizations.clearOrgPolicy cloudresourcemanager.v1.organizations.setIamPolicy cloudresourcemanager.v1.organizations.setOrgPolicy cloudresourcemanager.v1.projects.clearOrgPolicy cloudresourcemanager.v1.projects.create cloudresourcemanager.v1.projects.delete cloudresourcemanager.v1.projects.setIamPolicy cloudresourcemanager.v1.projects.setOrgPolicy cloudresourcemanager.v1.projects.undelete cloudresourcemanager.v1.projects.update
Datenzugriff (ADMIN_READ)	GetContactInfo v3: cloudresourcemanager.v3.organizations.get cloudresourcemanager.v3.organizations.getIamPolicy cloudresourcemanager.v3.organizations.search cloudresourcemanager.v3.organizations.testIamPermissions cloudresourcemanager.v3.folders.get cloudresourcemanager.v3.folders.getIamPolicy cloudresourcemanager.v3.folders.list cloudresourcemanager.v3.folders.search cloudresourcemanager.v3.folders.testIamPermissions cloudresourcemanager.v3.projects.get cloudresourcemanager.v3.projects.getIamPolicy cloudresourcemanager.v3.projects.list cloudresourcemanager.v3.projects.search cloudresourcemanager.v3.projects.testIamPermissions cloudresourcemanager.v3.tagKeys.get cloudresourcemanager.v3.tagKeys.getIamPolicy cloudresourcemanager.v3.tagKeys.list cloudresourcemanager.v3.tagKeys.testIamPermissions cloudresourcemanager.v3.tagValues.get cloudresourcemanager.v3.tagValues.getIamPolicy cloudresourcemanager.v3.tagValues.list cloudresourcemanager.v3.tagValues.testIamPermissions v2beta1: cloudresourcemanager.v2beta1.folders.get cloudresourcemanager.v2beta1.folders.getIamPolicy cloudresourcemanager.v2beta1.folders.list v2: cloudresourcemanager.v2.folders.get cloudresourcemanager.v2.folders.getIamPolicy cloudresourcemanager.v2.folders.list v1beta1: cloudresourcemanager.v1beta1.organizations.get cloudresourcemanager.v1beta1.organizations.getIamPolicy cloudresourcemanager.v1beta1.projects.get cloudresourcemanager.v1beta1.projects.getIamPolicy v1: cloudresourcemanager.v1.folders.getEffectiveOrgPolicy cloudresourcemanager.v1.folders.getOrgPolicy cloudresourcemanager.v1.folders.listAvailableOrgPolicyConstraints cloudresourcemanager.v1.folders.listOrgPolicies cloudresourcemanager.v1.organizations.get cloudresourcemanager.v1.organizations.getEffectiveOrgPolicy cloudresourcemanager.v1.organizations.getIamPolicy cloudresourcemanager.v1.organizations.getOrgPolicy cloudresourcemanager.v1.organizations.listAvailableOrgPolicyConstraints cloudresourcemanager.v1.organizations.listOrgPolicies cloudresourcemanager.v1.projects.get cloudresourcemanager.v1.projects.getEffectiveOrgPolicy cloudresourcemanager.v1.projects.getIamPolicy cloudresourcemanager.v1.projects.listAvailableOrgPolicyConstraints cloudresourcemanager.v1.projects.listOrgPolicies
Logs zum Datenzugriff (ADMIN_READ unter dem Namen des zu integrierenden Dienstes)^[1]	v3: cloudresourcemanager.v3.tagBindings.list cloudresourcemanager.v3.effectiveTags.list
Logs zum Datenzugriff (ADMIN_READ unter „Organization Policy Service“)^[2]	v2: orgpolicy.policies.getEffectivePolicy

^[1] ADMIN_READ muss für die jeweilige Ressource, an die das Tag angehängt ist, unter dem Dienst aktiviert sein, damit dieses Protokoll aktiviert werden kann.

^[2] ADMIN_READ muss unter der Organization Policy Service API aktiviert sein, damit dieses Protokoll aktiviert werden kann.

Hinweis: Die Audit-Logs für projects.delete-Vorgänge werden in die übergeordnete Ressource des Projekts geschrieben, die nicht unbedingt die Organisationsressource ist.

Die Audit-Logs für Tag-Vorgänge in anderen Diensten wie cloudsql.instances.listEffectiveTags werden in das übergeordnete Element der Ressource geschrieben und in Resource Manager-Audit-Logs aufgenommen. Sie sind nicht in den Audit-Logs der Dienstressource enthalten. Wenn Sie diese Logs sehen möchten, müssen Sie ADMIN_READ unter dem Dienst für die jeweilige Ressource aktivieren, an die das Tag angehängt ist.

Die Vorgänge GetContactInfo und UpdateContactInfo unterstützen den Dienst ContactInfo für die Datenschutz-Grundverordnung (DSGVO) der EU. Mit diesen Vorgängen werden Kontaktdaten für einen EU-Bevollmächtigten und einen Datenschutzbeauftragten aktualisiert bzw. abgerufen. Diese können in der Google Cloud Console auf der Seite Datenschutz und Sicherheit der Google Cloud geändert werden.

Audit-Logformat

Audit-Logeinträge umfassen folgende Komponenten:

• Den Logeintrag selbst. Dabei handelt es sich um ein Objekt vom Typ LogEntry. Interessante Felder sind unter anderem:

  • logName enthält die Ressourcen-ID und den Audit-Logtyp.
  • resource enthält das Ziel zum geprüften Vorgang.
  • timeStamp enthält die Uhrzeit des geprüften Vorgangs
  • protoPayload enthält die geprüften Informationen

• Die Audit-Logdaten, bei denen es sich um ein AuditLog-Objekt handelt, das sich im Feld protoPayload des Logeintrags befindet

• Optionale dienstspezifische Auditinformationen. Das Objekt ist dienstspezifisch. Bei früheren Integrationen befindet sich dieses Objekt im Feld serviceData des AuditLog-Objekts. Spätere Integrationen verwenden das Feld metadata.

Informationen zu anderen Feldern in diesen Objekten sowie zu deren Interpretation finden Sie unter Audit-Logs verstehen.

Logname

Lognamen von Cloud-Audit-Logs enthalten Ressourcenkennungen, die das Google Cloud-Projekt oder eine andere Google Cloud-Entität angeben, die der Inhaber der Audit-Logs ist. Außerdem zeigen sie an, ob das Log Audit-Logging-Daten zu Administratoraktivitäten, Datenzugriff, Richtlinienverweigerung oder Audit-Systemereignissen enthält.

Im Folgenden finden Sie die Namen der Audit-Logs, einschließlich Variablen für die Ressourcenkennungen:

   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Factivity
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Factivity
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Factivity
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fpolicy

Hinweis: Der Teil des Lognamens nach /logs/ muss URL-codiert sein. Der Schrägstrich / muss als %2F geschrieben werden.

Dienstname

Für Audit-Logs von Resource Manager wird der Dienstname cloudresourcemanager.googleapis.com verwendet.

Eine vollständige Liste aller Cloud Logging API-Dienstnamen und des jeweiligen überwachten Ressourcentyps finden Sie unter Dienste Ressourcen zuordnen.

Ressourcentypen

Die Audit-Logs von Resource Manager verwenden bei allen Audit-Logs den Ressourcentyp project.

Eine Liste aller überwachten Cloud Logging-Ressourcentypen und beschreibende Informationen finden Sie unter Überwachte Ressourcentypen.

Aufruferidentitäten

Die IP-Adresse des Aufrufers wird im Feld RequestMetadata.caller_ip des AuditLog-Objekts gespeichert. In Logging können bestimmte Aufruferidentitäten und IP-Adressen entfernt werden.

Informationen dazu, welche Informationen in Audit-Logs entfernt werden, finden Sie unter Aufruferidentitäten in Audit-Logs.

Audit-Logging aktivieren

Audit-Logs zu Administratoraktivitäten sind immer aktiviert. Sie können sie nicht deaktivieren.

Audit-Logs zum Datenzugriff sind standardmäßig deaktiviert und werden nur geschrieben, wenn sie explizit aktiviert werden. Eine Ausnahme bilden die Audit-Logs zum Datenzugriff für BigQuery, die nicht deaktiviert werden können.

Informationen zum Aktivieren einiger oder aller Audit-Logs zum Datenzugriff finden Sie unter Audit-Logs zum Datenzugriff aktivieren.

Berechtigungen und Rollen

IAM-Berechtigungen und -Rollen bestimmen Ihre Fähigkeit, auf Audit-Logdaten in Google Cloud-Ressourcen zuzugreifen.

Berücksichtigen Sie Folgendes bei der Entscheidung, welche Logging-spezifischen Berechtigungen und Rollen für Ihren Anwendungsfall gelten:

• Die Rolle „Log-Betrachter“ (roles/logging.viewer) bietet Ihnen Lesezugriff auf die Audit-Logs zu Administratoraktivitäten, abgelehnten Richtlinien und Systemereignissen. Wenn Sie nur diese Rolle haben, können Sie keine Audit-Logs zum Datenzugriff aufrufen, die sich im Bucket _Default befinden.

• Die Rolle „Betrachter privater Logs“ ((roles/logging.privateLogViewer) enthält die Berechtigungen, die in roles/logging.viewer enthalten sind, sowie die Möglichkeit, Audit-Logs zum Datenzugriff im Bucket _Default zu lesen.

  Wenn diese privaten Logs in benutzerdefinierten Buckets gespeichert sind, kann jeder Nutzer, der Berechtigungen zum Lesen von Logs in diesen Buckets hat, die privaten Logs lesen. Weitere Informationen zu Log-Buckets finden Sie unter Routing und Speicher.

Weitere Informationen zu den IAM-Berechtigungen und -Rollen, die für Audit-Logdaten gelten, finden Sie unter Zugriffssteuerung mit IAM.

Logs ansehen

Sie können nach allen Audit-Logs oder nach dem Namen des Audit-Logs abfragen. Der Name des Audit-Logs enthält die Ressourcenkennung des Google Cloud-Projekts, des Ordners, des Rechnungskontos oder der Organisation, für die Sie Audit-Logging-Informationen aufrufen möchten. Sie können in Ihren Abfragen indexierte LogEntry-Felder angeben. Weitere Informationen zum Abfragen von Protokollen finden Sie unter Abfragen im Log-Explorer erstellen.

Im Log-Explorer können Sie einzelne Logeinträge aufrufen und filtern. Wenn Sie Gruppen von Logeinträgen mit SQL analysieren möchten, verwenden Sie die Seite Log Analytics. Weitere Informationen finden Sie unter:

• Logs in Log Analytics abfragen und ansehen
• Beispielabfragen für Sicherheitsinformationen.
• Abfrageergebnisse in Diagrammen darstellen

Die meisten Audit-Logs können in Cloud Logging mithilfe der Google Cloud Console, der Google Cloud CLI oder der Logging API aufgerufen werden. Für Audit-Logs im Zusammenhang mit der Abrechnung können Sie jedoch nur die Google Cloud CLI oder die Logging API verwenden.

Console

In der Google Cloud Console können Sie mit dem Log-Explorer die Audit-Logeinträge für Ihr Google Cloud-Projekt, Ihren Ordner oder Ihre Organisation abrufen:

Hinweis: Sie können keine Audit-Logs für Cloud-Rechnungskonten in der Google Cloud Console aufrufen. Sie müssen die API oder die gcloud CLI verwenden.

1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

   Zum Log-Explorer

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Logging ist.

2. Wählen Sie ein vorhandenes Google Cloud-Projekt, einen Ordner oder eine Organisation aus.

3. Wenn Sie alle Audit-Logs aufrufen möchten, geben Sie eine der folgenden Abfragen in das Feld des Abfrageeditors ein und klicken dann auf Abfrage ausführen:

   logName:"cloudaudit.googleapis.com"
   

   protoPayload."@type"="type.googleapis.com/google.cloud.audit.AuditLog"
   

4. So rufen Sie im Bereich Query Builder die Audit-Logs für eine bestimmte Ressource und einen bestimmten Audit-Logtyp auf:

   • Wählen Sie unter Ressourcentyp die Google Cloud-Ressource aus, deren Audit-Logs angezeigt werden sollen.

   • Wählen Sie unter Logname den Audit-Logtyp aus, den Sie sehen möchten:

     • Wählen Sie für Audit-Logs zu Administratoraktivitäten die Option activity aus.
     • Wählen Sie für Audit-Logs zum Datenzugriff die Option data_access aus.
     • Wählen Sie für Audit-Logs zu Systemereignissen die Option system_event aus.
     • Wählen Sie für Audit-Logs zu Richtlinienverstößen die Option policy aus.

   • Klicken Sie auf Abfrage ausführen.

   Wenn diese Optionen nicht angezeigt werden, sind im Google Cloud-Projekt, im Ordner oder in der Organisation keine Audit-Logs dieses Typs verfügbar.

   Wenn beim Aufrufen von Logs im Log-Explorer Probleme auftreten, lesen Sie die Informationen zur Fehlerbehebung.

   Weitere Informationen zu Abfragen mit dem Log-Explorer finden Sie unter Abfragen im Log-Explorer erstellen.

gcloud

Die Google Cloud CLI bietet eine Befehlszeile für die Logging API. Geben Sie in jedem Lognamen eine gültige Ressourcenkennung an. Wenn die Abfrage beispielsweise eine PROJECT_ID enthält, muss sich die von Ihnen angegebene Projekt-ID auf das aktuell ausgewählte Google Cloud-Projekt beziehen.

Führen Sie den folgenden Befehl aus, um Ihre Audit-Logeinträge auf Google Cloud-Projektebene zu lesen:

gcloud logging read "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com" \
    --project=PROJECT_ID

Führen Sie den folgenden Befehl aus, um Ihre Audit-Logeinträge auf Ordnerebene zu lesen:

gcloud logging read "logName : folders/FOLDER_ID/logs/cloudaudit.googleapis.com" \
    --folder=FOLDER_ID

Führen Sie den folgenden Befehl aus, um Ihre Audit-Logeinträge auf Organisationsebene zu lesen:

gcloud logging read "logName : organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com" \
    --organization=ORGANIZATION_ID

Führen Sie den folgenden Befehl aus, um Ihre Audit-Logeinträge auf Cloud-Rechnungskontoebene zu lesen:

gcloud logging read "logName : billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com" \
    --billing-account=BILLING_ACCOUNT_ID

Fügen Sie Ihrem Befehl das Flag --freshness hinzu, um Logs zu lesen, die mehr als einen Tag alt sind.

Weitere Informationen zur Verwendung der gcloud CLI erhalten Sie unter gcloud logging read.

REST

Geben Sie beim Erstellen von Abfragen in jedem Lognamen eine gültige Ressourcenkennung an. Wenn die Abfrage beispielsweise eine PROJECT_ID enthält, muss sich die von Ihnen angegebene Projekt-ID auf das aktuell ausgewählte Google Cloud-Projekt beziehen.

So können Sie beispielsweise mit der Logging API Ihre Audit-Logeinträge auf Projektebene aufrufen:

1. Rufen Sie den Abschnitt Diese API testen in der Dokumentation für die Methode entries.list auf.

2. Geben Sie im Teil Anfragetext des Formulars Diese API testen Folgendes ein. Wenn Sie auf dieses vorausgefüllte Formular klicken, wird der Anfragetext automatisch übernommen. Sie müssen jedoch in jedem der Lognamen eine gültige PROJECT_ID angeben.

   {
     "resourceNames": [
       "projects/PROJECT_ID"
     ],
     "pageSize": 5,
     "filter": "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com"
   }
   

3. Klicken Sie auf Ausführen.

Beispielabfragen

So verwenden Sie die Beispielabfragen in der folgenden Tabelle:

1. Ersetzen Sie die Variablen im Abfrageausdruck durch Ihre eigenen Projektinformationen und kopieren Sie den Ausdruck dann mit dem Symbol für die Zwischenablage .

2. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

   Zum Log-Explorer

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Logging ist.

3. Aktivieren Sie Abfrage anzeigen, um das Feld „Query Editor” zu öffnen, und fügen Sie den Ausdruck dann in das Feld des Query Editor ein:

   

4. Klicken Sie auf Abfrage ausführen. Logs, die Ihrer Abfrage entsprechen, werden im Bereich Abfrageergebnisse aufgeführt.

Verwenden Sie die folgenden Abfragen im Log-Explorer, um Audit-Logs für Resource Manager zu finden:

Name der Abfrage	Ausdruck
Projekt erstellt	log_id("cloudaudit.googleapis.com/activity") protoPayload.methodName="CreateProject" resource.labels.project_id="PROJECT_ID"
Projekt gelöscht	log_id("cloudaudit.googleapis.com/activity") protoPayload.methodName="DeleteProject" resource.labels.project_id="PROJECT_ID"

Audit-Logs weiterleiten

Sie können Audit-Logs auf dieselbe Weise wie andere Arten von Logs an unterstützte Ziele weiterleiten. Im Folgenden erfahren Sie, warum es sinnvoll sein kann, Ihre Audit-Logs weiterzuleiten:

• Sie können Kopien Ihrer Audit-Logs an Cloud Storage, BigQuery oder Pub/Sub weiterleiten, um Audit-Logs für einen längeren Zeitraum aufzubewahren oder leistungsfähigere Suchfunktionen zu nutzen. Mit Pub/Sub haben Sie die Möglichkeit, die Logs an andere Anwendungen, andere Repositories und Dritte weiterzuleiten.

• Zum organisationsübergreifenden Verwalten Ihrer Audit-Logs erstellen Sie aggregierte Senken, mit denen sich Logs aus beliebigen oder allen Google Cloud-Projekten in der Organisation weiterleiten lassen.

• Wenn die aktivierten Audit-Logs zum Datenzugriff dazu führen, dass Ihre Google Cloud-Projekte Ihre Logkontingente überschreiten, können Sie Senken erstellen, die die Audit-Logs zum Datenzugriff aus Logging ausschließen.

Eine Anleitung zum Weiterleiten von Logs finden Sie unter Logs an unterstützte Ziele weiterleiten.

Preise

Weitere Informationen zu Preisen finden Sie in der Preisübersicht für Cloud Logging.