WebAppIdentity

Sample Web Application featuring ASP.NET Core 3 Authentication with Identity

Table of contents:

• Creating a basic Razor Pages Web app
• Creating the Web app with authentication
• Scaffold identity into a Razor project with authorization
• References

Creating a basic Razor Pages Web app

Create a Razor Pages web app with ASP.NET Core

dotnet new webapp -o WebAppIdentity

Test the application with:

dotnet run

More information can be found at the following location Create a Razor Pages web app with ASP.NET Core.

Creating the Web app with authentication

Create an ASP.NET Core Web Application project with Individual User Accounts.

dotnet new webapp --auth Individual -o WebAppIdentity

The generated project provides ASP.NET Core Identity as a Razor Class Library. The Identity Razor Class Library exposes endpoints with the Identity area. For example:

/Identity/Account/Login
/Identity/Account/Logout
/Identity/Account/Manage

Apply the migrations:

dotnet ef database update

Test the application with:

dotnet run

Identity is enabled by calling UseAuthentication. UseAuthentication adds authentication middleware to the request pipeline.

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    //...
    app.UseAuthentication();
    //...
}

The template-generated app does not use authorization. app.UseAuthorization is included to ensure it's added in the correct order should the app add authorization. UseRouting, UseAuthentication, UseAuthorization, and UseEndpoints must be called in the order shown in the preceding code.

More information can be found at the following location Create a Web app with authentication.

Scaffold identity into a Razor project with authorization

Install the ASP.NET Core scaffolder:

dotnet tool install -g dotnet-aspnet-codegenerator

Add required NuGet package references to the project (*.csproj) file. Run the following command in the project directory:

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 3.1.2
dotnet add package Microsoft.AspNetCore.Identity.EntityFrameworkCore -v 3.1.2 
dotnet add package Microsoft.AspNetCore.Identity.UI -v 3.1.2
dotnet add package Microsoft.EntityFrameworkCore.Tools -v 3.1.2

Run the Identity scaffolder with the options you want. For example, to setup identity with the default UI and the minimum number of files, run the following command:

dotnet aspnet-codegenerator identity -dc WebAppIdentity.Data.ApplicationDbContext --files "Account.Register;Account.Login"

If you run the Identity scaffolder without specifying the --files flag or the --useDefaultUI flag, all the available Identity UI pages will be created in your project.

The default web project templates allow anonymous access to the home pages. To test Identity, add [Authorize]. Specifies that the class or method that this attribute is applied to requires the specified authorization.

More information can be found at following locations Scaffold Register, Login, and LogOut and Scaffold identity into a Razor project with authorization.

References

• Create a Razor Pages web app with ASP.NET Core
• Create a Web app with authentication
• Razor Class Library