mostafafathi/user-auth

Laravel package for user type management with SSO and OTP authentication

v1.1.13 2025-10-16 10:20 UTC

Requires

• php: ^8.2
• laravel/framework: ^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^7.0
• phpunit/phpunit: ^9.0

MIT

• Mostafa Fathi

• OpenId
• Authentication
• SSO
• laravel
• otp
• saml

README

A comprehensive Laravel package for user type management with SSO and OTP authentication support.

Features

• Multiple user types with permissions
• SSO authentication (SAML, OpenID Connect)
• OTP-based authentication as fallback
• Development-friendly with test email support
• Flexible configuration

Requirements

• PHP 8.2 or higher
• Laravel 11.x or 12.x

Installation

You can install the package via Composer:

composer require mostafafathi/user-auth

Configuration

Publish the configuration file:

php artisan vendor:publish --provider="MostafaFathi\\UserAuth\\UserAuthServiceProvider" --tag=user-auth-config

Publish and run migrations:

php artisan vendor:publish --provider="MostafaFathi\\UserAuth\\UserAuthServiceProvider" --tag=user-auth-migrations
php artisan migrate

Seed user types:

php artisan db:seed --class=UserTypeSeeder

Usage

Environment Variables

Add these to your .env file:

USER_AUTH_METHOD=sso
SSO_ENABLED=true
OTP_ENABLED=true
TEST_EMAIL=[e-mail]

To Overwrite Routes

// SSO Routes
Route::get('/auth/sso/redirect', [SsoAuthController::class, 'redirectToSso'])->name('sso.redirect');
Route::get('/auth/sso/callback', [SsoAuthController::class, 'ssoCallback'])->name('sso.callback');

// OTP Routes
Route::get('/auth/verify', [SsoAuthController::class, 'otpVerifyPage'])->name('otpVerifyPage');
Route::post('/auth/otp/request', [SsoAuthController::class, 'requestOtp'])->name('otp.request');
Route::post('/auth/otp/verify', [SsoAuthController::class, 'verifyOtp'])->name('otp.verify');

SSO Configuration

Configure your SSO providers in the "config/user-auth.php" file.

License

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