Microsoft Integration – SSO and Teams - Azure AD Setup Guide

Microsoft Integration – SSO and Teams - Azure AD Setup Guide

The Teamgage and Microsoft Teams integration allows your employees to access reports, leave feedback and collaborate without ever leaving Microsoft Teams. With Single Sign-On enabled, the app is seamlessly accessible, without any requirement to login, creating zero friction for users to access their Teamgage account. 


Setup instructions

The process of onboarding your organisation for AAD usage in Teamgage is straightforward.  

Step 1: Request Onboarding Link

Contact to set up Microsoft Teams integration and request an Azure AD onboarding link. Please include the email domain(s) used by your users (e.g. if your company email addresses are of the form, this would be 

Please note, multiple email domains may be provided if desired, as long as they are:

  • unique to your organisation (not
  • all registered as Custom Domains within the one Azure AD Tenant

Please provide a test account on the email domain that Teamgage can use for internal testing. 

Step 2: Provide Consent

You will receive an email containing an onboarding link similar to the following: 


Page Break 

Click on this onboarding link to be directed to your Azure onboarding page (see image below). 


Provide consent for Teamgage to access your data by clicking on the blue 'Review and Accept Permissions' button. Once you have clicked on this button, you will be redirected to the Azure AD consent page where, assuming you have sufficient privileges, you will see the following information:


Once you have clicked 'Accept', your Azure AD set up is completed and you will be redirected back to the Azure AD Onboarding screen. 

Step 3: Install the Teams App

Once you have completed steps 1 and 2, the onboarding screen will display options to install the Teamgage application in Microsoft Teams (see below). 


In order to use the Teams App, it must first be installed into a Microsoft Teams channel. This can be completed in one of two ways. We recommend automatically pre-installing the Teamgage Teams App into all Teams channels in your organisation by using the provided Powershell/BASH script or by following the 'Login to Azure AD link' button. Alternatively, individual users can download the Teamgage app from the App store and install it to any Channel which they are part of. 

Important to note: When you install the Teamgage app into a channel, the application will announce its presence by sending a notification to the channel. As such, we recommend that you install the application on the day of your Teamgage launch. Please ensure you coordinate with your organisation's Teamgage lead or communications team to plan when this will occur.


 further authentication when a user opens the application. 



    • Related Articles

    • Single Sign-On - SAML Setup Guide

      Using SAML authentication to provide a single sign-on experience for your organisation’s users can enhance your users’ experience in using Teamgage. Note that for users who only use Teamgage to submit their results and comments, we do not require ...
    • Single Sign-On - SAML Setup Guide for ADFS

      This guide demonstrates how to configure Active Directory Federation Services (ADFS) as an Identity Provider for Single Sign-On with Teamgage. Not using ADFS? See Single Sign-On - SAML Setup Guide for more general guidance. Before You Begin To ...
    • Teamgage for Microsoft Teams

      Engage your teams with Teamgage for Microsoft Teams Did you know that your team members are able to use Teamgage all within the Microsoft Teams platform! Our new integration allows Teamgage users to receive their regular Teamgage notifications, share ...
    • Set up Microsoft Teams notifications for your organisation

      This article will show you how to configure Teamgage to send notifications via Microsoft Teams, for more information on this feature please visit this article. You must be an administrator of your Teamgage account in order to configure this feature. ...
    • Teamgage on Internet Explorer and Microsoft Edge

      Due to their age and lack of updates, it's no longer possible to provide a secure and modern user experience via Internet Explorer or Microsoft Edge Legacy. For this reason we are now prompting users who login to Teamgage using Internet Explorer or ...