Focus Identity on BWAs

Author: guardrex

aspnetcore/security/authentication/identity.md

@@ -11,8 +11,6 @@ uid: security/authentication/identity
 
 :::moniker range=">= aspnetcore-8.0"
 
-By [Rick Anderson](https://twitter.com/RickAndMSFT)
-
 ASP.NET Core Identity:
 
 * Is an API that supports user interface (UI) login functionality.
@@ -28,6 +26,8 @@ Identity is typically configured using a SQL Server database to store user names
 
 In this topic, you learn how to use Identity to register, log in, and log out a user. Note: the templates treat username and email as the same for users. For more detailed instructions about creating apps that use Identity, see [Next Steps](#next).
 
+For more information on Identity in Blazor apps, see <xref:blazor/security/index> and the articles that follow it in the Blazor documentation.
+
 ASP.NET Core Identity isn't related to the [Microsoft identity platform](/azure/active-directory/develop/). Microsoft identity platform is:
 
 * An evolution of the Azure Active Directory (Azure AD) developer platform.
@@ -39,7 +39,49 @@ ASP.NET Core Identity isn't related to the [Microsoft identity platform](/azure/
 
 <a name="adi"></a>
 
-## Create a Web app with authentication
+## Create a Blazor Web App with authentication
+
+Create an ASP.NET Core Blazor Web App project with Individual Accounts.
+
+> [!NOTE]
+> For a Razor Pages experience, see the [Create a Razor Pages app with authentication](#create-a-razor-pages-app-with-authentication) section.
+
+# [Visual Studio](#tab/visual-studio)
+
+* Select the **Blazor Web App** template and select **Next**. Name the project **BlazorApp1** to have the same namespace as the project download. Select **Next**.
+* Make the following selections:
+  * **Authentication type**: **Individual Accounts**
+  * **Interactive render mode**: **Server**
+  * **Interactivity Location**: **Global**
+* Select **Create**.
+
+# [.NET CLI](#tab/net-cli)
+
+```dotnetcli
+dotnet new blazor -au Individual -o BlazorApp1
+```
+
+The preceding command creates a Blazor Web App using SQLite. To create the web app with LocalDB, run the following command:
+
+```dotnetcli
+dotnet new blazor -au Individual -uld -o BlazorApp1
+```
+
+---
+
+The generated project includes Identity Razor components. The components are found in the `Components/Account` folder of the project. For example:
+
+* `/Components/Account/Pages/Register`
+* `/Components/Account/Pages/Login`
+* `/Components/Account/Pages/ChangePassword`
+
+Blazor Identity components can be viewed in the [Blazor project template ASP.NET Core reference source (`dotnet/aspnetcore` GitHub repository)](https://github.com/dotnet/aspnetcore/tree/main/src/ProjectTemplates/Web.ProjectTemplates/content/BlazorWeb-CSharp/BlazorWeb-CSharp/Components/Account).
+
+[!INCLUDE[](~/includes/aspnetcore-repo-ref-source-links.md)]
+
+For more information, see <xref:blazor/security/index> and the articles that follow it in the Blazor documentation. Most of the articles in the *Security and Identity* area of the main ASP.NET Core documentation set apply to Blazor apps. However, the Blazor documentation set contains articles and guidance that supercedes or adds information. We recommend studying the general ASP.NET Core documentation set first, followed by accessing the articles in the Blazor *Security and Identity* documentation.
+
+## Create a Razor Pages app with authentication
 
 Create an ASP.NET Core Web Application project with Individual Accounts.
 
@@ -64,9 +106,11 @@ dotnet new webapp --auth Individual -uld -o WebApp1
 
 The generated project provides [ASP.NET Core Identity](xref:security/authentication/identity) as a [Razor class library](xref:razor-pages/ui-class). The Identity Razor class library exposes endpoints with the `Identity` area. For example:
 
-* /Identity/Account/Login
-* /Identity/Account/Logout
-* /Identity/Account/Manage
+* `/Identity/Account/Login`
+* `/Identity/Account/Logout`
+* `/Identity/Account/Manage`
+
+Pages are described individually in the documentation for specific use cases and are subject to change each release. To view all of the pages, see the [ASP.NET Core reference source (`dotnet/aspnetcore` GitHub repository, `Identity/UI/src/Areas/Identity/Pages` folder)](https://github.com/dotnet/aspnetcore/tree/main/src/Identity/UI/src/Areas/Identity/Pages).
 
 ### Apply migrations
 
@@ -243,10 +287,11 @@ To prevent publishing static Identity assets (stylesheets and JavaScript files f
 
 ## Next Steps
 
+* <xref:blazor/security/index>
 * [ASP.NET Core Identity source code](https://github.com/dotnet/aspnetcore/tree/main/src/Identity)
 * [How to work with Roles in ASP.NET Core Identity](https://www.yogihosting.com/aspnet-core-identity-roles/)
 <!-- https://github.com/dotnet/AspNetCore.Docs/issues/7114 -->
-* See [this GitHub issue](https://github.com/dotnet/AspNetCore.Docs/issues/5131) for information on configuring Identity using SQLite.
+* For information on configuring Identity using SQLite, see [How to config Identity for SQLite (`dotnet/AspNetCore.Docs` #5131)](https://github.com/dotnet/AspNetCore.Docs/issues/5131).
 * [Configure Identity](xref:security/authentication/identity-configuration)
 * <xref:security/authorization/secure-data>
 * <xref:security/authentication/add-user-data>