Prerequisites
Before you begin, confirm you have the following:- Admin access to the Microsoft Entra admin center
- ACS URL from your Auxia representative
- SP Entity ID from your Auxia representative
Step 1: Create an Enterprise Application
- Log in to the Microsoft Entra admin center.
- In the left sidebar, expand Identity → Applications → Enterprise applications.
- Click New application.
- Click Create your own application.
- Enter a name for the application (e.g.,
Auxia). - Select Integrate any other application you don’t find in the gallery (Non-gallery).
- Click Create.
Step 2: Configure SAML
- From your new application’s overview page, click Single sign-on in the left sidebar.
- Select SAML as the sign-on method.
- In the Basic SAML Configuration section, click Edit.
-
Fill in the following fields:
- Click Save.
Step 3: Verify Attribute Mappings
- In the Attributes & Claims section, click Edit.
-
Confirm the following claim mappings are present:
-
Ensure namespace values end in
/claims. - Click Save if you made any changes.
Step 4: Assign Users and Groups
- In the left sidebar, click Users and groups.
- Click Add user/group.
- Select the users and groups who should have access to Auxia.
- Click Assign.
Note: Only users assigned here will be able to authenticate to Auxia via SSO.
Step 5: Copy the Metadata URL
- Return to the Single sign-on page for your application.
- Scroll to the SAML Signing Certificate section.
- Copy the App Federation Metadata URL.
Step 6: Share the Metadata URL with Auxia
Send the App Federation Metadata URL to your Auxia representative. They will use it to complete the SSO connection on the Auxia side. Once your Auxia representative confirms the connection is active, your users will be able to log in to Auxia Console using their Microsoft credentials.Troubleshooting
Users can’t log in after setup
- Confirm the user is assigned to the Entra ID application (Step 4).
- Verify the ACS URL and SP Entity ID were entered correctly (Step 2).
- Check that the attribute mappings are correct (Step 3).
The metadata URL isn’t working
- Make sure you copied the App Federation Metadata URL, not the Certificate download link.
- If the URL has expired, regenerate the signing certificate and share the new metadata URL with your Auxia representative.