---
title: "Microsoft Entra SAML 2.0 SSO Setup"
canonical: "https://help.agiloft.com/space/HELP/43715708/Microsoft+Entra+SAML+2.0+SSO+Setup"
format: markdown
---
This article provides instructions for setting up SAML 2.0 single sign-on (SSO) with Microsoft Entra as the Identity Provider (IdP). It also includes instructions on how to log in with SSO after the integration and make sure other users log in with SSO as well.

> Macro (include)

# Set Up SAML 2.0 SSO

> Macro (include)

## > Macro (anchor)

Create a SAML SSO Profile

> Macro (include)

## > Macro (anchor)

Configure Service Provider Details

> Macro (include)

At this point, you can't finish the setup in Agiloft until you configure your IdP. Continue to [Configure Entra](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43715708/Microsoft+Entra+SAML+2.0+SSO+Setup#MicrosoftEntraSAML2.0SSOSetup-configure_idp) for instructions on setting up your IdP.

## > Macro (anchor)

Configure Entra

Follow the steps below to add the Agiloft Contract Management Suite application to Entra and configure it as a SAML service provider.

> ℹ️ These are general steps for adding the Agiloft application to Entra from the gallery. If the options you see in the admin center or your practices for adding applications differ from those described here, refer to Microsoft's [documentation](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal) on enterprise applications to complete the task.

1. First, to streamline the Entra setup, download the SAML Service Provider Metadata XML file from Agiloft so you can import it to Entra:
  1. In Agiloft, go to **Setup > Access > Configure SAML 2.0 Profiles**.
  2. Select the profile for this IdP, then click Download Metadata XML. The file includes the X.509 certificate.
2. Now, sign in to the [Entra admin center](https://entra.microsoft.com/) as an administrator with permission to configure new applications.
3. If your account has access to multiple tenants, select the tenant in which you want to add the application.
4. Go to **Enterprise applications** and click New application.
5. In the Search field, search and select Agiloft Contract Management Suite.
6. Edit the Name as needed and click Create. The admin center opens the Overview page for the new application.
7. Click the Get started link under Set up single sign on, then select SAML as the single sign-on method.
8. At the top of the setup screen, click Upload metadata file.
9. Browse for and select the SAML SP metadata XML file that you downloaded from Agiloft and click Add. The admin center opens the Basic SAML Configuration screen.
10. Update any of the optional basic SAML configuration settings as needed, then click Save and close the panel.
11. You may get a message asking if you want to test the application. Skip the test for now because it fails until you add users and groups to the application.
12. The SAML attributes that Entra sends by default are shown under Attributes & Claims. If you plan to provision or update user records based on SAML attributes and you want Entra to send additional attributes, configure the app to send additional claims. For instructions, see Microsoft's [documentation](https://learn.microsoft.com/en-us/entra/identity-platform/saml-claims-customization) on customizing SAML token claims. For information on configuring Entra to send group and team attributes for users, see Microsoft's [documentation](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/custom-security-attributes-apps?pivots=portal) on managing custom security attributes.
13. On the setup screen under SAML Certificates, click the link to download Federation Metadata XML. You use the contents of this file to configure the identity provider details in Agiloft.
14. Finally, add to the application the users and groups who need access to log in with SSO:
  1. In the Enterprise application, click Users and groups.
  2. Click Add user/group at the top of the screen.
  3. Add the users and groups who need access to Agiloft through SAML single sign-on.

Now that Entra is configured, return to Agiloft. If you want to configure SAML attribute to Agiloft field mappings, continue to [Configure User Group, Team, and Fields Mapping](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43715708/Microsoft+Entra+SAML+2.0+SSO+Setup#MicrosoftEntraSAML2.0SSOSetup-mapping) below. If you don't want to configure mappings, proceed to [Configure Identity Provider Details](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43715708/Microsoft+Entra+SAML+2.0+SSO+Setup#MicrosoftEntraSAML2.0SSOSetup-identity_provider).

## > Macro (anchor)

Configure User Group, Team, and Fields Mapping

> Macro (include)

### > Macro (anchor)

SAML Attribute Mapping

The table below lists some of the default SAML attributes that Entra sends in the SAML response.

| **Attributes sent by Entra** | **Value** | **Field Mapping in Agiloft** |
| --- | --- | --- |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier | user.userprincipalname [nameid-format:emailAddress] | Mapped in Service Provider Details |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname | user.givenname | First Name |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname | user.surname | Last Name |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress | user.mail | Email Address |

> ℹ️ The nameidentifier attribute is the NameID that is mapped on the [Service Provider Details](#service_provider) tab. The default format in this instance is emailAddress.

To map the attributes to fields in Agiloft, enter the attributes in the relevant field names on the User Field(s) Mapping tab.

![User Field Mappings](media://895526f4-4ccf-452b-b9f0-02bc47c2b168)

Now that user, group, and team mappings are configured, proceed to [Configure Identity Provider Details](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43715708/Microsoft+Entra+SAML+2.0+SSO+Setup#MicrosoftEntraSAML2.0SSOSetup-identity_provider) to complete the SAML SSO setup.

## > Macro (anchor)

Configure Identity Provider Details

> Macro (include)

# > Macro (anchor)

Log in with SAML

> Macro (include)

# > Macro (anchor)

Force SSO Login

> Macro (include)

# > Macro (anchor)

Generating a Key Pair

> Macro (include)

> Macro (hide-if)
> 
> #### Related articles
> 
> > Macro (contentbylabel)