移动端与PHP服务端接口通讯流程设计(基础版)

移动端与PHP服务端接口通讯流程设计(基础版)    

针对

--->非开放性平台

--->公司内部产品

 

接口特色汇总：

一、由于是非开放性的，因此全部的接口都是封闭的，只对公司内部的产品有效；

二、由于是非开放性的，因此OAuth那套协议是行不通的，由于没有中间用户的受权过程；

三、有点接口须要用户登陆才能访问；

四、有点接口不须要用户登陆就可访问；

 

针对以上特色，移动端与服务端的通讯就须要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

其中的 

一、 '2013-12-18' 为当天时间，

二、'加密密钥' 为私有的加密密钥，手机端须要在服务端注册一个“接口使用者”帐号后，系统会分配一个帐号及密码，数据表设计参考以下：

字段名字段类型注释

client_idvarchar(20)客户端ID

client_secretvarchar(20)客户端(加密)密钥

（注：只列出了核心字段，其它的再扩展吧！！！）

 

服务端接口校验，PHP实现流程以下：

<?php

// 一、获取 GET参数 值

$module = $_GET['mod'];

$controller = $_GET['ctl']

$action = $_GET['act'];

$client_id = $_GET['client_id'];

$api_token = $_GET[''api_token];

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

$client_secret = getClientSecretById($client_id);

// 三、服务端从新生成一份 api_token

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

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

if ($api_token != $api_token_server) {

    exit('access deny');  // 拒绝访问

}

// 五、验证经过，返回数据给客户端

//。。。

?>

 

再说第二个token（user_token）

 

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

若是接口须要用户登陆，其访问流程以下：

一、用户提交“用户名”和“密码”，实现登陆（条件容许，这一步最好走https）；

二、登陆成功后，服务端返回一个 user_token，生成规则参考以下：

user_token = md5('用户的uid' + 'Unix时间戳') = etye0fgkgk4ca2aabd20ae9a5dd77471fgf

服务端用数据表维护user_token的状态，表设计以下：

字段名字段类型注释

user_idint用户ID

user_tokenvarchar(36)用户token

expire_timeint过时时间（Unix时间戳）

（注：只列出了核心字段，其它的再扩展吧！！！）

服务端生成 user_token 后，返回给客户端（本身存储），客户端每次接口请求时，若是接口须要用户登陆才能访问，则须要把 user_id 与 user_token 传回给服务端，服务端接受到这2个参数后，须要作如下几步：

一、检测 api_token的有效性；

二、删除过时的 user_token 表记录；

三、根据 user_id，user_token 获取表记录，若是表记录不存在，直接返回错误，若是记录存在，则进行下一步；

四、更新 user_token 的过时时间（延期，保证其有效期内连续操做不掉线）；

五、返回接口数据；

 

接口用例以下：

 

一、发布日志

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' => []

}

 

 

延伸阅读：

移动端与PHP服务端接口通讯流程设计(加强版) 

前面讲过：移动端与PHP服务端接口通讯流程设计(基础版)

对于 api_token 的校验，其安全性还可再加强：

 

加强地方一：

 

再增长2张表，一个接口表，一个受权表，设计参考以下：

接口表

字段名 字段类型 注释

api_id int 接口ID

api_name varchar(120) 接口名，以"/"做为分割线，如 blog/Index/addBlog

api_domain varchar(256) 所属领域

is_enabled tinyint(1) 是否可用  1:可用 0:不可用

add_time int 添加时间（戳）

（注：只列出了核心字段，其它的再扩展吧！！！）

 

受权表

字段名 字段类型 注释

client_id int 客户端ID

api_id int api编号

api_name varchar(120) 接口名，以"/"做为分割线，如 blog/Index/addBlog

is_enabled tinyint(1) 是否可用  1:可用 0:不可用

add_time int 添加时间（戳）

expire_time int 过时时间（戳）

（注：只列出了核心字段，其它的再扩展吧！！！）

 

执行过程以下：

一、移动端与服务端生成的 api_token 进行对比，若是不相等，则直接返回错误，不然，进入下一步；

二、根据接口URL，组装 api_name，再加上客户端传回的 client_id 为参数，查找 “受权表”记录，若是记录存在，且有效（是否可用，是否过时），则表示权限验证经过，返回接口数据，不然返回错误信息；

 

加强地方二：

 

对于一些很特殊的接口，怎么特殊，哪些算特殊，我也不知道，总而言之，就是感受http请求有可能被劫取，传递参数有可能被窜改等状况，仍是举个例子来讲吧：

有个直接转帐接口，页面上 我输入的是5元，表示我要给对方某某转帐5元，结果在http传递过程当中，被人劫取并窜改为了 10000元，并且入帐对象改为了“黑客”的帐号，那不是亏大发了，思考了一下，应该有2种方案解决这个问题，

 

方案一：走https，这个就很少说，比较公认的安全机制；

方案二：走数字签名，实现原理以下：

 

一个http请求，假如须要传递以下3个参数

 

参数名1=参数值1

参数名2=参数值2

参数名3=参数值3

 

咱们能够再追加一个参数，该参数的名为 identity_key （名字是什么不重要），该参数的值为 前几个参数值按顺序相加，再加密后的结果。

即：

identity_key = md5('参数值1' + '参数值2' + '参数值3' + '加密密钥');

因而，最终传递的参数有：

 

参数名1=参数值1

参数名2=参数值2

参数名3=参数值3

client_id=client_id值

identity_key=md5('参数值1' + '参数值2' + '参数值3'+ 'client_id值' + '加密密钥')

 

服务端接到参数后，再按相同的加密规则从新生成一份 identity_key，服务端的identity_key和客户端的identity_key 进行校对，若是不相等，表示被窜改过，接下来怎么操做，本身看着办吧！