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

上篇有朋友提及到如果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(, , );

                 b.ExpireTimeSpan = new TimeSpan(, , );
             });
         }

下面简单说明下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 async Task<IActionResult> OnGetLoginOutAsync() ，那么需要指定get的handler请求参数：hanlder=LoginOut，举个退出按钮的例子，这里的href指定的请求格式如： /login?handler=loginout ，这样才能请求的login界面的退出 OnGetLoginOutAsync 方法，好吧下面看下效果图：

如果本文对您有好的帮助，不妨点个赞支持下，谢谢！！！