分类 wifidog-ddwrt 下的文章

wifidog 认证 Wiwiz Setup API参考手册与接口规范(2)

紧接上文。

5.7 添加电子招待券
请求参数说明：
1.png

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>Voucher Created</message>
    </status>
</result>

5.8 修改电子招待券
请求参数说明：
2.png

返回数据示例与说明：




OK

Voucher Changed

5.9 删除电子招待券
请求参数说明：
3.png

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>Voucher Deleted</message>
    </status>
</result>

5.10 删除全部电子招待券
请求参数说明：
4.png

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>All Vouchers Deleted</message>
    </status>
</result>

5.11 查询访问控制规则
请求参数说明：
5.png

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>Operation Completed</message>
</status>
    <data> <!-- 仅在code为OK时出现 -->
        <record> <!-- 每个record标签代表一条访问控制规则记录 -->
            <mac_id>224</mac_id> <!-- 访问控制记录的唯一存储标识 -->
            <mac>00:50:56:C0:00:08</mac> <!-- MAC地址 -->
            <action>1</action> <!-- 控制规则。0代表屏蔽；1代表放行；2代表免认证 -->
            <memo>Hello, world!</memo> <!-- 备注信息 -->
        </record>
    </data>
</result>

5.12 添加访问控制规则
请求参数说明：
6.png

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>MAC Added</message>
    </status>
</result>

5.13 修改访问控制规则
请求参数说明：
7.png

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>MAC Changed</message>
    </status>
</result>

5.14 删除访问控制规则
请求参数说明：
8.png

返回数据示例与说明：

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <status>
        <!-- code: 调用结果状态码。
            值为OK代表调用成功；如果为以ERR开头的文字，则代表错误 -->
        <code>OK</code>
        <!-- message: 调用结果状态说明（供调试参考）-->
        <message>MAC Deleted</message>
    </status>
</result>

本文章由 http://www.wifidog.pro/2015/03/23/wifidog-Wiwiz-Setup-API-2.html 整理编辑，转载请注明出处

wifidog安装wifidog疑难问题排查

1. 我将Wiwiz HotSpot Builder Utility安装到了DD-WRT设备，但是当我打开浏览器后没看到热点的认证页面，而是可以浏览任意网页。
可能的原因是：

  1. 你的DD-WRT版本并不包含Wifidog组件。
  2. 你的DD-WRT设备没有用WAN口接入Internet。
  3. 你的DD-WRT版本存在BUG，不兼容的设备，内核模块不完整或可用内存不足。

2. 我安装了Wiwiz HotSpot Builder Utility，但是显示的认证页面并不是我在Wiwiz Web面板设置的。
需要注意，在安装配置Wiwiz HotSpot Builder Utility的时候，一定要输入正确的Hotspot ID与User Name。否则，显示的热点认证页面将是默认的样例页面。

3. 我将Wiwiz HotSpot Builder Utility安装到了Linux计算机，并且用WiFi终端也能正常连接。但打开浏览器后却看不到认证页面。
如果你使用无线路由器作为AP，你需要禁用无线路由器上的DHCP与UPNP服务，并且你还需要在你的Linux计算机上正确配置并启动DHCP服务。

4. 我使用虚拟机方式安装的Wiwiz HotSpot Builder Utility，并且用WiFi终端也能正常连接。但打开浏览器后却不能打开任何网页。
可能的原因是，
你的宿主机与你的无线路由器之间并不是通过网线连接的；
你的VMWare软件没有正确的配置虚拟网络设置、没有建立可用的NAT虚拟网络，或错误的防火墙策略导致NAT网络不通等。请检查VMWare软件的相关设置；
也有可能是你的网络的其他设置或防火墙等因素导致DNS解析异常。你可尝试在重新安装设置Wiwiz HotSpot Builder Utility，并在指定DNS的步骤时指定第三方的DNS服务器地址，例如Google的8.8.8.8或您的ISP提供的DNS地址。
此外，请使用官方版本的VMWare软件。部分非官方版本可能会导致异常。

5. 如何禁用Wiwiz HotSpot Builder Utility?
如果你是在支持DD-WRT的设备上安装的，执行以下命令：
/jffs/usr/local/hsbuilder/hsbuilder_setup4dd-wrt.sh disable
然后重启DD-WRT设备。

如果你是在Linux计算机或虚拟机内安装的，执行以下命令：
/usr/local/hsbuilder/hsbuilder_setup.sh disable

6. 如何卸载Wiwiz HotSpot Builder Utility?
如果你是在支持DD-WRT的设备上安装的，执行以下命令：
/jffs/usr/local/hsbuilder/hsbuilder_setup4dd-wrt.sh -dest /jffs uninstall
然后重启DD-WRT设备。

如果你是在Linux计算机或虚拟机内安装的，执行以下命令：
/usr/local/hsbuilder/hsbuilder_setup.sh uninstall

7. 在DD-WRT中安装Wiwiz HotSpot Builder Utility时，当执行
“cd /jffs; tar -zxf /tmp/root/hsbuilder-util-latest-DD-WRT.tar.gz”后，遇到以下错误信息：
tar: can’t open ‘/tmp/root/hsbuilder-util-latest-DD-WRT.tar.gz’: No such file or directory
你可能没有将你的DD-WRT设备接入Internet，或暂时下载失败。请确认DD-WRT设备接入Internet后再次尝试。

8. 在DD-WRT中安装Wiwiz HotSpot Builder Utility时，当执行
“/jffs/usr/local/hsbuilder/hsbuilder_setup4dd-wrt.sh -dest /jffs setup”后，遇到以下错误信息：
-sh: /jffs/usr/local/hsbuilder/hsbuilder_setup4dd-wrt.sh: not found
你的DD-WRT不支持JFFS2，JFFS2分区的剩余空间不足，或者没有启用JFFS2支持。
请使用正确的DD-WRT版本以支持JFFFS2，启用它并确保JFFS2分区有足够的剩余空间。

9. 在DD-WRT/OpenWrt中成功安装了Wiwiz HotSpot Builder Utility，在终端访问网页会显示认证页面，但认证之后立即访问其他网页依然会再次显示认证页面，如此循环。
可能的原因是，你的DD-WRT/OpenWrt存在设置冲突（例如开启了自带的QOS功能）。或者，你使用的DD-WRT/OpenWrt固件版本存在BUG，不兼容的设备，内核模块不完整或可用内存不足等。

10. 用虚拟机安装了Wiwiz，最初一切正常，但有时会出现网页不能打开的情况，重启虚拟机依然无效，重启宿主机（物理机）才能恢复。
我们提供的虚拟机镜像是用VMWare程序创建的。默认设置下，其eth0网卡访问Internet依赖宿主机的VMWare NAT Service（Windows系统服务）。但是，部分版本的VMWare程序的VMWare NAT Service可能存在缺陷，导致Internet访问，尤其是DNS解析存在不稳定。一个解决建议是，可以定时重启用VMWare NAT Service。例如，通过添加Windows计划任务，定时执行以下内容的BAT文件：
net stop "VMWare NAT Service"
net start "VMWare NAT Service"

本文章由http://www.wifidog.pro/2015/03/19/wifidog%E5%AE%89%E8%A3%85%E9%97%AE%E9%A2%98%E8%A7%A3%E7%AD%94.html整理编辑，转载请注明出处

一键实现DD-WRT升级web认证功能wifidog版

一、硬件准备（硬件支持列表）
请参照DD-WRT网站的“支持的硬件列表”：
如果你的产品不在列表中，请确认你的路由器支持DD-WRT，或与我们的技术人员联系。
已熟悉DD-WRT并正确配置上网的用户，请直接跳到第五点。
二、升级DD-WRT固件
请先将路由器升级为DD-WRT原版，并确认该版本支持wifidog功能（进入路由器管理界面的“服务》热点”查看是否有wifidog的选项。升级方法请百度）。
默认内网IP为192.168.1.1 DHCP开启（具体配置可参照第四点）。
Step 1：获取IP地址，访问192.168.1.1
Step 2：设置web管理界面的登录用户名和密码
Step 3：设置web管理界面语言为中文：
“管理》管理》语言》简体中文”：

三、配置网络参数
打开“设置》基本设置》WAN连接类型”，设置下图红色框处的参数（PPPoE、DHCP或静态IP，根据你的网络环境而定）：
“可选设置”：输入路由器名称（任意名称，如OldTreeCoffee）
“网络设置》路由器IP”：
1）本地IP地址为192.168.X.X（X为1-254之间的任意数字，如192.168.12.1）
2）子网掩码为255.255.255.0
3）其它参数默认
“网络设置》网络地址服务器设置 (DHCP)”：
1）DHCP类型为“DHCP服务器”
2）DHCP服务器“启用”
3）起始IP地址为100（大于1小于255的数值）
4）最大DHCP用户数（100）
5）其它参数默认
注：某些路由器（如磊科NW618）可能还需要作如下调整（WAN无法获取DHCP地址或无法拨号时进行此操作）
进入“设置》VLANs”页面
取消W下面的小勾（红框处），点击“保存”；等待片刻，重新勾选W，点击“保存”，再点击“应用”，重启路由器，WAN即可恢复正常状态。
（如果其它路由器发现WAN无法使用，亦可尝试此方法）

四、配置无线网络
“无线》基本设置”
1）无线模式为“访问点（AP）”
2）无线网络模式为“混合”
3）无线网络名（SSID）为“wifiap.cn_XXX”
4）无线频道一般选择（1、6、11）三个频道的其中一个（如果无线信号不稳定，请尝试更改此参数）
5）其它参数默认
6）点击“保存”，再点击“应用”
至此，连接到的wifiap路由器的电脑（有线或无线）均可正常上网。

务必先确认路由器在未开启认证的时候能正常上网。

五、注册Wifiap中央管理平台账号
1）访问wifiap官方网站
2）点击右下角的“商家登录|后台管理”，并进行注册
3）填写注册相关资料，提交免费注册（请牢记你的登录账号和密码）
六、创建云端AP并更新标识
1）登录官方网站的管理后台
2）从顶部导航进入“热点管理》热点维护》【新增】”
3）热点名称：热点的唯一标识名称（脚本中的hotspotname）
4）热点类型：选择“商家版”
5）机器码：输入一段字符串，如wifiapkey
6）点击“添加”，成功添加此热点（在“热点维护”中的“更新标识”可修改更多参数）
7）在“热点维护”页面找到新增的热点，在“操作”中点击“生成启动脚本”
8）填写路由系统（DD-WRT）、热点名称（刚新增的热点）、机器码（刚新增的机器码），然后点击“自动生成脚本”，在文本框中复制脚本（见下图）
9）配置路由认证，粘贴脚本（见第七点）
1.png

七、配置路由器认证模块
进入wifiap路由器web管理界面，并打开“管理》命令”
在指令输入框处，粘贴脚本（在脚本参数中生成的脚本）
编辑完成后，点击“保存为启动指令”，然后重启路由器生效。如下图示：
2.png

八、启用web认证功能并配置认证页面
进入官方网站的“热点管理》认证页面配置”，找到刚创建的热点，并点击【认证配置】
1）认证模式》认证方式：选择“用户认证”（其它认证方式请参考“云中心管理系统说明”）
2）认证模式》登录后跳转页面：用户登录成功后强制跳转的页面，如贵公司的网站（留空则跳转到认证前访问的页面）
3）认证模式》注册开关：是否允许用户自助注册，和注册的类型
4）web认证页面》页面模板：务必选择一个合适的模板，并点击“模板示例/使用说明”配置好各文本和图片，点击“修改”确认提交
5）点击【预览】查看页面效果，如需要调整，可即时修改参数，最后点击“修改”生效
3.png

九、用户账号管理
进入官方网站的“账号管理》创建账号”，添加一个账号，如test，密码123
高级账号管理功能请参考“云中心管理系统说明”
十、重启路由器
回到路由器管理界面，进入“管理》管理”页面，点击右下角的“重启路由器”，认证功能将自动启动。
应用效果
打开浏览器，随便输入一个网址，将强制跳转到wifiap云后台配置的认证页面，用户必须输入账号密码方可进行上网。

本文章由 http://www.wifidog.pro/2015/02/15/ddwrt-wifidog%E6%97%A0%E7%BA%BF%E8%AE%A4%E8%AF%81.html 整理编辑，转载请注明出处

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. ...
  8. 9