第 6 期 · M1 注册与验证码
· 阅读需 4 分钟
站点可以开放注册了;注册和多次登录失败之后需要验证码,验证码可以是内置图形验证码,也可以是 Turnstile、reCAPTCHA、hCaptcha,在后台随时切换。
本期完成
internal/captcha:四种验证码的统一接口。内置图形验证码用 Go Bold 字体逐字旋转、缩放,加干扰曲线、整体扭曲与噪点;每个挑战只能试一次。三家第三方共用一套 siteverify 实现,reCAPTCHA 走 recaptcha.net。- 注册:
auth.registration、auth.registrations_per_ip、score.initial三个设置;先校验字段、再校验验证码、最后才算哈希;按精确地址(数据库)与 IPv6 /64(内存)计数。 - 登录:同一客户端失败 3 次后要求验证码;对单个账号的分布式攻击让所有人都要验证码,而不是锁定账号(兑现了 ADR 0012 的计划)。
- 前端:
/auth/register、统一的Captcha组件(按需加载第三方脚本、失败后自动换新挑战)、登录页按需显示验证码、页头与首页的注册按钮随设置显示或隐藏。字段错误改为共享的本地化文案。 - 设计记录:ADR 0014 注册与验证码;文档站新增"账号、注册与验证码"。
本地实测(skinloom up --dev,全新数据目录)
- 注册页显示图形验证码;故意填错验证码提交:提示"验证码不正确或已过期",自动换一张新图,其它字段保留。
- 用命令行把
captcha.provider改为none,运行中的站点 2 秒内生效,注册页的验证码随之消失;注册成功后自动登录为普通用户。 - 改回图形验证码,退出后连续输错 3 次密码,第 4 次登录要求验证码。
- 关闭注册:注册页显示"暂未开放注册",注册接口返回 403,页头与首页的注册按钮全部隐藏(首页按钮最初没有隐藏:默认主题显式配置了指向注册页的按钮,于是改为按目标地址判断)。
- 服务端日志无警告、无错误。
验证码本身没有在浏览器里手动"解"过:服务端校验由单元测试与 HTTP 测试覆盖(第三方提供方用本地假服务器模拟成功、答错、密钥错误、服务中断)。
测试
- 验证码:图形挑战只能用一次、答错即作废、过期、大小写不敏感、存储上限、字符分布均匀、PNG 尺寸;siteverify 的表单参数与各种返回。
- 账号:注册(安装前拒绝、关闭、字段错误、邮箱大小写重复、初始积分、自动登录、审计)、按地址计数(精确地址重启后仍有效、IPv6 同 /64)、登录验证码(3 次后要求、其它客户端不受影响、120 次分布式失败后带验证码仍能登录)。SQLite 与 PostgreSQL 均通过。
- HTTP:注册流程、字段错误不消耗验证码、登录要求验证码、图形验证码接口、bootstrap 不泄露 secret。
问题与风险
- 图形验证码存在后端进程内存里,多副本后端需要会话保持或改用第三方验证码(文档已说明)。
- 注册接口会提示"邮箱已注册",靠验证码与按地址限流控制枚举速度;邮件验证上线后再改为统一提示。
- 第三方验证码只做了服务端的模拟测试,没有用真实密钥在浏览器里验证过。
下期计划
邮件队列与 SMTP 设置、邮箱验证、找回密码(一次性令牌,重置后吊销全部会话);然后是个人资料与后台用户管理。