Merge pull request #291124 from zhiyuanliang-ms/zhiyuanliang/add-AAD-js-doc

Azure App Configuration - Add AAD authentication option for js doc

Author: AnnaMHuff

articles/azure-app-configuration/enable-dynamic-configuration-aspnet-netfx.md

@@ -164,12 +164,12 @@ Add the following key-values to the App Configuration store and leave **Label**
 
     If you use the Windows command prompt, run the following command:
     ```console
-    setx ConnectionString "connection-string-of-your-app-configuration-store"
+    setx ConnectionString "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use Windows PowerShell, run the following command:
     ```powershell
-    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
+    $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
     ```
 
 1. Restart Visual Studio to allow the change to take effect. 

articles/azure-app-configuration/enable-dynamic-configuration-azure-functions-csharp.md

@@ -184,19 +184,19 @@ Azure Functions support running [in-process](../azure-functions/functions-dotnet
 1. Set an environment variable named **ConnectionString**, and set it to the access key to your app configuration store. If you use the Windows command prompt, run the following command and restart the command prompt to allow the change to take effect:
 
     ```console
-    setx ConnectionString "connection-string-of-your-app-configuration-store"
+    setx ConnectionString "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use Windows PowerShell, run the following command:
 
     ```powershell
-    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
+    $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use macOS or Linux, run the following command:
 
     ```console
-    export ConnectionString='connection-string-of-your-app-configuration-store'
+    export ConnectionString='<connection-string-of-your-app-configuration-store>'
     ```
 
 2. To test your function, press F5. If prompted, accept the request from Visual Studio to download and install **Azure Functions Core (CLI)** tools. You might also need to enable a firewall exception so that the tools can handle HTTP requests.

articles/azure-app-configuration/enable-dynamic-configuration-dotnet-background-service.md

@@ -177,19 +177,19 @@ You use the [.NET command-line interface (CLI)](/dotnet/core/tools/) to create a
     If you use the Windows command prompt, run the following command and restart the command prompt to allow the change to take effect:
 
     ```cmd
-    setx Endpoint "endpoint-of-your-app-configuration-store"
+    setx Endpoint "<endpoint-of-your-app-configuration-store>"
     ```
 
     If you use PowerShell, run the following command:
 
     ```powershell
-    $Env:Endpoint = "endpoint-of-your-app-configuration-store"
+    $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"
     ```
 
     If you use macOS or Linux, run the following command:
 
     ```bash
-    export Endpoint='endpoint-of-your-app-configuration-store'
+    export Endpoint='<endpoint-of-your-app-configuration-store>'
     ```
 
     ### [Connection string](#tab/connection-string)
@@ -198,19 +198,19 @@ You use the [.NET command-line interface (CLI)](/dotnet/core/tools/) to create a
     If you use the Windows command prompt, run the following command and restart the command prompt to allow the change to take effect:
 
     ```cmd
-    setx ConnectionString "connection-string-of-your-app-configuration-store"
+    setx ConnectionString "<connection-string-of-your-app-configuration-store>"
     ```
 
    If you use PowerShell, run the following command:
 
     ```powershell
-    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
+    $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use macOS or Linux, run the following command:
 
     ```bash
-    export ConnectionString='connection-string-of-your-app-configuration-store'
+    export ConnectionString='<connection-string-of-your-app-configuration-store>'
     ```
     ---
 

articles/azure-app-configuration/enable-dynamic-configuration-dotnet-core-push-refresh.md

@@ -185,31 +185,31 @@ The `ProcessPushNotification` method takes in a `PushNotification` object contai
     To build and run the app locally using the Windows command prompt, run the following command and restart the command prompt to allow the change to take effect:
 
     ```console
-    setx AppConfigurationConnectionString "connection-string-of-your-app-configuration-store"
+    setx AppConfigurationConnectionString "<connection-string-of-your-app-configuration-store>"
     ```
 
     ### [PowerShell](#tab/powershell)
 
     If you use Windows PowerShell, run the following command:
 
     ```powershell
-    $Env:AppConfigurationConnectionString = "connection-string-of-your-app-configuration-store"
+    $Env:AppConfigurationConnectionString = "<connection-string-of-your-app-configuration-store>"
     ```
 
     ### [macOS](#tab/unix)
 
     If you use macOS, run the following command:
 
     ```console
-    export AppConfigurationConnectionString='connection-string-of-your-app-configuration-store'
+    export AppConfigurationConnectionString='<connection-string-of-your-app-configuration-store>'
     ```
 
     ### [Linux](#tab/linux)
 
     If you use Linux, run the following command:
 
     ```console
-    export AppConfigurationConnectionString='connection-string-of-your-app-configuration-store'
+    export AppConfigurationConnectionString='<connection-string-of-your-app-configuration-store>'
     ```
 
     ---

articles/azure-app-configuration/enable-dynamic-configuration-dotnet-core.md

@@ -117,19 +117,19 @@ In the previous code, you're manually saving an instance of `IConfigurationRefre
 1. Set an environment variable named **ConnectionString**, and set it to the access key to your App Configuration store. If you use the Windows command prompt, run the following command and restart the command prompt to allow the change to take effect:
 
     ```console
-     setx ConnectionString "connection-string-of-your-app-configuration-store"
+     setx ConnectionString "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use Windows PowerShell, run the following command:
 
     ```powershell
-     $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
+     $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use macOS or Linux, run the following command:
 
     ```console
-     export ConnectionString='connection-string-of-your-app-configuration-store'
+     export ConnectionString='<connection-string-of-your-app-configuration-store>'
     ```
 
 1. Run the following command to build the console app:

articles/azure-app-configuration/enable-dynamic-configuration-dotnet.md

@@ -114,12 +114,12 @@ Add the following key-value to the App Configuration store and leave **Label** a
 
     If you use the Windows command prompt, run the following command:
     ```console
-    setx ConnectionString "connection-string-of-your-app-configuration-store"
+    setx ConnectionString "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use Windows PowerShell, run the following command:
     ```powershell
-    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
+    $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
     ```
 
 1. Restart Visual Studio to allow the change to take effect. 

articles/azure-app-configuration/enable-dynamic-configuration-java-spring-push-refresh.md

@@ -161,7 +161,7 @@ Event Grid Web Hooks require validation on creation. You can validate by followi
     If you use macOS or Linux, run the following command:
 
     ```bash
-    export APP_CONFIGURATION_ENDPOINT='endpoint-of-your-app-configuration-store'
+    export APP_CONFIGURATION_ENDPOINT='<endpoint-of-your-app-configuration-store>'
     ```
 
     ### [Connection string](#tab/connection-string)
@@ -182,7 +182,7 @@ Event Grid Web Hooks require validation on creation. You can validate by followi
     If you use macOS or Linux, run the following command:
 
     ```bash
-    export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
+    export APP_CONFIGURATION_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
     ```
     ---
 

articles/azure-app-configuration/enable-dynamic-configuration-javascript.md

@@ -3,13 +3,13 @@ title: Use dynamic configuration in JavaScript
 titleSuffix: Azure App Configuration
 description: Learn how to dynamically update configuration data for JavaScript.
 services: azure-app-configuration
-author: eskibear
+author: zhiyuanliang-ms
 ms.service: azure-app-configuration
 ms.devlang: javascript
 ms.topic: tutorial
 ms.date: 03/27/2024
 ms.custom: devx-track-js
-ms.author: yanzh
+ms.author: zhiyuanliang
 #Customer intent: As a JavaScript developer, I want to dynamically update my app to use the latest configuration data in Azure App Configuration.
 ---
 # Tutorial: Use dynamic configuration in JavaScript
@@ -39,13 +39,15 @@ Add the following key-value to your Azure App Configuration store. For more info
 The following examples show how to use refreshable configuration values in console applications.
 Choose the following instructions based on how your application consumes configuration data loaded from App Configuration, either as a `Map` or a configuration object.
 
+You can connect to App Configuration using either Microsoft Entra ID (recommended) or a connection string. The following code snippet demonstrates using Microsoft Entra ID. You use the DefaultAzureCredential to authenticate to your App Configuration store. While completing the quickstart listed in the prerequisites, you already [assigned your credential the App Configuration Data Reader role](./concept-enable-rbac.md#authentication-with-token-credentials).
+
 1. Open the file *app.js* and update the `load` function. Add a `refreshOptions` parameter to enable the refresh and configure refresh options. The loaded configuration will be updated when a change is detected on the server. By default, a refresh interval of 30 seconds is used, but you can override it with the `refreshIntervalInMs` property.
 
     ### [Use configuration as Map](#tab/configuration-map)
 
     ```javascript
-    // Connecting to Azure App Configuration using connection string
-    const settings = await load(connectionString, {
+    // Connecting to Azure App Configuration using endpoint and token credential
+    const settings = await load(endpoint, credential, {
         // Setting up to refresh when the sentinel key is changed
         refreshOptions: {
             enabled: true,
@@ -60,8 +62,8 @@ Choose the following instructions based on how your application consumes configu
     To ensure an up-to-date configuration, update the configuration object in the `onRefresh` callback triggered whenever a configuration change is detected and the configuration is updated.
 
     ```javascript
-    // Connecting to Azure App Configuration using connection string
-    const settings = await load(connectionString, {
+    // Connecting to Azure App Configuration using endpoint and token credential
+    const settings = await load(endpoint, credential, {
         // Setting up to refresh when the sentinel key is changed
         refreshOptions: {
             enabled: true,
@@ -115,11 +117,13 @@ Choose the following instructions based on how your application consumes configu
     ```javascript
     const sleepInMs = require("util").promisify(setTimeout);
     const { load } = require("@azure/app-configuration-provider");
-    const connectionString = process.env.AZURE_APPCONFIG_CONNECTION_STRING;
+    const { DefaultAzureCredential } = require("@azure/identity");
+    const endpoint = process.env.AZURE_APPCONFIG_ENDPOINT;
+    const credential = new DefaultAzureCredential(); // For more information, see https://learn.microsoft.com/azure/developer/javascript/sdk/credential-chains#use-defaultazurecredential-for-flexibility
 
     async function run() {
-        // Connecting to Azure App Configuration using connection string
-        const settings = await load(connectionString, {
+        // Connecting to Azure App Configuration using endpoint and token credential
+        const settings = await load(endpoint, credential, {
             // Setting up to refresh when the sentinel key is changed
             refreshOptions: {
                 enabled: true,
@@ -142,11 +146,13 @@ Choose the following instructions based on how your application consumes configu
     ```javascript
     const sleepInMs = require("util").promisify(setTimeout);
     const { load } = require("@azure/app-configuration-provider");
-    const connectionString = process.env.AZURE_APPCONFIG_CONNECTION_STRING;
+    const { DefaultAzureCredential } = require("@azure/identity");
+    const endpoint = process.env.AZURE_APPCONFIG_ENDPOINT;
+    const credential = new DefaultAzureCredential(); // For more information, see https://learn.microsoft.com/azure/developer/javascript/sdk/credential-chains#use-defaultazurecredential-for-flexibility
 
     async function run() {
-        // Connecting to Azure App Configuration using connection string
-        const settings = await load(connectionString, {
+        // Connecting to Azure App Configuration using endpoint and token credential
+        const settings = await load(endpoint, credential, {
             // Setting up to refresh when the sentinel key is changed
             refreshOptions: {
                 enabled: true,

articles/azure-app-configuration/integrate-ci-cd-pipeline.md

@@ -70,31 +70,31 @@ If you build locally, download and install the [Azure CLI](/cli/azure/install-az
     To build and run the app locally using the Windows command prompt, run the following command and restart the command prompt to allow the change to take effect:
 
     ```console
-        setx ConnectionString "connection-string-of-your-app-configuration-store"
+        setx ConnectionString "<connection-string-of-your-app-configuration-store>"
     ```
 
     ### [PowerShell](#tab/powershell)
 
     If you use Windows PowerShell, run the following command:
 
     ```powershell
-        $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
+        $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
     ```
 
     ### [macOS](#tab/unix)
 
     If you use macOS, run the following command:
 
     ```console
-        export ConnectionString='connection-string-of-your-app-configuration-store'
+        export ConnectionString='<connection-string-of-your-app-configuration-store>'
     ```
 
     ### [Linux](#tab/linux)
 
     If you use Linux, run the following command:
 
     ```console
-        export ConnectionString='connection-string-of-your-app-configuration-store'
+        export ConnectionString='<connection-string-of-your-app-configuration-store>'
     ```
 
     ---

articles/azure-app-configuration/quickstart-azure-functions-csharp.md

@@ -183,19 +183,19 @@ This project will use [dependency injection in .NET Azure Functions](../azure-fu
     If you use the Windows command prompt, run the following command and restart the command prompt to allow the change to take effect:
 
     ```cmd
-    setx ConnectionString "connection-string-of-your-app-configuration-store"
+    setx ConnectionString "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use PowerShell, run the following command:
 
     ```powershell
-    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
+    $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
     ```
 
     If you use macOS or Linux, run the following command:
 
     ```bash
-    export ConnectionString='connection-string-of-your-app-configuration-store'
+    export ConnectionString='<connection-string-of-your-app-configuration-store>'
     ```
 
 2. Press F5 to test your function. If prompted, accept the request from Visual Studio to download and install **Azure Functions Core (CLI)** tools. You might also need to enable a firewall exception so that the tools can handle HTTP requests.