Skip to content

Files

Latest commit

3c13abd · May 30, 2025

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
May 8, 2025
Jun 13, 2024
May 8, 2025
May 8, 2025
May 28, 2025
May 8, 2024
May 30, 2025
Jun 14, 2023
Jun 14, 2023
May 28, 2025
Jan 7, 2025
May 27, 2025
May 8, 2025
May 27, 2025
Jun 14, 2023
Jan 22, 2024

README.md

page_type languages products name urlFragment description extensions
sample
typescript
office-teams
office
Bot App with SSO Enabled
officedev-teamsfx-samples-bot-bot-sso
A Hello World app of Microsoft Teams Bot app with SSO
createdDate
2021-10-19

Getting Started with Bot SSO

A bot, chatbot, or conversational bot is an app that responds to simple commands sent in chat and replies in meaningful ways. Examples of bots in everyday use include: bots that notify about build failures, bots that provide information about the weather or bus schedules, or provide travel information. A bot interaction can be a quick question and answer, or it can be a complex conversation. Being a cloud application, a bot can provide valuable and secure access to cloud services and corporate resources.

This is a sample chatbot application demonstrating Single Sign-on using Microsoft 365 Agents SDK and Teams Framework that can respond to a show message.

Bot SSO Overview

This sample illustrates

  • Use Microsoft 365 Agents Toolkit to create a Teams bot app.
  • Use Microsoft Graph to get User info and picture in Teams app.
  • Implementing SSO for Teams bot.

Prerequisite to use this sample

Note: If you are using node 20, you can add following snippet in package.json to remove the warning of incompatibility. (Related discussion: microsoft/botbuilder-js#4550)

"overrides": {
  "@azure/msal-node": "^2.6.0"
}

Minimal path to awesome

Run the app locally

  • From VS Code:
    1. hit F5 to start debugging. Alternatively open the Run and Debug Activity Panel and select Debug in Teams (Edge) or Debug in Teams (Chrome).
  • From Microsoft 365 Agents Toolkit CLI:
    1. Install dev tunnel cli.
    2. Login with your M365 Account using the command devtunnel user login.
    3. Start your local tunnel service by running the command devtunnel host -p 3978 --protocol http --allow-anonymous.
    4. In the env/.env.local file, fill in the values for BOT_DOMAIN and BOT_ENDPOINT with your dev tunnel URL.
      BOT_DOMAIN=sample-id-3978.devtunnels.ms
      BOT_ENDPOINT=https://sample-id-3978.devtunnels.ms
      
    5. Run command: atk provision --env local .
    6. Run command: atk deploy --env local .
    7. Run command: atk preview --env local .

Deploy the app to Azure

  • From VS Code:
    1. Sign into Azure by clicking the Sign in to Azure under the ACCOUNTS section from sidebar.
    2. Click Provision from LIFECYCLE section or open the command palette and select: Microsoft 365 Agents: Provision.
    3. Click Deploy or open the command palette and select: Microsoft 365 Agents: Deploy.
  • From Microsoft 365 Agents Toolkit CLI:
    1. Run command: atk auth login azure.
    2. Run command: atk provision --env dev.
    3. Run command: atk deploy --env dev.

Preview the app in Teams

  • From VS Code:
    1. Open the Run and Debug Activity Panel. Select Launch Remote (Edge) or Launch Remote (Chrome) from the launch configuration drop-down.
  • From Microsoft 365 Agents Toolkit CLI:
    1. Run command: atk preview --env dev.

Version History

Date Author Comments
Apr 19, 2022 IvanJobs update to support Teams Toolkit v4.0.0
Dec 7, 2022 yukun-dong update to support Teams Toolkit v5.0.0
Feb 22, 2024 yukun-dong update card to adaptive card
May 28, 2025 nliu update sdk

Feedback

We really appreciate your feedback! If you encounter any issue or error, please report issues to us following the Supporting Guide. Meanwhile you can make recording of your journey with our product, they really make the product better. Thank you!