Skip to content

Commit e4c7718

Browse files
authored
Merge pull request #204565 from MicrosoftDocs/main
7/13 OOB Publish at 8AM
2 parents 4ddee71 + b3c9e19 commit e4c7718

File tree

106 files changed

+3095
-544
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

106 files changed

+3095
-544
lines changed

articles/azure-monitor/alerts/alerts-types.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ You may also decide not to split when you want a condition applied to multiple r
7070

7171
You can monitor at scale by applying the same metric alert rule to multiple resources of the same type for resources that exist in the same Azure region. Individual notifications are sent for each monitored resource.
7272

73-
These platform metrics for these services in the following Azure clouds are supported:
73+
The platform metrics for these services in the following Azure clouds are supported:
7474

7575
| Service | Global Azure | Government | China |
7676
|:-----------------------------|:-------------|:-----------|:--------|
@@ -85,7 +85,9 @@ These platform metrics for these services in the following Azure clouds are supp
8585
| Recovery Services vaults | Yes | No | No |
8686

8787
> [!NOTE]
88-
> Platform metrics are not supported for virtual machine network metrics (Network In Total, Network Out Total, Inbound Flows, Outbound Flows, Inbound Flows Maximum Creation Rate, Outbound Flows Maximum Creation Rate).
88+
> Multi-resource metric alerts are not supported for the following scenarios:
89+
> - Alerting on virtual machines' guest metrics
90+
> - Alerting on virtual machines' network metrics (Network In Total, Network Out Total, Inbound Flows, Outbound Flows, Inbound Flows Maximum Creation Rate, Outbound Flows Maximum Creation Rate).
8991
9092
You can specify the scope of monitoring with a single metric alert rule in one of three ways. For example, with virtual machines you can specify the scope as:
9193

articles/communication-services/concepts/interop/custom-teams-endpoint-use-cases.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Use cases for custom Teams endpoint
2+
title: Use cases for Azure Communication Services support Teams identities
33
titleSuffix: An Azure Communication Services concept document
4-
description: This article describes use cases for a custom Teams endpoint.
4+
description: This article describes use cases for Azure Communication Services support Teams identities.
55
author: tomaschladek
66
manager: nmurav
77
services: azure-communication-services
@@ -13,7 +13,7 @@ ms.service: azure-communication-services
1313
ms.subservice: teams-interop
1414
---
1515

16-
# Custom Teams Endpoint — Use cases
16+
# Azure Communication Services support Teams identities — Use cases
1717

1818
Microsoft Teams provides identities managed by Azure Active Directory and calling experiences controlled by Teams Admin Center and policies. Users might have assigned licenses to enable PSTN connectivity and advanced calling capabilities of Teams Phone System. Azure Communication Services are supporting Teams identities for managing Teams VoIP calls, Teams PSTN calls, and join Teams meetings. Developers might extend the Azure Communication Services with Graph API to provide contextual data from Microsoft 365 ecosystem. This page is providing inspiration on how to use existing Microsoft technologies to provide an end-to-end experience for calling scenarios with Teams users and Azure Communication Services calling SDKs.
1919

articles/communication-services/concepts/teams-endpoint.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Build a custom Teams endpoint
2+
title: Integrate communication as Teams user with Azure Communication Services
33
titleSuffix: An Azure Communication Services concept document
4-
description: This article discusses how to build a custom Teams endpoint.
4+
description: This article discusses how to integrate communication as Teams user with Azure Communication Services.
55
author: tomaschladek
66
manager: nmurav
77
services: azure-communication-services
@@ -12,25 +12,25 @@ ms.topic: conceptual
1212
ms.service: azure-communication-services
1313
ms.subservice: teams-interop
1414
---
15-
# Build a custom Teams endpoint
15+
# Integrate communication as Teams user with Azure Communication Services and Graph API
1616

1717
[!INCLUDE [Public Preview](../includes/public-preview-include-document.md)]
1818

19-
You can use Azure Communication Services and Graph API to build custom Teams endpoints to communicate with the Microsoft Teams client or other custom Teams endpoints. With a custom Teams endpoint, you can customize a voice, video, chat, and screen-sharing experience for Teams users.
19+
You can use Azure Communication Services and Graph API to integrate communication as Teams user into your products to communicate with other people in and outside your organization. With Azure Communication Services supporting Teams identities and Graph API, you can customize a voice, video, chat, and screen-sharing experience for Teams users.
2020

2121
You can use the Azure Communication Services Identity SDK to exchange Azure Active Directory (Azure AD) access tokens of Teams users for Communication Identity access tokens. The diagrams in the next sections demonstrate multitenant use cases, where fictional company Fabrikam is the customer of fictional company Contoso.
2222

2323
## Calling
2424

25-
Voice, video, and screen-sharing capabilities are provided via Azure Communication Services Calling SDKs. The following diagram shows an overview of the process you'll follow as you integrate your calling experiences with custom Teams endpoints.
25+
Voice, video, and screen-sharing capabilities are provided via Azure Communication Services Calling SDKs. The following diagram shows an overview of the process you'll follow as you integrate your calling experiences with Azure Communication Services support Teams identities.
2626

27-
![Diagram of the process of enabling the calling feature for a custom Teams endpoint experience.](./media/teams-identities/teams-identity-calling-overview.svg)
27+
![Diagram of the process to integrate the calling capabilities into your product with Azure Communication Services.](./media/teams-identities/teams-identity-calling-overview.svg)
2828

2929
## Chat
3030

31-
Optionally, you can also use custom Teams endpoints to integrate chat capabilities by using Graph APIs. For more information about the Graph API, see the [chat resource type](/graph/api/channel-post-messages) documentation.
31+
Optionally, you can also use Graph API to integrate chat capabilities into your product. For more information about the Graph API, see the [chat resource type](/graph/api/channel-post-messages) documentation.
3232

33-
![Diagram of the process of enabling the chat feature for a custom Teams endpoint experience.](./media/teams-identities/teams-identity-chat-overview.png)
33+
![Diagram of the process to integrate the chat capabilities into your product with Graph API.](./media/teams-identities/teams-identity-chat-overview.png)
3434

3535
## Azure Communication Services permissions
3636

articles/communication-services/quickstarts/eligible-teams-licenses.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,5 +44,5 @@ The following articles might be of interest to you:
4444

4545
- Try [quickstart for authentication of Teams users](./manage-teams-identity.md).
4646
- Try [quickstart for calling to a Teams user](./voice-video-calling/get-started-with-voice-video-calling-custom-teams-client.md).
47-
- Learn more about [Custom Teams endpoint](../concepts/teams-endpoint.md)
47+
- Learn more about [Azure Communication Services support Teams identities](../concepts/teams-endpoint.md)
4848
- Learn more about [Teams interoperability](../concepts/teams-interop.md)

articles/communication-services/quickstarts/manage-teams-identity.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.custom: mode-other
1717

1818
[!INCLUDE [Public Preview](../../communication-services/includes/public-preview-include-document.md)]
1919

20-
In this quickstart, you'll build a .NET console application to authenticate a Microsoft 365 user by using the Microsoft Authentication Library (MSAL) and retrieving a Microsoft Azure Active Directory (Azure AD) user token. You'll then exchange that token for an access token of Teams user with the Azure Communication Services Identity SDK. The access token for Teams user can then be used by the Communication Services Calling SDK to build a custom Teams endpoint.
20+
In this quickstart, you'll build a .NET console application to authenticate a Microsoft 365 user by using the Microsoft Authentication Library (MSAL) and retrieving a Microsoft Azure Active Directory (Azure AD) user token. You'll then exchange that token for an access token of Teams user with the Azure Communication Services Identity SDK. The access token for Teams user can then be used by the Communication Services Calling SDK to integrate calling capability as Teams user.
2121

2222
> [!NOTE]
2323
> When you're in a production environment, we recommend that you implement this exchange mechanism in back-end services, because requests for an exchange are signed with a secret.
@@ -37,7 +37,7 @@ The following sections will guide you through the steps for administrators, deve
3737

3838
The Administrator role has extended permissions in Azure AD. Members of this role can set up resources and can read information from the Azure portal. In the following diagram, you can see all actions that have to be executed by Administrators.
3939

40-
![Administrator actions to enable custom Teams endpoint experience](./media/teams-identities/teams-identity-admin-overview.svg)
40+
![Administrator actions to enable Azure Communication Services support for Teams identities.](./media/teams-identities/teams-identity-admin-overview.svg)
4141

4242
1. The Contoso Administrator creates or selects an existing *application* in Azure Active Directory. The property *Supported account types* defines whether users from various tenants can authenticate to the application. The property *Redirect URI* redirects a successful authentication request to the Contoso *server*.
4343
1. The Contoso Administrator adds API permissions to `Teams.ManageCalls` and `Teams.ManageChats` from Communication Services.
@@ -112,7 +112,7 @@ The Contoso developer needs to set up the *client application* to authenticate u
112112

113113
The developer's required actions are shown in following diagram:
114114

115-
![Diagram of developer actions to enable the custom Teams endpoint experience.](./media/teams-identities/teams-identity-developer-overview.svg)
115+
![Diagram of developer actions to enable Azure Communication Services support for Teams identities.](./media/teams-identities/teams-identity-developer-overview.svg)
116116

117117
1. The Contoso developer configures the Microsoft Authentication Library (MSAL) to authenticate the user for the application that was created earlier by the Administrator for Communication Services Teams.ManageCalls and Teams.ManageChats permissions.
118118
1. The Contoso developer initializes the Communication Services Identity SDK and exchanges the incoming Azure AD user token for the access token of Teams user via the identity SDK. The access token of Teams user is then returned to the *client application*.
@@ -145,14 +145,14 @@ For more information about setting up environments in public documentation, see
145145

146146
The user represents the Fabrikam users of the Contoso application. The user experience is shown in the following diagram:
147147

148-
![Diagram of user actions to enable the custom Teams endpoint experience.](./media/teams-identities/teams-identity-user-overview.svg)
148+
![Diagram of user actions to enable Azure Communication Services support for Teams identities.](./media/teams-identities/teams-identity-user-overview.svg)
149149

150150
1. The Fabrikam user uses the Contoso *client application* and is prompted to authenticate.
151151
1. The Contoso *client application* uses the MSAL to authenticate the user against the Fabrikam Azure AD tenant for the Contoso application with Communication Services Teams.ManageCalls and Teams.ManageChats permissions.
152152
1. Authentication is redirected to the *server*, as defined in the property *Redirect URI* in the MSAL and the Contoso application.
153153
1. The Contoso *server* exchanges the Azure AD user token for the access token of Teams user by using the Communication Services Identity SDK and returns the access token of Teams user to the *client application*.
154154

155-
With a valid access token for Teams user in the *client application*, developers can integrate the Communication Services Calling SDK and build a custom Teams endpoint.
155+
With a valid access token for Teams user in the *client application*, developers can integrate the Communication Services Calling SDK and manage calls as Teams user.
156156

157157
## Next steps
158158

@@ -165,5 +165,5 @@ In this quickstart, you learned how to:
165165
166166
Learn about the following concepts:
167167

168-
- [Custom Teams endpoint](../concepts/teams-endpoint.md)
168+
- [Azure Communication Services support Teams identities](../concepts/teams-endpoint.md)
169169
- [Teams interoperability](../concepts/teams-interop.md)

articles/communication-services/samples/trusted-auth-sample.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ This repository provides a sample of a server implementation of an authenticatio
2727

2828
This sample can help you in the following scenarios:
2929
- As a developer, you need to enable an authentication flow to generate Azure Communication Services user identities mapped to an Azure Active Directory identity. Using this identity you then will provision access tokens to be used in calling and chat experiences.
30-
- As a developer, you need to enable an authentication flow for Custom Teams Endpoint, which is done by using an Microsoft 365 Azure Active Directory identity of a Teams' user to fetch an Azure Communication Services token to be able to join Teams calling/chat.
30+
- As a developer, you need to enable an authentication flow for Azure Communication Services support Teams identities, which is done by using an Microsoft 365 Azure Active Directory identity of a Teams' user to fetch an Azure Communication Services token to be able to join Teams calling/chat.
3131

3232
> [!NOTE]
3333
>If you are looking to get started with Azure Communication Services, but are still in learning / prototyping phases, check out our [quickstarts for getting started with Azure communication services users and access tokens](../quickstarts/access-tokens.md?pivots=programming-language-csharp).

articles/communication-services/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -238,7 +238,7 @@ items:
238238
href: concepts/teams-interop.md
239239
- name: Join a Teams meeting
240240
href: concepts/join-teams-meeting.md
241-
- name: Custom Teams endpoint
241+
- name: Communication for Teams identities
242242
items:
243243
- name: Overview
244244
href: concepts/teams-endpoint.md

0 commit comments

Comments
 (0)