开放接口 timestamp 差 300 秒报 401 重放窗口到底设多长

合作方反馈开放接口偶发 401,错误码 invalid timestamp。我们自己用脚本调一百次一次不复现,只有他们那边出现,集中在上午十点和下午三点。

第一反应是对方服务器时钟不准。让他们装 chrony,回话说已经开了。抓了一次失败请求,timestamp 和我们的服务器时间差 287 秒,正好压在我设的 300 秒窗口边缘。

网络延迟和时钟漂移叠加,边界就会破。试着把窗口放宽到 600 秒,问题少了,但安全那边不同意,说 10 分钟足够重放。这个方向走到头了。

换个思路,时间窗只做粗筛,真正的防重放交给 nonce。每个请求带一个随机串,服务端用 SETNX 存 300 秒,重复的直接拒。这样窗口可以保持 300 秒,也不怕边界抖动。

$key = "open:nonce:" . $appid . ":" . $nonce;
$ok = $redis->set($key, 1, ["nx", "ex" => 300]);
if (!$ok) { return [401, "replay"]; }
$ts = (int) $_GET["timestamp"];
if (abs(time() - $ts) > 300) {
    return [401, "timestamp"];
}

顺序很重要:先验 nonce 再验时间。反过来会出现时间过期的请求把 nonce 占掉,正常请求反而被拒。nonce 的 key 要带 appid,不同应用的同名随机串不能互相顶。

验签用的是原始 body,不是解析后的数组。之前有个接口把 JSON 解析再拼回去,字段顺序变了,签名永远对不上。现在入口处先读 php://input 存一份原文,验签和处理都用它。

确认:拿同一个请求重放 100 次,第一次 200,其余 99 次返回 401 replay;把 timestamp 改到 400 秒前,返回 401 timestamp;正常业务连续跑 3 天,401 占比低于 0.02%。

窗口值最后定在 300 秒,是按对方最大重试间隔 3 分钟再留一倍余量算的,写进了对接文档,后面换合作方也照这个来。

您可以还会对下面的文章感兴趣: