Configuring Azure AD in 60 Seconds with the SAML2 Setup Wizard

Yesterday we introduced our new SAML2 package. Today, we want to show you the Setup Wizard, the feature that will save you hours of reading XML documentation.

The hardest part of SAML is the "handshake": giving your metadata to the Identity Provider (IDP) and getting theirs back.

Let's configure a connection with Azure Active Directory using the wizard.

Step 1: Access the Wizard

Navigate to /saml2/setup in your app. You will immediately see your Service Provider (SP) details.

• Entity ID: https://your-app.com
• ACS URL: https://your-app.com/saml2/acs

Copy these and paste them into your Azure Enterprise Application configuration.

Step 2: The Magic Import

Instead of asking your IT admin to email you a confusing .xml file, just ask for the Federation Metadata URL.

In the Wizard:

1. Select "From URL".
2. Paste the link (e.g., https://login.microsoftonline.com/.../federationmetadata.xml).
3. Click Fetch.

Boom. 💥

The package automatically parses the XML, extracts the SSO URL, the Entity ID, and most importantly, the X.509 Certificate. No manual copy-pasting errors.

Step 3: Test and Launch

Click "Save and Complete". You will be redirected to a success page with a "Test Login" button.

Click it, log in with your Microsoft account, and watch as you are redirected back to your app, authenticated and ready to go.

What about Attribute Mapping?

Azure sends claims like http://schemas.xmlsoap.org/.../emailaddress. Our package maps these common patterns to simple keys (email, name) out of the box, but you can customize them in the Admin UI later.

This is how Enterprise Auth should feel in 2026.