Beartropy SAML2
Setup Wizard
The Setup Wizard is the easiest way to configure SAML2. It's available only before configuring the first IDP.
Overview
Initial setup consists of:
- Configuring the Service Provider (SP) - Your Laravel application
- Configuring an Identity Provider (IDP) - Azure AD, Okta, ADFS, etc.
- Publishing the login listener - To handle authentication
- Testing the login flow
Access the wizard at
/saml2/setup after installation.
Step 1: Review SP Metadata
The wizard displays your Service Provider's information to share with your IDP administrator:
| Field | Description |
|---|---|
| Entity ID | Unique identifier for your application |
| ACS URL | URL where the IDP sends SAML responses |
| Metadata URL | URL of the SP's metadata XML |
| Metadata XML | Full XML content to copy |
Step 2: Configure IDP
The wizard offers three methods to configure your IDP:
From URL
Enter the IDP's metadata URL and click "Fetch". The wizard automatically parses the XML.
Paste XML
Copy and paste the XML metadata content from your IDP and click "Parse".
Manual Entry
Fill in the IDP Key, Name, Entity ID, SSO URL, and X.509 Certificate manually.
Common Metadata URLs
| Provider | Metadata URL |
|---|---|
| Azure AD | https://login.microsoftonline.com/{tenant-id}/federationmetadata/2007-06/federationmetadata.xml |
| Okta | https://{your-domain}.okta.com/app/{app-id}/sso/saml/metadata |
| ADFS | https://{your-server}/FederationMetadata/2007-06/FederationMetadata.xml |
| https://accounts.google.com/gsiwebsdk/v3/downloadmetadata | |
| Keycloak | https://{server}/realms/{realm}/protocol/saml/descriptor |
Step 3: Save and Complete
Click "Save and Complete Setup". If successful, you'll see a success page with the configured SP/IDP details, login routes, and next steps.
Prefer the command line? See the Artisan Setup guide for CLI-based configuration.
Current version:
0.2.6