Files
HiveGrid-Wireframes/02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.md
T
2026-06-24 23:36:10 +02:00

202 lines
8.6 KiB
Markdown

---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P2 / Auth-Core
package: WF-P2 2FA Verwalten
typ: Auth-Core Modal Flow
status: In Subframe
subframe: "https://app.subframe.com/f023064a5ca0/flow/4de27a18-0e2f-43de-b39b-01a94b0c93b8/edit"
canvas: WF-P2 2FA Verwalten.canvas
---
# WF-P2 2FA Verwalten
Status: In Subframe
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/4de27a18-0e2f-43de-b39b-01a94b0c93b8/edit
Canvas: [[WF-P2 2FA Verwalten.canvas]]
Stand: 2026-06-23
---
## 1. Kurzfassung
`2FA Verwalten` ist ein eigener wiederverwendbarer Sicherheitsflow.
Der Flow wird aus Profil Settings getriggert, bleibt aber getrennt, damit 2FA spaeter auch aus anderen Sicherheitskontexten gestartet werden kann. Die UI ist als Modal-/Dialogsequenz gedacht.
Wichtig: `2FA-Code eingeben` ist hier kein eigener Flow. Code-Eingaben sind Inline-Zustaende in den jeweiligen Modals, z. B. bei Device hinzufuegen oder 2FA deaktivieren.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-P2 / Auth-Core |
| Was soll der Nutzer am Ende schaffen? | 2FA einrichten, vorhandene 2FA-Devices sehen, neue Devices hinzufuegen, Devices entfernen oder 2FA deaktivieren |
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | eigener Sicherheitsflow als Modal-/Dialogsequenz |
| Welche Planning-Quellen wurden geprueft? | D-P2, Profil-und-Sicherheit-Entscheidung, Set-Password-2FA-Pattern |
| Was ist sicher im Scope? | 2FA Status, 2FA aktivieren/einrichten, Device hinzufuegen, Device entfernen, 2FA deaktivieren mit Code + Confirm |
| Was ist sicher nicht im Scope? | Profil bearbeiten, Passwort aendern, Session-Verwaltung, Trust-Device-Liste als eigene Seite |
| Gibt es Admin/Normalrolle-Unterschiede? | nein; gleicher Self-Service-Flow fuer eingeloggte Nutzer |
| Welche Annahmen sind noch unsicher? | ob v1 mehrere Authenticator-Devices wirklich unterstuetzt oder die UI erstmal nur darauf vorbereitet wird |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-P2 / Auth-Core |
| Nutzerrolle | eingeloggter Nutzer |
| Admin-Variante | keine eigene UI |
| Normale Rolle | gleicher Flow |
| Startpunkt | Trigger aus Profil Settings oder spaeter anderer Sicherheitskontext |
| Ziel | 2FA-Status sicher verwalten |
| Haupt-Archetyp | A5 Modal/Wizard + A4 Auth Form |
| Bespoke-Anteil | nein |
| Out of scope | aktive Sessions, Trust-Device-Liste als eigene Security-Seite, Passwort aendern |
---
## 4. Brainstorming
### Flow-Frage
Wie viel eigene Struktur braucht 2FA-Verwaltung, ohne aus einfachen Code-Eingaben eigene Flows zu machen?
### UX-Varianten
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|---|---|---|---|---|
| A | 2FA komplett im Profil-Screen einbetten | wenig Modals | Profil wird sicherheitslastig und schlechter wiederverwendbar | raus |
| B | Eigener 2FA-Verwalten-Flow, aber Code-Eingaben bleiben Inline-Zustaende | wiederverwendbar, schlank, klarer Security-Kontext | braucht saubere Modal-Zustaende | genommen |
| C | Jede 2FA-Bestaetigung als eigener Flow | sehr formal | zu kompliziert fuer diesen Scope | raus |
### Entscheidung
| Entscheidung | Status | Notiz |
|---|---|---|
| 2FA-Verwaltung ist eigener Flow | genommen | Profil ist nur Trigger |
| UI als Modal-/Dialogsequenz | genommen | bleibt innerhalb der App-Shell |
| 2FA-Code-Eingaben sind keine eigenen Flows | genommen | Codefelder liegen im jeweiligen Modal |
| Inaktiver und aktiver Status liegen in demselben Start-Modal | genommen | spart eigenen Empty-State-Screen |
| Device/Token hinzufuegen ist ein eigener Modal-Step | genommen | QR/Secret + Code brauchen eigenen Arbeitsmoment |
| Device entfernen ist kein eigener Screen | genommen | Row-Action + Confirm reicht |
| Letztes Device nicht still entfernen | genommen | blockieren oder zu 2FA deaktivieren fuehren |
| 2FA deaktivieren ist eigener Confirm-Modal | genommen | hoher Risiko-Branch, aber Code + Confirm im selben Modal |
| MFA-Aenderung benachrichtigen | genommen | E-Mail/Toast nur dokumentieren, kein eigener Screen |
### Happy Path
1. Nutzer klickt in Profil Settings auf 2FA verwalten.
2. Modal `2FA verwalten` oeffnet sich.
3. Wenn 2FA nicht aktiv ist, sieht der Nutzer den Status und kann 2FA einrichten.
4. Wenn 2FA aktiv ist, sieht der Nutzer vorhandene Devices und Aktionen.
5. Nutzer fuegt ein Device hinzu oder entfernt ein Device.
6. Nutzer kann 2FA deaktivieren; dafuer gibt er den 2FA-Code im Deaktivieren-Modal ein und bestaetigt bewusst die Deaktivierung.
### Varianten / Branches
- 2FA ist nicht aktiv: Start-Modal zeigt CTA `2FA einrichten`.
- 2FA ist aktiv: Start-Modal zeigt Device-Liste und Aktionen.
- Neues Device hinzufuegen: QR/Secret + Code im Setup-Modal.
- Device entfernen: Row-Action mit kleiner Confirm-Abfrage.
- Letztes Device entfernen: blockiert oder fuehrt zu `2FA deaktivieren`.
- 2FA deaktivieren: Code + Confirm im selben Modal.
- Code ist falsch: Inline-Fehler, kein eigener Screen.
### Roadblocks
- falscher 2FA-Code
- letztes Device entfernen
- Setup-Code abgelaufen/ungueltig
- technische Setup-/Disable-Fehler
### Meldungs-/Error-State-Brainstorming
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| 2FA nicht aktiv | Zustand in M01 | nein | nein | CTA zum Einrichten |
| 2FA aktiv | Zustand in M01 | nein | nein | Device-Liste + Aktionen |
| neues Device hinzufuegen | Modal-Step M02 | ja | pruefen | QR/Secret + Code |
| Device entfernen | Row-Action + Confirm | teilweise | nein | wenn nicht letztes Device |
| letztes Device entfernen | Inline/Confirm-Hinweis | ja | nein | Nutzer soll 2FA deaktivieren statt letztes Device still entfernen |
| 2FA deaktivieren | Modal M03 | ja | pruefen | Code + bewusster Confirm im selben Modal |
| 2FA-Code falsch | Inline im Modal | ja | nein | korrigierbar |
---
## 5. Screen-Kandidaten nach Entscheidung
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|---|---|---|
| 2FA verwalten | Start-Modal fuer aktiven/inaktiven Status | Bauen |
| 2FA einrichten / Device hinzufuegen | QR/Secret + Code | Bauen |
| 2FA deaktivieren | sicherheitskritischer Branch | Bauen |
| Device entfernen | kleinere Aktion | Nur dokumentieren |
| 2FA-Code falsch | Inline-Zustand | Nur dokumentieren |
| Letztes Device entfernen blockiert | Inline-/Confirm-Zustand | Nur dokumentieren |
---
## 6. Screen Validation Gate
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|---|---|---|---|---|---|
| M01 | 2FA verwalten | ja | ja, eigener Sicherheitsstart | Bauen | Status, Device-Liste, Einstieg zu Aktionen |
| M02 | Device/Token hinzufuegen | ja | ja, QR/Secret + Code | Bauen | eigener Setup-Arbeitsmoment |
| M03 | 2FA deaktivieren | ja | ja, hohes Risiko | Bauen | Code + Confirm im selben Modal |
| D01 | Device entfernen | teilweise | ja, Zugriff wird entzogen | Nur dokumentieren | Row-Action + Confirm reicht |
| D02 | 2FA-Code falsch | nein | nein | Nur dokumentieren | Inline-Fehler |
| D03 | Letztes Device entfernen | nein | ja | Nur dokumentieren | blockieren oder zu 2FA deaktivieren fuehren |
| D04 | MFA-Aenderung Benachrichtigung | nein | ja, Security Audit | Nur dokumentieren | E-Mail/Toast nach Setup, Remove, Disable |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| M01 | 2FA verwalten | Modal | Bauen | von Profil Settings | Validiert |
| M02 | Device/Token hinzufuegen | Modal | Bauen | von M01 | Validiert |
| M03 | 2FA deaktivieren | Modal | Bauen | von M01 | Validiert |
| D01 | Device entfernen | Row-Action/Confirm | Nur dokumentieren | in M01 | Validiert |
| D02 | 2FA-Code falsch/abgelaufen | Inline | Nur dokumentieren | in M02/M03 | Validiert |
| D03 | Letztes Device entfernen | Inline/Confirm | Nur dokumentieren | in M01 | Validiert |
| D04 | MFA-Aenderung Benachrichtigung | E-Mail/Toast | Nur dokumentieren | nach Setup/Remove/Disable | Validiert |
---
## 8. Subframe-Grid
```text
Profil Settings -> M01 2FA verwalten
M01 -> M02 Device/Token hinzufuegen
M01 -> M03 2FA deaktivieren
M01 -> Device entfernen (dokumentierte Row-Action)
M02/M03 -> 2FA-Code falsch (Inline)
M02/M03/Device entfernen -> MFA-Aenderung Benachrichtigung (dokumentiert)
```
---
## 9. Screen-Pakete
| ID | Datei |
|---|---|
| M01 | [[Screens/M01 2FA verwalten.md]] |
| M02 | [[Screens/M02 Device Token hinzufuegen.md]] |
| M03 | [[Screens/M03 2FA deaktivieren.md]] |
---
## 10. Handoff-Check
- [x] Eigenes Paket ist angelegt.
- [x] Profil ist nur Trigger, nicht Besitzer des Flows.
- [x] 2FA-Code-Bestaetigung ist kein eigener Flow.
- [x] 2FA deaktivieren verlangt Code + Confirm im selben Modal.
- [x] David hat die Kandidaten validiert.
- [ ] Subframe-Link ist eingetragen.