82.skills-sso-cloudadapter

SSO with Skills Sample

Bot Framework v4 skills SSO sample.

This bot has been created using Bot Framework, it shows how to create a simple root bot that sends message activities to a skill bot that echoes it back.

Prerequisites

• .NET SDK version 6.0

  # determine dotnet version
  dotnet --version

Key concepts in this sample

The solution includes a parent bot (rootBot) and a skill bot (skillBot) and shows how the skill bot can accept OAuth credentials from the root bot, without needing to send it's own OAuthPrompt.

This is the general authentication flow:

1. Root bot prompts user to authenticate with an OAuth prompt card.
2. Authentication succeeds and the user is granted a token.
3. User performs and action on the skill bot that requires authentication.
4. The skill bot sends an OAuth prompt card to the root bot.
5. The root bot intercepts the OAuth prompt card, aware that the user is already authenticated and that the user should authenticate with the skill via SSO.
6. Instead of showing the OAuth prompt card to the user, the root bot sends a token exchange request invoke activity along with the token to the skill.
7. The skill's OAuth prompt receives the token exchange request and uses the token from the root bot to continue authenticating.

To try this sample

• Clone the repository

  git clone https://github.com/microsoft/botbuilder-samples.git

• Create a bot registration in the azure portal for the SkillBot and update appsettings.json with the MicrosoftAppId and MicrosoftAppPassword of the new bot registration.

• Update the BotFrameworkSkills section in the RootBot appsettings.json with the app ID for the skill you created in the previous step.

• Create a bot registration in the azure portal for the RootBot and update appsettings.json with the MicrosoftAppId and MicrosoftAppPassword of the new bot registration.

• Add the RootBot MicrosoftAppId to the AllowedCallers list in the SkillBot appsettings.json.

• Create and configure an OAuth connection for RootBot:

  1. Create an Azure Active Directory V2 application for the root bot following the steps described in Create the Azure AD identity for RootBot
  2. Open the RootBot registration in the Azure portal, navigate to the Configuration tab and add a new OAuth Connection Settings using the settings of the app you created in the previous step as described in Create an OAuth connection for a root bot
  3. Update the RootBot appsettings.json ConnectionName property with the name of the connection you created in the previous step

• Create and configure an OAuth connection for SkillBot:

  1. Create an Azure Active Directory V2 application for the skill following the steps described in Create the Azure AD identity for SkillBot
  2. Open the SkillBot registration in the Azure portal, navigate to the Configuration tab and add a new OAuth Connection Settings using the settings of the app you created in the previous step as described in Create an OAuth connection for a skill
  3. Update the SkillBot appsettings.json ConnectionName property with the name of the connection you created in the previous step

• Open the SkillsSSOCloudAdapter.sln solution and configure it to start debugging with multiple processes

Note: leave the MicrosoftAppType and MicrosoftAppTenantId empty to try this example, see the Implement a skill article for additional information on what authentication types are supported for skills.

Testing the bot using the Bot Framework Emulator

The Bot Framework Emulator is a desktop application that allows bot developers to test and debug their bots on localhost or running remotely through a tunnel.

• Install the Bot Framework Emulator version 4.14.0 or greater from here

Connect to the bot using Bot Framework Emulator

• Launch Bot Framework Emulator
• File -> Open Bot.
• Enter a Bot URL of http://localhost:3978/api/messages, the MicrosoftAppId and MicrosoftAppPassword for the RootBot.
• Click Connect.
• Follow the prompts to initiate the token exchange between the SkillBot and RootBot, resulting in a valid token displayed.

Deploy the bots to Azure

To learn more about deploying a bot to Azure, see Deploy your bot to Azure for a complete list of deployment instructions.