API常用签名验证方法(PHP实现)

使用场景

现在越来越多的项目使用的前后端分离的模式进行开发，后端开发人员使用API接口传递数据给到前端开发进行处理展示，在一些比较重要的修改数据接口，涉及金钱，用户信息等修改的接口如果不做防护验证，经常容易被人恶意刷接口，导致巨大的损失。

API签名验证

这里我们引入业内比较通用的签名验证来对接口进行参数加密，有以下优势。

• 请求的唯一性：计算出的签名是唯一的，可以用来验证。

• 参数的可变性：参数中包含时间戳参数，这就保证每次的请求计算出得签名都是不一样的。

• 请求的时效：由于请求中带有当前发起请求的时间戳参数，服务端可以对时间戳进行验证，过滤超出时效的请求。

• 安全性：即使请求被人恶意抓包，对方恶意篡改其中的参数，那么签名都是错误的，参数无法修改。

实践出真理

1. 对map类型（即一组键值对）的待签名数据根据键的大小进行排序。map中各参数按字母顺序排序,如果第一个字母相同,按第二个字母排序,依次类推。例如

{
    timestamp: 2017-06-08 09:38:00,
    format: xml,
    app_id: aabbc,
    cp_extend_info: ,
    sign_type: HMAC-SHA1,
    sign: abc
}

那么，排序后变成

{
    app_id: aabbc,
    cp_extend_info: ,
    format: xml,
    sign_type: HMAC-SHA1,
    timestamp: 2017-06-08 09:38:00
}

注意：如果map中包含签名的参数(sign)需要过滤该参数的键值不参与签名，没有值的参数请不要参与签名

2. 对排序后的map进行序列化处理成待签名字符串，拼接后的待签名字符串为

app_id=aabbc&format=xml&sign_type=HMAC-SHA1&timestamp=2017-06-08 09:38:00

3. 根据HMAC-SHA1算法使用密钥提取待签名字符串的摘要（hash）签名并进行base64_encode编码（便于显性传输和对比），假设签名密钥为 test ，则提取出的摘要签名并进行base64_encode的值为

JqoEqPIVVor0eyRHMYiZftsycVo=

注意：由于有些数据根据HTTP协议需求,在网络传输过程中需要进行URLencoding,这样接收方才可以接收到正确的参数,但如果这个参数参与签名,那么待签名字符串必须是字符串原值而非URLencoding 的值。

代码实践

PHP示例

/**
 * 使用密钥生成HMAC-Sha1签名
 * @param array $params 请求参数
 * @param string $signKey 签名密钥
 * @return string
 */
function hmacSha1Sign($params,$signKey)
{
    ksort($params);
 
    $paramString = '';
    foreach ($params as $key => $value) {
        if (is_null($value) || $value=='' || $key == 'sign') {
            continue;
        }
        $paramString .= $key.'='.$value.'&';
    }
    $paramString = substr($paramString,0,-1);
    $sign = base64_encode(hash_hmac(sha1, $paramString, $signKey, $raw_output=TRUE));
    return $sign;
}