100 lines
3.3 KiB
Markdown
100 lines
3.3 KiB
Markdown
|
# STEP 4.2 – SICHERES PASSWORT-HASHING
|
|||
|
|
# Status: ABGESCHLOSSEN
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Ziel
|
|||
|
|
|
|||
|
|
GAP #18: SHA-256 ohne Salt durch moderne KDF ersetzen.
|
|||
|
|
Transparente Migration bestehender Hashes ohne Forced Reset.
|
|||
|
|
|
|||
|
|
## Alte vs. neue Methode
|
|||
|
|
|
|||
|
|
| Parameter | ALT (unsicher) | NEU (sicher) |
|
|||
|
|
|-----------|----------------|--------------|
|
|||
|
|
| Algorithmus | SHA-256 | bcrypt |
|
|||
|
|
| Salt | Keines | Automatisch (eingebettet) |
|
|||
|
|
| Cost-Faktor | n/a | 12 Runden |
|
|||
|
|
| Hash-Format | 64 Hex-Zeichen | $2b$12$... (60 Zeichen) |
|
|||
|
|
| Brute-Force-Resistenz | Minimal (GPU-optimiert) | ~250ms pro Versuch |
|
|||
|
|
| Rainbow-Table-Schutz | Keiner | Salt schützt |
|
|||
|
|
|
|||
|
|
## Parameter
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
bcrypt.gensalt(rounds=12)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- Cost: 12 (2^12 = 4096 Iterationen)
|
|||
|
|
- Salt: 16 Bytes, automatisch generiert
|
|||
|
|
- Output: 60-Zeichen-String mit eingebettetem Salt + Params
|
|||
|
|
- Format: $2b$12$<22-char-salt><31-char-hash>
|
|||
|
|
|
|||
|
|
## Geänderte Dateien
|
|||
|
|
|
|||
|
|
| Datei | Zeile | Änderung |
|
|||
|
|
|-------|-------|----------|
|
|||
|
|
| basis14.py | 16-17 | `import bcrypt` hinzugefügt |
|
|||
|
|
| basis14.py | 1298-1300 | `_hash_password()`: SHA-256 → bcrypt |
|
|||
|
|
| basis14.py | 1302-1311 | NEU: `_verify_password()` mit Legacy-Erkennung |
|
|||
|
|
| basis14.py | 1313-1317 | NEU: `_is_legacy_hash()` |
|
|||
|
|
| basis14.py | 1355-1362 | Login: `_verify_password()` + automatischer Rehash |
|
|||
|
|
| basis14.py | 1459 | Registration: nutzt neuen `_hash_password()` (bcrypt) |
|
|||
|
|
| basis14.py | 1545 | Profil: `_verify_password()` für altes Passwort |
|
|||
|
|
| basis14.py | 1554 | Profil: `_hash_password()` für neues Passwort (bcrypt) |
|
|||
|
|
|
|||
|
|
## Migrationslogik
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Login-Versuch:
|
|||
|
|
1. _verify_password(pw, stored_hash) aufrufen
|
|||
|
|
2. Prüfe: beginnt stored_hash mit "$2b$" oder "$2a$"?
|
|||
|
|
JA → bcrypt.checkpw()
|
|||
|
|
NEIN → SHA-256 Legacy-Vergleich
|
|||
|
|
3. Bei erfolgreicher Anmeldung:
|
|||
|
|
_is_legacy_hash(stored_hash)?
|
|||
|
|
JA → Rehash mit bcrypt, Profil speichern
|
|||
|
|
NEIN → Nichts tun
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- Kein Forced Reset
|
|||
|
|
- Alter Hash wird beim nächsten Login automatisch ersetzt
|
|||
|
|
- Neuer Hash sofort bei Registration und Passwortänderung
|
|||
|
|
|
|||
|
|
## Legacy-Erkennung
|
|||
|
|
|
|||
|
|
Ein Hash ist Legacy (SHA-256) wenn:
|
|||
|
|
- Er NICHT mit "$2" beginnt (kein bcrypt-Prefix)
|
|||
|
|
- Er exakt 64 Zeichen lang ist (SHA-256 Hex-Output)
|
|||
|
|
|
|||
|
|
## Tests
|
|||
|
|
|
|||
|
|
| Test | Ergebnis |
|
|||
|
|
|------|----------|
|
|||
|
|
| Neuer bcrypt-Hash erstellen | PASS ($2b$12$...) |
|
|||
|
|
| bcrypt verify (korrektes PW) | PASS (True) |
|
|||
|
|
| bcrypt verify (falsches PW) | PASS (False) |
|
|||
|
|
| Legacy SHA-256 erkennen | PASS (is_legacy=True) |
|
|||
|
|
| bcrypt als nicht-Legacy erkennen | PASS (is_legacy=False) |
|
|||
|
|
| Legacy verify (korrektes PW) | PASS (True) |
|
|||
|
|
| Legacy verify (falsches PW) | PASS (False/rejected) |
|
|||
|
|
| Legacy rehash zu bcrypt | PASS (verify nach rehash True) |
|
|||
|
|
|
|||
|
|
## Nicht geändert
|
|||
|
|
|
|||
|
|
- workforce_planner/api/auth.py – nutzt bereits bcrypt (cost=default)
|
|||
|
|
- aza_persistence.py – importiert hashlib, nutzt es aber nicht für Passwörter
|
|||
|
|
- Backup-Kopien (basis14 - Kopie*.py) – bewusst nicht geändert
|
|||
|
|
|
|||
|
|
## Rest-Risiken
|
|||
|
|
|
|||
|
|
1. **bcrypt als Dependency**: Muss installiert sein (`pip install bcrypt`).
|
|||
|
|
Ist bereits Dependency von workforce_planner.
|
|||
|
|
|
|||
|
|
2. **Timing**: Legacy-SHA-256-Vergleich ist schneller als bcrypt.
|
|||
|
|
Ein Timing-Seitenkanalangriff könnte erkennen, ob ein Nutzer
|
|||
|
|
noch einen alten Hash hat. Risiko: minimal (lokale Desktop-App).
|
|||
|
|
|
|||
|
|
3. **workforce_planner cost**: Nutzt bcrypt mit Default-Rounds (10).
|
|||
|
|
Empfehlung: Auf 12 angleichen (separater Schritt).
|