WX3510H无线控制器对接第三方portal服务器

在portal-web-server下传参

1.1.170  url-parameter

url-parameter命令用来配置设备重定向给用户的Portal Web服务器的URL中携带的参数信息。

undo url-parameter命令用来删除配置的Portal Web服务器URL携带的参数信息。

【命令】

url-parameter param-name { nas-id | nas-port-id | original-url | source-address | ssid | { ap-mac | source-mac } [ format section { 1 | 3 | 6 } { lowercase | uppercase } ] [ encryption { aes | des } key { cipher | simple } string ] | value expression | vlan }

undo url-parameter param-name

【缺省情况】

未配置设备重定向给用户的Portal Web服务器的URL中携带的参数信息。

【视图】

Portal Web服务器视图

【缺省用户角色】

network-admin

【参数】

param-name：URL参数名，为1～32个字符的字符串，区分大小写。URL参数名对应的参数内容由param-name后的参数指定。

nas-id：网络接入服务器标识。

nas-port-id：网络接入服务器端口标识。

original-url：用户初始访问的Web页面的URL。

source-address：用户的IP地址。

ssid：无线AP的SSID（服务集标示符）。

ap-mac：无线AP的MAC地址。

source-mac：用户的MAC地址。

format：指定MAC地址格式。

section：指定MAC地址分段数。

1：MAC地址被分为1段，如XXXXXXXXXXXX。

3：MAC地址被分为3段，如XXXX-XXXX-XXXX。

6：MAC地址被分为6段，如XX-XX-XX-XX-XX-XX。

lowercase：MAC地址格式为小写。

uppercase：MAC地址格式为大写。

encryption：表示以密文的方式携带无线AP的MAC地址和用户的MAC地址。

aes：指定加密算法为AES算法。

des：指定加密算法为DES算法。

cipher：以密文方式设置密钥。

key：指定加密密钥。

simple：以明文方式设置密钥，该密钥将以密文形式存储。

string：密钥字符串，区分大小写。密钥的长度范围和选择的加密方式有关。具体关系如下：

·     对于des cipher，密钥为41个字符的字符串。

·     对于des simple，密钥为8个字符的字符串。

·     对于aes cipher，密钥为1～73个字符的字符串。

·     对于aes simple，密钥为1～31个字符的字符串。

value expression：自定义字符串，为1～256个字符的字符串，区分大小写。

vlan：用户VLAN。

【使用指导】

可以通过多次执行本命令配置多条参数信息。

配置url-parameter命令会导致Portal Web服务器的URL长度增加，当URL总长度超过2048字节时，设备会将超过的字节丢弃，从而造成重定向失败。

对于同一个参数名param-name后的参数设置，最后配置的生效。

该命令用于配置用户访问Portal Web服务器时，要求携带的一些参数，比较常用的是要求携带用户的IP地址、MAC地址、用户原始访问的URL信息。用户也可以手工指定，携带一些特定的字符信息。配置完成后，在设备给用户强制重定向URL时会携带这些参数，例如用户的源IP地址的1.1.1.1，配置Portal Web服务器的URL为：***.***/portal，若同时配置如下两个参数信息：url-parameter userip source-address和

url-parameter userurl value ***.***/welcome，则设备给该用户重定向时回应的URL格式即为：***.***/portal?userip=1.1.1.1&userurl=***.***/welcome。

param-name这个URL参数名必须与具体应用环境中的Portal服务器所支持的URL参数名保持一致，不同的Portal服务器支持URL参数名是不一样的，请根据具体情况配置URL参数名。例如iMC服务器支持的URL参数名如下：

·     userurl：表示original-url

·     userip：表示source-address

·     usermac：表示source-mac

在Portal服务器为H3C公司的iMC服务器的组网环境中，如果设备重定向给用户的Portal Web服务器的URL中需要携带用户的IP地址参数信息时，必须把param-name参数配置成userip，否则，iMC服务器不能识别用户的IP地址。

如果给某个参数配置了加密方式，则重定向URL中携带的将是其加密后的值。例如在上述配置的基础上，再配置url-parameter usermac source-mac encryption des key simple 12345678，则设备给源MAC地址为1111-1111-1111的用户重定向时回应的URL格式即为：

***.***/portal?usermac=xxxxxxxxx&userip=1.1.1.1&userurl=***.***/welcome，其中xxxxxxxxx为加密后的用户mac地址。

【举例】

# 为设备重定向给用户的Portal Web服务器wbs的URL中配置两个参数userip和userurl，其值分别为用户IP地址和自定义字符串***.***/welcome。

<Sysname> system-view

[Sysname] portal web-server wbs

[Sysname-portal-websvr-wbs] url-parameter userip source-address

[Sysname-portal-websvr-wbs] url-parameter userurl value ***.***/welcome

# 为设备重定向给用户的Portal Web服务器wbs的URL中配置参数usermac，其值为用户mac地址，并使用des算法进行加密。

<Sysname> system-view

[Sysname] portal web-server wbs

[Sysname-portal-websvr-wbs] url-parameter usermac source-mac encryption des key simple 12345678

# 为设备重定向给用户的Portal Web服务器wbs的URL中配置参数vlan，其值为用户VLAN。

<Sysname> system-view

[Sysname] portal web-server wbs

[Sysname-portal-websvr-wbs] url-parameter uservlan vlan