PHPackages esyede/sso - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Authentication & Authorization](/categories/authentication) 4. / 5. esyede/sso ActiveLibrary[Authentication & Authorization](/categories/authentication) esyede/sso ========== Simple PHP SSO package for Laravel v1.0.2(3y ago)116MITPHPPHP ^8.1 Since May 8Pushed 3y ago1 watchersCompare [ Source](https://github.com/esyede/sso)[ Packagist](https://packagist.org/packages/esyede/sso)[ Docs](https://github.com/esyede/sso)[ RSS](/packages/esyede-sso/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (2)Versions (4)Used By (0) SSO === [](#sso) Simple PHP SINGLE Sign-On package for Laravel ### Requirements [](#requirements) - Laravel 10x - PHP >=8.1 ### Words meanings [](#words-meanings) - ***SSO*** - Single Sign-On. - ***Server*** - page which works as SSO server, handles authentications, stores all sessions data. - ***Broker*** - your page which is used visited by clients/users. - ***Client/User*** - your every visitor. ### How it works? [](#how-it-works) Client visits Broker and unique token is generated. When new token is generated we need to attach Client session to his session in Broker so he will be redirected to Server and back to Broker at this moment new session in Server will be created and associated with Client session in Broker's page. When Client visits other Broker same steps will be done except that when Client will be redirected to Server he already use his old session and same session id which associated with Broker#1. Installation ============ [](#installation) ### Server [](#server) Install this package using composer. ``` composer require esyede/sso ``` Copy config file to Laravel project `config/` folder. ``` php artisan vendor:publish --provider="Esyede\SSO\SSOServiceProvider" ``` Create table where all brokers will be saved. ``` php artisan migrate --path=vendor/esyede/sso/database/migrations ``` Edit `app/Http/Kernel.php` by removing throttle middleware and adding sessions middleware to `api` middlewares array. It's necessary because we need sessions to work in API routes and throttle middleware can block connections that we need. ``` 'api' => [ // .. \Illuminate\Routing\Middleware\SubtituteBindings::class \Illuminate\Session\Middleware\StartSession::class, ], ``` Now you should create brokers. You can create new broker using following Artisan CLI command: ``` $ php artisan sso:broker-create {name} ``` **Note:** Broker names should NOT contains non-alphanumeric characters. --- ### Broker [](#broker) Install this package using composer. ``` $ composer require esyede/sso ``` Copy config file to Laravel project `config/` folder. ``` $ php artisan vendor:publish --provider="Esyede\SSO\SSOServiceProvider" ``` Change `type` value in `config/sso.php` file from `server` to `broker`. If want to use relationship when returning data, set options `SSO_WITH_RELATIONSHIP = true`, and set `relation_name` in `config/` to relationship name in Server's User Model. Set 3 new options in your `.env` file: ``` SSO_SERVER_URL= SSO_BROKER_NAME= SSO_BROKER_SECRET= ``` `SSO_SERVER_URL` is your server's http url without trailing slash. `SSO_BROKER_NAME`and `SSO_BROKER_SECRET` must be data which exists in your server's `brokers` table. Edit your `app/Http/Kernel.php` by adding `\Esyede\SSO\Middleware\SSOAutoLogin::class` middleware to `web` middleware group. It should look like this: ``` protected $middlewareGroups = [ 'web' => [ // ... \Esyede\SSO\Middleware\SSOAutoLogin::class, ], 'api' => [ // ... ], ]; ``` Last but not least, you need to edit `app/Http/Controllers/Auth/LoginController.php`. You should add two functions into `LoginController` class which will authenticate your client through SSO server but not your Broker page. ``` protected function attemptLogin(Request $request) { $credentials = $this->credentials($request); return (new \Esyede\SSO\LaravelSSOBroker)->login($credentials['phone'], $credentials['password']); } public function logout(Request $request) { (new \Esyede\SSO\LaravelSSOBroker)->logout(); $this->guard()->logout(); $request->session()->invalidate(); return redirect('/'); } ``` That's all. For other Broker pages you should repeat everything from the beginning just changing your Broker name and secret in configuration file. Example `.env` options: ``` SSO_SERVER_URL=https://server.test SSO_BROKER_NAME=site1 SSO_BROKER_SECRET=892asjdajsdksja74jh38kljk2929023 ``` ### Multiple mode [](#multiple-mode) you can use the multiple mode by using like this: you must use the newest version to use this feature. - In `server` and `client`'s config file `sso.php` `multi_enabled` option must be true: ``` 'multi_enabled' => env('SSO_MULTI_ENABLED', false), ``` in .env file: ``` SSO_MULTI_ENABLED=true ``` when `multi_enabled` is true you can use the multi mode. - In `LoginController.php` you need rewrite the function `attemptLogin` ``` protected function attemptLogin(Request $request) { $broker = new LaravelSSOBroker(); $credentials = $this->credentials($request); // this is your own field. $loginKey = $request->input('login_key', ''); return $broker->handleLogin($credentials[$this->username()], $credentials['password'], $loginKey); } ``` - your blade/js send the request with params: ``` login_key //your login key username //your login key value password // your login key password ``` or you can change the name of `login_key` to other key name like `login_name` then you need to change the `loginKey`'s name in `attemptLogin` function like this: ``` protected function attemptLogin(Request $request) { $broker = new LaravelSSOBroker(); $credentials = $this->credentials($request); // this is your own field. $loginKey = $request->input('login_name', ''); return $broker->handleLogin($credentials[$this->username()], $credentials['password'], $loginKey); } ``` In `sso` it will send a request like this: ``` $this->userInfo = $this->makeRequest('POST', 'loginMulti', [ $key => $keyValue, 'password' => $password, 'key' => $key ]); ``` And your own key `login_key` 's value will be used for authentication. ### Health Score 25 — LowBetter than 37% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community7 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 3 Last Release 1102d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/10582583?v=4)[Suyadi](/maintainers/esyede)[@esyede](https://github.com/esyede) --- Top Contributors [![esyede](https://avatars.githubusercontent.com/u/10582583?v=4)](https://github.com/esyede "esyede (9 commits)") --- Tags laravelAuthenticationSSOlogin ### Embed Badge ![Health badge](/badges/esyede-sso/health.svg) ``` [![Health](https://phpackages.com/badges/esyede-sso/health.svg)](https://phpackages.com/packages/esyede-sso) ``` ### Alternatives [zefy/laravel-sso Simple PHP SSO integration for Laravel 1013.0k](/packages/zefy-laravel-sso)[maicol07/laravel-oidc-client OpenID Connect Client for Laravel 251.1k](/packages/maicol07-laravel-oidc-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)