Merge pull request #187627 from ddematheu2/dademath-auth-sample

jborsecnik · web-flow · commit cb662680e332 · 2022-02-22T14:47:20.000-08:00
ACS Auth Sample overview page
diff --git a/articles/communication-services/concepts/authentication.md b/articles/communication-services/concepts/authentication.md
@@ -50,6 +50,8 @@ To set up a service principal, [create a registered application from the Azure C
 
 Communication services support Azure AD authentication but do not support managed identity for Communication services resources. You can find more details, about the managed identity support in the [Azure Active Directory documentation](../../active-directory/managed-identities-azure-resources/services-support-managed-identities.md).
 
+Use our [Trusted authentication service hero sample](../samples/trusted-auth-sample.md) to map Azure Communication Services access tokens with your Azure Active Directory.
+
 ### User Access Tokens
 
 User access tokens are generated using the Identity SDK and are associated with users created in the Identity SDK. See an example of how to [create users and generate tokens](../quickstarts/access-tokens.md). Then, user access tokens are used to authenticate participants added to conversations in the Chat or Calling SDK. For more information, see [add chat to your app](../quickstarts/chat/get-started.md). User access token authentication is different compared to access key and Azure AD authentication in that it is used to authenticate a user rather than a secured Azure resource.
@@ -62,8 +64,15 @@ The user identity is intended to act as a primary key for logs and metrics colle
 
 > [!div class="nextstepaction"]
 > [Create and manage Communication Services resources](../quickstarts/create-communication-resource.md)
+
+> [!div class="nextstepaction"]
 > [Create an Azure Active Directory service principal application from the Azure CLI](../quickstarts/identity/service-principal-from-cli.md)
-> [Create User Access Tokens](../quickstarts/access-tokens.md)
+
+> [!div class="nextstepaction"]
+> [Create user access tokens](../quickstarts/access-tokens.md)
+
+> [!div class="nextstepaction"]
+> [Trusted authentication service hero sample](../samples/trusted-auth-sample.md)
 
 For more information, see the following articles:
-- [Learn about client and server architecture](../concepts/client-and-server-architecture.md)
+- [Learn about client and server architecture](../concepts/client-and-server-architecture.md)
diff --git a/articles/communication-services/concepts/client-and-server-architecture.md b/articles/communication-services/concepts/client-and-server-architecture.md
@@ -33,6 +33,7 @@ Azure Communication Services clients must present `user access tokens` to access
 - **Concept:** [User Identity](identity-model.md)
 - **Quickstart:** [Create and manage access tokens](../quickstarts/access-tokens.md)
 - **Tutorial:** [Build a identity management services use Azure Functions](../tutorials/trusted-service-tutorial.md)
+- **Sample:** [Trusted authentication service hero sample](../samples/trusted-auth-sample.md)
 
 > [!IMPORTANT]
 > For simplicity, we do not show user access management and token distribution in subsequent architecture flows.
diff --git a/articles/communication-services/overview.md b/articles/communication-services/overview.md
@@ -52,6 +52,7 @@ After creating a Communication Services resource you can start building client s
 |**[Join your calling app to a Teams meeting](./quickstarts/voice-video-calling/get-started-teams-interop.md)**|Azure Communication Services can be used to build custom meeting experiences that interact with Microsoft Teams. Users of your Communication Services solution(s) can interact with Teams participants over voice, video, chat, and screen sharing.|
 |**[Get started with chat](./quickstarts/chat/get-started.md)**|The Azure Communication Services Chat SDK is used to add rich real-time text chat into your applications.|
 |**[Connect a Microsoft Bot to a phone number](https://github.com/microsoft/botframework-telephony)**|Telephony channel is a channel in Microsoft Bot Framework that enables the bot to interact with users over the phone. It leverages the power of Microsoft Bot Framework combined with the Azure Communication Services and the Azure Speech Services.  |
+| **[Add visual communication experiences](https://aka.ms/acsstorybook)** | The UI Library for Azure Communication Services enables you to easily add rich, visual communication experiences to your applications for both calling and chat. |
 
 ## Samples
 
@@ -75,6 +76,7 @@ Learn more about the Azure Communication Services SDKs with the resources below.
 |**[Calling SDK overview](./concepts/voice-video-calling/calling-sdk-features.md)**|Review the Communication Services Calling SDK overview.|
 |**[Chat SDK overview](./concepts/chat/sdk-features.md)**|Review the Communication Services Chat SDK overview.|
 |**[SMS SDK overview](./concepts/sms/sdk-features.md)**|Review the Communication Services SMS SDK overview.|
+|**[UI Library overview](https://aka.ms/acsstorybook))**| Review the UI Library for the Communication Services |
 
 ## Other Microsoft Communication Services
 
diff --git a/articles/communication-services/quickstarts/access-tokens.md b/articles/communication-services/quickstarts/access-tokens.md
@@ -86,3 +86,4 @@ You might also want to:
  - [Learn about authentication](../concepts/authentication.md)
  - [Add chat to your app](./chat/get-started.md)
  - [Learn about client and server architecture](../concepts/client-and-server-architecture.md)
+ - [Deploy trusted authentication service hero sample](../samples/trusted-auth-sample.md)
diff --git a/articles/communication-services/quickstarts/chat/get-started.md b/articles/communication-services/quickstarts/chat/get-started.md
@@ -61,6 +61,7 @@ In this quickstart you learned how to:
 
 You may also want to:
 
+ - Get started with the [UI Library](https://aka.ms/acsstorybook)
  - Learn about [chat concepts](../../concepts/chat/concepts.md)
  - Familiarize yourself with [Chat SDK](../../concepts/chat/sdk-features.md)
  - Using [Chat SDK in your React Native](./react-native.md) application.
diff --git a/articles/communication-services/quickstarts/identity/quick-create-identity.md b/articles/communication-services/quickstarts/identity/quick-create-identity.md
@@ -42,3 +42,4 @@ You may also want to:
 
  - [Learn about authentication](../../concepts/authentication.md)
  - [Learn about client and server architecture](../../concepts/client-and-server-architecture.md)
+ - [Deploy trusted authentication service hero sample](../../samples/trusted-auth-sample.md)
diff --git a/articles/communication-services/quickstarts/voice-video-calling/get-started-teams-interop.md b/articles/communication-services/quickstarts/voice-video-calling/get-started-teams-interop.md
@@ -1,7 +1,7 @@
 ---
 title: Quickstart - Teams interop on Azure Communication Services
 titleSuffix: An Azure Communication Services quickstart
-description: In this quickstart, you'll learn how to join an Teams meeting with the Azure Communication Calling SDK.
+description: In this quickstart, you'll learn how to join a Teams meeting with the Azure Communication Calling SDK.
 author: chpalm
 ms.author: chpalm
 ms.date: 06/30/2021
@@ -40,5 +40,6 @@ If you want to clean up and remove a Communication Services subscription, you ca
 For more information, see the following articles:
 
 - Check out our [calling hero sample](../../samples/calling-hero-sample.md)
+- Get started with the [UI Library](https://aka.ms/acsstorybook)
 - Learn about [Calling SDK capabilities](./getting-started-with-calling.md)
 - Learn more about [how calling works](../../concepts/voice-video-calling/about-call-types.md)
diff --git a/articles/communication-services/quickstarts/voice-video-calling/get-started-with-video-calling.md b/articles/communication-services/quickstarts/voice-video-calling/get-started-with-video-calling.md
@@ -36,6 +36,7 @@ If you want to clean up and remove a Communication Services subscription, you ca
 ## Next steps
 For more information, see the following articles:
 
-- Check out our [web calling sample](../../samples/web-calling-sample.md)
+- Check out our [calling hero sample](../../samples/calling-hero-sample.md)
+- Get started with the [UI Library](https://aka.ms/acsstorybook)
 - Learn about [Calling SDK capabilities](./getting-started-with-calling.md?pivots=platform-web)
 - Learn more about [how calling works](../../concepts/voice-video-calling/about-call-types.md)
diff --git a/articles/communication-services/quickstarts/voice-video-calling/getting-started-with-calling.md b/articles/communication-services/quickstarts/voice-video-calling/getting-started-with-calling.md
@@ -43,5 +43,6 @@ If you want to clean up and remove a Communication Services subscription, you ca
 For more information, see the following articles:
 
 - Check out our [calling hero sample](../../samples/calling-hero-sample.md)
+- Get started with the [UI Library](https://aka.ms/acsstorybook)
 - Learn about [Calling SDK capabilities]()
 - Learn more about [how calling works](../../concepts/voice-video-calling/about-call-types.md)
diff --git a/articles/communication-services/samples/calling-hero-sample.md b/articles/communication-services/samples/calling-hero-sample.md
@@ -1,9 +1,9 @@
 ---
-title: Group calling hero sample
+title: Calling hero sample
 titleSuffix: An Azure Communication Services sample overview
 description: Overview of calling hero sample using Azure Communication Services to enable developers to learn more about the inner workings of the sample.
 author: ddematheu2
-manager: nimag
+manager: chpalm
 services: azure-communication-services
 
 ms.author: dademath
@@ -14,7 +14,7 @@ ms.subservice: calling
 zone_pivot_groups: acs-web-ios-android
 ---
 
-# Get started with the group calling hero sample
+# Get started with the calling hero sample
 
 ::: zone pivot="platform-web"
 [!INCLUDE [Web Calling Hero Sample](./includes/web-calling-hero.md)]
diff --git a/articles/communication-services/samples/chat-hero-sample.md b/articles/communication-services/samples/chat-hero-sample.md
@@ -1,9 +1,9 @@
 ---
-title: Group Chat Hero Sample
+title: Chat Hero Sample
 titleSuffix: An Azure Communication Services sample overview
 description: Overview of chat hero sample using Azure Communication Services to enable developers to learn more about the inner workings of the sample and learn how to modify it.
 author: ddematheu2
-manager: nimag
+manager: chpalm
 services: azure-communication-services
 
 ms.author: dademath
@@ -13,7 +13,7 @@ ms.service: azure-communication-services
 ms.subservice: chat
 ---
 
-# Get started with the group chat hero sample
+# Get started with the chat hero sample
 
 > [!IMPORTANT]
 > [This sample is available **on GitHub**.](https://github.com/Azure-Samples/communication-services-web-chat-hero)
@@ -36,9 +36,9 @@ When you press the "Start a Chat" button, the web application fetches a user acc
 
 :::image type="content" source="./media/chat/pre-chat.png" alt-text="Screenshot showing the application's pre-chat screen.":::
 
-Once your configure your display name and emoji, you can join the chat session. Now you will see the main chat canvas where the core chat experience lives.
+Once you configure your display name and emoji, you can join the chat session. Now you will see the main chat canvas where the core chat experience lives.
 
-:::image type="content" source="./media/chat/main-app.png" alt-text="Screenshot showing showing the main screen of the sample application.":::
+:::image type="content" source="./media/chat/main-app.png" alt-text="Screenshot showing the main screen of the sample application.":::
 
 Components of the main chat screen:
 
@@ -102,7 +102,7 @@ For more information, see the following articles:
 
 - Learn about [chat concepts](../concepts/chat/concepts.md)
 - Familiarize yourself with our [Chat SDK](../concepts/chat/sdk-features.md)
-- Review the [Contoso Med App](https://github.com/Azure-Samples/communication-services-contoso-med-app) sample
+- Check out the chat components in the [UI Library](https://azure.github.io/communication-ui-library/)
 
 ## Additional reading
 
diff --git a/articles/communication-services/samples/includes/csharp-auth-hero.md b/articles/communication-services/samples/includes/csharp-auth-hero.md
@@ -0,0 +1,44 @@
+---
+title: include file
+description: include file
+services: azure-communication-services
+author: ddematheu2
+manager: chpalm
+ms.service: azure-communication-services
+ms.subservice: azure-communication-services
+ms.date: 02/15/2022
+ms.topic: include
+ms.custom: include file
+ms.author: dademath
+---
+
+## Getting started
+
+If you're wondering where to get started, here are a few scenarios to help you get going:
+
+* "I want to see what this Azure Communication Services Authentication Server sample can do by running it!"
+  * Check out our [local deployment guide](https://github.com/Azure-Samples/communication-services-authentication-hero-csharp/blob/main/docs/deployment-guides/deploy-locally.md) guide.
+
+* "How does the Azure Communication Services Authentication server sample work?"
+  * Take a look at our conceptual design documentation. This documentation outlines the internal design of the service.
+    - [Azure Communication Services Authentication Server Sample Architecture Design](https://github.com/Azure-Samples/communication-services-authentication-hero-csharp/blob/main/docs/design-guides/architecture-overview.md).
+    - [Secured Web API Architecture Design](https://github.com/Azure-Samples/communication-services-authentication-hero-csharp/blob/main/docs/design-guides/secured-web-api-design.md).
+    - [Identity Mapping Architecture Design](https://github.com/Azure-Samples/communication-services-authentication-hero-csharp/blob/main/docs/design-guides/identity-mapping-design-graph-open-extensions.md).
+    - [Token Exchange Architecture Design](https://github.com/Azure-Samples/communication-services-authentication-hero-csharp/blob/main/docs/design-guides/token-exchange-design.md)
+
+## Endpoints
+
+This Azure Communication Services Solutions - Authentication server sample provides responses for **user** and **token** endpoints. For more details, please check our [Endpoints and Responses design doc](https://github.com/Azure-Samples/communication-services-authentication-hero-csharp/blob/main/docs/design-guides/endpoints-and-responses.md).
+
+## Next steps
+
+>[!div class="nextstepaction"]
+>[Download the sample from GitHub](https://github.com/Azure-Samples/communication-services-authentication-hero-csharp)
+
+## Additional reading
+
+- [Azure Communication Services Documentation](https://docs.microsoft.com/azure/communication-services/) - Find more about how to add voice, video, chat, and telephony on our official documentation.
+- [Azure Communication Services Hero Samples](https://docs.microsoft.com/azure/communication-services/samples/overview) - Find more Azure Communication Services samples and examples on our samples overview page.
+- [On-Behalf-Of workflow](https://docs.microsoft.com/azure/active-directory/develop/v2-oauth2-on-behalf-of-flow) - Find more about the OBO workflow.
+- [Creating a protected API](https://github.com/Azure-Samples/active-directory-dotnet-native-aspnetcore-v2/tree/master/2.%20Web%20API%20now%20calls%20Microsoft%20Graph) - Detailed example of creating a protected API.
+- [Graph Open Extensions](https://docs.microsoft.com/graph/extensibility-open-users) - Find out more about Microsoft Graph open extensions.
diff --git a/articles/communication-services/samples/includes/node-auth-hero.md b/articles/communication-services/samples/includes/node-auth-hero.md
@@ -0,0 +1,46 @@
+---
+title: include file
+description: include file
+services: azure-communication-services
+author: ddematheu2
+manager: chpalm
+ms.service: azure-communication-services
+ms.subservice: azure-communication-services
+ms.date: 02/15/2022
+ms.topic: include
+ms.custom: include file
+ms.author: dademath
+---
+
+## Getting started
+
+If you're wondering where to get started, here are a few scenarios to help you get going:
+
+* "I want to see what this Azure Communication Services Authentication Server sample can do by running it!"
+  * Check out our [local deployment guide](https://github.com/Azure-Samples/communication-services-authentication-hero-nodejs/blob/main/docs/deployment-guides/deploy-locally.md) guide.
+
+* "How does the Azure Communication Services Authentication server sample work?"
+  * Take a look at our conceptual design documentation. This documentation outlines the internal design of the service.
+    - [Architecture Overview](https://github.com/Azure-Samples/communication-services-authentication-hero-nodejs/blob/main/docs/design-guides/architecture-overview.md)
+    - [Secured Web API Architecture Design](https://github.com/Azure-Samples/communication-services-authentication-hero-nodejs/blob/main/docs/design-guides/secured-web-api-design.md).
+    - [Identity Mapping Architecture Design](https://github.com/Azure-Samples/communication-services-authentication-hero-nodejs/blob/main/docs/design-guides/identity-mapping-design-graph-open-extensions.md).
+    - [Token Exchange Architecture Design](https://github.com/Azure-Samples/communication-services-authentication-hero-nodejs/blob/main/docs/design-guides/token-exchange-design.md)
+
+
+## Endpoints
+
+This Azure Communication Services Solutions - Authentication server sample provides responses for **user** and **token** endpoints. For more details, please check our [Endpoints and Responses design doc](https://github.com/Azure-Samples/communication-services-authentication-hero-nodejs/blob/main/docs/design-guides/endpoints-and-responses.md).
+
+## Next steps
+
+>[!div class="nextstepaction"]
+>[Download the sample from GitHub](https://github.com/Azure-Samples/communication-services-authentication-hero-nodejs)
+
+
+## Additional reading
+
+- [Azure Communication Services Documentation](https://docs.microsoft.com/azure/communication-services/) - Find more about how to add voice, video, chat, and telephony on our official documentation.
+- [Azure Communication Services Hero Samples](https://docs.microsoft.com/azure/communication-services/samples/overview) - Find more Azure Communication Services samples and examples on our samples overview page.
+- [On-Behalf-Of workflow](https://docs.microsoft.com/azure/active-directory/develop/v2-oauth2-on-behalf-of-flow) - Find more about the OBO workflow.
+- [Creating a protected API](https://github.com/Azure-Samples/active-directory-dotnet-native-aspnetcore-v2/tree/master/2.%20Web%20API%20now%20calls%20Microsoft%20Graph) - Detailed example of creating a protected API.
+- [Graph Open Extensions](https://docs.microsoft.com/graph/extensibility-open-users) - Find out more about Microsoft Graph open extensions.
diff --git a/articles/communication-services/samples/media/auth/acs-authentication-server-sample-overview-flow.png b/articles/communication-services/samples/media/auth/acs-authentication-server-sample-overview-flow.png
diff --git a/articles/communication-services/samples/overview.md b/articles/communication-services/samples/overview.md
@@ -19,12 +19,10 @@ Azure Communication Services has many samples available, which you can use to te
 
 | Sample Name                                                                                          | Description                                                         | Languages/Platforms Available      |
 | :--------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------ | :--------------------------------- |
-| [Group Calling Hero Sample](./calling-hero-sample.md)                                                | Provides a sample of creating a group calling application.          | [Web](https://github.com/Azure-Samples/communication-services-web-calling-hero), [iOS](https://github.com/Azure-Samples/communication-services-ios-calling-hero), [Android](https://github.com/Azure-Samples/communication-services-android-calling-hero)                           |
+| [Calling Hero Sample](./calling-hero-sample.md)                                                | Provides a sample of creating a calling application.          | [Web](https://github.com/Azure-Samples/communication-services-web-calling-hero), [iOS](https://github.com/Azure-Samples/communication-services-ios-calling-hero), [Android](https://github.com/Azure-Samples/communication-services-android-calling-hero)                           |
+| [Chat Hero Sample](./chat-hero-sample.md) | Provides a sample of creating a chat application. | [Web](https://github.com/Azure-Samples/communication-services-web-chat-hero)                    |                  |
+| [Trusted Authentication Server Sample](./trusted-auth-sample.md) | Provides a sample implementation of a trusted authentication service used to generate user and access tokens for Azure Communication Services. The service by default maps generated identities to Azure Active Directory | [node.JS](https://github.com/Azure-Samples/communication-services-authentication-hero-nodejs), [C#](https://github.com/Azure-Samples/communication-services-authentication-hero-csharp)
 | [Web Calling Sample](./web-calling-sample.md)                                                        | A step by step walk-through of ACS Calling features, including PSTN, within the Web. | [Web](https://github.com/Azure-Samples/communication-services-web-calling-tutorial/)                                |
-| [Chat Hero Sample](./chat-hero-sample.md)                                                            | Provides a sample of creating a chat application.                   | [Web](https://github.com/Azure-Samples/communication-services-web-chat-hero)                    |
-| [Contoso Medical App](https://github.com/Azure-Samples/communication-services-contoso-med-app)       | Sample app demonstrating a patient-doctor flow.                     | Web & Node.js                      |
-| [Contoso Retail App](https://github.com/Azure-Samples/communication-services-contoso-retail-app)     | Sample app demonstrating a retail support flow.                     | ASP.NET, .NET Core, JavaScript/Web |
-| [WPF Calling Sample](https://github.com/Azure-Samples/communication-services-web-calling-wpf-sample) | Sample app for Windows demonstrating calling functionality          | WPF / Node.js                      |
 | [Network Traversal Sample]( https://github.com/Azure-Samples/communication-services-network-traversal-hero) | Sample app demonstrating network traversal functionality          | Node.js 
 
 ## Quickstart samples
diff --git a/articles/communication-services/samples/trusted-auth-sample.md b/articles/communication-services/samples/trusted-auth-sample.md
diff --git a/articles/communication-services/toc.yml b/articles/communication-services/toc.yml

Original file line number	Diff line number	Diff line change
`@@ -42,3 +42,4 @@ You may also want to:`
`42`	`42`
`43`	`43`	`- [Learn about authentication](../../concepts/authentication.md)`
`44`	`44`	`- [Learn about client and server architecture](../../concepts/client-and-server-architecture.md)`
	`45`	`+ - [Deploy trusted authentication service hero sample](../../samples/trusted-auth-sample.md)`