BU-08 – Audit-Historie Benutzerverwaltung
Stand: 12.10.2026 11:23
Branch: main
Status: erster Vorschlag
Änderungshistorie anzeigen
Use Case: UC08 – Benutzerverwaltung
Screen: BU-08
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
BU-08 zeigt die auditierbare Historie der Benutzerverwaltung eines Tenants.
Der Screen dient der Nachvollziehbarkeit von sicherheits- und verwaltungsrelevanten Aktionen wie Benutzer einladen, Einladung erneut senden, Einladung widerrufen, Rolle ändern, Benutzer deaktivieren, Benutzer reaktivieren und sicherheitsrelevante Systemereignisse.
BU-08 ist eine rein lesende Ansicht. Audit-Einträge werden nicht verändert.
2. Primäre Nutzer
| Rolle |
Nutzung |
tenant_admin |
prüft Audit-Einträge der Benutzerverwaltung des eigenen Tenants |
mitarbeiter |
keine Nutzung dieser internen Ansicht in V1 |
kunde |
keine Nutzung dieser internen Ansicht |
superadmin |
nicht Zielnutzer dieses Tenant-Screens |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| BU-01 |
Aktion „Audit“ aus Benutzerübersicht |
| BU-03 |
Audit-Historie eines ausgewählten Benutzers |
| BU-04 |
Prüfung nach Rollenänderung |
| BU-05 |
Prüfung von Einladungsereignissen |
| BU-06 |
Prüfung von Deaktivierung / Reaktivierung |
| BU-07 |
Prüfung eines sicherheitsbezogenen Ereignisses |
4.1 Kopfbereich
| Feld |
Beschreibung |
| Tenant |
betroffene Tauchschule / Organisation |
| Zeitraum |
gewählter Prüfzeitraum |
| Anzahl Ereignisse |
gefundene Audit-Einträge |
| Filterstatus |
aktive Filter |
| Hinweis |
Audit-Historie ist unveränderbar |
4.2 Audit-Tabelle
| Spalte |
Beschreibung |
| Zeitpunkt |
Datum / Zeit der Aktion |
| Aktion |
z. B. user_invited, role_changed, user_deactivated |
| Zielobjekt |
betroffener Benutzer oder Einladung |
| ausführender Benutzer |
Benutzer, der die Aktion ausgeführt hat |
| alter Wert |
vorheriger Wert, falls vorhanden |
| neuer Wert |
neuer Wert, falls vorhanden |
| Grund |
Pflichtgrund oder Systemgrund |
| Quelle |
UI, System, Auth-Service, Sync |
| Ergebnis |
erfolgreich, blockiert, fehlgeschlagen |
| Aktion |
Detail anzeigen |
5. Filter und Ansichten
| Filter |
Zweck |
| Zeitraum |
letzte 7 Tage, 30 Tage, Jahr, frei wählbar |
| Aktionstyp |
Einladung, Rolle, Status, Security, System |
| Zielbenutzer |
Audit auf konkreten Benutzer einschränken |
| ausführender Benutzer |
wer hat Aktion ausgelöst |
| Ergebnis |
erfolgreich, blockiert, fehlgeschlagen |
| Quelle |
UI, System, Auth-Service |
6. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Filter anwenden |
Audit-Liste einschränken |
| Eintrag öffnen |
Detailinformationen anzeigen |
| Benutzerprofil öffnen |
öffnet BU-03 für Zielbenutzer |
| Sicherheits-Historie öffnen |
öffnet BU-07, falls Security-Bezug vorhanden |
| Export vorbereiten |
später möglich, nicht zwingend V1 |
| Zurück |
zurück zu vorherigem Screen |
7. Validierungen / Regeln
| ID |
Regel |
| BU08-R01 |
BU-08 ist eine rein lesende Ansicht |
| BU08-R02 |
Audit-Einträge dürfen nicht geändert oder gelöscht werden |
| BU08-R03 |
Audit-Einträge dürfen nur für den eigenen Tenant angezeigt werden |
| BU08-R04 |
sensible Rohdaten wie Token, Passwortdaten oder 2FA-Secrets dürfen nicht angezeigt werden |
| BU08-R05 |
Rollen- und Statusänderungen müssen alten und neuen Wert zeigen, sofern vorhanden |
| BU08-R06 |
Pflichtgründe müssen angezeigt werden, wenn sie erfasst wurden |
| BU08-R07 |
blockierte Sicherheitsregeln wie letzter Admin-Schutz müssen nachvollziehbar sein |
| BU08-R08 |
Export ist in V1 optional und darf keine sensiblen Geheimnisse enthalten |
8. Typische Audit-Aktionen
| Aktion |
Bedeutung |
user_invited |
Benutzer wurde eingeladen |
user_invitation_resent |
Einladung wurde erneut versendet |
user_invitation_revoked |
Einladung wurde widerrufen |
user_invitation_accepted |
Einladung wurde angenommen |
role_changed |
Rolle wurde geändert |
role_change_blocked |
Rollenänderung wurde blockiert |
user_deactivated |
Benutzer wurde deaktiviert |
user_reactivated |
Benutzer wurde reaktiviert |
last_admin_protection_triggered |
letzter Admin-Schutz hat Aktion verhindert |
security_event_reviewed |
Security-Ereignis wurde geprüft, falls protokolliert |
9. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| keine Einträge |
„Keine Audit-Einträge für diese Filterauswahl vorhanden.“ |
| fremder Tenant |
„Zugriff verweigert.“ |
| blockierte Aktion |
Badge „blockiert“ |
| fehlgeschlagene Aktion |
Badge „fehlgeschlagen“ |
| sensibler Wert verborgen |
„Wert aus Sicherheitsgründen verborgen.“ |
| Export nicht verfügbar |
„Export ist in V1 noch nicht aktiviert.“ |
10. Bezug zu Datenmodell
| Bereich |
Bezug |
| Audit |
audit_log |
| Tenant |
tenant_id |
| Zielbenutzer |
target_user_id |
| ausführender Benutzer |
actor_user_id |
| Aktion |
action |
| alter Wert |
old_value |
| neuer Wert |
new_value |
| Grund |
reason |
| Ergebnis |
result |
| Quelle |
source |
| Zeitpunkt |
created_at |
11. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Tenant-Isolation |
serverseitig erzwingen |
| Unveränderbarkeit |
Audit-Einträge nicht editierbar machen |
| Datenminimierung |
keine Passwörter, Tokens oder 2FA-Secrets anzeigen |
| Nachvollziehbarkeit |
alte und neue Werte, Grund und Benutzer anzeigen |
| Zugriffsschutz |
nur berechtigte Rollen |
| Export |
später nur mit reduzierten, sicheren Daten |
12. Akzeptanzkriterien
| ID |
Kriterium |
| BU08-AC01 |
tenant_admin kann BU-08 aus BU-01 oder BU-03 öffnen |
| BU08-AC02 |
System zeigt Audit-Einträge des eigenen Tenants |
| BU08-AC03 |
System zeigt Aktion, Zeitpunkt, Zielobjekt und ausführenden Benutzer |
| BU08-AC04 |
System zeigt alte und neue Werte bei Rollen- und Statusänderungen |
| BU08-AC05 |
System zeigt Gründe, wenn sie erfasst wurden |
| BU08-AC06 |
System zeigt blockierte Aktionen nachvollziehbar an |
| BU08-AC07 |
System zeigt keine Passwörter, Tokens oder 2FA-Secrets |
| BU08-AC08 |
BU-08 verändert keine Audit-Einträge |
| BU08-AC09 |
tenant_admin kann nach Zeitraum, Aktion und Benutzer filtern |
13. Offene Punkte
| ID |
Frage |
Status |
| BU08-O01 |
Wird Audit-Export bereits in V1 angeboten? |
Vorschlag: nein, nur vorbereiten |
| BU08-O02 |
Wie lange bleiben Audit-Einträge sichtbar? |
technische / rechtliche Detailklärung |
| BU08-O03 |
Wird Zugriff auf BU-08 selbst auditierbar protokolliert? |
Security-Review empfohlen |
| BU08-O04 |
Werden Security-Events vollständig in BU-08 gespiegelt oder nur in BU-07 angezeigt? |
offen |
| BU08-O05 |
Werden alte / neue Werte als strukturierte JSON-Werte gespeichert? |
technische Detailklärung |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
1.3 |
Abschnitt «Wireframe» mit klickbarem Bild des Screens ergänzt |
Claude |
| 12.10.2026 09:58 |
1.2 |
Änderungshistorie ans Dokumentende verschoben und Sprunglink «Änderungshistorie anzeigen» unter dem Kopf ergänzt (einheitlicher Dokumentaufbau gemäss AGENTS.md) |
Claude |
| 12.10.2026 09:08 |
1.1 |
Branch-Angabe im Kopfbereich auf main korrigiert |
Claude |
| 01.08.2026 14:55 |
1.0 |
Kopfbereich vereinheitlicht |
David Mittig |