接口防护:限流、防重放、幂等性与安全校验
🎯 引言
学完这篇文章,你能区分频率控制、重复请求处理和恶意重放,并选择对应的服务端措施。
⏱ 用限流中间件控制请求次数
登录、发验证码等接口需要限制尝试次数。Express 项目可以使用 express-rate-limit,配置统计时间和次数,而不用手工维护计数表。
安装本节需要的依赖:
npm install express-rate-limit@8.7.1
新建 rate-server.mjs:
import express from 'express';
import { rateLimit } from 'express-rate-limit';
const app = express();
配置一分钟内允许五次请求:
const limiter = rateLimit({
windowMs: 60_000,
limit: 5,
standardHeaders: 'draft-8',
legacyHeaders: false,
message: { error: '请求过于频繁,请稍后再试' }
});
windowMs 是统计窗口的毫秒数,limit 是这个窗口内允许的次数。这里使用默认的客户端地址统计方式;standardHeaders 返回限流信息,legacyHeaders: false 关闭旧格式头。
🚪 把限流放在受保护操作之前
给测试接口挂上中间件:
app.get('/limited', limiter, (req, res) => {
res.json({ allowed: true });
});
app.listen(3000, '127.0.0.1');
运行 node rate-server.mjs,在同一个窗口内连续请求 /limited:前五次返回 200,第六次返回 429 和提示,并带 Retry-After 告诉调用者等待时间。窗口重置后可以再次访问。
在登录或发验证码接口中,将 limiter 放在密码计算、邮件发送之前,超限请求就不会进入这些昂贵操作。
🗃 部署时检查计数范围
默认计数存储位于当前进程内,适合本地验证;多个实例应配置共享存储,避免请求换一台服务就获得一份新的额度。
经过反向代理时,要按真实代理链配置可信代理,否则可能把所有用户都算成代理的同一个地址,也可能错误信任客户端伪造的地址。不要为了让限流工作就无条件开启信任所有代理。
只按地址统计可能影响同一网络下的多个用户。敏感接口通常还需要结合账号和操作设置额度,具体额度由业务风险决定。
🔁 幂等性保护正常重试
用户创建记录后网络断开,客户端不知道是否成功,再提交一次可能产生两条记录。可以要求客户端为同一次业务操作生成幂等键:
POST /api/v1/reports HTTP/1.1
Idempotency-Key: 8bc47c4e-0d44-42ca-852f-8ad93984db99
Content-Type: application/json
{"title":"本周记录"}
幂等性在这里表示:同一次创建操作重试多次,仍然只创建一条报告。Idempotency-Key 用来识别这次操作,客户端重试时必须保持这个值不变。
服务端保存当前用户、接口、这个键、提交内容和创建结果。假设首次请求创建了编号 12 的报告,后续处理如下:
| 再次收到的请求 | 服务端处理结果 |
|---|---|
| 同一个键、同样的标题 | 返回编号 12,不再创建 |
| 同一个键、改成另一个标题 | 返回 409,提示同一个键不能代表两次不同操作 |
| 原请求还没处理完 | 返回约定的处理中提示,让客户端稍后查询或重试 |
请求头本身不会自动防止重复创建。实现时,需要让数据库拒绝同一用户、同一接口下重复的键,并保证“创建报告”和“保存创建结果”一起成功或一起失败。这分别是数据库的唯一约束和事务所做的事。
🛑 防重放:不要让复制的请求再次执行操作
假设你接入一个视频处理平台:视频处理完成后,平台会向你的接口发送通知,你的服务器据此给用户新增一条“视频已处理完成”的站内消息。
如果有人拿到这次请求,把内容原样再发十次,而服务器每次都新增消息,用户就会收到重复消息。把有效请求复制后再次发送,就叫重放;防重放就是防止这些复制的请求再次执行操作。
先确认通知确实来自平台
第三方通知通常带有签名,也就是平台根据请求内容和约定的密钥生成的校验信息。接收通知时,用平台提供的库验证签名,检查发送方和内容是否可信;验证失败就拒绝处理。
但复制请求的人没有修改内容,也复制了签名,所以同一份请求仍可能验证通过。验签通过,只能说明这份内容可信,不能说明它是第一次到达。
再检查这条通知是否处理过
平台通常为每条通知提供一个事件 ID,例如 evt_123,用来区分不同通知。服务端把已经处理成功的事件 ID 保存到数据库:
| 收到的通知 | 服务端怎么做 |
|---|---|
第一次收到 evt_123 | 新增一条站内消息,并保存这条事件的处理记录 |
再次收到 evt_123 | 不再新增消息,按平台约定返回成功确认 |
收到新的 evt_124 | 作为另一条通知处理 |
数据库要限制同一平台的同一个事件 ID 只能保存一次,并让“新增消息”和“保存处理记录”一起成功或一起失败。这样两个重复请求同时到达时,也不会各新增一条消息;处理失败时,后续重试还有机会完成。
平台也可能因为没收到你的成功响应而主动重试,不一定是有人攻击。只要事件已经处理成功,就不再执行一次;这也用到了上一节的幂等处理。
有发送时间时,拒绝过旧的请求
如果平台的签名规则包含发送时间,还应使用它提供的验证方式检查时间。例如约定只接受五分钟内发送的请求,那么十分钟前的请求就应被拒绝。这个时间必须受签名保护,否则复制者可以直接改成当前时间。
具体时限遵循平台协议。五分钟内仍可能重复发送,因此时间检查不能代替事件 ID 检查。
🧭 三种保护不能互相替代
| 保护 | 回答的问题 | 不解决什么 |
|---|---|---|
| 限流 | 一段时间内请求是否过多 | 低频重复请求仍可能重复执行 |
| 幂等性 | 相同业务操作重复提交如何处理 | 不能证明请求来自可信身份 |
| 防重放 | 旧的有效消息是否被再次利用 | 不能替代字段与权限检查 |
所有修改还要检查当前身份、数据范围和字段。幂等键不是认证凭据,不能凭它直接返回其他用户的操作结果。
❓ 知识问答
Q1:每次重试都生成新的幂等键可以吗?
不可以,同一次业务操作的重试必须沿用原键,否则服务器会把它们视为不同操作。
Q2:加上时间戳就能防重放吗?
不够。请求在有效时间内仍能被重复发送,需要验证签名,并检查该事件是否已经处理过。
Q3:幂等记录可以马上删除吗?
不应在客户端仍可能重试时删除。保留期限要覆盖约定的重试窗口,同时管理过期清理。
🧪 小练习
为“发送验证码”和“创建报告”分别选择频率键与幂等规则,说明请求重复到达时应该拒绝、等待还是返回原结果。
// 请在这里编写代码或记录验证结果
