Kratos 接口防刷需自研Redis滑动窗口限流中间件,key为"brush:{ip}/{appid}:{path}";防篡改须实现HMAC-SHA256签名验签,校验timestamp偏移与nonce防重放,二者须分层独立拦截且顺序严格。

Kratos 微服务安全防护不能只靠 JWT 认证中间件,接口防刷和防篡改必须独立设计、分层拦截。JWT 解决的是“你是谁”,但解决不了“你是不是在刷接口”或“参数有没有被中间人改过”。这两个问题在 Kratos 中需结合 middleware、自定义拦截器和外部存储(如 Redis)协同实现。
如何用 Kratos 实现接口防刷(限流)
Kratos 的 middleware/ratelimit/ratelimit.go 提供了限流能力,但默认的 BBR 限流器适用于服务间调用场景,不直接适配面向公网的接口防刷需求——它不区分用户身份、不支持按 IP 或 AppID 维度计数。
- 生产中应自行封装基于 Redis 的滑动窗口限流中间件,key 设计为
"brush:{ip}:{path}"或"brush:{appid}:{path}",value 用 Redis 的INCR+EXPIRE组合实现 - 避免在
ratelimit.Server()中直接使用bbr.NewLimiter做外网接口防护,它没有用户粒度控制,容易误伤正常流量 - 限流阈值建议分级:未登录用户(IP 级)10 次/分钟,已认证 AppID 100 次/分钟,内部服务调用不限(或走 BBR)
- 注意 Redis 连接池配置,防刷中间件是高频调用路径,连接不足会导致请求阻塞在
redis.Get()
如何防止接口被篡改(签名验证)
Kratos 本身不提供签名验签中间件,需手动实现。核心逻辑是:提取请求头或 query 中的 appid、timestamp、nonce 和 sign,拼接后与服务端重算签名比对。
- 签名算法推荐 HMAC-SHA256,密钥从
config.Config加载,**严禁硬编码在代码里**,更不能写死在jwt.Server()的回调函数中 -
timestamp必须校验时间偏移,建议允许 ±180 秒,超出直接返回ErrTimestampExpired(自定义错误码) -
nonce要存入 Redis 并设置 5 分钟过期,防止重放;key 用"nonce:{appid}:{nonce}",避免不同 AppID 的 nonce 冲突 - 签名原文必须固定排序(如按参数名字典序),且排除
sign字段本身;Kratos 的http.Request参数获取建议用r.URL.Query()+r.PostForm合并后标准化处理
为什么不能把防刷和验签都塞进一个中间件?
两者失败后的响应语义和可观测性要求完全不同:防刷失败要返回 429 Too Many Requests,记录 rate_limit_exceeded 指标;验签失败必须返回 401 Unauthorized 或 403 Forbidden,并触发安全告警。混在一起会模糊错误边界,也增加调试难度。
- 防刷中间件应在链路最前端(比如在
tracing和logging之前),快速拒绝恶意流量 - 验签中间件应放在认证中间件之后、业务 handler 之前,确保只有合法 AppID 才进入验签流程
- Kratos 的 middleware 执行顺序由
http.Middleware()数组顺序决定,顺序错位会导致nonce已被消费但签名未校验,或限流绕过验签
真正容易被忽略的是 nonce 的 Redis 存储一致性:如果服务多实例部署,而 Redis 是单点或主从异步复制,可能因延迟导致重放请求偶然通过。生产环境务必用 Redis Cluster 或开启 WAIT 1 1000 保证写入强一致。











