Merge branch 'master' of https://github.com/MicrosoftDocs/azure-docs-pr into tamram-0317

Author: tamram

articles/active-directory/fundamentals/whats-new.md

@@ -12,7 +12,7 @@ ms.service: active-directory
 ms.subservice: fundamentals
 ms.workload: identity
 ms.topic: conceptual
-ms.date: 02/27/2020
+ms.date: 03/18/2020
 ms.author: mimart
 ms.reviewer: dhanyahk
 ms.custom: it-pro
@@ -36,7 +36,17 @@ This page is updated monthly, so revisit it regularly. If you're looking for ite
 ---
 
 ## February 2020
+
+### Upcoming changes to custom controls
+
+**Type:** Plan for change  
+**Service category:** MFA  
+**Product capability:** Identity Security & Protection
 
+We're planning to replace the current custom controls preview with an approach that allows partner-provided authentication capabilities to work seamlessly with the Azure Active Directory administrator and end user experiences. Today, partner MFA solutions face the following limitations: they work only after a password has been entered; they don’t serve as MFA for step-up authentication in other key scenarios; and they don’t integrate with end user or administrative credential management functions. The new implementation will allow partner-provided authentication factors to work alongside built-in factors for key scenarios, including registration, usage, MFA claims, step up authentication, reporting, and logging. 
+
+Custom controls will continue to be supported in preview alongside the new design until it reaches general availability. At that point, we'll give customers time to migrate to the new design. Because of the limitations of the current approach, we won't onboard new providers until the new design is available. We are working closely with customers and providers and will communicate the timeline as we get closer. [Learn more](https://docs.microsoft.com/azure/active-directory/conditional-access/controls).
+
 ### Identity Secure Score - MFA improvement action updates
 
 **Type:** Plan for change  

articles/active-directory/hybrid/TOC.yml

@@ -316,6 +316,8 @@
       href: tshoot-connect-attribute-not-syncing.md
     - name: Installation issues
       href: tshoot-connect-install-issues.md
+    - name: UPN changes
+      href: howto-troubleshoot-upn-changes.md
 - name: Reference
   items:
   - name: Hybrid Identity Required Ports and Protocols

articles/active-directory/hybrid/howto-troubleshoot-upn-changes.md

@@ -114,6 +114,8 @@ To configure Azure AD single sign-on with Palo Alto Networks - Admin UI, perform
 
 	> [!NOTE]
 	> These values are not real. Update these values with the actual Sign-On URL, Identifier and Reply URL. Contact [Palo Alto Networks - Admin UI Client support team](https://support.paloaltonetworks.com/support) to get these values. You can also refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal.
+	>
+	> Port 443 is required on the **Identifier** and the **Reply URL** as these values are hardcoded into the Palo Alto Firewall. Removing the port number will result in an error during login if removed.
 
 5. Palo Alto Networks - Admin UI application expects the SAML assertions in a specific format. Configure the following claims for this application. You can manage the values of these attributes from the **User Attributes** section on application integration page. On the **Set up Single Sign-On with SAML** page, click **Edit** button to open **User Attributes** dialog.
 

articles/active-directory/hybrid/media/howto-troubleshoot-upn-changes/custom-domains.png

@@ -1666,7 +1666,7 @@
       - name: Airstack
         href: airstack-provisioning-tutorial.md
       - name: Amazon Web Services (AWS) - Role Provisioning
-        href: amazon-web-service-tutorial.md#configure-azure-ad-single-sign-on
+        href: amazon-web-service-tutorial.md#configure-azure-ad-sso
       - name: Asana
         href: asana-provisioning-tutorial.md
       - name: Atlassian Cloud

articles/active-directory/hybrid/media/howto-troubleshoot-upn-changes/other-user.png

@@ -30,7 +30,7 @@
     href: advisor-quick-fix.md
   - name: Advisor data in Azure Resource Graph
     href: advisor-azure-resource-graph.md
-  - name: Get period summary for recommendations
+  - name: Get periodic summary for recommendations
     href: advisor-recommendations-digest.md
 - name: Reference
   items:

articles/active-directory/hybrid/media/howto-troubleshoot-upn-changes/verified-domains.png

@@ -1,148 +1,147 @@
 ---
-title: 'QuickStart: Create a C# ASP.NET Core app'
+title: "Quickstart: Create a C# ASP.NET Core app"
 description: Learn how to run web apps in Azure App Service by deploying the default C# ASP.NET Core web app template from Visual Studio.
 ms.assetid: b1e6bd58-48d1-4007-9d6c-53fd6db061e3
 ms.topic: quickstart
-ms.date: 08/30/2019
-ms.custom: mvc, devcenter, vs-azure
-ms.custom: seodec18
-
+ms.date: 03/17/2020
+ms.custom: mvc, devcenter, vs-azure, seodec18
 ---
-# Create an ASP.NET Core web app in Azure
-
-> [!NOTE]
-> This article deploys an app to App Service on Windows. To deploy to App Service on _Linux_, see [Create a .NET Core web app in App Service on Linux](./containers/quickstart-dotnetcore.md).
->
 
-[Azure App Service](overview.md) provides a highly scalable, self-patching web hosting service.
+# Quickstart: Create an ASP.NET Core web app in Azure
 
-This quickstart shows how to deploy your first ASP.NET Core web app to Azure App Service. When you're finished, you'll have a resource group that consists of an App Service plan and an App Service app with a deployed web application.
+In this quickstart, you'll learn how to create and deploy your first ASP.NET Core web app to [Azure App Service](overview.md). 
 
-[!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)]
+When you're finished, you'll have an Azure resource group consisting of an App Service hosting plan and an App Service with a deployed web application.
 
 ## Prerequisites
 
-To complete this tutorial, install <a href="https://www.visualstudio.com/downloads/" target="_blank">Visual Studio 2019</a> with the **ASP.NET and web development** workload.
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
+- This quickstart deploys an app to App Service on Windows. To deploy to App Service on _Linux_, see [Create a .NET Core web app in App Service on Linux](./containers/quickstart-dotnetcore.md).
+- Install <a href="https://www.visualstudio.com/downloads/" target="_blank">Visual Studio 2019</a> with the **ASP.NET and web development** workload.
+
+  If you've installed Visual Studio 2019 already:
 
-If you've installed Visual Studio 2019 already:
+  - Install the latest updates in Visual Studio by selecting **Help** > **Check for Updates**.
+  - Add the workload by selecting **Tools** > **Get Tools and Features**.
 
-- Install the latest updates in Visual Studio by selecting **Help** > **Check for Updates**.
-- Add the workload by selecting **Tools** > **Get Tools and Features**.
 
 ## Create an ASP.NET Core web app
 
-Create an ASP.NET Core web app by following these steps:
+Create an ASP.NET Core web app in Visual Studio by following these steps:
 
-1. Open Visual Studio and then select **Create a new project**.
+1. Open Visual Studio and select **Create a new project**.
 
-1. In **Create a new project**, find and choose **ASP.NET Core Web Application** for C#, then select **Next**.
+1. In **Create a new project**, select **ASP.NET Core Web Application** and confirm that **C#** is listed in the languages for that choice, then select **Next**.
 
-1. In **Configure your new project**, name the application _myFirstAzureWebApp_, and then select **Create**.
+1. In **Configure your new project**, name your web application project *myFirstAzureWebApp*, and select **Create**.
 
    ![Configure your web app project](./media/app-service-web-get-started-dotnet/configure-web-app-project.png)
 
-1. For this quickstart, choose the **Web Application** template. Make sure authentication is set to **No Authentication** and no other option is selected. Select **Create**.
-
-   ![Select ASP.NET Core Razor Pages for this tutorial](./media/app-service-web-get-started-dotnet/aspnet-razor-pages-app.png)
-
-    You can deploy any type of ASP.NET Core web app to Azure.
+1. You can deploy any type of ASP.NET Core web app to Azure, but for this quickstart, choose the **Web Application** template. Make sure **Authentication** is set to **No Authentication**, and that no other option is selected. Then, select **Create**.
 
-1. From the Visual Studio menu, select **Debug** > **Start Without Debugging** to run the web app locally.
+   ![Create a new ASP.NET Core web app](./media/app-service-web-get-started-dotnet/create-aspnet-core-web-app.png) 
+   
+1. From the Visual Studio menu, select **Debug** > **Start Without Debugging** to run your web app locally.
 
-   ![Run app locally](./media/app-service-web-get-started-dotnet/razor-web-app-running-locally.png)
+   ![Web app running locally](./media/app-service-web-get-started-dotnet/web-app-running-locally.png)
 
 ## Publish your web app
 
-1. In **Solution Explorer**, right-click the **myFirstAzureWebApp** project and select **Publish**.
+To publish your web app, you must first create and configure a new App Service that you can publish your app to. 
 
-1. Choose **App Service** and then select **Publish**.
+As part of setting up the App Service, you'll create:
 
-   ![Publish from project overview page](./media/app-service-web-get-started-dotnet/publish-app-vs2019.png)
+- A new [resource group](https://docs.microsoft.com/azure/azure-resource-manager/management/overview#terminology) to contain all of the Azure resources for the service.
+- A new [Hosting Plan](https://docs.microsoft.com/azure/app-service/overview-hosting-plans) that specifies the location, size, and features of the web server farm that hosts your app.
 
-1. In **App Service Create new**, your options depend on whether you're signed in to Azure already and whether you have a Visual Studio account linked to an Azure account. Select either **Add an account** or **Sign in** to sign in to your Azure subscription. If you're already signed in, select the account you want.
+Follow these steps to create your App Service and publish your web app:
 
-   > [!NOTE]
-   > If you're already signed in, don't select **Create** yet.
-   >
+1. In **Solution Explorer**, right-click the **myFirstAzureWebApp** project and select **Publish**. If you haven't already signed-in to your Azure account from Visual Studio, select either **Add an account** or **Sign in**. You can also create a free Azure account.
 
-   ![Sign in to Azure](./media/app-service-web-get-started-dotnet/sign-in-azure-vs2019.png)
+1. In the **Pick a publish target** dialog box, choose **App Service**, select **Create New**, and then select **Create Profile**.
 
-   [!INCLUDE [resource group intro text](../../includes/resource-group.md)]
+   ![Pick a publish target](./media/app-service-web-get-started-dotnet/pick-publish-target-vs2019.png)
 
-1. For **Resource group**, select **New**.
+1. In the **App Service: Create new** dialog, provide a globally unique **Name** for your app by either accepting the default name, or entering a new name. Valid characters are: `a-z`, `A-Z`, `0-9`, and `-`. This **Name** is used as the URL prefix for your web app in the format `http://<app_name>.azurewebsites.net`.
 
-1. In **New resource group name**, enter *myResourceGroup* and select **OK**.
+1. For **Subscription**, accept the subscription that is listed or select a new one from the drop-down list.
 
-   [!INCLUDE [app-service-plan](../../includes/app-service-plan.md)]
+1. In **Resource group**, select **New**. In **New resource group name**, enter *myResourceGroup* and select **OK**. 
 
-1. For the **Hosting Plan**, select **New**.
+1. For **Hosting Plan**, select **New**. 
 
-1. In the **Configure Hosting Plan** dialog, enter the values from the following table, and then select **OK**.
+1. In the **Hosting Plan: Create new** dialog, enter the values specified in the following table:
 
-   | Setting | Suggested Value | Description |
-   |-|-|-|
-   |App Service Plan| myAppServicePlan | Name of the App Service plan. |
-   | Location | West Europe | The datacenter where the web app is hosted. |
-   | Size | Free | [Pricing tier](https://azure.microsoft.com/pricing/details/app-service/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio) determines hosting features. |
+   | Setting  | Suggested Value | Description |
+   | -------- | --------------- | ----------- |
+   | **Hosting Plan**  | *myFirstAzureWebAppPlan* | Name of the App Service plan. |
+   | **Location**      | *West Europe* | The datacenter where the web app is hosted. |
+   | **Size**          | *Free* | [Pricing tier](https://azure.microsoft.com/pricing/details/app-service/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio) determines hosting features. |
+   
+   ![Create new Hosting Plan](./media/app-service-web-get-started-dotnet/create-new-hosting-plan-vs2019.png)
 
-   ![Create App Service plan](./media/app-service-web-get-started-dotnet/app-service-plan-vs2019.png)
+1. Leave **Application Insights** set to *None*.
 
-1. In **Name**, enter a unique app name that includes only the valid characters are `a-z`, `A-Z`, `0-9`, and `-`. You can accept the automatically generated unique name. The URL of the web app is `http://<app_name>.azurewebsites.net`, where `<app_name>` is your app name.
+1. In the **App Service: Create new** dialog box, select **Create** to start creating the Azure resources.
 
-   ![Configure app name](./media/app-service-web-get-started-dotnet/web-app-name-vs2019.png)
+   ![Create new app service](./media/app-service-web-get-started-dotnet/create-new-app-service-vs2019.png)
 
-1. Select **Create** to start creating the Azure resources.
+1. Once the wizard completes, select **Publish**.
 
-Once the wizard completes, it publishes the ASP.NET Core web app to Azure, and then launches the app in the default browser.
+   ![Publish web app to Azure](./media/app-service-web-get-started-dotnet/publish-web-app-vs2019.png)
 
-![Published ASP.NET web app in Azure](./media/app-service-web-get-started-dotnet/web-app-running-live.png)
+   Visual Studio publishes your ASP.NET Core web app to Azure, and launches the app in your default browser. 
 
-The app name specified in the **App Service Create new** page is used as the URL prefix in the format `http://<app_name>.azurewebsites.net`.
+   ![Published ASP.NET web app running in Azure](./media/app-service-web-get-started-dotnet/web-app-running-live.png)
 
 **Congratulations!** Your ASP.NET Core web app is running live in Azure App Service.
 
 ## Update the app and redeploy
 
+Follow these steps to update and redeploy your web app:
+
 1. In **Solution Explorer**, under your project, open **Pages** > **Index.cshtml**.
 
 1. Replace the two `<div>` tags with the following code:
 
    ```HTML
    <div class="jumbotron">
        <h1>ASP.NET in Azure!</h1>
-       <p class="lead">This is a simple app that we’ve built that demonstrates how to deploy a .NET app to Azure App Service.</p>
+       <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
    </div>
    ```
 
 1. To redeploy to Azure, right-click the **myFirstAzureWebApp** project in **Solution Explorer** and select **Publish**.
 
 1. In the **Publish** summary page, select **Publish**.
 
-   ![Visual Studio publishing summary page](./media/app-service-web-get-started-dotnet/publish-summary-page-vs2019.png)
+   ![Publish update to web app](./media/app-service-web-get-started-dotnet/publish-update-to-web-app-vs2019.png)
 
 When publishing completes, Visual Studio launches a browser to the URL of the web app.
 
-![Updated ASP.NET web app in Azure](./media/app-service-web-get-started-dotnet/web-app-running-live-updated.png)
+![Updated ASP.NET web app running in Azure](./media/app-service-web-get-started-dotnet/updated-web-app-running-live.png)
 
 ## Manage the Azure app
 
-To manage the web app, go to the [Azure portal](https://portal.azure.com), and search for and select **App Services**.
+To manage your web app, go to the [Azure portal](https://portal.azure.com), and search for and select **App Services**.
 
 ![Select App Services](./media/app-service-web-get-started-dotnet/app-services.png)
 
 On the **App Services** page, select the name of your web app.
 
-![Portal navigation to Azure app](./media/app-service-web-get-started-dotnet/access-portal-vs2019.png)
-
-You see your web app's Overview page. Here, you can do basic management like browse, stop, start, restart, and delete.
+![Portal navigation to Azure app](./media/app-service-web-get-started-dotnet/select-app-service.png)
 
-![App Service in Azure portal](./media/app-service-web-get-started-dotnet/web-app-general-vs2019.png)
+The **Overview** page for your web app, contains options for basic management like browse, stop, start, restart, and delete. The left menu provides further pages for configuring your app.
 
-The left menu provides different pages for configuring your app.
+![App Service in Azure portal](./media/app-service-web-get-started-dotnet/web-app-overview-page.png)
 
 [!INCLUDE [Clean-up section](../../includes/clean-up-section-portal.md)]
 
 ## Next steps
 
+In this quickstart, you used Visual Studio to create and deploy an ASP.NET Core web app to Azure App Service.
+
+Advance to the next article to learn how to create a .NET Core app and connect it to a SQL Database:
+
 > [!div class="nextstepaction"]
 > [ASP.NET Core with SQL Database](app-service-web-tutorial-dotnetcore-sqldb.md)