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) -11 表示校验成功并删除,0 表示不匹配,-1 表示不存在或已过期,-2 表示错误次数达到上限并使凭据失效。
安全边界
验证码发送还应按账号、手机号、IP 和设备维度限流,避免攻击者绕过单一维度。签发新验证码时应删除旧错误计数,或让错误键包含验证码版本,防止新验证码继承旧次数。临时令牌必须使用密码学安全随机值,并限制用途、有效期和可使用次数。
日志不得记录完整验证码、令牌或未脱敏的手机号。对于找回密码、支付确认等高风险操作,还应结合账户状态、设备风险和二次校验。
按自己的节奏,确认真正理解。