1. 介绍

JWT全称JSON Web Token是一种跨域认证解决方案，属于一个开放的标准，它规定了一种Token实现方式，目前多用于前后端分离项目和OAuth2.0业务场景下。

jwt-go 是使用Go语言实现的Json web token (JWT),目前GitHub Start 9.8k,源码地址: https://github.com/dgrijalva/jwt-go，从版本3.2.1开始,源码地址变更为: github.com/golang-jwt/jwt,需要下载最新版本时,可以使用这个地址。

2. 安装

1
2

// 下载最新版本
go get -u github.com/golang-jwt/jwt

3.生成JWT

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

// 设置声明
type UserClaims struct {
	*jwt.StandardClaims
	Name string
	Uid  uint
}
// 创建Jwt
func TestCreateJWTByNewWithClaims(t *testing.T) {
	nowTime := time.Now()
	// 使用NewWithClaims创建声明
	claims := jwt.NewWithClaims(jwt.SigningMethodHS256,&UserClaims{
		StandardClaims: &jwt.StandardClaims{
			// 设置有效期为5分钟
			ExpiresAt: nowTime.Add(time.Minute * 5).Unix(),
			Issuer: "猿码记", // 签发人
			IssuedAt: nowTime.Unix(), //签发时间
		},
		Name: "张三",
		Uid: 100,
	})
	// 使用指定的secret签名,获取字符串token
	signedString, err := claims.SignedString([]byte("这是我定义的secret"))
	if err != nil {
		t.Error(err)
		return
	}
	fmt.Println("生成JWT:",signedString)
}

/** 输出
=== RUN   TestCreateJWTByNewWithClaims
生成JWT: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MjY4NTM5OTcsImlhdCI6MTYyNjg1MzY5NywiaXNzIjoi54y_56CB6K6wIiwiTmFtZSI6IuW8oOS4iSIsIlVpZCI6MTAwfQ.GFu9ixPIMFauXUgu3GC35UD7ZuXLDN4l9M_8-k3yseE
--- PASS: TestCreateJWTByNewWithClaims (0.00s)
PASS
*/

4. 解析JWT

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

// 解析JWT
func TestValidJWT(t *testing.T) {
	jwtStr := "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MjY5MDk0MTYsImlhdCI6MTYyNjg1NTQxNiwiaXNzIjoi54y_56CB6K6wIiwiTmFtZSI6IuW8oOS4iSIsIlVpZCI6MTAwfQ.NG0qvleaLBVLrpOr89Z83c4EaYaVFbCnqY4POdIMuks"
	// 解析jwt,第三个参数是个函数，返回生成jwt设置的secret
	token, err := jwt.ParseWithClaims(jwtStr, &UserClaims{}, func(token *jwt.Token) (interface{}, error) {
		return []byte("这是我定义的secret"), nil
	})
	if err != nil {
		t.Error("解析失败:", err.Error())
		return
	}
	// 断言类型
	claim, ok := token.Claims.(*UserClaims)
	// 验证
	if !ok || !token.Valid {
		t.Error("解析失败,Token不合法!")
		return
	}
	fmt.Printf("解析结果: %+v\n", claim)
}

/** 输出
=== RUN   TestValidJWT
解析结果: &{StandardClaims:0xc0000a4360 Name:张三 Uid:100}
--- PASS: TestValidJWT (0.00s)
PASS
*/

更多使用可见文档: https://pkg.go.dev/github.com/dgrijalva/jwt-go