Cookie,Session,Token这些用于认证，鉴权的名词相信大家都很熟悉了，网上都有大量的文章讲解，这里我们主要针对本商城通过mysql进行存储的token鉴权进行讲解。
这只是作为一个学习项目使用Mysql进行存储鉴权信息，一般企业项目中的单点登录都会使用redis进行存储
什么是token
访问资源接口（API）时所需要的资源凭证
简单 token 的组成： uid(用户唯一的身份标识)、time(当前时间的时间戳)、sign（签名，token 的前几位以哈希算法压缩成的一定长度的十六进制字符串）
特点
服务端无状态化、可扩展性好
支持移动端设备
安全
支持跨程序调用
token 的身份验证流程：
[图片上传失败...(image-5d8906-1655621934648)]
token的解释，转自https://juejin.cn/post/6844904034181070861
商城中token存储
新蜂商城项目中存在两个类型的用户：
- 后台管理员
- 商城用户
其实现逻辑是一致的所以我们调一个讲解即可，这里我们使用后台管理员的登陆进行讲解
我们使用了两张数据库表对用户的登录进行管理
tb_newbee_mall_admin_user & tb_newbee_mall_admin_user_token
我们通过两张表的admin_user_id将 用户和token进行了关联，如果用户登陆状态是有效的，则tb_newbee_mall_admin_user_token中就会存在一条记录，否则就是用户没有登陆。
[图片上传失败...(image-f954ca-1655621934649)]
[图片上传失败...(image-49b31-1655621934649)]
gin实现接口鉴权
管理员登录的时候，校验用户名和密码，通过的话则将生成的token存入数据库中用于后续的鉴权
// AdminLogin 管理员登陆
func (m *ManageAdminUserService) AdminLogin(params manageReq.MallAdminLoginParam) (err error, mallAdminUser manage.MallAdminUser, adminToken manage.MallAdminUserToken) {
err = global.GVA_DB.Where("login_user_name=? AND login_password=?", params.UserName, params.PasswordMd5).First(&mallAdminUser).Error
if mallAdminUser != (manage.MallAdminUser{}) {
token := getNewToken(time.Now().UnixNano()/1e6, int(mallAdminUser.AdminUserId))
global.GVA_DB.Where("admin_user_id", mallAdminUser.AdminUserId).First(&adminToken)
nowDate := time.Now()
// 48小时过期
expireTime, _ := time.ParseDuration("48h")
expireDate := nowDate.Add(expireTime)
// 没有token新增，有token 则更新
if adminToken == (manage.MallAdminUserToken{}) {
adminToken.AdminUserId = mallAdminUser.AdminUserId
adminToken.Token = token
adminToken.UpdateTime = nowDate
adminToken.ExpireTime = expireDate
if err = global.GVA_DB.Create(&adminToken).Error; err != nil {
return
}
} else {
adminToken.Token = token
adminToken.UpdateTime = nowDate
adminToken.ExpireTime = expireDate
if err = global.GVA_DB.Save(&adminToken).Error; err != nil {
return
}
}
}
return err, mallAdminUser, adminToken
}
然后我们定义一个拦截器，让需要鉴权的接口进行token的校验
// 拦截器
func AdminJWTAuth() gin.HandlerFunc {
return func(c *gin.Context) {
token := c.Request.Header.Get("token")
if token == "" {
response.FailWithDetailed(nil, "未登录或非法访问", c)
c.Abort()
return
}
err, mallAdminUserToken := manageAdminUserTokenService.ExistAdminToken(token)
if err != nil {
response.FailWithDetailed(nil, "未登录或非法访问", c)
c.Abort()
return
}
if time.Now().After(mallAdminUserToken.ExpireTime) {
response.FailWithDetailed(nil, "授权已过期", c)
manageAdminUserTokenService.DeleteMallAdminUserToken(token)
c.Abort()
return
}
c.Next()
}
}
最后在我们需要使用鉴权的接口处注册上这个拦截器的中间件,不需要鉴权的接口就不使用拦截器
func (r *ManageAdminUserRouter) InitManageAdminUserRouter(Router *gin.RouterGroup) {
mallAdminUserRouter := Router.Group("v1").Use(middleware.AdminJWTAuth())
mallAdminUserWithoutRouter := Router.Group("v1")
var mallAdminUserApi = v1.ApiGroupApp.ManageApiGroup.ManageAdminUserApi
{
mallAdminUserRouter.POST("createMallAdminUser", mallAdminUserApi.CreateAdminUser) // 新建MallAdminUser
mallAdminUserRouter.PUT("adminUser/name", mallAdminUserApi.UpdateAdminUserName) // 更新MallAdminUser
mallAdminUserRouter.PUT("adminUser/password", mallAdminUserApi.UpdateAdminUserPassword)
......
}
{
mallAdminUserWithoutRouter.POST("adminUser/login", mallAdminUserApi.AdminLogin) //管理员登陆
}
}
因为这里我们没有使用到更高级别的权限管理，go中对于权限管理有casbin这个库，有兴趣的话可以了解一下，这里不做过多的讲解。
效果演示
启动我们后管系统的vue项目，登陆后发现tb_newbee_mall_admin_user_token 表中新增了一条token的数据，同时前端的请求头中也会新增一个token的字段，用于存储鉴权信息。
总结
如果你对这一节的内容感兴趣可以访问https://github.com/newbee-ltd/newbee-mall-api-go/ 下载源代码，后续一章我会介绍跨域相关的内容，当时进行调试前端项目的时候也是被自己坑惨了
