Zum Inhalt

Audit-Log

Jede schreibende Operation (Anlegen, Ändern, Löschen) auf relevanten Objekten sowie Anmeldungen und sicherheitsrelevante Aktionen landen im Audit-Log — mit Vorher/Nachher-Werten, Akteur und Zeitstempel.

Zu finden unter Admin → Protokolle & Support → Audit-Log. Im User-Portal gibt es unter /audit eine Ansicht, die immer nur die eigenen Aktionen zeigt — auch für Super-Admins — und auf das vollständige Log im Admin-Portal verweist.

Was ist drin

Feld Bedeutung
Zeitpunkt wann
Akteur E-Mail bzw. Benutzername des Kontos
Aktion z. B. host_create, dashboard_update, dashboard_soft_delete, login, login_failed, step_up
Zieltyp / Ziel-ID betroffenes Objekt, z. B. host, dashboard
Detail Zusatzinfos (z. B. geänderte Feldnamen)
Vorher / Nachher Werte vor und nach der Änderung
Tenant Tenant-Bezug (leer bei instanzweiten Aktionen)

Ein eigenes IP-Adressfeld gibt es nicht — bei Anmeldungen (auch Fehlversuchen) steht die Absender-IP in den Details. Jeder Eintrag mit Inhalt lässt sich aufklappen und zeigt die Details vollständig, dazu den Vorher/Nachher-Vergleich.

Protokolliert werden unter anderem auch Änderungen an den SMTP-Einstellungen (Passwort nur als „geändert: ja/nein"), Lizenzwechsel (nur die ersten sechs Zeichen des Schlüssels), erzeugte Offline-Bundles, eingespielte Offline-Updates, falsch eingegebene Codes der Authenticator-App samt anschließender Sperre und das Umschalten sicherheitsrelevanter Einstellungen.

Redigierte Felder

Zugangsdaten und Geheimnisse erscheinen im Audit-Log nie im Klartext, sondern als [REDACTED] — auf jeder Verschachtelungsebene und auch in Einträgen, die vor dieser Regel geschrieben wurden. Dazu gehören u. a. Passwort-Hashes, 2FA-Geheimnisse, Token- und Schlüssel-Hashes, SNMP-Communities und SNMPv3-Passwörter, SSH-Passwörter und -Schlüssel, API-Tokens und -Passwörter, Freigabe-Tokens und -Passwörter von Dashboards, Passwort-/Adressfelder von Benachrichtigungs-Kanälen, Geheimnisse aus Zugangsdaten-Sets sowie TLS-/ACME-Schlüssel. Die Suche findet keine Werte, die in der Anzeige maskiert sind.

Diff-Ansicht

Klappbare Zeilen mit Diff-Hervorhebung zwischen Vorher und Nachher, rot/grün gefärbt. Am Handy werden lange Aktionsnamen gekürzt (voller Name beim Antippen).

Filter

Filter Beispiel
Suche Teiltext über Akteur, Aktion und Detail-Inhalte
Aktion z. B. nur dashboard_soft_delete
Zieltyp nur host
Zeitraum Von/Bis
Nebenaktionen standardmäßig ausgeblendet (Präferenz-Updates, gespeicherte Filter, Token-Refresh) — per Schalter einblendbar

Nach Ziel-ID, Kategorie, Host oder Akteur lässt sich über die API filtern (GET /api/v1/audit/ mit target_type, target_id, category, host_id, actor_email). Drei vorgefertigte Abfragen gibt es ebenfalls nur über die API: /api/v1/audit/quick/login-attempts (7 Tage), /quick/destructive (Löschen/Purge/Restore/Import, 30 Tage) und /quick/mode-changes (90 Tage).

Sichtbarkeits-Stufen

Drei Permissions steuern, wie viel ein Konto sieht:

Permission Wirkung
audit_log.view_own nur eigene Aktionen
audit_log.view_tenant alle Aktionen in den eigenen Tenants (ohne instanzweite Einträge)
audit_log.view_global alle Aktionen, tenantübergreifend (Super-Admin automatisch)

view_global wirkt nur, wenn das Konto es in allen Tenants hat; gilt es nur in einzelnen Tenants, wirkt es dort wie view_tenant. Instanzweite Einträge (Anmeldungen von Super-Admins, Lizenz, Admin-Zugang) sehen nur Konten mit globaler Sicht.

Audit auf der Host-Detail-Seite

Der Reiter Verlauf einer Host-Detail-Seite enthält den Unterreiter Änderungen in Vesana — dieselbe Audit-Ansicht, eingegrenzt auf diesen Host und seine Checks. Er zeigt, wer Gerät und Checks in Vesana angelegt, geändert oder gelöscht hat — nicht, was auf dem Gerät selbst passiert ist.

Aufbewahrung

Audit-Einträge werden standardmäßig nicht gelöscht. Eine Frist lässt sich unter Admin → System → Ressourcen → Speicher setzen (der Vorschlag „Sparsam" setzt 730 Tage); gelöschte Einträge lassen sich nicht wiederherstellen.

Sicherheit

  • Das Audit-Log ist über die Oberfläche nur lesbar — es gibt keine Bearbeiten-Funktion.
  • Es gibt keinen CSV/JSON-Export und keinen manuellen Purge — Einträge verschwinden nur über eine selbst gesetzte Aufbewahrungsfrist.

Compliance

Wenn ein Auditor fragt „Wer hat Dashboard X am Datum Y geändert?":

  • Im Admin-Portal nach Zieltyp dashboard und Zeitraum filtern, oder per API GET /api/v1/audit/?target_type=dashboard&target_id=<uuid>
  • Sortiert nach Datum, einzeln aufklappen
  • Diff zeigt alte und neue Werte, der Akteur ist sichtbar

Anschluss