RoWaWorld

Bitte bearbeite dieses Dokument nur, wenn du es verbessern kannst. Nach dem Bearbeiten den [Speichern]-Knopf drücken. Siehe syntax zur Wiki-Syntax. Zum Testen bitte erst im Spielplatz üben.

<WRAP rww-page-header>
<WRAP rww-page-header-main>
<WRAP rww-page-title>
====== DokuWiki-Passwort zurücksetzen ======
</WRAP>

<WRAP rww-page-back>
[[dokumentation_wissen:dokuwiki:start|← DokuWiki]] · [[:start|Startseite]]
</WRAP>
</WRAP>

----

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:

<code>
E:\xampp\htdocs\rowawiki\conf\users.auth.php
</code>

Die Datei beispielsweise mit Notepad++ öffnen.

===== Benutzer suchen =====

In der Datei die Zeile des betreffenden Benutzers suchen.

Für den Administrator beginnt sie mit:

<code>
admin:
</code>

Der grundsätzliche Aufbau einer Benutzerzeile ist:

<code>
Benutzername:Passwort-Hash:Name:E-Mail:Gruppen
</code>

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:

<code cmd>
E:\xampp\php\php.exe -r "echo password_hash('NEUES_PASSWORT', PASSWORD_DEFAULT), PHP_EOL;"
</code>

''NEUES_PASSWORT'' durch das gewünschte neue Passwort ersetzen.

PHP gibt anschließend den neuen Passwort-Hash aus.

===== Passwort-Hash ersetzen =====

In:

<code>
E:\xampp\htdocs\rowawiki\conf\users.auth.php
</code>

**nur den bisherigen Passwort-Hash** des Benutzers durch den neu erzeugten Hash ersetzen.

Die übrigen Angaben der Benutzerzeile bleiben unverändert.

<WRAP important>
Nicht die komplette Benutzerzeile ersetzen.

Nur den Hash zwischen dem ersten und zweiten Doppelpunkt austauschen.
</WRAP>

===== Datei speichern =====

Die geänderte Datei speichern.

In Notepad++ beispielsweise mit:

===== 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 =====

<code>
users.auth.php öffnen
        ↓
Benutzer suchen
        ↓
neuen Passwort-Hash mit PHP erzeugen
        ↓
alten Hash ersetzen
        ↓
Datei speichern
        ↓
mit neuem Passwort anmelden
</code>

===== Merksatz =====

<WRAP info>
**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.
</WRAP>

<WRAP rww-to-top>
[[#dokuwiki-passwort_zuruecksetzen|↑]]
</WRAP>

Zusammenfassung