class Handler

The authentication Handler is responsible for handling authentication requirements and providing a Member to the Manager if required, so it can be used in request contexts.

Traits

Provides extensions to this object to integrate it with standard config API methods.

Methods

static Config_ForClass
config()

Get a configuration accessor for this class. Short hand for Config::inst()->get($this->class, .

mixed
stat(string $name) deprecated

Get inherited config value

mixed
uninherited(string $name)

Gets the uninherited value for the given config option

$this
set_stat(string $name, mixed $value) deprecated

Update the config value for a given property

Member|false
requireAuthentication(HTTPRequest $request)

If required, enforce authentication for non-session authenticated requests. The Member returned from the authentication method will returned for use in the OperationResolver context.

getAuthenticator(HTTPRequest $request)

Returns the first configured authenticator by highest priority, or null if none are configured

prioritiseAuthenticators(array $authenticators)

Sort the configured authenticators by their "priority" (highest to lowest). This allows modules to contribute to the decision of which authenticator should be used first. Users can rewrite this in their own configuration if necessary.

Details

in Configurable at line 20
static Config_ForClass config()

Get a configuration accessor for this class. Short hand for Config::inst()->get($this->class, .

....).

Return Value

Config_ForClass

in Configurable at line 32
mixed stat(string $name) deprecated

deprecated 5.0 Use ->config()->get() instead

Get inherited config value

Parameters

string $name

Return Value

mixed

in Configurable at line 44
mixed uninherited(string $name)

Gets the uninherited value for the given config option

Parameters

string $name

Return Value

mixed

in Configurable at line 57
$this set_stat(string $name, mixed $value) deprecated

deprecated 5.0 Use ->config()->set() instead

Update the config value for a given property

Parameters

string $name
mixed $value

Return Value

$this

at line 51
Member|false requireAuthentication(HTTPRequest $request)

If required, enforce authentication for non-session authenticated requests. The Member returned from the authentication method will returned for use in the OperationResolver context.

Authenticators are defined in configuration. see AuthenticatorInterface::authenticate.

Parameters

HTTPRequest $request

Return Value

Member|false If authentication was successful the Member is returned. False if no authenticators are configured.

Exceptions

ValidationException If authentication is attempted and fails

at line 72
null|AuthenticatorInterface getAuthenticator(HTTPRequest $request)

Returns the first configured authenticator by highest priority, or null if none are configured

Parameters

HTTPRequest $request

Return Value

null|AuthenticatorInterface

at line 113
prioritiseAuthenticators(array $authenticators)

Sort the configured authenticators by their "priority" (highest to lowest). This allows modules to contribute to the decision of which authenticator should be used first. Users can rewrite this in their own configuration if necessary.

Parameters

array $authenticators