Het logboek lezen¶

Het logboek van je organisatie legt elke wijziging vast aan haar mensen, groepen, rollen, eigenschappen, regels, uitnodigingen en instellingen. Deze pagina laat zien hoe je het leest en filtert. Wat erin staat en wat niet, staat in Rollen en toegang.

Het logboek lezen kan org-admin of auditor. Het heeft nog geen scherm in OS: je leest het via de API. De voorbeelden gebruiken $OS, $TOKEN en $ORG zoals in Groepen beheren.

Het logboek lezen¶

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

OS geeft de rijen van oud naar nieuw, per pagina van hoogstens 200 (standaard 50). Geef next_cursor mee als cursor voor de volgende pagina. Een rij ziet er zo uit:

{"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"]}

Veld	Betekenis
`at`, `request_id`	wanneer, en het verzoek dat de wijziging deed
`actor_membership_id`	wie: een lidmaatschap, of `system` voor wat OS zelf deed
`actor_organisation_id`	vanuit welke organisatie: de jouwe, of een erboven als een partner of operator handelde
`event`	wat er gebeurde, als `<soort>.<werkwoord>`
`kind`, `thing_id`	waaraan het gebeurde
`changes`	elk vastgelegd veld dat veranderde, als `[voor, na]`

Filteren¶

Voeg een of meer filters toe aan de vraag:

event=membership.deactivated: alleen deze gebeurtenis;
kind=group: alleen wijzigingen aan één soort ding;
actor=mem_...: alleen wat één persoon deed.

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

Welke gebeurtenissen er zijn¶

Gebeurtenis	Wat er vastligt
`group.created`, `group.changed`, `group.deleted`	naam en labels; bij verwijderen hoeveel leden de groep had
`group.member_added`, `group.member_removed`	de groep en het lid
`role.created`, `role.changed`, `role.deleted`	naam, labels en regels; bij verwijderen hoeveel toekenningen meegingen
`role.assigned`, `role.unassigned`	de rol, het bereik, en het lid of de groep
`attribute.defined`, `attribute.changed`, `attribute.deleted`	naam, toegestane waarden en `multiple`; bij verwijderen hoeveel waarden meegingen
`attribute.value_assigned`, `attribute.value_removed`	de eigenschap, de waarde, en het lid of de groep
`rule.replaced`	de regels
`membership.deactivated`, `membership.reactivated`, `membership.removed`	de status
`membership.profile_changed`	welke velden van naam en telefoon een beheerder wijzigde, nooit de waarden
`membership.rows_removed`	hoeveel rollen, groepen en waarden verdwenen toen OS een verwijderd lid opruimde
`invitation.sent`, `invitation.revoked`, `invitation.accepted`	het lidmaatschap van de uitnodiging; bij accepteren is de nieuwe persoon de actor
`organisation.relabelled`, `organisation.retention_set`	de labels staan op de organisatie; de bewaartermijn

Een geaccepteerde uitnodiging levert ook een rij op voor elke rol, groep en waarde die ze gaf.

Wat het logboek niet bevat¶

Geen wachtwoorden, tokens, sleutels en geen e-mailadressen: een uitnodiging ligt vast met haar id. Nadat een persoon is gewist, staan zijn lidmaatschaps-id's er nog, maar die wijzen niemand meer aan.

Een wijziging aan de mensen of instellingen staat meteen in het logboek. Wijzigingen aan lidmaatschappen en uitnodigingen komen er op de achtergrond in, kort daarna. Lees je een pagina opnieuw, dan zie je ook rijen die later zijn vastgelegd; het logboek is om te lezen, niet om live te volgen.

Hoe lang het logboek bewaard blijft¶

Rijen blijven standaard 400 dagen bewaard; daarna verwijdert OS ze. De termijn staat in audit_retention_days van de organisatie. Alleen je operator wijzigt hem; vraag het daar als je een andere termijn nodig hebt.

Ook bij Artific Core¶

OS levert elke rij ook af aan het logboek van je organisatie bij Artific Core, binnen een paar minuten. Daar staat ze tussen Core's eigen gebeurtenissen, onder Aanroepen en productgebeurtenissen, met als herkomst Artific OS en als naam os. voor de gebeurtenis, zoals os.role.assigned. Zo lees je bij Core één logboek van alles wat er in je organisatie gebeurde.

Core toont een gewijzigd veld als voor en na. Een veld met een lijst, zoals de toegestane waarden van een eigenschap, staat er als twee velden: allowed_values_before en allowed_values. Een veld dat Core niet kan bewaren, zoals de regels van een rol of de labels van een groep, staat daar niet in maar wordt genoemd onder omitted; het OS-logboek houdt het volledig. Rijen van voordat OS ging afleveren, staan alleen in het OS-logboek.

Dit werkt pas als de beheerder van Artific Core het voor OS heeft aangezet. Tot dan blijven de rijen wachten en is het OS-logboek volledig op zichzelf.

Als OS weigert¶

Antwoord	Betekenis	Wat je doet
`403`	De organisatie, of een erboven, is opgeschort.	Vraag je operator wat er aan de hand is.
`404`	Je mag het logboek niet lezen, dan bestaat het voor jou niet; of de organisatie bestaat niet of je bereikt haar niet.	Controleer `$ORG`, of vraag een beheerder om de rol `auditor`.
`422`	Een filter of `limit` klopt niet, bijvoorbeeld `limit` boven 200.	Lees `errors` in het antwoord.