Redis 与缓存 / 系统课时

实现验证码与临时令牌

实现验证码与临时令牌

本课使用 Redis TTL 管理验证码和临时令牌,并通过 Lua 原子完成校验、错误计数与删除,确保短期凭据到期自动清理且成功后不能再次使用。

学习目标

  • 设计按用途隔离的短期凭据键
  • 原子校验并消费一次性凭据
  • 限制发送频率和错误尝试次数

写入短期凭据

不同用途必须使用不同键空间,例如 verify:login:<target> 和 verify:reset:<target>,避免登录验证码被用于重置密码。发送锁用于限制同一目标在短时间内重复获取验证码。

bash
TARGET="13800000000:demo-$$"
CODE_KEY="verify:login:${TARGET}"
SEND_KEY="verify:send-lock:login:${TARGET}"
ATTEMPT_KEY="verify:attempt:login:${TARGET}"

redis-cli SET "$CODE_KEY" 482913 EX 300
redis-cli SET "$SEND_KEY" 1 NX EX 60
redis-cli TTL "$CODE_KEY"

预期输出:

text
OK
OK
<REMAINING_SECONDS>

<REMAINING_SECONDS> 应为大于 0 且不超过 300 的整数,实际值会随执行耗时减少。生产环境不应直接保存可读明文验证码,可保存带服务端密钥的摘要。

原子校验与错误计数

脚本同时读取验证码、比较输入、累计错误次数,并在校验成功时删除验证码和错误计数。达到最大错误次数后立即使验证码失效。

lua
local codeKey = KEYS[1]
local attemptKey = KEYS[2]
local submittedCode = ARGV[1]
local maxAttempts = tonumber(ARGV[2])
local attemptTtl = tonumber(ARGV[3])

local value = redis.call("GET", codeKey)
if not value then
    return -1
end

if value == submittedCode then
    redis.call("DEL", codeKey, attemptKey)
    return 1
end

local attempts = redis.call("INCR", attemptKey)
if attempts == 1 then
    redis.call("EXPIRE", attemptKey, attemptTtl)
end

if attempts >= maxAttempts then
    redis.call("DEL", codeKey)
    return -2
end

return 0

将脚本保存为 verify-once.lua,在同一终端验证错误输入、成功消费和重复使用:

bash
redis-cli --eval verify-once.lua "$CODE_KEY" "$ATTEMPT_KEY" , 111111 5 300
redis-cli --eval verify-once.lua "$CODE_KEY" "$ATTEMPT_KEY" , 482913 5 300
redis-cli --eval verify-once.lua "$CODE_KEY" "$ATTEMPT_KEY" , 482913 5 300

预期输出:

text
(integer) 0
(integer) 1
(integer) -1

1 表示校验成功并删除,0 表示不匹配,-1 表示不存在或已过期,-2 表示错误次数达到上限并使凭据失效。

安全边界

验证码发送还应按账号、手机号、IP 和设备维度限流,避免攻击者绕过单一维度。签发新验证码时应删除旧错误计数,或让错误键包含验证码版本,防止新验证码继承旧次数。临时令牌必须使用密码学安全随机值,并限制用途、有效期和可使用次数。

日志不得记录完整验证码、令牌或未脱敏的手机号。对于找回密码、支付确认等高风险操作,还应结合账户状态、设备风险和二次校验。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现验证码与临时令牌

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通