Golang JWT生成与解析库sjwt使用指南

sjwt是一个简单高效的Golang JWT(JSON Web Token)库，它提供了简洁的API来生成和解析JWT令牌。下面我将详细介绍如何使用这个库。

安装

首先安装sjwt库：

go get github.com/ssleert/sjwt

基本用法

1. 生成JWT令牌

package main

import (
	"fmt"
	"time"
	
	"github.com/ssleert/sjwt"
)

func main() {
	// 设置密钥
	secret := "your-secret-key"

	// 创建claims
	claims := sjwt.New()
	claims.Set("username", "john_doe")
	claims.Set("role", "admin")
	claims.SetExpiresAt(time.Now().Add(24 * time.Hour)) // 24小时后过期

	// 生成JWT
	token, err := claims.Generate(secret)
	if err != nil {
		fmt.Println("生成JWT失败:", err)
		return
	}

	fmt.Println("生成的JWT:", token)
}

2. 解析和验证JWT

package main

import (
	"fmt"
	
	"github.com/ssleert/sjwt"
)

func main() {
	secret := "your-secret-key"
	token := "your.jwt.token.here"

	// 解析并验证JWT
	claims, err := sjwt.Parse(token, secret)
	if err != nil {
		fmt.Println("JWT验证失败:", err)
		return
	}

	// 获取claims中的值
	username, _ := claims.GetStr("username")
	role, _ := claims.GetStr("role")
	
	fmt.Printf("用户名: %s, 角色: %s\n", username, role)
	
	// 检查token是否过期
	if claims.IsExpired() {
		fmt.Println("Token已过期")
	} else {
		fmt.Println("Token有效")
	}
}

高级功能

1. 自定义Claims

type UserClaims struct {
	Username string `json:"username"`
	Role     string `json:"role"`
	Email    string `json:"email"`
}

func main() {
	secret := "your-secret-key"
	
	user := UserClaims{
		Username: "john_doe",
		Role:     "admin",
		Email:    "john@example.com",
	}

	claims := sjwt.New()
	claims.Set("user", user)
	claims.SetExpiresAt(time.Now().Add(12 * time.Hour))

	token, err := claims.Generate(secret)
	if err != nil {
		fmt.Println("生成JWT失败:", err)
		return
	}

	fmt.Println("生成的JWT:", token)
}

2. 从JWT解析回结构体

func main() {
	secret := "your-secret-key"
	token := "your.jwt.token.here"

	claims, err := sjwt.Parse(token, secret)
	if err != nil {
		fmt.Println("JWT验证失败:", err)
		return
	}

	var user UserClaims
	if err := claims.GetTo("user", &user); err != nil {
		fmt.Println("解析用户信息失败:", err)
		return
	}

	fmt.Printf("用户信息: %+v\n", user)
}

3. 设置签发时间和其他标准Claims

func main() {
	secret := "your-secret-key"

	claims := sjwt.New()
	claims.SetIssuer("my-app")                    // 签发者
	claims.SetSubject("user-auth")                // 主题
	claims.SetAudience([]string{"web", "mobile"}) // 受众
	claims.SetIssuedAt(time.Now())                // 签发时间
	claims.SetNotBefore(time.Now())               // 生效时间
	claims.SetExpiresAt(time.Now().Add(24 * time.Hour)) // 过期时间
	claims.Set("username", "john_doe")

	token, err := claims.Generate(secret)
	if err != nil {
		fmt.Println("生成JWT失败:", err)
		return
	}

	fmt.Println("生成的JWT:", token)
}

性能考虑

sjwt在设计上注重性能：

1. 使用高效的JSON编解码
2. 最小化内存分配
3. 优化的签名算法实现

安全建议

1. 使用足够强的密钥（至少32字节）
2. 设置合理的过期时间
3. 不要在客户端存储敏感信息
4. 使用HTTPS传输JWT

// 生成强密钥示例
import "crypto/rand"

func generateStrongSecret() string {
	b := make([]byte, 32)
	if _, err := rand.Read(b); err != nil {
		panic(err)
	}
	return string(b)
}

总结

sjwt提供了简单直观的API来处理JWT的生成和验证，适合大多数Golang项目。它的轻量级设计和良好的性能使其成为处理身份验证和授权需求的优秀选择。