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

226 lines
9.8 KiB
Markdown

---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
typ: Zubringerflow
status: In Subframe
subframe: "https://app.subframe.com/f023064a5ca0/flow/5782f3c4-4321-4bb9-b048-990e296897a4/edit"
canvas: "02 Wireframes/P2 Auth/WF-P2 Passwort Reset/WF-P2 Passwort Reset.canvas"
---
# WF-P2 Passwort Reset
Status: In Subframe
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/5782f3c4-4321-4bb9-b048-990e296897a4/edit
Canvas: [[WF-P2 Passwort Reset.canvas]]
Stand: 2026-06-23
---
## 1. Kurzfassung
`Passwort Reset` ist ein Zubringerflow zum zentralen `WF-P2 Set Password`.
Der Nutzer fordert per E-Mail einen Reset-Link an. Nach dem Oeffnen des Links wird, falls fuer den Account 2FA aktiv ist, erst 2FA bestaetigt. Danach fuehrt der Flow in `WF-P2 Set Password`.
Wenn 2FA nicht mehr verfuegbar ist, bekommt der Nutzer einen klaren Blocker-Screen mit zwei sicheren Pfaden: Admin kontaktieren oder einen zuvor gespeicherten Wiederherstellungscode verwenden.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-P2 / Auth |
| Was soll der Nutzer am Ende schaffen? | Passwort-Reset sicher starten und danach in Set Password wechseln |
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | Zubringerflow |
| Welche Planning-Quellen wurden geprueft? | D-P2, Route `/forgot-password`, Route `/reset`, Passwort-Reset-Mail, Password Policy |
| Was ist sicher im Scope? | E-Mail anfordern, Reset-Link gesendet, 2FA-Bestaetigung, Link ungueltig/abgelaufen, 2FA nicht verfuegbar, Admin-Kontakt, Wiederherstellungscode als Recovery-Pfad |
| Was ist sicher nicht im Scope? | Neues Passwort setzen, 2FA neu einrichten im Detail, separater externer Kontaktpfad |
| Gibt es Admin/Normalrolle-Unterschiede? | Nutzer sieht bei verlorener 2FA den Admin-Kontakt und kann optional einen gespeicherten Wiederherstellungscode nutzen |
| Welche Annahmen sind noch unsicher? | Detailverhalten nach erfolgreichem Recovery-Code: ob 2FA direkt neu eingerichtet werden muss oder nach Set Password erzwungen wird |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-P2 / Auth |
| Nutzerrolle | Nutzer ohne aktuelle Session |
| Startpunkt | Login -> Passwort vergessen |
| Ziel | sicherer Uebergang in `WF-P2 Set Password` |
| Haupt-Archetyp | A4 Form + Auth-Status |
| Bespoke-Anteil | nein |
| Security-Regel | keine User Enumeration: unbekannte E-Mail zeigt denselben Gesendet-Screen |
| Out of scope | Passwortformular, 2FA-Setup, Admin-Reset aus Admin UI |
---
## 4. Brainstorming
### Flow-Frage
Wie viel Sicherheit braucht der Passwort-Reset, bevor der Nutzer ein neues Passwort setzen darf?
### UX-Varianten
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|---|---|---|---|---|
| A | E-Mail eingeben -> Link gesendet -> Set Password | sehr kurz | zu schwach, wenn 2FA aktiv ist | raus |
| B | E-Mail eingeben -> Link gesendet -> 2FA pruefen, falls aktiv -> Set Password | sicherer B2B-Standard | ein zusaetzlicher Schritt bei aktiver 2FA | genommen |
| C | Immer Admin/Support oder Recovery-Code vor Set Password | maximal vorsichtig | zu viel Reibung fuer Standard-Reset | raus |
### Entscheidung
| Entscheidung | Status | Notiz |
|---|---|---|
| Option B | genommen | Reset bleibt schlank, aber 2FA wird respektiert |
| Keine E-Mail-nicht-gefunden-Meldung | genommen | neutraler Gesendet-Screen verhindert Account Enumeration |
| 2FA vor Set Password, wenn aktiv | genommen | Reset darf 2FA nicht umgehen |
| 2FA nicht verfuegbar als eigener Screen | genommen | Nutzer braucht klare Loesung: Admin kontaktieren oder Wiederherstellungscode verwenden |
| Separater externer Kontaktpfad | raus | V1 nutzt nur Admin-Kontakt als Kontaktpfad |
| Wiederherstellungscode als Alternative | genommen | Code ist legitimer Recovery-Pfad, wenn er vorher gespeichert wurde und einmalig verwendet wird |
| Neues Passwort nicht hier bauen | genommen | liegt im zentralen `WF-P2 Set Password` |
| Abbrechen als kleiner Link | genommen | Reset-Flow kann jederzeit ueber kleinen Textlink zum Login verlassen werden |
### Happy Path
1. Nutzer klickt im Login auf Passwort vergessen.
2. Nutzer gibt E-Mail ein.
3. Nutzer sieht neutralen Screen: Reset-Link gesendet.
4. Nutzer oeffnet Link aus der E-Mail.
5. Wenn 2FA aktiv ist, bestaetigt der Nutzer 2FA.
6. Danach geht es zu `WF-P2 Set Password`.
### Varianten / Branches
- Reset-Link ist ungueltig oder abgelaufen.
- 2FA ist aktiv, aber Nutzer hat keinen Zugriff mehr auf Authenticator.
- Nutzer kontaktiert Admin mit kurzer Nachricht.
- Nutzer nutzt einen gespeicherten Wiederherstellungscode, um 2FA zurueckzusetzen.
- E-Mail ist unbekannt: trotzdem S02 anzeigen.
- Zu viele Anfragen: Rate-Limit wird dokumentiert, kein eigener Screen fuer v1.
### Roadblocks
- E-Mail fehlt/ungueltig
- Reset-Link ungueltig/abgelaufen
- 2FA-Code falsch
- 2FA nicht verfuegbar
- Wiederherstellungscode ungueltig oder bereits verwendet
- Rate-Limit
---
## 5. Screen-Kandidaten nach Entscheidung
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|---|---|---|
| Passwort Reset anfordern | Hauptstart | Bauen |
| Reset-Link gesendet | copy-kritischer Status, Anti-Enumeration | Bauen |
| 2FA bestaetigen | Sicherheitspruefung vor Set Password | Bauen |
| Reset-Link ungueltig/abgelaufen | eigener Blocker mit naechster Aktion | Bauen |
| 2FA nicht verfuegbar / Admin kontaktieren | Nutzer ist sonst festgefahren | Bauen |
| Admin kontaktieren Modal | Nutzer soll dem Admin direkt eine kurze Nachricht senden koennen | Bauen |
| Wiederherstellungscode eingeben | sicherer Self-Service-Pfad, wenn Code vorhanden ist | Bauen |
| E-Mail fehlt/ungueltig | Formularzustand | Nur dokumentieren |
| E-Mail nicht gefunden | darf nicht sichtbar sein | Wiederverwenden S02 |
| Zu viele Anfragen | Rate-Limit-Zustand | Nur dokumentieren |
---
## 6. Screen Validation Gate
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|---|---|---|---|---|---|
| S01 | [[Screens/S01 Passwort Reset anfordern]] | ja | ja, Start des Flows | Bauen | eigener Auth-Einstieg |
| S02 | [[Screens/S02 Reset-Link gesendet]] | ja | ja, copy-kritischer Status | Bauen | Anti-Enumeration muss klar gestaltet sein |
| S03 | [[Screens/S03 2FA bestaetigen]] | ja | ja, Sicherheitspruefung | Bauen | Reset darf 2FA nicht umgehen |
| V01 | [[Varianten/V01 Reset-Link ungueltig]] | ja | ja, Blocker | Bauen | Nutzer braucht neuen Link |
| V02 | [[Varianten/V02 2FA nicht verfuegbar]] | ja | ja, Blocker | Bauen | Nutzer muss Admin kontaktieren oder Recovery-Code nutzen koennen |
| M01 | [[Screens/M01 Admin kontaktieren]] | ja | ja, Kontaktpfad | Bauen | kleines Modal mit Textarea an Admin |
| M02 | [[Screens/M02 Wiederherstellungscode eingeben]] | ja | ja, Security Recovery | Bauen | Code pruefen und 2FA sicher zuruecksetzen |
| D01 | E-Mail fehlt/ungueltig | nein | nein | Nur dokumentieren | Standardformular |
| D02 | E-Mail nicht gefunden | nein | Sicherheit | Wiederverwenden | immer S02 anzeigen |
| D03 | Zu viele Anfragen | nein | technischer Schutz | Nur dokumentieren | Meldung im S01/S02-Kontext |
| D04 | 2FA-Code falsch | nein | nein | Nur dokumentieren | Inline-Fehler in S03 |
### Copy-kritische Zustaende
| Zustand | Bauen? | Warum / Copy-Entscheidung |
|---|---|---|
| Reset-Link gesendet | ja | Nutzer muss wissen, dass auch unbekannte E-Mails gleich behandelt werden, ohne es direkt so zu sagen |
| Reset-Link ungueltig | ja | naechste Aktion muss klar sein |
| 2FA nicht verfuegbar | ja | starker Blocker, Admin-Kontakt oder Wiederherstellungscode notwendig |
| Admin-Nachricht | ja | Nutzer braucht klare Erwartung, was an Admin gesendet wird |
| Wiederherstellungscode | ja | Muss klar als vorher gespeicherter, einmalig nutzbarer Code erklaert werden |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | [[Screens/S01 Passwort Reset anfordern]] | Auth Form | Bauen | `/forgot-password` | Validiert |
| S02 | [[Screens/S02 Reset-Link gesendet]] | Auth Feedback | Bauen | nach S01 | Validiert |
| S03 | [[Screens/S03 2FA bestaetigen]] | Auth Security | Bauen | nach Reset-Link, falls 2FA aktiv | Validiert |
| V01 | [[Varianten/V01 Reset-Link ungueltig]] | Auth Blocker | Bauen | Link-Fehler | Validiert |
| V02 | [[Varianten/V02 2FA nicht verfuegbar]] | Auth Blocker | Bauen | Variante von S03 | In Subframe |
| M01 | [[Screens/M01 Admin kontaktieren]] | Auth Modal | Bauen | von V02 | In Subframe |
| M02 | [[Screens/M02 Wiederherstellungscode eingeben]] | Auth Modal | Bauen | von V02 | In Subframe |
---
## 8. Subframe-Grid
Hauptflow:
```text
S01 Passwort Reset anfordern -> S02 Reset-Link gesendet -> E-Mail-Link -> S03 2FA bestaetigen -> WF-P2 Set Password
```
Ohne aktive 2FA:
```text
S02 Reset-Link gesendet -> E-Mail-Link -> WF-P2 Set Password
```
Blocker:
```text
E-Mail-Link -> V01 Reset-Link ungueltig
S03 2FA bestaetigen -> V02 2FA nicht verfuegbar
V02 2FA nicht verfuegbar -> M01 Admin kontaktieren
V02 2FA nicht verfuegbar -> M02 Wiederherstellungscode eingeben -> WF-P2 Set Password
```
---
## 9. Screen-Pakete
- [[Screens/S01 Passwort Reset anfordern]]
- [[Screens/S02 Reset-Link gesendet]]
- [[Screens/S03 2FA bestaetigen]]
- [[Varianten/V01 Reset-Link ungueltig]]
- [[Varianten/V02 2FA nicht verfuegbar]]
- [[Screens/M01 Admin kontaktieren]]
- [[Screens/M02 Wiederherstellungscode eingeben]]
Alle Screens nutzen `Abbrechen` als kleinen sekundaren Link, wenn der Nutzer den Reset-Flow verlassen soll.
---
## 10. Handoff-Check
- [x] Jeder Screen ist mit Umsetzung markiert.
- [x] Jedes sichtbare Feld hat eine Datenquelle.
- [x] Jeder Button hat eine Aktion.
- [x] Banner/Inline-Meldungen sind dokumentiert.
- [x] Relevante Zustaende sind beschrieben.
- [x] Zubringer-/Core-Regel ist dokumentiert.
- [x] Zurueck-/Abbrechen-Aktion ist dokumentiert.
- [x] Offene Fragen sind sichtbar.
- [x] Subframe-Link ist eingetragen.