Das Prüfprotokoll lesen¶

Das Prüfprotokoll Ihrer Organisation hält jede Änderung an ihren Personen, Gruppen, Rollen, Attributen, Regeln, Einladungen und Einstellungen fest. Diese Seite zeigt, wie Sie es lesen und filtern. Was darin steht und was nicht, steht unter Rollen und Zugriff.

Das Prüfprotokoll lesen kann org-admin oder auditor. Es hat in OS noch keinen Bildschirm: Sie lesen es über die API. Die Beispiele nutzen $OS, $TOKEN und $ORG wie unter Gruppen verwalten.

Das Protokoll lesen¶

curl -s "$OS/api/v1/organisations/$ORG/audit-events?limit=100" \
    -H "Authorization: Bearer $TOKEN"

OS liefert die Zeilen von alt nach neu, seitenweise mit höchstens 200 (Standard 50). Geben Sie next_cursor als cursor mit, um die nächste Seite zu erhalten. Eine Zeile sieht so aus:

{"id": 4182, "at": "2026-10-17T09:12:00Z", "request_id": "...",
 "actor_membership_id": "mem_...", "actor_organisation_id": "org_...",
 "event": "role.assigned", "kind": "role", "thing_id": "ras_...",
 "changes": {"role": [null, "people-admin"], "reach": [null, "organisation"],
             "member_id": [null, "mem_..."]},
 "allowed_actions": ["see"]}

Feld	Bedeutung
`at`, `request_id`	wann, und die Anfrage, die die Änderung vornahm
`actor_membership_id`	wer: eine Mitgliedschaft, oder `system` für das, was OS selbst tat
`actor_organisation_id`	aus welcher Organisation: Ihrer eigenen oder einer darüber, wenn ein Partner oder Betreiber handelte
`event`	was geschah, als `<Art>.<Verb>`
`kind`, `thing_id`	woran es geschah
`changes`	jedes festgehaltene Feld, das sich änderte, als `[vorher, nachher]`

Filtern¶

Fügen Sie der Abfrage einen oder mehrere Filter hinzu:

event=membership.deactivated: nur dieses Ereignis;
kind=group: nur Änderungen an einer Art von Ding;
actor=mem_...: nur, was eine Person tat.

curl -s "$OS/api/v1/organisations/$ORG/audit-events?event=rule.replaced" \
    -H "Authorization: Bearer $TOKEN"

Welche Ereignisse es gibt¶

Ereignis	Was festgehalten wird
`group.created`, `group.changed`, `group.deleted`	Name und Labels; beim Löschen, wie viele Mitglieder die Gruppe hatte
`group.member_added`, `group.member_removed`	die Gruppe und das Mitglied
`role.created`, `role.changed`, `role.deleted`	Name, Labels und Regeln; beim Löschen, wie viele Zuweisungen mitgingen
`role.assigned`, `role.unassigned`	die Rolle, die Reichweite und das Mitglied oder die Gruppe
`attribute.defined`, `attribute.changed`, `attribute.deleted`	Name, erlaubte Werte und `multiple`; beim Löschen, wie viele Werte mitgingen
`attribute.value_assigned`, `attribute.value_removed`	das Attribut, der Wert und das Mitglied oder die Gruppe
`rule.replaced`	die Regeln
`membership.deactivated`, `membership.reactivated`, `membership.removed`	der Status
`membership.profile_changed`	welche Felder von Name und Telefon ein Administrator änderte, nie die Werte
`membership.rows_removed`	wie viele Rollen, Gruppen und Werte verschwanden, als OS ein entferntes Mitglied aufräumte
`invitation.sent`, `invitation.revoked`, `invitation.accepted`	die Mitgliedschaft der Einladung; beim Annehmen ist die neue Person der Handelnde
`organisation.relabelled`, `organisation.retention_set`	die Labels der Organisation; die Aufbewahrungsfrist

Eine angenommene Einladung erzeugt auch eine Zeile für jede Rolle, Gruppe und jeden Wert, die sie gab.

Was das Prüfprotokoll nicht enthält¶

Keine Passwörter, Tokens, Schlüssel und keine E-Mail-Adressen: Eine Einladung wird mit ihrer ID festgehalten. Nachdem eine Person gelöscht wurde, stehen ihre Mitgliedschafts-IDs noch darin, zeigen aber auf niemanden mehr.

Eine Änderung an Personen oder Einstellungen steht sofort im Prüfprotokoll. Änderungen an Mitgliedschaften und Einladungen kommen im Hintergrund kurz danach hinein. Lesen Sie eine Seite erneut, sehen Sie auch Zeilen, die später festgehalten wurden; das Prüfprotokoll ist zum Lesen da, nicht zum Live-Verfolgen.

Wie lange das Prüfprotokoll aufbewahrt wird¶

Zeilen bleiben standardmäßig 400 Tage erhalten; danach löscht OS sie. Die Frist steht in audit_retention_days der Organisation. Nur Ihr Betreiber ändert sie; fragen Sie dort, wenn Sie eine andere Frist brauchen.

Wenn OS ablehnt¶

Antwort	Bedeutung	Was Sie tun
`403`	Die Organisation oder eine darüber ist ausgesetzt.	Fragen Sie Ihren Betreiber, was los ist.
`404`	Dürfen Sie das Prüfprotokoll nicht lesen, existiert es für Sie nicht; oder die Organisation existiert nicht oder Sie erreichen sie nicht.	Prüfen Sie `$ORG`, oder bitten Sie einen Administrator um die Rolle `auditor`.
`422`	Ein Filter oder `limit` stimmt nicht, zum Beispiel `limit` über 200.	Lesen Sie `errors` in der Antwort.