202 Star 1.9K Fork 614

张奇峰 / GinSkeleton

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
captcha.md 2.12 KB
一键复制 编辑 原始数据 按行查看 历史

验证码

1.基于 github.com/dchest/captcha 包封装.
2.本项目只提供了数字验证功能,没有封装语音验证功能.

定义的路由地址

1.路由地址

验证码业务控制器地址

1.验证码业务 , 验证数字长度、验证码尺寸(宽 x 高)在这里设置.

使用步骤

1.获取验证码ID等信息

    # get 方式请求获取验证ID等信息
    http://127.0.0.1:20201/captcha/
    
    #返回值中携带了获取验证码图片的地址以及校验地址

2.获取验证码

    # get , 根据步骤1中返回值提示获取 验证码ID  
    http://127.0.0.1:20201/captcha/验证码ID.png

3.校验验证码

    # get ,  根据步骤1中返回值提示进行校验验证即可  
    http://127.0.0.1:20201/captcha/验证码ID/验证码正确值  

任何路由(接口)都可以调用我们封装好的验证码中间件

  • 1.已经封装好的验证码中间件:authorization.CheckCaptchaAuth()
  • 2.一般是登录接口,需要验证码校验,那么我们可以直接调用验证码中间件增加校验机制。
  • 3.注意:如果直接调用了验证码中间件,一般都是和登陆接口搭配,所以请求方式为 POST

    // 已有的登陆接口(路由),不需要验证码即可登陆
    noAuth.POST("login", validatorFactory.Create(consts.ValidatorPrefix+"UsersLogin"))
    
    // 只需要添加验证码中间件即可启动登陆前的验证机制
    // 本质上就是给登陆接口增加了2个参数:验证码id提交时的键:captcha_id 和 验证码值提交时的键 captcha_value,具体参见配置文件
    //noAuth.Use(authorization.CheckCaptchaAuth()).POST("login", validatorFactory.Create(consts.ValidatorPrefix+"UsersLogin"))

备注说明

1.验证码ID一旦提交到校验接口(步骤3)进行验证,不管输入的验证码正确与否,该ID都会失败,需要从步骤1开始重新获取.

Go
1
https://gitee.com/daitougege/GinSkeleton.git
git@gitee.com:daitougege/GinSkeleton.git
daitougege
GinSkeleton
GinSkeleton
master

搜索帮助