ApiQueryAuthManagerInfo.php

Go to the documentation of this file.

<?php
use MediaWiki\Auth\AuthManager;

class ApiQueryAuthManagerInfo extends ApiQueryBase {

    public function __construct( ApiQuery $query, $moduleName ) {
        parent::__construct( $query, $moduleName, 'ami' );
    }

    public function execute() {
        $params = $this->extractRequestParams();
        $helper = new ApiAuthManagerHelper( $this );

        $manager = AuthManager::singleton();
        $ret = [
            'canauthenticatenow' => $manager->canAuthenticateNow(),
            'cancreateaccounts' => $manager->canCreateAccounts(),
            'canlinkaccounts' => $manager->canLinkAccounts(),
        ];

        if ( $params['securitysensitiveoperation'] !== null ) {
            $ret['securitysensitiveoperationstatus'] = $manager->securitySensitiveOperationStatus(
                $params['securitysensitiveoperation']
            );
        }

        if ( $params['requestsfor'] ) {
            $action = $params['requestsfor'];

            $preservedReq = $helper->getPreservedRequest();
            if ( $preservedReq ) {
                $ret += [
                    'haspreservedstate' => $preservedReq->hasStateForAction( $action ),
                    'hasprimarypreservedstate' => $preservedReq->hasPrimaryStateForAction( $action ),
                    'preservedusername' => (string)$preservedReq->username,
                ];
            } else {
                $ret += [
                    'haspreservedstate' => false,
                    'hasprimarypreservedstate' => false,
                    'preservedusername' => '',
                ];
            }

            $reqs = $manager->getAuthenticationRequests( $action, $this->getUser() );

            // Filter out blacklisted requests, depending on the action
            switch ( $action ) {
                case AuthManager::ACTION_CHANGE:
                    $reqs = ApiAuthManagerHelper::blacklistAuthenticationRequests(
                        $reqs, $this->getConfig()->get( 'ChangeCredentialsBlacklist' )
                    );
                    break;
                case AuthManager::ACTION_REMOVE:
                    $reqs = ApiAuthManagerHelper::blacklistAuthenticationRequests(
                        $reqs, $this->getConfig()->get( 'RemoveCredentialsBlacklist' )
                    );
                    break;
            }

            $ret += $helper->formatRequests( $reqs );
        }

        $this->getResult()->addValue( [ 'query' ], $this->getModuleName(), $ret );
    }

    public function isReadMode() {
        return false;
    }

    public function getAllowedParams() {
        return [
            'securitysensitiveoperation' => null,
            'requestsfor' => [
                ApiBase::PARAM_TYPE => [
                    AuthManager::ACTION_LOGIN,
                    AuthManager::ACTION_LOGIN_CONTINUE,
                    AuthManager::ACTION_CREATE,
                    AuthManager::ACTION_CREATE_CONTINUE,
                    AuthManager::ACTION_LINK,
                    AuthManager::ACTION_LINK_CONTINUE,
                    AuthManager::ACTION_CHANGE,
                    AuthManager::ACTION_REMOVE,
                    AuthManager::ACTION_UNLINK,
                ],
            ],
        ] + ApiAuthManagerHelper::getStandardParams( '', 'mergerequestfields', 'messageformat' );
    }

    protected function getExamplesMessages() {
        return [
            'action=query&meta=authmanagerinfo&amirequestsfor=' . urlencode( AuthManager::ACTION_LOGIN )
                => 'apihelp-query+authmanagerinfo-example-login',
            'action=query&meta=authmanagerinfo&amirequestsfor=' . urlencode( AuthManager::ACTION_LOGIN ) .
                '&amimergerequestfields=1'
                => 'apihelp-query+authmanagerinfo-example-login-merged',
            'action=query&meta=authmanagerinfo&amisecuritysensitiveoperation=foo'
                => 'apihelp-query+authmanagerinfo-example-securitysensitiveoperation',
        ];
    }

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