MediaWiki  1.34.0
ApiAuthManagerHelper Class Reference

Helper class for AuthManager-using API modules. More...

Collaboration diagram for ApiAuthManagerHelper:

Public Member Functions

 __construct (ApiBase $module)
 
 formatAuthenticationResponse (AuthenticationResponse $res)
 Format an AuthenticationResponse for return. More...
 
 formatRequests (array $reqs)
 Format an array of AuthenticationRequests for return. More...
 
 getPreservedRequest ()
 Fetch the preserved CreateFromLoginAuthenticationRequest, if any. More...
 
 loadAuthenticationRequests ( $action)
 Fetch and load the AuthenticationRequests for an action. More...
 
 logAuthenticationResult ( $event, $result)
 Logs successful or failed authentication. More...
 
 securitySensitiveOperation ( $operation)
 Call $manager->securitySensitiveOperationStatus() More...
 

Static Public Member Functions

static blacklistAuthenticationRequests (array $reqs, array $blacklist)
 Filter out authentication requests by class name. More...
 
static getStandardParams ( $action,... $wantedParams)
 Fetch the standard parameters this helper recognizes. More...
 
static newForModule (ApiBase $module)
 Static version of the constructor, for chaining. More...
 

Private Member Functions

 formatFields (array $fields)
 Clean up a field array for output. More...
 
 formatMessage (array &$res, $key, Message $message)
 Format a message for output. More...
 

Private Attributes

string $messageFormat
 Message output format. More...
 
ApiBase $module
 API module, for context and parameters. More...
 

Detailed Description

Helper class for AuthManager-using API modules.

Intended for use via composition.

Definition at line 36 of file ApiAuthManagerHelper.php.

Constructor & Destructor Documentation

◆ __construct()

ApiAuthManagerHelper::__construct ( ApiBase  $module)
Parameters
ApiBase$moduleAPI module, for context and parameters

Definition at line 47 of file ApiAuthManagerHelper.php.

References $module, and ApiBase\extractRequestParams().

Member Function Documentation

◆ blacklistAuthenticationRequests()

static ApiAuthManagerHelper::blacklistAuthenticationRequests ( array  $reqs,
array  $blacklist 
)
static

Filter out authentication requests by class name.

Parameters
AuthenticationRequest[]$reqsRequests to filter
string[]$blacklistClass names to remove
Returns
AuthenticationRequest[]

Definition at line 121 of file ApiAuthManagerHelper.php.

Referenced by ApiChangeAuthenticationData\execute(), ApiQueryAuthManagerInfo\execute(), and ApiClientLogin\execute().

◆ formatAuthenticationResponse()

ApiAuthManagerHelper::formatAuthenticationResponse ( AuthenticationResponse  $res)

Format an AuthenticationResponse for return.

Parameters
AuthenticationResponse$res
Returns
array

Definition at line 184 of file ApiAuthManagerHelper.php.

References $res, ApiMessage\create(), formatMessage(), and formatRequests().

◆ formatFields()

ApiAuthManagerHelper::formatFields ( array  $fields)
private

Clean up a field array for output.

Parameters
array$fields-param array{type:string,options:array,value:string,label:Message,help:Message,optional:bool,sensitive:bool,skippable:bool} $fields
Returns
array

Definition at line 315 of file ApiAuthManagerHelper.php.

References $module, formatMessage(), and ApiResult\setArrayType().

Referenced by formatRequests().

◆ formatMessage()

ApiAuthManagerHelper::formatMessage ( array &  $res,
  $key,
Message  $message 
)
private

Format a message for output.

Parameters
array&$resResult array
string$keyResult key
Message$message

Definition at line 69 of file ApiAuthManagerHelper.php.

References $res, and ApiResult\setIndexedTagName().

Referenced by formatAuthenticationResponse(), formatFields(), and formatRequests().

◆ formatRequests()

ApiAuthManagerHelper::formatRequests ( array  $reqs)

Format an array of AuthenticationRequests for return.

Parameters
AuthenticationRequest[]$reqs
Returns
array Will have a 'requests' key, and also 'fields' if $module's params include 'mergerequestfields'.

Definition at line 269 of file ApiAuthManagerHelper.php.

References formatFields(), formatMessage(), and ApiResult\META_TYPE.

Referenced by formatAuthenticationResponse().

◆ getPreservedRequest()

ApiAuthManagerHelper::getPreservedRequest ( )

Fetch the preserved CreateFromLoginAuthenticationRequest, if any.

Returns
CreateFromLoginAuthenticationRequest|null

Definition at line 258 of file ApiAuthManagerHelper.php.

◆ getStandardParams()

static ApiAuthManagerHelper::getStandardParams (   $action,
  $wantedParams 
)
static

◆ loadAuthenticationRequests()

ApiAuthManagerHelper::loadAuthenticationRequests (   $action)

Fetch and load the AuthenticationRequests for an action.

Parameters
string$actionOne of the AuthManager::ACTION_* constants
Returns
AuthenticationRequest[]

Definition at line 136 of file ApiAuthManagerHelper.php.

References true.

◆ logAuthenticationResult()

ApiAuthManagerHelper::logAuthenticationResult (   $event,
  $result 
)

Logs successful or failed authentication.

Parameters
string$eventEvent type (e.g. 'accountcreation')
string | AuthenticationResponse$resultResponse or error message

Definition at line 235 of file ApiAuthManagerHelper.php.

References $module, $status, ApiBase\getModuleName(), StatusValue\newFatal(), and StatusValue\newGood().

◆ newForModule()

static ApiAuthManagerHelper::newForModule ( ApiBase  $module)
static

Static version of the constructor, for chaining.

Parameters
ApiBase$moduleAPI module, for context and parameters
Returns
ApiAuthManagerHelper

Definition at line 59 of file ApiAuthManagerHelper.php.

References $module.

Referenced by ApiRemoveAuthenticationData\execute().

◆ securitySensitiveOperation()

ApiAuthManagerHelper::securitySensitiveOperation (   $operation)

Call $manager->securitySensitiveOperationStatus()

Parameters
string$operationOperation being checked.
Exceptions
ApiUsageException

Definition at line 98 of file ApiAuthManagerHelper.php.

References $status.

Member Data Documentation

◆ $messageFormat

string ApiAuthManagerHelper::$messageFormat
private

Message output format.

Definition at line 42 of file ApiAuthManagerHelper.php.

◆ $module

ApiBase ApiAuthManagerHelper::$module
private

API module, for context and parameters.

Definition at line 39 of file ApiAuthManagerHelper.php.

Referenced by __construct(), formatFields(), logAuthenticationResult(), and newForModule().


The documentation for this class was generated from the following file: