详解ASP.NET Core 之 Identity 入门（一）

下面是“详解ASP.NET Core 之 Identity 入门（一）”的完整攻略：

什么是ASP.NET Core Identity？

ASP.NET Core Identity是一个身份验证和授权框架，用于管理用户身份验证和授权。它提供了一组API和UI组件，用于注册、登录、注销、管理用户和角色等方面。

如何使用ASP.NET Core Identity？

使用ASP.NET Core Identity的基本步骤如下：

1. 安装Microsoft.AspNetCore.Identity NuGet包

在ASP.NET Core应用程序中使用Identity进行身份验证和授权，需要安装Microsoft.AspNetCore.Identity NuGet包。可以使用Visual Studio的NuGet包管理器或使用命令行工具安装。

1. 创建IdentityDbContext类

在ASP.NET Core应用程序中使用Identity进行身份验证和授权，需要创建一个IdentityDbContext类。IdentityDbContext类是DbContext类的子类，它包含了Identity相关的实体类和表。

public class ApplicationDbContext : IdentityDbContext<ApplicationUser>
{
    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) : base(options)
    {
    }
}

在上面的代码中，我们创建了一个名为ApplicationDbContext的IdentityDbContext类，并在构造函数中调用了基类的构造函数。

1. 注册Identity服务

在ASP.NET Core应用程序中使用Identity进行身份验证和授权，需要在Startup.cs文件中注册Identity服务。可以使用AddIdentity扩展方法注册Identity服务。

services.AddIdentity<ApplicationUser, IdentityRole>()
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddDefaultTokenProviders();

在上面的代码中，我们使用AddIdentity扩展方法注册Identity服务，并指定了ApplicationUser和IdentityRole作为用户和角色实体类。我们还使用AddEntityFrameworkStores方法指定了IdentityDbContext类，使用AddDefaultTokenProviders方法添加了默认的令牌提供程序。

1. 配置Identity选项

在ASP.NET Core应用程序中使用Identity进行身份验证和授权，可以配置Identity选项。可以使用IdentityOptions类配置Identity选项。

services.Configure<IdentityOptions>(options =>
{
    options.Password.RequireDigit = true;
    options.Password.RequireLowercase = true;
    options.Password.RequireUppercase = true;
    options.Password.RequireNonAlphanumeric = false;
    options.Password.RequiredLength = 8;
    options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(30);
    options.Lockout.MaxFailedAccessAttempts = 5;
    options.User.RequireUniqueEmail = true;
});

在上面的代码中，我们使用Configure扩展方法配置Identity选项。在这个示例中，我们配置了密码选项、锁定选项和用户选项。

1. 创建用户和角色

在ASP.NET Core应用程序中使用Identity进行身份验证和授权，需要创建用户和角色。可以使用UserManager和RoleManager类创建用户和角色。

var user = new ApplicationUser { UserName = "[e-mail]", Email = "[e-mail]" };
var result = await _userManager.CreateAsync(user, "P@ssw0rd");
if (result.Succeeded)
{
    await _userManager.AddToRoleAsync(user, "User");
}

var role = new IdentityRole { Name = "Admin" };
await _roleManager.CreateAsync(role);

在上面的代码中，我们使用UserManager类创建用户，并使用AddToRoleAsync方法将用户添加到角色中。我们还使用RoleManager类创建角色。

1. 使用Identity进行身份验证和授权

在ASP.NET Core应用程序中使用Identity进行身份验证和授权，可以使用SignInManager和UserManager类进行身份验证和授权。

var result = await _signInManager.PasswordSignInAsync(model.Email, model.Password, model.RememberMe, lockoutOnFailure: false);
if (result.Succeeded)
{
    return RedirectToAction("Index", "Home");
}

ModelState.AddModelError(string.Empty, "Invalid login attempt.");
return View(model);

在上面的代码中，我们使用SignInManager类进行密码身份验证。如果身份验证成功，我们将用户重定向到主页。如果身份验证失败，我们将显示错误消息。

示例一：使用Identity进行注册和登录

在这个示例中，我们将演示如何使用Identity进行注册和登录。

public class RegisterModel : PageModel
{
    private readonly UserManager<ApplicationUser> _userManager;
    private readonly SignInManager<ApplicationUser> _signInManager;

    public RegisterModel(UserManager<ApplicationUser> userManager, SignInManager<ApplicationUser> signInManager)
    {
        _userManager = userManager;
        _signInManager = signInManager;
    }

    [BindProperty]
    public InputModel Input { get; set; }

    public class InputModel
    {
        [Required]
        [EmailAddress]
        [Display(Name = "Email")]
        public string Email { get; set; }

        [Required]
        [DataType(DataType.Password)]
        [Display(Name = "Password")]
        public string Password { get; set; }

        [DataType(DataType.Password)]
        [Display(Name = "Confirm password")]
        [Compare("Password", ErrorMessage = "The password and confirmation password do not match.")]
        public string ConfirmPassword { get; set; }
    }

    public void OnGet()
    {
    }

    public async Task<IActionResult> OnPostAsync()
    {
        if (ModelState.IsValid)
        {
            var user = new ApplicationUser { UserName = Input.Email, Email = Input.Email };
            var result = await _userManager.CreateAsync(user, Input.Password);
            if (result.Succeeded)
            {
                await _signInManager.SignInAsync(user, isPersistent: false);
                return RedirectToPage("/Index");
            }
            foreach (var error in result.Errors)
            {
                ModelState.AddModelError(string.Empty, error.Description);
            }
        }

        return Page();
    }
}

public class LoginModel : PageModel
{
    private readonly SignInManager<ApplicationUser> _signInManager;

    public LoginModel(SignInManager<ApplicationUser> signInManager)
    {
        _signInManager = signInManager;
    }

    [BindProperty]
    public InputModel Input { get; set; }

    public class InputModel
    {
        [Required]
        [EmailAddress]
        public string Email { get; set; }

        [Required]
        [DataType(DataType.Password)]
        public string Password { get; set; }

        [Display(Name = "Remember me?")]
        public bool RememberMe { get; set; }
    }

    public void OnGet()
    {
    }

    public async Task<IActionResult> OnPostAsync()
    {
        if (ModelState.IsValid)
        {
            var result = await _signInManager.PasswordSignInAsync(Input.Email, Input.Password, Input.RememberMe, lockoutOnFailure: false);
            if (result.Succeeded)
            {
                return RedirectToPage("/Index");
            }
            ModelState.AddModelError(string.Empty, "Invalid login attempt.");
        }

        return Page();
    }
}

在上面的代码中，我们创建了一个名为RegisterModel的页面模型类和一个名为LoginModel的页面模型类。在RegisterModel类中，我们使用UserManager类创建用户，并使用SignInManager类进行登录。在LoginModel类中，我们使用SignInManager类进行登录。

示例二：使用Identity进行授权

在这个示例中，我们将演示如何使用Identity进行授权。

[Authorize(Roles = "Admin")]
public class AdminController : Controller
{
    public IActionResult Index()
    {
        return View();
    }
}

在上面的代码中，我们使用Authorize特性进行授权。在这个示例中，只有具有Admin角色的用户才能访问AdminController类的Index方法。