接口签名:防篡改与防重放
参数排序、拼接、HMAC 签名,加上时间戳与 nonce 防重放,是开放接口最常见的鉴权方式。
更新于 2026-11-0839 行代码
完整代码
PHP
<?php
function sign_params(array $params, string $secret): string
{
unset($params['sign']);
ksort($params);
$pairs = [];
foreach ($params as $k => $v) {
if (is_array($v)) {
$v = json_encode($v, JSON_UNESCAPED_UNICODE);
}
$pairs[] = $k . '=' . $v;
}
return strtoupper(hash_hmac('sha256', implode('&', $pairs), $secret));
}
function sign_check(array $params, string $secret, int $ttl = 300): array
{
if (empty($params['sign']) || empty($params['ts']) || empty($params['nonce'])) {
return [false, '缺少签名参数'];
}
if (abs(time() - (int)$params['ts']) > $ttl) {
return [false, '请求已过期'];
}
$expect = sign_params($params, $secret);
if (!hash_equals($expect, strtoupper((string)$params['sign']))) {
return [false, '签名不匹配'];
}
// nonce 在 ttl 内只能使用一次
$key = 'nonce:' . $params['nonce'];
if (file_exists(sys_get_temp_dir() . '/' . md5($key))) {
return [false, '重复请求'];
}
file_put_contents(sys_get_temp_dir() . '/' . md5($key), '1');
return [true, 'ok'];
}
怎么用
- 客户端把业务参数加上 ts(当前时间戳)和 nonce(随机串),排序后计算 sign。
- 服务端用同样的规则重算并比对,再检查 ts 与 nonce。
- 签名密钥不要放在前端代码里;前端直连的场景应改用后端代理。
注意
- 参数值必须统一转成字符串再拼接,布尔和 null 的处理要和服务端约定一致。
- nonce 存文件只适合小流量,正式项目用 Redis 的 SET NX EX。
- 签名只保证「参数没被改」,不保证「内容加密」,敏感字段仍要 HTTPS。