Review service connector docs

maud-lv · maud-lv · commit f9d9616701e3 · 2024-10-22T17:39:23.000+02:00
diff --git a/articles/service-connector/concept-service-connector-internals.md b/articles/service-connector/concept-service-connector-internals.md
@@ -6,7 +6,7 @@ ms.author: malev
 ms.service: service-connector
 ms.custom: engagement-fy23
 ms.topic: conceptual
-ms.date: 01/17/2023
+ms.date: 10/22/2024
 ---
 # Service Connector internals
 
diff --git a/articles/service-connector/known-limitations.md b/articles/service-connector/known-limitations.md
@@ -4,7 +4,7 @@ description: Learn about current limitations in Service Connector.
 titleSuffix: Service Connector
 ms.service: service-connector
 ms.topic: troubleshooting
-ms.date: 03/02/2023
+ms.date: 10/22/2024
 ms.author: malev
 author: maud-lv
 ---
diff --git a/articles/service-connector/quickstart-portal-app-service-connection.md b/articles/service-connector/quickstart-portal-app-service-connection.md
@@ -5,7 +5,7 @@ author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: quickstart
-ms.date: 10/05/2023
+ms.date: 10/22/2024
 #Customer intent: As an app developer, I want to connect several services together so that I can ensure I have the right connectivity to access my Azure resources.
 ---
 
@@ -45,7 +45,7 @@ Sign in to the Azure portal at [https://portal.azure.com/](https://portal.azure.
 
 1. Select **Next: Authentication** to choose an authentication method.
 
-    ### [System-assigned managed identity](#tab/SMI)
+    ### [System-assigned managed identity (recommended)](#tab/SMI)
 
     System-assigned managed identity is the recommended authentication option. Select **System-assigned managed identity** to connect through an identity that's generated in Microsoft Entra ID and tied to the lifecycle of the service instance.
 
diff --git a/articles/service-connector/quickstart-portal-container-apps.md b/articles/service-connector/quickstart-portal-container-apps.md
@@ -1,11 +1,11 @@
 ---
-title: Quickstart - Create a service connection in Container Apps from the Azure portal
+title: Quickstart: Create a service connection in Container Apps.
 description: This quickstart shows how to create a service connection in Azure Container Apps from the Azure portal
 author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: quickstart
-ms.date: 10/31/2023
+ms.date: 10/22/2024
 #Customer intent: As an app developer, I want to connect Azure Container Apps to a storage account in the Azure portal using Service Connector.
 ---
 
@@ -57,11 +57,11 @@ Use Service Connector to create a new service connection in Container Apps.
 
 1. Select **Next: Authentication** to choose an authentication method: system-assigned managed identity (SMI), user-assigned managed identity (UMI), connection string, or service principal.
 
-    ### [SMI](#tab/SMI)
+    ### [System-assigned managed identity (recommended)](#tab/SMI)
 
     System-assigned managed identity is the recommended authentication option. Select **System-assigned managed identity** to connect through an identity that's automatically generated in Microsoft Entra ID and tied to the lifecycle of the service instance.
 
-    ### [UMI](#tab/UMI)
+    ### [User-assigned managed identity](#tab/UMI)
 
     Select **User-assigned managed identity** to authenticate through a standalone identity assigned to one or more instances of an Azure service. Select a subscription that contains a user-assigned managed identity, and select the identity.
 
diff --git a/articles/service-connector/quickstart-portal-functions-connection.md b/articles/service-connector/quickstart-portal-functions-connection.md
@@ -5,7 +5,7 @@ author: houk-ms
 ms.author: honc
 ms.service: service-connector
 ms.topic: quickstart
-ms.date: 10/25/2023
+ms.date: 10/22/2024
 ---
 # Quickstart: Create a service connection in a function app from the Azure portal
 
diff --git a/articles/service-connector/tutorial-passwordless.md b/articles/service-connector/tutorial-passwordless.md
@@ -6,7 +6,7 @@ author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: tutorial
-ms.date: 09/28/2023
+ms.date: 10/22/2024
 ms.devlang: azurecli
 ms.custom: passwordless-dotnet, passwordless-java, devx-track-azurecli
 zone_pivot_group_filename: service-connector/zone-pivot-groups.json
@@ -66,7 +66,7 @@ Then you can check the log or call the application to see if it can connect to t
 
 #### Permission
 
-If you encounter any permission-related errors, confirm the Azure CLI signed-in user with the command `az account show`. Make sure you log in with the correct account. Next, confirm that you have the following permissions that might be required to create a passwordless connection with Service Connector.
+If you encounter any permission-related errors, confirm the Azure CLI signed-in user with the command `az account show`. Make sure you sign in with the correct account. Next, confirm that you have the following permissions that might be required to create a passwordless connection with Service Connector.
 
 ::: zone pivot="postgresql"
 
diff --git a/articles/service-connector/tutorial-portal-key-vault.md b/articles/service-connector/tutorial-portal-key-vault.md
@@ -1,16 +1,17 @@
 ---
-title: Tutorial - Connect Azure services and store secrets in Key Vault
-description: Tutorial showing how to store your web app's secrets in Azure Key Vault using Service Connector
+title: Tutorial: Connect Azure services and store secrets in Key Vault
+description: Tutorial showing how to store your web application's secrets in Azure Key Vault using Service Connector.
 author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: tutorial
-ms.date: 10/31/2023
+ms.date: 10/22/2024
+#customer intent: As a web developer, I want store my app's secrets in Azure Key Vault so they can be managed and protected by Azure's security features.
 ---
 
 # Quickstart: Connect Azure services and store secrets in Azure Key Vault
 
-Azure Key Vault is a cloud service that provides a secure store for secrets. You can securely store keys, passwords, certificates, and other secrets. When you create a service connection, you can securely store access keys and secrets into connected Key Vault. In this tutorial, you'll complete the following tasks using the Azure portal. Both methods are explained in the following procedures.
+Azure Key Vault is a cloud service that provides a secure store for secrets. You can securely store keys, passwords, certificates, and other secrets. When you create a service connection, you can securely store access keys and secrets into connected Key Vault. In this tutorial, you complete the following tasks using the Azure portal. Both methods are explained in the following procedures.
 
 > [!div class="checklist"]
 > * Create a service connection to Azure Key Vault in Azure App Service
@@ -25,8 +26,8 @@ To create a service connection and store secrets in Key Vault with Service Conne
 * An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free).
 * An app hosted on App Service. If you don't have one yet, [create and deploy an app to App Service](../app-service/quickstart-dotnetcore.md)
 * An Azure Key Vault. If you don't have one, [create an Azure Key Vault](/azure/key-vault/general/quick-create-portal)
-* Another target service instance supported by Service Connector. In this tutorial, you'll use [Azure Blob Storage](../storage/blobs/storage-quickstart-blobs-portal.md)
-* Read and write access to the App Service, Key Vault and the target service.
+* Another target service instance supported by Service Connector. In this tutorial, you use [Azure Blob Storage](../storage/blobs/storage-quickstart-blobs-portal.md)
+* Read and write access to the App Service, Key Vault, and the target service.
 
 ## Create a Key Vault connection in App Service
 
@@ -52,7 +53,7 @@ To store your connection access keys and secrets into a key vault, start by conn
 
 ## Create a Blob Storage connection in App Service and store access keys into Key Vault
 
-Now you can create a service connection to another target service and directly store access keys into a connected Key Vault when using a connection string/access key or a Service Principal for authentication. We'll use Blob Storage as an example below. Follow the same process for other target services.
+Now you can create a service connection to another target service and directly store access keys into a connected Key Vault when using a connection string/access key or a service principal for authentication. We use Blob Storage as an example below. Follow the same process for other target services.
 
 1. In the Azure portal, type **App Service** in the search menu and select the name of the App Service you want to use from the list.
 1. Select **Service Connector** from the left table of contents. Then select **Create**.
@@ -83,11 +84,11 @@ Now you can create a service connection to another target service and directly s
 
     ### [Service principal](#tab/serviceprincipal)
 
-    Select **Next: Authentication** to select the authentication type and select **Service Principal** to use Service Principal to connect your storage account.
+    Select **Next: Authentication** to select the authentication type and select **Service Principal** to use a service principal to connect your storage account.
 
     | Setting      | Suggested value  | Description                                        |
     | ------------ |  ------- | -------------------------------------------------- |
-    | **Service Principal object ID or name** | Choose the Service Principal you want to use to connect to Blob Storage from the list | The Service Principal in your subscription that is used to connect to target service. |
+    | **Service Principal object ID or name** | Choose the service principal you want to use to connect to Blob Storage from the list | The service principal in your subscription that is used to connect to target service. |
     | **Store Secret to Key Vault** | Check | This option lets Service Connector store the service principal ID and secret into Key Vault. |
     | **Key Vault connection** | One of your key vault connections | Select the Key Vault in which you want to store your service principal ID and secret. |
 
@@ -103,7 +104,7 @@ Now you can create a service connection to another target service and directly s
 
 1. Expand the Blob Storage connection, select **Hidden value. Click to show value**. You can see that the value is a Key Vault reference.
 
-1. Select the **Key Vault** in the Service Type column of your Key Vault connection. You will be redirected to the Key Vault portal page.
+1. Select the **Key Vault** in the Service Type column of your Key Vault connection. You'll be redirected to the Key Vault portal page.
 
 1. Select **Secrets** in the Key Vault left ToC, and select the blob storage secret name.
 
diff --git a/articles/service-connector/tutorial-python-functions-storage-blob-as-input.md b/articles/service-connector/tutorial-python-functions-storage-blob-as-input.md
@@ -1,16 +1,17 @@
 ---
 title: 'Tutorial: Python function with Azure Blob Storage as input'
-description: Learn how you can connect a Python function to a storage blob as input using Service Connector
+description: Learn how you can connect a Python function to a storage blob as input using Service Connector in Azure.
 author: houk-ms
 ms.author: honc
 ms.service: service-connector
 ms.custom: devx-track-python
 ms.topic: tutorial
-ms.date: 10/25/2023
+ms.date: 10/22/2024
+#customer intent: As a developer, I want to configure a Python function with Storage Blob as input function binding so that I can process and manage large volumes of data stored in Azure Blob Storage. 
 ---
 # Tutorial: Python function with Azure Blob Storage as input
 
-In this tutorial, you learn how to configure a Python function with Storage Blob as input by completing the following tasks:
+In this tutorial, you learn how to configure a Python function with Azure Blob storage as input by completing the following tasks:
 
 > [!div class="checklist"]
 > * Use Visual Studio Code to create a Python function project.
diff --git a/articles/service-connector/tutorial-python-functions-storage-queue-as-trigger.md b/articles/service-connector/tutorial-python-functions-storage-queue-as-trigger.md
@@ -6,7 +6,7 @@ ms.author: honc
 ms.service: service-connector
 ms.custom: devx-track-python
 ms.topic: tutorial
-ms.date: 10/25/2023
+ms.date: 10/22/2024
 ---
 # Tutorial: Python function with Azure Queue Storage as trigger
 
@@ -50,15 +50,15 @@ Follow the [tutorial to create a local Azure Functions project](../azure-functio
 | **Provide a function name**                                     | Enter `QueueStorageTriggerFunc`.                                                                                                          |
 | **Select setting from "local.settings.json"**                   | Choose `Create new local app settings`, which lets you select your Storage Account and provide your queue name that works as the trigger. |
 
-You have created a Python function project with Azure Storage Queue as trigger. The local project connects to Azure Storage using the connection string saved into the `local.settings.json` file. Finally, the `main` function in `__init__.py` file of the function can consume the connection string with the help of the Function Binding defined in the `function.json` file.
+You created a Python function project with Azure Storage Queue as trigger. The local project connects to Azure Storage using the connection string saved into the `local.settings.json` file. Finally, the `main` function in `__init__.py` file of the function can consume the connection string with the help of the Function Binding defined in the `function.json` file.
 
 ## Run the function locally
 
 Follow the [tutorial](../azure-functions/create-first-function-vs-code-python.md?pivots=python-mode-configuration#run-the-function-locally) to run the function locally and verify the trigger.
 
 1. Select the storage account as you chose when creating the Azure Function resource if you're prompted to connect to storage. This value is used for Azure Function's runtime, and it isn't necessarily the same as the storage account you use for the trigger.
 1. To start the function locally, press `<kbd>`F5 `</kbd>` or select the **Run and Debug** icon in the left-hand side Activity bar.
-1. To verify the trigger works properly, keep the function running locally and open the Storage Queue blade in Azure portal, select **Add message** and provide a test message. You should see the function is triggered and processed as a queue item in your Visual Studio Code terminal.
+1. To verify the trigger works properly, keep the function running locally and open the Storage Queue pane in Azure portal, select **Add message** and provide a test message. You should see the function is triggered and processed as a queue item in your Visual Studio Code terminal.
 
 ## Create a connection using Service Connector
 
@@ -81,11 +81,11 @@ This step creates a Service Connector resource that configures an `AZURE_STORAGE
 Now you can deploy your function to Azure and verify the storage queue trigger works.
 
 1. Follow this [Azure Functions tutorial](../azure-functions/create-first-function-vs-code-python.md?pivots=python-mode-configuration#deploy-the-project-to-azure) to deploy your function to Azure.
-1. Open the Storage Queue blade in the Azure portal, select **Add message** and provide a test message. You should see the function is triggered and processed as a queue item in your function logs.
+1. Open the Storage Queue pane in the Azure portal, select **Add message** and provide a test message. You should see the function is triggered and processed as a queue item in your function logs.
 
 ## Troubleshoot
 
-If there are any errors related with the storage host, such as `No such host is known (<acount-name>.queue.core.windows.net:443)`, check whether the connection string you use to connect to Azure Storage contains the queue endpoint or not. If it doesn't, go to Azure Storage in the Azure portal, copy the connection string from the `Access keys` blade, and replace the values.
+If there are any errors related with the storage host, such as `No such host is known (<acount-name>.queue.core.windows.net:443)`, check whether the connection string you use to connect to Azure Storage contains the queue endpoint or not. If it doesn't, go to Azure Storage in the Azure portal, copy the connection string from the `Access keys` pane, and replace the values.
 
 If this error happens when you start the project locally, check the `local.settings.json` file.
 
