README

Used along side a EZ Auth Server to allow SSO across multiple subdomains sharing a TLD using JWTs.

Installation

Use composer to manage your dependencies and download EZ Auth Client:

composer require gooby/ez-auth-client

Setup

We recommend adding these to your .env file, otherwise, you can pass these settings in the Auth constructor.

EZ_AUTH_CLIENT_SECRET="my-shared-secret-here"
EZ_AUTH_CLIENT_SERVER="https://auth.my-ez-auth-server.com"

Quick Start

<?php

$auth = new Gooby\EzAuthClient\Auth();
$user = $auth->getUserOrLogin();

echo "You're logged in and your ID is {$user->id}";

Example

<?php

use Gooby\EzAuthClient\Auth;
use Gooby\EzAuthClient\JwtDecodeException;

$client = new Auth();

try {

    $user = $client->getUser();

} catch (JwtDecodeException $e) {

    // Invalid token, or bad secret
    MyApp::logFailedLoginAttempt('Invalid Token: ' . $e->getMessage());

    // Redirect request to login page
    $client->login();
}

echo "You're logged in and your ID is {$user->id}";