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

246 lines
8.9 KiB
Markdown

---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Login und 2FA
typ: Flow
status: In Subframe
subframe: "https://app.subframe.com/f023064a5ca0/flow/a457cbaa-9cca-412a-98b2-3bef128338ac/edit"
canvas: "02 Wireframes/P2 Auth/WF-P2 Login und 2FA/WF-P2 Login und 2FA.canvas"
---
# WF-P2 Login und 2FA
Status: In Subframe
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/a457cbaa-9cca-412a-98b2-3bef128338ac/edit
Canvas: [[WF-P2 Login und 2FA.canvas]]
Stand: 2026-06-23
---
## 1. Kurzfassung
Dieses Paket beschreibt den Login-Flow mit E-Mail/Passwort, Magic-Link-Alternative und 2FA.
Ziel ist ein einfacher Standard-Auth-Flow, aber mit bewusst gebauten copy-kritischen Auth-Zustaenden wie Magic-Link gesendet, falsche Login-Daten, Captcha nach mehreren Versuchen und 2FA gesperrt.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-P2 Auth / Identitaet |
| Was soll der Nutzer am Ende schaffen? | sich sicher einloggen und bei Bedarf 2FA bestaetigen |
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | Flow mit Hauptscreens und wichtigen Varianten |
| Welche Planning-Quellen wurden geprueft? | D-P2, SCREEN-MAP Auth-Screens |
| Was ist sicher im Scope? | Login, Magic-Link, Magic-Link gesendet, 2FA, falsche Login-Daten, Captcha, 2FA gesperrt, Konto-erstellen-Link im Login |
| Was ist sicher nicht im Scope? | Signup-Flow selbst, Passwort vergessen, Profil-/Tenant-Auswahl als eigener Flow, Session-Verwaltung |
| Gibt es Admin/Normalrolle-Unterschiede? | Ja, aber nur als Outcome nach erfolgreichem Login |
| Welche Annahmen sind noch unsicher? | Ob 2FA wirklich immer kommt oder nur bei aktivierter 2FA; fuer Wireframe reicht "bei Bedarf" |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-P2 Auth |
| Nutzerrolle | eingeloggter Nutzer nach erfolgreicher Authentifizierung |
| Admin-Variante | Admin geht nach Login zur Tenant-/Workspace-Auswahl oder Admin-Startpunkt |
| Normale Rolle | hoechste Rolle unter Admin geht nach Login zur Home/App |
| Startpunkt | `/login` |
| Ziel | Authentifizierung erfolgreich abschliessen |
| Haupt-Archetyp | A4 Form + A5 Auth-Step |
| Bespoke-Anteil | nein |
| Out of scope | Tenant-Auswahl-Flow, Signup-Flow selbst, Passwort-Reset |
---
## 4. Brainstorming
Screen-Listen entstehen erst nach dem Brainstorming. Hier wurde zuerst entschieden, ob Login E-Mail-first oder klassisch gebuendelt laufen soll.
### Flow-Frage
Soll Login zuerst nur die E-Mail abfragen oder direkt E-Mail und Passwort zusammen zeigen?
### UX-Varianten
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|---|---|---|---|---|
| A | E-Mail und Passwort zusammen auf einem Login-Screen | einfach, vertraut, wenig Schritte | weniger Security-Guidance | genommen |
| B | E-Mail-first, danach Passwort oder Magic-Link | kontrollierter, modern | mehr Schritte, komplexer | raus fuer v1 |
| C | Voller Security-first Flow mit Account-Erkennung und mehreren Pfaden | sehr granular | zu komplex, Risiko fuer Account-Enumeration | raus |
### Entscheidung
| Entscheidung | Status | Notiz |
|---|---|---|
| E-Mail + Passwort zusammen | genommen | einfacher Standardflow; kein E-Mail-Pre-Screen |
| Magic-Link direkt auf Login sichtbar | genommen | Alternative sichtbar, aber nicht dominant |
| Magic-Link eigener Anforderungs-Screen | genommen | bewusster Wechsel in alternativen Login |
| Konto erstellen Link im Login | genommen | Signup ist erreichbar, aber eigener Flow |
| Wichtige Auth-Zustaende bauen | genommen | Copy soll von Design entschieden werden |
| Admin-Weiterleitung | dokumentieren | eigener Tenant-/Workspace-Flow spaeter |
### Happy Path
1. Nutzer oeffnet Login.
2. Nutzer gibt E-Mail und Passwort ein.
3. Falls 2FA noetig ist, gibt Nutzer den 6-stelligen Code ein.
4. Danach geht es je nach Rolle weiter.
### Varianten / Branches
- Nutzer waehlt Magic-Link.
- Magic-Link wurde gesendet.
- Login-Daten sind falsch.
- Captcha erscheint nach mehreren Fehlversuchen.
- 2FA ist gesperrt oder zu oft falsch eingegeben.
### Roadblocks
- falsche Login-Daten
- Captcha erforderlich
- 2FA zu oft falsch
- technische Login-Fehler
### Offene Fragen
- Kommt 2FA wirklich bei jedem Login oder nur bei aktivierter 2FA?
- Admin-/Mehrworkspace-Ziel wird in `WF-P2 Workspace Auswahl` geplant; UI-Begriff ist Workspace.
---
## 5. Screen-Kandidaten nach Entscheidung
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|---|---|---|
| Login | Hauptscreen | Bauen |
| Magic-Link anfordern | alternativer Auth-Weg | Bauen |
| Magic-Link gesendet | copy-kritischer Erfolg | Bauen |
| 2FA Code eingeben | eigener Security-Schritt | Bauen |
| Login mit falschen Daten | haeufiger, copy-kritischer Fehler | Bauen |
| Login mit mCaptcha | Layout aendert sich nach 3 Fehlversuchen | Bauen |
| 2FA gesperrt | wichtiger Blocker | Bauen |
| Konto erstellen Link | Nutzer ohne Konto braucht klaren Einstieg | in S01 integrieren |
| E-Mail-Pre-Screen | alternative UX, aber fuer v1 zu viel Schritt | Raus |
| Trust Device | Bestandteil von 2FA | in 2FA integrieren |
| Login erfolgreich | reine Weiterleitung | Raus |
| Admin-Weiterleitung | Rollen-Outcome | Dokumentieren |
---
## 6. Screen Validation Gate
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|---|---|---|---|---|---|
| S01 | [[Screens/S01 Login]] | ja | ja, Hauptauthentifizierung | Bauen | Hauptscreen |
| S02 | [[Screens/S02 Magic-Link anfordern]] | ja | ja, alternativer Login-Weg | Bauen | Nutzer entscheidet bewusst Magic-Link |
| S03 | [[Screens/S03 Magic-Link gesendet]] | ja | ja, naechster Schritt muss klar sein | Bauen | copy-kritischer Zustand |
| S04 | [[Screens/S04 2FA Code eingeben]] | ja | ja, Security-Schritt | Bauen | eigener Auth-Schritt |
| V01 | [[Varianten/V01 Login falsche Daten]] | teilweise | ja, sensibler Fehlertext | Bauen | Copy nicht Dev ueberlassen |
| V02 | [[Varianten/V02 Login mit mCaptcha]] | teilweise | ja, Feld/Struktur kommt hinzu | Bauen | Captcha-Slot muss sichtbar sein |
| V03 | [[Varianten/V03 2FA gesperrt]] | ja | ja, Blocker | Bauen | Nutzer braucht klare Loesung |
| D01 | Trust Device | nein | nein | Wiederverwenden | Checkbox in S04 |
| D02 | Login erfolgreich | nein | nein | Raus | nur Weiterleitung |
| D03 | Admin nach Login | nein | Rollen-Outcome | Nur dokumentieren | siehe `WF-P2 Workspace Auswahl`; UI-Begriff ist Workspace |
| D04 | Konto erstellen Link | nein | Navigation zu anderem Flow | Wiederverwenden | Link in S01, Signup ist eigenes Paket |
| D05 | E-Mail-Pre-Screen | nein | zusaetzlicher Schritt | Raus | fuer v1 nicht noetig |
### Copy-kritische Zustaende
| Zustand | Bauen? | Warum / Copy-Entscheidung |
|---|---|---|
| Magic-Link gesendet | ja | Nutzer muss wissen, was als Naechstes passiert |
| Falsche Login-Daten | ja | neutraler Sicherheitstext, keine Account-Enumeration |
| mCaptcha nach 3 Versuchen | ja | Layout aendert sich, Anti-Abuse sichtbar |
| 2FA gesperrt | ja | starker Blocker, Loesung muss klar sein |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | [[Screens/S01 Login]] | Auth Form | Bauen | `/login` | Validiert |
| S02 | [[Screens/S02 Magic-Link anfordern]] | Auth Form | Bauen | von S01 | Validiert |
| S03 | [[Screens/S03 Magic-Link gesendet]] | Auth Feedback | Bauen | nach S02 | Validiert |
| S04 | [[Screens/S04 2FA Code eingeben]] | Auth Security | Bauen | nach S01 | Validiert |
| V01 | [[Varianten/V01 Login falsche Daten]] | Auth Error | Bauen | Variante von S01 | Validiert |
| V02 | [[Varianten/V02 Login mit mCaptcha]] | Auth Error | Bauen | Variante von S01 | Validiert |
| V03 | [[Varianten/V03 2FA gesperrt]] | Auth Blocker | Bauen | Variante von S04 | Validiert |
---
## 8. Subframe-Grid
Hauptflow:
```text
S01 Login -> S04 2FA Code eingeben -> Outcome
```
Magic-Link Branch:
```text
S01 Login -> S02 Magic-Link anfordern -> S03 Magic-Link gesendet
```
Login-Varianten:
```text
S01 Login
|
v
V01 Login falsche Daten
S01 Login
|
v
V02 Login mit mCaptcha
```
2FA-Variante:
```text
S04 2FA Code eingeben
|
v
V03 2FA gesperrt
```
Outcome nach erfolgreichem Login:
| Rolle | Ziel |
|---|---|
| Normale Rolle | Home/App |
| Admin | Tenant-/Workspace-Auswahl oder Admin-Startpunkt |
---
## 9. Screen-Pakete
- [[Screens/S01 Login]]
- [[Screens/S02 Magic-Link anfordern]]
- [[Screens/S03 Magic-Link gesendet]]
- [[Screens/S04 2FA Code eingeben]]
- [[Varianten/V01 Login falsche Daten]]
- [[Varianten/V02 Login mit mCaptcha]]
- [[Varianten/V03 2FA gesperrt]]
---
## 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] Toasts/Action-Feedback sind dokumentiert.
- [x] Relevante Zustaende sind beschrieben.
- [x] Rollen-Outcome ist dokumentiert.
- [x] Offene Fragen sind sichtbar.
- [x] Subframe-Link ist eingetragen.