APP认证 测试指导书
信锐网科技术有限公司2015年9 月29 日
目录
APP认证 (1)
1 认证接口描述 (3)
1.1 认证原理 (3)
1.2 认证接口 (4)
1.3 配置要点 (4)
2 APP认证场景 (5)
2.1 强制APP下载 (5)
2.2 强制APP注册登录 (5)
3 控制器设置 (5)
3.1 配置wifi信号 (5)
3.2 配置微信公众账号 (6)
3.3全局放通 (7)
3.4 页面重定向 (8)
4 注意事项 (11)
1 认证接口描述
1.1 认证原理
认证接口实质上为一个网页链接，当终端链接wifi，请求该连接，即可通过认证。如图1-1原理图所示，当无线用户连上wifi后需要上网，该终端发起的任何上网请求都会被重定向至客户自定义的认证系统。通过该自定义系统portal页来引导用户做出相应行为（比如下载APP、或者在APP内登陆等等），判断出该终端已经完成了指定的动作之后，客户自定义系统立即调用我司认证接口，通过认证并放通用户上网。
注意：该接口是复用的微信认证接口，故在实际配置过程中，需要按照微信认证配置流程进行。
图1-1 认证接口原理图
1.2 认证接口
http://2.2.2.1/wx.html?href=‘.$encrypt.’&id＝$id
下边是encrypt的构造过程
$time = date(‘Y-m-d-H-i-s’,time()); //时间戳，2.0正式版本后可以填充一个固定的，后台不在校
验
$key = “sangfor”; //加密密钥，不要加密可忽略
$str = “n=”.$nickname.“&u=”.$openid.“&t=”.$time; //这里openid，nickname表示微信用户个人信息
$len = strlen($str); //有效信息长度
$str_str = $str .“&l=”.$len; //长度和有效内容合并成统一字符串
$encrypt_str = $this->mc_encrypt($str_str,$key); //aes加密，也可以不加密,不加密直接用bin2hex转为16进制
即即可
$encrypt = bin2hex($encrypt_str); //二进制转为16进制
$id //微信公众平台原始id，可随意填充
注意：该接口需要客户研发在认证系统（APP下载页面，或者APP登陆等页面）中调用。微信公众平台id仅作校验使用，可任意配置，需要保证跟控制器中微信公众平台原始id一致。
1.3 配置要点
(1)认证前放通
在认证之前，需要将用户的所有上网请求转发至客户自有的系统（APP下载页面或者注册页面等等），由客户的自定义页面去引导终端做出某种行为。配置重点如下：
①认证前角色，DNS
②认证前角色或全局放通客户自定义页面（例如APP下载页面等）
③修改我司默认终端认证页面，使其指向客户自定义页面（例如APP下载页等）
(2)接口联动
需要预先在控制器中配置微信公众账号，且该公众账号的原始ID与认证接口中的原始ID一致。
①配置微信公众平台:原始ID与认证接口原始ID一致
②配置微信认证wifi：开放式+web(微信认证)
2 APP认证场景
2.1 强制APP下载
场景描述：终端连接wifi，打开任意页面重定向至APP下载页面。点击下载之后，通过认证上网。
2.2 强制APP注册登录
场景描述：终端连接wifi后，打开任意页面重定向至APP下载页面，下载后运行，点击登陆或者注册通过之后即可上网。
3 控制器设置
预置条件：
①微信原始id:12345678(可任意，与接口中一致即可)
②SSID名称：APP-test
③客户APP下载页面：
④认证接口：http://2.2.2.1/wx.html?href=‘.$encrypt.’&id＝12345678 。客户研发自行处理。
3.1 配置wifi信号
配置如下图，详情见微信认证配置
3.2 配置微信公众账号
注意：此处的微信原始ID需要与接口的原始id一致
3.3全局放通
需要在全局排除地址中将APP下载页面排除，此处需要排除的是。
3.4 页面重定向
3.4.1 下载终端页面
在【认证授权】→【终端页面】→【下载】，将页面模板下载下来
3.4.2 修改页面重定向
将下载下来的文件解压，用记事本分别打开mobile.html和pc.html页面，并添加如下语句
注意:需要将替换成指定的APP下载页面
3.4.3 上传修改后的页面
将修改好的页面文件夹直接压缩成zip格式，上传至控制器，并命名为apptest
3.4.4 引用认证页面
重复3.1步骤，将认证页面替换成apptest,确认提交即可
111111
4 注意事项
1、该接口是复用的微信认证接口，故在实际配置过程中，需要按照微信认证配置流程进行。
2、该接口需要客户研发在认证系统（APP下载页面，或者APP登陆等页面）中调用。微信公众平台id仅作校验使用，可任意配置，需要保证跟控制器中微信公众平台原始id一致。
3、配置完成后，需要修改认证页面
11
