php api接口安全设计 sign理论

一. url请求的参数包括：timestamp，token, username，sign

1. timestamp:

时间戮

2. token：

登陆验证时，验证成功后，生成唯一的token（可以为uuid），并把token储存到缓存（redis）里 ，键为username,值为token

3. username:

用户名,保证唯一

4. sign：

规则：参数timestamp，token，username按字典排序，md5加密码（加点盐），后大写

用户登陆，验证成功后，生成sign

二. url 拦截规则，验证

1.  用户登陆，验证成功后，生成token，缓存（username->token）并返回给客户端

2.  客户端每个接口请求（除登陆接口）时，传必要的参数timestamp,token,username, sign，没传直接返回报错

3.  timestamp作用：是否在有效期内，有效期可以设置10，20分钟，根据需求设定

比如说  过期时间设置为10分中

服务接受到请求的当前时间戳是30，传过来的timestamp时间戳是10，30-10>10, 说明这个请求过期

4.  token作用：直接与redis中的username键值 对比，如果不相等，则过期，或如果redis缓存时间过期了，也过期

5. sign作用：根据规则传过来的参数，生成sign，与传过来的sign对比。如果不相等，报错
---------------------
作者：蒙--
来源：CSDN
原文：https://blog.csdn.net/mengzuchao/article/details/78046697
版权声明：本文为博主原创文章，转载请附上博文链接！

token生成：

1、因为是非开放性的，所以所有的接口都是封闭的，只对公司内部的产品有效；

2、因为是非开放性的，所以OAuth那套协议是行不通的，因为没有中间用户的授权过程；

3、有点接口需要用户登录才能访问；

4、有点接口不需要用户登录就可访问；

针对以上特点，移动端与服务端的通信就需要2把钥匙，即2个token。

第一个token是针对接口的（api_token）；

第二个token是针对用户的（user_token）；

先说第一个token（api_token）

它的职责是保持接口访问的隐蔽性和有效性，保证接口只能给自家人用，怎么做到？参考思路如下：

现在的接口基本是mvc模式，URL基本是restful风格，URL大体格式如下：

http://blog.snsgou.com/模块名/控制器名/方法名?参数名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实现流程如下：

<?php   

// 1、获取 GET参数 值   

$module = $_GET['mod']; $controller = $_GET['ctl']   

$action = $_GET['act']; $client_id = $_GET['client_id'];   

$api_token = $_GET['api_token‘];   

// 2、根据客户端传过来的 client_id ，查询数据库，获取对应的 client_secret   

$client_secret = getClientSecretById($client_id);   

// 3、服务端重新生成一份 api_token   

$api_token_server = md5($module . $controller . $action .  date('Y-m-d', time()) .  $client_secret);   

// 4、客户端传过来的 api_token 与服务端生成的 api_token 进行校对，如果不相等，则表示验证失败   

if ($api_token != $api_token_server) {   

    exit('access deny');  // 拒绝访问 } // 5、验证通过，返回数据给客户端    

?>

 

再说第二个token（user_token）

它的职责是保护用户的用户名及密码多次提交，以防密码泄露。

如果接口需要用户登录，其访问流程如下：

1、用户提交“用户名”和“密码”，实现登录（条件允许，这一步最好走https）；（用户名+密码+随机字符串+时间戳）token保证唯一就行

2、登录成功后，服务端返回一个 user_token，生成规则参考如下：

服务端用数据表维护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：  http://blog.snsgou.com/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' => []
}