Dateien
Hetzner-Backup/v2_adminpanel/MIGRATION_2FA.md
2025-06-09 04:38:35 +02:00

1.3 KiB

Migration zu Passwort-Änderung und 2FA

Übersicht

Das Admin Panel unterstützt jetzt Passwort-Änderungen und Zwei-Faktor-Authentifizierung (2FA). Um diese Features zu nutzen, müssen bestehende Benutzer migriert werden.

Migration durchführen

  1. Container neu bauen (für neue Dependencies):

    docker-compose down
    docker-compose build adminpanel
    docker-compose up -d
    
  2. Migration ausführen:

    docker exec -it v2_adminpanel python migrate_users.py
    

    Dies erstellt Datenbankeinträge für die in der .env konfigurierten Admin-Benutzer.

Nach der Migration

Passwort ändern

  1. Einloggen mit bisherigem Passwort
  2. Klick auf "👤 Profil" in der Navigation
  3. Neues Passwort eingeben (min. 8 Zeichen)

2FA aktivieren

  1. Im Profil auf "2FA einrichten" klicken
  2. QR-Code mit Google Authenticator oder Authy scannen
  3. 6-stelligen Code eingeben
  4. Backup-Codes sicher aufbewahren!

Wichtige Hinweise

  • Backup-Codes unbedingt speichern (Drucker, USB-Stick, etc.)
  • Jeder Backup-Code kann nur einmal verwendet werden
  • Bei Verlust des 2FA-Geräts können nur Backup-Codes helfen

Rückwärtskompatibilität

  • Benutzer aus .env funktionieren weiterhin
  • Diese haben aber keinen Zugriff auf Profil-Features
  • Migration ist erforderlich für neue Features