Set up a Microsoft Azure AD integration

TABLE OF CONTENTS

• Introduction
• Contact CSM
• Configure your Azure AD
• Complete the configuration
• Test the configuration
• Confirm success

Introduction

Having a Single Sign-On (SSO) integration using the Azure Active Directory (Azure AD) allows users to access the Collegial application with a single set of credentials.

This guide provides step-by-step instructions on how to configure SSO integration.

Contact CSM

Notify your CSM and Collegial Support that you wish to initiate the SSO process.

During the first meeting you will need to establish:

1. Communication channel - ensure that Collegial has an effective way to communicate with relevant stakeholders. That might be either in a Slack channel, a Teams channel or via email
2. IT Team’s SSO Contact(s)
3. Testing flow - decide on how you are going to test the SSO flow
4. Timeline of the implementation

Your CSM and Collegial support will provide you with the following metadata:

• Redirect URI

Configure your Azure AD

This step involves setting up your Azure AD for SSO authentication.

• First, register your app with Azure AD, see Microsoft's Quickstart: Register an application with the Microsoft identity platform.

  If you have more than one Azure AD directory, make sure you are in the correct directory when you register the app you want to use with Auth0.

  We recommend that you configure external directories as different connections.

• Then, create a client secret, see Microsoft's Quickstart: Configure a client application to access web APIs - Add Credentials to your web application

• Next, add permissions, see Microsoft's Quickstart: Configure a client application to access web APIs - Add permissions to access web APIs.

Please collect and exchange the following metadata:

1. Microsoft Azure AD Domain - Your Azure AD domain name. You can find this on your Azure AD directory's overview page in the Microsoft Azure portal
2. Client ID - Unique identifier for your registered Azure AD application
3. Client Secret - String used to gain access to your registered Azure AD application

Complete the configuration

After receiving metadata, Collegial completes the configuration on the platform. This usually takes up to two days.

Test the configuration

Once configured, perform a test authentication to ensure that the SSO connection is working as expected. Verify that users can authenticate to your application using their IdP credentials.

In case of any questions, Collegial will diligently monitor the newly established SSO connection, offering assistance with monitoring and troubleshooting as needed.

Confirm success

Time to celebrate! Your SSO configuration is ready for use!