ApiChangeAuthenticationData.php

Go to the documentation of this file.

<?php
use MediaWiki\Auth\AuthManager;

class ApiChangeAuthenticationData extends ApiBase {

    public function __construct( ApiMain $main, $action ) {
        parent::__construct( $main, $action, 'changeauth' );
    }

    public function execute() {
        if ( !$this->getUser()->isLoggedIn() ) {
            $this->dieUsage( 'Must be logged in to change authentication data', 'notloggedin' );
        }

        $helper = new ApiAuthManagerHelper( $this );
        $manager = AuthManager::singleton();

        // Check security-sensitive operation status
        $helper->securitySensitiveOperation( 'ChangeCredentials' );

        // Fetch the request
        $reqs = ApiAuthManagerHelper::blacklistAuthenticationRequests(
            $helper->loadAuthenticationRequests( AuthManager::ACTION_CHANGE ),
            $this->getConfig()->get( 'ChangeCredentialsBlacklist' )
        );
        if ( count( $reqs ) !== 1 ) {
            $this->dieUsage( 'Failed to create change request', 'badrequest' );
        }
        $req = reset( $reqs );

        // Make the change
        $status = $manager->allowsAuthenticationDataChange( $req, true );
        Hooks::run( 'ChangeAuthenticationDataAudit', [ $req, $status ] );
        if ( !$status->isGood() ) {
            $this->dieStatus( $status );
        }
        $manager->changeAuthenticationData( $req );

        $this->getResult()->addValue( null, 'changeauthenticationdata', [ 'status' => 'success' ] );
    }

    public function isWriteMode() {
        return true;
    }

    public function needsToken() {
        return 'csrf';
    }

    public function getAllowedParams() {
        return ApiAuthManagerHelper::getStandardParams( AuthManager::ACTION_CHANGE,
            'request'
        );
    }

    public function dynamicParameterDocumentation() {
        return [ 'api-help-authmanagerhelper-additional-params', AuthManager::ACTION_CHANGE ];
    }

    protected function getExamplesMessages() {
        return [
            'action=changeauthenticationdata' .
                '&changeauthrequest=MediaWiki%5CAuth%5CPasswordAuthenticationRequest' .
                '&password=ExamplePassword&retype=ExamplePassword&changeauthtoken=123ABC'
                => 'apihelp-changeauthenticationdata-example-password',
        ];
    }

    public function getHelpUrls() {
        return 'https://www.mediawiki.org/wiki/API:Manage_authentication_data';
    }
}