Using Azure Active Directory 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 authentication and so nothing will change. The users who will benefit from an SSO experience are the managers, report viewers and administrators.


Not using Azure AD? Teamgage also supports Single Sign-On with SAML.


Using your Azure Active Directory with Teamgage can provide a low friction experience with a single sign-on experience for your organisation’s users. We also provide integration with Microsoft Teams which enhances your users' experience in using Teamgage. 

 

Note that for users who only use Teamgage to submit their results and comments, we do not require authentication and so nothing will change. The users who will benefit from an SSO experience are the managers, report viewers, administrators. 

 

Setup instructions 


The process of onboarding your organisation for AAD usage in Teamgage is straightforward. 
For the setup of SSO follow up until step 6, for full AAD integration, continue to the end. 

 

Contact Teamgage and ask us for an onboarding link. The information we require from you is simply the email domain(s) used by your users (e.g. if your company email addresses are of the form john.smith@contoso.com, this would be contoso.com). 

Multiple domains may be provided if desired, the only restriction being that the domain must be unique to your organisation.

 

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

We will send you an email containing a URL similar to the following: 


 

Page Break 

Click on this link. You will be directed to your Azure onboarding page 


 

Review and accept the permissions. It will redirect you to the AAD consent page for these permissions.

Assuming you have sufficient privileges, you should get something similar to the following: 

 


 
 Click Accept, and you will be redirected back to Teamgage. If you are using only SSO, you have completed the setup! If you are using the Microsoft Teams integration you will see this screen: 


 

(Optional) We provide the opportunity to automatically install our application into your Microsoft Teams’ teams. You can either let us automatically install the Microsoft Teams app across your AAD tenant by clicking the button or if you would like to run a script yourself, we have provided Powershell and BASH options. 

If you wish to skip this step you will have to manually install the application from the Teams store for your Microsoft Team’s teams.  


That’s all there is to it. Now when your organisation’s managers log in to Teamgage, they will be asked to enter their email address, but will then be redirected to AzureAD for authentication. If they are already authenticated with Azure, they should automatically be redirected back to Teamgage with their expected access.

 

Within Microsoft Teams, the Teamgage application will now be able to be accessed, and will not require any further authentication when a user opens the application.