在Go中使用jwt的教程详解

HS256 加密
生成 token
验证 token
RS256 加密
安装 openssl
生成 rsa 私钥
获取到 rsa 秘钥
生成 token
验证 token
生成 token 一般用 jwt，常用的两种加密方式是 HS256 和 RS256，借助 "github.com/golang-jwt/jwt/v5" 这个库来实现

jwt 由三部分组成：

header 头部
官方规定的字段：
alg: (algorithm) 算法
typ: (type) 类型
cty: (content type) 内容类型
kid: (key ID) 密钥 ID
x5u: (X.509 URL) X.509 地址
x5c: (X.509 certificate chain) X.509 证书链
crit: (critical) 关键
一般使用 alg 和 type，例如

{
  "alg": "HS256",
  "typ": "JWT"
}

payload 负载

官方规定的字段
iss: (issuer) 签发人
exp: (expiration time) 过期时间
sub: (subject) 主题
aud: (audience) 受众
nbf: (Not Before) 生效时间
iat: (Issued At) 签发时间
jti: (JWT ID) 编号
自定义字段
user: 用户信息
例如

{
  "exp": 1718254332,
  "iat": 1718167932,
  "user": {
    "email": "[e-mail]",
    "username": "jack22ssss22"
  }
}

signature 签名，这个签名不能泄漏，否则会被篡改
完整的 jwt 就是把这三部分组合起来 HMACSHA256(base64UrlEncode(Header).base64UrlEncode(Payload).Signature)

HS256 加密
HS256 是一种对称加密算法，使用秘密密钥对每条消息进行签名和验证

生成 token

func GenerateJWTHS256(username, email string) (string, error) {
  key := []byte("secret")
  tokenDuration := 24 * time.Hour
  now := time.Now()
  t := jwt.NewWithClaims(jwt.SigningMethodHS256, jwt.MapClaims{
    "user": map[string]string{
      "username": username,
      "email":    email,
    },
    "iat": now.Unix(),
    "exp": now.Add(tokenDuration).Unix(),
  })
  return t.SignedString(key)
}

验证 token

func VerifyJWTHS256(token string) (*jwt.MapClaims, bool, error) {
  var claim jwt.MapClaims
  claims, err := jwt.ParseWithClaims(token, &claim, func(t *jwt.Token) (interface{}, error) {
    return []byte("secret"), nil
  })
  if err != nil {
    return nil, false, err
  }
  if claims.Valid {
    return &claim, true, nil
  }
  return nil, false, nil
}

RS256 加密
RS256 是一种非对称加密算法，使用私钥加密明文，公钥解密密文

安装 openssl
apt install openssl
生成 rsa 私钥
在当前目录下生成一个 2048 位的私钥文件 private.pem
openssl genrsa -out private.pem 2048
获取到 rsa 秘钥

var privateKey *rsa.PrivateKey
var publicKey *rsa.PublicKey
 
func init() {
  var err error
  var bytes []byte
  bytes, err = os.ReadFile("/root/uccs/realworld/private.pem")
  if err != nil {
    panic(err)
  }
  privateKey, err = jwt.ParseRSAPrivateKeyFromPEM(bytes)
  if err != nil {
    panic(err)
  }
 
  bytes, err = os.ReadFile("/root/uccs/realworld/public.pem")
  if err != nil {
    panic(err)
  }
  publicKey, err = jwt.ParseRSAPublicKeyFromPEM(bytes)
  if err != nil {
    panic(err)
  }
}

生成 token

func GenerateJWTRS256(username, email string) (string, error) {
  tokenDuration := 24 * time.Hour
  now := time.Now()
  t := jwt.NewWithClaims(jwt.SigningMethodRS256, jwt.MapClaims{
    "user": map[string]string{
      "username": username,
      "email":    email,
    },
    "iat": now.Unix(),
    "exp": now.Add(tokenDuration).Unix(),
  })
  return t.SignedString(privateKey)
}

验证 token

func VerifyJWTRS256(token string) (*jwt.MapClaims, bool, error) {
  var claim jwt.MapClaims
  claims, err := jwt.ParseWithClaims(token, &claim, func(t *jwt.Token) (interface{}, error) {
    return publicKey, nil
  })
  if err != nil {
    return nil, false, err
  }
  if claims.Valid {
    return &claim, true, nil
  }
  return nil, false, nil
}