Registering Teamwork Analytics as an Azure Application

This document describes the process of registering Teamwork Analytics Client as an Azure Application as the first step to deployment. As part of the registration you will gather the following information for use further along the deployment process.

Note: Instead of registering the application via the azure portal, you can execute the application creation powershell script instead.

Register Teamwork Analytics with Azure Active Directory

  1. Sign in to the Azure Portal
  2. Select the Azure Active Directory service from the navigation pane on the left
  3. Select App Registrations and click New Registration (Take care not to select App Registrations (Legacy) as these instructions do not apply to them)
  4. Enter the following application registration details
    • Name - must be Modality Teamwork Analytics (this name is important for the application to work correctly)
    • Supported Account Types - Recommend setting this to Accounts in this Organisational Directory Only
    • Redirect URI - The authorization endpoint used by Teamwork Analytics - Recommend setting this to https://login.live.com/oauth20_desktop.srf
    • (The Redirect URI Type dropdown can be left as the default value of Web)
  5. Click Register and Azure AD will create an Application ID and present the Overview page application registration
  6. Take note of the ApplicationID as this will be required futher in the deployment process overview of application

Add a Client Secret

  1. Navigate to the Azure Active Directory from the navigation pane on the left
  2. Select App Registrations and select the Modality Teamwork Analytics app
  3. Select Certificates & secrets from the Manage menu
  4. Select New client secret and enter an appropriate description and expiry period
    • Description - Recommend setting this to TWA-Secret
    • Expiry - Recommend setting this to Never
  5. Click Add
  6. Immediately take note of the Secret as this can not be retrieved later and will be required further in the deployment process team work secret

Declare API Permissions for Teamwork Analytics

  1. Navigate to the Azure Active Directory from the navigation pane on the left
  2. Select App Registrations and select the Modality Teamwork Analytics app
  3. Select Api permissions from the Manage menu
  4. Find and select Microsoft Graph from the Request API permissions blade add permissions
  5. Ensure that the permission type is set to “Application permissions” and not “Delegated permissions” set permission type
  6. Select the follow 6 permissions from Microsoft.Graph
    • ChannelMessages.Read.All
    • Directory.Read.All
    • Files.Read.All
    • Group.Read.All
    • Reports.Read.All
    • Sites.Read.All
    • User.Read.All
  7. Click Add permissions to be returned to the “API permissions” blade
  8. Click the Grant Admin Consent for Your Name button permissions summary

Retrieve your Tenant ID

  1. Navigate to the Azure Active Directory from the navigation pane on the left
  2. Select Properties
  3. Your Tenant ID is listed as Directory ID, copy this for later use tenant id