Auditprotokolle
Führe eine Prüfung des Verlaufs zustandsändernder Aktionen in deiner Organisation durch — nur ergänzbar und mit erkennbaren Manipulationsspuren: Wer hat was, wann und von wo aus getan?
Auditprotokolle bieten eine durchsuchbare, filterbare Zeitleiste der unterstützten Verwaltungsaktionen in deiner Organisation, darunter Rollenzuweisungen, Änderungen an Engines und die Ausgabe von API-Schlüsseln. Siehe Einschränkungen der Erfassung. Verfügbar mit dem Enterprise-Tarif, ebenso wie Rollen & Berechtigungen.
Das Protokoll lässt sich auf Datenbankebene ausschließlich ergänzen: Über die Datenbankverbindung der Anwendung können Auditzeilen weder aktualisiert noch gelöscht werden, auch ein Leeren der Tabelle ist nicht möglich. Was einmal geschrieben wurde, bleibt erhalten.
Was erfasst wird #
Jedes Ereignis hält den Akteur, die Aktion, das Ziel und den HTTP-Kontext fest, in dem die Anfrage eingegangen ist.
| Feld | Hinweise |
|---|---|
| Akteur | Der Nutzer oder API-Schlüssel, der die Aktion ausgeführt hat |
| Aktion | Ein typisierter Wert wie engine.created oder member.role_changed |
| Ziel | Die betroffene Entität (z. B. eine Engine, eine Rolle oder ein Glossareintrag) |
| Metadaten | IDs zugehöriger Entitäten — niemals Namen, E-Mail-Adressen oder Inhaltsausschnitte |
| Anfragekontext | request_id, IP-Adresse, User-Agent — erfasst, wenn der Aufruf über HTTP einging |
| Zeitstempel | UTC sowie eine monoton steigende Sequenznummer zur Erkennung von Lücken |
Bewusst nur IDs
Die Metadatenspalte speichert IDs statt menschenlesbarer Werte. Die Oberfläche verknüpft sie beim Abrufen mit den aktuellen Namen. Wird eine Engine oder ein Nutzer umbenannt, bleibt der Verlauf deshalb unverändert. So geraten Auditzeilen auch nicht in Konflikt mit dem Recht auf Löschung nach DSGVO — es gibt keine Inhalte, die unkenntlich gemacht werden müssten.
Erfasste Aktionen #
Die Ereignisse sind in Kategorien gruppiert, die dem Filter im Dashboard entsprechen.
| Kategorie | Derzeit erfasste Aktionen |
|---|---|
| Organisation | org.created, org.settings_updated, org.deleted |
| Mitglieder | member.invited, member.removed, member.role_changed |
| Rollen | role.created, role.updated, role.deleted |
| Engines | engine.created, engine.updated, engine.deleted |
| API-Schlüssel | api_key.created, api_key.revoked |
| Inhalte | glossary_item.*, instruction.*, brand_voice.* (nur Einzeloperationen) |
Zugriff auf das Protokoll #
Der Eintrag Auditprotokoll erscheint immer in den Einstellungen unter Administration. Ohne die entsprechende Freischaltung zeigt die Seite „Das Auditprotokoll ist in deinem Tarif nicht verfügbar“ statt der Zeitleiste. Im Auditprotokoll findest du:
- Filterbare Liste — grenze die Liste nach Aktion, Akteur und Zeitraum ein (mit einer Voreinstellung wie Letzte 7 Tage oder einem Datumsbereich mit Von / Bis). Datumsangaben in der Zukunft sind nicht auswählbar.
- Ältere Ereignisse laden — die neuesten Ereignisse stehen zuerst; klicke am Ende der Liste auf Ältere Ereignisse laden, um die nächste Seite abzurufen.
- Ereignisdetails — klicke auf eine Zeile, um sie direkt aufzuklappen und die vollständigen Metadaten, die Anfrage-ID, die IP-Adresse und den User-Agent anzuzeigen.
- Teilbare Ansichten — die Filter und das geöffnete Ereignis werden in der URL abgebildet. So lässt sich jede Ansicht teilen.
Wer das Protokoll einsehen kann #
Der Zugriff auf die Seite hängt von zwei Voraussetzungen ab:
- Freischaltung — die Auditprotokoll-Funktion muss für die Organisation aktiviert sein (Enterprise-Tarif).
- Berechtigung — die Rolle der zugreifenden Person muss
org:view_audit_logsenthalten. Die vorab angelegte Rolle Vollzugriff enthält diese Berechtigung standardmäßig; Inhaber haben sie immer.
Mitglieder ohne diese Berechtigung sehen statt der Zeitleiste eine Seite mit „Kein Zugriff“. Mitglieder einer Organisation ohne die entsprechende Freischaltung sehen eine Bezahlschranke.
Wenn dein Enterprise-Tarif ausläuft
Auditprotokolle erfordern dieselbe tarifabhängige Freischaltung wie RBAC. Bisherige Ereignisse bleiben in der Datenbank. Die Seite zeigt jedoch „Das Auditprotokoll ist in deinem Tarif nicht verfügbar“, und die Leseendpunkte geben 403 zurück, bis der Tarif wieder aktiviert wird.
Erkennbarkeit von Manipulationen #
Auditprotokolle zeichnen nicht nur Aktionen auf — sie lassen sich auch im Nachhinein nur schwer verändern.
- Auf Datenbankebene nur ergänzbar. Die Migration, die die Tabelle anlegt, führt
REVOKE UPDATE, DELETE, TRUNCATEfür die API-Rolle aus. Jeder künftige Codepfad — ob Fehler, neuer Endpunkt oder sogar SQL-Injection — wird von Postgres abgewiesen, bevor er eine Zeile ändern kann. - Monoton steigende Sequenz. Jede Zeile enthält in der Spalte
seqeinen strikt steigenden Wert. Wer die Sequenz im Rahmen eines Audits untersucht, kann Löschungen anhand von Lücken erkennen.
Das reicht für Kontrollen nach dem Vorbild von SOC 2 aus. Es schützt nicht vor Angreifern mit direkten Zugangsdaten zur Produktionsdatenbank — stärkere Schutzmaßnahmen (separate Eigentümerrolle, WORM-Spiegelung) sind auf Anfrage verfügbar.
Aufbewahrung #
Auditereignisse werden standardmäßig unbegrenzt aufbewahrt. Individuelle Aufbewahrungsfristen — typischerweise 1, 3 oder 7 Jahre — sind mit Enterprise verfügbar. Melde dich, wenn du eine bestimmte Aufbewahrungsrichtlinie für Compliance-Anforderungen oder Sicherheitsfragebögen benötigst.
Was nicht erfasst wird #
Diese bewusst gesetzten Grenzen der ersten Version solltest du kennen:
- Erfassung nach dem Best-Effort-Prinzip, nicht transaktional. Die transaktionale Erfassung ist für die nahe Zukunft geplant. Das Auditereignis wird nach der beschriebenen Aktion geschrieben — nicht innerhalb derselben Datenbanktransaktion. In seltenen Fehlerfällen (eine Aktion ist erfolgreich, aber das anschließende Einfügen des Auditeintrags schlägt fehl) kann die Aktion ohne entsprechendes Ereignis stattfinden.
- Einige Aktionstypen werden noch nicht erfasst. Änderungen an Engine-Mitgliedschaften, das Verbinden / Aktualisieren / Trennen von Integrationen, Änderungen an der Modellkonfiguration, Änderungen an Abrechnungsabonnements und Massenoperationen für Inhalte (CSV-Upload,
createMany/updateMany/deleteMany) erzeugen noch keine Ereignisse. Die Aktionsbezeichnungen sind bereits reserviert, sodass diese Aktionen nach der Anbindung unter den bestehenden Filterkategorien erscheinen. - Lesezugriffe werden nicht protokolliert. Das Anzeigen des Auditprotokolls selbst, das Durchsehen von Engine-Anfrageprotokollen oder das Herunterladen eines Glossars erzeugt keine Ereignisse. Nur zustandsändernde Aktionen erzeugen Ereignisse.
- Noch keine Exporte. Auditdaten werden über das Dashboard angezeigt. CSV-Export, SIEM-Webhook und S3-Spiegelung sind geplant — lass uns wissen, wenn du sie benötigst.
- Keine auf eine Engine beschränkte Ansicht. Alle Auditereignisse der Organisation erscheinen auf einer einzigen Zeitleiste. Filtere nach Aktion oder Akteur, um die Ansicht einzugrenzen.
- Keine Live-Anzeige. Es gibt weder eine Schaltfläche Aktualisieren noch einen WebSocket-Datenstrom — lade die Seite neu, um neuere Ereignisse anzuzeigen.