​
Setup Guide

​
Prerequisites

Sign up for a free Microsoft account.

​
Step 1: Register an Application in Azure AD

Go to the Azure Active Directory (AAD) and register a new application.
  1. Go to App registrations.
  2. Click on New registration.
  3. Fill in the required details:
    • Name: Enter a name for your application.
    • Supported account types: Choose the appropriate account type(s).
  4. Click Register.
  5. Note down the Application (client) ID and Directory (tenant) ID.

​
Step 2: Create a Client Secret

  1. In the Azure AD app registration, go to Certificates & secrets.
  2. Click on New client secret.
  3. Fill in the required details:
    • Description: Enter a description for your client secret, such as Client secret for Strata integration
    • Expires: Choose an expiry for the client secret.
  4. Click Add.
  5. Note down the secret Value.

​
Step 3: Register Strata as a Redirect URI

  1. In the app registration, go to Authentication.
  2. If you don’t already have a Web platform set up, create one by clicking Add a platform and select Web.
    • If you already have a Web platform, click Add URI.
  3. Enter https://connect.sandbox.connectstrata.com/oauth/callback for the Redirect URI value.
  4. Save changes by clicking Configure if creating a new platform, or scrolling to the bottom of the page and clicking Save.

​
Step 4: Create an Application Registration in Strata

Go to the Strata Integration Catalog and select Microsoft Teams. Input your application’s client ID (your Application ID) and tenant ID from Step 1, your client secret from Step 2, and the space-separated scopes your application requires, for example https://graph.microsoft.com/Calendars.Read offline_access. Strata requires the offline_access scope to refresh its access token, and will automatically add that scope if you don’t explicitly add it.

​
Integration Authorization

Use the Strata SDK to prompt users to authorize your application. Note users must have appropriate permissions to authorize and manage applications for their Microsoft Teams account.

​
Making Proxy Requests

See Proxy API for the full details on how to make a proxy request to the Microsoft Teams API. Here’s an example: 
curl -X GET "https://proxy.sandbox.connectstrata.com/projects/<project_id>/proxy/microsoft-teams/api/v2.0/me/events?startDateTime=2023-01-01T00:00:00Z&endDateTime=2023-01-31T23:59:59Z" \
  -H "Authorization: Bearer <user_jwt_token>" \
  -H "Content-Type: application/json"