粗略使用.NetCore2.0自带授权登陆Authorize

上篇Linux+.NetCore+Nginx搭建集群有朋友提及到如果nginx做集群后应该还会有下一篇文章主讲session控制，一般来说就是登陆；本篇分享的内容不是关于分布式session内容，而是netcore自带的授权Authorize，Authorize粗略的用法，希望能对大家有好的帮助；

web网站session和cookie关系
在NetCore中使用Authorize登陆

web网站session和cookie关系

要说session和cookie关系，恐怕有很多文章都有说过，这里我只阐述下自己的理解，尽可能的做到通俗易懂；对于session往往存储于服务端，登陆的话session一般会存储登陆用户的基本信息，还有个会话唯一sessionId（以下简称：token），这个token会分配到每个用户头上，服务端根据用户请求的token来识别服务端存储的登陆信息，以此达到登陆的目的；

客户端要传递这个同样的token，必须要存储起来，这就要用到咋们说的cookie，客户端用cookie来存储token，cookie拥有过期时间特性能够很好的做到登录失效的效果（尽管session也有），往往在分布式的时候cookie和session的失效时间都会设置，只要某一个时间过期了将视为需要重新登录或者需要重新设置cookie；下面将截图在谷歌浏览器下某个网站的cookie存储图：

能够看出cookie存储就是key-value的方式，唯一的名字+value；

在.NetCore中使用Authorize登陆

对于Authorize经常使用mvc的朋友肯定不陌生，在core中使用Authorize登录首先需要在Starup.cs的ConfigureServices方法中配置下，这里我直接给出粗略的配置吧（满足登录）：

public void ConfigureServices(IServiceCollection services)

{

services.AddMvc();

//配置authorrize

services.AddAuthentication(b =>

{

b.DefaultAuthenticateScheme = CookieAuthenticationDefaults.AuthenticationScheme;

b.DefaultChallengeScheme = CookieAuthenticationDefaults.AuthenticationScheme;

b.DefaultSignInScheme = CookieAuthenticationDefaults.AuthenticationScheme;

}).

AddCookie(b =>

{

//登陆地址

b.LoginPath = "/login";

//sid

b.Cookie.Name = "My_SessionId";

// b.Cookie.Domain = "shenniu.core.com";

b.Cookie.Path = "/";

b.Cookie.HttpOnly = true;

b.Cookie.Expiration = new TimeSpan(0, 0, 30);

b.ExpireTimeSpan = new TimeSpan(0, 0, 30);

});

}

下面简单说明下cookie的属性效果：

b.Cookie.Name：就是cookie的名字，对应第一小节谷歌浏览器截图的Name；
b.LoginPath：设置登陆失败或者未登录授权的情况下，直接跳转的路径这里，这是/login；
b.Cookie.Domain：指定cookie对应的域名，这里我没域名和没设置本地host所以屏蔽，屏蔽的或默认localhost；
b.Cookie.HttpOnly：设置cookie只读情况；
b.Cookie.Expiration：cookie过期时间；

好了咋们设置完后，需要在login页面设置这样的逻辑和代码；首先是get路由，她会做两件事情：验证是否已授权登陆过和未登录显示登录试图界面：

public IActionResult OnGet()

{

//登录授权直接跳转index界面

if (HttpContext.User.Identity.IsAuthenticated)

{

return RedirectToPage("Index");

}

return Page();

}

这里利用Identity.IsAuthenticated来校验登录状态，登录了直接重定向到主页面Index这没什么说的；如果没登录，需要用户登陆下，然后在做授权，以下是用户post提交的登录请求处理：

/// <summary>

/// 登录

/// </summary>

/// <returns></returns>

public async Task<IActionResult> OnPost()

{

if (ModelState.IsValid)

{

//登陆授权

var claims = new List<Claim>();

claims.Add(new Claim(ClaimTypes.Name, this.LoginUser.UserName));

var indentity = new ClaimsIdentity(claims, "denglu");

var principal = new ClaimsPrincipal(indentity);

await HttpContext.SignInAsync(

CookieAuthenticationDefaults.AuthenticationScheme,

principal);

//验证是否授权成功

if (principal.Identity.IsAuthenticated)

{

return RedirectToPage("Index");

}

return Page();

}

主要通过HttpContext.SignInAsync()来设置授权，Claim设置一些账号等信息；这里我用的是2.0出的Razor模板，也为了更好的学习razor的请求和绑定数据方式，因此这里给出具体的cshtml代码布局代码：

@page
@model LoginModel
@{
}<form method="post"><input type="text" name="LoginUser.UserName" /><button type="submit" class="btn">登陆</button>
</form>

需要注意的是输入框的那么这样写的 name="LoginUser.UserName" ，对应的cs后台代码必须要这样设置实体：

[BindProperty]public MoLoginUser LoginUser { get; set; }

需要设置 [BindProperty] 标记，不然没有初始化LoginUser对象会有问题的（本章也不打算讲解更多的razor模板提交的方式，等以后有需要在说吧）；

回来说authorize，通过上面配置和登录的设置，我们还需要通过 [Authorize] 标记哪些界面或者操作需要授权登陆才能执行，比如我这里的Index界面需要登录后才能显示内容，所以只需要在class上添加标记 [Authorize] 就行了：

有了登陆，咋们还需要退出，直接给出退出的具体代码：

/// <summary>

/// 退出

/// </summary>

/// <returns></returns>

public async Task<IActionResult> OnGetLoginOutAsync()

{

if (HttpContext.User.Identity.IsAuthenticated)

{

await HttpContext.SignOutAsync(CookieAuthenticationDefaults.AuthenticationScheme);

}

return RedirectToPage("Login");

}

实际也仅仅只需要 HttpContext.SignOutAsync 就完成了注销，这就是Authorize提供的便利；由于这里还是razor模板，因此在多get提交注销的时候，如果您自定义了非OnGet或OnGetAsnyc方法名外的get函数，如： public asyncTask<IActionResult> OnGetLoginOutAsync() ，那么需要指定get的handler请求参数：hanlder=LoginOut，举个退出按钮的例子，这里的href指定的请求格式如： /login?handler=loginout ，这样才能请求的login界面的退出 OnGetLoginOutAsync 方法，好吧下面看下效果图：