ASP.NET Core 简介 Identity

作者:Rick Anderson

ASP.NET Core Identity:

  • 是一个 API,它支持用户界面) 登录功能 (UI。
  • 管理用户、密码、配置文件数据、角色、声明、令牌、电子邮件确认等。

用户可以使用存储在中的登录信息创建一个帐户, Identity 也可以使用外部登录提供程序。 支持的外部登录提供程序包括 Facebook、Google、Microsoft 帐户和 Twitter

有关如何全局要求所有用户进行身份验证的信息,请参阅需要通过身份验证的用户

GitHub 上提供了 Identity 源代码基架 Identity 并查看生成的文件以查看与的模板交互 Identity 。

Identity 通常使用 SQL Server 数据库配置以存储用户名、密码和配置文件数据。 另外,还可以使用另一个永久性存储,例如 Azure 表存储。

在本主题中,你将了解如何使用 Identity 注册、登录和注销用户。 注意:这些模板将用户的用户名和电子邮件视为相同。 有关创建使用的应用程序的更多详细说明 Identity ,请参阅 后续步骤

Microsoft 标识平台 是:

  • ) 开发人员平台 Azure AD Azure Active Directory (的演变。
  • 与无关 ASP.NET Core Identity 。

ASP.NET Core Identity 将用户界面 (UI) 登录功能添加到 ASP.NET Core Web 应用。 若要保护 Web API 和 SPA,请使用以下项之一:

IdentityServer4 是适用于 ASP.NET Core 的 OpenID Connect 和 OAuth 2.0 框架。 IdentityServer4 支持以下安全功能:

  • 身份验证即服务 (AaaS)
  • 跨多个应用程序类型的单一登录/注销 (SSO)
  • API 的访问控制
  • Federation Gateway

有关详细信息,请参阅欢迎使用 IdentityServer4

查看或下载示例代码 (如何下载) 。

创建具有身份验证的 Web 应用

使用单个 ASP.NET 创建一个 Core Web 应用程序项目。

  • 选择 "文件 > "" > 新建项目"。
  • 选择“ASP.NET Core Web 应用程序”。 将项目 WebApp1 命名,以与项目下载具有相同的命名空间。 单击“确定”。
  • 选择"ASP.NET Web 应用程序", 然后选择"更改身份验证"。
  • 选择 "单个用户帐户", 然后单击"确定 "。

生成的项目以 ASP.NET Core Identity 类库 Razor 提供。 类 Identity Razor 库使用 区域公开 Identity 终结点。 例如:

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

应用迁移

应用迁移以初始化数据库。

在 PMC 控制台程序包管理器中 (以下) :

PM> Update-Database

测试注册和登录

运行应用并注册用户。 根据屏幕大小,可能需要选择导航切换按钮才能看到"注册 " 和"登录 " 链接。

查看 Identity 数据库

  • 从 " 视图 " 菜单中选择 " SQL Server 对象资源管理器 (SSOX) "。
  • 导航到 (localdb) MSSQLLocalDB (SQL Server 13)。 右键单击 " dbo"。 > 查看数据 AspNetUsers:

SQL Server 对象资源管理器中的 AspNetUsers 表上的上下文菜单

配置 Identity 服务

中添加了服务 ConfigureServices 。 典型模式是调用所有 Add{Service} 方法,然后调用所有 services.Configure{Service} 方法。

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext<ApplicationDbContext>(options =>
     // options.UseSqlite(
        options.UseSqlServer(
            Configuration.GetConnectionString("DefaultConnection")));
    services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
        .AddEntityFrameworkStores<ApplicationDbContext>();
    services.AddRazorPages();

    services.Configure<IdentityOptions>(options =>
    {
        // Password settings.
        options.Password.RequireDigit = true;
        options.Password.RequireLowercase = true;
        options.Password.RequireNonAlphanumeric = true;
        options.Password.RequireUppercase = true;
        options.Password.RequiredLength = 6;
        options.Password.RequiredUniqueChars = 1;

        // Lockout settings.
        options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(5);
        options.Lockout.MaxFailedAccessAttempts = 5;
        options.Lockout.AllowedForNewUsers = true;

        // User settings.
        options.User.AllowedUserNameCharacters =
        "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._@+";
        options.User.RequireUniqueEmail = false;
    });

    services.ConfigureApplicationCookie(options =>
    {
        // Cookie settings
        options.Cookie.HttpOnly = true;
        options.ExpireTimeSpan = TimeSpan.FromMinutes(5);

        options.LoginPath = "/Identity/Account/Login";
        options.AccessDeniedPath = "/Identity/Account/AccessDenied";
        options.SlidingExpiration = true;
    });
}

前面突出显示的代码 Identity 用默认选项值进行配置。 服务通过 依赖关系注入提供给应用程序。

Identity 通过调用启用 UseAuthenticationUseAuthentication 将身份验证 中间件 添加到请求管道。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseDatabaseErrorPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();

    app.UseRouting();

    app.UseAuthentication();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapRazorPages();
    });
}
public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext<ApplicationDbContext>(options =>
        // options.UseSqlite(
        options.UseSqlServer(
            Configuration.GetConnectionString("DefaultConnection")));
    services.AddDatabaseDeveloperPageExceptionFilter();
    services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
        .AddEntityFrameworkStores<ApplicationDbContext>();
    services.AddRazorPages();

    services.Configure<IdentityOptions>(options =>
    {
        // Password settings.
        options.Password.RequireDigit = true;
        options.Password.RequireLowercase = true;
        options.Password.RequireNonAlphanumeric = true;
        options.Password.RequireUppercase = true;
        options.Password.RequiredLength = 6;
        options.Password.RequiredUniqueChars = 1;

        // Lockout settings.
        options.Lockout.DefaultLockoutTimeSpan = TimeSpan.FromMinutes(5);
        options.Lockout.MaxFailedAccessAttempts = 5;
        options.Lockout.AllowedForNewUsers = true;

        // User settings.
        options.User.AllowedUserNameCharacters =
        "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._@+";
        options.User.RequireUniqueEmail = false;
    });

    services.ConfigureApplicationCookie(options =>
    {
        // Cookie settings
        options.Cookie.HttpOnly = true;
        options.ExpireTimeSpan = TimeSpan.FromMinutes(5);

        options.LoginPath = "/Identity/Account/Login";
        options.AccessDeniedPath = "/Identity/Account/AccessDenied";
        options.SlidingExpiration = true;
    });
}

前面的代码 Identity 用默认选项值进行配置。 服务通过 依赖关系注入提供给应用程序。

Identity 通过调用 UseAuthentication启用。 UseAuthentication 将身份验证 中间件 添加到请求管道。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseMigrationsEndPoint();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();

    app.UseRouting();

    app.UseAuthentication();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapRazorPages();
    });
}

模板生成的应用不使用 授权app.UseAuthorization 包括,以确保在应用添加授权时,按正确的顺序添加。 UseRoutingUseAuthenticationUseAuthorizationUseEndpoints 必须按前面的代码中所示的顺序调用。

有关和的详细 IdentityOptions 信息 Startup ,请参阅 IdentityOptions应用程序启动

基架注册、登录、注销和 RegisterConfirmation

添加 RegisterLoginLogOutRegisterConfirmation 文件。 将 基架标识置于 Razor 具有授权 说明的项目中,以生成本部分中所示的代码。

检查注册

当用户单击页面上的 " 注册 " 按钮时 Register ,将 RegisterModel.OnPostAsync 调用该操作。 用户由 CreateAsync 在对象上创建 _userManager

public async Task<IActionResult> OnPostAsync(string returnUrl = null)
{
    returnUrl = returnUrl ?? Url.Content("~/");
    ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync())
                                          .ToList();
    if (ModelState.IsValid)
    {
        var user = new IdentityUser { UserName = Input.Email, Email = Input.Email };
        var result = await _userManager.CreateAsync(user, Input.Password);
        if (result.Succeeded)
        {
            _logger.LogInformation("User created a new account with password.");

            var code = await _userManager.GenerateEmailConfirmationTokenAsync(user);
            code = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(code));
            var callbackUrl = Url.Page(
                "/Account/ConfirmEmail",
                pageHandler: null,
                values: new { area = "Identity", userId = user.Id, code = code },
                protocol: Request.Scheme);

            await _emailSender.SendEmailAsync(Input.Email, "Confirm your email",
                $"Please confirm your account by <a href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking here</a>.");

            if (_userManager.Options.SignIn.RequireConfirmedAccount)
            {
                return RedirectToPage("RegisterConfirmation", 
                                      new { email = Input.Email });
            }
            else
            {
                await _signInManager.SignInAsync(user, isPersistent: false);
                return LocalRedirect(returnUrl);
            }
        }
        foreach (var error in result.Errors)
        {
            ModelState.AddModelError(string.Empty, error.Description);
        }
    }

    // If we got this far, something failed, redisplay form
    return Page();
}

禁用默认帐户验证

使用默认模板时,会将用户重定向到用户 Account.RegisterConfirmation 可以在其中选择要确认帐户的链接。 默认值 Account.RegisterConfirmation 用于测试,应在生产应用中禁用自动帐户验证。

若要在注册时要求确认帐户并阻止立即登录,请 DisplayConfirmAccountLink = false/Areas/ Identity /Pages/Account/RegisterConfirmation.cshtml.cs 中设置:

[AllowAnonymous]
public class RegisterConfirmationModel : PageModel
{
    private readonly UserManager<IdentityUser> _userManager;
    private readonly IEmailSender _sender;

    public RegisterConfirmationModel(UserManager<IdentityUser> userManager, IEmailSender sender)
    {
        _userManager = userManager;
        _sender = sender;
    }

    public string Email { get; set; }

    public bool DisplayConfirmAccountLink { get; set; }

    public string EmailConfirmationUrl { get; set; }

    public async Task<IActionResult> OnGetAsync(string email, string returnUrl = null)
    {
        if (email == null)
        {
            return RedirectToPage("/Index");
        }

        var user = await _userManager.FindByEmailAsync(email);
        if (user == null)
        {
            return NotFound($"Unable to load user with email '{email}'.");
        }

        Email = email;
        // Once you add a real email sender, you should remove this code that lets you confirm the account
        DisplayConfirmAccountLink = false;
        if (DisplayConfirmAccountLink)
        {
            var userId = await _userManager.GetUserIdAsync(user);
            var code = await _userManager.GenerateEmailConfirmationTokenAsync(user);
            code = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(code));
            EmailConfirmationUrl = Url.Page(
                "/Account/ConfirmEmail",
                pageHandler: null,
                values: new { area = "Identity", userId = userId, code = code, returnUrl = returnUrl },
                protocol: Request.Scheme);
        }

        return Page();
    }
}

登录

当出现以下情况时,将显示登录窗体:

  • 选择 " 登录 " 链接。
  • 用户尝试访问他们无权访问的受限制的页面, 未经系统的身份验证。

提交登录页上的窗体时,将 OnPostAsync 调用该操作。 PasswordSignInAsync_signInManager 对象调用。

public async Task<IActionResult> OnPostAsync(string returnUrl = null)
{
    returnUrl = returnUrl ?? Url.Content("~/");

    if (ModelState.IsValid)
    {
        // This doesn't count login failures towards account lockout
        // To enable password failures to trigger account lockout, 
        // set lockoutOnFailure: true
        var result = await _signInManager.PasswordSignInAsync(Input.Email,
                           Input.Password, Input.RememberMe, lockoutOnFailure: true);
        if (result.Succeeded)
        {
            _logger.LogInformation("User logged in.");
            return LocalRedirect(returnUrl);
        }
        if (result.RequiresTwoFactor)
        {
            return RedirectToPage("./LoginWith2fa", new
            {
                ReturnUrl = returnUrl,
                RememberMe = Input.RememberMe
            });
        }
        if (result.IsLockedOut)
        {
            _logger.LogWarning("User account locked out.");
            return RedirectToPage("./Lockout");
        }
        else
        {
            ModelState.AddModelError(string.Empty, "Invalid login attempt.");
            return Page();
        }
    }

    // If we got this far, something failed, redisplay form
    return Page();
}

有关如何做出授权决策的信息,请参阅 ASP.NET Core 中的授权简介

注销

" 注销 " 链接将调用该 LogoutModel.OnPost 操作。

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Identity;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.Extensions.Logging;
using System.Threading.Tasks;

namespace WebApp1.Areas.Identity.Pages.Account
{
    [AllowAnonymous]
    public class LogoutModel : PageModel
    {
        private readonly SignInManager<IdentityUser> _signInManager;
        private readonly ILogger<LogoutModel> _logger;

        public LogoutModel(SignInManager<IdentityUser> signInManager, ILogger<LogoutModel> logger)
        {
            _signInManager = signInManager;
            _logger = logger;
        }

        public void OnGet()
        {
        }

        public async Task<IActionResult> OnPost(string returnUrl = null)
        {
            await _signInManager.SignOutAsync();
            _logger.LogInformation("User logged out.");
            if (returnUrl != null)
            {
                return LocalRedirect(returnUrl);
            }
            else
            {
                return RedirectToPage();
            }
        }
    }
}

在前面的代码中,代码 return RedirectToPage(); 需要是重定向,以便浏览器执行新请求并更新用户的标识。

SignOutAsync 清除存储在中的用户声明 cookie 。

Post 在 Pages/Shared/_LoginPartial 中指定。 cshtml

@using Microsoft.AspNetCore.Identity
@inject SignInManager<IdentityUser> SignInManager
@inject UserManager<IdentityUser> UserManager

<ul class="navbar-nav">
@if (SignInManager.IsSignedIn(User))
{
    <li class="nav-item">
        <a  class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Manage/Index" 
                                              title="Manage">Hello @User.Identity.Name!</a>
    </li>
    <li class="nav-item">
        <form class="form-inline" asp-area="Identity" asp-page="/Account/Logout" 
                                  asp-route-returnUrl="@Url.Page("/", new { area = "" })" 
                                  method="post" >
            <button  type="submit" class="nav-link btn btn-link text-dark">Logout</button>
        </form>
    </li>
}
else
{
    <li class="nav-item">
        <a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Register">Register</a>
    </li>
    <li class="nav-item">
        <a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Login">Login</a>
    </li>
}
</ul>

考试 Identity

默认 web 项目模板允许匿名访问主页。 若要测试 Identity ,请添加 [Authorize]

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.Extensions.Logging;

namespace WebApp1.Pages
{
    [Authorize]
    public class PrivacyModel : PageModel
    {
        private readonly ILogger<PrivacyModel> _logger;

        public PrivacyModel(ILogger<PrivacyModel> logger)
        {
            _logger = logger;
        }

        public void OnGet()
        {
        }
    }
}

如果已登录,请注销。运行应用并选择 Privacy 链接。 将被重定向到登录页。

浏览 Identity

若要 Identity 更详细地了解,请:

Identity 组件

所有 Identity 依赖 的 NuGet 包都包含在 ASP.NET Core 共享框架 中

的主要包是 Identity Microsoft.AspNetCore。 Identity 此包包含 的核心接口集,由 ASP.NET Core Identity 包含 Microsoft.AspNetCore.Identity.EntityFrameworkCore

迁移到 ASP.NET Core Identity

有关迁移现有存储的信息和指导 Identity ,请参阅迁移身份验证 Identity 和

设置密码强度

有关 设置 最低密码要求的示例,请参阅配置。

AddDefault Identity 和 AddIdentity

AddDefaultIdentity 在 ASP.NET Core 2.1 中引入了 。 调用 AddDefaultIdentity 类似于调用以下内容:

有关详细信息 ,请参阅 Identity AddDefault 源。

防止发布静态 Identity 资产

若要防止将 (UI 的样式表和 JavaScript) 发布到 Web 根目录,请添加以下属性和目标到 Identity Identity ResolveStaticWebAssetsInputsDependsOn RemoveIdentityAssets 应用的项目文件:

<PropertyGroup>
  <ResolveStaticWebAssetsInputsDependsOn>RemoveIdentityAssets</ResolveStaticWebAssetsInputsDependsOn>
</PropertyGroup>

<Target Name="RemoveIdentityAssets">
  <ItemGroup>
    <StaticWebAsset Remove="@(StaticWebAsset)" Condition="%(SourceId) == 'Microsoft.AspNetCore.Identity.UI'" />
  </ItemGroup>
</Target>

后续步骤

作者:Rick Anderson

ASP.NET Core Identity 是一个成员身份系统,用于将登录功能添加到 ASP.NET Core 应用。 用户可以创建一个帐户,该帐户包含存储在 中的登录信息 Identity ,或者可以使用外部登录提供程序。 支持的外部登录提供程序包括 Facebook、Google、Microsoft 帐户和 Twitter

Identity 可以使用 SQL Server 数据库配置以存储用户名、密码和配置文件数据。 另外,还可以使用另一个永久性存储,例如 Azure 表存储。

查看或下载示例代码 (如何下载) 。

在本主题中,你将了解如何使用 Identity 注册、登录和注销用户。 有关创建使用的应用程序的更多详细说明 Identity ,请参阅本文末尾的后续步骤部分。

AddDefault Identity 并添加Identity

AddDefaultIdentity 是在 ASP.NET Core 2.1 中引入的。 调用 AddDefaultIdentity 类似于调用以下内容:

有关详细信息,请参阅 AddDefault Identity 源

创建具有身份验证的 Web 应用

使用单独的用户帐户创建 ASP.NET Core Web 应用程序项目。

  • 选择 " 文件" " > 新建 > 项目"。
  • 选择“ASP.NET Core Web 应用程序”。 将项目命名为 WebApp1 ,使其命名空间与项目下载相同。 单击“确定”。
  • 选择 ASP.NET Core Web 应用程序,然后选择 " 更改身份验证"。
  • 选择 单个用户帐户 ,然后单击 "确定"

生成的项目 ASP.NET Core Identity 以类库形式 Razor 提供。 类库 Identity Razor 公开的终结点 Identity 。 例如:

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

应用迁移

应用迁移以初始化数据库。

在包管理器控制台中运行以下命令 (PMC) :

Update-Database

测试注册和登录

运行应用并注册用户。 根据屏幕大小,你可能需要选择 "导航" 切换按钮以查看 " 寄存器 " 和 " 登录 " 链接。

查看 Identity 数据库

  • 从 " 视图 " 菜单中选择 " SQL Server 对象资源管理器 (SSOX) "。
  • 导航到 (localdb) MSSQLLocalDB (SQL Server 13)。 右键单击 " dbo"。 > 查看数据 AspNetUsers:

SQL Server 对象资源管理器中的 AspNetUsers 表上的上下文菜单

配置 Identity 服务

中添加了服务 ConfigureServices 。 典型模式是调用所有 Add{Service} 方法,然后调用所有 services.Configure{Service} 方法。

前面的代码 Identity 用默认选项值进行配置。 服务通过 依赖关系注入提供给应用程序。

Identity 通过调用 UseAuthentication启用。 UseAuthentication 将身份验证 中间件 添加到请求管道。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseDatabaseErrorPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();
    app.UseCookiePolicy();

    app.UseAuthentication();

    app.UseMvc();
}

有关详细信息,请参阅 Identity Options 类应用程序启动

基架注册、登录和注销

基架标识置于 Razor 具有授权 说明的项目中,以生成本部分中所示的代码。

添加注册、登录和注销文件。

检查寄存器

当用户单击"注册 "链接RegisterModel.OnPostAsync ,将调用操作。 用户由 CreateAsync 在 对象 _userManager 上创建:

public async Task<IActionResult> OnPostAsync(string returnUrl = null)
{
    returnUrl = returnUrl ?? Url.Content("~/");
    if (ModelState.IsValid)
    {
        var user = new IdentityUser { UserName = Input.Email, Email = Input.Email };
        var result = await _userManager.CreateAsync(user, Input.Password);
        if (result.Succeeded)
        {
            _logger.LogInformation("User created a new account with password.");

            var code = await _userManager.GenerateEmailConfirmationTokenAsync(user);
            var callbackUrl = Url.Page(
                "/Account/ConfirmEmail",
                pageHandler: null,
                values: new { userId = user.Id, code = code },
                protocol: Request.Scheme);

            await _emailSender.SendEmailAsync(Input.Email, "Confirm your email",
                $"Please confirm your account by <a href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking here</a>.");

            await _signInManager.SignInAsync(user, isPersistent: false);
            return LocalRedirect(returnUrl);
        }
        foreach (var error in result.Errors)
        {
            ModelState.AddModelError(string.Empty, error.Description);
        }
    }

    // If we got this far, something failed, redisplay form
    return Page();
}

如果已成功创建用户,则用户通过调用 登录 _signInManager.SignInAsync

注意: 有关 防止在注册时 立即登录的步骤,请参阅帐户确认。

登录

当以下项时,将显示"登录"窗体:

  • 选择"登录 "链接。
  • 用户尝试访问他们无权访问的受限页面,或者他们未通过系统身份验证时。

提交"登录"页上的表单时 OnPostAsync ,将调用 操作。 PasswordSignInAsync 对 对象调用 _signInManager

public async Task<IActionResult> OnPostAsync(string returnUrl = null)
{
    returnUrl = returnUrl ?? Url.Content("~/");

    if (ModelState.IsValid)
    {
        // This doesn't count login failures towards account lockout
        // To enable password failures to trigger account lockout, 
        // set lockoutOnFailure: true
        var result = await _signInManager.PasswordSignInAsync(Input.Email, 
            Input.Password, Input.RememberMe, lockoutOnFailure: true);
        if (result.Succeeded)
        {
            _logger.LogInformation("User logged in.");
            return LocalRedirect(returnUrl);
        }
        if (result.RequiresTwoFactor)
        {
            return RedirectToPage("./LoginWith2fa", new { ReturnUrl = returnUrl, RememberMe = Input.RememberMe });
        }
        if (result.IsLockedOut)
        {
            _logger.LogWarning("User account locked out.");
            return RedirectToPage("./Lockout");
        }
        else
        {
            ModelState.AddModelError(string.Empty, "Invalid login attempt.");
            return Page();
        }
    }

    // If we got this far, something failed, redisplay form
    return Page();
}

若要了解如何做出授权决策,请参阅 ASP.NET Core 中的授权简介

注销

注销 链接 调用 LogoutModel.OnPost 操作。

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Identity;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.Extensions.Logging;
using System.Threading.Tasks;

namespace WebApp1.Areas.Identity.Pages.Account
{
    [AllowAnonymous]
    public class LogoutModel : PageModel
    {
        private readonly SignInManager<IdentityUser> _signInManager;
        private readonly ILogger<LogoutModel> _logger;

        public LogoutModel(SignInManager<IdentityUser> signInManager, ILogger<LogoutModel> logger)
        {
            _signInManager = signInManager;
            _logger = logger;
        }

        public void OnGet()
        {
        }

        public async Task<IActionResult> OnPost(string returnUrl = null)
        {
            await _signInManager.SignOutAsync();
            _logger.LogInformation("User logged out.");
            if (returnUrl != null)
            {
                return LocalRedirect(returnUrl);
            }
            else
            {
                // This needs to be a redirect so that the browser performs a new
                // request and the identity for the user gets updated.
                return RedirectToPage();
            }
        }
    }
}

SignOutAsync 清除存储在 中的用户声明 cookie 。

Post 在 Pages/Shared/_LoginPartial.cshtml 中指定

@using Microsoft.AspNetCore.Identity
@inject SignInManager<IdentityUser> SignInManager
@inject UserManager<IdentityUser> UserManager

<ul class="navbar-nav">
    @if (SignInManager.IsSignedIn(User))
    {
        <li class="nav-item">
            <a class="nav-link text-dark" asp-area="Identity"
               asp-page="/Account/Manage/Index"
               title="Manage">Hello@User.Identity.Name!</a>
        </li>
        <li class="nav-item">
            <form class="form-inline" asp-area="Identity" asp-page="/Account/Logout" 
                   asp-route-returnUrl="@Url.Page("/", new { area = "" })" 
                   method="post">
                <button type="submit" class="nav-link btn btn-link text-dark">Logout</button>
            </form>
        </li>
    }
    else
    {
        <li class="nav-item">
            <a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Register">Register</a>
        </li>
        <li class="nav-item">
            <a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Login">Login</a>
        </li>
    }
</ul>


测试 Identity

默认 Web 项目模板允许匿名访问主页。 若要测试 Identity ,请 [Authorize] 添加到 Privacy 页面。

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc.RazorPages;

namespace WebApp1.Pages
{
    [Authorize]
    public class PrivacyModel : PageModel
    {
        public void OnGet()
        {
        }
    }
}

如果已登录,请注销。运行应用并选择 Privacy 链接。 将被重定向到登录页。

浏览 Identity

Identity了解更多详细信息:

Identity 组分

所有 Identity 相关 NuGet 包都包含在 Microsoft.AspNetCore.App 元包中。

的主包为 Identity AspNetCore。 Identity 此包包含的核心接口集 ASP.NET Core Identity ,由提供 Microsoft.AspNetCore.Identity.EntityFrameworkCore

迁移到 ASP.NET Core Identity

有关迁移现有存储的详细信息和指南 Identity ,请参阅迁移身份验证 Identity 和

设置密码强度

有关设置最小密码要求的示例,请参阅 配置

后续步骤