PHP开发API离不开签名验证,你是如何设计?

我们两清 提交于 2020-03-06 10:28:36

开发过程中,我们经常会与接口打交道,有的时候是调取别人网站的接口,有的时候是为他人提供自己网站的接口,但是在这调取的过程中都离不开签名验证。

我们在设计签名验证的时候,请注意要满足以下几点:

  • 可变性:每次的签名必须是不一样的。

  • 时效性:每次请求的时效,过期作废等。

  • 唯一性:每次的签名是唯一的。

  • 完整性:能够对传入数据进行验证,防止篡改。

     

这里介绍一种方式,是目前国内互联网公司常用的一种方式,其中淘宝的支付宝支付接口、淘宝开放平台接口、腾讯开放平台等应用的一种方式。

 

一、签名参数sign生成的方法

第1步: 将所有参数(注意是所有参数),除去sign本身,以及值是空的参数,按参数名字母升序排序。

第2步: 然后把排序后的参数按参数1值1参数2值2…参数n值n(这里的参数和值必须是传输参数的原始值,不能是经过处理的,如不能将"转成”后再拼接)的方式拼接成一个字符串。

第3步: 把分配给接入方的验证密钥key拼接在第2步得到的字符串前面。

第2步: 在上一步得到的字符串前面加上验证密钥key(这里的密钥key是接口提供方分配给接口接入方的),然后计算md5值,得到32位字符串,然后转成大写.

第4步: 计算第3步字符串的md5值(32位),然后转成大写,得到的字符串作为sign的值。

 

举例:

假设传输的数据是/interface.php?sign=sign_value&p2=v2& p1=v1&method=cancel&p3=&pn=vn(实际情况最好是通过post方式发送),其中sign参数对应的sign_value就是签名的值。

第一步,拼接字符串,首先去除sign参数本身,然后去除值是空的参数p3,剩下p2=v2&p1=v1&method=cancel& amp;pn=vn,然后按参数名字符升序排序,method=cancel&p1=v1&p2=v2&pn=vn.

第二步,然后做参数名和值的拼接,最后得到methodcancelp1v1p2v2pnvn
第三步,在上面拼接得到的字符串前加上验证密钥key,我们假设是abc,得到新的字符串abcmethodcancelp1v1p2v2pnvn

第四步,然后将这个字符串进行md5计算,假设得到的是abcdef,然后转为大写,得到ABCDEF这个值即为sign签名值。

注意,计算md5之前请确保接口与接入方的字符串编码一致,如统一使用utf-8编码或者GBK编码,如果编码方式不一致则计算出来的签名会校验失败。

二、签名验证方法:

根据前面描述的签名参数sign生成的方法规则,计算得到参数的签名值,和参数中通知过来的sign对应的参数值进行对比,如果是一致的,那么就校验通过,如果不一致,说明参数被修改过。

 

三、下面直接看代码

 1 <?php
 2 // 设置一个公钥(key)和私钥(secret),公钥用于区分用户,私钥加密数据,不能公开
 3 $key = "c4ca4238a0b923820dcc509a6f75849b";
 4 $secret = "28c8edde3d61a0411511d3b1866f0636";
 5 
 6 // 待发送的数据包
 7 $data = array(
 8     'username' => 'abc@qq.com',
 9     'sex' => '1',
10     'age' => '16',
11     'addr' => 'guangzhou',
12     'key' => $key,
13     'timestamp' => time(),
14 );
15 
16 // 获取sign
17 function getSign($secret, $data)
18 {
19     // 对数组的值按key排序
20     ksort($data);
21     // 生成url的形式
22     $params = http_build_query($data);
23     // 生成sign
24     $sign = md5($params . $secret);
25     return $sign;
26 }
27 
28 // 发送的数据加上sign
29 $data['sign'] = getSign($secret, $data);
30 
31 /**
32  * 后台验证sign是否合法
33  * @param  [type] $secret [description]
34  * @param  [type] $data   [description]
35  * @return [type]         [description]
36  */
37 function verifySign($secret, $data)
38 {
39     // 验证参数中是否有签名
40     if (!isset($data['sign']) || !$data['sign']) {
41         echo '发送的数据签名不存在';
42         die();
43     }
44     if (!isset($data['timestamp']) || !$data['timestamp']) {
45         echo '发送的数据参数不合法';
46         die();
47     }
48     // 验证请求, 10分钟失效
49     if (time() - $data['timestamp'] > 600) {
50         echo '验证失效, 请重新发送请求';
51         die();
52     }
53     $sign = $data['sign'];
54     unset($data['sign']);
55     ksort($data);
56     $params = http_build_query($data);
57     // $secret是通过key在api的数据库中查询得到
58     $sign2 = md5($params . $secret);
59     if ($sign == $sign2) {
60         die('验证通过');
61     } else {
62         die('请求不合法');
63     }
64 }
65 
66 $res = verifySign($secret, $data);
67 echo "<pre>";
68 print_r($res);
69 echo "<pre>";
70 exit;
71 ?>

 

链接:https://mp.weixin.qq.com/s/5_3Zol1O0sxNjsfHKPdTXQ

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!