go语言后端开发学习(一)——JWT的介绍以及基于JWT实现登录验证

简介: go语言后端开发学习(一)——JWT的介绍以及基于JWT实现登录验证

什么是JWT

JWT,全名为JSON Web Token,是当下主流的一种服务端通信认证方式,具有轻量,无状态的特点,它实现了让我们在用户与服务器之间传递安全可靠的Json文本信息,它的使用过程主要是这样的:

当用户注册的时候,服务端会接受到来自用户输入的账号与密码,然后服务端会向客户端发送JWT,而当客户端有了JWT这个令牌后,当下一次客户端向服务端请求数据时,我们只要利用这个令牌,就可以轻松访问服务端的数据了,因此这种信息传输方式也有着开销少,传输安全的特点。

JWT的下载

终端输入以下命令即可:

go get -u github.com/golang-jwt/jwt/v4

JWT的构成

简介

在RFC标准中,JWT由以下三个部分组成:

  • Header: 头部
  • Payload: 载荷
  • Signature: 签名

我们会将这里的每一个部分用一个点.来分隔,最后组成一个字符串,格式如下:

header.payload.signature

而这就是一个JWT令牌的标准结构,接下来网格大家来逐个讲解每个结构的作用。

头部

Header中主要是声明一些基本信息,通常是由两部分来组成:

  • 令牌的类型
  • 签名所使用的加密算法
    比如下面的这个示例:
{
  "alg":"HS526",
  "typ":"JWT"
}

上面这个Json格式的数据意思大致为:令牌的类型为JWT,签名所使用的加密算法为HS526,最后再将JSON对象通过Base64Url编码为字符串,该字符串就是JWT的头部

载荷

JWT的第二部分是载荷部分,主要就是声明部分claims,声明部分通常是一个实体的数据,比如一个用户。而关于声明的类型主要有以下几种:

  • reigstered:Reigetered claims代表着一些预定义的声明 ,例如:iss(issuer 签发者),exp(expiration time 过期时间),aud(audience 受众)
  • public:Puiblic claims这部分可以让使用JWT的人随意定义,但是最好避免与其他声明部分冲突
  • private claims:这部分的声明同样也是自定义的,通常用于在服务双方共享一些信息。

示例:

{
  "sub": "1234567890",
    "name": "John Doe",
    "admin": true
}

该JSON对象将通过Base64Url编码为字符串,该字符串就是JWT的第二部分。

注意:虽然载荷部分也受到保护,也有防篡改,但是这一部分是公共可读的,所以不要把敏感信息存放在JWT内。

签名

在获得了编码的头部和编码的载荷部分后,就可以通过头部所指明的签名算法根据前两个部分的内容再加上密钥进行加密签名,所以一旦JWT的内容有任何变化,解密时得到的签名都会不一样,同时如果是使用私钥,也可以对JWT的签发者进行验证。

JWT的工作原理

在身份验证中,用户使用凭据成功登录是,将会返回一个JSON WEB令牌,由于令牌是凭证,所以要求我们要常常小心地防止出现安全问题,所以令牌的保存时间不应超过其所需的时间,同时无论何时用户想要访问受保护的路由与资源,在发送请求时都必须携带上token,服务端在收到JWT后会对其进行有效性认证,例如内容有篡改,token已过期等等,如果验证通过就可以顺利的访问资源。

注意:虽然JWT允许我们携带一些基本的信息,但是建议不要带有过大信息量的数据。

JWT的使用案例

这里我主要会以一个通过JWT来实现的登录验证中间件来讲解一下我们如何在项目中使用JWT:

设置JWTKey

首先我们在config文件中设置JWTKey:

然后我们基于这个配置文件读取来读取配置:

package utils
import (
  "fmt"
  "github.com/sirupsen/logrus"
  "gopkg.in/ini.v1"
)
type Config struct {
  Server   *server   `ini:"server"`
  Database *database `ini:"database"`
}
type server struct {
  AppMode  string `ini:"AppMode"`
  HttpPort string `ini:"HttpPort"`
  JWTKey   string `ini:"JWTKey"`
}
type database struct {
  Db         string `ini:"Db"`
  DbName     string `ini:"DbName"`
  DbUser     string `ini:"DbUser"`
  DbPassWord string `ini:"DbPassWord"`
  DbHost     string `ini:"DbHost"`
  DbPort     string `ini:"DbPort"`
}
var ServerSetting = &server{
  AppMode:  "debug",
  HttpPort: ":3000",
  JWTKey:   "FengXu123",
}
var DatabaseSetting = &database{
  Db:         "mysql",
  DbName:     "goblog",
  DbUser:     "root",
  DbPassWord: "ba161754",
  DbHost:     "localhost",
  DbPort:     "3306",
}
// Config_Message
var Config_Message = &Config{
  Server:   ServerSetting,
  Database: DatabaseSetting,
}
func init() {
  filename := "config/config.ini"
  cfg, err := ini.Load(filename)
  if err != nil {
    logrus.Errorf("配置文件加载失败: %v", err)
  }
  err = cfg.MapTo(Config_Message)
  if err != nil {
    logrus.Errorf("配置文件映射失败: %v", err)
  }
  fmt.Println(Config_Message.Server.JWTKey)
  logrus.Infof("配置文件加载成功")
}

具体go-ini第三方包的使用可以参考博主以前的文章:

go语言并发实战——日志收集系统(五) 基于go-ini包读取日志收集服务的配置文件

运行程序后,控制台显示:

说明我们的配置信息就成功被加载出来了。

定义相关结构体与信息

// JWT结构体
type JWT struct {
  JWTKey []byte // JWT密钥
}
func NewJWT() *JWT { //新建JWT结构体
  return &JWT{
    JWTKey: []byte(utils.Config_Message.Server.JWTKey),
  }
}
// 自定义声明
type MyClaims struct {
  Username string `json:"username"` //这里的与gorm中声明的保持一致
  jwt.RegisteredClaims
}
// 定义相关错误信息
var (
  TokenExpired     error = errors.New("token已过期,请重新登录")
  TokenNotValidYet error = errors.New("token无效,请重新登录")
  TokenMalformed   error = errors.New("token不正确,请重新登录")
  TokenInvalid     error = errors.New("这不是一个token,请重新登录")
)

生成token

func(j *JWT)CreateToken(claims MyClaims) (string, error) {
  token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
  return token.SignedString(j.JWTKey)
}

部分函数记录:

  1. NewWithClaims:
func NewWithClaims(method SigningMethod, claims Claims) *Token
  • 作用:创建一个新的token
  • 相关参数:
  • SigningMethod:所采用的加密方法
  • claims:我们所定义的声明
  1. SignedString:
  • 作用:SignedString创建并返回一个完整的、已签名的JWT

解析token

// 解析token
func (j *JWT) ParseToken(tokenString string) error {
  // 解析token
  token, err := jwt.Parse(tokenString, func(token *jwt.Token) (interface{}, error) {
    return j.JWTKey, nil
  })
  // 校验token
  if token.Valid {
    return nil
  } else if errors.Is(err, jwt.ErrTokenExpired) || errors.Is(err, jwt.ErrTokenNotValidYet) {
    return TokenExpired
  } else if errors.Is(err, jwt.ErrSignatureInvalid) {
    return TokenInvalid
  } else if errors.Is(err, jwt.ErrTokenMalformed) {
    return TokenMalformed
  } else {
    return TokenNotValidYet
  }
}

实现token中间件

//jwt中间件
func JwtToken() gin.HandlerFunc {
  return func(c *gin.Context) {
    var code int
    //检验Header
    tokenHeader := c.Request.Header.Get("Authorization")
    if tokenHeader == "" {
      code = errmsg.ERROR_TOKEN_NOT_EXIST
      c.JSON(200, gin.H{
        "status":  code,
        "message": errmsg.GetErrMsg(code),
      })
      c.Abort() //拦截中间件
    }
    checkToken := strings.Split(tokenHeader, " ")
    if len(checkToken) == 0 {
      code = errmsg.ERROR_TOKEN_TYPE_WRONG
      c.JSON(200, gin.H{
        "status":  code,
        "message": errmsg.GetErrMsg(code),
      })
      c.Abort()
    }
    if len(checkToken) != 2 || checkToken[0] != "Bearer" {
      c.JSON(200, gin.H{
        "status":  code,
        "message": errmsg.GetErrMsg(code),
      })
      c.Abort()
    }
    //解析token
    j := NewJWT()
    err := j.ParseToken(checkToken[1])
    if err != nil {
      if errors.Is(err, TokenExpired) {
        c.JSON(200, gin.H{
          "status":  errmsg.ERROR_TOKEN_RUNTIME,
          "message": errmsg.GetErrMsg(errmsg.ERROR_TOKEN_RUNTIME),
        })
        c.Abort()
      } else {
        c.JSON(200, gin.H{
          "status":  errmsg.ERROR,
          "message": err.Error(),
        })
        c.Abort()
      }
    }
    c.Next()
  }
}

完整代码

package middleware
import (
  "errors"
  "gin_vue_blog/utils"
  "gin_vue_blog/utils/errmsg"
  "github.com/gin-gonic/gin"
  "github.com/golang-jwt/jwt/v4"
  "strings"
)
// JWT结构体
type JWT struct {
  JWTKey []byte // JWT密钥
}
func NewJWT() *JWT { //新建JWT结构体
  return &JWT{
    JWTKey: []byte(utils.Config_Message.Server.JWTKey),
  }
}
// 自定义声明
type MyClaims struct {
  Username string `json:"username"` //这里的与gorm中声明的保持一致
  jwt.RegisteredClaims
}
// 定义相关错误信息
var (
  TokenExpired     error = errors.New("token已过期,请重新登录")
  TokenNotValidYet error = errors.New("token无效,请重新登录")
  TokenMalformed   error = errors.New("token不正确,请重新登录")
  TokenInvalid     error = errors.New("这不是一个token,请重新登录")
)
// 生成token
func (j *JWT) CreateToken(claims MyClaims) (string, error) {
  token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
  return token.SignedString(j.JWTKey)
}
// 解析token
func (j *JWT) ParseToken(tokenString string) error {
  // 解析token
  token, err := jwt.Parse(tokenString, func(token *jwt.Token) (interface{}, error) {
    return j.JWTKey, nil
  })
  // 校验token
  if token.Valid {
    return nil
  } else if errors.Is(err, jwt.ErrTokenExpired) || errors.Is(err, jwt.ErrTokenNotValidYet) {
    return TokenExpired
  } else if errors.Is(err, jwt.ErrSignatureInvalid) {
    return TokenInvalid
  } else if errors.Is(err, jwt.ErrTokenMalformed) {
    return TokenMalformed
  } else {
    return TokenNotValidYet
  }
}
//jwt中间件
func JwtToken() gin.HandlerFunc {
  return func(c *gin.Context) {
    var code int
    //检验Header
    tokenHeader := c.Request.Header.Get("Authorization")
    if tokenHeader == "" {
      code = errmsg.ERROR_TOKEN_NOT_EXIST
      c.JSON(200, gin.H{
        "status":  code,
        "message": errmsg.GetErrMsg(code),
      })
      c.Abort() //拦截中间件
    }
    checkToken := strings.Split(tokenHeader, " ")
    if len(checkToken) == 0 {
      code = errmsg.ERROR_TOKEN_TYPE_WRONG
      c.JSON(200, gin.H{
        "status":  code,
        "message": errmsg.GetErrMsg(code),
      })
      c.Abort()
    }
    if len(checkToken) != 2 || checkToken[0] != "Bearer" {
      c.JSON(200, gin.H{
        "status":  code,
        "message": errmsg.GetErrMsg(code),
      })
      c.Abort()
    }
    //解析token
    j := NewJWT()
    err := j.ParseToken(checkToken[1])
    if err != nil {
      if errors.Is(err, TokenExpired) {
        c.JSON(200, gin.H{
          "status":  errmsg.ERROR_TOKEN_RUNTIME,
          "message": errmsg.GetErrMsg(errmsg.ERROR_TOKEN_RUNTIME),
        })
        c.Abort()
      } else {
        c.JSON(200, gin.H{
          "status":  errmsg.ERROR,
          "message": err.Error(),
        })
        c.Abort()
      }
    }
    c.Next()
  }
}

备注:拦截中间件与响应中间件的具体细节可以参考博主之前的文章:

Gin框架学习笔记(五) ——文件上传与路由中间件

拓展:签名算法的选择(仅供参考)

可用的签名算法有好几种,在使用之前应该先了解下它们之间的区别以便更好的去选择签名算法,它们之间最大的不同就是对称加密和非对称加密。

最简单的对称加密算法HSA,让任何[]byte都可以用作有效的密钥,所以计算速度稍微快一点。在生产者和消费者双方都是可以被信任的时候,对称加密算法的效率是最高的。不过由于签名和验证都使用相同的密钥,因此无法轻松的分发用于验证的密钥,毕竟签名的密钥也是同一个,签名泄露了则JWT的安全性就毫无意义。

非对称加密签名方法,例如RSA,使用不同的密钥来进行签名和验证token,这使得生成带有私钥的令牌成为可能,同时也允许任何使用公钥验证的人正常访问。

不同的签名算法所需要的密钥的类型也不同,下面给出一些常见签名算法的类型:

  • HMAC:对称加密,需要类型[]byte的值用于签名和验证。 (HS256,HS384,HS512)
  • RSA:非对称加密,需要rsa.PrivateKey类型的值用于签名,和rsa.PublicKey类型的值用于验证。(RS256,RS384,RS512)
  • ECDSA:非对称加密,需要ecdsa.PrivateKey类型的值用于签名,和ecdsa.PublicKey类型的值用于验证。(ES256,ES384,ES512)
  • EdDSA:非对称加密,需要ed25519.PrivateKey类型的值用于签名和ed25519.PublicKey 类型的值用于验证。(Ed25519)
相关文章
|
JavaScript NoSQL Redis
Vue中实现修改邮箱、手机号等流程的大致过程、验证码由后端的redis生成验证(版本1.0)
这篇文章记录了在Vue中实现修改手机号和邮箱的大致流程,包括使用过滤器部分隐藏展示的手机号和邮箱,以及通过点击触发路由跳转的便捷方式。文章还描述了旧号码和新号码验证的界面实现,其中验证码由后端生成并通过弹窗展示给用户,未来可以接入真正的手机验证码接口。此外,还提供了修改邮箱的页面效果截图,并强调了学习是一个永无止境的过程。
Vue中实现修改邮箱、手机号等流程的大致过程、验证码由后端的redis生成验证(版本1.0)
|
算法 安全 Go
Go 语言中实现 RSA 加解密、签名验证算法
随着互联网的发展,安全需求日益增长。非对称加密算法RSA成为密码学中的重要代表。本文介绍如何使用Go语言和[forgoer/openssl](https://github.com/forgoer/openssl)库简化RSA加解密操作,包括秘钥生成、加解密及签名验证。该库还支持AES、DES等常用算法,安装简便,代码示例清晰易懂。
651 12
|
存储 前端开发 Java
验证码案例 —— Kaptcha 插件介绍 后端生成验证码,前端展示并进行session验证(带完整前后端源码)
本文介绍了使用Kaptcha插件在SpringBoot项目中实现验证码的生成和验证,包括后端生成验证码、前端展示以及通过session进行验证码校验的完整前后端代码和配置过程。
4510 1
验证码案例 —— Kaptcha 插件介绍 后端生成验证码,前端展示并进行session验证(带完整前后端源码)
|
前端开发 JavaScript
这篇文章介绍了如何使用form表单结合Bootstrap格式将前端数据通过action属性提交到后端的servlet,包括前端表单的创建、数据的一级和二级验证,以及后端servlet的注解和参数获取。
这篇文章介绍了使用AJAX技术将前端页面中表单接收的多个参数快速便捷地传输到后端servlet的方法,并通过示例代码展示了前端JavaScript中的AJAX调用和后端servlet的接收处理。
这篇文章介绍了如何使用form表单结合Bootstrap格式将前端数据通过action属性提交到后端的servlet,包括前端表单的创建、数据的一级和二级验证,以及后端servlet的注解和参数获取。
|
安全 Java 数据库连接
后端框架的学习----mybatis框架(3、配置解析)
这篇文章详细介绍了MyBatis框架的核心配置文件解析,包括环境配置、属性配置、类型别名设置、映射器注册以及SqlSessionFactory和SqlSession的生命周期和作用域管理。
后端框架的学习----mybatis框架(3、配置解析)
|
JSON 中间件 Go
go语言后端开发学习(四) —— 在go项目中使用Zap日志库
本文详细介绍了如何在Go项目中集成并配置Zap日志库。首先通过`go get -u go.uber.org/zap`命令安装Zap,接着展示了`Logger`与`Sugared Logger`两种日志记录器的基本用法。随后深入探讨了Zap的高级配置,包括如何将日志输出至文件、调整时间格式、记录调用者信息以及日志分割等。最后,文章演示了如何在gin框架中集成Zap,通过自定义中间件实现了日志记录和异常恢复功能。通过这些步骤,读者可以掌握Zap在实际项目中的应用与定制方法
1169 1
go语言后端开发学习(四) —— 在go项目中使用Zap日志库
|
NoSQL Java Redis
shiro学习四:使用springboot整合shiro,正常的企业级后端开发shiro认证鉴权流程。使用redis做token的过滤。md5做密码的加密。
这篇文章介绍了如何使用Spring Boot整合Apache Shiro框架进行后端开发,包括认证和授权流程,并使用Redis存储Token以及MD5加密用户密码。
673 0
shiro学习四:使用springboot整合shiro,正常的企业级后端开发shiro认证鉴权流程。使用redis做token的过滤。md5做密码的加密。
|
前端开发 Java
学习SpringMVC,建立连接,请求,响应 SpringBoot初学,如何前后端交互(后端版)?最简单的能通过网址访问的后端服务器代码举例
文章介绍了如何使用SpringBoot创建简单的后端服务器来处理HTTP请求,包括建立连接、编写Controller处理请求,并返回响应给前端或网址。
705 0
学习SpringMVC,建立连接,请求,响应 SpringBoot初学,如何前后端交互(后端版)?最简单的能通过网址访问的后端服务器代码举例
|
人工智能 Go
go validator 值为 0 required 验证
go validator 值为 0 required 验证
261 6
|
Java 数据库连接 mybatis
后端框架的学习----mybatis框架(9、多对一处理和一对多处理)
这篇文章介绍了在MyBatis框架中如何处理多对一和一对多的关联查询,通过定义`<resultMap>`和使用`<association>`与`<collection>`元素来实现对象间的关联映射。

热门文章

最新文章