202 lines
8.6 KiB
Markdown
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.
|