华为乾坤-URL模板:参数说明

时间：2025-02-17 11:36:42

参数说明

表1 “策略模板”（URL模板）
参数名称		说明
名称		用于唯一标识URL模板。
模板类型		“云平台中继认证”和“第三方认证”可供选择。
模板参数	赋值方式	范围：替换控制器已有值：选择iMaster NCE-Campus已有参数。用户自定义：用户自定义参数值。约束和限制：赋值方式仅“云平台中继认证”类型有效。
	参数内容	指定在URL中携带的模板参数信息。模板类型不同，支持定义的模板参数也不同。各参数详细说明以及填写要求请参见表2。
	参数名称	第三方portal服务器认证所需参数名称。
MAC地址格式设置（仅“模板类型”选择为“云平台中继认证”可配置）		默认不开启，开启后可设置“模板参数”中的“参数内容”为ap-mac、device-mac、user-mac参数的MAC地址格式。开关开启时支持的设置的格式包含： MAC地址大小写：“大写”，“小写”。 MAC地址连接符：“横杠（-）”，“点（.）”，“冒号（：）”，“无连接符”。 MAC地址格式：“XXXX-XXXX-XXXX”，“XX-XX-XX-XX-XX-XX”。
URL参数加密（仅“模板类型”选择为“云平台中继认证”可配置）	URL参数名称	为了传输数据的安全，希望Portal服务器和控制器之间传递的URL参数能够经过加密处理时，可通过使能此开关实现。开启后URL参数会整体加密，仅支持AES-CBC算法。
	密钥	三方认证系统和iMaster NCE-Campus对接时，该系统使用的对接密钥和密钥向量。
	密钥IV向量	三方认证系统和iMaster NCE-Campus对接时，该系统使用的对接密钥和密钥向量。

表2 模板参数
模板类型	参数	参数说明	取值
云平台中继认证	device-mac	指定在URL中携带认证设备的MAC地址。	取值为1~64位字母、短线、数字或下划线，不能以数字开头。
	redirect-url	指定在URL中携带用户重定向前访问的原始URL。
	ssid	指定在URL中携带用户关联的SSID名称。
	user-ip	指定在URL中携带接入用户的IP地址。
	user-mac	指定在URL中携带接入用户的MAC地址。
	loginurl	指定在URL中携带iMaster NCE-Campus提供的用户认证的URL。
	ap-location	指定在URL中携带AP的位置信息。
	fitap-mac	指定在URL中携带WAC+FitAP认证场景下，FitAP的MAC地址信息。
	sync-login-url	指定在URL中携带三方Portal服务器回调的认证同步接口信息。
	sync-login-http-url	指定在URL中携带三方Portal服务器回调的认证同步HTTP接口信息。
	site-code	指定在URL中携带站点认证码信息。
	device-type	指定在URL中携带认证设备的设备类型信息。
	site-name	指定在URL中携带站点名称信息。
第三方认证	ap-ip	AP的IP地址。	取值为1~16位的半角字符，不能包含空格。
	device-ip	认证设备的IP地址，对于普通云AP，需要使用ap-ip参数。
	ap-mac	AP的MAC地址。
	redirect-url	用户重定向前访问的原始URL。
	ssid	用户关联的SSID名称。
	sysname	认证设备的系统名称。
	user-ip	用户的IP地址。
	user-mac	用户的MAC地址。
	device-mac	认证设备的MAC地址，对于普通云AP，需要使用ap-mac参数。
	interface	用户接入的设备接口。
	esn	认证设备的ESN。
	ap-location	AP的位置信息。
	login-url	认证设备的登录URL。其中： url-key：重定向时携带给Portal服务器登录URL的识别关键字。 url：接入设备上指定的URL。说明：中心AP不支持此参数。	“login-url”有两个值需要填充，url-key和url之间需要用空格隔开。例如：XX Y。 url-key：重定向时携带给Portal服务器登录URL的识别关键字。字符串形式，不支持空格、问号、和号和等于号，区分大小写，长度范围是1～16。 url：接入设备上指定的URL。字符串形式，不支持空格，区分大小写，长度范围是1～247。