4.8 KiB
STEP 11 – Audit-Logging (Minimal & DSG-konform)
Ziel
Sicherheitsrelevante Ereignisse nachvollziehbar protokollieren, ohne sensible Daten (Patientendaten, Prompts, Passwoerter) zu speichern.
1. Architektur
Neues Modul: aza_audit_log.py
Log-Format: Pipe-separierte Textdatei (eine Zeile pro Ereignis)
TIMESTAMP | EVENT | USER | STATUS | SOURCE | DETAIL
Beispiel: 2026-02-22T21:13:25.419+00:00 | LOGIN_OK | Dr. Mueller | OK | desktop |
Alle Timestamps sind UTC (ISO-8601).
2. Protokollierte Ereignisse
Event-Typ Beschreibung Wann
APP_START Anwendung gestartet main() APP_STOP Anwendung beendet nach mainloop() LOGIN_OK Erfolgreicher Login do_login() LOGIN_FAIL Fehlgeschlagener Login do_login() 2FA_OK 2FA-Verifizierung erfolgreich do_verify() 2FA_FAIL 2FA-Verifizierung fehlgeschlagen do_verify() CONSENT_GRANT KI-Einwilligung erteilt on_accept() CONSENT_REVOKE KI-Einwilligung widerrufen toggle_consent() AI_TRANSCRIBE KI-Transkription gestartet transcribe_wav() AI_CHAT KI-Chat-Completion aufgerufen call_chat_completion() AI_BLOCKED KI-Aufruf ohne Consent blockiert transcribe/chat PASSWORD_REHASH Legacy-Hash auf bcrypt migriert do_login() EXPORT Log-Export durchgefuehrt do_export()
3. Data Minimization (DSG Art. 6)
Was NICHT im Audit-Log gespeichert wird:
- Patientennamen / Patientendaten
- Transkripte / KG-Inhalte
- KI-Prompts / KI-Antworten
- Passwoerter / Passwort-Hashes
- API-Keys / Secrets
- E-Mail-Inhalte
Detail-Feld: Maximal 200 Zeichen, nur Metadaten (z.B. "model=gpt-5.2", "2FA backup-code").
4. Log-Rotation
Parameter Standard ENV-Variable
Max. Dateigroesse 10 MB AZA_AUDIT_ROTATE_MB Rotierte Dateien 12 AZA_AUDIT_KEEP Logdatei-Pfad aza_audit.log AZA_AUDIT_LOG
Bei Ueberschreitung der Maximalgroesse: aza_audit.log -> aza_audit.1.log -> ... -> aza_audit.12.log Aelteste Datei wird ueberschrieben.
5. Export
Ueber Einstellungen -> "Logs exportieren (Audit)": Exportiert sowohl Consent-Log als auch Audit-Log als JSON.
Programmatisch: python -c "from aza_audit_log import export_audit_log; print(export_audit_log())"
Export-Format: { "export_timestamp": "2026-02-22T...", "total_entries": 12, "source_file": ".../aza_audit.log", "entries": [ { "timestamp": "2026-02-22T...", "event": "LOGIN_OK", "user_id": "...", "status": "OK", "source": "desktop", "detail": "" } ] }
6. Integration bestehender Audit-Systeme
Komponente Audit-System Speicherort
Desktop-App (basis14) aza_audit_log.py aza_audit.log Backend (backend_main) _audit_write() medwork_audit.log Workforce Planner log_action() + DB workforce_planner.db
Alle drei Systeme sind unabhaengig und koennen separat exportiert werden.
7. Geaenderte / Neue Dateien
Datei Aktion
aza_audit_log.py NEU – Audit-Log-Modul basis14.py GEAENDERT – Import + 10 log_event()-Aufrufe aza_settings_mixin.py GEAENDERT – Import + Widerruf-Log + Export _test_audit_log.py NEU – Testskript (23 Tests)
8. Test-Ergebnisse (22.02.2026)
Test Ergebnis
Events schreiben PASS 12 Zeilen korrekt PASS 6 Felder pro Zeile PASS Timestamp UTC PASS Event-Typ korrekt PASS User korrekt PASS Status OK/FAIL korrekt PASS Source = desktop PASS Statistiken korrekt PASS Export JSON korrekt PASS Data Minimization PASS Pipe-Sanitierung PASS Gesamt: 23/23 ALLE BESTANDEN
9. Risiken
Risiko Bewertung Massnahme
Log-Datei loeschbar NIEDRIG Backup sichert mit Kein zentrales SIEM MITTEL Export fuer manuelle Pruefung Keine Echtzeit-Alarmierung MITTEL Manueller Review empfohlen Log-Rotation verliert alte Daten NIEDRIG 12 Dateien a 10 MB = 120 MB