Manual:wrapOldPasswords.php
From Linux Web Expert
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>">
<translate> ≥</translate> 1.24
| <translate> MediaWiki version:</translate> |
| MediaWiki file: wrapOldPasswords.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.41.1 • 1.40.3 • 1.39.7 |
| Classes: | WrapOldPasswords |
Details
wrapOldPasswords.php file is a maintenance script to wrap all passwords of a certain type in a specified layered type that wraps around the old type.
If necessary, the old MD5 hashing can be restored by changing $wgPasswordDefault to 'B'.
This maintenance script can wrap all passwords in 'pbkdf2-legacyA' or 'pbkdf2-legacyB' if you do not want to wait for your users to log in.
Options/Arguments
| Option | Description | Required? |
|---|---|---|
| --type | Type to convert to. This must be one of the layered types from $wgPasswordConfig, meaning either pbkdf2-legacyA or pbkdf2-legacyB. |
<translate> Required</translate> |
| --verbose | Create verbose output during execution. | <translate> Optional</translate> |
| --update | Actually wrap passwords | <translate> Optional</translate> |
Usage
php maintenance/wrapOldPasswords.php --type PasswordConfigKey [ --verbose| --update ]
Dry run
Terminal
$ php maintenance/wrapOldPasswords.php --type pbkdf2-legacyA 7 user rows found using old password formats. Run script again with --update to update these rows
Updating the password
Terminal
$ php maintenance/wrapOldPasswords.php --type pbkdf2-legacyA --update 7 users rows updated.
