wifidog认证服务接口Wiwiz Auth API参考手册与接口规范

[功能描述]
Wiwiz Auth API是Wiwiz HotSpot Builder提供的基于Web的外部开发接口。利用它可以实现在第三方系统/用户系统进行账户认证（Web认证）后接入网络并进行简单的认证控制。

将用户系统与Wiwiz Auth API集成的过程非常简单。用户仅需了解一种Web服务器端开发语言或工具（例如，ASP，C#/VB.Net，JSP/Servlet，PHP等），并使用它根据Wiwiz Auth API的接口规范为用户系统编写一个Web程序。

如果，你已利用Wiwiz Auth API与你的系统（例如，你的网站，论坛，博客或其他系统等）进行了集成，当某个客户在你的网络中打开浏览器并访问任意的http地址时，他将会首先看到你的网络或热点的Web认证页面，即你编写的Web程序。在这个页面中，他将根据你的要求进行身份验证或登录确认等操作，并得到你的授权。之后，他才可以访问Internet。

[使用条件与要求]

  1. 用户需拥有Wiwiz专业版账户。
  2. 查询Wiwiz账户的User Key。（注3）
  3. 在Wiwiz Web面板创建一个热点，在“认证规则设置”部分设置“认证方式”为“第三方认证(调用Wiwiz Auth API)”。设置“认证URL”为你为用户系统编写的Web程序地址。（注1）
  4. 已在本地网络设备中安装并设置了Wiwiz HotSpot Builder Utility（参考Wiwiz HotSpot Builder Utility的相关安装指南）。

[调用示意图]
api_cn.png

[调用流程说明]
(1) 网络中的客户端在浏览器中访问任意http网址，将会自动启动Web认证机制，请求会被Wiwiz服务端拦截并将浏览器页面跳转至“认证URL”（*注1）”。同时，Wiwiz服务端会通过“认证URL”向用户系统传送3个HTTP GET传入参数，tokencode，srvurl与url。参数的含义如下：

1.png

(2) 在用户系统中，根据用户系统的业务需求进行自己的账户验证/登录验证等处理。即，图中的“第1步”处理。

(3) 如在用户系统中的验证处理通过，则在用户系统的服务器端调用Wiwiz Auth API以进行预认证。即，图中的“第2步”处理。

  • 调用方式为在服务器端（不是在客户端或浏览器侧）（注2）向Wiwiz服务端发起HTTP请求。请求地址为处理（1）中传入参数srvurl的值。

  • 发起请求时需要设置若干参数（HTTP GET或HTTP POST参数），包括：
    2.png

  • Wiwiz服务端接收到该请求后将返回一个Http Response作为验证结果，这个结果叫做verifycode。
    如果存在错误，verifycode的值为ERRX(X代表一位数字) （*注4）。
    否则，verifycode应该是一组16位进制的数字。

(4) 然后，再次调用Wiwiz Auth API完成认证。即，图中的“第3步”处理。

  • 调用方式为是在客户端/浏览器侧（*注5）向Wiwiz服务端发起一个HTTP请求。请求的地址为处理(1)中传入参数srvurl的值。

  • 请求的同时需要设置以下参数（HTTP GET或HTTP POST参数），包括：
    3.png

  • 最后，认证完成。浏览器将显示认证后页面或用户指定的在参数postauth中设置的地址。
    如遇到错误则显示错误页面并显示错误代码（*注6）。

[断开连接的方法]
如果需要切断某个已认证连接，可以在服务器端向Wiwiz服务端发起HTTP请求，请求的URL为：
格式：[srvurl]?disconn=2&t=[tokencode]&userkey=[userkey]
例：http://cp.wiwiz.com/as/s/login2/?disconn=2&t=A1398E284DC&userkey=246DD22C084BB40E

Wiwiz服务端接收到该请求后返回的Http Response的含义为：
4.png

[客户端用户自主断开连接的方法]
你可能希望客户端用户自己可以主动断开已认证的Internet连接。
你只需让客户端用户在浏览器访问以下网址即可：
格式：[srvurl]?disconn=1&t=[tokencode]
例：http://cp.wiwiz.com/as/s/login2/?disconn=1&t=A1398E284DC

这个访问请求成功后，其返回结果有以下3种：
5.png

[注解]
注1：“认证URL”可在Wiwiz Web面板的“热点设置”页面中设置。它就是用户根据Wiwiz Auth API的规范为用户系统写的Web程序的地址。

注2：<重要>出于安全考虑，进行预认证发起的HTTP请求一定要在服务器端程序中进行。例如，在ASP，C#/VB.Net，JSP/Servlet，PHP代码中，而不要使用HTML与Javascript在客户端发起请求。

注3：User Key可在Wiwiz Web面板的“用户菜单”->“升级选项”->“查询User Key”中查询。

注4：错误代码及错误原因：
6.png

注5：用于完成认证所发起的HTTP请求，最简单的方式是的方式是使浏览器跳转到指定地址，可使用服务器端代码通过向浏览器发送Redirect指令进行，也可使用客户端代码进行浏览器页面地址跳转，如HTML，JavaScript。

注6：错误代码及错误原因：
7.png

本文章由 http://www.wifidog.pro/2015/03/20/wifidog%E8%AE%A4%E8%AF%81%E6%9C%8D%E5%8A%A1%E6%8E%A5%E5%8F%A3.html 整理编辑，转载请注明出处

标签: wifidog认证, wifidog流程, wifidog配置, dd wrt wifidog教程, dd wrt wifidog配置