Merge pull request #314832 from Xelu86/sdaftoolconf

[Update] Configure external tools to use with SAP Deployment Automation Framework

Author: v-regandowner

articles/sap/automation/tools-configuration.md

@@ -1,20 +1,25 @@
 ---
 title: Configure external tools for SAP Deployment Automation Framework
-description: Learn how to configure external tools for using SAP Deployment Automation Framework.
+description: Learn how to configure Visual Studio Code to connect to the deployer virtual machine for SAP Deployment Automation Framework.
 author: kimforss
 ms.author: kimforss
-ms.reviewer: kimforss
-ms.date: 10/19/2022
-ms.topic: concept-article
+ms.date: 04/16/2026
+ms.topic: how-to
 ms.service: sap-on-azure
 ms.subservice: sap-automation
 ms.custom: sfi-image-nochange
 # Customer intent: As a developer configuring deployment tools for SAP, I want to set up Visual Studio Code with the necessary SSH credentials, so that I can efficiently connect to the deployer virtual machine and automate deployment tasks.
 ---
 
-# Configure external tools to use with SAP Deployment Automation Framework
+# Configure external tools for SAP Deployment Automation Framework
 
-This article describes how to configure external tools to use SAP Deployment Automation Framework.
+This article describes how to configure Visual Studio Code to connect to the deployer virtual machine (VM) for SAP Deployment Automation Framework.
+
+## Prerequisites
+
+- A deployed SAP Deployment Automation Framework control plane, including a deployer VM. For more information, see [Deploy the control plane](deploy-control-plane.md).
+- [Visual Studio Code](https://code.visualstudio.com/) installed on your local machine.
+- Access to the deployer key vault in the Azure portal.
 
 ## Configure Visual Studio Code
 
@@ -36,46 +41,46 @@ Follow these steps to configure Visual Studio Code.
 
 1. Create a new file in Visual Studio Code and copy in the secret value.
 
-1. Save the file where you keep SSH keys. For example, use `C:\\Users\\<your-username>\\.ssh\weeu_deployer.ssh`. Make sure that you save the file without an extension.
+1. Save the file where you keep SSH keys. For example, use `C:\Users\<your-username>\.ssh\weeu_deployer.ssh`. When you save the file, make sure the file type is set to **All Files** so the `.ssh` extension is preserved and no other extension like `.txt` is appended.
 
-After you've downloaded the SSH key for the deployer, you can use it to connect to the deployer virtual machine.
+After you download the SSH key for the deployer, you can use it to connect to the deployer VM.
 
 ### Get the public IP of the deployer
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. Find the resource group for the deployer. The name starts with `MGMT-[REGION_CODE]-DEP00` unless you've deployed the control plane by using a custom naming convention. The contents of the deployer resource group should look like the following image.
+1. Find the resource group for the deployer. The name starts with `MGMT-[REGION_CODE]-DEP00` unless you deployed the control plane by using a custom naming convention. The contents of the deployer resource group should look like the following image.
 
-    :::image type="content" source="media/tutorial/deployer-resource-group.png" alt-text="Screenshot that shows deployer resources":::
+   :::image type="content" source="media/tutorial/deployer-resource-group.png" alt-text="Screenshot that shows deployer resources in the Azure portal.":::
 
 1. Find the public IP for the deployer. The name should end with `-pip`. Filter by **type**, if necessary.
 
 1. Copy the IP address.
 
 ### Install the Remote Development extension
 
-1. Open the **Extensions** window by selecting **View** > **Extensions** or by selecting Ctrl+Shift+X.
+1. Open the **Extensions** window by selecting **View** > **Extensions** or by pressing **Ctrl + Shift + X**.
 
 1. Ensure that the **Remote Development** extension is installed.
 
 ### Connect to the deployer
 
-1. Open the command palette by selecting **View** > **Command Palette** or by selecting Ctrl+Shift+P. Enter **Connect to host**. You can also select the icon in the lower-left corner of Visual Studio Code and select **Connect to host**.
+1. Open the command palette by selecting **View** > **Command Palette** or by pressing **Ctrl + Shift + P**. Enter **Connect to host**. You can also select the icon in the lower-left corner of Visual Studio Code and select **Connect to host**.
 
 1. Select **Add New SSH Host**.
 
-    ```bash
-    ssh -i `C:\\Users\\<your-username>\\weeu_deployer.ssh` azureadm@<IP_Address>
-    ```
+   ```bash
+   ssh -i "C:\Users\<your-username>\.ssh\weeu_deployer.ssh" azureadm@<IP_Address>
+   ```
 
-    > [!NOTE]
-    > Change <IP_Address> to reflect the deployer IP.
+   > [!NOTE]
+   > Replace `<IP_Address>` with the deployer IP address.
 
 1. Select **Connect**. Select **Linux** when you're prompted for the target operating system, and accept the remaining dialogs (such as key and trust).
 
 1. When connected, select **Open Folder** and open the `/Azure_SAP_Automated_Deployment` folder.
 
-## Next step
+## Related content
 
-> [!div class="nextstepaction"]
-> [Configure the SAP workload zone](deploy-workload-zone.md)
+- [Configure the SAP workload zone](deploy-workload-zone.md)
+- [Deploy the control plane](deploy-control-plane.md)