3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation; either version 2 of the License, or
6 * (at your option) any later version.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 * http://www.gnu.org/copyleft/gpl.html
22 namespace MediaWiki\Auth
;
24 use MediaWiki\MediaWikiServices
;
27 * This represents the intention to set a temporary password for the user.
31 class TemporaryPasswordAuthenticationRequest
extends AuthenticationRequest
{
32 /** @var string|null Temporary password */
35 /** @var bool Email password to the user. */
36 public $mailpassword = false;
39 * @var bool Do not fail certain operations if the password cannot be mailed, there is a
40 * backchannel present.
42 public $hasBackchannel = false;
44 /** @var string Username or IP address of the caller */
47 public function getFieldInfo() {
51 'label' => wfMessage( 'createaccountmail' ),
52 'help' => wfMessage( 'createaccountmail-help' ),
58 * @param string|null $password
60 public function __construct( $password = null ) {
61 $this->password
= $password;
63 $this->mailpassword
= true;
68 * Return an instance with a new, random password
69 * @return TemporaryPasswordAuthenticationRequest
71 public static function newRandom() {
72 $config = MediaWikiServices
::getInstance()->getMainConfig();
74 // get the min password length
75 $minLength = $config->get( 'MinimalPasswordLength' );
76 $policy = $config->get( 'PasswordPolicy' );
77 foreach ( $policy['policies'] as $p ) {
78 if ( isset( $p['MinimalPasswordLength'] ) ) {
79 $minLength = max( $minLength, $p['MinimalPasswordLength'] );
81 if ( isset( $p['MinimalPasswordLengthToLogin'] ) ) {
82 $minLength = max( $minLength, $p['MinimalPasswordLengthToLogin'] );
86 $password = \PasswordFactory
::generateRandomPasswordString( $minLength );
88 return new self( $password );
92 * Return an instance with an invalid password
93 * @return TemporaryPasswordAuthenticationRequest
95 public static function newInvalid() {
96 $request = new self( null );
100 public function describeCredentials() {
102 'provider' => wfMessage( 'authmanager-provider-temporarypassword' ),
103 'account' => new \
RawMessage( '$1', [ $this->username
] ),
104 ] + parent
::describeCredentials();