Zum Hauptinhalt springen

Change user password

POST 
/company/users/changePass

Ermöglicht dem authentifizierten Benutzer, sein eigenes Passwort zu ändern.

Ziel​

Sichere Passwortänderung durch den Benutzer selbst ermöglichen, unter Beibehaltung des Passwortverlaufs, um Wiederholungen zu vermeiden.

Anwendungsfälle​

  • Benutzer möchte sein Passwort regelmäßig ändern
  • Benutzer hat sein Passwort vergessen und die Wiederherstellung genutzt (möchte nun ein persönliches)
  • Sicherheitsrichtlinie erfordert regelmäßige Änderung

Authentifizierung​

  • Erfordert gültiges JWT (Middleware m.isLoged)
  • Benutzer muss authentifiziert sein

Validierungen​

  • Das aktuelle Passwort muss gültig sein (model.isValidPassword)
  • Das neue Passwort muss mit der Bestätigung übereinstimmen
  • Das neue Passwort muss Sicherheitsanforderungen erfüllen:
    • Mindestens 8 Zeichen
    • Mindestens 1 Großbuchstabe
    • Mindestens 1 Zahl
  • Darf nicht mit den letzten 5 verwendeten Passwörtern identisch sein
  • Erstellt Benachrichtigung bei Passwortänderung

Ablauf​

  1. Benutzer sendet aktuelles Passwort und neues Passwort
  2. System prüft, ob das aktuelle Passwort korrekt ist
  3. System prüft, ob new_pass und confirm_pass übereinstimmen
  4. Wenn gültig, wird auf das neue gehashte Passwort aktualisiert
  5. Löscht recovery_token
  6. Erstellt Benachrichtigung über Passwortänderung
  7. Aktualisiert Token mit m.setNewToken()

Fehlermeldungen​

  • INVALID_PASSWORD (403): Aktuelles Passwort ist falsch
  • PASSWORD_NOT_MATCH (405): new_pass und confirm_pass stimmen nicht überein

Request​

Responses​

Passwort erfolgreich geändert