Strukturiertes Logging ohne Geheimnisse

Ziel

Logs erzeugen, die maschinell durchsuchbar und aggregierbar sind, von Menschen verstanden werden und mit Support-Personal geteilt werden können, ohne Geheimnisse preiszugeben.

Voraussetzungen

Eine Logging-Bibliothek, die strukturierte Ausgabe unterstützt (oder ein Formatter, der ein JSON-Objekt pro Zeile ausgibt), sowie ein Log-Collector.

Schritte

1. Einen Datensatz pro Ereignis mit einer festen Menge an Schlüsseln ausgeben: Zeitstempel, Level, Logger, Ereignisname und ereignisspezifische Felder. Frei formulierte Nachrichten vermeiden, die Werte aneinanderhängen.
2. Festlegen, was jedes Level für den eigenen Dienst bedeutet (zum Beispiel WARNING = braucht Aufmerksamkeit innerhalb eines Tages, ERROR = eine Anfrage ist fehlgeschlagen), und sich daran halten.
3. Pro Feld entscheiden, ob es protokolliert werden darf. Die OWASP-Anleitung schliesst Zugangsdaten, Sitzungskennungen, Zahlungsdaten und andere sensible Werte aus; personenbezogene Daten brauchen einen dokumentierten Zweck und eine dokumentierte Aufbewahrungsdauer.
4. Bereits an der Quelle schwärzen: den Datensatz aus erlaubten Feldern aufbauen, statt Zeichenketten nachträglich zu filtern.
5. Korrelationskennungen einbeziehen (Request-ID, Trace-ID), damit sich Datensätze einer Anfrage zusammenführen lassen.
6. Rotations- und Aufbewahrungsgrenzen festlegen und testen, dass die Anwendung eine volle Festplatte oder einen nicht erreichbaren Collector übersteht.

Erwartetes Ergebnis

Abfragen wie "alle fehlgeschlagenen Anfragen für Endpunkt X in der letzten Stunde" funktionieren ohne reguläre Ausdrücke; ein versehentlicher Log-Export gibt keine Geheimnisse preis.

Grenzen und Prüfbasis

Strukturierte Logs sind grösser als reiner Text; hochvolumige Debug-Ereignisse stichprobenartig erfassen. Schwärzungslisten müssen gepflegt werden, sobald Felder hinzukommen. Die Anleitung folgt den zitierten Quellen und der Praxis des eigenen Diensts dieses Wikis.