ASP.NET Core Identity Hands On（1）——Identity 初次体验

ASP.NET Core Identity是用于构建ASP.NET Core Web应用程序的成员资格系统，包括成员资格、登录和用户数据存储

这是来自于 ASP.NET Core Identity 仓库主页的官方介绍，如果你是个萌新你可能不太理解什么是成员资格，那我来解释一下，成员资格由 membership 直译而来， membership 还有会员资格、会员身份、会员全体等相关含义，我们可以将其简单直接但并非十分恰当的理解为用户管理系统

ASP.NET Core Identity（下文简称Identity），既然可以理解为用户管理系统，那么她自然是十分强大的，包含用户管理的方方面面，简单的来讲包括：

  1. 用户数据存储（使用任意你喜欢的关系型数据库，从sqllite到mysql、sqlserver等等，由Entity Framwork 支持）
  2. 登陆、注册外加身份认证（基于cookie的身份认证，如果你使用Vs那么还可以生成用于注册登录的用户界面及处理代码）
  3. 角色管理
  4. 基于声明的认证模式Claims Based Authentication（如果你不知道Claim是什么，没关系你先记住这个单词）

Ok Identity这么好，她到底长啥样？我怎么用呢，接下来我们先来做一个小小的demo体验一下，一边做，一边讲解

软件准备

  • Visual Studio 2017（越新越好，如果你没有的话就下载Vs2017社区版，安装很快速，与旧版本兼容，完全免费传送门）

动手做

打开Vs的创建新项目面板依次选择 .net core -> asp.net core web 应用程序

选择 web 应用程序（模型视图控制器）->更改身份认证->个人用户账户

在这之后默认会使用 sqlserver compact来存储用户数据

按 Ctrl+F5运行项目

注意到右上角的 register 和 login了吗？在我们选择个人身份认证的时候 Identity被自动添加到项目中，并且生成了

  • 账户控制器（AccountController 注册和登陆相关的代码都在这里）
  • 登陆注册页面（还有其它的 如：确认邮件、访问受限等等）
  • 管理控制器（ManageController 这是给注册用户用的，主要有两个功能，改密码和双因子验证）
  • Identity可不会给你生成管理员界面哦

点击 register 进入注册界面，界面看起来还不错，甚至可以直接使用，然后我们注册一个账户

当你点击 register 按钮之后，会跳转到 数据库迁移（如果你用过EF Core，那么这个概念你并不会感到陌生） 确认页面

应用迁移后，你要等一会刷新页面，在这段时间里，我建议你看看迁移页面上的信息

如果看不太懂，那么请看下图

Ok， 迁移好了之后，就会回到主页，右上角的注册登录会变成你的邮箱和注销链接，点击你的账户邮箱，先看看里面有什么

这个页面里的内容就在ManageController中，如果你不知道双因子认证Two-factor authentication是什么，没关系，在后续讲到它时再说

点一下 Send verification email链接，不用担心，不会真的发送邮件

Identity 提供了电子邮件验证功能，就是通常见到的那种，邮件中会有一个加密的链接，用于验证邮件，如何生成链接Identity已经做好了，甚至写了邮件发送的接口——IEmailSender和一个空的实现EmailSender

namespace IdentityDemo.Services
{
    public interface IEmailSender
    {
        Task SendEmailAsync(string email, string subject, string message);
    }
}

查看数据库

刚刚我们注册了一个新的用户，那么用户存哪里了？默认存储用的是sqlserver compact，接下来我们找到它，再看看Identity是如何设计用户数据，另外我自己粗浅的认为学习一个新技术最好就是先看看它把数据存成什么样了

在Vs上方的菜单里依次选择 工具->连接到数据库

Ok，默认数据库的位置是哪里？数据库叫什么名字呢？现在，先关闭这个窗口，打开项目根目录下的appsettings.json配置文件

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=aspnet-IdentityDemo-E3266F7D-D9FD-4038-9AF7-773A31FC3680;Trusted_Connection=True;MultipleActiveResultSets=true"
  },
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Warning"
    }
  }
}

可以看到我们数据库的名字叫做aspnet-IdentityDemo-E3266F7D-D9FD-4038-9AF7-773A31FC3680，而他的位置在 C:\Users\{当前登录的用户名}\下面。 再操作一次，然后点 继续 选择你的数据库文件

这可能会遇到数据库文件占用的的情况

这是因为刚刚启动的程序没有退出，如果你用的是自托管启动，那么关闭它如果用的是IISExpress，也关闭它

好了，先看看数据库里有什么吧

_EFMigrationsHistory 是 Ef的迁移历史表不必关注此表

AspNetUserClaims、AspNetRoleClaims是用户和角色的声明表，之前我们提到 Identity 是基于声明的认证模式（Claims Based Authentication）的，Claim在其中扮演者很重要的角色，甚至角色（Role）都被转换成了Claim，Claim相关会在后面专门讲解，如果你不了解它，不要着急

AspNetUsers、AspNetRoles和AspNetUserRoles存储用户和角色信息

AspNetUserTokens、AspNetUserLogins存储的是用户使用的外部登陆提供商的信息和Token，外部登陆提供商指的是像微博、QQ、微信、Google、微软这类提供 oauth 或者 openid connect 登陆的厂商。比如 segmentfault 就可以使用微博登陆

接下来就要解释下最为重要的一张表AspNetUsers

用户数据核心存储—— AspNetUsers

刚刚注册的用户的切实数据如下

博客园不支持横向滚动代码，所以我把代码都竖过来了，看着有点别扭 或者你可以到这里看具体的数据

Id
------------------------------------
d4929072-e704-447c-a9aa-e1b7f510fd37         

AccessFailedCount
-----------------
0                 

ConcurrencyStamp
------------------------------------
5765da8f-1945-40c6-8f81-97604739e5ec 

Email
-----------------
[email protected]   

EmailConfirmed
--------------
0             

LockoutEnabled
--------------
1              

LockoutEnd
----------
NULL      

NormalizedEmail
-----------------
[email protected] 

NormalizedUserName
------------------
[email protected]   

PasswordHash
------------------------------------------------------------------------------------
AQAAAAEAACcQAAAAEHQ+3Z9h0tiUsinNPs8B99skAqbXh0zcWlGWTgTVik6S85viEWQFV8TF8bRyDTW8rw==

PhoneNumber
-----------
NULL       

PhoneNumberConfirmed
--------------------
0                   

SecurityStamp
------------------------------------
a4d9c858-cc08-4ceb-8d5d-92a6cb1c40b8

TwoFactorEnabled
----------------
0               

UserName
-----------------
[email protected]

Id

主键 默认是 nvarchar(450) 但事实上是存储的Guid字符串，另外值得一提的是Id的创建时机

主键的Guid是在创建用户时在构造函数中生成的

namespace Microsoft.AspNetCore.Identity
{
    public class IdentityUser : IdentityUser<string>
    {
        public IdentityUser()
        {
            Id = Guid.NewGuid().ToString();
        }

这是一小段源代码，用来证明上述内容

也就是说它是完全随机的无序Guid，那么它可能带来的隐患就是当用户量非常大的时候，创建用户可能变慢，不过对于绝大多数情景来讲，这不太可能（有那么多的用户），当然这可能发生，所以在后续的文章里，我会讲解如何使用bigint作为主键

AccessFailedCount

这个是用来记录用户尝试登陆却登陆失败的次数，我们可以通过这个来确定在什么时候需要锁定用户，

ConcurrencyStamp

同步标记，每当用户记录被更改时必须要更改此列的值，事实上存储的是Guid，并且在创建用户模型的时候直接在属性上初始化随机值

public virtual string ConcurrencyStamp { get; set; } = Guid.NewGuid().ToString();

另外要注意，这个列的值的更改时机，它是在程序中手动编写的代码更改的，而不是由数据库更改（可能是考虑到并不是所有ef支持的数据库都支持timestamp 或者 rowversion 类型）

Email、NormalizedEmail

Email就是Email，NormalizedEmail是 规范化后的Email

什么是规范化呢？

在我们刚刚创建的用户中，可以看到 NormalizedEmail 只是将email 的值变成大写了，我想你已经有点明白了

的确，这样会提高数据库的查询效率，从Identity的代码中可以看到，关于Email的查询都转换成了对 NormalizedEmail的查询。空口无凭，我们看一小段简短的代码

namespace Microsoft.AspNetCore.Identity.EntityFrameworkCore
{
        public override Task<TUser> FindByEmailAsync(string normalizedEmail, CancellationToken cancellationToken = default(CancellationToken))
        {
            // 略...
            return Users.FirstOrDefaultAsync(u => u.NormalizedEmail == normalizedEmail, cancellationToken);
        }

NormalizedEmail在使用时你可以不用关心，你也不要去手动更改它的值，因为当用户创建或者用户资料更新的时候 NormalizedEmail都会被自动更新

然后我们依旧看一眼源代码代码

namespace Microsoft.AspNetCore.Identity
{
    public class UserManager<TUser> : IDisposable where TUser : class
    {
        public virtual async Task<IdentityResult> CreateAsync(TUser user)
        {
            // 略...
            await UpdateNormalizedUserNameAsync(user);
            await UpdateNormalizedEmailAsync(user);
            return await Store.CreateAsync(user, CancellationToken);
        }

        protected virtual async Task<IdentityResult> UpdateUserAsync(TUser user)
        {
            // 略...
            await UpdateNormalizedUserNameAsync(user);
            await UpdateNormalizedEmailAsync(user);
            return await Store.UpdateAsync(user, CancellationToken);
        }

UserName 、NormalizedUserName

UserName就是UserName NormalizedUserName 还是规范化之后的UserName，也就是转换到大写

它们的行为和上述的 Email、NormalizedEmail 一致，就不赘述了

EmailConfirmed

邮件已经确认，这是个bit（bool）类型的列，前文提到Identity含有发送和验证确认邮件的功能，在创建用户的时候这个值默认是false ，确认链接由 Identity生成，之后交由 IEmailSender发送。Ok，这里一半任务就做完了，展示一小段代码能让你更清楚这个过程

public async Task<IActionResult> Register(RegisterViewModel model, string returnUrl = null)
{
    //略...
    var user = new ApplicationUser { UserName = model.Email, Email = model.Email };
    var result = await _userManager.CreateAsync(user, model.Password);
    if (result.Succeeded)
    {
        var code = await _userManager.GenerateEmailConfirmationTokenAsync(user);
        var callbackUrl = Url.EmailConfirmationLink(user.Id, code, Request.Scheme);
        await _emailSender.SendEmailConfirmationAsync(model.Email, callbackUrl);
        略...

这些代码是创建项目时生成的，是属于你的项目而不是Identity的

你可能想到，在注册之后我们顺利的进入系统，而并没有被阻止，即便我们没有确认过邮件，数据库中的数据也指明邮件没有确认

的确，因为这已经不在Identity的范畴内了，这属于我们的程序逻辑，要不要阻止未验证邮件的用户登录，需要我们自己做，不过，很简单，只需在登陆时多写几行代码而已，这里暂时先不展开讨论

LockoutEnabled、LockoutEnd

他们的数据类型是 bit和datetimeoffset(7)，LockoutEnabled指示这个用户可不可以被锁定，LockoutEnd指定锁定的到期日期，null 或者一个过去的时间，代表这个用户没有被锁定

需要注意的是Identity为我们实现了锁定功能的基础设施，但是是否在用户锁定之后禁止用户登录是属于我们程序的逻辑的

PasswordHash

密码哈希，Identity使用的hash 强度是比较高的，暴力破解的难度十分大

=======================
HASHED PASSWORD FORMATS
=======================

Version 2:
PBKDF2 with HMAC-SHA1, 128-bit salt, 256-bit subkey, 1000 iterations.
(See also: SDL crypto guidelines v5.1, Part III)
Format: { 0x00, salt, subkey }

Version 3:
PBKDF2 with HMAC-SHA256, 128-bit salt, 256-bit subkey, 10000 iterations.
Format: { 0x01, prf (UInt32), iter count (UInt32), salt length (UInt32), salt, subkey }
(All UInt32s are stored big-endian.)

version 2和3 是为了兼容Identity V1 V2 和V3 他们的对应关系如下

  • v1 、v2 -> Version 2
  • v3 -> Version 3

SecurityStamp

安全标记,一个随机值，在用户凭据相关的内容更改时，必须更改此项的值，事实存储的是Guid

它的更改时机有：

  • 用户创建
  • 更改用户名
  • 移除外部登陆
  • 设置/更改邮件
  • 设置/更改电话号码
  • 设置/更改双因子验证
  • 更改密码

    同ConcurrencyStamp一样，SecurityStamp也是在程序中由代码控制更改的

PhoneNumber、PhoneNumberConfirmed

电话和电话已确认，比较容易理解

TwoFactorEnabled

指示当前用户是否开启了双因子验证

初次体验到此结束 :)

本文已同步发表到我的segmentfault专栏 .net core web dev

ASP.NET Core Identity Hands On（1）——Identity 初次体验

原文地址：https://www.cnblogs.com/rocketRobin/p/9070684.html

时间： 2024-10-08 15:50:30

ASP.NET Core Identity Hands On（1）——Identity 初次体验的相关文章

asp.net core系列 55 IS4使用Identity密码保护API

原文:asp.net core系列 55 IS4使用Identity密码保护API 一.概述 OAuth 2.0资源(web api)所有者密码授权,允许客户端(Client项目)向令牌服务(IdentityServer项目)发送用户名和密码,并获取代表该用户的访问令牌.在官方文档中讲到:规范通常建议不要使用“资源所有者密码授权”.当用户进行身份验证并请求访问令牌时,使用一个交互式OpenID Connect流程通常要好得多(下篇再了解). 本篇介绍“资源所有者密码授权”是因为这种授权允许我们快

ASP.NET MVC应用迁移到ASP.NET Core及其异同简介

ASP.NET Core是微软新推出支持跨平台.高性能.开源的开发框架,相比起原有的ASP.NET来说,ASP.NET Core更适合开发现代应用程序,如跨平台.Dorker的支持.集成现代前端开发框架(如npm.bower.gulp等等).另外相比ASP.NET它的性能更好,还内置了依赖注入等功能对开发方式进行了优化.但它们之间也有很多相同或相似的地方,如都使用C#进行开发.都提供了MVC.Entity Framework.Identity等组件来快速构建应用程序. 本文将通过迁移一个简单的A

基于VS2017的Docker Support体检ASP.NET Core站点的Docker部署

最近在学习如何用 Docker 部署生产环境中的 ASP.NET Core 站点,作为一个 Docer 新手,从何处下手更容易入门呢?一开始就手写 Docker 配置文件(Docfile, docker-compose.yml)容易让人产生挫败感,想到 Visual Studio 2017 对 Docker 的支持(Docker Support),也许借助它自动生成Docker配置文件.初步体验一下 Docker 部署是一个入门捷径,遂据此想法尝试了一下,感觉不错. 1. 启用 VS2017 的

ASP.NET Core 之 Identity 入门（一）

参考页面: http://www.yuanjiaocheng.net/ASPNET-CORE/core-identity.html http://www.yuanjiaocheng.net/ASPNET-CORE/core-authorize-attribute.html http://www.yuanjiaocheng.net/ASPNET-CORE/core-identity-configuration.html http://www.yuanjiaocheng.net/ASPNET-COR

[转]ASP.NET Core 之 Identity 入门（一）

本文转自:http://www.cnblogs.com/savorboard/p/aspnetcore-identity.html 前言 在 ASP.NET Core 中,仍然沿用了 ASP.NET里面的 Identity 组件库,负责对用户的身份进行认证,总体来说的话,没有MVC 5 里面那么复杂,因为在MVC 5里面引入了OWIN的东西,所以很多初学者在学习来很费劲,对于 Identity 都是一头雾水,包括我也是,曾经在学 identity 这个东西前后花了一个多月来搞懂里面的原理.所以大

使用Asp.Net Core Identity给用户添加及删除角色

基于Asp.Net Core编制一个项目,需要给用户添加及删除角色的功能,于是使用到了Identity中的UserManager. 先后解决了几个问题,终于实现了设想. 1. 环境条件 Asp.Net Core 1.0.1 Microsoft.AspNetCore.Identity.EntityFrameworkCore 1.0.0 2. 给用户添加角色(组)使用到UserManager.AddToRolesAsync(),元数据中对AddToRolesAsync的解释为: // // 摘要:

ASP.NET Core 之 Identity 入门（三）

转自:http://www.cnblogs.com/savorboard/p/aspnetcore-identity3.html ASP.NET Core 之 Identity 入门(三) 前言 在上一篇文章中,我们学习了 CookieAuthentication 中间件,本篇的话主要看一下 Identity 本身. 最早2005年 ASP.NET 2.0 的时候开始, Web 应用程序在处理身份验证和授权有了很多的变化,多了比如手机端,平板等,所以那个时候为了适应这种变化就引入了ASP.NET

使用 ASP.NET Core Identity 的 IdentityServer4 授权服务器(二)

在 使用 ASP.NET Core Identity 的 IdentityServer4 授权服务器(1) 中,IdentityServer4 使用的是内存数据,不方便灵活,这次要把 IdentityServer4 的数据也保存到数据库中. 添加 IdentityServer4.EntityFramework IdentityServer4 有两种类型的数据需要保存数据库中.第一是配置数据(资源和客户端).第二个是 IdentityServer 在使用时产生的操作数据(令牌,代码和同意).这些存

在 Ubuntu 16.04 上的 ASP.NET Core 应用开发04：使用 ASP.NET Core Identity 的 IdentityServer4 授权服务器

新建 ASP.NET Core Identity 项目 在新建ASP.NET Core Web 应用程序 窗口中分别选择:ASP.NET Core 2.0,Web应用程序(模型视图控制器)和个人用户账号 项目建立后, 运行方式改为使用控制台运行而不是IISExpress, 以便查看各种debug信息. 打开launchSettings.json: { "profiles": { "IdentityManagerServer": { "commandName