Microsoft Teams is a collaboration platform by Microsoft that helps people communicate and work together in one place. It combines chat, video and audio meetings, file sharing, and integration with Microsoft 365 apps like Word, Excel, and Outlook.

Permissions for Microsoft Teams Integration

All permissions requested are read-only and used exclusively to collect evidence for audit purposes. Scytale does not perform any actions or changes within your Azure AD account.

Required permissions:

Team.ReadBasic.All
TeamMember.Read.All
User.Read.All

How to Connect Scytale and Microsoft Teams

In Scytale, go to 'Integrations'.
Search for Microsoft Teams and select 'Connect'.
Paste the following details from your Azure application:
• Application ID
• Secret Value
• Directory ID
Add a connection name – this will be used to differentiate between your connections – and then select 'Next'.
Click 'Connect' to complete the setup.

You have now successfully connected to Microsoft Teams!

How To Create Credentials in Microsoft Teams

Note: Global admin role should create the application.

Step 1: Register an application

Log in to the Azure portal and then navigate to Microsoft Teams.
On the left menu, click on App registrations
On the screen that loads, click on New registration and fill in the following details:
- Name - you can choose a name, for example: scytale-integration
- Supported account types - the first option must be selected - "Accounts in this organizational directory only (Default Directory only - Single tenant)".
- Under the Redirect URI - Select web, and paste the following URI:
  - For Scytale's US environment - https://api.scytale.ai/integrations/microsoft_teams/installation/callback
  - For Scytale's EU environment - https://api.eu.scytale.ai/integrations/microsoft_teams/installation/callback
- Click on Register

Next, navigate to the app registrations page.
On the app registrations page, click on scytale-integration (the application you just created in the previous step).
On the left menu, select "overview".
Under "Essentials", copy the (A) - Application (Client) ID and the (B) - Directory (tenant) ID (You'll need this to connect the integration)

Step 2: Create a new client secret for the app

Make sure you are still within the scytale-integration app, created in step 1.
Go to "Certificates & secrets", in the left menu.
Click on New client secret.
- Description - you can choose a description, for example: scytale-key
- Expires - we recommend selecting 730 days (24 months). As we cannot collect data after the key expires.
- Click on Add.
Click on the copy sign on the (C) - "Value" column. (You'll need this to connect the integration)

Step 3: Add permissions

Make sure you are still within the scytale-integration app, created in step 1.
Go to "API permissions"
Click on Add a permission
Under "Request API permissions"
In Microsoft API's tab, select "Microsoft Graph" and then select "application permissions".
Select to add the following permissions (you can search for permissions from the list):
- Team.ReadBasic.All
- TeamMember.Read.All
- User.Read.All
Click on Add permissions
Under API permissions - to grant permission, select "Grant admin consent for Default Directory".