一、背景
最近在使用到Golang进行原生开发,注册和登录页面都涉及到图片验证码的功能。找了下第三方库的一些实现,发现了这个库用得还是蛮多的。并且支持很多类型的验证方式,例如支持数字类型、字母类型、音频验证码、中文验证码等等。
项目地址: https://github.com/mojocn/base64Captcha
官方文档地址: https://captcha.mojotv.cn/.netlify/functions/captcha
支持多种验证码类型(多种验证码驱动):
二、基本使用
1、生成验证码base64字符串
生成验证码的基本逻辑顺序如下:
0、需要准备存储验证码的一种驱动实现Store接口,库中有一个基于Store接口的内存存储方案的默认实现类: base64Captcha.DefaultMemStore
1、需要定义生成验证码类型的Driver驱动类实例, 配置验证码信息,例如图片大小、高度、模糊度等等
2、通过base64Captcha.NewCaptcha(&driver, store),生成验证码的base64字符串、验证码ID、验证码的答案、以及error信息, 最后重点拿到验证码ID、验证码base64字符串响应给前端进行展示
3、最后底层会将数据存储到store存储方式中,这个store类实现了Store接口,将验证码信息进行存储
// 这里我自己实现了一个基于Redis的Store存储驱动类
var store = captcha.NewRedisStore(db.GetRedisConn())func GenCaptcha() (string, string) {// 设置验证码驱动类型,这里是数字运算类型的验证码 // 例如会生成几个数的基本运算, 最后求运算结果作为验证码结果driver := base64Captcha.DriverMath{ Height: 50,Width: 200,NoiseCount: 0,}captchaObj := base64Captcha.NewCaptcha(&driver, store)captchaId, b64s, _, err := captchaObj.Generate()if err != nil {panic(err.Error())}return captchaId, b64s // 拿到验证码ID、验证码的base64字符串
}
拿到验证码ID、验证码的base64字符串, 前端页面使用一个隐藏的input存储验证码ID、一个input作为表单提交验证码的值、一个img标签,将src设置为这个base64字符串,即可正常显示这个验证码.
前端局部代码如下:
显示效果如下:
后端查看Redis的存储信息: 可以看到验证码ID、验证码答案 8 x 5 = 40
2、后端校验验证码
后端校验的大致逻辑就是:
0、需要准备存储验证码的一种驱动实现store,库有有一个基于Store接口的内存存储方案的实现类base64Captcha.DefaultMemStore。 这个使用刚才和生成验证码的store变量一样即可
1、直接通过store对象,调用Verify方法,传递验证码ID、以及验证码答案即可, 验证结果返回true则代表通过, 返回false则表示不通过. 还有一个参数clear(bool), 代表执行验证后无论是否通过,都需要将这个验证码删除/作废
func VerifyCaptcha(captchaId string, answer string) bool {return store.Verify(captchaId, answer, true)
}
后端获取验证码,进行校验的代码截图:
3、Redis存储驱动代码: RedisStore
非生产环境代码,只是简单示例,请勿使用在生产环境。 因为有些逻辑没有做严格校验以及测试
package captchaimport ("context""github.com/redis/go-redis/v9""sync""time"
)const captchaKey = "string:captcha:"var ctx = context.Background()type RedisStore struct {redisClient *redis.Clientmtx sync.Mutex
}func (r *RedisStore) Set(id string, value string) error {r.mtx.Lock()defer r.mtx.Unlock()key := captchaKey + idresult := r.redisClient.SetNX(ctx, key, value, time.Second*60)if result.Err() != nil {return result.Err()}return nil
}func (r *RedisStore) Get(id string, clear bool) string {r.mtx.Lock()defer r.mtx.Unlock()key := captchaKey + idresult := r.redisClient.Get(ctx, key)if result.Err() != nil {return ""}if clear {go r.redisClient.Del(ctx, key)}return result.Val()
}func (r *RedisStore) Verify(id, answer string, clear bool) bool {r.mtx.Lock()defer r.mtx.Unlock()key := captchaKey + idresult := r.redisClient.Get(ctx, key)if result.Err() != nil {return false}storeAnswer := result.Val()if clear {go r.redisClient.Del(ctx, key)}return answer == storeAnswer
}func NewRedisStore(redisClient *redis.Client) *RedisStore {return &RedisStore{redisClient: redisClient,mtx: sync.Mutex{},}
}
三、总结
使用mojocn/base64Captcha库可以简单的生成验证码base64图片信息,方便了我们进行Web开发。 如果需要更高级或者详细的使用方式,请查看官方文档。
在实现Store存储驱动的时候,还要考虑我们的图片验证码例如访问频率限制、怎么针对有特征的客户端进行限流, 除了验证码有过期时间以外, 如是否有IP访问限流? 或者其他防御手段, 这样才能确保我们的后端Redis不会被恶意刷新,导致Redis内存撑爆了.