Skip to navigation

Microsoft Teams Secret Rotation Guide

View as Markdown

A Non-App Store installation of the Moveworks AI Assistant in Microsoft Teams authenticates to your Microsoft tenant with a client secret on the Azure Bot’s app registration. Client secrets expire, with a maximum lifetime of 2 years. Before the secret expires, generate a new one in Azure and update it in two places in Moveworks Setup: the Microsoft Teams chatbot configuration and the MS Graph connector.

Find the Azure Bot in the Azure portal

  1. Sign in to the Azure portal.

  2. In the portal search bar, search for your bot name or moveworks, and open the Azure Bot resource.

  3. Open Configuration, then select Manage next to Microsoft App ID.

Generate a new client secret

  1. In the left pane, select Certificates & secrets.

  2. Under Client secrets, select New client secret.

  3. Enter a name such as “Moveworks Bot”, set the longest expiration available, and select Add. Copy the secret Value right away, since Azure shows it only once. Record the expiration date so you can rotate the secret again before it expires.

Update the secret in Moveworks Setup

Chatbot configuration

  1. In Moveworks Setup, go to Chat Platforms > Manage Chatbots and open the chatbot configuration whose connector is your MS Teams connector (for example, msteams).

  2. If you have more than one Teams chatbot, open the one whose Microsoft Teams App Id matches the app ID of the Azure Bot.

  3. Enter the new secret in Microsoft Graph client secret, then save the configuration.

MS Graph connector

The MS Graph connector ingests user identity information with the same app ID, so it needs the new secret too.

  1. Go to Core Platform > Connectors > Built-in Connectors.

  2. Select Edit next to the MS Graph connector whose Client ID matches the app ID of the Azure Bot.

  3. Update the Client Secret, then save the connector.

The AI Assistant now authenticates with the new secret. If you run into issues, contact Moveworks Support.