SAML2 Doesn't Have to Be a Nightmare: Introducing beartropy/saml2

If you have ever been asked to integrate "Enterprise SSO" (Azure AD, Okta, ADFS) into your Laravel application, you probably felt a chill down your spine.

SAML XML metadata, certificates, assertions, claim mapping... it is usually a week of frustration.

Today, we are changing that. We are thrilled to announce beartropy/saml2, a package designed to make SAML integrations painless, visual, and native to the TALL stack.

🚀 Why another SAML package?

Existing solutions are powerful but often require deep configuration via array files or lack a user interface. We wanted an experience that felt like "magic".

Key Features:

• 🧙‍♂️ Setup Wizard: A visual step-by-step guide to configure your first connection. No copy-pasting XML into code.
• 🖥️ Admin UI: A complete dashboard to manage Identity Providers (IDPs), toggle them, and debug settings.
• 🔄 Auto-Metadata Fetching: Just paste the Azure/Okta URL, and we pull the certificates and endpoints automatically.
• ⚡ Multi-Tenant Ready: Configure as many IDPs as you need (e.g., one for Employees, one for Partners).

📦 Installation

It is as simple as:

1composer require beartropy/saml2
2php artisan vendor:publish --tag=beartropy-saml2-config
3php artisan migrate

Once installed, you get a dedicated route /saml2/setup to kickstart your integration.

🎧 The Login Listener

We also handle the "after login" logic for you. Run php artisan saml2:publish-listener and you get a clean event handler to create or update your local users:

1public function handle(Saml2LoginEvent $event): void
2{
3    $user = User::firstOrCreate(
4        ['email' => $event->getEmail()],
5        ['name' => $event->getName()]
6    );
7 
8    Auth::login($user);
9}

Stop fearing the "Enterprise SSO" requirement. Embrace it with Beartropy SAML2.