All articles on building an Azure Bot Services deployment with SSO
- Azure Bot Services: Advanced deployment with SSO (Microsoft Teams): Intro
- Azure Bot Services: Advanced deployment with SSO (Microsoft Teams): AAD Portal
- Azure Bot Services: Advanced deployment with SSO (Microsoft Teams): Azure Portal
- Azure Bot Services: Advanced deployment with SSO (Microsoft Teams): Apps Developer Portal
- Azure Bot Services: Advanced deployment with SSO (Microsoft Teams): SSO and Graph API Nodes
Create an Azure Bot in the Azure Portal
In this tutorial, you will create a resource group and configure a new Azure bot in the Azure Portal.
Create a Resource Group
If you already have a resource group, you can skip this section.
To create access to a resource group, follow these steps:
- Click the Create a resource card.
- In the Marketplace search, enter resource group.
- In the search results, find the Resource group card. At the bottom of this card, click Create > Resource group.
- On the Create a Resource group page, select your subscription from the list. A trial or usage-based one will work.
- Add a unique name for the group.
- Select a region where all resources will be stored.
- Save changes by clicking Review + create > Create.
Your resource group will be created. You can check it by clicking the bell icon > Go to resource group.
Create an Azure Bot
To create a bot, follow these steps:
- Click the Create a resource card.
- In the Marketplace search, enter Azure Bot or azure bot.
- In the search results, find the Azure bot card. At the bottom of this card, click Create > Azure bot.
- On the Create an Azure bot page, fill in the following fields:
- Bot handle - enter a display name of the Azure bot that you are creating.
- Subscription and Resource group - select the same values that you previously configured in the Resource group section.
- Data residency — select Global.
- Pricing tier — select Free plan by clicking Change plan.
- In the Microsoft App ID section, select Single Tenant or Multi Tenant type of App.
- In the Creation type list, select Use an existing app registration.
- In the App ID field, Enter the Client ID you previously copied and saved.
- the Client Secret you previously copied and saved.
This field is required only for the Single Tenant option. - Save changes by clicking Review + create > Create.
Wait for the deployment, which might take 1-2 minutes, then go to the resource.
Configure the Azure Bot
Go to the Azure Bot that you have just created:
- In the Settings section, select Configuration.
- In the Messaging endpoint field must be the previously copied Endpoint URL from the Cognigy.AI Azure Bot Services Endpoint
- Activate the Enable Streaming Endpoint checkbox.
- Click Add OAuth Connection Settings.
- On the New Connection Setting window, fill in the following fields:
- Name — add a unique name. Copy and save this name for later usage in Cognigy.AI.
- Service provider — select Azure Active Directory v2.
- Client ID — enter the previously copied and saved Client ID.
- Client Secret — enter the previously copied and saved Client Secret.
- Token Exchange URL — enter the Cognigy AI Endpoint URL.
- Tenant ID — enter the “common” word for a Multi-tenant or the tenant ID for a Single tenant.
- Scopes — add permissions your bot should have. Must be in a space-delimited list, for example, email offline_access openid profile User.Read.
- Click Save.
- At the bottom of the Configuration page, click Apply.
Channels Section
Add the Teams channel to your channel list.
- Go to the Azure Bot that you have just configured.
- In the Settings section, select Channels.
- In the Available channels section, select Microsoft Teams.
- Accept Terms of Service by clicking Agree.
- Click Save.
The Teams channel appears in your channel list.
Update the Cognigy Azure Bot Services Endpoint
To update the Cognigy Azure Bot Endpoint:
- Go to the Cognigy.AI interface, then Deploy > Endpoints. Select your previously created Azure Bot Services Endpoint.
- In the Bot Framework Settings section:
- Add the Client ID to the Microsoft App ID.
- Add the Client Secret to the Microsoft App Password.
- Add the Connection Name to the SSO Connection Name.
- Save changes.
Once the Azure Bot has been configured, you can create an App for Teams.
Comments
0 comments