网络控制器NAC

信锐新一代网络控制器是信锐技术自主研发的多元化、高性能的网络控制器设备,集信锐新一代网络控制器、认证服务器、内网终端状态可视化分析、上网行为管理、上网行为审计、流量控制、VPN、防火墙、有线无线管理系统。 结合AI运维技术,极大程度的提升网络运维效率!
NAC3.9.0及以下版本
网络控制器NAC 文档 功能配置 最佳实践 短信认证测试最佳实践指导手册
{{sendMatomoQuery("网络控制器NAC","短信认证测试最佳实践指导手册")}}

短信认证测试最佳实践指导手册

更新时间:2023-12-25

1网络环境

1.1网络拓扑

1- 1 网络拓扑

本文档涉及的拓扑仅为示例, 该拓扑适用于新项目测试或者新项目功能验证时进行环境 快速搭建。实际项目中以具体网络环境为准, 原则上瘦模式 AP 组网可满足短信认证测试条件。

为达到测试效果, 需要提前准备好短信测试必要的环境, 如短信猫, 短信网关等, 提前获取短信网关等接口信息

1.2测试工具

1.2.1硬件工具准备

资源名称

数量

备注

测试手机

1 

推荐终端: Iphone11、三星 S10、小

 10

测试电脑

1 

CPU  G4400 以上;

内存 4G 以上;

支持 PCI-E 接口

NVME 固态硬盘

 

2 配置指导

2.1演示环境搭建

根据上述网络拓扑搭建测试环境,保证 NAC 、交换机以及 AP 工作正常

2.2配置短信服务

在配置短信认证方式之前,要确保短信服务是可用的, 短信服务可以是对接短信猫或第三方短信平台。

 

2.2.1对接短信猫

短信猫分为两种,分别是 GSM 短信猫和 CDMA 短信猫。 GSM 短信猫适用于移动 SIM卡和联通 SIM 卡,CDMA 短信猫仅支持电信 SIM 卡。

在控制器【系统管理】 -【短信服务】-【短信设置】启用短信服务, 发送模块选择本设备串口连接短信猫。

按照如下说明填写发送参数:

1)网关类型:分为 GSM 短信猫和 CDMA 短信猫。

2)短信中心:网关类型为 GSM 短信猫, 则需要配置短信中心号码, 可以联系运营商查

 SIM 卡归属地的短信中心号码。 CDMA 短信猫不需要配置短信中心号码。

3)使用串口:控制器串口默认是 COM0

4)串口波特率:控制器串口波特率默认是 115200

 

注意:

1)信锐的短信猫仅支持 SIM 卡的 2G 信号,需要保证安装短信猫位置有 2G 信号(将 SIM 卡安装到手机调成 2G  信号模式测试是否能成功发送短信, 来检测 SIM 卡是否正常工作)。

2)控制器仅支持信锐的短信猫,其他厂商短信猫可能不支持

2.2.2对接 http get 类型短信平台

目前常见的短信网关分为两类: HTTP Get  Webservice Post 类型。 两者最大的区别在 于: get 类型的短信网关可以直接在浏览器中发送短信, post 类型则不能。本节以 http get 型的短信平台为例

控制器【系统管理】 -【短信服务】-【短信设置】启用短信服务, 发送模块选择短信网关,如下图所示:

按照如下说明填写发送参数:

1)网关类型: 选择 HTTP 协议

2URL 地址:控制器请求短信平台的 URL 链接,根据客户提供的短信接口文档来配置 URL 链接。

3Content-Type:默认是application/text,根据客户提供的短信接口文档配置短信报头。

4)编码: 支持 GBK  UTF-8 两种编码方式, 依据短信接口文档配置编码方式。

5SOAP 版本和请求类型: 根据短信平台提供的短信接口文档, 这里配置 soap1.1 版本 get 请求类型

6)短信模板:根据短信接口文档说明,配置 URL 链接必须携带的 URL 参数。

 

GET  请求类型,可以在浏览器里面测试是否收到短信, 并且可以看到短信平台回复的结果。

例:

通过浏览器测试的链接:

http://api.ums86.com:8899/sms/Api/Send.do?SpCode=216849&LoginName=admin&Password=Password&MessageContent=xxxx&UserNumber=1872930****&SerialNumber=&ScheduleTime=&f=1

转换成短信模板的链接为:

http://api.ums86.com:8899/sms/Api/Send.do?SpCode=216849&LoginName=admin&Password=Password&MessageContent=$$SMS_CONTENT$$&UserNumber=$$MOBILE_NUM$$&SerialNumber=&ScheduleTime=&f=1

2.2.3  对接 http post 类型短信平台

目前常见的短信网关分为两类: HTTP Get  Webservice Post 类型。 两者最大的区别在于: get 类型的短信网关可以直接在浏览器中发送短信, post 类型则不能。 本节以 http post类型的短信平台为例

控制器【系统管理】 -【短信服务】-【短信设置】启用短信服务, 发送模块选择短信网关,如下图所示:

 

按照如下说明填写发送参数:

1)网关类型: 选择 HTTP 协议

2URL 地址:请求短信网关的 URL 链接, 根据短信接口文档查询,短信发送的 URL 址是 http://218.65.241.103:9088/services/WebServiceSoap?wsdl 以及发送接口名称是PostSingle

3Content-Type:短信报头,默认是 application/text ,部分短信网关是 json 格式的, 则短信报头是 application/json

4)编码: 支持 GBK  UTF-8 两种编码方式, 依据短信接口文档配置编码方式。

5SOAP 版本和请求类型: 根据客户提供的短信接口文档配置

6)短信模板:在浏览器打开短信发送 URL 地址,右击将此网页另存为一个 xml 文件,如下图所示

 

 

短信模板点击设置,接口名称填写短信发送接口名称 PostSingle wsdl 文件导入刚刚生 成的 WebServiceSoap.xml 文件自动生成“请求模板 ”,并将模板中的参数按照占位符或者实际用户信息替换。其中, 各参数的含义在接口文档中给出,一般情况下顺序一致。

2.3测试短信服务

测试短信服务有效性时,确保测试时编辑的短信内容和短信网关设置的短信内容模板保 持一致,大部分短信网关会自动加上短信签名, 少部分短信网关需要手动加上短信签名, 体可以跟短信网关技术人员确认清楚。

 

2.4创建无线信号

在控制器【认证授权】-web 认证】- 【访客认证】新增短信认证方式, 配置的短信内 容模板配置要和短信平台设置的内容模板保持一致,<VerifyCode>是形参,代表平台发出的短信验证码, 这个保持不动即可。

 

控制器【接入点配置】-【无线网络】创建一个无线网络, 名称命名为 Guest,认证类型选择开放式+web,认证方式选择访客认证。

 

3结果演示

3.1演示方法

实际测试中使用手机连接无线网络,获取短信验证码并进行无线认证。

3.2预期效果

手机可以正常接受到认证短信, 通过短信验证码可以正常进行无线认证, 控制器【系统状态】 -【在线用户】可以查看短信认证用户信息。

控制器右上角应用点击认证中心模块【用户管理】 - 【访客账号】-【短信认证】可以查看控制器上短信认证访客信息。

 

4常见问题

4.1无法正常收到短信验证码

1)测试短信服务器有效性时,收不到验证码或者验证码接收的很慢可能是短信模板不符或者未手动配置签名,需要平台审核。

2 短信认证方式中的短信内容确保和短信网关设置的短信内容模板保持一致,<VerifyCode>参数用于控制器发送验证码不需要修改。

3)短信认证的无线网络保证认证前角色是仅允许 dns 流量。

4)对接短信猫, 需要注意 GSM 短信猫支持移动和联动 SIM 卡,CDMA 短信猫仅支持电信 SIM 卡。

5)我们短信猫仅支持 SIM  2G 信号,需要保证短信猫所在位置有 2G 信号。