Skip to main content

SSO Integration with Azure Active Directory

These are instructions for setting up Holistics SAML SSO with Azure. If you use a different identity provider and need assistance with configuration, please contact our support team.

Step 1: Add a new Enterprise Application

  1. In Azure Active Directory, select the Enterprise applications option in the left sidebar. Click on add New > Enterprise Application to add a new enterprise application.
  1. Then, click on Create your own application. Enter Holistics in the "Name" field and click on the Add button to add the application.

Step 2: Add Users and Groups

Click on the newly-created Holistics application. Then, select Users and Groups in the left sidebar. Finally, add your users into this application.

Step 3: Configure Single Sign-on with SAML

In the Holistics application overview, click on Single Sign-on on the left sidebar. Select SAML as the sign-on method.

Section 1: Basic SAML Configuration section

  1. Cick edit Edit in the Basic SAML Configuration section (section 1).

Fill in Identifier and Reply URL fields. If you are unsure about these values, depending on your data center, go to your SSO Configuration URL and copy them. Remember to toggle Authenticate with SSO (SAML) to on first.

info
  1. Click Save to save the configuration.

Section 2: Attributes & Claims section

  1. Click Edit on the Attributes & Claims section. You will need to edit every line in the Additional claims section. Click on each line to begin the editing. Remove the namespace section in all the records.
Change emailaddress attribute name to email

By default, there is an attribute name emailaddress in AzureAD. Change this into email to conform to Holistics configurations.

  1. Click Save. After editing, the second section should look like this.

Section 3: SAML Signing Certificate

Download Certificate (Base64) from the section. Copy its content and paste it into the Certificate box of your SSO Configurations in Holistics.

info

Section 4: Set up Holistics

Copy the Login URL in the Azure section and paste it to Identity Provider Single Sign On URL in your SSO Configurations in Holistics.

info

Section 5: Test single sign-on with Holistics

Click on Test in this section to verify that the setup was done correctly. You should be able to login to Holistics.


Let us know what you think about this document :)