tokenpocket钱包官方苹果app下载|gtoken

作者: tokenpocket钱包官方苹果app下载
2024-03-07 19:04:12

gtoken: 基于gf框架的token插件，通过服务端验证方式实现token认证；已完全可以支撑线上token认证，并支持集群模式

开源

企业版

高校版

搜索

帮助中心

使用条款

关于我们

开源

企业版

高校版

私有云

Gitee AI

NEW

我知道了

查看详情

代码拉取完成，页面将自动刷新

开源项目

WEB应用开发

OAuth/单点登录/统一认证

捐赠

捐赠前请先登录

取消

前往登录

扫描微信二维码支付

取消

支付完成

支付提示

将跳转至支付宝完成支付

确定

取消

Watch

不关注

关注所有动态

仅关注版本发行动态

关注但不提醒动态

Star

Fork

goflyfox / gtoken

代码

Issues

Pull Requests

Wiki

统计

流水线

服务

Gitee Pages

质量分析

Jenkins for Gitee

腾讯云托管

腾讯云 Serverless

悬镜安全

阿里云 SAE

Codeblitz

我知道了，不再自动展开

加入 Gitee

与超过 1200万开发者一起发现、参与优秀开源项目，私有仓库也完全免费：）

免费加入

已有帐号？

立即登录

master

管理

分支 (3)

标签 (49)

master

dev

v1.4.5

v1.5.10

v1.5.9

v1.5.8

v1.5.7

v1.5.6

v1.5.4

v1.4.5.1

v1.5.3

v1.5.2

v1.5.1

v1.5.0

v1.4.5

v1.4.3

v1.4.4

v1.4.2

v1.4.1

v1.4.0

v1.3.21

v1.3.20

v1.3.19

克隆/下载

HTTPS

SSH

SVN

SVN+SSH

下载ZIP

登录提示

该操作需登录 Gitee 帐号，请先登录后再操作。

立即登录

没有帐号，去注册

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别，请执行以下命令完成配置

git config --global user.name userName

git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时，需按下述提示完成 SSH 配置

生成 RSA 密钥

获取 RSA 公钥内容，并配置到 SSH公钥中

在 Gitee 上使用 SVN，请访问使用指南

使用 HTTPS 协议时，命令行会出现如下账号密码验证步骤。基于安全考虑，Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com':

私人令牌

新建文件

新建 Diagram 文件

新建子模块

上传文件

分支 3

标签 49

贡献代码

同步代码

创建 Pull Request

了解更多

对比差异

通过 Pull Request 同步

同步更新到分支

通过 Pull Request 同步

将会在向当前分支创建一个 Pull Request，合入后将完成同步

zhangb

update version

4b19df9

129 次提交

提交

取消

提示:

由于 Git 不支持空文件夾，创建文件夹后会生成空的 .keep 文件

example

保存

取消

gtoken

保存

取消

.gitignore

保存

取消

ChangeLog.md

保存

取消

LICENSE

保存

取消

README.md

保存

取消

go.mod

保存

取消

go.sum

保存

取消

README

Apache-2.0

gtoken

介绍

基于GoFrame框架的token插件，通过服务端验证方式实现token认证；已完全可以支撑线上token认证，通过Redis支持集群模式；使用简单，大家可以放心使用；

全面适配GoFrame v2.0.0 ; GoFrame v1.X.X 请使用gtoken v1.4.X相关版本;

github地址：https://github.com/goflyfox/gtoken

gitee地址：https://gitee.com/goflyfox/gtoken

gtoken优势

gtoken支撑单点应用测试使用内存存储，支持个人项目文件存储，也支持企业集群使用redis存储；完全适用于企业生产级使用；

有效的避免了jwt服务端无法退出问题；

解决jwt无法作废已颁布的令牌，只能等到令牌过期问题；

通过用户扩展信息存储在服务端，有效规避了jwt携带大量用户扩展信息导致降低传输效率问题；

有效避免jwt需要客户端实现续签功能，增加客户端复杂度；支持服务端自动续期，客户端不需要关心续签逻辑；

特性说明

支持token认证，不强依赖于session和cookie，适用jwt和session认证所有场景；

支持单机gcache和集群gredis模式；

# 缓存模式 1 gcache 2 gredis 3 fileCache

CacheMode = 2

支持服务端缓存自动续期功能

// 注：通过MaxRefresh，默认当用户第五天访问时，自动续期

// 超时时间默认10天

Timeout int

// 缓存刷新时间默认为超时时间的一半

MaxRefresh int

支持分组拦截、全局拦截、深度路径拦截，便于根据个人需求定制拦截器；建议使用分组拦截方式；

框架使用简单，只需要设置登录验证方法以及登录、登出路径即可；

在gtoken v1.4.0版本开始支持分组中间件方式实现，但依然兼容全局和深度中间件实现方式；

在gtoken v1.5.0全面适配GoFrame v2.0.0 ; GoFrame v1.X.X 请使用GfToken v1.4.X相关版本;

安装教程

gopath模式: go get github.com/goflyfox/gtoken

或者使用go.mod添加 :require github.com/goflyfox/gtoken latest

分组中间件实现

GoFrame官方推荐使用Group方式实现路由和中间件；

使用说明

推荐使用分组方式实现

// 启动gtoken

gfToken := >oken.GfToken{

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

}

s.Group("/admin", func(group *ghttp.RouterGroup) {

group.Middleware(CORS)

gfToken.Middleware(group)

group.ALL("/system/user", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user"))

})

………………

})

登录方法实现，通过username返回空或者r.ExitAll()\r.Exit()处理认证失败；

特别提示：这里注册的路径严格按照GF group方式，所以注册的路径是/admin/login和/admin/user/logout

func Login(r *ghttp.Request) (string, interface{}) {

username := r.GetPostString("username")

passwd := r.GetPostString("passwd")

// TODO 进行登录校验

if username == "" || passwd == "" {

r.Response.WriteJson(gtoken.Fail("账号或密码错误."))

r.ExitAll()

}

// 第一个字段是用户唯一标识，第二个字段是扩展参数user data

return username, ""

}

通过gtoken.GetTokenData(r)获取登录信息

路径拦截规则

AuthExcludePaths: g.SliceStr{"/user/info", "/system/user/*"}, // 不拦截路径 /user/info,/system/user/info,/system/user,

分组中间件实现，不需要设置AuthPaths认证路径，设置也没有作用，需要认证路径为该分组下所有路由；

使用分组拦截的是通过GoFrame的group.Middleware(authMiddleware)方法，对该分组下的所有路由进行拦截；

对登录接口路径loginPath和登出接口路径logoutPath做拦截认证放行，登出放行是为了避免认证过期无法登出情况；

严格按照GoFrame分组中间件拦截优先级；如果使用跨域中间件，建议放在跨域中间件之后；

如果配置AuthExcludePaths路径，会将配置的不拦截路径排除；

逻辑测试

参考sample项目，先运行main.go，然后可运行api_test.go进行测试并查看结果；验证逻辑说明：

访问用户信息，提示未携带token

调用登录后，携带token访问正常

调用登出提示成功

携带之前token访问，提示未登录

=== RUN TestAdminSystemUser

api_admin_test.go:22: 1. not login and visit user

api_admin_test.go:29: {"code":-401,"msg":"请求错误或登录超时","data":""}

api_admin_test.go:42: 2. execute login and visit user

api_admin_test.go:45: {"code":0,"msg":"success","data":"system user"}

api_admin_test.go:51: 3. execute logout

api_admin_test.go:54: {"code":0,"msg":"success","data":"Logout success"}

api_admin_test.go:60: 4. visit user

api_admin_test.go:65: {"code":-401,"msg":"请求错误或登录超时","data":""}

全局中间件实现

使用说明

只需要配置登录路径、登出路径、拦截路径以及登录校验实现即可

// 启动gtoken

gtoken := >oken.GfToken{

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

AuthPaths: g.SliceStr{"/user", "/system"}, // 这里是按照前缀拦截，拦截/user /user/list /user/add ...

GlobalMiddleware: true, // 开启全局拦截，默认关闭

}

gtoken.Start()

登录方法实现，通过username返回空或者r.ExitAll()\r.Exit()处理认证失败；

func Login(r *ghttp.Request) (string, interface{}) {

username := r.GetPostString("username")

passwd := r.GetPostString("passwd")

// TODO 进行登录校验

if username == "" || passwd == "" {

r.Response.WriteJson(gtoken.Fail("账号或密码错误."))

r.ExitAll()

}

// 第一个字段是用户唯一标识，第二个字段是扩展参数user data

return username, ""

}

通过gtoken.GetTokenData(r)获取登录信息

路径拦截规则

AuthPaths: g.SliceStr{"/user", "/system"}, // 这里是按照前缀拦截，拦截/user /user/list /user/add ...

AuthExcludePaths: g.SliceStr{"/user/info", "/system/user/*"}, // 不拦截路径 /user/info,/system/user/info,/system/user,

GlobalMiddleware: true, // 开启全局拦截，默认关闭

GlobalMiddleware:true全局拦截的是通过GF的BindMiddleware方法创建拦截/*

GlobalMiddleware:false路径拦截的是通过GF的BindMiddleware方法创建拦截/user*和/system/*

按照中间件优先级路径拦截优先级很高；如果先实现部分中间件在认证前处理需要切换成全局拦截器，严格按照注册顺序即可；

程序先处理认证路径，如果满足；再排除不拦截路径；

如果只想用排除路径功能，将拦截路径设置为/*即可；

逻辑测试

参考sample1项目，先运行main.go，然后可运行api_test.go进行测试并查看结果；验证逻辑说明：

访问用户信息，提示未携带token

调用登录后，携带token访问正常

调用登出提示成功

携带之前token访问，提示未登录

=== RUN TestSystemUser

api_test.go:43: 1. not login and visit user

api_test.go:50: {"code":-401,"msg":"请求错误或登录超时","data":""}

api_test.go:63: 2. execute login and visit user

api_test.go:66: {"code":0,"msg":"success","data":"system user"}

api_test.go:72: 3. execute logout

api_test.go:75: {"code":0,"msg":"success","data":"Logout success"}

api_test.go:81: 4. visit user

api_test.go:86: {"code":-401,"msg":"请求错误或登录超时","data":""}

返回码及配置项

正常操作成功返回0

未登录访问需要登录资源返回401

程序异常返回-99，如编解码错误等

SUCCESS = 0 // 正常

FAIL = -1 // 失败

ERROR = -99 // 异常

UNAUTHORIZED = -401 // 未认证

配置项说明

具体可参考GfToken结构体，字段解释如下：

名称

配置字段

说明

分组中间件

全局中间件

服务名

ServerName

默认空即可

支持

缓存模式

CacheMode

1 gcache 2 gredis 3 fileCache 默认1

支持

缓存key

CacheKey

默认缓存前缀GToken:

支持

超时时间

Timeout

默认10天（毫秒）

支持

缓存刷新时间

MaxRefresh

默认为超时时间的一半（毫秒）

支持

Token分隔符

TokenDelimiter

默认_

支持

Token加密key

EncryptKey

默认12345678912345678912345678912345

支持

认证失败提示

AuthFailMsg

默认请求错误或登录超时

支持

是否支持多端登录

MultiLogin

默认false

支持

中间件类型

MiddlewareType

1、Group 2、Bind 3 、Global；使用分组模式不需要设置

支持

登录路径

LoginPath

登录接口路径

支持

登录验证方法

LoginBeforeFunc

登录验证需要用户实现方法

支持

登录返回方法

LoginAfterFunc

登录完成后调用

支持

登出地址

LogoutPath

登出接口路径

支持

登出验证方法

LogoutBeforeFunc

登出接口前调用

支持

登出返回方法

LogoutAfterFunc

登出接口完成后调用

支持

拦截地址

AuthPaths

此路径列表进行认证

不需要

支持

拦截排除地址

AuthExcludePaths

此路径列表不进行认证

支持

认证验证方法

AuthBeforeFunc

拦截认证前后调用

支持

认证返回方法

AuthAfterFunc

拦截认证完成后调用

支持

文档

https://goframe.org/pages/viewpage.action?pageId=1115974

感谢

gf框架 https://github.com/gogf/gf

项目支持

项目的发展，离不开大家得支持~！~

阿里云：ECS云服务器新人优惠券；请点击这里

也可以请作者喝一杯咖啡:)

Apache License

Version 2.0, January 2004

http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,

and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by

the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all

other entities that control, are controlled by, or are under common

control with that entity. For the purposes of this definition,

"control" means (i) the power, direct or indirect, to cause the

direction or management of such entity, whether by contract or

otherwise, or (ii) ownership of fifty percent (50%) or more of the

outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity

exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,

including but not limited to software source code, documentation

source, and configuration files.

"Object" form shall mean any form resulting from mechanical

transformation or translation of a Source form, including but

not limited to compiled object code, generated documentation,

and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or

Object form, made available under the License, as indicated by a

(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object

form, that is based on (or derived from) the Work and for which the

editorial revisions, annotations, elaborations, or other modifications

represent, as a whole, an original work of authorship. For the purposes

of this License, Derivative Works shall not include works that remain

separable from, or merely link (or bind by name) to the interfaces of,

the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including

the original version of the Work and any modifications or additions

to that Work or Derivative Works thereof, that is intentionally

submitted to Licensor for inclusion in the Work by the copyright owner

or by an individual or Legal Entity authorized to submit on behalf of

the copyright owner. For the purposes of this definition, "submitted"

means any form of electronic, verbal, or written communication sent

to the Licensor or its representatives, including but not limited to

communication on electronic mailing lists, source code control systems,

and issue tracking systems that are managed by, or on behalf of, the

Licensor for the purpose of discussing and improving the Work, but

excluding communication that is conspicuously marked or otherwise

designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity

on behalf of whom a Contribution has been received by Licensor and

subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of

this License, each Contributor hereby grants to You a perpetual,

worldwide, non-exclusive, no-charge, royalty-free, irrevocable

publicly display, publicly perform, sublicense, and distribute the

Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of

this License, each Contributor hereby grants to You a perpetual,

worldwide, non-exclusive, no-charge, royalty-free, irrevocable

(except as stated in this section) patent license to make, have made,

use, offer to sell, sell, import, and otherwise transfer the Work,

where such license applies only to those patent claims licensable

by such Contributor that are necessarily infringed by their

Contribution(s) alone or by combination of their Contribution(s)

with the Work to which such Contribution(s) was submitted. If You

institute patent litigation against any entity (including a

cross-claim or counterclaim in a lawsuit) alleging that the Work

or a Contribution incorporated within the Work constitutes direct

or contributory patent infringement, then any patent licenses

granted to You under this License for that Work shall terminate

as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the

Work or Derivative Works thereof in any medium, with or without

modifications, and in Source or Object form, provided that You

meet the following conditions:

(a) You must give any other recipients of the Work or

Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices

stating that You changed the files; and

that You distribute, all copyright, patent, trademark, and

attribution notices from the Source form of the Work,

excluding those notices that do not pertain to any part of

the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its

distribution, then any Derivative Works that You distribute must

include a readable copy of the attribution notices contained

within such NOTICE file, excluding those notices that do not

pertain to any part of the Derivative Works, in at least one

of the following places: within a NOTICE text file distributed

as part of the Derivative Works; within the Source form or

documentation, if provided along with the Derivative Works; or,

within a display generated by the Derivative Works, if and

wherever such third-party notices normally appear. The contents

of the NOTICE file are for informational purposes only and

do not modify the License. You may add Your own attribution

notices within Derivative Works that You distribute, alongside

or as an addendum to the NOTICE text from the Work, provided

that such additional attribution notices cannot be construed

as modifying the License.

You may add Your own copyright statement to Your modifications and

may provide additional or different license terms and conditions

for use, reproduction, or distribution of Your modifications, or

for any such Derivative Works as a whole, provided Your use,

reproduction, and distribution of the Work otherwise complies with

the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise,

any Contribution intentionally submitted for inclusion in the Work

by You to the Licensor shall be under the terms and conditions of

this License, without any additional terms or conditions.

Notwithstanding the above, nothing herein shall supersede or modify

the terms of any separate license agreement you may have executed

with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade

names, trademarks, service marks, or product names of the Licensor,

except as required for reasonable and customary use in describing the

origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or

agreed to in writing, Licensor provides the Work (and each

Contributor provides its Contributions) on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or

implied, including, without limitation, any warranties or conditions

of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A

PARTICULAR PURPOSE. You are solely responsible for determining the

appropriateness of using or redistributing the Work and assume any

risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory,

whether in tort (including negligence), contract, or otherwise,

unless required by applicable law (such as deliberate and grossly

negligent acts) or agreed to in writing, shall any Contributor be

liable to You for damages, including any direct, indirect, special,

incidental, or consequential damages of any character arising as a

result of this License or out of the use or inability to use the

Work (including but not limited to damages for loss of goodwill,

work stoppage, computer failure or malfunction, or any and all

other commercial damages or losses), even if such Contributor

has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing

the Work or Derivative Works thereof, You may choose to offer,

and charge a fee for, acceptance of support, warranty, indemnity,

or other liability obligations and/or rights consistent with this

License. However, in accepting such obligations, You may act only

on Your own behalf and on Your sole responsibility, not on behalf

of any other Contributor, and only if You agree to indemnify,

defend, and hold each Contributor harmless for any liability

incurred by, or claims asserted against, such Contributor by reason

of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following

boilerplate notice, with the fields enclosed by brackets "[]"

replaced with your own identifying information. (Don't include

the brackets!) The text should be enclosed in the appropriate

comment syntax for the file format. We also recommend that a

file or class name and description of purpose be included on the

same "printed page" as the copyright notice for easier

identification within third-party archives.

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.

Starred

Star

Fork

捐赠

0 人次

举报成功

我们将于2个工作日内通过站内信反馈结果给你！

请认真填写举报原因，尽可能描述详细。

举报类型

请选择举报类型

举报原因

取消

发送

误判申诉

此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。

如您确认内容无涉及不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。

取消

提交

简介

基于gf框架的token插件，通过服务端验证方式实现token认证；已完全可以支撑线上token认证，并支持集群模式

展开

收起

暂无标签

100.0%

Apache-2.0

使用 Apache-2.0 开源许可协议

保存更改

取消

发行版

暂无发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

1. 开源生态

生产力：来评估开源项目输出软件制品和开源价值的能力。

创新力：用于评估开源软件及其生态系统的多样化程度。

稳健性：用于评估开源项目面对多变的发展环境，抵御内外干扰并自我恢复的能力。

2. 协作、人、软件

协作：代表了开源开发行为中协作的程度和深度。

人：观察开源项目核心人员在开源项目中的影响力，并通过第三方视角考察用户和开发者对开源项目的评价。

软件：从开源项目对外输出的制品评估其价值最终落脚点。也是开源评估最“古老”的主流方向之一“开源软件” 的具体表现。

3. 评估模型

基于“开源生态”与“协作、人、软件”的维度，找到与该目标直接或间接相关的可量化指标，对开源项目健康与生态进行量化评估，最终形成开源评估指数。

贡献者

全部

近期动态

加载更多

不能加载更多了

编辑仓库简介

简介内容

基于gf框架的token插件，通过服务端验证方式实现token认证；已完全可以支撑线上token认证，并支持集群模式

主页

取消

保存更改

https://gitee.com/goflyfox/gtoken.git

git@gitee.com:goflyfox/gtoken.git

goflyfox

gtoken

master

Git 大全

Git 命令学习

CopyCat 代码克隆检测

APP与插件下载

Gitee Reward

Gitee 封面人物

GVP 项目

Gitee 博客

Gitee 公益计划

Gitee 持续集成

OpenAPI

帮助文档

在线自助服务

更新日志

关于我们

加入我们

使用条款

意见建议

合作伙伴

售前咨询客服

技术交流QQ群

微信服务号

client#oschina.cn

企业版在线使用：400-606-0201

专业版私有部署：

13670252304

13352947997

开放原子开源基金会

合作代码托管平台

违法和不良信息举报中心

粤ICP备12009483号

简体

繁體

English

点此查找更多帮助

搜索帮助

Git 命令在线学习

如何在 Gitee 导入 GitHub 仓库

Git 仓库基础操作

企业版和社区版功能对比

SSH 公钥设置

如何处理代码冲突

仓库体积过大，如何减小？

如何找回被删除的仓库数据

Gitee 产品配额说明

GitHub仓库快速导入Gitee及同步更新

什么是 Release（发行版）

将 PHP 项目自动发布到 packagist.org

仓库举报

回到顶部

登录提示

该操作需登录 Gitee 帐号，请先登录后再操作。

立即登录

没有帐号，去注册

Gtoken “鉴权” 技术栈 - 知乎

Gtoken “鉴权” 技术栈 - 知乎首发于golang开发者实践切换模式写文章登录/注册Gtoken “鉴权” 技术栈文化科技君经济，人工智能，时讯，脱口秀，文学分享Gtoken基于GoFrame框架的token插件，通过服务端验证方式实现token认证；已完全可以支撑线上token认证，通过Redis支持集群模式。gtoken优势gtoken支撑单点应用使用内存存储，也支持集群使用redis存储；完全适用于企业生产级使用；有效的避免了jwt服务端无法退出问题；解决jwt无法作废已颁布的令牌，只能等到令牌过期问题；通过用户扩展信息存储在服务端，有效规避了jwt携带大量用户扩展信息导致降低传输效率问题；有效避免jwt需要客户端实现续签功能，增加客户端复杂度；支持服务端自动续期，客户端不需要关心续签逻辑；特性说明支持token认证，不强依赖于session和cookie，适用jwt和session认证所有场景；支持单机gcache和集群gredis模式；# 缓存模式 1 gcache 2 gredis 3 fileCache

CacheMode = 2

支持服务端缓存自动续期功能

// 注：通过MaxRefresh，默认当用户第五天访问时，自动续期

// 超时时间默认10天

Timeout int

// 缓存刷新时间默认为超时时间的一半

MaxRefresh int支持分组拦截、全局拦截、深度路径拦截，便于根据个人需求定制拦截器；建议使用分组拦截方式；框架使用简单，只需要设置登录验证方法以及登录、登出路径即可；在gtoken v1.4.0版本开始支持分组中间件方式实现，但依然兼容全局和深度中间件实现方式；分组实操分享GoFrame官方推荐使用Group方式实现路由和中间件； // 启动gtoken

gfToken := >oken.GfToken{

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

}

s.Group("/admin", func(group *ghttp.RouterGroup) {

group.Middleware(CORS)

gfToken.Middleware(group)

group.ALL("/system/user", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user"))

})

………………

})

登录方法实现，通过username返回空或者r.ExitAll()\r.Exit()处理认证失败；特别提示：这里注册的路径严格按照GF group方式，所以注册的路径是/admin/login和/admin/user/logoutfunc Login(r *ghttp.Request) (string, interface{}) {

username := r.GetPostString("username")

passwd := r.GetPostString("passwd")

// TODO 进行登录校验

if username == "" || passwd == "" {

r.Response.WriteJson(gtoken.Fail("账号或密码错误."))

r.ExitAll()

}

return username, ""

} 通过gtoken.GetTokenData(r)获取登录信息路径拦截规则 AuthExcludePaths: g.SliceStr{"/user/info", "/system/user/*"}, // 不拦截路径 /user/info,/system/user/info,/system/user,分组中间件实现，不需要设置AuthPaths认证路径，设置也没有作用，需要认证路径为该分组下所有路由；使用分组拦截的是通过GoFrame的group.Middleware(authMiddleware)方法，对该分组下的所有路由进行拦截；对登录接口路径loginPath和登出接口路径logoutPath做拦截认证放行，登出放行是为了避免认证过期无法登出情况；严格按照GoFrame分组中间件拦截优先级；如果使用跨域中间件，建议放在跨域中间件之后；如果配置AuthExcludePaths路径，会将配置的不拦截路径排除；逻辑测试参考sample项目，先运行main.go，然后可运行api_test.go进行测试并查看结果；验证逻辑说明：访问用户信息，提示未携带token调用登录后，携带token访问正常调用登出提示成功携带之前token访问，提示未登录=== RUN TestAdminSystemUser

api_admin_test.go:22: 1. not login and visit user

api_admin_test.go:29: {"code":-401,"msg":"请求错误或登录超时","data":""}

api_admin_test.go:42: 2. execute login and visit user

api_admin_test.go:45: {"code":0,"msg":"success","data":"system user"}

api_admin_test.go:51: 3. execute logout

api_admin_test.go:54: {"code":0,"msg":"success","data":"Logout success"}

api_admin_test.go:60: 4. visit user

api_admin_test.go:65: {"code":-401,"msg":"请求错误或登录超时","data":""}全局实操分享只需要配置登录路径、登出路径、拦截路径以及登录校验实现即可// 启动gtoken

gtoken := >oken.GfToken{

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

AuthPaths: g.SliceStr{"/user", "/system"}, // 这里是按照前缀拦截，拦截/user /user/list /user/add ...

GlobalMiddleware: true, // 开启全局拦截，默认关闭

}

gtoken.Start()

登录方法实现，通过username返回空或者r.ExitAll()\r.Exit()处理认证失败；func Login(r *ghttp.Request) (string, interface{}) {

username := r.GetPostString("username")

passwd := r.GetPostString("passwd")

// TODO 进行登录校验

if username == "" || passwd == "" {

r.Response.WriteJson(gtoken.Fail("账号或密码错误."))

r.ExitAll()

}

return username, ""

}通过gtoken.GetTokenData(r)获取登录信息路径拦截规则 AuthPaths: g.SliceStr{"/user", "/system"}, // 这里是按照前缀拦截，拦截/user /user/list /user/add ...

AuthExcludePaths: g.SliceStr{"/user/info", "/system/user/*"}, // 不拦截路径 /user/info,/system/user/info,/system/user,

GlobalMiddleware: true, // 开启全局拦截，默认关闭

GlobalMiddleware:true全局拦截的是通过GF的BindMiddleware方法创建拦截/*GlobalMiddleware:false路径拦截的是通过GF的BindMiddleware方法创建拦截/user*和/system/*按照中间件优先级路径拦截优先级很高；如果先实现部分中间件在认证前处理需要切换成全局拦截器，严格按照注册顺序即可；程序先处理认证路径，如果满足；再排除不拦截路径；如果只想用排除路径功能，将拦截路径设置为/*即可；逻辑测试参考sample1项目，先运行main.go，然后可运行api_test.go进行测试并查看结果；验证逻辑说明：访问用户信息，提示未携带token调用登录后，携带token访问正常调用登出提示成功携带之前token访问，提示未登录=== RUN TestSystemUser

api_test.go:43: 1. not login and visit user

api_test.go:50: {"code":-401,"msg":"请求错误或登录超时","data":""}

api_test.go:63: 2. execute login and visit user

api_test.go:66: {"code":0,"msg":"success","data":"system user"}

api_test.go:72: 3. execute logout

api_test.go:75: {"code":0,"msg":"success","data":"Logout success"}

api_test.go:81: 4. visit user

api_test.go:86: {"code":-401,"msg":"请求错误或登录超时","data":""}

分组拦截器 // 不认证接口

s.Group("/", func(group *ghttp.RouterGroup) {

group.Middleware(CORS)

// 调试路由

group.ALL("/hello", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("hello"))

})

// 认证接口

loginFunc := Login

// 启动gtoken

gfToken := >oken.GfToken{

ServerName: TestServerName,

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

AuthExcludePaths: g.SliceStr{"/user/info", "/system/user/info"}, // 不拦截路径 /user/info,/system/user/info,/system/user,

MultiLogin: g.Config().GetBool("gToken.MultiLogin"),

}

s.Group("/", func(group *ghttp.RouterGroup) {

group.Middleware(CORS)

gfToken.Middleware(group)

group.ALL("/system/user", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user"))

})

group.ALL("/user/data", func(r *ghttp.Request) {

r.Response.WriteJson(gfToken.GetTokenData(r))

})

group.ALL("/user/info", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("user info"))

})

group.ALL("/system/user/info", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user info"))

})

// 启动gtoken

gfAdminToken := >oken.GfToken{

ServerName: TestServerName,

//Timeout: 10 * 1000,

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

AuthExcludePaths: g.SliceStr{"/admin/user/info", "/admin/system/user/info"}, // 不拦截路径 /user/info,/system/user/info,/system/user,

MultiLogin: g.Config().GetBool("gToken.MultiLogin"),

}

s.Group("/admin", func(group *ghttp.RouterGroup) {

group.Middleware(CORS)

gfAdminToken.Middleware(group)

group.ALL("/system/user", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user"))

})

group.ALL("/user/info", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("user info"))

})

group.ALL("/system/user/info", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user info"))

})

})发布于 2023-03-08 21:58・IP 属地上海tokenGo 语言Go 编程赞同添加评论分享喜欢收藏申请转载文章被以下专栏收录golang开发者实践分享golang开

GitHub - goflyfox/gtoken: 基于gf框架的token插件，通过服务端验证方式实现token认证；

Toggle navigation

Product

Actions

Automate any workflow

Packages

Host and manage packages

Security

Find and fix vulnerabilities

Codespaces

Instant dev environments

Copilot

Write better code with AI

Code review

Manage code changes

Issues

Plan and track work

Discussions

Collaborate outside of code

Explore

All features

Documentation

GitHub Skills

Blog

Solutions

For

Enterprise

Teams

Startups

Education

By Solution

CI/CD & Automation

DevOps

DevSecOps

Resources

Learning Pathways

White papers, Ebooks, Webinars

Customer Stories

Partners

Open Source

GitHub Sponsors

Fund open source developers

The ReadME Project

GitHub community articles

Repositories

Topics

Trending

Collections

Pricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

You signed in with another tab or window. Reload to refresh your session.

You signed out in another tab or window. Reload to refresh your session.

You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

goflyfox

gtoken

Public

Notifications

Fork

Star

245

基于gf框架的token插件，通过服务端验证方式实现token认证；

License

Apache-2.0 license

245

stars

forks

Branches

通过阅读源码解决项目难题：GToken替换JWT实现SSO单点登录 - 掘金

首页首页

沸点

课程

直播

活动

竞赛

商城

APP

插件搜索历史

清空

创作者中心

写文章发沸点写笔记写代码草稿箱创作灵感

会员

通过阅读源码解决项目难题：GToken替换JWT实现SSO单点登录

王中阳Go

VIP.5 如鱼得水

2022-05-19

17,280

今天和大家分享一下使用GoFrame的gtoken替换jwt实现sso登录的经验，为了让大家更好的理解会带大家读一下重点的源码。

jwt的问题

首先说明一个jwt存在的问题，也就是要替换jwt的原因：

jwt无法在服务端主动退出的问题

jwt无法作废已颁布的令牌，只能等到令牌过期问题

jwt携带大量用户扩展信息导致降低传输效率问题

jwt的请求流程图

gtoken的优势

gtoken的请求流程和jwt的基本一致。

gtoken的优势就是能帮助我们解决jwt的问题，另外还提供好用的特性，比如：

gtoken支持单点应用使用内存存储，支持个人项目文件存储，也支持企业集群使用redis存储，完全适用于个人和企业生产级使用；

有效的避免了jwt服务端无法退出问题；

解决jwt无法作废已颁布的令牌，只能等到令牌过期问题；

通过用户扩展信息存储在服务端，有效规避了jwt携带大量用户扩展信息导致降低传输效率问题；

有效避免jwt需要客户端实现续签功能，增加客户端复杂度；支持服务端自动续期，客户端不需要关心续签逻辑；

注意问题

支持服务端缓存自动续期功能，不需要通过refresh_token刷新token，简化了客户端的操作

版本问题千万注意：在gtoken v1.5.0全面适配GoFrame v2.0.0 ; GoFrame v1.X.X 请使用GfToken v1.4.X相关版本

TIPS:下面我的演示demo和源码阅读都是基于v1.4.x版本的。

演示demo

下面的演示demo可以复制到本地main.go文件中执行，更新依赖的时候千万注意版本。

重点说一下踩的坑，Login方法会要求我们返回两个值：

第一个值对应userKey，后续我们可以根据userKey获得token

第二个值对应data，是interface{}类型，我们可以在这里定义例如userid、username等数据。

先有这个概念即可，为了让大家更好的理解，文章最后会带大家读源码。

入门示例

代码段的关键逻辑，已经添加了注释。

package main

import (

"github.com/goflyfox/gtoken/gtoken"

"github.com/gogf/gf/frame/g"

"github.com/gogf/gf/net/ghttp"

"github.com/gogf/gf/os/glog"

)

var TestServerName string

//var TestServerName string = "gtoken"

func main() {

glog.Info("########service start...")

g.Cfg().SetPath("example/sample")

s := g.Server(TestServerName)

initRouter(s)

glog.Info("########service finish.")

s.Run()

}

var gfToken *gtoken.GfToken

统一路由注册

func initRouter(s *ghttp.Server) {

// 不认证接口

s.Group("/", func(group *ghttp.RouterGroup) {

group.Middleware(CORS)

// 调试路由

group.ALL("/hello", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("hello"))

})

// 认证接口

loginFunc := Login

// 启动gtoken

gfToken := >oken.GfToken{

ServerName: TestServerName,

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

AuthExcludePaths: g.SliceStr{"/user/info", "/system/user/info"}, // 不拦截路径 /user/info,/system/user/info,/system/user,

MultiLogin: g.Config().GetBool("gToken.MultiLogin"),

}

s.Group("/", func(group *ghttp.RouterGroup) {

group.Middleware(CORS)

gfToken.Middleware(group)

group.ALL("/system/user", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user"))

})

group.ALL("/user/data", func(r *ghttp.Request) {

r.Response.WriteJson(gfToken.GetTokenData(r))

})

group.ALL("/user/info", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("user info"))

})

group.ALL("/system/user/info", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user info"))

})

// 启动gtoken

gfAdminToken := >oken.GfToken{

ServerName: TestServerName,

//Timeout: 10 * 1000,

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

AuthExcludePaths: g.SliceStr{"/admin/user/info", "/admin/system/user/info"}, // 不拦截路径 /user/info,/system/user/info,/system/user,

MultiLogin: g.Config().GetBool("gToken.MultiLogin"),

}

s.Group("/admin", func(group *ghttp.RouterGroup) {

group.Middleware(CORS)

gfAdminToken.Middleware(group)

group.ALL("/system/user", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user"))

})

group.ALL("/user/info", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("user info"))

})

group.ALL("/system/user/info", func(r *ghttp.Request) {

r.Response.WriteJson(gtoken.Succ("system user info"))

})

}

func Login(r *ghttp.Request) (string, interface{}) {

username := r.GetString("username")

passwd := r.GetString("passwd")

if username == "" || passwd == "" {

r.Response.WriteJson(gtoken.Fail("账号或密码错误."))

r.ExitAll()

}

return username, "1"

/**

返回的第一个参数对应：userKey

返回的第二个参数对应：data

{

"code": 0,

"msg": "success",

"data": {

"createTime": 1652838582190,

"data": "1",

"refreshTime": 1653270582190,

"userKey": "王中阳",

"uuid": "ac75676efeb906f9959cf35f779a1d38"

}

// 跨域

func CORS(r *ghttp.Request) {

r.Response.CORSDefault()

r.Middleware.Next()

}

运行效果

启动项目：

访问不认证接口：返回成功

未登录时访问认证接口：返回错误提示

请求登录接口：返回token

携带token再次访问认证接口：返回成功

以上就跑通了主体流程，就是这么简单。

分析源码

tips:下面带大家看的是 v1.4.1

下面带大家分析一下源码，学习一下作者是如何设计的。

刷新token

首先我认为gtoken很好的设计思想是不使用refresh_token来刷新token，而是服务端主动刷新。

在源码的getToken方法中做了更新refreshTime和createTime的处理。

更新createTime为当前时间，refreshTime为当前时间+自定义的刷新时间。

如下图所示，getToken方法在每次执行validToken校验token的时候都会调用，即每次校验token有效性时，如果符合刷新token有效期的条件，就会进行刷新操作(刷新token的过期时间，token值不变)

这样就实现了无感刷新token。

GfToken结构体

我们再来看一下GfToken的结构体，更好的理解一下作者的设计思路：

因为CacheMode支持redis，也就意味着支持集群模式。

我们在启动gtoken的时候，只需要设置登录和登出路径，另外登录和登出都提供了BeforeFunc和AfterFunc，让我们能清晰的界定使用场景。

// GfToken gtoken结构体

type GfToken struct {

// GoFrame server name

ServerName string

// 缓存模式 1 gcache 2 gredis 默认1

CacheMode int8

// 缓存key

CacheKey string

// 超时时间默认10天（毫秒）

Timeout int

// 缓存刷新时间默认为超时时间的一半（毫秒）

MaxRefresh int

// Token分隔符

TokenDelimiter string

// Token加密key

EncryptKey []byte

// 认证失败中文提示

AuthFailMsg string

// 是否支持多端登录，默认false

MultiLogin bool

// 是否是全局认证，兼容历史版本，已废弃

GlobalMiddleware bool

// 中间件类型 1 GroupMiddleware 2 BindMiddleware 3 GlobalMiddleware

MiddlewareType uint

// 登录路径

LoginPath string

// 登录验证方法 return userKey 用户标识如果userKey为空，结束执行

LoginBeforeFunc func(r *ghttp.Request) (string, interface{})

// 登录返回方法

LoginAfterFunc func(r *ghttp.Request, respData Resp)

// 登出地址

LogoutPath string

// 登出验证方法 return true 继续执行，否则结束执行

LogoutBeforeFunc func(r *ghttp.Request) bool

// 登出返回方法

LogoutAfterFunc func(r *ghttp.Request, respData Resp)

// 拦截地址

AuthPaths g.SliceStr

// 拦截排除地址

AuthExcludePaths g.SliceStr

// 认证验证方法 return true 继续执行，否则结束执行

AuthBeforeFunc func(r *ghttp.Request) bool

// 认证返回方法

AuthAfterFunc func(r *ghttp.Request, respData Resp)

}

思考题

我有N个子系统如何用gtoken实现sso登录呢？即实现一个子系统登录，其他各个子系统都自动登录，而无需二次登录呢？

想一想

我想到的解决方案是配合cookie实现：各个子系统二级域名不一致，但是主域名一致。

我在登录之后把token写入主域名的cookie中进行共享，前端网站通过cookie获得token请求服务接口。

同时在刷新token之后，也要刷新cookie的有效期，避免cookie失效导致获取不到token。

进一步阅读源码

在经过又一次仔细阅读源码之后，找到了刷新cookie有效期的合适场景：AuthAfterFunc，我们可以重写这个方法，来实现验证通过后的操作：

如果token验证有效则刷新cookie有效期；如果验证无效则自定义返回信息。（往往我们自己项目中的code码和gtoken定义的不一致，但是gtoken支持非常方便的重写返回值）

总结

我们项目之前是使用jwt实现sso登录，在刚刚拿到需求要重写时，自己也是一头雾水。

在没有认真阅读gtoken源码之前，我已经设计了refresh_token刷新的策略。

在仔细阅读源码之后，发现真香。

这次经历最大的收获是：碰到不好解决的问题时，带着问题去阅读源码是非常高效的方式。

一起学习

公众号：程序员升级打怪之旅

微信号：wangzhongyang1993

福利：点这里-->半价买掘金小册，额外领红包

王中阳Go

掘金签约作者 @程序员升职加薪之旅

270

文章

1.1m

阅读

4.0k

粉丝目录收起

jwt的问题

jwt的请求流程图

gtoken的优势

注意问题

演示demo

入门示例

运行效果

启动项目：

访问不认证接口：返回成功

未登录时访问认证接口：返回错误提示

请求登录接口：返回token

携带token再次访问认证接口：返回成功

分析源码

刷新token

GfToken结构体

思考题

进一步阅读源码

总结

一起学习

友情链接：

娱乐高清正版视频

莲花香图解

angularjs json转换

火车头采集 js

mysql慢查询设置路径

没有被你改写一生怎配有心事

gtoken: 基于gf框架的token插件，通过服务端验证方式实现token认证；

开源

企业版

高校版

搜索

帮助中心

使用条款

关于我们

开源

企业版

高校版

私有云

Gitee AI

NEW

我知道了

查看详情

代码拉取完成，页面将自动刷新

捐赠

捐赠前请先登录

取消

前往登录

扫描微信二维码支付

取消

支付完成

支付提示

将跳转至支付宝完成支付

确定

取消

Watch

不关注

关注所有动态

仅关注版本发行动态

关注但不提醒动态

Star

Fork

tanglichong / gtoken

代码

Issues

Pull Requests

Wiki

统计

流水线

服务

Gitee Pages

JavaDoc

PHPDoc

质量分析

Jenkins for Gitee

腾讯云托管

腾讯云 Serverless

悬镜安全

阿里云 SAE

Codeblitz

我知道了，不再自动展开

加入 Gitee

与超过 1200万开发者一起发现、参与优秀开源项目，私有仓库也完全免费：）

免费加入

已有帐号？

立即登录

master

管理

分支 (2)

标签 (28)

master

dev

v1.3.17

v1.3.16

v1.3.15

v1.3.14

v1.3.13

v1.3.12

v1.3.11

v1.3.10

v1.3.9

v1.3.8

v1.3.7

v1.3.6

v1.3.5

v1.3.4

v1.3.3

v1.3.2

v1.3.0

v1.3.1

v1.2.7

v1.2.5

克隆/下载

HTTPS

SSH

SVN

SVN+SSH

下载ZIP

登录提示

该操作需登录 Gitee 帐号，请先登录后再操作。

立即登录

没有帐号，去注册

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别，请执行以下命令完成配置

git config --global user.name userName

git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时，需按下述提示完成 SSH 配置

生成 RSA 密钥

获取 RSA 公钥内容，并配置到 SSH公钥中

在 Gitee 上使用 SVN，请访问使用指南

使用 HTTPS 协议时，命令行会出现如下账号密码验证步骤。基于安全考虑，Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com':

私人令牌

新建文件

新建 Diagram 文件

新建子模块

上传文件

分支 2

标签 28

贡献代码

同步代码

创建 Pull Request

了解更多

对比差异

通过 Pull Request 同步

同步更新到分支

通过 Pull Request 同步

将会在向当前分支创建一个 Pull Request，合入后将完成同步

zcool321@sina.com

add set GoFrame server name

fc4352f

61 次提交

提交

取消

提示:

由于 Git 不支持空文件夾，创建文件夹后会生成空的 .keep 文件

example

保存

取消

gtoken

保存

取消

.gitignore

保存

取消

ChangeLog.md

保存

取消

LICENSE

保存

取消

README.md

保存

取消

go.mod

保存

取消

go.sum

保存

取消

README

Apache-2.0

gtoken

介绍

基于gf框架的token插件，通过服务端验证方式实现token认证；已完全可以支撑线上token认证，并支持集群模式；使用简单，大家可以放心使用；

支持单机gcache和集群gredis模式；

# 配置文件

# 缓存模式 1 gcache 2 gredis

cache-mode = 2

支持简单token认证

加入缓存自动续期功能

// 注：通过MaxRefresh，默认当用户第五天访问时，自动再进行五天续期

// 超时时间默认10天

Timeout int

// 缓存刷新时间默认为超时时间的一半

MaxRefresh int

支持全局拦截或者深度路径拦截，便于根据个人需求定制拦截器

// 是否是全局认证

GlobalMiddleware bool

框架使用简单，只需要设置登录验证方法以及登录、登出、拦截路径即可；

github地址：https://github.com/goflyfox/gtoken

gitee地址：https://gitee.com/goflyfox/gtoken

gtoken优势

有效的避免了jwt服务端无法退出问题；

可以解决jwt无法作废已颁布的令牌；

用户扩展信息仍存储在服务端，可有效的减少传输空间；

gtoken支撑单点应用使用内存存储，也支持集群使用redis存储；

支持缓存自动续期，并且不需要客户端进行实现；

安装教程

gopath模式: go get github.com/goflyfox/gtoken

或者使用go.mod添加 :require github.com/goflyfox/gtoken latest

使用说明

只需要配置登录路径、登出路径、拦截路径以及登录校验实现即可

// 启动gtoken

gtoken := >oken.GfToken{

LoginPath: "/login",

LoginBeforeFunc: loginFunc,

LogoutPath: "/user/logout",

AuthPaths: g.SliceStr{"/user", "/system"}, // 这里是按照前缀拦截，拦截/user /user/list /user/add ...

GlobalMiddleware: true, // 开启全局拦截，默认关闭

}

gtoken.Start()

登录方法实现

func Login(r *ghttp.Request) (string, interface{}) {

username := r.GetPostString("username")

passwd := r.GetPostString("passwd")

// TODO 进行登录校验

return username, ""

}

路径拦截规则

AuthPaths: g.SliceStr{"/user", "/system"}, // 这里是按照前缀拦截，拦截/user /user/list /user/add ...

AuthExcludePaths: g.SliceStr{"/user/info", "/system/user/*"}, // 不拦截路径 /user/info,/system/user/info,/system/user,

GlobalMiddleware: true, // 开启全局拦截，默认关闭

GlobalMiddleware:true全局拦截的是通过GF的BindMiddleware方法创建拦截/*

GlobalMiddleware:false路径拦截的是通过GF的BindMiddleware方法创建拦截/user*和/system/*

按照中间件优先级路径拦截优先级很高；如果先实现部分中间件在认证前处理需要切换成全局拦截器，严格按照注册顺序即可；

程序先处理认证路径，如果满足；再排除不拦截路径；

如果只想用排除路径功能，将拦截路径设置为/*即可；

逻辑测试

可运行api_test.go进行测试并查看结果；验证逻辑说明：

访问用户信息，提示未携带token

登录后，携带token访问正常

登出成功

携带之前token访问，提示未登录

--- PASS: TestSystemUser (0.00s)

api_test.go:43: 1. not login and visit user

api_test.go:50: {"code":-1,"data":"","msg":"query token fail"}

api_test.go:63: 2. execute login and visit user

api_test.go:66: {"code":0,"msg":"success","data":"system user"}

api_test.go:72: 3. execute logout

api_test.go:75: {"code":0,"msg":"success","data":"logout success"}

api_test.go:81: 4. visit user

api_test.go:86: {"code":-1,"msg":"login timeout or not login","data":""}

感谢

gf框架 https://github.com/gogf/gf

项目支持

项目的发展，离不开大家得支持~！~

【双12】主会场低至1折；请点击这里

阿里云：ECS云服务器2折起；请点击这里