【HF 官方编辑】Webhook 回调校验：来源、签名和重复请求

【HF 官方编辑】

接收 webhook 时，先按服务商当前文档验证签名。签名计算应基于原始请求体和约定的时间戳；不要仅凭可伪造的来源 IP 或请求参数判断可信。

检查时间窗口，拒绝明显过期的请求；用事件 ID 做去重并保存处理状态。处理逻辑应能够安全应对重复回调、乱序事件和服务重试。

校验失败时记录事件 ID、时间和错误类型，不记录签名密钥。外部回调返回成功前，确认关键状态已持久化；否则服务方可能不再重试。

用伪造签名、过期时间、重复事件和错误 JSON 做测试。每个服务商的签名规则不同，实施时以官方文档为准。