商业营销认证设备端配置基本检查

1、最新版本，并且升级后清空缓存重新配置

2、关闭认证，上网正常

3、设备DNS和终端DHCP DNS配置成一个

4、如果是VPN场景，需要带源ping 112.124.31.88

5、如果是拨号，注意MTU：经过几次客户那边测试，发现1472能通基本就没问题

6、在设备上ping captive.apple.com 防止某些DNS不能解析苹果官网

7、特征库更新到最新

8、检查免审计用户设置。免审计用户不会经过应用识别，因此会导致微信唤醒、IOS弹框等异常。对免审计用户需要同时设置到免认证中。

商业营销认证WMC配置基本检查

1、先登陆WMC/MCP服务器，点击联动设备管理，检查设备对应的配置是否问题，例如：是否二层网络，是否微信连wifi设备，对应的设备类型等。

2、通过设备查询到对应的门店

3、通过门店管理找到设备对应的门店，点击修改，查看关联的认证模版和广告规则信息。

4、进入认证模版，找到门店对应的认证模版，点击修改按钮，查看认证配置是否问题，例如是否开了指定的认证方式，或者有问题的功能。

5、进入广告管理页面，找到门店对应的广告规则，点击修改，查看对应的广告和具体规则信息。

6、进入广告列表，查找到对应的广告，检查广告是否有问题。如果有已发布-已修改，请点击发布按钮。

7、进入微信门店，找到联动设备管理中关联的微信门店，检查配置。

建议：

1、门店下建议都绑定用户自己新增的广告规则，不要不勾选。

2、广告中正常情况下应该要包含认证或者悬浮认证按钮。特殊用户不需要认证的除外

MCP对微信认证支持情况

MCP 从1.32版本以后不再支持微信关注和微信链接功能，只支持微信连wifi;

微信连wifi支持多种认证方式共存情况

微信连wifi认证可以和短信认证，固定账号或免账号一键登录认证同时启用。该认证场景在wmc1.35及以上版本支持。

微信连wifi认证成功后跳转页面

不支持，仅支持显示认证成功，跳转必须在微信公众平台商家主页自定义设置

微信公众平台中一个微信门店最多添加多少个不同SSID的设备

100个。

如何申请MCP解密key

微信连wifi获取解密秘钥的方式：

客户提供以下材料

1、公司营业执照副本扫描件或者高清照片

2、申请人身份证正反两面扫描件或高清照片

3、填写附件中的申请表格，并且打印出来加盖企业公章，将加盖公章后的申请表格拍照和填写好的电子版一起提供

4、提供的材料必须是该微信公众号所属公司材料

将以上材料发邮件给钟宇樵即可，一般7-15工作日可以申请下来

什么类型微信公众号可做微信连wifi

订阅号和服务器支持，企业号不支持微信连wifi

不同SSID关注不同微信公众号

在AC上关联多个微信门店，然后瘦AP通过不同的SSID来区分，可以实现不同瘦AP关注不同微信门店

微信自定义广告连接模版

微信连wifi是否支持无感知

微信连WIFI的无感知要求WMC上开启无感知，设备上配置macbypass。

单独WMC上开启无感知，设备上不配置macbypass是不生效的。

微信连wifi 认证模板-上网配置功能支持情况

微信连wifi以及多种认证方式共存场景下只支持定时看广告，禁止PC和PAD上网，无感知和漫游；不支持认证成功后跳转页面，显示认证成功；

单独非微信连wifi认证方式下，可支持认证成功后跳转页面，显示认证成功，且这两者的关系如下：

是否开启“认证成功后跳转页面”	是否开启“显示认证成功”	非微信连wifi的其他认证方式的效果
是	是	用户认证成功后，浏览器页面先显示“亲认证成功”的提示页面后，然后才将浏览器页面跳转到配置的认证成功的跳转页面的URL地址。
是	否	用户认证成功后，浏览器页面直接跳转到配置的认证成功的跳转页面的URL地址。
否	是	用户认证成功后，浏览器页面显示“亲认证成功”的提示页面
否	否	无法认证成功。认证成功后跳转页面和显示认证成功两者必选其一，否则相当于认证到一半把认证页面关闭了。

消息推送规则有哪些？微信推送如何开启？

短信推送和微信推送。

微信推送的配置方式：

1、接口信息配置中输入微风托管平台的地址

2、消息推送——新增，就可以看到微信推送方式了，可以选择文本消息和图文消息

苹果手机扫码后无法直接跳转认证界面

仅安卓手机支持扫描后跳转认证，IOS系统没有开源，微信客户端无法对苹果终端下发指令要求连接上WIFI后跳转到认证页面。

PC端无法选择微信连wifi外的其他认证方式

微信连wifi3.x在微信连wifi和其他认证方式并存时，PC端仅支持使用微信连wifi认证，手机端无限制。

网关设备微信连wifi认证点击立即连接后网络断开

检查是否用户添加免审计，特征库是否最新

消息推送规则设置短信推送方式，设置好后在指定时间内无法接收到短信

1.MCP场景：检查MCP服务器ping baas系统域名是否能解析，如果不能，则为mcp dns没配置或者解析异常，更换dns；

ping baas.ruijieyun.com 看是否ping通-----如果ping不通，则dns解析问题，网卡配置文件修改添加dns地址；然后重启网卡服务service network restart

2.检查系统配置-短信网关配置是否填写baas系统注册正确账号和密码；

3.检查baas系统配置：检查baas系统注册账号是否有短信条目可发，查看短信发送日志；检查是否绑定了短信运营商

4.确认没收到短信的手机号可在注册来宾里查到

5.抓包，联系研发；

微信公众号或微风托管平台中显示的微信门店的状态是否会影响认证？

不会。不生效、通过、已提交这三种状态都不会影响微信连WIFI 3.X的认证。

微信连WIFI认证终端广告页面无法弹出，报错：“You are now using WeChat 1.x protocol, please use the WeChat 3.x protocol”

请将微信连WIFI 1.X协议变更为微信连WIFI 3.X协议，具体变更配置参见实施一本通典型案例章节。

微信连WIFI认证方式，认证成功后微信广告显示白屏。

可能原因：

1.如果是微风托管，wmc本地配置微信广告后，微信门店上是否关联调用微信广告；

2.如果是非微风托管，则进入mp平台，微信连wifi---商家主页管理----连接完成页设置将需要跳转的网页url复制进去

3、检查下微风托管或者微信公众平台上面的配置，确保门店处于生效状态

（MCP场景）添加微信门店时提示：“请输入其他ssid、appId或者shopId,该ssid、appId和shopId的组合已经被使用”

补丁下载链接：链接：http://pan.baidu.com/s/1dERNeQP 密码：nbqw

可以采用WINSCP将链接里的TThirdWifiInfoServiceImpl.class插件替换/project/chain/WEB-INF/classes/com/ruijie/mcp/chain/service/impl目录下的插件。

微信连WIFI认证时终端已走完认证流程，打开浏览器还是弹出一键唤醒广告页面，无法上网（反复认证）

原因：该种情况大多为网络配置以及版本问题

1.如果设备是AC,请确认ac版本是否为AC_RGOS 11.1(5)B8T8,如果版本不是，则需要升级到该版本；

2.如果联动设备为EG,跨vpn场景，EG需要确认是否指定设备与认证服务器通讯的源ip地址；

3.确认WMC上认证设备类型是否正确。比如

AG EG350 EG150 类型为小网络系列

EG1000和 EG2000 BCR8000-T1 类型为EG

4.检查WMC/MCP配置，认证管理中是否开启了强制关注
5.检查设备配置，如配置没问题，则在WMC抓包；

微信连WIFI 3.X 微信商户广告bar乱码

设备ssid避免包含@,因为@符号在微信bar中会乱码。

微信连wifi 1.x改为微信连wifi 3.x时微信连wifi设备选择为“启用微信连wifi 3.x协议”时，无微信门店的选项

先将微信连wifi设备选择为“否”，保存下，再改成“启用微信连wifi 3.x协议”，即可看到微信门店选项。

点击点此免费上网后提示"正在进行微信认证，请稍等“

原因：手机终端此时无法通网，无法与微信服务器进行通信

解决方法：

若EG等采用微信兼容方案，则确认其特征库是否有问题，“weixin.qq.com”是否有放行；

若是AC等采用微信标准方案，则确认设备是否可通网。手机终端点击“微信认证”后，会向设备申请30s的临时放行时间，此时该终端可临时上网，并与微信服务器进行通信拿到唤醒微信的票据。

判断手机终端是否可访问微信服务器，可让其在点击“微信认证”后的30s内在浏览器中输入“weixin.qq.com”，若能打开微信网页，则说明其可上网

重定向portal广告页”该设备还未关联到机构，请联系管理员“

原因：WMC/MCP中找不到认证设备。

解决方法：

请检查设备重定向到WMC/MCP时，是否将设备序列号给WMC/MCP（比如AC的nas-id未配置），或者给是设备序列号未在WMC/MCP中添加。

重定向到portal广告页，点击“微信认证”提示“未找到与设备关联的SSID信息，无法进行微信认证”

原因：设备发送的SSID并未在WMC/MCP中配置

解决方法：

确认设备的SSID、设备序列号，然后在WMC/MCP中找到该设备，确认该设备已经关联了配置对应SSID的微信门店。

若SSID为中文，则请确认设备端在设置该SSID时，是使用UTF-8编码设置的，若用非UTF-8设置时（如GBK、GB2312等），则设备重定向到WMC/MCP的portal页时，附带的ssid加密值会解析成乱码，从而导致认证终端点击“微信认证”后提示“未找到与SSID匹配的微信信息”

若是EG，设备端并不支持多SSID方式，否则认证终端重定向到WMC/MCP后，附带的SSID值解密出来也可能是乱码，最终出现上图结果。

若是BCR850，设备端需要将SSID的名字由中文修改为英文，还有web全局配置下认证SSID需要修改为实际SSID（默认为“32”）.

认证终端提示：“设备未开启微信连wifi认证，开启后方可使用微信连wifi 认证”

1、wmc上的联动设备要启用微信连wifi3.x协议并关联对应的微信门店

2、设备上的认证配置中要使用微信连wifi协议，并确保url为3.x的url

认证终端，点击“微信认证”唤醒微信后，点击微信客户端中的“立即连接”，提示”网络连接失败“

原因及解决方案：

信号不好，微信客户端无法与设备进行通信，或者丢包，导致无法认证。解决方法是检查手机终端是否连接上无线网络，以及网络信号是否良好

在ios上近期也爆发比较多类似情况（IOS9.2、9.3），点击“立即连接”后提示“网络连接失败”，设备端也介入排查，后发现是ios和微信兼容问题。具体表现为MCP服务端抓包未接收到设备发送的stage=logon的http请求；或者发起stage=logon后，mcp在1秒内返回手机可认证上线结果给设备，但实际手机的微信客户端中还是提示“网络连接失败”

若微信未绑定手机号，也可能出现此类问题，解决方法是微信绑定手机号；或者将微信客户端升级到最新版本，然后重新进行微信认证，此时微信客户端会提示用户绑定手机号

若是小米手机，比较容易出现此类问题。此为微信客户端兼容性问题，请多尝试几次或者升级微信客户端；其他中出现此类问题也可多尝试几次

若唤醒微信后，点击“立即连接”之前，租户管理员后台关闭了微信认证、删除认证模板等也可能出现此提示（此为小概率事件，存在，但基本不会发生）

其他还发现此类问题，则只能针对具体终端，抓包分析。抓包可在服务器端抓包，也可在设备端抓包。若是MCP，还可直接通过web启动抓包，具体步骤为：

1) 使用租户管理员登录mcp

2) 浏览器访问地址：http://ip/systemConfig/systemConfig!debugtool.action

比如mcp地址为182.254.246.68，则抓包地址为http://182.254.246.68/systemConfig/systemConfig!debugtool.action，返回页面如下：

3) 抓包后，可根据技术白皮书中3.2.4章节【微信连wifi3.x】的报文分析排查。主要排查3.2.4.3节中的第5、6、7步骤报文是否存在，若无5步骤报文，则可能是微信与设备问题；若无6步骤报文，则是设备问题；若7步骤中无服务器向设备返回认证上线报文，则主要是服务器问题

认证终端，点击“微信认证”提示如下报错：”appId and shopId not registered"

原因：WMC/MCP后台未正确配置微信信息。比如shopId、appId位置配错

解决方法：将WMC/MCP后台的微信信息与微信MP平台配置一致

认证终端点击“微信认证”后，提示：”浏览器不支持自动跳转微信请手动打开微信“

原因：腾讯兼容性问题（安卓部分手机兼容性问题）；

解决：

手动打开微信客户端走认证流程；

更换其他浏览器，如uc，qq浏览器；

重定向广告报错：“expired timestamp"

原因：提交给微信服务器的时间搓与微信服务器本地时间不一致。导致时间搓不一致有三种，一种是认证终端的本机时间与北京时间不同步（针对单个用户）；重定向到广告页的时间超过5分钟，此时点击微信认证；WMC/MCP服务器时间与北京时间不同步（针对大批量用户）

解决方法：

若单个终端出现，则请确认认证终端的时间是否与北京时间同步；或者访问其他http请求，再次重定向到广告页，然后点击“微信认证”。

若是大批量，则请确认WMC/MCP服务器的时间是否与北京时间同步。

与北京时间误差不得超过5分钟

跳转微信认证提示：”invaild parameters"

原因：腾讯回复可能是认证终端浏览器+手机版本+微信客户端兼容性问题

解决方案：

1、将微信版本升级到最新版本

2、使用UC浏览器进行微信连WIFI认证

还是如此，则请稍后重新，或者选择“短信认证”、“固定账号认证”

由于此类问题问题是单个问题场景，而且非必现，所以只能针对具体认证终端做具体分析及处理

认证终端点击“微信认证”提示"invaild sign....."

原因：

终端唤醒微信客户端时，需向微信服务器提交微信信息（shopId、appId、secretKey、SSID)，若提交的secretKey与微信MP平台的secretKey不一致，则会报上图提示。

解决方法：

若首次在WMC/MCP上配置secretKey，然后认证时出现上图提示，则请检查在WMC/MCP上配置的微信信息是否与微信MP平台上的一致。

若一直运行稳定，突然出现大批量的出现此类错误，则请登录微信MP平台查看secretKey是否存在，若不存在，则原因为微信MP平台丢失了secretKey，请重置，并将重置后的secretKey拷贝到WMC/MCP平台中（此为微信平台的bug，且经常出现，微信团队已知晓，但还未更新到微信MP平台中）；若微信MP平台的secretKey存在，则请与WMC/MCP上的微信信息对比，确认两边是secretKey是否一致（此类情况，更多在于人为的更改了微信MP平台的secretKey，请微信公众号管理员确保在更改微信MP平台的secretKey后，将其同步到WMC/MCP平台中）。

若客户将微信公众号托管到微风平台进行管理，可直接在微风平台进行secretKey重置

若只是单个认证终端出现此类问题，则需要具体问题定位。从目前客户提的故障类型分析，大多数都是微信MP平台将secretKey丢失问题引起的。

微信丢失secretKey问题。腾讯MP后台丢失加密key，引起问题唤起微信客户端时，报错提示” invalid sign**”。

认证终端，点击“微信认证”，唤醒微信后，提示“无法连接网络，请寻找无线信号较佳位置后重试，或咨询工作人员”

原因：

手机终端无法与微信服务器通信。大多出现在EG等采用微信兼容方案，主要是因为设备未对微信客户端必要的http放行，导致无法获取微信必要信息；或者本身设备已经放行，但终端不可通网（概率较小）

解决方法：

EG等采用兼容方案者，需更新特征库，让设备放行认证终端与微信服务器通信的ip、域名等；设备已经进行放行，则需排查设备本身是否支持通网

由于认证终端的微信客户端与微信服务器通信ip是动态获取，所以即使更新到最新的特征库可能还会出现此类问题，所以最优方案是让设备采用标准微信连WIFI方案，提供微信连WIFI服务

认证终端，点击“微信认证”，唤醒微信后，在“立即连接”页面，点击“阅读须知”，偶跳转到认证广告页面或者页面提示“网络出错，轻触屏幕重新加载”

原因：

到“立即连接”页面时，设备临时放行30s可能已经结束，所以微信上点击“阅读须知”后，请求会被设备拦截并重定向到认证广告页面内

解决方法：

设备对3gimg.qq.com地址放行

将客户的微信连WIFI从1.x升级到3.x后，认证终端重定向广告页面，出现白屏

原因：切换到3.x时，未选择关联的微信门店。导致认证终端进行重定向广告页时，由于参数缺失，导致白屏

解决方法：

切换1.x到3.x时，先选择“否”并保存，然后在选择“启用微信连WIFI3.X”，然后选择微信门店，最后点击保存

管理员登录租户管理后台，添加微信门店报错

原因：

通过微信接口向微信添加门店后，微信并不会立马返回添加结果，需要后台二次请求新增结果。若微信后台新增微信门店成功前后台已经发起查询，则会出现上图错误

解决方法：

继续重新

或者使用手工添加方式添加

下一版本会对此功能优化，避免出现上述错误

PC浏览器被重定向，出现如图页面，或者在二维码位置提示“网络繁忙，请重试”

原因为PC无法访问wifi.weixin.qq.com导致，请确认设备是否放行该地址（基本为此原因）或者PC本身是否对该地址进行了黑名单管理