PHP Класс RESTfulAPI_TokenAuthenticator

Автор: Thierry Francois @colymba [email protected]
Наследование: implements RESTfulAPI_Authenticator
Показать файл Открыть проект

Защищенные свойства (Protected)

Свойство Тип Описание
$tokenConfig array ...

Открытые методы

Метод Описание
__construct ( ) Instanciation + config aquisition
authenticate ( SS_HTTPRequest $request ) : true | RESTfulAPI_Error Checks if a request to the API is authenticated Gets API Token from HTTP Request and return Auth result
getOwner ( SS_HTTPRequest $request ) : null | DataObject Returns the DataObject related to the token that sent the authenticated request
getToken ( integer $id ) : string Return the stored API token for a specific owner
login ( SS_HTTPRequest $request ) : array Login a user into the Framework and generates API token Only works if the token owner is a Member
logout ( SS_HTTPRequest $request ) Logout a user from framework and update token with an expired one if token owner class is a Member
lostPassword ( SS_HTTPRequest $request ) : array Sends password recovery email
resetToken ( integer $id, boolean $expired = false ) Reset an owner's token if $expired is set to true the owner's will have a new invalidated/expired token

Приватные методы

Метод Описание
generateToken ( boolean $expired = false ) : array Generates an encrypted random token and an expiry date
validateAPIToken ( string $token ) : true | RESTfulAPI_Error Validate the API token

Описание методов

__construct() публичный Метод

Instanciation + config aquisition
public __construct ( )

authenticate() публичный Метод

Checks if a request to the API is authenticated Gets API Token from HTTP Request and return Auth result
public authenticate ( SS_HTTPRequest $request ) : true | RESTfulAPI_Error
$request SS_HTTPRequest HTTP API request
Результат true | RESTfulAPI_Error True if token is valid OR RESTfulAPI_Error with details

getOwner() публичный Метод

Returns the DataObject related to the token that sent the authenticated request
public getOwner ( SS_HTTPRequest $request ) : null | DataObject
$request SS_HTTPRequest HTTP API request
Результат null | DataObject null if failed or the DataObject token owner related to the request

getToken() публичный Метод

Return the stored API token for a specific owner
public getToken ( integer $id ) : string
$id integer ID of the token owner
Результат string API token for the owner

login() публичный Метод

Login a user into the Framework and generates API token Only works if the token owner is a Member
public login ( SS_HTTPRequest $request ) : array
$request SS_HTTPRequest HTTP request containing 'email' & 'pwd' vars
Результат array login result with token

logout() публичный Метод

Logout a user from framework and update token with an expired one if token owner class is a Member
public logout ( SS_HTTPRequest $request )
$request SS_HTTPRequest HTTP request containing 'email' var

lostPassword() публичный Метод

Sends password recovery email
public lostPassword ( SS_HTTPRequest $request ) : array
$request SS_HTTPRequest HTTP request containing 'email' vars
Результат array 'email' => false if email fails (Member doesn't exist will not be reported)

resetToken() публичный Метод

Reset an owner's token if $expired is set to true the owner's will have a new invalidated/expired token
public resetToken ( integer $id, boolean $expired = false )
$id integer ID of the token owner
$expired boolean if true the token will be invalidated

Описание свойств

$tokenConfig защищенное свойство

...
protected array $tokenConfig
Результат array