Breadcrumbs

How to: Setting up SAML

Configuring SAML to use for user login can be a slightly challenging task. This page describes all the necessary steps from the client’s side.

Prerequisites

  • The final custom domain must be configured

  • Circularo application needs to be registered in client’s AD

Registering the application in client’s AD

Most client utilize the MS Entra ID (formerly Azure Active Directory):

  1. Sign in to the Azure Portal

    1. Open the Azure Portal and log in with your credentials.

  2. Access MS Entra ID

    1. From the left-hand menu, select Microsoft Entra ID.

Microsoft Entra ID.png
Select Microsoft Entra ID

  1. Create a New Application

    1. Navigate to Enterprise applications.

New application.png
New application

b. Click + New application and select Create your own application.

Create your own application.png
Create your own application

c. Enter a name for the application and proceed to register it as a custom-built app.

  1. Configure the Application

a. Upload the configuration XML file provided by the Circularo team.

Upload metadata file.png
Upload metadata (XML) file

b. Set up Single Sign-On (SSO) with SAML - the Identifier and Reply URL at minimum.

Basic config.png
Set the SAML configuration

  1. Locate the Federation Metadata Document

    1. Go to the Set up Single Sign-On with SAML section.

    2. Find the Federation Metadata XML link.

Federation metadata file.png
Federation Metadata XML link

  1. Download the Metadata File

    1. Click the Federation Metadata XML link to open it in your browser.

    2. Save the file to your device (e.g., right-click and choose Save As).

  2. Send the file to the Circularo team.

Once we receive the file from you, we will finish the set up from our side.

For other AD systems the configuration should be similar but we currently unfortunately don’t have any experience with these.