cdvo/filament-utilities

A laravel package for CDVO to manage filament utilities.

1.2.2 2025-10-03 13:53 UTC

README

This package is designed to facilitate the integration of SSO (Single Sign-On) authentication in your Laravel application. It provides a middleware that checks if the user is authenticated via SSO and redirects them to the appropriate login page if not.

Installation

composer require cdvo/filament-utilities

Publish assets

php artisan vendor:publish --tag=cdvo-assets

Render exceptions

Set up the exceptions views in the bootstrap/app.php file

->withExceptions(function (Exceptions $exceptions) {
        $exceptions->render(function (Throwable $e, $request) {
            $status = $e instanceof \Symfony\Component\HttpKernel\Exception\HttpExceptionInterface
                ? $e->getStatusCode()
                : 500;

            if (view()->exists("sso::errors.{$status}")) {
                return response()->view("sso::errors.{$status}", [
                    'exception' => $e,
                ], $status);
            }

            return null; // fallback to default
        });

Set up the SSO middleware

Add the middleware in the bootstrap/app.php file

->withMiddleware(function (Middleware $middleware) {
    $middleware->append(\Cdvo\FilamentUtilities\Middleware\AuthenticateSSO::class);
})

Register the logout response

Register the LogoutResponse in the app/providers/AppServiceProvider.php file

use Cdvo\FilamentUtilities\Responses\LogoutResponse;
use Filament\Http\Responses\Auth\Contracts\LogoutResponse as LogoutResponseContract;

public function register(){
$this->app->bind(LogoutResponseContract::class, LogoutResponse::class);
}

Update the .env file

Add the following lines to your .env file:

APP_URL=
APP_URL_CD=