caridea / auth
A shrimp of an authentication library
Requires
- php: >=7.1.0
- caridea/event: ^3.0.0
- caridea/session: ^3.0.0
- psr/http-message: ^1.0.0
- psr/log: ^1.0.0
Requires (Dev)
- phpunit/phpunit: ^6.0.0
README
Caridea is a miniscule PHP application library. This shrimpy fellow is what you'd use when you just want some helping hands and not a full-blown framework.
This is its authentication component. It provides a way to authenticate principals and store their identity. It will broadcast authentication events for any listeners. It works with any implementation of PSR-7.
Included are three adapters for authentication through MongoDB, PDO, and X.509 client SSL certificates. You can easily write your own adapter for other authentication sources like IMAP, LDAP, or OAuth2.
Installation
You can install this library using Composer:
$ composer require caridea/auth
- The master branch (version 3.x) of this project requires PHP 7.1 and depends on
caridea/event
,caridea/session
,psr/log
, andpsr/http-message
. - Version 2.x of this project requires PHP 7.0 and depends on
caridea/event
,caridea/session
,psr/log
, andpsr/http-message
. - Version 1.x of this project requires PHP 5.5 and depends on
caridea/event
,caridea/session
,psr/log
, andpsr/http-message
.
Compliance
Releases of this library will conform to Semantic Versioning.
Our code is intended to comply with PSR-1, PSR-2, and PSR-4. If you find any issues related to standards compliance, please send a pull request!
Documentation
- Head over to Read the Docs
Examples
Just a few quick examples.
Login
// Let's say $session is a \Caridea\Session\Session, such as \Caridea\Session\NativeSession // Let's say $publisher is a \Caridea\Event\Publisher, such as \Caridea\Container\Objects $service = new \Caridea\Auth\Service($session, $publisher); // Let's say $collection is a \MongoCollection $adapter = new \Caridea\Auth\Adapter\Mongo($collection, 'username', 'password'); // Let's say $request is a \Psr\Http\Message\RequestInterface if ($service->login($request, $adapter)) { $principal = $service->getPrincipal(); $username = $principal->getUsername(); $details = $principal->getDetails()); // $details = [ // 'id' => '1234567890', // 'ua' => 'Mozilla/5.0', // 'ip' => '192.168.1.1' // ]; }
Upon login, Service
will broadcast a Caridea\Auth\Event\Login
if $publisher
has been set.
Resume
// Let's say $session is a \Caridea\Session\Session, such as \Caridea\Session\NativeSession // Let's say $publisher is a \Caridea\Event\Publisher, such as \Caridea\Container\Objects $service = new \Caridea\Auth\Service($session, $publisher); if ($service->resume()) { $principal = $service->getPrincipal(); }
Upon resume, Service
will broadcast a Caridea\Auth\Event\Resume
if $publisher
has been set.
Logout
// Let's say $session is a \Caridea\Session\Session, such as \Caridea\Session\NativeSession // Let's say $publisher is a \Caridea\Event\Publisher, such as \Caridea\Container\Objects $service = new \Caridea\Auth\Service($session, $publisher); // Let's say $collection is a \MongoCollection $adapter = new \Caridea\Auth\Adapter\Mongo($collection, 'username', 'password'); if ($service->logout()) { // anonymous! }
Upon login, Service
will broadcast a Caridea\Auth\Event\Logout
if $publisher
has been set.
Login Timeout
A component has been included, the TimeoutListener
which can be registered in a Caridea\Event\Publisher
.
It listens for Caridea\Auth\Event\Resume
and will log out a user if an authenticated session has either gone on too long or has been idle for too long.