小程序开发之API接口安全验证设计思路

港控/mmm° 2022-12-19 11:57 180阅读 0赞

接口特点汇总：  
1、因为是非开放性的，所以所有的接口都是封闭的，只对公司内部的产品有效；  
2、因为是非开放性的，所以OAuth那套协议是行不通的，因为没有中间用户的授权过程；  
3、有点接口需要用户登录才能访问；  
4、有点接口不需要用户登录就可访问；

针对以上特点，移动端与服务端的通信就需要2把钥匙，即2个token。  
第一个token是针对接口的（api\_token）；  
第二个token是针对用户的（user\_token）；

先说第一个token（api\_token）

它的职责是保持接口访问的隐蔽性和有效性，保证接口只能给自家人用，怎么做到？参考思路如下：  
按服务器端和客户端都拥有的共同属性生成一个随机串，客户端生成这个串，服务器也按同样算法生成一个串，用来校验客户端的串。  
现在的接口基本是mvc模式，URL基本是restful风格，URL大体格式如下：  
[/模块名/控制器名/方法名?参数名1=参数值1&参数名2=参数值2&参数名3=参数值3][1_1_2_2_3_3]

接口token生成规则参考如下：  
api\_token = md5 ('模块名' + '控制器名' + '方法名' + '2013-12-18' + '加密密钥') = 770fed4ca2aabd20ae9a5dd774711de2  
其中的  
1、 '2013-12-18' 为当天时间，  
2、'加密密钥' 为私有的加密密钥，手机端需要在服务端注册一个“接口使用者”账号后，系统会分配一个账号及密码，数据表设计参考如下：  
字段名 字段类型 注释  
client\_id varchar(20) 客户端ID  
client\_secret varchar(20) 客户端(加密)密钥  
（注：只列出了核心字段，其它的再扩展吧！！！）

服务端接口校验，PHP实现流程如下：  
01  
<?php  
02  
// 1、获取 GET参数 值  
03  
$module = $\_GET\['mod'\];  
04  
$controller = $\_GET\['ctl'\]  
05  
$action = $\_GET\['act'\];  
06  
$client\_id = $\_GET\['client\_id'\];  
07  
$api\_token = $\_GET\[''api\_token\];  
08

09  
// 2、根据客户端传过来的 client\_id ，查询数据库，获取对应的 client\_secret  
10  
$client\_secret = getClientSecretById($client\_id);  
11

12  
// 3、服务端重新生成一份 api\_token  
13  
$api\_token\_server = md5($module . $controller . $action . date('Y-m-d', time()) . $client\_secret);  
14

15  
// 4、客户端传过来的 api\_token 与服务端生成的 api\_token 进行校对，如果不相等，则表示验证失败  
16  
if ($api\_token != $api\_token\_server) \{  
17  
exit('access deny'); // 拒绝访问  
18  
\}  
19

20  
// 5、验证通过，返回数据给客户端  
21  
//。。。  
22  
?>

再说第二个token（user\_token）

它的职责是保护用户的用户名及密码多次提交，以防密码泄露。  
如果接口需要用户登录，其访问流程如下：  
1、用户提交“用户名”和“密码”，实现登录（条件允许，这一步最好走https）；  
2、登录成功后，服务端返回一个 user\_token，生成规则参考如下：  
user\_token = md5('用户的uid' + 'Unix时间戳') = etye0fgkgk4ca2aabd20ae9a5dd77471fgf  
服务端用数据表维护user\_token的状态，表设计如下：  
字段名 字段类型 注释  
user\_id int 用户ID  
user\_token varchar(36) 用户token  
expire\_time int 过期时间（Unix时间戳）  
（注：只列出了核心字段，其它的再扩展吧！！！）  
服务端生成 user\_token 后，返回给客户端（自己存储），客户端每次接口请求时，如果接口需要用户登录才能访问，则需要把 user\_id 与 user\_token 传回给服务端，服务端接受到这2个参数后，需要做以下几步：  
1、检测 api\_token的有效性；  
2、删除过期的 user\_token 表记录；  
3、根据 user\_id，user\_token 获取表记录，如果表记录不存在，直接返回错误，如果记录存在，则进行下一步；  
4、更新 user\_token 的过期时间（延期，保证其有效期内连续操作不掉线）；  
5、返回接口数据；

接口用例如下：

1、发布日志  
URL： [/blog/Index/addBlog?client\_id=wt3734wy636dhd3636sr5858t6&api\_token=880fed4ca2aabd20ae9a5dd774711de2&user\_token=etye0fgkgk4ca2aabd20ae9a5dd77471fgf&user\_id=12][blog_Index_addBlog_client_id_wt3734wy636dhd3636sr5858t6_api_token_880fed4ca2aabd20ae9a5dd774711de2_user_token_etye0fgkgk4ca2aabd20ae9a5dd77471fgf_user_id_12]  
请求方式： POST  
POST参数：title=我是标题&content=我是内容  
返回数据：  
\{  
'code' => 1, // 1:成功 0:失败  
'msg' => '操作成功' // 登录失败、无权访问  
'data' => \[\]  
\}

[1_1_2_2_3_3]: http://blog.snsgou.com/%E6%A8%A1%E5%9D%97%E5%90%8D/%E6%8E%A7%E5%88%B6%E5%99%A8%E5%90%8D/%E6%96%B9%E6%B3%95%E5%90%8D?%E5%8F%82%E6%95%B0%E5%90%8D1=%E5%8F%82%E6%95%B0%E5%80%BC1&%E5%8F%82%E6%95%B0%E5%90%8D2=%E5%8F%82%E6%95%B0%E5%80%BC2&%E5%8F%82%E6%95%B0%E5%90%8D3=%E5%8F%82%E6%95%B0%E5%80%BC3
[blog_Index_addBlog_client_id_wt3734wy636dhd3636sr5858t6_api_token_880fed4ca2aabd20ae9a5dd774711de2_user_token_etye0fgkgk4ca2aabd20ae9a5dd77471fgf_user_id_12]: http://blog.snsgou.com/blog/Index/addBlog?client_id=wt3734wy636dhd3636sr5858t6&api_token=880fed4ca2aabd20ae9a5dd774711de2&user_token=etye0fgkgk4ca2aabd20ae9a5dd77471fgf&user_id=12