wifi认证Portal开发系列(三):portal协议

中国移动WLAN业务PORTAL协议规范介绍

 

一、用户上线认证流程

上线流程完成用户账号的认证,并把认证结果通知Portal Server,Portal server将会通知WLAN用户并且显示相应的认证结果。

用户上线认证方式有两种:CHAP和PAP,其中CHAP方式为必选功能,PAP方式为可选功能。

1.1、用户上线Chap认证流程

 

 

  1. 用户访问网站,经过AC重定向到Portal Server,Portal Server推送认证页面;
  2. 用户填入用户名、密码,提交页面,向Portal Server发起连接请求;
  3. Portal Server向AC请求Challenge;
  4. AC分配Challenge给Portal Server;
  5. Portal Server向AC发起认证请求;
  6. 而后AC进行RADIUS认证,获得RADIUS认证结果;
  7. AC向Portal Server送认证结果;
  8. Portal Server将认证结果填入页面,和门户网站一起推送给客户;
  9. Portal Server回应确认收到认证结果的报文。

 1.2、用户上线Pap认证流程

 

 

  1. 用户访问网站,经过AC重定向到Portal Server,Portal Server推送认证页面;
  2. 用户填入用户名、密码,提交页面,向Portal Server发起连接请求;
  3. Portal Server向AC发起认证请求;
  4. 而后AC进行RADIUS认证,获得RADIUS认证结果;
  5. AC向Portal Server送认证结果;
  6. Portal Server将认证结果填入页面,和门户网站一起推送给客户;
  7. Portal Server回应确认收到认证结果的报文。

 

二、用户下线流程

用户下线流程包括用户主动发起下线流程,和用户异常下线流程:AC侦测到用户下线,主动通知Portal server。

2.1、用户下线流程

 

  1. 用户发起下线请求到Portal Server。
  2. Portal Server向AC请求下线。
  3. AC回应Portal Server下线请求。
  4. Portal Server推送下线结果页面给用户。

2.2、用户异常下线流程

用户异常下线流程:AC侦测用户下线流程,主动通知Portal server。

 

 

  1. AC侦测到用户下线,向Portal Server请求下线;
  2. Portal Server回应下线成功;

三、数据报文

3.1、报文格式

协议包采用固定长度头加可变长度的属性字段组成,属性字段采用TLV格式,具体如下图所示。

3.2、报文字段说明

Ver

Ver字段是协议的版本号,长度为 1 字节,目前定义的值为 0x01;

Type

Type字段定义报文的类型,长度为 1 字节,目前其值的如下图所示

 

Pap/Chap

Pap/Chap字段定义此用户的认证方式,长度为 1 字节,只对Type值为 0x03 的认证请求报文有意义:

    1. Chap方式认证,值:0x00
    2. Pap  方式认证,值:0x01

Rsv

Rsv目前为保留字段,长度为 1 字节,在所有报文中值为 0

SerialNo

(1)、SerialNo字段为报文的序列号,长度为 2 字节,由Portal Server随机生成,Portal Server必须尽量保证不同认证流程的SerialNo在一定时间内不得重复,在同一个认证流程中所有报文的SerialNo相同;

(2)、Portal Server发给AC设备的报文

a、由Portal Server发出的Type值为1、3的请求报文其SerialNo都是随机生成数;

b、由Portal Server向AC设备发出的Type值为5的(REQ_LOGOUT)报文其SerialNo值分两中情况:当ErrCode为0 时(请求用户下线报文),SerialNo值为一个随机生成数;当ErrCode为1时,SerialNo值可能和Type值为1或3的报文 (请求Challenge超时, 或请求认证超时) 相同,具体要看是请求Challenge超时还是请求认证超时;

c、由Portal Server向AC设备发出的认证成功确认报文(Type值为7的报文)SerialNo和其发出的相应请求报文的SerrialNo相同;比如对于Type值为7的报文其SerialNo值和Type值为3的请求认证报文相同;

(3)、每一个由AC设备发给Portal Server的响应报文的SerialNo必须和Portal Server发送的相应请求报文的SerialNo一样,否则Portal Server会丢掉从AC设备发来的响应报文; 比如Type值为2的报文其SerialNo值必须和Type值为1的报文相同,Type值为4的报文其SerialNo值必须和Type值为3的报文相同,Type值为6的报文其SerialNo值必须和Type值为5的报文相同。

ReqID

(1)、ReqID字段长度为 2 个字节,由AC设备随机生成,尽量使得在一定时间内ReqID不重复。

(2)、在Chap认证方式中:

a、AC设备在Type为2 (ACK-CHALLENGE) 的请求Challenge响应报文中把该ReqID的值告诉Portal Server;

b、在Type值为3、4、7 ( REQ-AUTH, ACK-AUTH, AFF-ACK-AUTH ) 的报文中ReqID字段的值都和Type值为2的报文中此字段的值相同;

c、在Type值为 5 (REQ-LOGOUT) 的报文中,若报文表示请求Challenge 超时则此字段值为0 ;若报文表示请求认证超时则此字段值和Type值为2 (ACK-CHALLENGE)的报文中此字段的值相同;

(3)、在Pap认证方式中,此字段无意义,其值为0;

(4)、在Type值为 5 (REQ-LOGOUT) 的报文中,若报文表示请求下线时则此字段值为0 ;

(5)、在Type值为1、6 (REQ-CHALLENGE , ACK-LOGOUT) 的报文中,该字段均无意义,值都为 0;

UserIP

UserIP字段为Portal用户的IP地址,长度为 4 字节,其值由Portal Server根据其获得的IP地址填写

在所有的报文中此字段都要有具体的值

UserPort

UserPort字段目前没有用到,长度为 2 字节,在所有报文中其值为0

ErrCode

ErrCode字段和Type字段一起表示一定的意义,长度为 1字节,具体如下:

(1)、对于Type值为1、3、7的报文,ErrCode字段无意义,其值为0;

(2)、当Type值为 2 时:

ErrCode=0,表示AC设备告诉Portal Server请求Challenge成功;

ErrCode=1,表示AC设备告诉Portal Server请求Challenge被拒绝;

ErrCode=2,表示AC设备告诉Portal Server此链接已建立;

ErrCode=3,表示AC设备告诉Portal Server有一个用户正在认证过程中,请稍后再试;

ErrCode=4,则表示AC设备告诉Portal Server此用户请求Challenge失败(发生错误);

(3)、当Type值为 4 时:

ErrCode=0,表示AC设备告诉Portal Server此用户认证成功;

ErrCode=1,表示AC设备告诉Portal Server此用户认证请求被拒绝;

ErrCode=2,表示AC设备告诉Portal Server此链接已建立;

ErrCode=3,表示AC设备告诉Portal Server有一个用户正在认证过程中,请稍后再试;

ErrCode=4 ,表示AC设备告诉Portal Server此用户认证失败(发生错误);

(4)、当Type值为 5 时:

ErrCode=0,表示此报文是Portal Server发给AC设备的请求下线报文;

ErrCode=1,表示此报文是在Portal Server没有收到AC设备发来的对各种请求的响应报文,而定时器时间到(即超时)时由Portal Server发给AC设备的报文;

(5)、当Type值为 6 时:

ErrCode=0,表示AC设备告诉Portal Server此用户下线成功;

ErrCode=1,表示AC设备告诉Portal Server此用户下线被拒绝;

ErrCode=2,  表示AC设备告诉Portal Server此用户下线失败(发生错误);

(6)、对Type为REQ_INFO时,ErrCode无意义,其值为0;

(7)、对Type为NTF_LOGOUT时,ErrCode含义如下:

 

(8)、对Type为ACK_INFO时,ErrCode含义如下:

AttrNum

AttrNum字段表示其后边可变长度的属性字段属性的个数,长度为 1 字节(表示属性字段最多可有255个属性),其值在所有的报文中都要根据具体情况赋值。

Attr:报文属性字段

Attr字段(属性字段)是一个可变长字段,由多个属性依次链接而成,每个属性的格式为TLV格式。

整体的Attr可能由多个属性TLV组成

 

报文属性字段说明如下:

(1)、属性类型(AttrType)

 

(2)、属性长度(AttrLen)

AttrLen字段表示属性的长度,长度为1字节,其值是整个属性三个字段AttrType、AttrLen、AttrValue的长度之和。

(3)、属性值(AttrValue)

AttrValue的值为具体的属性值,比如用户名、口令等,长度有些可变,有些固定(具体见表6.2),但最长不能超过253(255-2)字节。

 

四、参数

1、此协议规定承载报文的是UDP协议,也即报文为UDP报文,AC设备在固定端口2000(参照《BNAS宽带接入服务器技术规范-YD1148》修订)上等待接收Portal Server发来的各种请求报文和确认报文。

2、 PORTAL强制相关参数

当AC实现强制PORTAL功能时,要求在强制PORTAL URL中包含以下参数:

具体参数格式示例如下:

http://www.portal.com?wlanuserip=10.1.2.34&wlanacname= ACN.CTY.PRO.OPE

http://www.portal.com?wlanusername=IMSI@SIM

允许在”?”后面有其他的参数,但是名称不能以wlan作为起始。

3、 Chap认证的相关说明:

(1)、challenge的生成(AC生成) :

challenge由AC设备在收到请求Challenge报文的时候随机生成,长度为16个字节,跟随Challenge应答报文下发到Portal Server。

(2)、Chap_Password(Chap密码)的生成:

Chap_Password的生成遵循标准的Radious协议中的Chap_Password 生成方法(参见RFC2865)。

密码加密使用MD5算法,MD5函数的输入为ChapID + Password +Challenge  (ReqID有AC生成, ChapID是ReqID的低8位)

其中,ChapID取ReqID的低 8 位,Password的长度不够协议规定的最大长度,其后不需要补零。

Chap_Password = MD5 (ChapID+ Password + Challenge )

4、无论采用Chap认证还是Pap认证,都允许用户口令为空;

5、当用户向Portal Server提交的连接请求里用户名为空时,Portal Server在向AC设备发送认证请求时应用一个缺省的用户名代替(比如***);

6、认证流程中各种报文所带属性的个数(建议):

(1)、请求Challenge 报文:0个属性;

(2)、对请求Challenge响应的报文:若请求Challenge成功则为1个属性—Challenge属性,若请求Challenge失败则属性个数为0个;

(3)、请求认证报文:2个属性,分别为用户名、PassWord 或ChapPassWord ;

(4)、对请求认证的响应报文:0个属性;

(5)、请求下线报文或表示超时的报文:0个属性;

(6)、对请求下线的响应报文:0个属性;

(7)、Portal Server对收到从AC设备发来的认证成功报文的确认:0个属性;

(8)、强制下线请求:0个属性;

(9)、查询请求和回应:待定;

7、报文的长度限制是最小16字节,最大1024(1K)字节;

8、从支持多国语言的角度出发,认证结果信息进行统一编码,由Portal Server根据用户语言上下文推送对应信息的页面。

 

 

 

 

转载于:https://www.cnblogs.com/FlyingPuPu/p/7803241.html

  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

表情包
插入表情
评论将由博主筛选后显示,对所有人可见 | 还能输入1000个字符
相关推荐
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值