STACKIT Audit Log verstehen
Zuletzt aktualisiert am
Das STACKIT Audit Log ist ein zentralisierter Dienst, der administrative Ereignisse und Zugriffe über Ihre Cloud-Produkte hinweg aufzeichnet. Nutzen Sie diese Protokolle für die Compliance und Sicherheitsüberwachung, um Infrastrukturänderungen nachzuverfolgen.
Das System zeichnet Aktionen von Benutzern, Service Accounts und der STACKIT-Plattform für Services auf, die in das STACKIT Audit Log integriert sind. Dies hilft Ihnen, die folgenden Fragen zu beantworten:
- Was ist passiert? (Ereignisname)
- Wann ist es passiert? (Zeitstempel)
- Wer hat es ausgelöst? (Initiator)
- Wo ist es aufgetreten? (Ziel-Organisation oder Ziel-Projekt)
Wichtige Funktionen
Abschnitt betitelt „Wichtige Funktionen“Das Audit Log bietet die folgenden Funktionen:
- Standardmäßig sichtbar: Admin-Aktivitäten werden standardmäßig aufgezeichnet. Sie müssen dies nicht manuell einrichten. Informationen zur Aufbewahrung im Portal finden Sie unter Audit-Log-Ereignisse abrufen. Mit dem Telemetry Router können Sie Ihre Audit-Logs an externe Ziele weiterleiten.
- Vollständiger Verlauf: Das Protokoll zeichnet sowohl Aktivitäten von menschlichen Benutzern als auch von automatisierten Systemaufgaben für alle Services auf, die unter Services mit Audit Logs aufgeführt sind.
Vorteile und Anwendungsfälle
Abschnitt betitelt „Vorteile und Anwendungsfälle“Mit dem Audit Log können Sie:
- Governance und Compliance unterstützen: Erfüllen Sie Compliance-Vorschriften, indem Sie sicherheitsrelevante Audit-Trails führen, die Ihre Abfolge von Aktionen für Auditoren dokumentieren.
- Rückverfolgbarkeit verbessern: Verfolgen Sie Änderungen nach, um zu identifizieren, wer eine Aktion wann durchgeführt hat. Dies sorgt für Transparenz und Nachvollziehbarkeit in Ihrem gesamten Team.
- Probleme lösen: Beheben Sie Systemfehler, indem Sie den Verlauf von Ereignissen nachverfolgen, um eine Ursache zu finden.
- Performance optimieren: Nutzen Sie Log-Erkenntnisse, um Engpässe oder ineffiziente manuelle Prozesse zu identifizieren, die Sie automatisieren können.
Service-Abdeckung
Abschnitt betitelt „Service-Abdeckung“Welche Services Audit-Log-Ereignisse schreiben und welcher service.name-Wert jeden dieser Services identifiziert, erfahren Sie unter Services mit Audit Logs.
Felder von Audit-Ereignissen
Abschnitt betitelt „Felder von Audit-Ereignissen“Audit-Ereignisse enthalten einen gemeinsamen Satz von Feldern. Die Tabelle beschreibt für jedes Feld das Vorkommen, das Format und die Bedeutung. Sofern nicht anders angegeben, sind Werte Zeichenketten. Erforderliche Felder sind in jedem Audit-Ereignis vorhanden. Optionale Felder können fehlen. Bedingte Felder sind vorhanden, wenn der Service über den entsprechenden Wert verfügt.
| Feld | Vorkommen | Werte oder Format | Beschreibung |
|---|---|---|---|
body |
Erforderlich | Freier Text | Zusammenfassung des Ereignisses |
client.address |
Optional | IP-Adresse | Netzwerkadresse des Clients |
cloud.region |
Erforderlich | Zum Beispiel global, eu01 oder eu02 |
Region des Ereignisses |
http.request.method |
Optional | HTTP-Methode | Methode der API-Anfrage |
server.address |
Optional | API-Hostname | Host der API-Anfrage |
service.instance.id |
Erforderlich | ID oder Name | Betroffene Instanz |
service.name |
Erforderlich | Kennung des Services | Service, der das Ereignis geschrieben hat |
severityText |
Erforderlich | TRACE, DEBUG, INFO, WARN, ERROR oder FATAL |
Schweregrad des Ereignisses |
stackit.action |
Erforderlich | Aktion aus dem Katalog der Ereignisse des Service in der Form product.target.verb, zum Beispiel secrets-manager.instance.create |
Aktion, die das Ereignis ausgelöst hat |
stackit.initiator |
Erforderlich | Benutzer- oder Service-Account-ID oder SYSTEM |
Akteur, der das Ereignis ausgelöst hat |
stackit.initiator.email |
Bedingt | Email-Adresse | Email-Adresse des Initiators |
stackit.log.id |
Erforderlich | Eindeutige Ereignis-ID | Identifiziert das Ereignis |
stackit.log.type |
Erforderlich | AUDIT |
Typ des Log-Eintrags |
stackit.request.body |
Erforderlich | Ursprünglicher Request-Body, als String codiert; einzelne Felder können unkenntlich gemacht sein | Anfrage, die das Ereignis ausgelöst hat |
stackit.resource.id |
Erforderlich | ID des Projekts, Ordners oder der Organisation | Enthaltende Ressource des Ereignisses |
stackit.resource.type |
Erforderlich | PROJECT, FOLDER, ORGANIZATION, SYSTEM oder ein anderer Wert |
Typ der enthaltenden Ressource. Telemetry Router kann Ereignisse mit einem anderen Wert nicht an den Eigentümer weiterleiten. |
stackit.response.body |
Optional | JSON, als String codiert; kann leer sein | Antwort auf die Anfrage |
stackit.visibility |
Erforderlich | PUBLIC |
Sichtbarkeit des Ereignisses |
timeUnixNano |
Erforderlich | Vorzeichenlose 64-Bit-Ganzzahl, Unix-Zeit in Nanosekunden, in JSON als String mit einer Dezimalzahl | Zeitpunkt des Ereignisses |
url.path |
Optional | API-Pfad | Pfad der API-Anfrage |
user_agent.original |
Optional | User-Agent des Clients | Software des Clients, mit der die Anfrage gestellt wurde |
Die Werte stackit.request.body und stackit.response.body sind JSON-Strings und keine verschachtelten JSON-Objekte. Spezifische Felder finden Sie auf der entsprechenden Seite unter Services mit Audit Logs. Die Werte von stackit.action für den Telemetry Router und Telemetry Links finden Sie unter Audit-Ereignisse des Telemetry Router.
Der Telemetry Router liefert jedes Audit-Ereignis als OpenTelemetry-Log-Eintrag. body, severityText und timeUnixNano sind Felder des Log-Eintrags. Alle anderen Felder in der Tabelle sind Attribute des Log-Eintrags. Ereignisse können weitere Attribute enthalten:
{ "timeUnixNano": "1775575194605756000", "severityText": "INFO", "body": { "stringValue": "API Key 'key-9982' was successfully deleted by user." }, "attributes": [ { "key": "stackit.action", "value": { "stringValue": "secrets-manager.apikey.delete" } }, { "key": "stackit.initiator", "value": { "stringValue": "1472b021-f261-4bac-86cb-931a6759b7a2" } } ]}