Skip to content

Commit c8b2189

Browse files
committed
edit pass: comm-service-tutorials
1 parent 70a9ffa commit c8b2189

File tree

6 files changed

+20
-11
lines changed

6 files changed

+20
-11
lines changed

articles/communication-services/tutorials/hmac-header-tutorial.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,13 @@ In this tutorial, you learn how to sign an HTTP request with a hash-based messag
2222
> [!NOTE]
2323
> We strongly encourage you to use [Azure SDKs](https://github.com/Azure/azure-sdk). The approach described here is a fallback option for cases when Azure SDKs can't be used for any reason.
2424
25-
In this tutorial you learn how to:
25+
In this tutorial, you learn how to:
2626
> [!div class="checklist"]
27-
> * Sign an HTTP request with an HMAC signature.
27+
> * Create a request message.
28+
> * Create a content hash.
29+
> * Compute a signature.
30+
> * Create an authorization header string.
31+
> * Add headers.
2832
2933
::: zone pivot="programming-language-csharp"
3034
[!INCLUDE [Sign an HTTP request with C#](./includes/hmac-header-csharp.md)]
@@ -36,7 +40,7 @@ In this tutorial you learn how to:
3640

3741
## Clean up resources
3842

39-
To clean up and remove a Communication Services subscription, delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it. You can find out more about how to [clean up Azure Communication Services resources](../quickstarts/create-communication-resource.md#clean-up-resources) and [clean Azure Functions resources](../../azure-functions/create-first-function-vs-code-csharp.md#clean-up-resources).
43+
To clean up and remove a Communication Services subscription, delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it. You can find out more about how to [clean up Azure Communication Services resources](../quickstarts/create-communication-resource.md#clean-up-resources) and [clean up Azure Functions resources](../../azure-functions/create-first-function-vs-code-csharp.md#clean-up-resources).
4044

4145
## Related content
4246

articles/communication-services/tutorials/includes/hmac-header-csharp.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ The `hmac-sha256-signature` consists of:
3434
- Host
3535
- x-ms-content-sha256
3636

37-
## Setup
37+
## Set up the authorization header
3838

3939
The following steps describe how to construct the authorization header.
4040

articles/communication-services/tutorials/includes/hmac-header-python.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ The `hmac-sha256-signature` consists of:
3535
- Host
3636
- x-ms-content-sha256
3737

38-
## Setup
38+
## Set up the authorization header
3939

4040
The following steps describe how to construct the authorization header.
4141

articles/communication-services/tutorials/includes/trusted-service-js.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ This service is responsible for authenticating users to Communication Services.
3232

3333
For more information, see the [client-server architecture](../../concepts/identity-model.md#client-server-architecture) and [authentication and authorization](../../concepts/authentication.md) conceptual documentation.
3434

35-
## Setup
35+
## Set up a function
3636

3737
This section describes the procedures to set up a function.
3838

articles/communication-services/tutorials/postman-tutorial.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,9 @@ In this tutorial, you learn how to:
3030

3131
## Download and install Postman
3232

33-
Postman is a desktop application that's capable of making API requests against any HTTP API. Postman is commonly used for testing and exploring APIs. In this tutorial, you download the latest [desktop version from the Postman website](https://www.postman.com/downloads/). Postman has versions for Windows, Mac, and Linux, so download the version that's appropriate for your operating system. After the download is finished, open the application. The start screen asks you to sign in or create a Postman account. Creating an account is optional, and you can skip it by selecting **Skip and go to app**. Creating an account saves your API request settings to Postman. You can then pick up your requests on other computers.
33+
Postman is a desktop application that's capable of making API requests against any HTTP API. Postman is commonly used for testing and exploring APIs. In this tutorial, you download the latest [desktop version from the Postman website](https://www.postman.com/downloads/). Postman has versions for Windows, Mac, and Linux, so download the version that's appropriate for your operating system.
34+
35+
After the download is finished, open the application. The start screen asks you to sign in or create a Postman account. Creating an account is optional, and you can skip it by selecting **Skip and go to app**. Creating an account saves your API request settings to Postman. You can then pick up your requests on other computers.
3436

3537
:::image type="content" source="media/postman/create-account-or-skip.png" alt-text="Screenshot that shows the Postman start screen where you can create an account or go directly to the app.":::
3638

@@ -181,9 +183,9 @@ After you enter it, select Ctrl+S or select **Save** to save the script to the c
181183

182184
## Create a request in Postman
183185

184-
Now that everything is set up, you're ready to create a Communication Services request in Postman. To get started, select the Plus sign (+) next to the Communication Services collection.
186+
Now that everything is set up, you're ready to create a Communication Services request in Postman. To get started, select the plus sign (+) next to the Communication Services collection.
185187

186-
:::image type="content" source="media/postman/create-request.png" alt-text="Screenshot that shows the Postman Plus sign (+).":::
188+
:::image type="content" source="media/postman/create-request.png" alt-text="Screenshot that shows the Postman plus sign (+).":::
187189

188190
You created a new tab for your request in Postman, and now you need to configure it. You make a request against the SMS Send API, so be sure to refer to the [documentation for this API for assistance](/rest/api/communication/sms/send). Let's configure the Postman request.
189191

articles/communication-services/tutorials/trusted-service-tutorial.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,12 @@ This article describes how to use Azure Functions to build a trusted user access
2020
> [!IMPORTANT]
2121
> The endpoint created at the end of this tutorial isn't secure. Be sure to read about the security details in the [Azure Functions security](../../azure-functions/security-concepts.md) article. You need to add security to the endpoint to ensure that bad actors can't provision tokens.
2222
23-
In this tutorial you learn how to:
23+
In this tutorial, you learn how to:
2424
> [!div class="checklist"]
25-
> * Create an Azure function that serves as a trusted token provisioning service.
25+
> * Set up a function.
26+
> * Generate access tokens.
27+
> * Test the function.
28+
> * Deploy and run the function.
2629
2730
[!INCLUDE [Trusted Service JavaScript](./includes/trusted-service-js.md)]
2831

0 commit comments

Comments
 (0)