golang实现jwt鉴权

发布时间:2024-12-29 22:11:14

Golang实现JWT鉴权

JWT（JSON Web Token）是一种用于在网络环境中传递声明的十分轻便的方式。在很多Web应用程序中，使用JWT进行身份验证和授权已经成为了标准做法。Golang作为一种高性能的编程语言，有着丰富的库和工具支持，实现JWT鉴权非常方便。

生成JWT令牌

要生成JWT令牌，首先需要安装并导入相应的库。


go get github.com/dgrijalva/jwt-go


import "github.com/dgrijalva/jwt-go"

然后，定义一个结构体来存储用户信息：


type User struct {
  ID       uint   `json:"id"`
  Username string `json:"username"`
  Email    string `json:"email"`
}

接下来，创建一个处理JWT令牌的函数：


func CreateToken(user *User) (string, error) {
  token := jwt.New(jwt.SigningMethodHS256)
  
  claims := token.Claims.(jwt.MapClaims)
  claims["id"] = user.ID
  claims["username"] = user.Username
  claims["email"] = user.Email
  claims["exp"] = time.Now().Add(time.Hour * 24).Unix()
  
  tokenString, err := token.SignedString([]byte("secret-key"))
  if err != nil {
    return "", err
  }
  
  return tokenString, nil
}

这个函数会返回一个签名过的JWT令牌字符串。在函数中，我们首先使用`jwt.New()`函数创建一个新的令牌，并指定签名方法为HS256。

然后，我们将用户信息存储到令牌的Claims字段中，并设置有效期为24小时。

最后，调用`SignedString()`方法并传入一个密钥，生成签名过的令牌字符串。

验证JWT令牌

要验证JWT令牌，首先需要解析令牌并检查是否被篡改。


func ValidateToken(tokenString string) (*User, error) {
  token, err := jwt.Parse(tokenString, func(token *jwt.Token) (interface{}, error) {
    if _, ok := token.Method.(*jwt.SigningMethodHMAC); !ok {
      return nil, fmt.Errorf("unexpected signing method")
    }
    
    return []byte("secret-key"), nil
  })
  
  if err != nil {
    return nil, err
  }
  
  claims, ok := token.Claims.(jwt.MapClaims)
  if !ok || !token.Valid {
    return nil, fmt.Errorf("invalid token")
  }
  
  user := &User{
    ID:       uint(claims["id"].(float64)),
    Username: claims["username"].(string),
    Email:    claims["email"].(string),
  }
  
  return user, nil
}

在这个函数中，我们使用`jwt.Parse()`方法解析传入的令牌字符串，并使用`SigningMethodHMAC`进行验证。

然后，我们检查Claims字段的类型和令牌的有效性。如果都符合预期，则将各个字段的值解析到User结构体中，并返回。

使用JWT鉴权

为了在Web应用程序中使用JWT进行鉴权，我们可以在用户登录成功后生成JWT令牌，并将其返回给客户端。


func LoginHandler(w http.ResponseWriter, r *http.Request) {
  // 验证用户信息
  
  user := &User{
    ID:       1,
    Username: "example",
    Email:    "example@example.com",
  }
  
  token, err := CreateToken(user)
  if err != nil {
    // 处理错误
  }
  
  json.NewEncoder(w).Encode(token)
}

在这个示例中，我们在用户登录成功后创建一个JWT令牌，并使用`json.NewEncoder()`将其编码为JSON格式，并返回给客户端。

在其他需要验证用户身份的请求中，只需要解析并验证JWT令牌即可：


func ProtectedHandler(w http.ResponseWriter, r *http.Request) {
  tokenString := // 从请求头或cookie中获取JWT令牌
  
  user, err := ValidateToken(tokenString)
  if err != nil {
    // 处理错误
  }
  
  // 执行受保护的操作
}

在上面的示例中，我们从请求头或cookie中获取JWT令牌，并使用`ValidateToken()`函数验证令牌的有效性，如果验证通过，则可以执行受保护的操作。

总结

通过Golang实现JWT鉴权可以帮助我们在Web应用程序中轻松地进行用户身份验证和授权。通过生成和验证JWT令牌，我们可以确保请求来自合法的用户，并执行受保护的操作。

在实际应用中，我们可以根据具体的需求来扩展JWT的功能，例如添加权限管理、刷新令牌等。

golang实现jwt鉴权