Audit-Protokolle: wer in deinem Workspace was getan hat

Aktualisiert am 20.10.20266 Min. Lesezeit
Deutsch
Auf dieser Seite

Audit-Protokolle in Deskwoot sind eine Aufzeichnung der wichtigen Aktionen in deinem Workspace, die nur erweitert wird. Es gibt keinen Button und keine API-Route, um einen Eintrag zu ändern oder zu löschen. So beantworten sie die Frage „Wer hat was wann getan?“, ohne dass du darauf vertrauen musst, dass ein einzelner Administrator die Spur nicht nachträglich löscht. Audit-Protokolle helfen beim Nachweis der Zugriffskontrolle für SOC 2, bei der Aufzeichnungspflicht für Auftragsverarbeiter nach Artikel 28 DSGVO und bei jeder internen Aufarbeitung eines Sicherheitsvorfalls, bei der du eine Abfolge von Änderungen im Nachhinein rekonstruieren musst.

Was protokolliert wird

Diese Aktionen schreiben heute einen Eintrag ins Audit-Protokoll:

  • Anmeldung: jede erfolgreiche Anmeldung und jedes Mal, wenn sich der Deskwoot-Support als einer deiner Benutzer anmeldet.
  • Agenten, Teams und Einstellungen: Agent eingeladen, Agent entfernt, Schalter Teammitglieder eines Agenten geändert; Team erstellt, geändert oder gelöscht; Änderungen daran, wer den KI-Assistenten in Konversationen nutzen darf, und an der Pflicht zur Zwei-Faktor-Authentifizierung für alle Mitglieder.
  • Konversationen: Änderungen und Statusänderungen an Konversationen, CSAT-Bewertungen, die ein Administrator geändert hat, und die Sammelaktionen aus der Konversationsliste (Status, Agent oder Team zuweisen, Priorität, Label, stummschalten, Stummschaltung aufheben, als ungelesen markieren, zurückstellen, löschen).
  • Bestellungen, Erstattungen und Abos: stornierte oder erstattete Bestellungen, ausgeführte Erstattungen, Versand, Adressänderungen, Rücksendungen und gekündigte Abos, egal ob ein Agent oder der Bot gehandelt hat, dazu Bot-Aktionen, die rückgängig gemacht werden mussten.
  • Integrationen und MCP: Integrationen verbunden und getrennt; MCP-Zugriff ein- oder ausgeschaltet, MCP-Token erstellt oder widerrufen und jeder MCP-Werkzeugaufruf, der etwas ändert.
  • Kontakte: Kontakte blockiert oder entsperrt und E-Mail-Bounces zurückgesetzt, damit Kampagnen die Adresse wieder erreichen.
  • Datenschutz und Recht: Anfragen zu Betroffenenrechten (Datenauskunft versendet, Löschung ausgeführt), Änderungen daran, was der Bot darf, und der angenommene AVV.
  • Übersetzungskosten: jede Übersetzung eines Hilfecenter-Artikels, die vom Prepaid-Guthaben abgebucht wurde, und ihre Erstattungen.
  • Tarifänderungen: Kampagnen oder Automatisierungsregeln, die pausiert wurden, weil der Tarif sie nicht mehr enthält, und Kampagnen, die wegen einer ungültigen Zielgruppe gestoppt wurden.

Rollenänderungen, die persönliche Zwei-Faktor-Authentifizierung, Passwortänderungen, Änderungen an der Abrechnung und Änderungen an Automatisierungsregeln, Makros oder Textvorlagen stehen nicht im Audit-Protokoll.

Was jeder Eintrag enthält

Ein Eintrag enthält Datum und Uhrzeit, den Benutzer, der gehandelt hat (oder System, wenn Deskwoot selbst gehandelt hat), die Aktion, Typ und ID des Ziels und die Details der Aktion als JSON, zum Beispiel die E-Mail-Adresse eines eingeladenen Agenten oder den alten und neuen Wert einer geänderten Einstellung. Außerdem steht darin, ob die Aktion aus einer angemeldeten Sitzung oder über einen API-Token kam, und über welchen. IP-Adresse und Browser speichern die Einträge nicht.

Warum „unveränderbar“

Für Einträge im Audit-Protokoll gibt es in Deskwoot keinen Weg, sie zu ändern oder zu löschen. Selbst ein Administrator kann keinen Eintrag schwärzen: Es gibt keinen Button und keine API-Route. Löschst du für eine DSGVO-Anfrage die personenbezogenen Daten eines Kontakts, ersetzt Deskwoot die Details der Einträge, die ihn nennen, durch einen Löschvermerk, die Einträge selbst bleiben. So bleibt festgehalten, was passiert ist, auch wenn die personenbezogenen Daten entfernt sind.

Suchen und exportieren

Unter Einstellungen > Audit-Protokolle stehen die neuesten Einträge oben, 25 pro Seite. Mit Nach Aktion filtern grenzt du die Liste auf Erstellen, Aktualisieren, Löschen, Anmeldung oder Export ein. Einen Filter nach Benutzer oder Datum und einen CSV-Export gibt es nicht.

Webhook für ein SIEM

Für Audit-Ereignisse gibt es heute keinen Webhook. Audit-Protokolle lassen sich also nicht automatisch an ein SIEM (Datadog, Splunk, Sumo Logic, Elastic) weiterleiten.

Aufbewahrung

Audit-Protokolle bleiben erhalten, solange dein Workspace besteht. Wird der Workspace gelöscht (30 Tage nachdem du die Löschung bestätigt hast, oder 30 Tage nach dem Ende eines bereits bezahlten Zeitraums), werden die Audit-Protokolle mit ihm gelöscht.

Verfügbarkeit nach Tarif

Verfügbar im Enterprise-Tarif, für Administratoren. In den kleineren Tarifen schreibt Deskwoot die Einträge trotzdem, die Seite Audit-Protokolle und ihre API sind aber gesperrt.

Typische Compliance-Anwendungsfälle

  • Nachweis der Zugriffskontrolle für SOC 2: Zeig deinem Prüfer, wer im Prüfungszeitraum eingeladen oder entfernt wurde und wann sich jemand angemeldet hat.
  • Protokollierung nach ISO 27001 A.12.4: Einträge lassen sich in Deskwoot weder ändern noch löschen, das unterstützt die Anforderungen der Norm an die Protokollierung.
  • Aufzeichnungspflicht für Auftragsverarbeiter nach Artikel 28 DSGVO: Das Audit-Protokoll hält fest, was in deinem Workspace mit personenbezogenen Daten passiert ist, zum Beispiel Anfragen zu Betroffenenrechten.
  • Sicherheitsvorfälle: „Ist zwischen 14:00 und 15:00 UTC etwas Ungewöhnliches passiert?“ Öffne das Audit-Protokoll, blättere zu diesem Zeitfenster und achte auf unbekannte Benutzer oder ungewöhnliche Aktionen.

Häufige Fragen

Welche Aktionen werden protokolliert?
Anmeldungen, eingeladene und entfernte Agenten, Änderungen an Teams, am Zugriff auf den KI-Assistenten und an der Pflicht zur Zwei-Faktor-Authentifizierung, Änderungen an Konversationen und Sammelaktionen, Bestellaktionen (Stornierung, Erstattung, Versand), verbundene und getrennte Integrationen, MCP-Zugriff und MCP-Werkzeugaufrufe, Anfragen zu Betroffenenrechten und Übersetzungskosten. Reine Lesezugriffe, etwa das Öffnen einer Seite, werden nicht protokolliert.
Was steht in einem einzelnen Eintrag?
Datum und Uhrzeit, der Benutzer, der gehandelt hat (in der Oberfläche mit Name und E-Mail-Adresse), der Name der Aktion, Typ und ID dessen, was er geändert hat, und die Details als JSON. Du findest die Einträge unter Einstellungen > Audit-Protokolle.
Wie lange werden Audit-Protokolle aufbewahrt?
Solange dein Workspace besteht. Einen eingebauten CSV-Export gibt es derzeit nicht. Brauchst du für die Compliance eine Offline-Kopie, wende dich an den Support, wir exportieren die Einträge für dich.
Gibt es Audit-Protokolle auch in kleineren Tarifen?
Nein. Audit-Protokolle gehören zum Enterprise-Tarif. Die Einträge werden in jedem Tarif geschrieben (die Daten sind also da), die Seite Audit-Protokolle und ihr API-Endpunkt antworten außerhalb von Enterprise aber mit 403.
Kann ich das Audit-Protokoll filtern?
Ja, im Dashboard nach Art der Aktion (Erstellen, Aktualisieren, Löschen, Anmeldung, Export oder Alle Aktionen). Einen Filter nach Zeitraum, Benutzer oder Ziel gibt es weder im Dashboard noch in der API.
Kann ich sehen, wer eine Konversation angesehen hat?
Derzeit nicht: Protokolliert werden nur Aktionen, die etwas ändern, und Anmeldungen. Eine Protokollierung von Lesezugriffen würden wir auf Anfrage für einen Enterprise-Kunden mit strengeren Zugriffsregeln bauen.
Kann ich Audit-Protokolle an mein SIEM weiterleiten?
Über einen eingebauten Webhook noch nicht. Braucht dein Compliance-Team die Daten in einem SIEM (Datadog, Splunk, Sumo Logic), melde dich beim Support, dann finden wir einen Weg für einen regelmäßigen Export als JSON-Zeilen. Ein Webhook für Audit-Ereignisse in Echtzeit ist geplant.
Wie entferne ich personenbezogene Daten nach einem DSGVO-Löschantrag?
Führ die Löschung unter Einstellungen > Betroffenenrechte (DSGVO) aus. Deskwoot ersetzt die Details der Einträge, die den Kontakt nennen, durch einen Löschvermerk. Was getan wurde, bleibt also erhalten, die personenbezogenen Daten sind entfernt. So erfüllst du Artikel 17, ohne die Sicherheitsspur zu verlieren.
Bleiben Audit-Protokolle nach einer Kündigung erhalten?
Ja, bis dein Workspace gelöscht wird. Das passiert 30 Tage nachdem du die Löschung bestätigt hast, und die Audit-Protokolle werden mit dem Workspace gelöscht. Brauchst du die Aufzeichnung länger, bitte uns vorher um einen Export.
Wie sehen die Details als JSON aus?
Das Feld auditedChanges ist ein JSON-Objekt mit den Feldnamen als Schlüsseln. Das Dashboard zeigt die ersten drei Schlüssel direkt in der Zeile (gekürzt auf 40 Zeichen). Den vollständigen Eintrag kann ein angemeldeter Administrator über den Endpunkt /api/v1/accounts/{id}/audit-logs abrufen.
Erfasst das Audit-Protokoll IP-Adresse und Browser?
Nein. Die Einträge speichern weder die IP-Adresse noch den Browser. Sie halten aber fest, ob eine Aktion aus einer angemeldeten Sitzung oder über einen API-Token kam, und über welchen. Einträge, die Deskwoot selbst schreibt, erscheinen als System.

War diese Anleitung hilfreich?

Weiterlesen

Fynn zu dieser Anleitung fragen

Kurze Antwort aus dieser Anleitung und dem restlichen Hilfecenter.

Noch Hilfe nötig?

Fynn antwortet im Chat aus diesen Anleitungen, und dort erreichst du auch das Team.

E-Mail schreiben