Skip to content

Commit 3f0419c

Browse files
committed
fixed PR review comments
1 parent 6a448b2 commit 3f0419c

File tree

9 files changed

+28
-26
lines changed

9 files changed

+28
-26
lines changed

articles/communication-services/concepts/identity-model.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -144,14 +144,14 @@ Azure Communication Services now supports Microsoft Entra ID authentication, all
144144
The following sections will guide you through the essential aspects of Microsoft Entra ID integration:
145145

146146
- How to obtain and manage access tokens: [Access tokens with Microsoft Entra ID](#access-tokens-with-microsoft-entra-id).
147-
- How to implement a client architecture with Microsoft Entra ID: [Client architecture for the Microsoft Entra ID](#client-architecture-for-the-microsoft-entra-id).
147+
- How to implement a client architecture with Microsoft Entra ID: [Client architecture for the Microsoft Entra ID](#client-architecture-for-microsoft-entra-id).
148148
- Current Limitations and Recommended Guidance: [Limitations](#limitations).
149149

150150
### Access tokens with Microsoft Entra ID
151151

152152
Only Azure Communication Services access tokens are supported for authentication and authorization in Azure Communication Services, including chat and call functionalities. For more on token structure and management, see [Access tokens](#access-tokens).
153153

154-
With Microsoft Entra ID integration, you authenticate users via Entra ID, obtain an Entra ID user access token with API permissions for the Azure Communication Services Clients application, and exchange it for an Azure Communication Services access token. The Azure Communication Services Common SDKs offer seamless authentication by automatically obtaining an Azure Communication Services access token for Entra ID user. For more information on how to implement the logic with Azure Communication Services Common SDK, see [Obtain access tokens for Microsoft Entra ID users](../quickstarts/identity/entra-id-authentication-integration.md#developer-actions)
154+
With Microsoft Entra ID integration, you authenticate users via Entra ID, obtain an Entra ID user access token with API permissions for the Azure Communication Services Clients application, and exchange it for an Azure Communication Services access token. The Azure Communication Services Common SDKs offer seamless authentication by automatically obtaining an Azure Communication Services access token for Entra ID user. For more information on how to implement the logic with Azure Communication Services Common SDK, see [Obtain access tokens for Microsoft Entra ID users](../quickstarts/identity/microsoft-entra-id-authentication-integration.md#developer-actions)
155155

156156
The API permissions for the Azure Communication Services Clients application are named consistently with the Azure Communication Services access token scopes described in the sections [Chat token scopes](#chat-token-scopes) and [VoIP token scopes](#voip-token-scopes). The following table shows the mapping between API permissions and the access token scopes:
157157

@@ -166,21 +166,21 @@ The API permissions for the Azure Communication Services Clients application are
166166

167167
Azure Communication Services access tokens are issued with the same expiration as the Microsoft Entra ID user access token.
168168

169-
### Client architecture for the Microsoft Entra ID
169+
### Client architecture for Microsoft Entra ID
170170
With Microsoft Entra ID integration, you can simplify your architecture by directly using Entra ID for authentication and authorization. The following steps outline the process:
171171

172172
:::image type="content" source="./media/entra-client-server-architecture.png" alt-text="Diagram that shows the Microsoft Entra ID integration architecture." border="false":::
173173

174174
1. A user starts the client application.
175175
2. The client application authenticates the user via Microsoft Entra ID. The client application obtains an Entra ID user access token with API permissions for the Azure Communication Services Clients application.
176176
3. The client application obtains an Azure Communication Services access token for Entra ID user using one of the following methods:
177-
1. Using the Azure Communication Services Common SDKs: The client initializes the [CommunicationTokenCredential](./credentials-best-practices.md#communication-token-credential) with Entra ID token credential options, which automatically handles obtaining an Azure Communication Services access token for Entra ID user in the background. The application then uses this credential to access Azure Communication Services APIs.
178-
1. Custom implementation: The client application calls the [Exchange Entra ID token for Azure Communication Services access token](https://learn.microsoft.com/rest/api/communication/identity/entra-id-token) API to obtain an Azure Communication Services access token. The resulting Azure Communication Services access token is then used to access Azure Communication Services APIs.
177+
- Using the Azure Communication Services Common SDKs: The client initializes the [CommunicationTokenCredential](./credentials-best-practices.md#communication-token-credential) with Entra ID token credential options, which automatically handles obtaining an Azure Communication Services access token for Entra ID user in the background. The application then uses this credential to access Azure Communication Services APIs.
178+
- Custom implementation: The client application calls the [Exchange Entra ID token for Azure Communication Services access token](https://learn.microsoft.com/rest/api/communication/identity/entra-id-token) API to obtain an Azure Communication Services access token. The resulting Azure Communication Services access token is then used to access Azure Communication Services APIs.
179179

180180
This architecture eliminates the need for a separate identity management service, as Microsoft Entra ID handles user authentication and authorization directly.
181181

182182
### Limitations
183-
The Microsoft Entra ID integration is currently in public preview and has the following limitations:
183+
The Microsoft Entra ID integration is currently in preview and has the following limitations:
184184
- [Continuous Access Evaluation](/entra/identity/conditional-access/concept-continuous-access-evaluation) is not available. To revoke access tokens immediately, follow the instructions in [Revoke access tokens](../quickstarts/identity/access-tokens.md?pivots=platform-azcli#revoke-access-tokens).
185185
- Removing an Entra ID user does not automatically remove all associated data from the Communication Services resource. To ensure all data is deleted, follow the instructions in [Delete an identity](../quickstarts/identity/access-tokens.md?pivots=platform-azcli#delete-an-identity).
186186

@@ -189,7 +189,7 @@ The Microsoft Entra ID integration is currently in public preview and has the fo
189189
* To issue tokens, see [Create and manage access tokens for end users](../quickstarts/identity/access-tokens.md).
190190
* For an introduction to authentication, see [Authenticate to Azure Communication Services](./authentication.md).
191191
* For details on how authentication works in single-tenant and multitenant Microsoft Entra ID scenarios, refer to [Tenancy in Microsoft Entra ID](https://learn.microsoft.com/entra/identity-platform/single-and-multi-tenant-apps).
192-
* For a quickstart on how to authenticate Microsoft Entra ID users, see [Authenticate Microsoft Entra ID users](../quickstarts/identity/entra-id-authentication-integration.md).
192+
* For a quickstart on how to authenticate Microsoft Entra ID users, see [Authenticate Microsoft Entra ID users](../quickstarts/identity/microsoft-entra-id-authentication-integration.md).
193193
* To read about data residency and privacy, see [Region availability and data residency](./privacy.md).
194194
* For a full sample of a simple identity management service, see [Trusted service tutorial](../tutorials/trusted-service-tutorial.md).
195195
* For a more advanced identity management sample which integrates with Entra ID and Microsoft Graph, see [Authentication service hero sample](../samples/trusted-auth-sample.md).

articles/communication-services/quickstarts/identity/includes/entra-id/support-entra-id-users-js.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ npm init -y
4040

4141
### Install the package
4242

43-
Use the `npm install` command to install the Azure Identity and Azure Communication Services Common SDKs for JavaScript.The Azure Communication Services Common SDK version should be `2.4.0` or later.
43+
Use the `npm install` command to install the Azure Identity and Azure Communication Services Common SDKs for JavaScript. The Azure Communication Services Common SDK version should be `2.4.0` or later.
4444

4545
```console
4646
npm install @azure/communication-common --save
@@ -179,7 +179,7 @@ setAccessToken(accessToken.token);
179179

180180
## Run the code
181181

182-
From a console prompt, navigate to the directory *entra-id-users-support-quickstart* , then execute the following `npm` command to run the app.
182+
From a console prompt, navigate to the directory *entra-id-users-support-quickstart*, then execute the following `npm` command to run the app.
183183

184184
```console
185185
npm run dev

articles/communication-services/quickstarts/identity/includes/entra-id/support-entra-id-users-net.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,8 @@ ms.author: aigerimb
1616
## Set up prerequisites
1717

1818
- The latest version [.NET SDK](https://dotnet.microsoft.com/download/dotnet) for your operating system.
19-
- [Azure Identify SDK for .Net](https://www.nuget.org/packages/Azure.Identity) to authenticate with Microsoft Entra ID.
20-
- [Azure Communication Services Common SDK for .Net](https://www.nuget.org/packages/Azure.Communication.Common/) to obtain Azure Communication Services access tokens for Microsoft Entra ID user.
19+
- [Azure Identify SDK for .NET](https://www.nuget.org/packages/Azure.Identity) to authenticate with Microsoft Entra ID.
20+
- [Azure Communication Services Common SDK for .NET](https://www.nuget.org/packages/Azure.Communication.Common/) to obtain Azure Communication Services access tokens for Microsoft Entra ID user.
2121

2222
## Final code
2323
Find the finalized code for this quickstart on [GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/EntraIdUsersSupportQuickstart).
@@ -48,7 +48,7 @@ dotnet add package Azure.Identity
4848
dotnet add package Azure.Communication.Common
4949
```
5050

51-
### Implement the credential flow
51+
## Implement the credential flow
5252

5353
From the project directory:
5454

143 KB
Loading
Loading
364 KB
Loading

0 commit comments

Comments
 (0)