cleaniquecoders/laravel-config-sso

Database-backed SSO provider configuration for Laravel with a Livewire + Flux admin UI.

1.0.2 2026-06-09 03:31 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^12.0||^13.0
• illuminate/database: ^12.0||^13.0
• illuminate/support: ^12.0||^13.0
• laravel/socialite: ^5.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• livewire/flux: ^2.0
• livewire/livewire: ^3.5||^4.0
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^10.0||^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• socialiteproviders/keycloak: ^5.0
• socialiteproviders/microsoft-azure: ^4.0||^5.0
• spatie/laravel-ray: ^1.35

Suggests

• livewire/flux: Flux UI components used by the optional admin screen.
• livewire/livewire: Required for the SSO providers admin screen (UI).
• socialiteproviders/keycloak: Adds the Keycloak (OIDC) Socialite driver.
• socialiteproviders/microsoft-azure: Adds the Azure AD Socialite driver.
• spatie/laravel-permission: Enables automatic role assignment for users created on first SSO login.

MIT

• Nasrul Hazim Bin Mohamad

• laravel
• Cleanique Coders
• laravel-config-sso

README

Manage single sign-on (SSO) identity providers from your database — no .env juggling, no redeploys. Providers (Google, GitHub, GitLab, Bitbucket, Keycloak, Azure AD) are stored with an encrypted client secret, exposed through a Laravel Socialite redirect/callback flow that finds-or-creates and links the local user — plus an optional Livewire + Flux admin screen to manage them.

• 🔐 DB-backed providers, encrypted client_secret and OAuth token_data
• 🧩 Core drivers via laravel/socialite; Keycloak / Azure via optional socialiteproviders/*
• 🖥️ Optional Livewire 4 + Flux admin UI (create / edit / enable / delete)
• 🧱 App-agnostic — configurable user model, table names, and authorization gate
• ✅ Laravel 12 & 13, PHP 8.2+

Quickstart

composer require cleaniquecoders/laravel-config-sso
php artisan config-sso:install   # publishes config + runs migrations

Point the package at your user model and admin gate in config/config-sso.php, then add the login buttons to your login view:

<x-sso />

Add a provider (in the admin screen or by seeding SsoProvider) and it appears on your login page.

Login page (<x-sso />)	Admin UI (Livewire + Flux)

Documentation

Full documentation lives in docs/:

• Getting started — install, configure, add buttons
• Configuration reference — every config key
• API & usage — facade, routes, <x-sso />, admin UI
• Architecture — design, data layer, decoupling rules
• Local development & testing — the workbench app

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Nasrul Hazim Bin Mohamad
• All Contributors

License

The MIT License (MIT). Please see License File for more information.