Skip to main content

Setup SAML SSO with Microsoft Entra ID (Azure AD)

Connect Microsoft Entra ID (formerly Azure AD) to Figures with SAML: create the enterprise application, set the identifier and reply URL, map user attributes, assign users, then add the certificate in Figures and test SSO.

This guide requires you to be administrator of your Microsoft Entra ID (formerly Azure Active Directory) tenant.

ℹ️ Note: If your company uses app.figures.fr, replace app.figures.hr with app.figures.fr in every URL of this guide.

On Microsoft Entra ID

  1. Click on Enterprise applications

  2. Click on New application

  3. Click on Create your own application

  4. Enter the application name (e.g: Figures SAML), then click on Create

  5. Click on Set up single sign on

  6. Click on SAML

  7. Edit the Basic SAML Configuration section

    1. Add the following Identifier: https://app.figures.hr

    2. Add the following Reply URL: https://app.figures.hr/api/auth/saml/callback

    3. Click on Save

  8. Edit the Attributes & Claims section:

    1. Click the required claim Unique User Identifier (Name ID), set its Source attribute to user.mail, then click Save. Figures reads the user's email address from this Name ID, so each user needs an email address (mail) in Microsoft Entra ID identical to their Figures email

    2. Add the following Claims:

      1. Name: firstName - Source Attribute: user.givenname

      2. Name: lastName - Source Attribute: user.surname

  9. Under SAML Certificates, download the Certificate (Base64). You will require it soon.

  10. Under Set up, copy the Login URL. You will require it soon.

  11. Go to Users and groups and assign relevant people and groups to this application, depending on your needs. In order to test the integration, we recommend that you at least add yourself to start.

On Figures

  1. Go to Settings and click SAML SSO in the menu on the left

  2. If you don't have a SAML SSO configuration yet, click Configure SAML SSO

  3. If you do, either click an existing configuration to update it, or click Add new configuration to create a new one

  4. In the Configuration tab, fill in the settings you've copied from Microsoft before:

    1. Supported email domain(s): select the email domains of the users who sign in with Microsoft Entra ID

    2. Entry point corresponds to the Login URL

    3. Issuer: keep https://app.figures.hr, the Identifier you entered in Microsoft Entra ID

    4. Certificate corresponds to the Certificate (Base64) you've downloaded. Open this file in a text editor and copy its content.

  5. Enforce SAML SSO authentication is checked by default in the Options tab. With a single email domain, SSO is enforced as soon as you save; with several domains, only for the domains you check under it (Enforce for). For a new configuration, uncheck it before saving, test the configuration, then check it again and click Save once the test succeeds and your users have access in your identity provider (see the SAML SSO Configuration Guide). For a configuration already in use, keep it checked while you edit it: unchecking it would let users skip SSO until you check it again.

  6. Click on Save

  7. Click on Test this configuration, at the bottom of the configuration, and sign in with your Microsoft account

If you land on a page saying "Your SSO profile is missing information", you need to map your SAML attributes.

ℹ️ Note: If you check Sign authentication requests in the Options tab, Microsoft Entra ID must first trust the Figures certificate. Microsoft Entra ID does not read it from the Figures metadata file: ask Figures support for the certificate file, add it under SAML Certificates > Verification certificates, then check the option in Figures and click Save. Only then, if you want Microsoft Entra ID to check the signature and refuse unsigned requests, turn on Require verification certificates in Microsoft Entra ID (turning it on before Figures signs blocks sign-in). With this setting on, Microsoft Entra ID disables sign-in started from My Apps or the Microsoft 365 app launcher: users start sign-in from Figures.

Did this answer your question?