在 Gin 框架中使用 JSON Web 令牌（JWT）进行安全身份验证

2023-09-18 00:17:30

1. 简介

JSON Web 令牌 (JWT) 是一种紧凑的、自包含的令牌，可以用来在应用程序之间安全地传输信息。JWT 通常用于在用户和应用程序之间共享身份信息。它包含三个部分：

头部：包含令牌的元数据，如令牌类型和算法。
主体：包含有关用户的信息，如用户名和电子邮件地址。
签名：用来验证令牌的完整性和真实性。

2. 在 Gin 框架中使用 JWT

在 Gin 框架中，可以使用 JWT 中间件来轻松地实现 JWT 身份验证。下面是详细的步骤：

2.1 安装 JWT 中间件

import (
    "github.com/gin-gonic/gin"
    "github.com/golang-jwt/jwt/v4"
)

func main() {
    r := gin.Default()

    // 使用默认配置初始化 JWT 中间件
    r.Use(jwt.New())

    // 在需要身份验证的路由上使用 JWT 中间件
    r.GET("/api/private", func(c *gin.Context) {
        // 从上下文中获取当前用户
        user := c.MustGet("user").(*jwt.Token)

        // 使用用户信息渲染模板
        c.HTML(200, "private.tmpl", gin.H{
            "user": user,
        })
    })

    // 启动 Gin 服务器
    r.Run()
}

2.2 生成 JWT 令牌

// 生成 JWT 令牌
func GenerateJWT(claims jwt.Claims) (string, error) {
    // 创建 JWT 令牌
    token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)

    // 使用密钥对令牌进行签名
    tokenString, err := token.SignedString([]byte("secret"))
    if err != nil {
        return "", err
    }

    return tokenString, nil
}

2.3 验证 JWT 令牌

// 验证 JWT 令牌
func VerifyJWT(tokenString string) (*jwt.Token, error) {
    // 使用密钥验证令牌
    token, err := jwt.ParseWithClaims(tokenString, &jwt.StandardClaims{}, func(token *jwt.Token) (interface{}, error) {
        return []byte("secret"), nil
    })
    if err != nil {
        return nil, err
    }

    // 检查令牌是否有效
    if !token.Valid {
        return nil, errors.New("invalid token")
    }

    return token, nil
}