go使用jwt入门教程

更方便的在微信公众号阅读文章可以关注公众号：海生的go花园

一、介绍

jwt是 json web token的简称。
go使用jwt目前，主流使用的jwt库是golang-jwt/jwt

1.1 如何安装

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

1.2 import到项目里

import "github.com/golang-jwt/jwt/v4"

1.3 主流2类加密算法介绍

加密算法	代表算法	加解密
对称加密算法(hash加密) hsa	HS256(最常用), HS384, HS512	期望[]byte用于签名和验证的值
非对称签名方法 rsa	RS256(最常用), RS384,RS512	rsa.PrivateKey用于签名和*rsa.PublicKey验证

二、代码实现 -对称加密 hsa（hash加密）

2.1 生成token

我们使用 NewWithClaims(method SigningMethod, claims Claims) *Token来生成token,官方的源码如下

// NewWithClaims creates a new Token with the specified signing method and claims.
func NewWithClaims(method SigningMethod, claims Claims) *Token {
    return &Token{
        Header: map[string]interface{}{
            "typ": "JWT",
            "alg": method.Alg(),
        },
        Claims: claims,
        Method: method,
    }
}

其中我们需要传入一个 SigningMethod 加密算法，以及一个 Claims，需要加密的内容。

SigningMethod 我们这里使用 hsa256 哈希加盟
Claims 我们封装一个 UserClaims 如下

我们调用NewWithClaims生成token代码如下：

func TestHs256(t *testing.T) {
    type User struct {
        Id   int64
        Name string
    }
    type UserClaims struct {
        User User
        jwt.RegisteredClaims
    }
    // 1 jwt.NewWithClaims生成token
    user := User{
        Id:   101,
        Name: "hisheng",
    }
    userClaims := UserClaims{
        User:             user,
        RegisteredClaims: jwt.RegisteredClaims{},
    }
    token := jwt.NewWithClaims(jwt.SigningMethodHS256, userClaims)

    // 2 把token加密
    mySigningKey := []byte("ushjlwmwnwht")
    ss, err := token.SignedString(mySigningKey)
    t.Log(ss, err)
}

生成token分为两部分

1.使用jwt.NewWithClaims生产jwt.ToKen
2.把jwt.ToKen加密（这里我们需要添加一个加密key,使用base64url加密）

最后我们就得到了加密后的token，可以用来给客户端使用。

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VyIjp7IklkIjoxMDEsIk5hbWUiOiJoaXNoZW5nIn19.ij1kWID03f_CiELe0fPLZJ-Y64dkf2nDE-f6nGERBSE

token令牌由三部分组成，由.分隔。
前两部分是 JSON 对象，已经过base64url编码。
最后一部分是签名，以相同的方式编码。