Merge pull request #292816 from MicrosoftDocs/main

1/9/2025 11:00 AM IST Publish

Author: PhilKang0704

articles/communication-services/quickstarts/identity/access-tokens.md

@@ -1,11 +1,11 @@
 ---
-title: Quickstart - Create and manage access tokens
-titleSuffix: An Azure Communication Services quickstart
-description: Learn how to manage identities and access tokens by using the Azure Communication Services Identity SDK.
-author: tomaschladek
-manager: nmurav
+title: Create and manage access tokens
+titleSuffix: An Azure Communication Services guide
+description: Manage identities and access tokens using the Azure Communication Services Identity SDK.
+author: soricos85
+manager: dariagrigoriu
 services: azure-communication-services
-ms.author: tchladek
+ms.author: dariac
 ms.date: 11/17/2021
 ms.topic: quickstart
 ms.service: azure-communication-services
@@ -14,11 +14,11 @@ zone_pivot_groups: acs-azcli-js-csharp-java-python-portal-nocode
 ms.custom: mode-other, devx-track-azurecli, devx-track-extended-java, devx-track-js, devx-track-python
 ---
 
-# Quickstart: Create and manage access tokens
+# Create and manage access tokens
 
-Access tokens let Azure Communication Services SDKs [authenticate](../../concepts/authentication.md) directly against Azure Communication Services as a particular identity. You'll need to create access tokens if you want your users to join a call or chat thread within your application. 
+Access tokens enable Azure Communication Services SDKs to [authenticate](../../concepts/authentication.md) directly against Azure Communication Services as a particular identity. You need to create access tokens if you want your users to join a call or chat thread within your application. 
 
-In this quickstart, you'll learn how to use the Azure Communication Services SDKs to create identities and manage your access tokens. For production use cases, we recommend that you generate access tokens on a [server-side service](../../concepts/client-and-server-architecture.md).
+This article describes how to use the Azure Communication Services SDKs to create identities and manage your access tokens. For production use cases, we recommend that you generate access tokens on a server-side service as described in [Mobile architecture design](../../concepts/client-and-server-architecture.md).
 
 ::: zone pivot="platform-azcli"
 [!INCLUDE [Azure CLI](./includes/access-tokens/access-token-az-cli.md)]
@@ -41,55 +41,39 @@ In this quickstart, you'll learn how to use the Azure Communication Services SDK
 ::: zone-end
 
 ::: zone pivot="platform-azportal"
-[!INCLUDE [AzPortal](./includes/access-tokens/access-token-az-portal.md)]
+[!INCLUDE [Azure Portal](./includes/access-tokens/access-token-az-portal.md)]
 ::: zone-end
 
 ::: zone pivot="platform-nocode"
-[!INCLUDE [No Code](./includes/access-tokens/access-token-no-code.md)]
+[!INCLUDE [Power Platform](./includes/access-tokens/access-token-no-code.md)]
 ::: zone-end
 
 ## Use identity for monitoring and metrics
 
-The user ID is intended to act as a primary key for logs and metrics that are collected through Azure Monitor. To view all of a user's calls, for example, you can set up your authentication in a way that maps a specific Azure Communication Services identity (or identities) to a single user. 
+The user ID acts as a primary key for logs and metrics collected through Azure Monitor. To view all of a user's calls, for example, you can set up your authentication to map a specific Azure Communication Services identity (or identities) to a single user.
 
-Learn more about [authentication concepts](../../concepts/authentication.md), call diagnostics through [log analytics](../../concepts/analytics/log-analytics.md), and [metrics](../../concepts/metrics.md) that are available to you.
+For more information, see:
+- [Authentication concepts](../../concepts/authentication.md)
+- [Call diagnostics through log analytics](../../concepts/analytics/log-analytics.md)
+- [Metrics](../../concepts/metrics.md).
 
 ## Clean up resources
 
-To clean up and remove a Communication Services subscription, delete the resource or resource group. Deleting a resource group also deletes any other resources that are associated with it. For more information, see the "Clean up resources" section of [Create and manage Communication Services resources](../create-communication-resource.md#clean-up-resources).
+To clean up and remove a Communication Services subscription, delete the resource or resource group. Deleting a resource group also deletes any other resources associated with it. For more information, see [Create and manage Communication Services resources > Clean up resources](../create-communication-resource.md#clean-up-resources).
 
-::: zone pivot="platform-nocode"
-To clean up your logic app workflow and related resources, review [how to clean up Azure Logic Apps resources](../../../logic-apps/quickstart-create-example-consumption-workflow.md#clean-up-resources).
-::: zone-end
-
-::: zone pivot="platform-azportal,programming-language-java,programming-language-python,programming-language-javascript,programming-language-csharp,platform-azcli"
+To clean up your logic app workflow and related resources, see [Create an example Consumption logic app workflow using the Azure portal > Clean up resources](../../../logic-apps/quickstart-create-example-consumption-workflow.md#clean-up-resources).
 
 ## Next steps
 
-In this quickstart, you learned how to:
+This article described how to create a user and delete a user. It also describes how to issue an access token to a user and remove a user access token using the Azure Communication Services Identity connector. For more information, see [Azure Communication Services Identity Connector](/connectors/acsidentity/).
 
-> [!div class="checklist"]
-> * Issue access tokens
-> * Manage identities
+To see how tokens are use by other connectors, check out [how to send a chat message](../chat/logic-app.md) from Power Automate using Azure Communication Services.
 
-> [!div class="nextstepaction"]
-> [Add voice calling to your app](../voice-video-calling/getting-started-with-calling.md)
+To learn more about how to send an email using the Azure Communication Services Email connector check [Send email message in Power Automate with Azure Communication Services](../email/logic-app.md).
 
-You might also want to:
+## Related articles
 
  - [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)
-
-::: zone-end
-
-::: zone pivot="platform-nocode"
-## Next steps
-
-In this quickstart, you learned how to create a user, delete a user, issue a user an access token and remove user access token using the Azure Communication Services Identity connector. To learn more check the [Azure Communication Services Identity Connector](/connectors/acsidentity/) documentation.
-
-To see how tokens are use by other connectors, check out [how to send a chat message](../chat/logic-app.md) from Power Automate using Azure Communication Services.
-
-To learn more about how to send an email using the Azure Communication Services Email connector check [Send email message in Power Automate with Azure Communication Services](../email/logic-app.md).
-::: zone-end

articles/communication-services/quickstarts/identity/includes/access-tokens/access-token-az-cli.md

@@ -18,22 +18,24 @@ ms.author: dademath
 - An active Communication Services resource and connection string. [Create a Communication Services resource](../../../create-communication-resource.md?#access-your-connection-strings-and-service-endpoints-using-azure-cli).
 - Install [Azure CLI](/cli/azure/install-azure-cli-windows?tabs=azure-cli).
 
-## Setting up
+## Set up your environment
 
 ### Add the extension
-Add the Azure Communication Services extension for Azure CLI by using the `az extension` command.
+
+Add the Azure Communication Services extension for Azure CLI using the `az extension` command.
 
 ```azurecli-interactive
 az extension add --name communication
 ```
 
 ### Sign in to Azure CLI
-You'll need to [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in running the ```az login``` command from the terminal and providing your credentials.
+
+You need to [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in running the ```az login``` command from the terminal, then provide your credentials.
 
 
 ### (Optional) Use Azure CLI identity operations without passing in a connection string
 
-You can configure the `AZURE_COMMUNICATION_CONNECTION_STRING` environment variable to use Azure CLI identity operations without having to use `--connection_string` to pass in the connection string. To configure an environment variable, open a console window and select your operating system from the below tabs. Replace `<yourConnectionString>` with your actual connection string.
+You can configure the `AZURE_COMMUNICATION_CONNECTION_STRING` environment variable to use Azure CLI identity operations without having to use `--connection_string` to pass in the connection string. To configure an environment variable, open a console window and select your operating system from the following tabs. Replace `<yourConnectionString>` with your actual connection string.
 
 #### [Windows](#tab/windows)
 
@@ -43,7 +45,7 @@ Open a console window and enter the following command:
 setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"
 ```
 
-After you add the environment variable, you may need to restart any running programs that will need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
+After you add the environment variable, you might need to restart any running programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
 
 #### [macOS](#tab/unix)
 
@@ -53,7 +55,7 @@ Edit your **`.zshrc`**, and add the environment variable:
 export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"
 ```
 
-After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable.
 
 #### [Linux](#tab/linux)
 
@@ -63,7 +65,7 @@ Edit your **`.bash_profile`**, and add the environment variable:
 export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"
 ```
 
-After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable.
 
 ---
 
@@ -79,7 +81,7 @@ Open a console window and enter the following command:
 setx AZURE_COMMUNICATION_ACCESS_TOKEN "<yourAccessToken>"
 ```
 
-After you add the environment variable, you may need to restart any running programs that will need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
+After you add the environment variable, you might need to restart any running programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
 
 #### [macOS](#tab/unix)
 
@@ -89,7 +91,7 @@ Edit your **`.zshrc`**, and add the environment variable:
 export AZURE_COMMUNICATION_ACCESS_TOKEN="<yourAccessToken>"
 ```
 
-After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable.
 
 #### [Linux](#tab/linux)
 
@@ -99,7 +101,7 @@ Edit your **`.bash_profile`**, and add the environment variable:
 export AZURE_COMMUNICATION_ACCESS_TOKEN="<yourAccessToken>"
 ```
 
-After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable.
+After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable.
 
 ---
 
@@ -159,7 +161,7 @@ Access tokens are short-lived credentials that need to be reissued. Not doing so
 
 <a name='exchange-an-azure-ad-access-token-of-the-teams-user-for-a-communication-identity-access-token'></a>
 
-### Exchange a Microsoft Entra access token of the Teams User for a Communication Identity access token
+### Exchange a Microsoft Entra access token of the Teams user for a Communication Identity access token
 
 Use the `token get-for-teams-user` command to issue an access token for the Teams user that can be used with the Azure Communication Services SDKs.
 
@@ -171,12 +173,12 @@ Make this replacement in the code:
 
 - Replace `<yourConnectionString>` with your connection string.
 - Replace `<yourAadUser>` with your Microsoft Entra userId.
-- Replace `<yourAadApplication>` with your Microsoft Entra application Id.
+- Replace `<yourAadApplication>` with your Microsoft Entra application ID.
 - Replace `<yourAadToken>` with your Microsoft Entra access token.
 
 ### Revoke access tokens
 
-You might occasionally need to explicitly revoke an access token. For example, you would do so when application users change the password they use to authenticate to your service. The `token revoke` command invalidates all active access tokens that were issued to the identity.
+You might need to explicitly revoke an access token. For example, you would do so when application users change the password they use to authenticate to your service. The `token revoke` command invalidates all active access tokens that were issued to the identity.
 
 ```azurecli-interactive
 az communication identity token revoke --user "<userId>" --connection-string "<yourConnectionString>"
@@ -189,7 +191,7 @@ Make this replacement in the code:
 
 ### Delete an identity
 
-When you delete an identity, you revoke all active access tokens and prevent the further issuance of access tokens for the identity. Doing so also removes all persisted content that's associated with the identity.
+When you delete an identity, you revoke all active access tokens and prevent the further issuance of access tokens for the identity. Doing so also removes all persisted content associated with the identity.
 
 ```azurecli-interactive
 az communication identity user delete --user "<userId>" --connection-string "<yourConnectionString>"

articles/communication-services/quickstarts/identity/includes/access-tokens/access-token-az-portal.md

@@ -15,16 +15,20 @@ ms.custom: mode-other
 
 ## Prerequisites
 
-- An [Azure Communication Services resource](../../../create-communication-resource.md)
+- An [Azure Communication Services resource](../../../create-communication-resource.md).
 
 ## Create the access tokens
 
-In the [Azure portal](https://portal.azure.com), navigate to the **Identities & User Access Tokens** blade within your Communication Services resource. 
+1. In the [Azure portal](https://portal.azure.com), navigate to the **Identities & User Access Tokens** blade in your Communication Services resource. 
 
-Choose the scope of the access tokens. You can select none, one, or multiple. Click **Generate**.
+2. Choose the scope of the access tokens. You can choose none, one, or multiple services. 
 
-![Select the scopes of the identity and access tokens.](../../media/quick-create-identity-choose-scopes.png)
+3. Select **Generate**.
 
-You'll see an identity and corresponding user access token generated. You can copy these strings and use them in the [sample apps](../../../../samples/overview.md) and other testing scenarios.
+   :::image type="content" source="../../media/quick-create-identity-choose-scopes.png" alt-text="Screenshot that shows the scopes of the identity and access tokens where you select Generate." lightbox="../../media/quick-create-identity-choose-scopes.png":::
 
-![The identity and access tokens are generated and show the expiration date.](../../media/quick-create-identity-generated.png) 
+   The system generates an identity and corresponding user access token.
+
+4. Copy these strings and use them in the [sample apps](../../../../samples/overview.md) and other testing scenarios.
+
+   :::image type="content" source="../../media/quick-create-identity-generated.png" alt-text="Screenshot that shows the identity and access tokens with expiration date" lightbox="../../media/quick-create-identity-generated.png":::