Inhaltsverzeichnis
DokuWiki-Passwort zurücksetzen
Wurde das Passwort eines lokalen DokuWiki-Benutzers vergessen, kann ein neues Passwort direkt über die DokuWiki-Benutzerdatei gesetzt werden.
Dieses Verfahren wurde bei meinem lokalen RoWaWiki erfolgreich verwendet.
Ausgangssituation
Das Passwort für den Benutzer admin war nicht mehr bekannt.
Die Anmeldung über die normale DokuWiki-Anmeldeseite war deshalb nicht mehr möglich.
Benutzerdatei öffnen
Die Benutzerkonten befinden sich bei meiner lokalen RoWaWiki-Installation in:
E:\xampp\htdocs\rowawiki\conf\users.auth.php
Die Datei beispielsweise mit Notepad++ öffnen.
Benutzer suchen
In der Datei die Zeile des betreffenden Benutzers suchen.
Für den Administrator beginnt sie mit:
admin:
Der grundsätzliche Aufbau einer Benutzerzeile ist:
Benutzername:Passwort-Hash:Name:E-Mail:Gruppen
Wichtig ist der Passwort-Hash zwischen dem ersten und zweiten Doppelpunkt.
Neuen Passwort-Hash erzeugen
Eine Windows-Eingabeaufforderung öffnen.
Mit der lokalen PHP-Installation von XAMPP kann ein neuer Passwort-Hash erzeugt werden:
E:\xampp\php\php.exe -r "echo password_hash('NEUES_PASSWORT', PASSWORD_DEFAULT), PHP_EOL;"
NEUES_PASSWORT durch das gewünschte neue Passwort ersetzen.
PHP gibt anschließend den neuen Passwort-Hash aus.
Passwort-Hash ersetzen
In:
E:\xampp\htdocs\rowawiki\conf\users.auth.php
nur den bisherigen Passwort-Hash des Benutzers durch den neu erzeugten Hash ersetzen.
Die übrigen Angaben der Benutzerzeile bleiben unverändert.
Nicht die komplette Benutzerzeile ersetzen.
Nur den Hash zwischen dem ersten und zweiten Doppelpunkt austauschen.
Datei speichern
Die geänderte Datei speichern.
In Notepad++ beispielsweise mit:
Strg + S
Anmeldung testen
Anschließend die normale Anmeldeseite von RoWaWiki öffnen.
Anmelden mit:
- Benutzername:
admin - Passwort: das neu vergebene Passwort
Bei meinem RoWaWiki funktionierte die Anmeldung anschließend wieder.
Kurzfassung
users.auth.php öffnen
↓
Benutzer suchen
↓
neuen Passwort-Hash mit PHP erzeugen
↓
alten Hash ersetzen
↓
Datei speichern
↓
mit neuem Passwort anmelden
Merksatz
DokuWiki speichert nicht das eigentliche Passwort, sondern einen Passwort-Hash.
Beim manuellen Zurücksetzen wird deshalb nicht das neue Passwort in users.auth.php eingetragen, sondern der mit PHP erzeugte Hash.