Zum Inhalt springen

Audit-Log

Das Audit-Log beantwortet die Frage: „Was hat der Assistent in meiner Buchhaltung getan, und wer hat es freigegeben?“ Diese Seite führt seine Ereignisse und Felder auf und sagt, was die Datei garantiert; schalte es ein, bevor du eine Schreibstufe aktivierst (Berechtigungen).

Mit SEVDESK_AUDIT_LOG=<path> hängt der Server pro Ereignis jedes schreibenden Aufrufs eine JSON-Zeile an diese Datei an, im Fernzugriff außerdem eine je Datei, die über eine Upload-Seite oder einen Download-Link läuft. Ist die Variable gesetzt, die Datei aber nicht beschreibbar, werden Schreibvorgänge abgelehnt. Im Fernzugriff umfasst ein Log jedes Konto, das der Server bedient.

Ereignisse 

EreignisWann
dry_runEin Probelauf hat seine Vorschau zurückgegeben.
confirmation_requestedEine Bestätigung wurde angefordert, mit der Vorschau (und im Browser-Modus dem Referenzcode).
confirmation_refusedEin erneuter Versuch legte eine Bestätigung vor, die schon verwendet, abgelaufen oder für andere Argumente erteilt war.
approval_decidedAuf einer Freigabeseite wurde „Freigeben“ oder „Ablehnen“ gedrückt.
declinedDu hast im Client abgelehnt oder die Freigabe im Browser abgelehnt.
executingDie Aktion wird gleich gesendet, mit der Art der Freigabe: elicit, browser, confirmation_off oder not_required (die Stufe write).
executedDie Aktion wurde ausgeführt; mit den Datensätzen, die sie geändert hat.
failedDie Aktion ist gescheitert; mit der Art des Fehlers und allen Datensätzen, die ein früherer Schritt bereits geändert hat.
file_receivedFernzugriff: Eine Datei wurde auf einer Upload-Seite hochgeladen.
file_link_createdFernzugriff: Ein Werkzeug hat einen Download-Link angelegt.
file_downloadedFernzugriff: Ein Download-Link wurde verwendet.

Felder 

Jede Zeile beginnt mit ts (der Zeitpunkt, ISO 8601) und v, der Version des Zeilenformats (1), gefolgt von event. Im Fernzugriff folgen account und grant. Die übrigen Felder hängen vom Ereignis ab:

FeldEreignisseBedeutung
accountalle, nur im FernzugriffDie sevDesk-Konto-ID (im Bearer-Modus bearer, falls der Server sie nicht ermitteln konnte). Bei Dateizeilen das Konto, dessen Werkzeugaufruf die Upload-Seite oder den Link angelegt hat.
grantalle, nur im FernzugriffDie ID des OAuth-Zugangs oder bearer.
callIdSchreibereignisseGemeinsam für alle Zeilen einer Aktion, von der Anfrage bis zum Ergebnis.
toolSchreibereignisseDer Name des Werkzeugs.
tierSchreibereignissewrite, commit oder external.
argsHashSchreibereignisseEin Hash des Werkzeugs und seiner Argumente (ohne dryRun).
argsSchreibereignisse außer approval_decidedDie Argumente: Token und Upload-IDs geschwärzt, versteckte Zeichen als sichtbare \u{…}-Escapes geschrieben, Zeichenketten bis 20.000 Zeichen.
previewHashdry_run, confirmation_requested, approval_decided, executingEin Hash der Vorschau, die gezeigt und freigegeben wurde; bei Werkzeugen der Stufen commit und external umfasst er den englischen und den deutschen Text.
previewdry_run, confirmation_requestedDie Vorschau, wie sie gezeigt wurde: action (ein Satz), facts (label, value), warnings und irreversible.
approvalexecutingWie die Aktion freigegeben wurde: elicit, browser, confirmation_off oder not_required.
reasonconfirmation_refusedreplayed_or_expired oder mismatch (für ein anderes Werkzeug oder andere Argumente erteilt).
decisionapproval_decidedapproved oder rejected.
referenceconfirmation_requested im Browser-Modus, approval_decided, DateiereignisseDer Referenzcode, den die Seite und das Ergebnis des Werkzeugs zeigen. Nicht geheim.
affectedexecuted, failedDie geänderten Datensätze (objectName, id); bei failed die, die ein früherer Schritt bereits geändert hat.
errorfailedDie Art des Fehlers, etwa validation, not_found, auth, timeout, network, server, aborted, internal oder output_invalid.
kindDateiereignissepdf, png, jpeg, xml, csv oder zip.
bytesDateiereignisseDie Größe der Datei.
sha256DateiereignisseDer SHA-256 des Inhalts, hexadezimal. Dateizeilen enthalten nie den Dateinamen oder den Inhalt.

Eine längere Zeichenkette in args wird dort abgeschnitten und endet mit einem Hinweis, wie viele Zeichen nicht protokolliert wurden.

Zum Beispiel (gekürzt):

{  "ts": "2026-11-09T14:03:12.481Z",  "v": 1,  "event": "executed",  "callId": "6f1c…",  "tool": "sevdesk_invoice_finalize",  "tier": "commit",  "argsHash": "9b2e…",  "args": { "id": 1042, "sentVia": "email" },  "affected": [{ "objectName": "Invoice", "id": "1042" }]}

v ändert sich nur, wenn ein Feld seine Bedeutung ändert oder entfällt; neue Felder können ohne Änderung von v hinzukommen (Kompatibilität).

Integrität 

  • Die Datei. Sie wird mit Modus 0600 angelegt (und auf 0600 verschärft, falls sie schon existiert), nur zum Anhängen geöffnet und nie über einen symbolischen Link. Unter macOS und Linux wird eine Datei abgelehnt, die einem anderen Benutzer gehört, gleich mit welchem Modus: Ihr Besitzer könnte sie umschreiben, und eine ACL kann Zugriff geben, den der Modus nicht zeigt.
  • Ganze Zeilen. Jede Zeile wird ganz geschrieben, oder das Schreiben schlägt fehl; ein unvollständiger Schreibvorgang wird fortgesetzt, nicht hingenommen.
  • Im Zweifel ablehnen. Kann die Zeile executing nicht geschrieben werden, wird die Aktion nicht ausgeführt und nichts gesendet.
  • Nicht fälschungssicher. Das Log ist lokal: Es hält für dich fest, was dieser Server getan hat, und schützt nicht vor jemandem, der den Rechner kontrolliert.

Im Fernzugriff enthalten die Vorschauen, die es festhält, Kundennamen, Beträge und E-Mail-Texte jedes verbundenen Kontos (Datenschutz).