Audit-Protokolle

Wer kann das tun: Unternehmens-Admins
Welche Preispläne: Enterprise-Preisplan
Welche Plattformen: Browser

Audit-Protokolle ermöglichen Unternehmens-Admins mit den entsprechenden Berechtigungen, die Aktivitäten von Nutzern in ihrer Miro-Organisation nachzuverfolgen. Protokolle sind äußerst hilfreich, wenn du ein Problem untersuchen oder einen detaillierten Bericht über wichtige Ereignisse erstellen musst (z. B. Änderungen der globalen Sicherheitseinstellungen, Einladungen neuer Nutzer oder neu erstellte Boards).

✏️ Zurzeit werden Ereignisse ab dem Zeitpunkt der Erstellung des Enterprise-Abos protokolliert und standardmäßig 180 Tage lang gespeichert:
a) Wenn du von einem anderen Preisplan auf Enterprise upgradest, werden die Ereignisse ab dem Zeitpunkt des Upgrades protokolliert.
b) Wenn du einige Teams in das Enterprise-Abo migrierst, werden deren Daten erst ab dem Moment protokolliert, in dem sie Teil des Abos werden.

Audit-Protokolle aufrufen

Um auf die Audit-Protokolle zuzugreifen, gehe wie folgt vor:

1. Gehe zu Unternehmenseinstellungen.
2. Klicke im linken Feld auf Sicherheit > Audit-Protokolle.
3. Du kannst die Audit-Protokolle nach einem Datumsbereich, nach einem oder mehreren Akteuren (einschließlich Apps und KI-Agenten, die im Auftrag eines Nutzers handeln), nach einer oder mehreren Ereigniskategorien, nach einem oder mehreren Ereignissen und nach einem oder mehreren Betroffenen Objekten filtern.

Klicke auf die Schaltfläche „Ereignisse anzeigen“, um eine Vorschau der Ereignisse zu sehen, die deinen Filterkriterien entsprechen. Die Zeit wird im ISO 8601-Format in der Ortszeit angezeigt. Die Details eines bestimmten Ereignisses siehst du, indem du in der Spalte Details auf die drei Punkte klickst.

✏️ Du kannst Ereignisse bis zum Ende des Aufbewahrungszeitraums deiner Organisation anzeigen (bis zu 365 Tagen).

Audit-Protokolle exportieren

Du kannst Protokolle im CSV-Dateiformat exportieren.

In der CSV-Exportdatei sind Datum und Uhrzeit des Ereignisses im ISO 8601-Format in der UTC-Zeitzone angegeben. Es gibt keine Begrenzung der Anzahl der Datensätze, die auf einmal exportiert werden können; je mehr Daten du exportierst, desto länger dauert es, die Datei zum Herunterladen vorzubereiten. Beachte außerdem, dass gängige Anwendungen zum Arbeiten mit Tabellen Grenzen haben, wie viele Daten sie öffnen können. Die exportierte Datei spiegelt alle angewendeten Filter wider, einschließlich des betroffenen Objekts.

Um Protokolle zu exportieren, klicke auf die Als CSV exportieren-Schaltfläche.

Die Leiste mit den Details deiner Exportdatei erscheint darunter. Wenn die Datei zum Herunterladen bereit ist, kannst du auf die Schaltfläche CSV herunterladen klicken. Die Datei wird 24 Stunden lang zum Herunterladen verfügbar sein.

✏️ Zurzeit ist pro Organisation jeweils nur eine Exportdatei zum Herunterladen verfügbar. Wenn du auf die Als CSV exportieren-Schaltfläche klickst, wird die aktuelle Exportdatei ersetzt.

Audit-Protokolle per API abrufen

Admins können die Audit Log API oder unterstützte SIEM-Integrationen verwenden, um programmatisch auf Audit-Protokolldaten zuzugreifen und diese zu sammeln.

Die API unterstützt dieselben Filter wie die Benutzeroberfläche: Akteur, Ereigniskategorie, Ereignis und betroffenes Objekt — jeder akzeptiert mehrere Werte. Über die API können Admins den vollständigen Audit-Protokollverlauf ihrer Organisation abrufen.

Auslaufen der Audit Logs API v1

Audit Logs API v1 wurde eingestellt. Wenn du eine benutzerdefinierte Integration hast, die auf v1 (GET /v1/audit/logs) basiert, migriere sie zu v2 (GET /v2/audit/logs). Authentifizierung und die Parameter für das Zeitfenster bleiben unverändert, aber Paginierung, Antwortformat und einige Feldnamen unterscheiden sich; siehe die API-Referenz für Details. Wenn du eine von Miro bereitgestellte App oder einen Marketplace-Connector verwendest (z. B. die Miro App für Splunk oder Microsoft Sentinel), aktualisiere sie auf die neueste Version, die bereits v2 unterstützt.

Wesentliche Änderungen in der v2-Antwort:

• Die Paginierung ist cursor-basiert (ein undurchsichtiger Cursorwert) statt offset-basiert; es gibt keine Gesamtanzahl an Einträgen.
• createdBy.id wird als String zurückgegeben (zuvor als Zahl).
• Jedes Ereignis enthält ein obergeordnetes category-Feld.
• Event-IDs sind UUID-Strings (zuvor eine numerische Endung); behandle sie als undurchsichtige Werte.
• createdAt gibt an, wann das Ereignis gespeichert wurde, nicht genau, wann die Aktion stattfand (typischerweise eine Verzögerung von wenigen Sekunden).
• details-Felder verwenden camelCase (z. B. organizationId), große numerische Werte werden als Strings serialisiert, Zeitstempel verwenden ISO 8601, und Schlüssel mit null-Werten werden weggelassen.
• Bei Aktionen, die von einer App, einer Integration oder einem KI-Agenten im Auftrag eines Nutzers ausgeführt werden, enthält das Actor-Objekt ein onBehalfOf-Feld, das diesen Nutzer identifiziert.
• Der Actor-Name für abgemeldete Besucher ist jetzt "Visitor" (zuvor "Guest").
• Board-bezogene Ereignisse verweisen auf den öffentlichen boardKey anstelle einer internen numerischen ID.
• Event-Typen und -Kategorien, die zuvor „project“ verwendeten, nutzen jetzt „space“ (z. B. project_created heißt jetzt space_created); dies gilt rückwirkend für bisherige Ereignisse, die über v2 abgerufen werden.

Audit-Protokolle löschen

Als Admin kannst du eine Aufbewahrungsfrist für Audit-Protokolle festlegen. Du kannst zwischen 30, 90, 180 oder 365 Tagen wählen.

⚠️ Gelöschte Audit-Protokolle können nicht wiederhergestellt werden.

✏️ Die unbegrenzte Aufbewahrung für Audit-Protokolle wurde eingestellt.

Um eine Löschfrist festzulegen, gehe wie folgt vor:

1. Gehe zu Unternehmenseinstellungen.
2. Klicke im linken Feld auf Sicherheit > Audit-Protokolle.
3. Klicke unter Audit-Protokolle auf den Tab Einstellungen.
4. Wähle eine Option aus der Dropdown-Liste. Du wirst aufgefordert, deine Auswahl zu bestätigen.

Ereignisse in Audit-Protokollen

Die Audit-Protokolle enthalten Dateneinträge über folgende Ereigniskategorien:

Häufige Fragen