README.md

Jasny Auth

Authentication, authorization and access control for Slim Framework and other PHP micro-frameworks.

Features

• Multiple authorization strategies, like groups (for acl) and levels.
• Authorization context (eg. "is the user an admin of this team?").
• PSR-14 events for login and logout.
• PSR-15 middleware for access control.
• Session invalidation, explicit or implicit (eg. after password change).
• Multi-factor authentication support.
• JWT and Bearer authentication support.
• Confirmation tokens for sign up confirmation and forgot-password.
• PSR-3 logging of interesting events.
• Customizable to meet the requirements of your application.

---

Installation

Install using composer

composer require jasny/auth

Usage

Auth is a composition class. It takes an authz, storage, and optionally a confirmation service.

use Jasny\Auth\Auth;
use Jasny\Auth\Authz\Levels;

$levels = new Levels(['user' => 1, 'moderator' => 10, 'admin' => 100]);
$auth = new Auth($levels, new AuthStorage());

session_start();
$auth->initialize();

// Later...
if (!$auth->is('admin')) {
    http_response_code(403);
    echo "Access denied";
    exit();
}

The Auth service isn't usable until it's initialized. This should be done after the session is started.

session_start();
$auth->initialize();

Documentation

• Home
• Setup
  • Roles
  • Storage
  • User
  • Context
• Authentication
• Authorization
• Sessions
  • JWT
  • Bearer
• Middleware (for access control)
• MFA (Multi-factor authentication)
  • TOTP (aka Google authenticator)
• Confirmation
  • Random token
  • Hashids
  • Examples
    • Signup
    • Forgot password
• Logging