Skip to content

Commit 050552c

Browse files
committed
edits
1 parent ee3cbc3 commit 050552c

9 files changed

+32
-37
lines changed

articles/azure-functions/durable/durable-functions-configure-durable-functions-with-credentials.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
title: "Quickstart: Authenticate a Durable Functions app by using Microsoft Entra ID"
3-
description: Authenticate a Durable Functions app in Azure Functions by using either managed identity credentials or client secret credentials in Microsoft Entra ID.
3+
description: Authenticate a Durable Functions app in Azure Functions by using managed identity credentials or client secret credentials in Microsoft Entra ID.
44
author: naiyuantian
55
ms.topic: quickstart
6-
ms.date: 02/01/2023
6+
ms.date: 07/24/2024
77
ms.author: azfuncdf
88
---
99

@@ -56,26 +56,26 @@ Next, in the Azure portal, [assign](/entra/identity/managed-identities-azure-res
5656

5757
Before you can use your app's managed identity, make some changes to the app configuration:
5858

59-
1. In the Azure portal, in your function app resource menu under **Settings**, select **Configuration**.
59+
1. In the Azure portal, on your function app resource menu under **Settings**, select **Configuration**.
6060

6161
1. In the list of settings, select **AzureWebJobsStorage** and select the **Delete** icon.
6262

6363
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-01.png" alt-text="Screenshot that shows default storage settings and deleting AzureWebJobsStorage." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-01.png":::
6464

6565
1. Add a setting to link your Azure storage account to the application.
6666

67-
Use *one of the following methods* depending on the cloud that your app runs in.
67+
Use *one of the following methods* depending on the cloud that your app runs in:
6868

6969
* **Azure cloud**: If your app runs in *public Azure*, add a setting that identifies an Azure storage account name:
7070

7171
* `AzureWebJobsStorage__<accountName>`
7272

7373
Example: `AzureWebJobsStorage__mystorageaccount123`
7474

75-
* **Non-Azure cloud**: If your application runs in a cloud outside of Azure, you must add a specific service URI (endpoint) for the storage account instead of an account name.
75+
* **Non-Azure cloud**: If your application runs in a cloud outside of Azure, you must add a specific service URI (an *endpoint*) for the storage account instead of an account name.
7676

7777
> [!NOTE]
78-
> If you're using [Azure Government](../../azure-government/documentation-government-welcome.md) or any other cloud that's separate from public Azure, you must use the option to provide a specific service URL. For more information about using Azure Storage with Azure Government, see [Develop by using the Storage API in Azure Government](../../azure-government/documentation-government-get-started-connect-to-storage.md).
78+
> If you use [Azure Government](../../azure-government/documentation-government-welcome.md) or any other cloud that's separate from public Azure, you must use the option to provide a specific service URI. For more information about using Azure Storage with Azure Government, see [Develop by using the Storage API in Azure Government](../../azure-government/documentation-government-get-started-connect-to-storage.md).
7979
8080
* `AzureWebJobsStorage__<blobServiceUri>`
8181

@@ -89,7 +89,7 @@ Before you can use your app's managed identity, make some changes to the app con
8989

9090
Example: `AzureWebJobsStorage__https://mystorageaccount123.table.core.windows.net/`
9191

92-
You can get the values for these URI variables in the storage account on the **Endpoints** tab.
92+
You can get the values for these URI variables in the storage account information on the **Endpoints** tab.
9393

9494
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-02.png" alt-text="Screenshot that shows an example of an endpoint as a specific service URI.":::
9595

@@ -107,7 +107,7 @@ Before you can use your app's managed identity, make some changes to the app con
107107

108108
## Configure your app to use client secret credentials
109109

110-
Registering a client application in Microsoft Entra ID is another way that you can configure access to an Azure service for your Durable Functions app. In the following steps, you use client secret credentials for authentication to your Azure Storage account. Function apps can use this method both locally and in Azure. Using a client secret credential is *less recommended* than using managed identity credentials because a client secret is more complicated to configure and manage. A client secret credential also requires sharing a secret credential with the Azure Functions service.
110+
Registering a client application in Microsoft Entra ID is another way you can configure access to an Azure service for your Durable Functions app. In the following steps, you use client secret credentials for authentication to your Azure Storage account. Function apps can use this method both locally and in Azure. Using a client secret credential is *less recommended* than using managed identity credentials because a client secret is more complicated to configure and manage. A client secret credential also requires sharing a secret credential with the Azure Functions service.
111111

112112
<a name='register-a-client-application-on-azure-active-directory'></a>
113113

@@ -141,36 +141,36 @@ To add the roles:
141141

142142
1. In the Azure portal, go to your function's storage account.
143143

144-
1. In the resource menu, select **Access Control (IAM)**, and then select **Add role assignment**.
144+
1. On the resource menu, select **Access Control (IAM)**, and then select **Add role assignment**.
145145

146146
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-02.png" alt-text="Screenshot that shows the Access control pane with Add role assignment highlighted." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-02.png":::
147147

148-
1. Select the role you want to add, select **Next**, and then search for your application. Review the role, and then add the role.
148+
1. Select a role to add, select **Next**, and then search for your application. Review the role assignment, and then add the role.
149149

150150
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-03.png" alt-text="Screenshot that shows the role assignment pane." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-03.png":::
151151

152152
### Configure the client secret
153153

154154
In the Azure portal, run and test the application. To run and test the app locally, specify the following settings in the function’s *local.settings.json* file.
155155

156-
1. In the Azure portal, in your function app resource menu under **Settings**, select **Configuration**.
156+
1. In the Azure portal, on your function app resource menu under **Settings**, select **Configuration**.
157157

158158
1. In the list of settings, select **AzureWebJobsStorage** and select the **Delete** icon.
159159

160160
1. Add a setting to link your Azure storage account to the application.
161161

162-
Use *one of the following methods* depending on the cloud that your app runs in.
162+
Use *one of the following methods* depending on the cloud that your app runs in:
163163

164164
* **Azure cloud**: If your app runs in *public Azure*, add a setting that identifies an Azure storage account name:
165165

166166
* `AzureWebJobsStorage__<accountName>`
167167

168168
Example: `AzureWebJobsStorage__mystorageaccount123`
169169

170-
* **Non-Azure cloud**: If your application runs in a cloud outside of Azure, you must add a specific service URI (endpoint) for the storage account instead of an account name.
170+
* **Non-Azure cloud**: If your application runs in a cloud outside of Azure, you must add a specific service URI (an *endpoint*) for the storage account instead of an account name.
171171

172172
> [!NOTE]
173-
> If you use [Azure Government](../../azure-government/documentation-government-welcome.md) or any other cloud that's separate from public Azure, you must use the option to provide a specific service URL. For more information about using Azure Storage with Azure Government, see [Develop by using the Storage API in Azure Government](../../azure-government/documentation-government-get-started-connect-to-storage.md).
173+
> If you use [Azure Government](../../azure-government/documentation-government-welcome.md) or any other cloud that's separate from public Azure, you must use the option to provide a specific service URI. For more information about using Azure Storage with Azure Government, see [Develop by using the Storage API in Azure Government](../../azure-government/documentation-government-get-started-connect-to-storage.md).
174174
175175
* `AzureWebJobsStorage__<blobServiceUri>`
176176

@@ -184,18 +184,18 @@ In the Azure portal, run and test the application. To run and test the app local
184184

185185
Example: `AzureWebJobsStorage__https://mystorageaccount123.table.core.windows.net/`
186186

187-
You can get the values for these URI variables in the storage account on the **Endpoints** tab.
187+
You can get the values for these URI variables in the storage account information on the **Endpoints** tab.
188188

189189
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-02.png" alt-text="Screenshot that shows an example of an endpoint as a specific service URI." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-02.png":::
190190

191-
1. To add client secret credentials, specify the following values:
191+
1. To add client secret credentials, set the following values:
192192

193193
* **AzureWebJobsStorage__clientId**: Get this GUID value on the Microsoft Entra application pane.
194194

195195
* **AzureWebJobsStorage__ClientSecret**: The secret value that you generated in the Microsoft Entra admin center in an earlier step.
196196

197197
* **AzureWebJobsStorage__tenantId**: The tenant ID that the Microsoft Entra application is registered in. Get this GUID value on the Microsoft Entra application pane.
198198

199-
The values to use for the client ID and the tenant ID appear on your client application Overview pane. The client secret value is the one that you saved in an earlier step. The client secret value isn't available after the page is refreshed.
199+
The values to use for the client ID and the tenant ID appear on your client application Overview pane. The client secret value is the one that you saved in an earlier step. The client secret value isn't available after the pane is refreshed.
200200

201201
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-04.png" alt-text="Screenshot that shows the tenant ID and client ID on a Microsoft Entra application pane." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-04.png":::

articles/azure-functions/durable/durable-functions-isolated-create-first-csharp.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Quickstart: Create a C# Durable Functions app"
33
description: Create and publish a C# Durable Functions app in Azure Functions by using Visual Studio or Visual Studio Code.
44
author: lilyjma
55
ms.topic: quickstart
6-
ms.date: 06/05/2024
6+
ms.date: 07/24/2024
77
ms.author: azfuncdf
88
zone_pivot_groups: code-editors-set-one
99
ms.devlang: csharp

articles/azure-functions/durable/quickstart-java.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Quickstart: Create a Java Durable Functions app"
33
description: Create and publish a Java Durable Functions app in Azure Functions. Choose manual setup, Maven, or Visual Studio Code.
44
author: lilyjma
55
ms.topic: quickstart
6-
ms.date: 12/12/2022
6+
ms.date: 07/24/2024
77
ms.reviewer: azfuncdf
88
ms.devlang: java
99
ms.custom: mode-api, devx-track-extended-java

articles/azure-functions/durable/quickstart-js-vscode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Quickstart: Create a JavaScript Durable Functions app"
33
description: Create and publish a JavaScript Durable Functions app in Azure Functions by using Visual Studio Code.
44
author: anthonychu
55
ms.topic: quickstart
6-
ms.date: 02/13/2023
6+
ms.date: 07/24/2024
77
ms.reviewer: azfuncdf, antchu
88
ms.devlang: javascript
99
ms.custom: devx-track-js, mode-api, vscode-azure-extension-update-complete

articles/azure-functions/durable/quickstart-mssql.md

Lines changed: 8 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Configure a Durable Functions app to use the Microsoft SQL Server (
44
author: davidmrdavid
55
ms.topic: quickstart
66
ms.custom: devx-track-dotnet
7-
ms.date: 11/14/2022
7+
ms.date: 07/24/2024
88
ms.reviewer: azfuncdf
99
---
1010

@@ -43,12 +43,7 @@ If you don't meet these prerequisites, we recommend that you begin with one of t
4343
> [!NOTE]
4444
> If your app uses [Extension Bundles](../functions-bindings-register.md#extension-bundles), skip this section. Extension Bundles removes the need for manual extension management.
4545
46-
First, install the latest version of the MSSQL storage provider extension from NuGet. For .NET, you add a reference to the extension in your _.csproj_ file and build the project. You can also use the [dotnet add package](/dotnet/core/tools/dotnet-add-package) command to add extension packages.
47-
48-
Which extension package you install depends on the .NET worker you're using:
49-
50-
- For the _in-process_ .NET worker, install [Microsoft.DurableTask.SqlServer.AzureFunctions](https://www.nuget.org/packages/Microsoft.DurableTask.SqlServer.AzureFunctions).
51-
- For the _isolated_ .NET worker, install [Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer).
46+
First, install the latest version of the [Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer) MSSQL storage provider extension from NuGet. For .NET, you add a reference to the extension in your _.csproj_ file and then build the project. You can also use the [dotnet add package](/dotnet/core/tools/dotnet-add-package) command to add extension packages.
5247

5348
You can install the extension by using the following [Azure Functions Core Tools CLI](../functions-run-local.md#install-the-azure-functions-core-tools) command:
5449

@@ -214,21 +209,21 @@ You can get your Azure SQL database's connection string by going to the database
214209

215210
Here's an example of how to get the Azure SQL connection string in the portal:
216211

217-
![Screenshot that shows an Azure connection string in the Azure portal.](./media/quickstart-mssql/mssql-azure-db-connection-string.png)
212+
:::image type="content" source="media/quickstart-mssql/mssql-azure-db-connection-string.png" alt-text="Screenshot that shows an Azure connection string in the Azure portal.":::
218213

219214
In the Azure portal, the connection string has the database's password removed: it's replaced with `{your_password}`. Replace that placeholder with the password that you used to create the database earlier in this section. If you forgot your password, you can reset it by going to the database overview pane in the Azure portal. In the **Essentials** view, select your server name. Then, select **Reset password**. See the following screenshots for examples.
220215

221-
![Screenshot that shows the Azure SQL database view, with the server name option highlighted.](./media/quickstart-mssql/mssql-azure-reset-pass-1.png)
216+
:::image type="content" source="media/quickstart-mssql/mssql-azure-reset-pass-1.png" alt-text="Screenshot that shows the Azure SQL database view, with the server name option highlighted.":::
222217

223-
![Screenshot that shows the SQL Server view, where Reset password is visible.](./media/quickstart-mssql/mssql-azure-reset-pass-2.png)
218+
:::image type="content" source="media/quickstart-mssql/mssql-azure-reset-pass-2.png" alt-text="Screenshot that shows the SQL Server view, where Reset password is visible.":::
224219

225220
### Add the connection string as an application setting
226221

227222
Next, add your database's connection string as an application setting. To add it in the Azure portal, first go to your Azure Functions app view. Under **Configuration**, select **New application setting**. Assign **SQLDB_Connection** to map to a publicly accessible connection string. See the following screenshots for examples.
228223

229-
![Screenshot that shows the database pane and New application setting highlighted.](./media/quickstart-mssql/mssql-azure-environment-variable-1.png)
224+
:::image type="content" source="media/quickstart-mssql/mssql-azure-environment-variable-1.png" alt-text="Screenshot that shows the database pane and New application setting highlighted.":::
230225

231-
![Screenshot that shows entering a connection string setting name and its value.](./media/quickstart-mssql/mssql-azure-environment-variable-2.png)
226+
:::image type="content" source="media/quickstart-mssql/mssql-azure-environment-variable-2.png" alt-text="Screenshot that shows entering a connection string setting name and its value.":::
232227

233228
### Deploy
234229

@@ -242,7 +237,7 @@ SELECT TOP 5 InstanceID, RuntimeStatus, CreatedTime, CompletedTime FROM dt.Insta
242237

243238
After you run a simple orchestrator, you should see at least one result, as shown in this example:
244239

245-
![Screenshot that shows Azure SQL Query Editor results for the SQL query.](./media/quickstart-mssql/mssql-azure-db-check.png)
240+
:::image type="content" source="media/quickstart-mssql/mssql-azure-db-check.png" alt-text="Screenshot that shows Azure SQL Query Editor results for the SQL query.":::
246241

247242
## Related content
248243

articles/azure-functions/durable/quickstart-netherite.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Configure a Durable Functions app to use the Netherite storage prov
44
author: sebastianburckhardt
55
ms.topic: quickstart
66
ms.custom: devx-track-dotnet
7-
ms.date: 11/14/2022
7+
ms.date: 07/24/2024
88
ms.reviewer: azfuncdf
99
---
1010

articles/azure-functions/durable/quickstart-powershell-vscode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Quickstart: Create a PowerShell Durable Functions app"
33
description: Create and publish a PowerShell Durable Functions app in Azure Functions by using Visual Studio Code.
44
author: anthonychu
55
ms.topic: quickstart
6-
ms.date: 06/22/2022
6+
ms.date: 07/24/2024
77
ms.reviewer: azfuncdf, antchu
88
ms.devlang: powershell
99
ms.custom: mode-api, vscode-azure-extension-update-complete

articles/azure-functions/durable/quickstart-python-vscode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Quickstart: Create a Python Durable Functions app"
33
description: Create and publish a Python Durable Functions app in Azure Functions by using Visual Studio Code.
44
author: davidmrdavid
55
ms.topic: quickstart
6-
ms.date: 06/15/2022
6+
ms.date: 07/24/2024
77
ms.reviewer: azfuncdf, davidmrdavid
88
ms.devlang: python
99
ms.custom: mode-api, devdivchpfy22, vscode-azure-extension-update-complete, devx-track-python

articles/azure-functions/durable/quickstart-ts-vscode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Quickstart: Create a TypeScript Durable Functions app"
33
description: Create and publish a TypeScript Durable Functions app in Azure Functions by using Visual Studio Code.
44
author: hossam-nasr
55
ms.topic: quickstart
6-
ms.date: 07/09/2024
6+
ms.date: 07/24/2024
77
ms.reviewer: azfuncdf
88
ms.devlang: typescript
99
ms.custom: devx-track-js, mode-api, vscode-azure-extension-update-complete, devx-track-ts

0 commit comments

Comments
 (0)