0. 前言
通過前兩篇我們實作了如何在Service層如何訪問資料，以及如何運用簡單的加密演算法對資料加密，這一篇我們將探索如何實作asp.net core的身份驗證，
1. 身份驗證
asp.net core的身份驗證有 JwtBearer和Cookie兩種常見的模式，在這一篇我們將啟用Cookie作為身份資訊的保存，那么，我們如何啟用呢？
在Startup.cs 的ConfigureServices(IServiceCollection services) 方法里添加如下：
services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
.AddCookie(CookieAuthenticationDefaults.AuthenticationScheme, options =>
{
Configuration.Bind("CookieSettings",options);
});
此時可以啟動一個權限驗證，當用戶訪問需要驗證的頁面或介面時，如果沒有登錄，則會自動跳轉到：
https://localhost:5001/Account/Login?ReturnUrl=XXXX
其中ReturnUrl指向來源頁，
1.1 設定驗證
當我們在Startup類里設定啟用了身份驗證后，并不是訪問所有介面都會被跳轉到登錄頁面，那么如何設定訪問的路徑需要身份驗證呢？asp.net core為我們提供了一個特性類：
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
public class AuthorizeAttribute : Attribute, IAuthorizeData
{
public string Policy { get; set; }
public string Roles { get; set; }
public string AuthenticationSchemes { get; set; }
}
可以看的出，這個特性類允許設定在類、方法上，可以設定多個，允許子類繼承父類的特性，所以可以在控制器上設定[Authorize]，當在控制器上設定以后訪問控制器里所有的Action都會要求驗證身份；也可以單獨設定在Action上，表示該Action需要驗證身份，控制器里的其他方法不需要驗證，
1.2 設定忽略
我們在開發程序中，會遇到這樣的一組鏈接或者頁面：請求地址同屬于一個控制器下，但其中某個地址可以不用用戶登錄就可以訪問，通常我們為了減少重復代碼以及復用性等方面的考慮，會直接在控制器上設定身份驗證要求，而不是在控制器里所有的Action上添加驗證要求，
那么，我們如何放開其中的某個請求，可以允許它不用身份驗證，
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false, Inherited = true)]
public class AllowAnonymousAttribute : Attribute, IAllowAnonymous
{
}
仔細觀察，可以看得出這個特性可以設定在類、方法上，不允許多次設定，允許子類繼承父類的特性，
這個特性的使用沒啥可說的，不過需要注意的是，不要與AuthorizeAttribute一起使用，雖然編譯上沒啥問題，但實際上會對程式員的邏輯照成一定程度的誤導，
2.保存身份
有身份驗證，就必然需要保存身份，當我們從資料庫中或者其他的三方服務中獲取到用戶資訊后，我們需要將用戶資訊保存起來，而不是每次都向用戶或者服務提供方索求資訊，
在asp.net core中，Controller類里有一個屬性：
public HttpContext HttpContext { get; }
HttpContext 提供了一個擴展方法，可以用來保存用戶資訊：
public static Task SignInAsync(this HttpContext context, ClaimsPrincipal principal);
暫時忽略這個方法的回傳型別，它接受了一個ClaimsPrincipal型別的引數，我們來看下這個類的基本情況吧：
public class ClaimsPrincipal : IPrincipal
{
public ClaimsPrincipal();
public ClaimsPrincipal(IEnumerable<ClaimsIdentity> identities);
public ClaimsPrincipal(BinaryReader reader);
public ClaimsPrincipal(IIdentity identity);
public ClaimsPrincipal(IPrincipal principal);
public static ClaimsPrincipal Current { get; }
public static Func<ClaimsPrincipal> ClaimsPrincipalSelector { get; set; }
public static Func<IEnumerable<ClaimsIdentity>, ClaimsIdentity> PrimaryIdentitySelector { get; set; }
public virtual IIdentity Identity { get; }
public virtual IEnumerable<ClaimsIdentity> Identities { get; }
public virtual IEnumerable<Claim> Claims { get; }
public virtual void AddIdentities(IEnumerable<ClaimsIdentity> identities);
public virtual void AddIdentity(ClaimsIdentity identity);
public virtual ClaimsPrincipal Clone();
public virtual IEnumerable<Claim> FindAll(Predicate<Claim> match);
public virtual IEnumerable<Claim> FindAll(string type);
public virtual Claim FindFirst(string type);
public virtual Claim FindFirst(Predicate<Claim> match);
public virtual bool HasClaim(Predicate<Claim> match);
public virtual bool HasClaim(string type, string value);
public virtual bool IsInRole(string role);
public virtual void WriteTo(BinaryWriter writer);
}
方法和屬性有點多，那么我們重點關注一下建構式以及可以AddXXX開頭的方法，
這里有一個竅門，對于一個陌生的類來說，建構式對于類本身是個很重要的特征，我們可以通過建構式分析出這個類需要哪些基礎資料，
所以，通過簡單的分析，我們需要繼續了解這兩個類：
public class ClaimsIdentity : IIdentity
{
public ClaimsIdentity();
public ClaimsIdentity(string authenticationType);
public ClaimsIdentity(IIdentity identity);
public ClaimsIdentity(IEnumerable<Claim> claims);
public ClaimsIdentity(IEnumerable<Claim> claims, string authenticationType);
public ClaimsIdentity(IIdentity identity, IEnumerable<Claim> claims);
public ClaimsIdentity(string authenticationType, string nameType, string roleType);
public ClaimsIdentity(IEnumerable<Claim> claims, string authenticationType, string nameType, string roleType);
public ClaimsIdentity(IIdentity identity, IEnumerable<Claim> claims, string authenticationType, string nameType, string roleType);
}
public class Claim
{
public Claim(BinaryReader reader);
public Claim(BinaryReader reader, ClaimsIdentity subject);
public Claim(string type, string value);
public Claim(string type, string value, string valueType);
public Claim(string type, string value, string valueType, string issuer);
public Claim(string type, string value, string valueType, string issuer, string originalIssuer);
public Claim(string type, string value, string valueType, string issuer, string originalIssuer, ClaimsIdentity subject);
protected Claim(Claim other);
protected Claim(Claim other, ClaimsIdentity subject);
public string Type { get; }
public ClaimsIdentity Subject { get; }
public IDictionary<string, string> Properties { get; }
public string OriginalIssuer { get; }
public string Issuer { get; }
public string ValueType { get; }
public string Value { get; }
protected virtual byte[] CustomSerializationData { get; }
public virtual Claim Clone();
public virtual Claim Clone(ClaimsIdentity identity);
public override string ToString();
public virtual void WriteTo(BinaryWriter writer);
protected virtual void WriteTo(BinaryWriter writer, byte[] userData);
}
所以，看到這里就會發現，我們可以通過以下方式保存資訊：
List<Claim> claims = null;
var identity = new ClaimsIdentity(claims, CookieAuthenticationDefaults.AuthenticationScheme);
HttpContext.SignInAsync( CookieAuthenticationDefaults.AuthenticationScheme,new ClaimsPrincipal(identity));
這時候，資料就可以保存在Cookie里了，那么如何在控制器中獲取到資料呢：
public ClaimsPrincipal User { get; }
在控制器中，提供了這樣一個屬性，當然如果想要正確獲取到值的話，需要在 Startup.cs類中的添加如下配置：
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
// ……省略其他配置
app.UseAuthorization();
app.UseAuthentication();
// ……省略其他配置
}
3. 總結
在這一篇中，簡單介紹了asp.net core的identity，下一篇將從實際上帶領大家設定不一樣的identity以及Authorize驗證，
更多內容煩請關注我的博客《高先生小屋》
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/13503.html
標籤：C#
上一篇：解決火車頭7.6版本對一些https網站的采集報錯問題
下一篇：VSTO保存自定義資料到作業簿