With single sign-on (SSO), your employees sign in to SDS Manager with their Microsoft work account. This guide connects SDS Manager to Microsoft Entra ID (formerly Azure Active Directory) with SAML.
Before you start: SSO is an extra subscription. Contact us to get it switched on for your account. Only the owner of the SDS Manager account sees the SSO settings. In Microsoft Entra ID, you need rights to create enterprise applications. Read more: How can I set up SAML authentication?
A. Create the application in Microsoft Entra ID
1. In the Microsoft Azure portal, select Enterprise applications.

2. Create your own application: select Integrate any other application you don't find in the gallery (Non-gallery), enter the name of your application (for example SDS Manager) and click Create.

3. For the single sign-on method, choose SAML.


4. Edit the Basic SAML Configuration and enter:
- Identifier (Entity ID):
https://inventory.sdsmanager.com/saml2_auth/acs/ - Reply URL (Assertion Consumer Service URL):
https://inventory.sdsmanager.com/saml2_auth/acs/

5. Copy two values from Azure: the App Federation Metadata Url (under SAML Certificates) and the Application ID of the application.


B. Set up SSO in SDS Manager
6. In SDS Manager, click More → Settings and open the Single Sign-On (SSO) section. Fill in:
- Federation metadata document: choose Federation metadata URL and paste the App Federation Metadata Url. Or choose XML file and upload the Federation Metadata XML file that you downloaded from Azure.
- Application (client) ID: the Application ID.
- Email attribute mapping: the name of the SAML attribute that holds the user's e-mail address, for example
emailAddress.
Switch on Enable for users and click Save Configuration. SDS Manager then shows the SSO Login URL. Click the copy icon to copy it.

Click Test to try the sign-in in a new window. If SDS Manager finds the e-mail address under another attribute name, it offers to update the mapping for you.
C. Add the login link to Azure
7. Back in Azure, open the Basic SAML Configuration again, paste the SSO Login URL into Sign on URL (Optional) and save. Your users can then open SDS Manager with one click from myapps.microsoft.com. On the SDS Manager login page, they can also click Sign in with Enterprise SSO.

D. New users and roles
Users who already have a user account in your SDS Manager account sign in with SSO right away and keep their role.
To let other employees in, switch on Automatically create new users with role and choose the role: Admin, Admin Light, Staff or No Access. The first time such an employee signs in with SSO, SDS Manager creates a user with that role.
Do you want new users to get their role from Microsoft Entra ID instead? Also switch on Assign role from identity provider, and leave Role attribute name (optional) blank: SDS Manager then reads the role from the standard role claim. If no role matches, the role you chose above is used. The role is only set when the user is created. To change it later, use More → User management.
8. Create the app roles in Azure: go to Microsoft Entra ID → App registrations (not Enterprise applications), select your SDS Manager application, open App roles and click Create app role. Create one role for each SDS Manager role you want to use. The Value is what Azure sends to SDS Manager, and it must be one of these:
- Display name
Admin, ValueAdmin - Display name
Admin Light, ValueAdminLight - Display name
Staff, ValueStaff - Display name
No Access, ValueNoAccess
Upper or lower case does not matter. Other values, for example a read-only role, are not used: those users get the default role.

9. Assign users to the roles: go to Enterprise applications → your SDS Manager application → Users and groups, and assign users or groups to the right app role.
