首页/文章列表/文章详情

从0到1搭建权限管理系统系列三 .net8 JWT创建Token并使用

编程知识1522024-09-23评论

说明

该文章是属于OverallAuth2.0系列文章，每周更新一篇该系列文章（从0到1完成系统开发）。

该系统文章，我会尽量说的非常详细，做到不管新手、老手都能看懂。

说明：OverallAuth2.0 是一个简单、易懂、功能强大的权限+可视化流程管理系统。

结合上一篇文章使用，味道更佳：从0到1搭建权限管理系统系列二 .net8 使用JWT鉴权（附当前源码）

有兴趣的朋友，请关注我吧(*^▽^*)。

关注我，学不会你来打我

创建Token

　　创建token的因素（条件）有很多，在该篇文章中，采用jwt配置和用户基本信息作为生成token的基本因素（读者可根据系统，自由改变生成token因素）。

在JwtPlugInUnit.CS中创建2个方法（JwtPlugInUnit.CS在上一篇文章中有写到）

方法一：PropValuesType方法

/// <summary>
/// 反射获取字段
/// </summary>
/// <param name="obj"></param>
/// <returns></returns>
public static IEnumerable<(string Name, object Value, string Type)> PropValuesType(this object obj)
{
    List<(string a, object b, string c)> result = new List<(string a, object b, string c)>();

    var type = obj.GetType();
    var props = type.GetProperties();
    foreach (var item in props)
    {
        result.Add((item.Name, item.GetValue(obj), item.PropertyType.Name));
    }
    return result;
}

上述方法：PropValuesType是通过反射获取模型字段和属性。在本文章中，是为了提取登录人员信息，编写成List<Claim>，组成生成token的因素之一。
方法二：BuildToken方法

///<summary>///生成Token///</summary>///<param name="loginResult">登陆返回信息</param>///<returns></returns>publicstatic LoginOutPut BuildToken(LoginInput loginResult){ LoginOutPut result =newLoginOutPut();//获取配置var jwtsetting = AppSettingsPlugInUnit.GetNode<JwtSettingModel>("JwtSetting");//准备calims，记录登录信息var calims = loginResult.PropValuesType().Select(x => new Claim(x.Name, x.Value.ToString(), x.Type)).ToList(); //创建headervar key = newSymmetricSecurityKey(Encoding.UTF8.GetBytes(jwtsetting.SecurityKey));var creds = new SigningCredentials(key, SecurityAlgorithms.HmacSha256); var header = newJwtHeader(creds);//创建payloadvar payload = new JwtPayload(jwtsetting.Issuer, jwtsetting.Audience, calims, DateTime.Now, DateTime.Now.AddMinutes(jwtsetting.ExpireSeconds)); //创建令牌var token = new JwtSecurityToken(header, payload); var tokenStr = new JwtSecurityTokenHandler().WriteToken(token); result.ExpiresDate = token.ValidTo.AddHours(8).ToString(); result.Token = tokenStr; result.UserName =loginResult.UserName;returnresult;}

上述方法：BuildToken是创建token的核心代码，它通过用户信息+jwt配置信息生成token，并返回token、用户名、token过期时间等信息（读者可以添加更多返回信息）。

BuildToken中有2个模型，具体结构和位置如下：

创建Model类，用于存放系统中模型。

LoginInput模型结构如下：

///<summary>///登录输入模型///</summary>publicclassLoginInput{///<summary>///用户名///</summary>publicstring? UserName { get;set; } ///<summary>///密码///</summary>publicstring? Password { get;set; }}

LoginOutPut模型结构如下：

///<summary>///登录输入模型///</summary>publicclass LoginOutPut { ///<summary>///用户名///</summary>publicstring? UserName { get;set; } ///<summary>///密码///</summary>publicstring? Password { get;set; } ///<summary>///Token///</summary>publicstring? Token { get;set; } ///<summary>///Token过期时间///</summary>publicstring? ExpiresDate { get;set; } }

做完以上操作，用户就可以生成Token，但要把token运用到系统中，还需做以下操作。

创建模块分组

　　在ModeuleGroupEnum.cs中创建2个枚举，具体如下

　　说明：ModeuleGroupEnum.cs在从0到1搭建权限管理系统系列一 .net8 使用Swagger（附当前源码）文章中有说明（或者关注我的微信公众号）。

///<summary>///模块分组///</summary>publicenum ModeuleGroupEnum { ///<summary>///系统菜单///</summary> SysMenu = 1,///<summary>///系统用户///</summary> SysUser = 2,///<summary>///基础///</summary> Base = 3, }

　　新增【系统用户】、【基础】2个枚举。

创建新控制器

　　创建2个控制器：BaseController和SysUserController，结构如下

　　创建BaseController基础控制器，它存在的作用，就是承担系统中需要重写方法和获取用户基本信息的桥梁。

代码如下：

///<summary>///系统基础模块///</summary>[ApiController][Route("api/[controller]/[action]")][ApiExplorerSettings(GroupName=nameof(ModeuleGroupEnum.Base))][Authorize]publicclass BaseController : ControllerBase{ ///<summary>///获取登陆人员信息///</summary>///<returns></returns>[HttpGet]public LoginOutPut GetLoginUserMsg() { StringValues s =newStringValues();var auth = Request.Headers.TryGetValue("Authorization",outs);if(string.IsNullOrWhiteSpace(s))thrownewException("登录信息失效");var token = newJwtSecurityTokenHandler().ReadJwtToken(s.ToString().Replace($"{JwtBearerDefaults.AuthenticationScheme}","")); LoginOutPut loginResult =new() { UserName = token.Claims.FirstOrDefault(f => f.Type == "UserName").Value, Password = Convert.ToString(token.Claims.FirstOrDefault(f => f.Type == "Password").Value), }; return loginResult; }}

解读下该方法：通过获取Headers中的Token，然后使用jwt反解析token获取在BuildToken方法中记录的用户基本信息。

说明：控制器上方存在[Authorize]，只要有控制器继承基础控制【BaseController】，那么该控制器下的所有方法，都需要经过jwt验证。如果某一个接口不需要token验证，就在该接口上方添加 [AllowAnonymous]

　　创建SysUserController控制器，并继承BaseController控制器，它的作用就是承担系统用户的所有接口，具体代码如下：

///<summary>///用户模块///</summary> [ApiController] [Route("api/[controller]/[action]")] [ApiExplorerSettings(GroupName =nameof(ModeuleGroupEnum.SysUser))]publicclass SysUserController : BaseController { ///<summary>///获取Token///</summary>///<param name="userName">用户名</param>///<param name="password">密码</param> [HttpGet] [AllowAnonymous] publicstringGetToken(stringuserName,string password) { var loginResult = JwtPlugInUnit.BuildToken(new LoginInput { UserName = userName, Password = password }); return loginResult.Token ?? string.Empty; }}