This is a value object to hold authentication response data. More...

Collaboration diagram for MediaWiki\Auth\AuthenticationResponse:

Static Public Member Functions
static	newAbstain ()

static	newFail (Message $msg)

static	newPass ($username=null)

static	newRedirect (array $reqs, $redirectTarget, $redirectApiData=null)

static	newRestart (Message $msg)

static	newUI (array $reqs, Message $msg)

Public Attributes
AuthenticationRequest null	$createRequest = null
	Returned with a PrimaryAuthenticationProvider login FAIL or a PASS with no username, this holds a request that should result in a PASS when passed to that provider's PrimaryAuthenticationProvider::beginPrimaryAccountCreation(). More...

AuthenticationRequest null	$linkRequest = null
	Returned with a PrimaryAuthenticationProvider login PASS with no username, this holds a request to pass to AuthManager::changeAuthenticationData() to link the account once the local user has been determined. More...

AuthenticationRequest null	$loginRequest = null
	Returned with an AuthManager account creation PASS, this holds a request to pass to AuthManager::beginAuthentication() to immediately log into the created account. More...

Message null	$message = null
	I18n message to display in case of UI or FAIL. More...

AuthenticationRequest[]	$neededRequests = []
	Needed AuthenticationRequests to continue after a UI or REDIRECT response. More...

mixed	$redirectApiData = null
	Data for a REDIRECT response that a client might use to query the remote site via its API rather than by following $redirectTarget. More...

string null	$redirectTarget = null
	URL to redirect to for a REDIRECT response. More...

string	$status
	One of the constants above. More...

string null	$username = null
	Local user name from authentication. More...

const	ABSTAIN = 'ABSTAIN'
	Indicates that the authentication provider does not handle this request. More...

const	FAIL = 'FAIL'
	Indicates that the authentication failed. More...

const	PASS = 'PASS'
	Indicates that the authentication succeeded. More...

const	REDIRECT = 'REDIRECT'
	Indicates that the authentication needs to be redirected to a third party to proceed. More...

const	RESTART = 'RESTART'
	Indicates that third-party authentication succeeded but no user exists. More...

const	UI = 'UI'
	Indicates that the authentication needs further user input of some sort. More...

Detailed Description

This is a value object to hold authentication response data.

Since: 1.27

Definition at line 33 of file AuthenticationResponse.php.

Member Function Documentation

static MediaWiki\Auth\AuthenticationResponse::newAbstain ( )

static

Returns: AuthenticationResponse

Definition at line 149 of file AuthenticationResponse.php.

References $ret, and MediaWiki\Auth\AuthenticationResponse\ABSTAIN.

static MediaWiki\Auth\AuthenticationResponse::newFail ( Message $msg )

static

Parameters

Message $msg

Returns: AuthenticationResponse

Definition at line 128 of file AuthenticationResponse.php.

References $ret, and MediaWiki\Auth\AuthenticationResponse\FAIL.

static MediaWiki\Auth\AuthenticationResponse::newPass ( $username = null )

static

Parameters

string | null $username Local username

Returns: AuthenticationResponse

Definition at line 117 of file AuthenticationResponse.php.

References $ret, MediaWiki\Auth\AuthenticationResponse\$username, and MediaWiki\Auth\AuthenticationResponse\PASS.

static MediaWiki\Auth\AuthenticationResponse::newRedirect	(	array	$reqs,
			$redirectTarget,
			$redirectApiData = `null`
	)

static

Parameters

	AuthenticationRequest[]	$reqs AuthenticationRequests needed to continue
string	$redirectTarget	URL
mixed	$redirectApiData	Data suitable for adding to an ApiResult

Returns: AuthenticationResponse

Definition at line 178 of file AuthenticationResponse.php.

References MediaWiki\Auth\AuthenticationResponse\$redirectApiData, MediaWiki\Auth\AuthenticationResponse\$redirectTarget, $ret, and MediaWiki\Auth\AuthenticationResponse\REDIRECT.

Referenced by MediaWiki\Auth\AuthManagerTest\provideAccountCreation(), MediaWiki\Auth\AuthManagerTest\provideAccountLink(), and MediaWiki\Auth\AuthManagerTest\provideAuthentication().

static MediaWiki\Auth\AuthenticationResponse::newRestart ( Message $msg )

static

Parameters

Message $msg

Returns: AuthenticationResponse

Definition at line 139 of file AuthenticationResponse.php.

References $ret, and MediaWiki\Auth\AuthenticationResponse\RESTART.

Referenced by MediaWiki\Auth\AuthManager\continueAuthentication(), and MediaWiki\Auth\AuthManagerTest\provideAuthentication().

static MediaWiki\Auth\AuthenticationResponse::newUI	(	array	$reqs,
		Message	$msg
	)

static

Parameters

	AuthenticationRequest[]	$reqs AuthenticationRequests needed to continue
Message	$msg

Returns: AuthenticationResponse

Definition at line 160 of file AuthenticationResponse.php.

References $ret, and MediaWiki\Auth\AuthenticationResponse\UI.

Referenced by MediaWiki\Auth\ConfirmLinkSecondaryAuthenticationProvider\continueLinkAttempt(), MediaWiki\Auth\AuthManagerTest\provideAccountCreation(), MediaWiki\Auth\AuthManagerTest\provideAccountLink(), MediaWiki\Auth\AuthManagerTest\provideAuthentication(), MediaWiki\Auth\AuthManagerTest\testAutoCreateOnLogin(), MediaWiki\Auth\AuthManagerTest\testCreateFromLogin(), and MediaWiki\Auth\ResetPasswordSecondaryAuthenticationProvider\tryReset().

Member Data Documentation

AuthenticationRequest null MediaWiki\Auth\AuthenticationResponse::$createRequest = null

Returned with a PrimaryAuthenticationProvider login FAIL or a PASS with no username, this holds a request that should result in a PASS when passed to that provider's PrimaryAuthenticationProvider::beginPrimaryAccountCreation().

Returned with an AuthManager login FAIL or RESTART, this holds a CreateFromLoginAuthenticationRequest that may be passed to AuthManager::beginCreateAccount(), possibly in place of any "primary-required" requests. It may also be passed to AuthManager::beginAuthentication() to preserve state.

Definition at line 96 of file AuthenticationResponse.php.

AuthenticationRequest null MediaWiki\Auth\AuthenticationResponse::$linkRequest = null

Returned with a PrimaryAuthenticationProvider login PASS with no username, this holds a request to pass to AuthManager::changeAuthenticationData() to link the account once the local user has been determined.

Definition at line 104 of file AuthenticationResponse.php.

AuthenticationRequest null MediaWiki\Auth\AuthenticationResponse::$loginRequest = null

Returned with an AuthManager account creation PASS, this holds a request to pass to AuthManager::beginAuthentication() to immediately log into the created account.

Definition at line 111 of file AuthenticationResponse.php.

Message null MediaWiki\Auth\AuthenticationResponse::$message = null

I18n message to display in case of UI or FAIL.

Definition at line 75 of file AuthenticationResponse.php.

AuthenticationRequest [] MediaWiki\Auth\AuthenticationResponse::$neededRequests = []

Needed AuthenticationRequests to continue after a UI or REDIRECT response.

Definition at line 72 of file AuthenticationResponse.php.

mixed MediaWiki\Auth\AuthenticationResponse::$redirectApiData = null

Data for a REDIRECT response that a client might use to query the remote site via its API rather than by following $redirectTarget.

Value must be something acceptable to ApiResult::addValue().

Definition at line 66 of file AuthenticationResponse.php.

Referenced by MediaWiki\Auth\AuthenticationResponse\newRedirect().