--- 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.