当前位置：首页 > news >正文

Golang实现JWT认证与Casbin权限控制实战

news 2026/7/18 9:46:02

1. 项目概述

在现代Web应用开发中，身份验证与授权是保障系统安全的两大基石。这个Golang项目通过JWT(JSON Web Token)实现身份验证，结合Casbin进行细粒度的权限控制，构建了一套完整的访问控制解决方案。

我曾在多个生产级项目中实践过这套技术组合，发现它既能满足严格的权限管理需求，又保持了良好的开发效率。特别是在微服务架构中，这种无状态的认证授权方案展现出极大的优势。

2. 技术选型解析

2.1 JWT的核心优势

JWT之所以成为现代身份验证的首选方案，主要基于以下几个特点：

无状态性：服务端不需要存储会话信息，所有必要数据都包含在Token本身中
自包含性：Token包含完整的用户信息和元数据，减少数据库查询
跨域支持：非常适合前后端分离和微服务架构
标准化：作为RFC 7519标准，有完善的生态系统支持

// 典型的JWT生成代码示例 func GenerateJWT(user User) (string, error) { token := jwt.NewWithClaims(jwt.SigningMethodHS256, jwt.MapClaims{ "user_id": user.ID, "exp": time.Now().Add(time.Hour * 24).Unix(), }) return token.SignedString([]byte("your-secret-key")) }

2.2 Casbin的权限模型

Casbin提供了灵活的权限控制模型，支持多种访问控制策略：

ACL (访问控制列表)：最简单的用户-资源-操作三元组
RBAC (基于角色的访问控制)：通过角色关联权限
ABAC (基于属性的访问控制)：更细粒度的属性判断

# 典型的Casbin模型配置(rbac_model.conf) [request_definition] r = sub, obj, act [policy_definition] p = sub, obj, act [role_definition] g = _, _ [policy_effect] e = some(where (p.eft == allow)) [matchers] m = g(r.sub, p.sub) && r.obj == p.obj && r.act == p.act

3. 实现细节剖析

3.1 JWT身份验证实现

3.1.1 Token生成与验证

完整的JWT流程包括：

用户登录成功后生成Access Token和Refresh Token
Access Token设置较短有效期(如30分钟)
Refresh Token用于在Access Token过期后获取新Token

// Token生成示例 func CreateToken(userID string) (*TokenDetails, error) { td := &TokenDetails{} td.AtExpires = time.Now().Add(time.Minute * 30).Unix() td.TokenUuid = uuid.New().String() atClaims := jwt.MapClaims{ "access_uuid": td.TokenUuid, "user_id": userID, "exp": td.AtExpires, } at := jwt.NewWithClaims(jwt.SigningMethodHS256, atClaims) var err error td.AccessToken, err = at.SignedString([]byte(os.Getenv("ACCESS_SECRET"))) if err != nil { return nil, err } return td, nil }

3.1.2 Token刷新机制

为避免频繁登录，实现Refresh Token机制：

Refresh Token有效期较长(如7天)
当Access Token过期时，使用Refresh Token获取新Token
每次刷新后使旧Refresh Token失效

3.2 Casbin权限控制实现

3.2.1 策略定义与加载

Casbin策略可以存储在文件或数据库中。对于小型项目，CSV文件是简单有效的选择：

# policy.csv p, admin, /api/users, GET p, admin, /api/users, POST p, user, /api/profile, GET g, alice, admin g, bob, user

3.2.2 中间件实现

在Gin框架中，我们可以创建Casbin中间件进行权限校验：

func CasbinMiddleware(enforcer *casbin.Enforcer) gin.HandlerFunc { return func(c *gin.Context) { // 从JWT中获取用户角色 user := GetCurrentUser(c) // 检查权限 path := c.Request.URL.Path method := c.Request.Method if ok, _ := enforcer.Enforce(user.Role, path, method); !ok { c.AbortWithStatusJSON(403, gin.H{"error": "forbidden"}) return } c.Next() } }