WiFi硬件鉴权协议接口说明

《WiFi硬件鉴权协议接口说明》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、Wi-Fi硬件鉴权协议接⼜说明Wi-Fi硬件鉴权协议接⼝说明概述硬件鉴权协议主要用于Portal型设备的鉴权方式改造，使设备可以通过识别微信身份给顾客放行，让顾客的手机和PC快速便捷连上Wi-Fi。业务逻辑移动端连Wi-Fi用户连网流程顾客在手机上点选ssid后唤起portal页，点击页面上“微信连Wi-Fi”按钮进入连接前页，展示公众号logo和名称，点击“立即连网”按钮后开始连WiFi，连接成功后跳转到成功连接页，关注商家公众号。模块时序图若无法看清图中文字，可先通过“图片另存为”将图片保存到本地，再放大查看。PC连W

2、i-Fi用户连网流程顾客在PC上选择ssid后，在浏览器打开portal页，页面上展示连Wi-Fi二维码。用手机微信扫描该二维码，点击手机页面上的“确认”按钮，PC连上Wi-Fi，同时浏览器的portal页自动跳转到商家配置的网页。模块时序图若无法看清图中文字，可先通过“图片另存为”将图片保存到本地，再放大查看。移动端实现流程请按照以下步骤操作，即可完成设备改造，让移动端设备使用微信连Wi-Fi。第一步：获取门店Wi-Fi信息改造portal型设备的第一步，是获得门店Wi-Fi信息，包括：appId，shop_id，ssi

3、d，secretkey。有两种获取门店Wi-Fi信息的方法：1.通过页面操作获得在微信公众平台微信连Wi-Fi插件中，打开【设备管理】->【添加设备】，添加“新增微信方式连网+连网后近场服务”->”Portal型设备”；添加成功后即可获得门店Wi-Fi参数信息。已添加设备也可在【设备详情】->【查看设备改造信息】中，获得门店Wi-Fi参数信息。2.调用接口获得调用“添加portal型设备”接口获得。第二步：改造移动端portal页面若连网设备是移动设备，在portal页中引用下述微信JSAPI，让原有Wi-Fiportal

4、页具备呼起微信的能力：调用JSAPI触发呼起微信客户端：Wechat_GotoRedirect(appId,extend,timestamp,sign,shop_id,authUrl,mac,ssid);具体示例：Wechat_GotoRedirect('wx23fb4aaf04b8491e','demoNew','144

5、1768153341','a355c78bad9be9235d2105d28f8e010c','6747662','http://wifi.weixin.qq.com/assistant/wifigw/auth.xhtml?httpCode=200','aa:aa:aa:aa:aa:aa','2099');参数说明参数是否必须appId是商家微信公众平台extend⾥⾯可以放相关参数集合extend是营商认证URL。ex持英⽂和数字，且300个字符。timestamp是时间戳使⽤毫秒请求参数签名，具sign是下⽅说明AP设

6、备所在门店的shopId是shop_id认证服务端URL，authUrl是把⽤户微信⾝份信交并获得认证放⾏⽤户⼿机mac地址安卓设备必mac隔，字符长度17个需写，例如：00:1f:7ssid是AP设备的⽆线⽹络签名的计算方法：sign=MD5(appId+extend+timestamp+shopId+authUrl+mac+ssi注意：这里timestamp为毫秒单位的当前时间戳。第三步：支持临时放行上网请求请确保AP/AC在portal页打开后能够临时放行用户的上网请求。只有临时放行成功，才可以调用上述JSAPI呼起

7、微信，换取用户身份信息，保证后续认证请求顺利完成，从而成功连网。注意：IOS呼起微信时如果网络不通Wi-Fi会被切走，导致连网失败，因此请务必确保AC/AP支持临时放行上网请求。部分安卓设备的web浏览器无法自动呼起微信客户端的问题，请参考常见问题中的解决方案。第四步：接受微信身份认证放行微信客户端被呼起后，将自动向authUrl（JSAPI的传入参数）发起请求，提交认证所需的用户微信身份信息参数，包括extend、openId、tid。微信客户端向authUrl发送请求示例：http://www.foo.com/port

8、al/auth.html?extend=xxx&openId=xxx&tid=xxx参数说明参数说明extend为上⽂中调⽤呼起微信JSAPI时传递的ext原样回传给商家主页openId⽤户的微信openIdtid为加密后的⽤户⼿机号码（仅作⽹监部门备authUrl所对应的后台认证服务器必须能识别这些参