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
Open your Microsoft Azure portal
Click on Enterprise applications
Click on New application
Click on Create your own application
Enter the application name (e.g: Figures SAML), then click on Create
Click on Set up single sign on
Click on SAML
Edit the Basic SAML Configuration section
Add the following Identifier:
https://app.figures.hrAdd the following Reply URL:
https://app.figures.hr/api/auth/saml/callbackClick on Save
Edit the Attributes & Claims section:
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 emailAdd the following Claims:
Name:
firstName- Source Attribute:user.givennameName:
lastName- Source Attribute:user.surname
Under SAML Certificates, download the Certificate (Base64). You will require it soon.
Under Set up, copy the Login URL. You will require it soon.
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
Go to Settings and click SAML SSO in the menu on the left
If you don't have a SAML SSO configuration yet, click Configure SAML SSO
If you do, either click an existing configuration to update it, or click Add new configuration to create a new one
In the Configuration tab, fill in the settings you've copied from Microsoft before:
Supported email domain(s): select the email domains of the users who sign in with Microsoft Entra ID
Entry point corresponds to the Login URL
Issuer: keep
https://app.figures.hr, the Identifier you entered in Microsoft Entra IDCertificate corresponds to the Certificate (Base64) you've downloaded. Open this file in a text editor and copy its content.
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.
Click on Save
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.

