Skip to content

Commit 049af89

Browse files
authored
Improved quality of articles about Bot Powered ACEs and updated TOC (SharePoint#10012)
* Initial commit of articles about Bot Powered ACEs * Updated article about building first Bot Powered ACE * Added metadata to articles * Fixed issues in articles, accordingly to guidance * Fixed issues in articles, accordingly to guidance * Finalized initial batch of articles about Bot Powered ACEs * Finalized initial batch of articles about Bot Powered ACEs * Added article about security for Bot Powered ACEs * Updated articles about Bot Powered ACEs * Updated articles about Bot Powered ACEs * Updated articles about Bot Powered ACEs * Finalized second batch of articles about Bot Powered ACEs * Finalized second batch of articles about Bot Powered ACEs * Finalized second batch of articles about Bot Powered ACEs * Finalized second batch of articles about Bot Powered ACEs * Added article about Look Book PnP templates provisioning * Finalized article about Look Book PnP templates provisioning * Finalized article about look book PnP templates provisioning * Fixed learn.microsoft.com URLs * Fixed learn.microsoft.com URLs * Updated applying-pnp-templates.md to fix an issue * Fixed article applying-pnp-templates.md * Fixed article applying-pnp-templates.md * Updated articles about Bot Powered ACEs in .NET * Updated articles about Bot Powered ACEs security * Fixed article about security * Updated docs about security for Bot Powered ACEs * Finalized articles about Bot Powered ACEs security * Updates articles about Bot Powered ACEs security * Added article about Bot Powered ACEs with TTK+TS * Improved quality of articles about Bot Powered ACEs and updated TOC
1 parent 0f258f9 commit 049af89

File tree

4 files changed

+19
-7
lines changed

4 files changed

+19
-7
lines changed

docs/spfx/viva/bot-powered/AuthN-and-AuthZ-in-Bot-Powered-ACEs-Entra.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Following picture you can see how the Adaptive Card Extension looks like in the
2222
From a developer point of view, you build the ACE once and you benefit of it in both desktop and mobile experiences.
2323
The whole source code of the .NET sample is available in the following GitHub repository: [Welcome User Bot Powered ACE SSO](https://github.com/pnp/viva-dev-bot-powered-aces/tree/main/samples/dotnet/WelcomeUserBotPoweredAce-SSO).
2424

25-
## Developing a Secured Bot Powered ACE with Microsoft .NET
25+
## Developing a Secured Bot Powered ACE with Microsoft .NET and Microsoft Entra ID SSO
2626

2727
First of all, you should create a Bot Powered ACE following the guidance provided in article ["Building your first Bot Powered Adaptive Card Extension,"](./Building-Your-First-Bot-Powered-ACE.md) stopping before the section ["Implement the actual Bot Powered ACE."](./Building-Your-First-Bot-Powered-ACE.md#implement-the-actual-bot-powered-ace)
2828
For the sake of simplicity, assume that the Bot Powered ACE project name is "WelcomeUserBotPoweredAce" and register the Azure Bot accordingly to the guidance.
@@ -506,8 +506,8 @@ To properly support authentication, you need to add a `webApplicationInfo` secti
506506

507507
The `id` property is the actual Client ID of the Microsoft App behind the scenes of your Azure Bot. The `resource` property is the unique URI that you configured for that Microsoft App.
508508

509-
You're now ready to package the solution, deploy it on the SharePoint Online App Catalog, and play with it. You can follow the instructions provided in section ["Run and test the solution"](./Building-Your-First-Bot-Powered-ACE.md#run-and-test-the-solution) of the reference article ["Building your first Bot Powered Adaptive Card Extension."](./Building-Your-First-Bot-Powered-ACE.md)
510-
511509
Now, consider a Bot Powered ACE configured for multitenant and deployed on a target tenant. The first time users run it, they need to grant consent to your Azure Bot application to access Microsoft Graph with delegated permissions. The user's consent is collected through a custom dialog provided by Microsoft Entra ID. In the following picture, you can see the user's consent dialog in action.
512510

513511
![The popup dialog of Microsoft Entra ID to collect the user's consent to access specific resources based on the current Azure Bot application permissions.](./images/Bot-Powered-ACE-Secured-Consent-Multitenant.png)
512+
513+
You're now ready to package the solution, deploy it on the SharePoint Online App Catalog, and play with it. You can follow the instructions provided in section ["Run and test the solution"](./Building-Your-First-Bot-Powered-ACE.md#run-and-test-the-solution) of the reference article ["Building your first Bot Powered Adaptive Card Extension."](./Building-Your-First-Bot-Powered-ACE.md)

docs/spfx/viva/bot-powered/AuthN-and-AuthZ-in-Bot-Powered-ACEs-Magic-Code.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ In both scenarios (desktop and mobile), there are:
3131
From a developer point of view, you build the ACE once and you benefit of it in both desktop and mobile experiences.
3232
The whole source code of the .NET sample is available in the following GitHub repository: [Welcome User Bot Powered ACE](https://github.com/pnp/viva-dev-bot-powered-aces/tree/main/samples/dotnet/WelcomeUserBotPoweredAce).
3333

34-
## Developing a Secured Bot Powered ACE with Microsoft .NET
34+
## Developing a Secured Bot Powered ACE with Microsoft .NET and Magic Code
3535

3636
First of all, you should create a Bot Powered ACE following the guidance provided in article ["Building your first Bot Powered Adaptive Card Extension,"](./Building-Your-First-Bot-Powered-ACE.md) stopping before the section ["Implement the actual Bot Powered ACE."](./Building-Your-First-Bot-Powered-ACE.md#implement-the-actual-bot-powered-ace)
3737
For the sake of simplicity, assume that the Bot Powered ACE project name is "WelcomeUserBotPoweredAce" and register the Azure Bot accordingly to the guidance.
@@ -537,8 +537,8 @@ To properly support authentication, you need to add a `webApplicationInfo` secti
537537

538538
The `id` property is the actual Client ID of the Microsoft App behind the scenes of your Azure Bot. The `resource` property is the unique URI that you configured for that Microsoft App.
539539

540-
You're now ready to package the solution, deploy it on the SharePoint Online App Catalog, and play with it. You can follow the instructions provided in section ["Run and test the solution"](./Building-Your-First-Bot-Powered-ACE.md#run-and-test-the-solution) of the reference article ["Building your first Bot Powered Adaptive Card Extension."](./Building-Your-First-Bot-Powered-ACE.md)
541-
542540
Consider a Bot Powered ACE configured for multitenant and deployed on a target tenant. The first time users run it, they need to grant consent to your Azure Bot application to access Microsoft Graph with delegated permissions. The user's consent is collected through a custom dialog provided by Microsoft Entra ID. In the following picture, you can see the user's consent dialog in action.
543541

544542
![The popup dialog of Microsoft Entra ID to collect the user's consent to access specific resources based on the current Azure Bot application permissions.](./images/Bot-Powered-ACE-Secured-Consent-Multitenant.png)
543+
544+
You're now ready to package the solution, deploy it on the SharePoint Online App Catalog, and play with it. You can follow the instructions provided in section ["Run and test the solution"](./Building-Your-First-Bot-Powered-ACE.md#run-and-test-the-solution) of the reference article ["Building your first Bot Powered Adaptive Card Extension."](./Building-Your-First-Bot-Powered-ACE.md)

docs/spfx/viva/bot-powered/Building-Your-First-Bot-Powered-ACE-TTK-TS.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -528,3 +528,9 @@ Right after that, your Azure Bot is fully configured and ready to be used.
528528
![The panel to configure channels for the Azure Bot. There are now three pre-selected channels: "Direct Line", "Web Chat", and "Microsoft 365.](./images/Azure-Portal-Create-Azure-Bot-12-TTK.png)
529529
530530
You're now ready to run and test your Bot Powered ACE built with Microsoft Teams Toolkit and TypeScript.
531+
532+
## Additional readings
533+
534+
Now that you have built your first Bot Powered ACE with Microsoft Teams Toolkit and TypeScript, you are ready to dig into additional details reading the following articles.
535+
536+
* [Authentication and Authorization in Bot Powered Adaptive Card Extensions](./AuthN-and-AuthZ-in-Bot-Powered-ACEs.md)

docs/toc.yml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -668,10 +668,16 @@
668668
href: spfx/viva/bot-powered/Overview-Bot-Powered-ACEs.md
669669
- name: Understanding Bot Powered Adaptive Card Extensions
670670
href: spfx/viva/bot-powered/Understanding-Bot-Powered-ACEs.md
671-
- name: Building your first Bot Powered Adaptive Card Extension
671+
- name: Building your first Bot Powered ACE with .NET
672672
href: spfx/viva/bot-powered/Building-Your-First-Bot-Powered-ACE.md
673+
- name: Building your first Bot Powered ACE with Microsoft Teams Toolkit and TypeScript
674+
href: spfx/viva/bot-powered/Building-Your-First-Bot-Powered-ACE-TTK-TS.md
673675
- name: Authentication and Authorization in Bot Powered ACEs
674676
href: spfx/viva/bot-powered/AuthN-and-AuthZ-in-Bot-Powered-ACEs.md
677+
- name: Building Bot Powered ACEs with Microsoft Entra ID and Single Sign-on (SSO)
678+
href: spfx/viva/bot-powered/AuthN-and-AuthZ-in-Bot-Powered-ACEs-Entra.md
679+
- name: Building Bot Powered ACEs with Magic Code authentication
680+
href: spfx/viva/bot-powered/AuthN-and-AuthZ-in-Bot-Powered-ACEs-Magic-Code.md
675681
- name: Bringing Bot Powered ACEs to the market place
676682
href: spfx/viva/bot-powered/publish-to-marketplace-overview.md
677683
- name: Tutorials

0 commit comments

Comments
 (0)