Merge pull request #12699 from ghogen/publish-profile

Review and update credentials information for Azure App Service publish

Author: v-dirichards

docs/azure/how-to-get-publish-profile-from-azure-app-service.md

@@ -5,7 +5,7 @@ author: ghogen
 manager: mijacobs
 ms.subservice: azure-development
 ms.topic: how-to
-ms.date: 05/16/2024
+ms.date: 06/18/2024
 ms.author: ghogen
 monikerRange: ">=vs-2019"
 ---
@@ -15,7 +15,8 @@ monikerRange: ">=vs-2019"
 A publish profile is a file that contains information and settings that Visual Studio uses to deploy applications and services to Azure.
 
 1. In the Azure portal, open the Azure App Service.
-2. Go to **Download publish profile** and save the profile locally.
+1. Make sure that **Basic authentication** is enabled. Go to **Configuration**, **General settings**, **SCM Basic Auth Publishing Credentials**, and choose **On**.
+1. Go to **Download publish profile** and save the profile locally.
 
    :::image type="content" source="./media/app-service-get-publish-profile.png" alt-text="Screenshot showing how to get the publish profile from Azure App Service." lightbox="./media/app-service-get-publish-profile.png":::
 
@@ -25,3 +26,4 @@ See also [Azure App Service](/azure/app-service).
 
 > [!NOTE]
 > When [basic authentication is disabled](/azure/app-service/configure-basic-auth-disable), **Download publish profile** and **Reset publish profile** are disabled.
+

docs/deployment/media/tutorial-azure-app-service-download-publish-profile.png

@@ -1,7 +1,7 @@
 ---
 title: "Publish to Azure by importing publish settings"
 description: Create and import publish settings to deploy ASP.NET and ASP.NET Core web applications from Visual Studio to Azure App Service.
-ms.date: 10/22/2021
+ms.date: 06/18/2024
 ms.topic: tutorial
 helpviewer_keywords:
   - "deployment, publish settings"
@@ -15,11 +15,11 @@ ms.subservice: deployment
 You can use the **Publish** tool to import publish settings and then deploy your app. In this article, we use publish settings for Azure App Service. These steps apply to ASP.NET and ASP.NET Core web apps. 
 
 > [!NOTE]
-> A publish settings file (*\*.publishsettings*) is different than a publishing profile (*\*.pubxml*) created in Visual Studio. A publish settings file is created by Azure App Service, and then it can be imported into Visual Studio.
+> A publish settings file (`*.publishsettings`) is different than a publishing profile (`*.pubxml`) created in Visual Studio. A publish settings file is created by Azure App Service, and then it can be imported into Visual Studio.
 
 ## Prerequisites
 
-* You must have Visual Studio 2019 installed and the **ASP.NET and web development** workload.
+* You must have Visual Studio installed and the **ASP.NET and web development** workload.
 
     If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta) page to install it for free.
 
@@ -35,7 +35,7 @@ You can use the **Publish** tool to import publish settings and then deploy your
 
     The project template you choose (ASP.NET or ASP.NET Core) must correspond to the version of ASP.NET installed on the web server.
 
-1. Choose either **MVC** (.NET Framework) or **Web Application (Model-View-Controller)** (for .NET Core), and make sure that **No Authentication** is selected, and then select **OK**.
+1. Choose either **MVC** (.NET Framework) or **Web Application (Model-View-Controller)** (for .NET Core or .NET 5 and later), and make sure that **No Authentication** is selected, and then select **OK**.
 
 1. Type a name like **MyWebApp** and select **OK**.
 
@@ -47,11 +47,13 @@ You can use the **Publish** tool to import publish settings and then deploy your
 
 1. In the Azure portal, open the Azure App Service.
 
-1. Go to **Get publish profile** and save the profile locally.
+1. Go to **Download publish profile** and save the profile locally.
 
-    ![Get the publish profile](../deployment/media/tutorial-azure-app-service-get-publish-profile.png)
+    ![Screenshot showing how to download the publish profile in Azure App Service.](../deployment/media/tutorial-azure-app-service-download-publish-profile.png)
 
-    A file with a *.publishsettings* file extension has been generated in the location where you saved it. The following code shows a partial example of the file (in a more readable formatting).
+    In order to deploy with Web Deploy, you need to enable **Basic authentication**, which is what Web Deploy uses. In Azure App Service, go to **Configuration**, **General settings**, **SCM Basic Auth Publishing Credentials**, and enable Web Deploy. You can't download a publish profile if this setting is not enabled.
+
+    A file with a `.publishsettings` file extension has been generated in the location where you saved it. The following code shows a partial example of the file (in a more readable formatting).
 
     ```xml
     <publishData>
@@ -73,7 +75,7 @@ You can use the **Publish** tool to import publish settings and then deploy your
     </publishData>
     ```
 
-    Typically, the preceding *.publishsettings file contains two publishing profiles that you can use in Visual Studio, one to deploy using Web Deploy, and one to deploy using FTP. The preceding code shows the Web Deploy profile. Both profiles will be imported later when you import the profile.
+    Typically, the preceding `.publishsettings` file contains two publishing profiles that you can use in Visual Studio, one to deploy using Web Deploy, and one to deploy using FTP. The preceding code shows the Web Deploy profile. Both profiles will be imported later when you import the profile.
 
 ## Import the publish settings in Visual Studio and deploy