Connecting Microsoft Teams

Our Microsoft Teams integration requires a Teams app, which needs to be configured in your own Teams workspace when using Cortex Self-Managed.

Setup instructions

Create the app

Use existing OAuth credentials or create a new Enterprise application in Azure. The following environment variables are referred to later on.

MICROSOFT_TEAMS_CLIENT_ID - the Application ID

MICROSOFT_TEAMS_CLIENT_SECRET - the Client Secret

MICROSOFT_TEAMS_REDIRECT_URI - the Redirect URI, "[Cortex Frontend URL]/oauth/internal/microsoft_teams"
Create a Bot Service in Azure. The following environment variables are referred to later on.

MICROSOFT_TEAMS_BOT_APP_ID - the Microsoft App ID for the bot

MICROSOFT_TEAMS_BOT_APP_PASSWORD - the Bot Password

Create/Upload the Teams App

Use the following manifest to create a new Teams app in your workspace.

Make sure to replace the URLs found in [] with the URLs you set up.

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "manifestVersion": "1.16",
  "version": "1.0.0",
  "id": "[MICROSOFT_TEAMS_BOT_APP_ID]",
  "developer": {
    "name": "Cortex",
    "websiteUrl": "https://www.cortex.io",
    "privacyUrl": "https://www.cortex.io/legal/privacy-policy",
    "termsOfUseUrl": "https://www.cortex.io/legal/terms-of-service",
    "mpnId": "6762083"
  },
  "name": {
    "short": "Cortex",
    "full": "Cortex | Internal Developer Portal"
  },
  "description": {
    "short": "Stay on top of your Cortex Scorecard scores & Initiatives",
    "full": "Cortex Scorecards and Initiatives help your team establish best practices and improve quality. We’ll send you a weekly notification to let you know what’s on your plate for the week as well as notifications for any new Initiatives, upcoming Initiative deadlines, and score changes for services that you own. Book a demo: https://www.cortex.io/demo?utm_source=docs\nContact sales: https://go.cortex.io/contact-sales-request.html\nSupport hub: https://support.getcortexapp.com/hc/en-us\nSupport email: support@cortex.io\nGet started: https://docs.cortex.io"
  },
  "icons": {
    "outline": "cortex32x32.png",
    "color": "cortex192x192.png"
  },
  "accentColor": "#25074D",
  "bots": [
    {
      "botId": "[MICROSOFT_TEAMS_BOT_APP_ID]",
      "scopes": [
        "personal"
      ],
      "needsChannelSelector": false,
      "isNotificationOnly": false,
      "supportsFiles": false,
      "supportsCalling": false,
      "supportsVideo": false,
      "commandLists": []
    }
  ],
  "validDomains": [
    "[Cortex Backend URL]"
  ],
  "showLoadingIndicator": false,
  "isFullScreen": false,
  "defaultBlockUntilAdminAction": false,
  "defaultInstallScope": "personal",
  "configurableProperties": [],
  "webApplicationInfo": {
    "id": "[MICROSOFT_TEAMS_CLIENT_ID]"
  }
}

Download cortex32x32.png

Download cortex192x192.png

Configure the Messaging endpoint - "[Cortex API URL]/api/v1/microsoft/teams/webhook"
Upload a zipped manifest along with the icons to your Teams instance. Note: only Teams admins can do this.

caution

If your Cortex Self-Managed installation is not available from the public internet, the Microsoft Teams notifications will not work, as Microsoft Teams needs to be able to hit the Cortex API when a command is run.

Connect your Cortex instance

You'll need to configure your on-prem deployment to be able to talk your Teams App.

Create a k8s secret and add the secret in your values.yaml file for the Helm chart. You may already have a secret set up if you had configured a persistent store previously, so be sure to verify in your Helm chart.
Add the follow key/values to the secret (keeping in mind they need to be base64 encoded in k8s):
1. MICROSOFT_TEAMS_CLIENT_ID
2. MICROSOFT_TEAMS_CLIENT_SECRET
3. MICROSOFT_TEAMS_REDIRECT_URI
4. MICROSOFT_TEAMS_BOT_APP_ID
5. MICROSOFT_TEAMS_BOT_APP_PASSWORD
Restart your Cortex backend deployment

Setup instructions​

Create the app​

Connect your Cortex instance​

Setup instructions

Create the app

Connect your Cortex instance