Setting up Single sign-on using Microsoft Entra

This page walks you through setting up Single sign-on using Microsoft Entra.

Viewteam uses OpenID Connect for SSO. To configure, you'll need to enter the following information from Entra on the Viewteam Single sign-on page:

• Client ID
• Client Secret
• OIDC Discovery

Step 1 - Register your app with Entra

1. Login to Entra.

2. Open App registrations. Found on the left hand menu under Applications or by searching.

   

3. Click New registration.
4. Enter a Name for your application.
5. Select who can use the application
6. Add a Redirect URI
   1. Select Web from the dropdown
   2. Enter your Redirect URI which can be found on the Single sign-on page in Viewteam

7. Click Register

   

Once created you'll be redirected to the Overview page.

Step 2 - Gather required information

Now the application has been registered, you can collect the required information.

Client ID

On the application Overview page, find the Application (client) ID in the Essentials Tab. This is the Client ID needed for Viewteam.

Client Secret

To create a client secret:

1. Go to Certificates & secrets.
2. Click New client secret.
3. Enter a description and expiry time, then click Add.
4. Once created, copy the Value field. This is your Client Secret needed for Viewteam.

OIDC Discovery

On the application Overview page, click Endpoints. Find and copy the OpenID Connect metadata document, this is the OIDC Discovery needed for Viewteam.

Step 3 - Configuring Single sign-on in Viewteam

Now you've got all the required information, we can add it to Viewteam.

1. Go to Account settings > Single sign-on in Viewteam
2. Enter the Client ID, Client Secret and OIDC Discovery.
3. Click Save

You'll now be able to login using Microsoft SSO.

Note: Users must be added to Viewteam and have accepted their invitation to use SSO.