最簡實例演示asp.net5中用戶認證和授權(4)

上篇：

最簡實例演示asp.net5中用戶認證和授權(3)

上面我們把自定義認證和授權的相關的最小基礎類和要實現的接口都實現了，下面就是如何來進行認證和授權的配置。

 首先我們要告訴系統，我們的用戶和角色類以及實現的接口，這樣系統在認證的時候就知道要調用哪些類和方法，其實就是注冊一下上面定義的幾個類而已，在Startup.cs文件的ConfigureServices方法添加如下代碼：

public void ConfigureServices(IServiceCollection services)
        {
            
            ...

            services.AddIdentity<HDUser, HDRole>();
            services.AddSingleton<IUserStore<HDUser>, HDUserStore<HDUser>>();
            services.AddSingleton<IRoleStore<HDRole>, HDRoleStore<HDRole>>();
            ...

            
        }

第6行，注冊我們定義的用戶和角色類。第7行和第8行注冊用戶和角色操作類。

那么這三行代碼有什么關系呢？

我們去看一下AddIdentity的源代碼，看看里面都干了什么活：

public static IdentityBuilder AddIdentity<TUser, TRole>(
            this IServiceCollection services, 
            Action<IdentityOptions> setupAction)
            where TUser : class
            where TRole : class
        {
            // Services used by identity
            services.AddOptions();
            services.AddAuthentication(options =>
            {
                // This is the Default value for ExternalCookieAuthenticationScheme
                options.SignInScheme = new IdentityCookieOptions().ExternalCookieAuthenticationScheme;
            });

            // Identity services
            services.TryAddSingleton<IdentityMarkerService>();
            services.TryAddScoped<IUserValidator<TUser>, UserValidator<TUser>>();
            services.TryAddScoped<IPasswordValidator<TUser>, PasswordValidator<TUser>>();
            services.TryAddScoped<IPasswordHasher<TUser>, PasswordHasher<TUser>>();
            services.TryAddScoped<ILookupNormalizer, UpperInvariantLookupNormalizer>();
            services.TryAddScoped<IRoleValidator<TRole>, RoleValidator<TRole>>();
            // No interface for the error describer so we can add errors without rev'ing the interface
            services.TryAddScoped<IdentityErrorDescriber>();
            services.TryAddScoped<ISecurityStampValidator, SecurityStampValidator<TUser>>();
            services.TryAddScoped<IUserClaimsPrincipalFactory<TUser>, UserClaimsPrincipalFactory<TUser, TRole>>();
            services.TryAddScoped<UserManager<TUser>, UserManager<TUser>>();
            services.TryAddScoped<SignInManager<TUser>, SignInManager<TUser>>();
            services.TryAddScoped<RoleManager<TRole>, RoleManager<TRole>>();

            if (setupAction != null)
            {
                services.Configure(setupAction);
            }

            return new IdentityBuilder(typeof(TUser), typeof(TRole), services);
        }

原來這貨把認證授權需要實現的接口都注冊了一遍，光看方法名字確實讓人很難想象。
那么后兩行是干什么的呢？看一下AddIdentity源代碼的26~28行，需要用到usermanger、signinmanager和rolemanager，這幾個類里面需要用到IUserStore和IRoleStore，這兩行就是注冊這兩個接口的實現的。

好了，上面是注冊的，那么光注冊還不行，還要啟用才行，咱們再看一下Configure方法，添加如下代碼：

 public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerfactory)
        {         
            ...
            app.UseIdentity();
           ...
    
        }

這樣就告訴系統要啟用認證這套機制了。
OK。到這里基礎工作都做完了。

是不是活都干完了？沒有啊，還沒有告訴我怎么登錄，怎么對網頁或方法應用角色權限啊，我們慢慢來。

我們再寫一個簡單的登錄和退出的管理類，假設叫AccountController吧，代碼如下：

[Route("account")]
    public class AccountController : Controller
    {
        [FromServices]
        public SignInManager<HDUser> SignInManager { get; set; }


        [AllowAnonymous]
        [HttpGet("login")]
        public IActionResult Login(string returnUrl)
        {
            ViewBag.ReturnUrl = returnUrl;
            return View();
        }

        [HttpPost("login")]
        [AllowAnonymous]        
        public async Task<IActionResult> Login(LoginViewModel model, string returnUrl)
        {
            if (ModelState.IsValid == true)
            {
                var result = await SignInManager.PasswordSignInAsync(model.UserName, model.Password, model.RememberMe, lockoutOnFailure: false);
                if (result.Succeeded)
                {
                   
                    return RedirectToLocal(returnUrl);
                }

                ModelState.AddModelError("", "用戶名或密碼錯誤.");
                return View(model);
            }
            return View(model);
        }

        [HttpPost]
        [ValidateAntiForgeryToken]
        public async Task<IActionResult> LogOff()
        {
            await SignInManager.SignOutAsync();
            return RedirectToAction(nameof(HomeController.Index), "Home");
        }

        private IActionResult RedirectToLocal(string returnUrl)
        {
            if (Url.IsLocalUrl(returnUrl))
            {
                return Redirect(returnUrl);
            }
            else
            {
                return RedirectToAction(nameof(HomeController.Index), "Home");
            }
        }

    }

這里面最重要的就是Login方法，它根據傳入的登錄信息，調用SignInManager.PasswordSignInAsync方法，就能完成登錄了。等等，這個SignInManager怎么來的？你咋可以直接用呢？看看上面的定義：

[FromServices]
        public SignInManager<HDUser> SignInManager { get; set; }

有一個FromServices標記，原來這個是系統自動從服務里面取得的，還記得我們上面調用了一次AddIdentity嗎？它就把SignInManager注冊到服務里，然后就可以到處使用了，這個可以認為是asp.net5的非常重要的依賴注入機制，也是靈魂之一，如果不明白的，一定要好好看看哦。

好了，我們再看看LoginViewModel，這個也是比較重要的一個參數：

 public class LoginViewModel
    {
        [Required]
        [Display(Name = "User name")]
        public string UserName { get; set; }

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

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

不過代碼很簡單，vs自動生成項目的時候，一般都這么生成登錄代碼。

有Controler了，是不是還要有View呢，當然要有，不過很簡單，就不貼出來了。

最后，我們看一下應用權限的類是什么樣的：

    [Authorize]
    [Route("api/data")]
    public class DatasApiController : Controller
    {
        
        [HttpGet("daxialist")]
        [Authorize(Roles ="user")]
        public JsonResult GetDaxiaList()
        {
           
            ...
            return Json(...);
        }


        [HttpGet("daxiacount")]
        public JsonResult GetDaxiaCount()
        {
                       return Json(...);
        }
}

這里使用[Authorize]表示要對這個類的所有方法應用權限管理

[Authorize(Roles ="user")]表示這個方法只能角色為user的用戶可以訪問。
那個GetDaxiaCount方法，沒有應用角色，表示所有經過認證的用戶都可以訪問，不管角色是什么。

至此，我們最終完成了一個最簡單的基於asp.net5的認證授權。當然，這里可能連認證授權百分之一的功能都沒有體現出來，要想深入了解，還要花大量的時間去研究啊。