当前位置:

首页 > 编程开发 > Golang处理JWT认证与权限管理实践

Golang处理JWT认证与权限管理实践

使用Golang结合JWT实现认证与权限控制,通过github.com/golang-jwt/jwt/v5生成包含用户信息的Token,利用中间件解析Bearer令牌并校验角色权限,结合context传递用户数据,确保安全通信需配合HTTPS并妥善管理密钥。

本文目录

    使用Golang结合JWT实现认证与权限控制,通过github.com/golang-jwt/jwt/v5生成包含用户信息的Token,利用中间件解析Bearer令牌并校验角色权限,结合context传递用户数据,确保安全通信需配合HTTPS并妥善管理密钥。

    Golang如何处理JSON Web Token认证_Golang Web JWT认证与权限管理实践

    在现代 Web 应用中,用户认证和权限管理是核心功能之一。JSON Web Token(JWT)因其无状态、自包含的特性,被广泛用于 Golang 项目中的身份验证机制。下面介绍如何在 Golang 中实现 JWT 认证与基础的权限控制。

    JWT 基本原理与结构

    JWT 是一个经过加密签名的字符串,通常由三部分组成:头部(Header)、载荷(Payload)和签名(Signature),以点号分隔。它可以在客户端(如浏览器)存储,并随每次请求发送到服务器进行身份验证。

    在 Golang 中,常用 github.com/golang-jwt/jwt/v5 库来处理 JWT 的生成与解析。

    典型 JWT 结构示例:

    eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9. eyJ1c2VyX2lkIjoxMjMsInJvbGUiOiJ1c2VyIiwiaWF0IjoxNjAwMDAwMDAwLCJleHAiOjE2MDAwODAwMDB9. TJVA95OrM7E2cBab30ROYRFrHZYXJNBapLU_NbY

    使用 Golang 生成与解析 JWT

    先安装依赖:

    go get github.com/golang-jwt/jwt/v5

    定义用户信息结构和密钥:

    var jwtKey = []byte("your_secret_key") // 建议从环境变量读取

    type Claims struct { UserID uint json:"user_id" Role string json:"role" jwt.RegisteredClaims }

    生成 Token 示例:

    func GenerateToken(userID uint, role string) (string, error) { expirationTime := time.Now().Add(24 * time.Hour) claims := &Claims{ UserID: userID, Role: role, RegisteredClaims: jwt.RegisteredClaims{ ExpiresAt: jwt.NewNumericDate(expirationTime), IssuedAt: jwt.NewNumericDate(time.Now()), Issuer: "my-api", }, }
    token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
    return token.SignedString(jwtKey)

    }

    解析并验证 Token:

    func ParseToken(tokenStr string) (*Claims, error) { token, err := jwt.ParseWithClaims(tokenStr, &Claims{}, func(token *jwt.Token) (interface{}, error) { if _, ok := token.Method.(*jwt.SigningMethodHMAC); !ok { return nil, fmt.Errorf("unexpected signing method") } return jwtKey, nil })
    if err != nil {
        return nil, err
    }
    
    if claims, ok := token.Claims.(*Claims); token.Valid {
        return claims, nil
    }
    
    return nil, fmt.Errorf("invalid token")

    }

    在 HTTP 中间件中集成 JWT 验证

    通过中间件自动检查请求头中的 Authorization 字段,提取并验证 Token。

    func AuthMiddleware(requiredRole string) func(http.Handler) http.Handler { return func(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { authHeader := r.Header.Get("Authorization") if authHeader == "" { http.Error(w, "Authorization header missing", http.StatusUnauthorized) return }
            tokenStr := strings.TrimPrefix(authHeader, "Bearer ")
            if tokenStr == authHeader {
                http.Error(w, "Bearer token required", http.StatusUnauthorized)
                return
            }
    
            claims, err := ParseToken(tokenStr)
            if err != nil {
                http.Error(w, "Invalid or expired token", http.StatusUnauthorized)
                return
            }
    
            // 角色权限检查
            if requiredRole != "" && claims.Role != requiredRole {
                http.Error(w, "Insufficient permissions", http.StatusForbidden)
                return
            }
    
            // 将用户信息注入上下文
            ctx := context.WithValue(r.Context(), "userID", claims.UserID)
            ctx = context.WithValue(ctx, "role", claims.Role)
            next.ServeHTTP(w, r.WithContext(ctx))
        })
    }

    }

    在路由中使用:

    http.HandleFunc("/public", PublicHandler) http.Handle("/admin", AuthMiddleware("admin")(http.HandlerFunc(AdminHandler))) http.Handle("/user", AuthMiddleware("user")(http.HandlerFunc(UserHandler)))

    权限分级与上下文传递

    利用 Go 的 context 包,可以在请求生命周期内安全地传递用户身份和角色信息。避免重复解析 Token。

    获取当前用户信息:

    func AdminHandler(w http.ResponseWriter, r *http.Request) { userID := r.Context().Value("userID").(uint) role := r.Context().Value("role").(string)
    fmt.Fprintf(w, "Hello Admin %d (%s)", userID, role)

    }

    注意:context.Value 是非类型安全的,建议定义键常量避免冲突:

    type contextKey string const UserIDKey contextKey = "userID" // 存储时使用 context.WithValue(r.Context(), UserIDKey, id)

    基本上就这些。Golang 处理 JWT 简洁高效,配合中间件可轻松实现认证与权限控制。关键是保证密钥安全、合理设置过期时间,并结合 HTTPS 使用。不复杂但容易忽略细节。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Nod 0.8.1怎样理解状态码、Ray ID与计划检查
    Nod 0.8.1怎样理解状态码、Ray ID与计划检查

    Nod 0.8.1补充连接服务状态与原因、Attio Cloudflare 403诊断,并让Gmail在连接服务429或503后延后计划轮询。

    Ducter 0.0.59如何理解同会话聊天、Git可选和附件变化
    Ducter 0.0.59如何理解同会话聊天、Git可选和附件变化

    Ducter 0.0.59扩展Telegram、Slack和Mac iMessage会话,区分项目目录来源、Git可选、等待状态与附件入口。

    llama.cpp b12435、b12436、b12438测试构建的三类兼容变化有什么区别?
    llama.cpp b12435、b12436、b12438测试构建的三类兼容变化有什么区别?

    llama.cpp b12435、b12436、b12438预发布构建,分别解释Vulkan并列选择确定性、32位编译与Jinja JSON键排序的适用范围。

    ScopeWeaver 0.9.2、0.9.3与0.9.4如何区分运行时、Zod和任务状态变化
    ScopeWeaver 0.9.2、0.9.3与0.9.4如何区分运行时、Zod和任务状态变化

    ScopeWeaver 0.9.2、0.9.3与0.9.4分别调整桥运行时、Zod依赖和同进程服务器重建后的暂停状态;区分版本对象与作者本地研究用途声明。

    AG2 1.3.2的输入Token为何变多,旧ACP版本还能用吗
    AG2 1.3.2的输入Token为何变多,旧ACP版本还能用吗

    AG2 1.3.2统一缓存Token统计并更新ACP1.x依赖;解释预算提前触达、报表口径与Python3.15构建限制。

    llama.cpp b12433怎样为AMD奇数列保留MUL_MAT_ID回退路径
    llama.cpp b12433怎样为AMD奇数列保留MUL_MAT_ID回退路径

    llama.cpp b12433避免AMD设备将奇数src0列送入需要偶数列的MMVF路径:满足偶数条件才保留MMVF,其他形状沿用既有回退。对应改动发生在MUL_MAT_ID处理和相关同步判断中,范围限定于代码说明中的类型与token条件。

    Ducter 0.0.58如何区分下一步消息、完成后消息与后台会话
    Ducter 0.0.58如何区分下一步消息、完成后消息与后台会话

    Ducter 0.0.58调整任务阅读、执行中消息和后台会话,区分下一步发送与做完再说,并说明tailnet HTTPS辅助的条件。

    Unlimited OCR 2在TextMind能否直接使用,账号权限与模型示例如何区分
    Unlimited OCR 2在TextMind能否直接使用,账号权限与模型示例如何区分

    Unlimited OCR 2官方确认百度智能云TextMind渠道;区分云端入口、账号权限配额与本地模型部署,避免混淆接口和计费条件。

    TensorFold 1.2.9的Ollama接口和服务配置文件怎么用
    TensorFold 1.2.9的Ollama接口和服务配置文件怎么用

    TensorFold 1.2.9的服务配置文件用于保存和复用启动参数,Ollama兼容API则在同一推理路径上提供聊天、生成和模型查询等接口。理解配置优先级及后端限制,比只看到“兼容”就直接迁移全部流量更有用。

    如何理解Univer 1.5.2的二次混淆移除与构建边界?
    如何理解Univer 1.5.2的二次混淆移除与构建边界?

    理解Univer 1.5.2的关键,是把额外混淆与构建压缩分开。本版删除二次混淆插件及相关配置,同时保留Pro模块的minify设置;它解释的是产物处理方式的变化,不代表增加了表格或公式能力。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。