README

A helper package for ITS SSO authentication in laravel framework

Requirements

1. PHP 7.4 or greater
2. Laravel version 8
3. myits/openid-connect-client

Installation

Install using composer:

composer require dptsi/laravel-sso

Usage

Login

@method static void login(\Dptsi\Sso\Requests\OidcLoginRequest $request)

• Create login request (provided credentials from ITS SSO)

  use Dptsi\Sso\Requests\OidcLoginRequest; $request = new OidcLoginRequest( config('openid.provider'), config('openid.client_id'), config('openid.client_secret'), config('openid.redirect_uri'), config('openid.scope'), config('openid.allowed_roles') );

• Call static login method with OidcLoginRequest parameter

  use Dptsi\Sso\Facade\Sso; Sso::login($request);

Logout

@method static void logout(\Dptsi\Sso\Requests\OidcLogoutRequest $request)

• Create logout request (provided credentials from ITS SSO)

  use Dptsi\Sso\Requests\OidcLogoutRequest; $request = new OidcLogoutRequest( config('openid.provider'), config('openid.client_id'), config('openid.client_secret'), config('openid.post_logout_redirect_uri') );

• Call static logout method with OidcLogoutRequest parameter

  use Dptsi\Sso\Facade\Sso; Sso::logout($request);

Check if the user is authenticated

@method static bool check()

use Dptsi\Sso\Facade\Sso; Sso::check();

Get current authenticated user

@method static \Dptsi\Sso\Models\User|null user()

use Dptsi\Sso\Facade\Sso; Sso::user();

Set current authenticated user

@method static void set(\Dptsi\Sso\Models\User $user)

use Dptsi\Sso\Facade\Sso; use Dptsi\Sso\Models\User; $user = Sso::user(); $user->setActiveRole($role); Sso::set($user);

For change role purpose

Get token of current authenticated user

use Dptsi\Sso\Facade\Sso; Sso::token();

Additional Information

Middleware

Call middleware sso from route or controller to check if user is authenticated or not

Route::middleware(['web', 'sso'])

SSO Helpers

sso()-> same as Sso::, it can be called from controller, route, view, etc.

sso()->check() sso()->user() ...

Claim support

Support any claim from ITS SSO, different claim determine Dptsi\Sso\Models\User model property (whether is null or not), more about User Model