Merge pull request #248294 from cilwerner/CIAM-rename

Renaming CIAM how-to's to tutorials, fixing broken links

Author: v-dirichards

.openpublishing.redirection.active-directory.json

@@ -1715,6 +1715,21 @@
       "redirect_url": "/azure/active-directory/external-identities/customers/tutorial-daemon-node-call-api-prepare-tenant",
       "redirect_document_id": false 
     },
+    {
+      "source_path_from_root": "/articles/active-directory/external-identities/customers/how-to-web-app-dotnet-sign-in-prepare-tenant.md",
+      "redirect_url": "/azure/active-directory/external-identities/customers/tutorial-web-app-dotnet-sign-in-prepare-tenant",
+      "redirect_document_id": false 
+    },
+    {
+      "source_path_from_root": "/articles/active-directory/external-identities/customers/how-to-web-app-dotnet-sign-in-prepare-app.md",
+      "redirect_url": "/azure/active-directory/external-identities/customers/tutorial-web-app-dotnet-sign-in-prepare-app",
+      "redirect_document_id": false 
+    },
+    {
+      "source_path_from_root": "/articles/active-directory/external-identities/customers/how-to-web-app-dotnet-sign-in-sign-out.md",
+      "redirect_url": "/azure/active-directory/external-identities/customers/tutorial-web-app-dotnet-sign-in-sign-out",
+      "redirect_document_id": false 
+    },
     {
       "source_path_from_root": "/articles/active-directory/external-identities/conditional-access.md",
       "redirect_url": "/azure/active-directory/external-identities/authentication-conditional-access",

articles/active-directory/external-identities/customers/index.yml

@@ -91,7 +91,7 @@ landingContent:
           - text: Node.js web app
             url: tutorial-web-app-node-sign-in-prepare-tenant.md
           - text: ASP.NET web app
-            url: how-to-web-app-dotnet-sign-in-prepare-tenant.md
+            url: tutorial-web-app-dotnet-sign-in-prepare-tenant.md
           - text: Secure an ASP.NET web API
             url: tutorial-protect-web-api-dotnet-core-build-app.md
           - text: More build and integrate guides

articles/active-directory/external-identities/customers/media/how-to-web-app-dotnet-sign-in-sign-in-out/display-aspnet-welcome.png renamed to articles/active-directory/external-identities/customers/media/tutorial-web-app-dotnet-sign-in-sign-in-out/display-aspnet-welcome.png

@@ -17,7 +17,7 @@ ms.custom: developer, devx-track-dotnet
 
 # Sign in users for a sample ASP.NET web app in an Azure AD for customers tenant
 
-This how-to guide uses a sample ASP.NET web application to show the fundamentals of modern authentication using the [Microsoft Authentication Library for .NET](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet) and [Microsoft Identity Web](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-node) for ASP.NET to handle authentication.
+This how-to guide uses a sample ASP.NET web application to show the fundamentals of modern authentication using the [Microsoft Authentication Library for .NET](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet) and [Microsoft Identity Web](https://github.com/AzureAD/microsoft-identity-web/) for ASP.NET to handle authentication.
 
 In this article, you'll register a web application in the Microsoft Entra admin center and create a sign in and sign out user flow. You'll associate your web application with the user flow, download and update a sample ASP.NET web application using your own Azure Active Directory (Azure AD) for customers tenant details. Finally, you'll run and test the sample web application.
 
@@ -89,7 +89,7 @@ To get the web app sample code, you can do either of the following tasks:
 
 1. Once signed in the display name is shown next to the **Sign out** button as shown in the following screenshot.
 
-    :::image type="content" source="media/how-to-web-app-dotnet-sign-in-sign-in-out/display-aspnet-welcome.png" alt-text="Screenshot of sign in into a ASP.NET web app.":::
+    :::image type="content" source="media/tutorial-web-app-dotnet-sign-in-sign-in-out/display-aspnet-welcome.png" alt-text="Screenshot of sign in into a ASP.NET web app.":::
 
 1. To sign-out from the application, select the **Sign out** button.
 
@@ -98,4 +98,4 @@ To get the web app sample code, you can do either of the following tasks:
 - [Enable password reset](how-to-enable-password-reset-customers.md)
 - [Customize the default branding](how-to-customize-branding-customers.md)
 - [Configure sign-in with Google](how-to-google-federation-customers.md)
-- [Sign in users in your own ASP.NET web application by using an Azure AD for customers tenant](how-to-web-app-dotnet-sign-in-prepare-app.md)
+- [Sign in users in your own ASP.NET web application by using an Azure AD for customers tenant](tutorial-web-app-dotnet-sign-in-prepare-app.md)

articles/active-directory/external-identities/customers/sample-web-app-dotnet-sign-in.md

@@ -43,7 +43,7 @@ These samples and how-to guides demonstrate how to write a web application that
 > | Language/<br/>Platform | Code sample guide | Build and integrate guide  |
 > | ------- | -------- | ------------- | 
 > | JavaScript, Node.js (Express) | &#8226; [Sign in users](./sample-web-app-node-sign-in.md)<br/> &#8226; [Sign in users and call an API](./sample-web-app-node-sign-in-call-api.md)  |  &#8226; [Sign in users](tutorial-web-app-node-sign-in-prepare-tenant.md)<br/> &#8226; [Sign in users and call an API](how-to-web-app-node-sign-in-call-api-overview.md)  |
-> | ASP.NET Core | &#8226; [Sign in users](./sample-web-app-dotnet-sign-in.md)   | &#8226; [Sign in users](how-to-web-app-dotnet-sign-in-prepare-tenant.md)   |
+> | ASP.NET Core | &#8226; [Sign in users](./sample-web-app-dotnet-sign-in.md)   | &#8226; [Sign in users](tutorial-web-app-dotnet-sign-in-prepare-tenant.md)   |
 
 ### Web API
 
@@ -112,7 +112,7 @@ These samples and how-to guides demonstrate how to write a daemon application th
 > | App type | Code sample guide | Build and integrate guide  |
 > | ------- | -------- | ------------- | 
 > | Web API| ---  | &#8226; [Secure an ASP.NET web API](tutorial-protect-web-api-dotnet-core-build-app.md)   |
-> | Web app | &#8226; [Sign in users](./sample-web-app-dotnet-sign-in.md)   | &#8226; [Sign in users](how-to-web-app-dotnet-sign-in-prepare-tenant.md)   |
+> | Web app | &#8226; [Sign in users](sample-web-app-dotnet-sign-in.md)   | &#8226; [Sign in users](tutorial-web-app-dotnet-sign-in-prepare-tenant.md)   |
 
 ### .NET (MAUI)
 

articles/active-directory/external-identities/customers/samples-ciam-all.md

@@ -144,11 +144,11 @@ items:
               - name: Sign in users
                 items:
                   - name: Prepare tenant
-                    href: how-to-web-app-dotnet-sign-in-prepare-tenant.md
+                    href: tutorial-web-app-dotnet-sign-in-prepare-tenant.md
                   - name: Prepare app
-                    href: how-to-web-app-dotnet-sign-in-prepare-app.md
+                    href: tutorial-web-app-dotnet-sign-in-prepare-app.md
                   - name: Sign in and sign out
-                    href: how-to-web-app-dotnet-sign-in-sign-out.md
+                    href: tutorial-web-app-dotnet-sign-in-sign-out.md
       - name: Web API
         items: 
           - name: Protect ASP.NET API

articles/active-directory/external-identities/customers/toc.yml

@@ -16,7 +16,7 @@ ms.date: 05/23/2023
 
 # Tutorial: Prepare an ASP.NET web app for authentication in a customer tenant
 
-In the [previous article](./how-to-web-app-dotnet-sign-in-prepare-tenant.md), you registered an application and configured user flows in your Azure Active Directory (Azure AD) for customers tenant.
+In the [previous article](./tutorial-web-app-dotnet-sign-in-prepare-tenant.md), you registered an application and configured user flows in your Azure Active Directory (Azure AD) for customers tenant.
 
 In this tutorial you'll;
 
@@ -28,7 +28,7 @@ In this tutorial you'll;
 
 ## Prerequisites
 
-* Completion of the prerequisites and steps in [Prepare your customer tenant for building an ASP.NET web app](./how-to-web-app-dotnet-sign-in-prepare-tenant.md).
+* Completion of the prerequisites and steps in [Prepare your customer tenant for building an ASP.NET web app](./tutorial-web-app-dotnet-sign-in-prepare-tenant.md).
 * Although any integrated development environment (IDE) that supports ASP.NET applications can be used, this tutorial uses **Visual Studio Code**. You can download it [here](https://visualstudio.microsoft.com/downloads/).
 * [.NET 7.0 SDK](https://dotnet.microsoft.com/download/dotnet).
 
@@ -83,7 +83,7 @@ Identity related NuGet packages must be installed in the project to authenticate
 
     * `Authority` - The identity provider instance and sign-in audience for the app. Replace `Enter_the_Tenant_Subdomain_Here` with the sub-domain of your customer tenant. To find this, select **Overview** in the sidebar menu, then switch to the **Overview tab**. Find the **Primary domain**, in the form *caseyjensen.onmicrosoft.com*. The sub-domain is *caseyjensen*.
     * `ClientId` - The identifier of the application, also referred to as the client. Replace the text in quotes with the **Application (client) ID** value that was recorded earlier from the overview page of the registered application.
-    * `ClientSecret` - The value of the client secret you created in [Prepare your tenant](./how-to-web-app-dotnet-sign-in-prepare-tenant.md). Replace the text in quotes with the client secret **value** in the Microsoft Entra admin center.
+    * `ClientSecret` - The value of the client secret you created in [Prepare your tenant](./tutorial-web-app-dotnet-sign-in-prepare-tenant.md). Replace the text in quotes with the client secret **value** in the Microsoft Entra admin center.
     * `CallbackPath` - Is an identifier to help the server redirect a response to the appropriate application.
     
 1. Save changes to the file.
@@ -181,4 +181,4 @@ The *Program.cs* needs to be modified to add authentication and authorization to
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Sign in and sign out](how-to-web-app-dotnet-sign-in-sign-out.md)
+> [Sign in and sign out](tutorial-web-app-dotnet-sign-in-sign-out.md)

articles/active-directory/external-identities/customers/how-to-web-app-dotnet-sign-in-prepare-app.md renamed to articles/active-directory/external-identities/customers/tutorial-web-app-dotnet-sign-in-prepare-app.md

@@ -66,4 +66,4 @@ In this tutorial, you'll;
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Prepare ASP.NET web app](how-to-web-app-dotnet-sign-in-prepare-app.md)
+> [Prepare ASP.NET web app](tutorial-web-app-dotnet-sign-in-prepare-app.md)

articles/active-directory/external-identities/customers/how-to-web-app-dotnet-sign-in-prepare-tenant.md renamed to articles/active-directory/external-identities/customers/tutorial-web-app-dotnet-sign-in-prepare-tenant.md

@@ -7,14 +7,14 @@ ms.author: cwerner
 manager: celestedg
 ms.service: active-directory
 ms.subservice: ciam
-ms.topic: how-to
+ms.topic: tutorial
 ms.date: 05/23/2023
 #Customer intent: As a dev, devops, I want to learn about how to enable authentication in my own ASP.NET web app with Azure Active Directory (Azure AD) for customers tenant.
 ---
 
 # Tutorial: Add sign-in and sign-out to an ASP.NET web application for a customer tenant
 
-In the [previous article](./how-to-web-app-dotnet-sign-in-prepare-app.md), you created an ASP.NET project in Visual Studio Code and configured it for authentication.
+In the [previous article](./tutorial-web-app-dotnet-sign-in-prepare-app.md), you created an ASP.NET project in Visual Studio Code and configured it for authentication.
 
 In this tutorial you'll:
 
@@ -25,7 +25,7 @@ In this tutorial you'll:
 
 ## Prerequisites
 
-- Completion of the prerequisites and steps in [Prepare an ASP.NET web app for authentication in a customer tenant](./how-to-web-app-dotnet-sign-in-prepare-app.md).
+- Completion of the prerequisites and steps in [Prepare an ASP.NET web app for authentication in a customer tenant](./tutorial-web-app-dotnet-sign-in-prepare-app.md).
 
 ## Add the sign-in and sign out experience
 
@@ -128,7 +128,7 @@ The web app is now configured to sign in users with the Microsoft identity platf
     1. If a window appears prompting you to **Stay signed in**, choose either **Yes** or **No**.
 1. The ASP.NET Welcome page appears in your browser as depicted in the following screenshot:
 
-    :::image type="content" source="media/how-to-web-app-dotnet-sign-in-sign-in-out/display-aspnet-welcome.png" alt-text="Screenshot of sign in into an ASP.NET web app.":::
+    :::image type="content" source="media/tutorial-web-app-dotnet-sign-in-sign-in-out/display-aspnet-welcome.png" alt-text="Screenshot of sign in into an ASP.NET web app.":::
 
 ## Sign out of the application
 

articles/active-directory/external-identities/customers/how-to-web-app-dotnet-sign-in-sign-out.md renamed to articles/active-directory/external-identities/customers/tutorial-web-app-dotnet-sign-in-sign-out.md

@@ -65,9 +65,9 @@ Welcome to what's new in Azure Active Directory for customers documentation. Thi
 - [Tutorial: Prepare a vanilla JavaScript single-page app for authentication in a customer tenant](how-to-single-page-app-vanillajs-prepare-app.md) - Fixed SPA aligning content styling
 - [Tutorial: Prepare your customer tenant to authenticate a vanilla JavaScript single-page app](how-to-single-page-app-vanillajs-prepare-tenant.md) - Fixed SPA aligning content styling
 - [Tutorial: Add sign-in and sign-out to a vanilla JavaScript single-page app for a customer tenant](how-to-single-page-app-vanillajs-sign-in-sign-out.md) - Fixed SPA aligning content styling
-- [Tutorial: Prepare your customer tenant to authenticate users in a React single-page app (SPA)](./tutorial-single-page-app-react-sign-in-prepare-tenant.md) - Fixed SPA aligning content styling
-- [Tutorial: Prepare an ASP.NET web app for authentication in a customer tenant](how-to-web-app-dotnet-sign-in-prepare-app.md) - ASP.NET web app fixes
-- [Tutorial: Prepare your customer tenant to authenticate users in an ASP.NET web app](how-to-web-app-dotnet-sign-in-prepare-tenant.md) - ASP.NET web app fixes
-- [Tutorial: Add sign-in and sign-out to an ASP.NET web application for a customer tenant](how-to-web-app-dotnet-sign-in-sign-out.md) - ASP.NET web app fixes
+- [Tutorial: Prepare your customer tenant to authenticate users in a React single-page app (SPA)](tutorial-single-page-app-react-sign-in-prepare-tenant.md) - Fixed SPA aligning content styling
+- [Tutorial: Prepare an ASP.NET web app for authentication in a customer tenant](tutorial-web-app-dotnet-sign-in-prepare-app.md) - ASP.NET web app fixes
+- [Tutorial: Prepare your customer tenant to authenticate users in an ASP.NET web app](tutorial-web-app-dotnet-sign-in-prepare-tenant.md) - ASP.NET web app fixes
+- [Tutorial: Add sign-in and sign-out to an ASP.NET web application for a customer tenant](tutorial-web-app-dotnet-sign-in-sign-out.md) - ASP.NET web app fixes
 - [Collect user attributes during sign-up](how-to-define-custom-attributes.md) - Added a step for the Show more attributes pane and custom attributes
 - [Manage Azure Active Directory for customers resources with Microsoft Graph](microsoft-graph-operations.md) - Combined Graph API references into one doc