国家 / 地区

11-安全命令参考

09-Portal命令

本章节下载  (278.64 KB)

docurl=/cn/Service/Document_Software/Document_Center/Routers/Catalog/MSR/MSR_50/Command/Command_Manual/H3C_MSR_CR(V5)-R2516-V1.16/11/201807/1093949_30005_0.htm

09-Portal命令


1 Portal

1.1  Portal配置命令

1.1.1  access-user detect

【命令】

access-user detect type arp retransmit number interval interval

undo access-user detect

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

type arp:表示探测报文的类型为ARP请求。

number:探测报文发送的次数,即允许探测无响应的次数,取值范围为2~5。在探测次数达到该值时,若设备仍未收到Portal用户的响应报文,则将强制该用户下线。

interval:探测报文发送的间隔,取值范围为5~120,单位为秒。

【描述】

access-user detect命令用来配置Portal用户在线探测功能。undo access-user detect命令用来恢复缺省情况。

缺省情况下,接口上未配置Portal用户在线探测功能。

配置了该功能的设备,通过主动向从接口上线的Portal在线用户定期发送ARP探测报文来确认该用户是否在线。具体的探测过程为:若设备发现3分钟(不可配)内接口上未收到某Portal用户的报文,则向该用户发送ARP探测报文,若在探测次数达到指定值时,设备仍未收到该用户的响应报文,则将强制其下线。如果在指定的探测次数到达之前,设备收到了该用户的响应报文,则停止发送探测报文,并开始监测接下来的3分钟之内该用户是否有流量,并重复这个过程。

本功能仅直接和二次地址分配方式的三层Portal认证支持。

【举例】

# 在接口Ethernet1/1上配置Portal用户在线探测功能:探测报文为ARP请求报文,发送探测报文的次数为3次,发送间隔为10秒。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] access-user detect type arp retransmit 3 interval 10

1.1.2  display portal acl

【命令】

display portal acl { all | dynamic | static } interface interface-type interface-number [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

all:显示所有ACL的信息,包括动态ACL和静态ACL。

dynamic:显示动态ACL的信息,即用户通过Portal认证后产生的ACL。

static:显示静态ACL的信息,即相关配置产生的ACL。

interface interface-type interface-number:显示指定接口的ACL统计信息。interface-type interface-number为接口类型和接口编号。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal acl命令用来显示接口上Portal的ACL信息。

【举例】

# 显示接口Ethernet1/1上所有ACL的统计信息。

<Sysname> display portal acl all interface ethernet 1/1

IPv4 portal ACL rules on Ethernet1/1:

 Rule 0

 Inbound interface : Ethernet1/1

 Type                 : static

 Action               : permit

 Protocol            : 0

 Source:

    IP        : 0.0.0.0

    Mask      : 0.0.0.0

    Port      : any

    MAC       : 0000-0000-0000

    Interface : any

    VLAN      : 0

Destination:

    IP        : 192.168.0.111

    Mask      : 255.255.255.255

    Port      : any

 

Rule 1

 Inbound interface : Ethernet1/1

 Type              : static

 Action            : redirect

 Protocol         : 6

 Source:

    IP        : 0.0.0.0

    Mask      : 0.0.0.0

    Port      : any

    MAC       : 0000-0000-0000

    Interface : any

    VLAN      : 2

Destination:

    IP        : 0.0.0.0

    Mask      : 0.0.0.0

    Port      : 80

 

 Rule 2

 Inbound interface : Ethernet1/1

 Type                 : dynamic

 Action               : permit

 Source:

    IP        : 2.2.2.2

    Mask      : 255.255.255.255

    MAC       : 000d-88f8-0eab

    Interface : Ethernet1/1

    VLAN      : 0

    Protocol  : 0

 Destination:

    IP        : 0.0.0.0

    Mask      : 0.0.0.0

 Author ACL:

    Number   : 3001

表1-1 display portal acl命令显示信息描述表

字段

描述

 

Rule

Portal ACL编号,此编号为生成的ACL序号,每次显示从0开始递增

 

Inbound interface

Portal ACL绑定的接口

 

Type

Portal ACL的类型

 

Action

Portal ACL的匹配动作

 

Protocol

Portal ACL的传输层协议号

Source

Portal ACL的源信息

 

IP

Portal ACL的源IP地址

 

Mask

Portal ACL的源IP地址子网掩码

 

Port

Portal ACL的源传输层端口号

MAC

Portal ACL的源MAC地址

 

Interface

Portal ACL的源接口

 

VLAN

Portal ACL的源VLAN

 

Protocol

Portal ACL的协议类型

 

Destination

Portal ACL目的信息

 

IP

Portal ACL的目的IP地址

 

Port

Portal ACL的目的传输层端口号

Mask

Portal ACL的目的IP地址子网掩码

 

Author ACL

Portal ACL的授权ACL,该字段仅在Type为dynamic时才显示

 

Number

Portal ACL的授权ACL号,即服务器下发的ACL号,None表示服务器未下发ACL

 

 

1.1.3  display portal connection statistics

【命令】

display portal connection statistics { all | interface interface-type interface-number } [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

all:显示所有接口上Portal的连接统计信息。

interface interface-type interface-number:显示指定接口上Portal的连接统计信息。interface-type interface-number为接口类型和接口编号。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal connection statistics命令用来显示接口上Portal的连接统计信息。

【举例】

# 显示接口Ethernet1/1上Portal的连接统计信息。

<Sysname> display portal connection statistics interface ethernet 1/1

 ---------------Interface: Ethernet1/1-----------------------

 User state statistics:

 State-Name                User-Num

 VOID                       0

 DISCOVERED                0

 WAIT_AUTHEN_ACK          0

 WAIT_AUTHOR_ACK          0

 WAIT_LOGIN_ACK           0

 WAIT_ACL_ACK              0

 WAIT_NEW_IP               0

 WAIT_USERIPCHANGE_ACK   0

 ONLINE                     1

 WAIT_LOGOUT_ACK          0

 WAIT_LEAVING_ACK         0

 

 Message statistics:

 Msg-Name                  Total         Err           Discard

 MSG_AUTHEN_ACK           3              0             0

 MSG_AUTHOR_ACK           3              0             0

 MSG_LOGIN_ACK            3              0             0

 MSG_LOGOUT_ACK           2              0             0

 MSG_LEAVING_ACK          0              0             0

 MSG_CUT_REQ               0              0             0

 MSG_AUTH_REQ              3              0             0

 MSG_LOGIN_REQ             3              0             0

 MSG_LOGOUT_REQ            2              0             0

 MSG_LEAVING_REQ           0              0             0

 MSG_ARPPKT                 0              0             0

 MSG_PORT_REMOVE           0              0             0

 MSG_VLAN_REMOVE           0              0             0

 MSG_IF_REMOVE             6              0             0

 MSG_IF_SHUT                0              0             0

 MSG_IF_DISPORTAL          0             0             0

 MSG_IF_UP                 0             0             0

 MSG_ACL_RESULT            0             0             0

 MSG_AAACUTBKREQ           0             0             0

 MSG_CUT_BY_USERINDEX      0             0             0

 MSG_CUT_L3IF              0             0             0

 MSG_IP_REMOVE             0              0             0

 MSG_ALL_REMOVE            1              0             0

 MSG_IFIPADDR_CHANGE      0              0             0

 MSG_SOCKET_CHANGE        8              0             0.

 MSG_NOTIFY                 0             0             0

 MSG_SETPOLICY             0             0             0

 MSG_SETPOLICY_RESULT     0             0             0

表1-2 display portal connection statistics命令显示信息描述表

字段

描述

 

User state statistics

Portal用户统计信息

 

State-Name

用户状态名称

 

User-Num

某状态下的用户数量

 

VOID

处于void状态的用户数

 

DISCOVERED

处于discovered状态的用户数

 

WAIT_AUTHEN_ACK

处于wait_authen_ack状态的用户数

 

WAIT_AUTHOR_ACK

处于wait_author_ack状态的用户数

 

WAIT_LOGIN_ACK

处于wait_login_ack状态的用户数

 

WAIT_ACL_ACK

处于wait_acl_ack状态的用户数

 

WAIT_NEW_IP

处于wait_new_ip状态的用户数

 

WAIT_USERIPCHANGE_ACK

处于wait_useripchange_ack状态的用户数

 

ONLINE

处于online状态的用户数

 

WAIT_LOGOUT_ACK

处于wait_logout_ack状态的用户数

 

WAIT_LEAVING_ACK

处于wait_leaving_ack状态的用户数

 

Message statistics

消息统计信息

 

Msg-Name

消息名字

 

Total

某一类消息的总数

 

Err

某一类错误的消息的数目

 

Discard

某一类被丢弃的消息的数目

 

MSG_AUTHEN_ACK

认证回应消息

 

MSG_AUTHOR_ACK

授权回应消息

 

MSG_LOGIN_ACK

计费回应消息

 

MSG_LOGOUT_ACK

停止计费请求回应消息

 

MSG_LEAVING_ACK

下线请求回应消息

 

MSG_CUT_REQ

切断用户请求消息

 

MSG_AUTH_REQ

认证请求消息

 

MSG_LOGIN_REQ

计费请求消息

 

MSG_LOGOUT_REQ

停止计费请求消息

 

MSG_LEAVING_REQ

下线请求消息

 

MSG_ARPPKT

ARP消息

 

MSG_PORT_REMOVE

删除某个二层接口的用户消息

 

MSG_VLAN_REMOVE

删除VLAN的用户消息

 

MSG_IF_REMOVE

删除某个三层接口导致用户下线的消息

 

MSG_IF_SHUT

三层接口关闭的消息

 

MSG_IF_DISPORTAL

接口去使能Portal的消息

 

MSG_IF_UP

三层接口UP的消息

 

MSG_ACL_RESULT

ACL下发失败的消息

 

MSG_AAACUTBKREQ

AAA通知Portal删除备份用户的消息

MSG_CUT_BY_USERINDEX

强制用户下线的消息

MSG_CUT_L3IF

强制用户下线导致的删除某个三层接口的用户消息

 

MSG_IP_REMOVE

删除某个IP的用户消息

 

MSG_ALL_REMOVE

删除所有的用户消息

 

MSG_IFIPADDR_CHANGE

接口IP变化消息

 

MSG_SOCKET_CHANGE

socket变化消息

 

MSG_NOTIFY

通知下发消息

 

MSG_SETPOLICY

服务器下发安全ACL的Set policy消息

 

MSG_SETPOLICY_RESULT

Set policy结果消息

 

 

1.1.4  display portal free-rule

【命令】

display portal free-rule [ rule-number ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

rule-number:免认证规则编号。取值范围为0~255。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal free-rule命令用来显示Portal的免认证规则信息。

需要注意的是,若不指定参数rule-number,则显示所有的免认证规则信息。

相关配置可参考命令portal free-rule

【举例】

# 显示编号为1的免认证规则。

<Sysname> display portal free-rule 1

 Rule-Number  1:

 Source:

   IP        : 2.2.2.0

   Mask      : 255.255.255.0

   Port      : any

   MAC       : 0000-0000-0000

   Interface : any

   Vlan      : 0

 Destination:

   IP        : 0.0.0.0

   Mask      : 0.0.0.0

   Port      : any

 Protocol    : 6

表1-3 display portal free-rule命令显示信息描述表

字段

描述

 

Rule-Number

免认证规则的编号

 

Source

免认证规则的源信息

 

IP

免认证规则的源IP地址

 

Mask

免认证规则的源IP地址子网掩码

 

Port

免认证规则的源传输层协议端口号

MAC

免认证规则的源MAC地址

 

Interface

免认证规则的源接口

 

Vlan

免认证规则的源VLAN

 

Destination

免认证规则的目的信息

 

IP

免认证规则的目的IP地址

 

Mask

免认证规则的目的IP地址子网掩码

 

Port

免认证规则的目的传输层协议端口号

 

Protocol

免认证规则的传输层协议号

 

 

1.1.5  display portal interface

【命令】

display portal interface interface-type interface-number [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

interface-type interface-number:接口类型和接口编号。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal interface命令用来显示指定接口的Portal配置信息。

【举例】

# 显示接口Ethernet1/1的Portal配置信息。

<Sysname> display portal interface ethernet 1/1

Portal configuration of Ethernet 1/1

 IPv4:

     Status: Portal running

     Portal server: servername

     Portal backup-group: 1

     Authentication type: Layer3

     Authentication domain: my-domain

     Authentication network:

         Source       IP: 1.1.1.1              Mask : 255.255.0.0

表1-4 display portal interface命令显示信息描述表

字段

描述

Portal configuration of interface

接口interface上的Portal的配置信息

IPv4

IPv4 Portal服务器的相关配置信息

Status

接口上Portal认证的状态

·     Portal disabled:Portal认证未使能

·     Portal enabled:Portal认证已使能,但未生效

·     Portal running:Portal认证已生效

Portal server

接口引用的Portal服务器

Authentication type

接口上配置的认证方式

Authentication domain

接口上的强制认证域

Authentication network

Portal认证网段信息,可包括源认证网段信息和目的认证网段信息

Source IP

Portal源认证网段的IP地址

Destination IP

Portal目的认证网段的IP地址

Mask

Portal认证网段的子网掩码

 

1.1.6  display portal local-server

【命令】

display portal local-server [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal local-server用来显示本地Portal服务器的配置信息,包括支持的协议类型、SSID的绑定关系。

相关配置可参考命令portal local-server

【举例】

# 显示本地Portal服务器的配置。

<Sysname> display portal local-server

 Protocol: HTTP

 Bind SSID list:

  ssid1: file1.zip

  ssid2: file1.zip

表1-5 display portal local-server命令显示信息描述表

字段

描述

Protocol

本地Portal服务器支持的协议类型,包括HTTP和HTTPS,目前,MSR设备仅支持HTTP协议

Bind SSID list

SSID绑定关系列表,如果未配置绑定关系,则此字段为空;如果不支持绑定配置,则无此字段

 

1.1.7  display portal server

【命令】

display portal server [ server-name ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

server-name:Portal服务器的名称,为1~32个字符的字符串,区分大小写。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal server命令用来显示Portal服务器信息。

需要注意的是,若不指定参数server-name,则显示所有Portal服务器信息。

相关配置可参考命令portal server

【举例】

# 显示Portal服务器aaa的信息。

<Sysname> display portal server aaa

 Portal server:

  1)aaa:

    IP             : 192.168.0.111

    VPN instance : vpn1

    Port           : 50100

    Key            : ******

    URL            : http://192.168.0.111

    Status        : Up

表1-6 display portal server命令显示信息描述表

字段

描述

1)

Portal服务器编号

aaa

Portal服务器名称

VPN instance

Portal服务器所属的MPLS L3VPN

IP

Portal服务器的IP地址

Port

Portal服务器的监听端口

Key

与Portal服务器进行报文交互时使用的共享密钥

·     若已配置,则显示******

·     若未配置,则显示Not configured

URL

Portal服务器重定向地址

若未配置,则显示Not configured

Status

Portal服务器当前状态,其取值涵义如下:

·     N/A:该服务器未在任何接口上被引用或者服务器探测功能未开启,可达状态未知;

·     Up:服务器探测功能已开启,且该服务器已经在接口上被引用,探测结果为该服务器当前可达;

·     Down:服务器探测功能已开启,且该服务器已经在接口上被引用,探测结果为该服务器当前不可达

 

1.1.8  display portal server statistics

【命令】

display portal server statistics { all | interface interface-type interface-number } [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

all:显示所有接口上Portal服务器的统计信息。

interface interface-type interface-number:显示指定接口上Portal服务器的统计信息。interface-type interface-number为接口类型和接口编号。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal server statistics命令用来显示接口上Portal服务器的统计信息,其中包括设备接收到Portal服务器发送的报文以及设备发送给该Portal服务器的报文的信息。

需要注意的是,指定all参数时,设备依次显示各个接口上的Portal服务器的统计信息,即使是一个Portal服务器的统计信息也是分别在不同接口下显示。

【举例】

# 显示接口Ethernet1/1上Portal服务器的统计信息。

<Sysname> display portal server statistics interface ethernet 1/1

 ---------------Interface: Ethernet1/1----------------------

 Server name:  st

 Invalid packets: 0

 Pkt-Name                          Total   Discard  Checkerr

 REQ_CHALLENGE                       3        0        0

 ACK_CHALLENGE                       3        0        0

 REQ_AUTH                             3        0        0

 ACK_AUTH                             3        0        0

 REQ_LOGOUT                           1        0        0

 ACK_LOGOUT                           1        0        0

 AFF_ACK_AUTH                         3        0        0

 NTF_LOGOUT                           1        0        0

 REQ_INFO                              6        0        0

 ACK_INFO                              6        0        0

 NTF_USERDISCOVER                    0        0        0

 NTF_USERIPCHANGE                    0        0        0

 AFF_NTF_USERIPCHANGE               0         0        0

 ACK_NTF_LOGOUT                      1         0        0

 NTF_HEARTBEAT                        0        0        0

 NTF_USERSYNC                        2         0        0

 ACK_NTF_USERSYNC                   0         0        0

 NTF_CHALLENGE                       0        0        0

 NTF_USER_NOTIFY                     0        0        0

 AFF_NTF_USER_NOTIFY                 0        0        0

 NTF_AUTH                              0        0        0

 ACK_NTF_AUTH                         0        0        0

 REQ_QUERY_STATE                     0        0        0

 ACK_QUERY_STATE                      0        0        0

 REQ_MACBINDING_INFO                 0        0        0

 ACK_MACBINDING_INFO                 0        0        0

 NTF_USER_LOGON                       0        0        0

 RESERVED33                            0        0        0

 NTF_USER_LOGOUT                      0        0        0

 RESERVED35                            0        0        0

 PT_TYPE_REQ_USER_OFFLINE           0        0        0

表1-7 display portal server statistics命令显示信息描述表

字段

描述

 

Interface

Portal服务器所在的接口

 

Server name

Portal服务器名称

 

Invalid packets

无效报文的数目

 

Pkt-Name

报文的名称

 

Total

报文的总数

 

Discard

丢弃报文数

 

Checkerr

错误报文数

 

REQ_CHALLENGE

Portal服务器向接入设备发送的challenge请求报文

 

ACK_CHALLENGE

接入设备对Portal服务器challenge请求的响应报文

 

REQ_AUTH

Portal服务器向接入设备发送的请求认证报文

 

ACK_AUTH

接入设备对Portal服务器认证请求的响应报文

 

REQ_LOGOUT

Portal服务器向接入设备发送的下线请求报文

 

ACK_LOGOUT

接入设备对Portal服务器下线请求的响应报文

 

AFF_ACK_AUTH

Portal服务器收到认证成功响应报文后向接入设备发送的确认报文

 

NTF_LOGOUT

接入设备发送给Portal服务器,用户被强制下线的通知报文

 

NTF_HEARTBEAT

Portal服务器像接入设备发送的Portal心跳报文

REQ_INFO

信息询问报文

 

ACK_INFO

信息询问的响应报文

 

NTF_USERDISCOVER

Portal服务器向接入设备发送的发现新用户要求上线的通知报文

 

NTF_USERIPCHANGE

接入设备向Portal服务器发送的通知更改某个用户IP地址的通知报文

 

AFF_NTF_USERIPCHANGE

Portal服务器通知接入设备对用户表项的IP切换已成功报文

 

ACK_NTF_LOGOUT

Portal服务器对强制下线通知的响应报文

 

NTF_USERSYNC

接入设备收到的从Portal服务器发送的用户同步报文

 

ACK_NTF_USERSYNC

接入设备向Portal服务器回应的用户同步响应报文

 

NTF_CHALLENGE

接入设备向Portal服务器发送的challenge请求报文

 

NTF_USER_NOTIFY

接入设备向Portal服务器发送的用户消息通知报文

 

AFF_NTF_USER_NOTIFY

Portal服务器向接入设备发送的对NTF_USER_NOTIFY的确认报文

 

NTF_AUTH

Portal服务器向接入设备发送的强制认证通知报文

 

ACK_NTF_AUTH

接入设备向Portal服务器发送的对NTF_AUTH的确认报文

 

REQ_QUERY_STATE

Portal服务器向接入设备发送的用户在线状态查询报文

 

ACK_QUERY_STATE

接入设备向Portal服务器发送的用户在线状态回应报文

 

REQ_MACBINDING_INFO

接入设备向MAC绑定服务器发送的MAC绑定查询请求报文

 

ACK_MACBINDING_INFO

MAC绑定服务器向接入设备发送的MAC绑定查询应答报文

 

NTF_USER_LOGON

接入设备向MAC绑定服务器发送的用户上线通知报文

 

RESERVED33

保留用途

 

NTF_USER_LOGOUT

接入设备发送给MAC绑定服务器的用户下线通知报文

 

RESERVED35

保留用途

 

PT_TYPE_REQ_USER_OFFLINE

MAC绑定服务器发送给接入设备的强制用户下线请求报文

 

 

1.1.9  display portal tcp-cheat statistics

【命令】

display portal tcp-cheat statistics [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal tcp-cheat statistics命令用来显示TCP仿冒统计信息。

【举例】

# 显示所有TCP仿冒统计信息。

<Sysname> display portal tcp-cheat statistics

 TCP Cheat Statistic:

 Total Opens: 0

 Resets Connections: 0

 Current Opens: 0

 Packets Received: 0

 Packets Sent: 0

 Packets Retransmitted: 0

 Packets Dropped: 0

 HTTP Packets Sent: 0

 Connection State:

          SYN_RECVD: 0

          ESTABLISHED: 0

          CLOSE_WAIT: 0

          LAST_ACK: 0

          FIN_WAIT_1: 0

          FIN_WAIT_2: 0

          CLOSING: 0

表1-8 display portal tcp-cheat statistics命令显示信息描述表

字段

描述

TCP Cheat Statistic

TCP仿冒统计信息

Total Opens

打开的连接总数

Resets Connections

通过RST报文重置的连接数

Current Opens

当前正在打开的连接数

Packets Received

收到的报文数

Packets Sent

发送的报文数

Packets Retransmitted

重传的报文数

Packets Dropped

丢弃的报文数

HTTP Packets Sent

发送的HTTP报文数

Connection State

连接状态

ESTABLISHED

处于established状态的连接数

CLOSE_WAIT

处于close wait状态的连接数

LAST_ACK

处于last ack状态的连接数

FIN_WAIT_1

处于fin wait 1状态的连接数

FIN_WAIT_2

处于fin wait 2状态的连接数

CLOSING

处于closing状态的连接数

 

1.1.10  display portal user

【命令】

display portal user { all | interface interface-type interface-number } [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

all:显示所有Portal用户的信息。

interface interface-type interface-number:显示指定接口上的Portal用户信息。interface-type interface-number为接口类型和接口编号。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display portal user命令用来显示Portal用户的信息。

【举例】

# 显示所有Portal用户的信息。

<Sysname> display portal user all

 Index:2

 State:ONLINE

 SubState:NONE

 ACL:NONE

 Work-mode:Stand-alone

 VPN instance:NONE

 MAC                IP                 Vlan   Interface

 ---------------------------------------------------------------------

 000d-88f8-0eab   2.2.2.2           0      Ethernet1/1

Total 1 user(s) matched, 1 listed.

表1-9 display portal user命令显示信息描述表

字段

描述

Index

Portal用户的索引

State

Portal用户的当前状态

SubState

Portal用户的当前子状态

ACL

Portal用户的授权ACL

Work-mode

Portal用户的工作模式,有如下三种:

·     协同工作主用户:Primary

·     协同工作备用户:Secondary

·     单独工作用户:Stand-alone

MSR不支持该参数,显示信息为Stand-alone

VPN instance

Portal用户所属的MPLS L3VPN

MAC

Portal用户的MAC地址

IP

Portal用户的IP地址

Vlan

Portal用户所在的VLAN

Interface

Portal用户所在的接口

Total 1 user(s) matched, 1 listed

总计有一个Portal用户

 

1.1.11  portal auth-network

【命令】

portal auth-network network-address { mask-length | mask }

undo portal auth-network { network-address | all }

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

network-address:源认证网段地址。

mask-length:子网掩码长度,取值范围为0~32。

mask:子网掩码,点分十进制格式。

all:所有源认证网段。

【描述】

portal auth-network命令用来配置源认证网段,即接口上只允许在源认证网段范围内的用户报文才能触发Portal认证。如果未认证用户的HTTP报文既不满足免认证规则又不在源认证网段内,则将被接入设备丢弃。undo portal auth-network命令用来取消源认证网段的配置。

缺省情况下,源认证网段为0.0.0.0/0,表示对来自任意网段的用户都进行Portal认证。

需要注意的是:

·     源认证网段配置仅对可跨三层Portal认证(layer3)有效。直接认证方式(direct)下的源认证网段为任意源IP,二次地址分配方式(redhcp)下的源认证网段为由接口私网IP决定的私网网段。

·     可通过多次执行本命令,配置多个源认证网段。

·     若接口下同时配置了源认证网段和目的认证网段,则源认证网段的配置无效。

【举例】

# 在接口Ethernet1/1上配置一条源认证网段为10.10.10.0/24,允许来自10.10.10.0/24网段的用户触发Portal认证。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] portal auth-network 10.10.10.0 24

1.1.12  portal auth-network destination

【命令】

portal auth-network destination network-address { mask-length | mask }

undo portal auth-network destination { network-address | all }

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

network-address:目的认证网段地址。

mask-length:子网掩码长度,取值范围为0~32。

mask:子网掩码,点分十进制格式。

all:所有目的认证网段。

【描述】

portal auth-network destination命令用来配置目的认证网段,即接口上仅要求访问指定目的认证网段(除免认证规则中指定的目的IP地址或网段)的用户进行Portal认证,其它用户访问外部网络时无需认证。undo portal auth-network destination命令用来取消目的认证网段的配置。

缺省情况下,目的认证网段为0.0.0.0/0,表示对访问任意目的网段的用户都进行Portal认证。

需要注意的是:

·     目的认证网段的配置对三层Portal认证的三种认证方式都有效,且仅三层Portal认证支持。

·     可通过多次执行本命令,配置多个目的认证网段,最多允许配置的源认证网段和目的认证网段总数为16个。

·     若接口下同时配置了源认证网段和目的认证网段,则源认证网段的配置无效。

【举例】

# 在接口Ethernet1/2上配置目的认证网段为2.2.2.0/24,仅要求访问2.2.2.0/24网段的用户进行Portal认证,其它用户访问外部网络时无需认证。

<Sysname> system-view

[Sysname] interface ethernet 1/2

[Sysname-Ethernet1/2] portal auth-network destination 2.2.2.0 24

1.1.13  portal delete-user

【命令】

portal delete-user { ip-address | all | interface interface-type interface-number }

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

ip-address:指定Portal用户的IP地址。

all:所有Portal用户。

interface interface-type interface-number:该接口下的所有Portal用户。interface-type interface-number为接口类型和接口编号。

【描述】

portal delete-user命令用来强制接入设备上的Portal用户下线。

相关配置可参考命令display portal user

【举例】

# 强制IP地址为1.1.1.1的Portal用户下线。

<Sysname> system-view

[Sysname] portal delete-user 1.1.1.1

1.1.14  portal domain

【命令】

portal domain domain-name

undo portal domain

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

domain-name:ISP认证域名,为1~63个字符的字符串,不区分大小写,且必须是已经存在的域名。

【描述】

portal domain命令用来指定Portal用户使用的认证域,使得所有从该接口上接入的Portal用户强制使用该认证域。undo portal domain命令用来删除指定的Portal用户使用的认证域。

缺省情况下,未指定Portal用户使用的认证域。

相关配置可参考命令display portal interface

【举例】

# 指定从接口Ethernet1/1上接入的Portal用户使用认证域my-domain。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] portal domain my-domain

1.1.15  portal free-rule

【命令】

portal free-rule rule-number { destination { any | ip { ip-address mask { mask-length | mask } | any } } | source { any | [ interface interface-type interface-number | ip { ip-address mask { mask-length | netmask } | any } | mac mac-address | vlan vlan-id ] * } } *

undo portal free-rule { rule-number | all }

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

rule-number:免认证规则编号。取值范围为0~255。

any:表示不对前面的参数做限制。

ip ip-address:免认证规则的IP地址。

mask { mask-length | mask }:免认证规则的IP地址掩码。其中,mask-length为子网掩码长度,取值范围为0~32;mask为子网掩码,点分十进制格式。

interface interface-type interface-number:免认证规则的源接口。interface-type interface-number为接口类型和接口编号。

mac mac-address:免认证规则的源MAC地址,为H-H-H的形式。

vlan vlan-id:免认证规则的源VLAN编号。

all:所有免认证规则。

【描述】

portal free-rule命令用来配置Portal的免认证规则,指定源过滤条件或目的过滤条件。undo portal free-rule命令用来删除免认证规则。

需要注意的是:

·     如果同时指定源IP地址与源MAC地址,则必须保证IP地址为32位掩码的主机地址,否则指定的MAC地址无效。

·     如果免认证规则中同时配置了vlaninterface则要求interface属于该VLAN,否则该规则无效。

·     相同内容的免认证规则不能重复配置,否则提示免认证规则已存在或重复。

·     无论接口上是否使能Portal认证,只能添加或者删除免认证规则,不能修改。

·     加入聚合组的二层接口不能被指定为免认证规则的源接口,反之亦然。

·     对于二层Portal认证,只能配置从任意源地址(即source any)到任意或指定目的地址的免认证规则。配置了这种类型的免认证规则后,用户不需要通过Portal认证即可访问指定目的网段或地址的网络资源,且用户访问这些资源的HTTP请求不会被重定向到Portal认证页面上。

相关配置可参考命令display portal free-rule

【举例】

# 配置Portal免认证规则,符合源地址为10.10.10.1/24、接口为Ethernet1/1和目的IP地址任意的报文不会触发Portal认证。

<Sysname> system-view

[Sysname] portal free-rule 15 source ip 10.10.10.1 mask 24 interface ethernet 1/1 destination ip any

1.1.16  portal local-server

【命令】

portal local-server http

undo portal local-server http

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

http:指定本地Portal服务器使用HTTP协议和客户端交互认证信息。

【描述】

portal local-server命令用来配置本地Portal服务器支持的协议类型,并同时加载缺省认证页面文件。undo portal local-server命令用来取消本地Portal服务器支持的协议类型。

缺省情况下,本地Portal服务器不支持任何协议类型。

需要注意的是:

·     执行本命令时,本地Portal服务器将同时加载已保存在根目录的缺省认证页面文件,因此,为保证自定义的缺省认证页面生效,请首先完成对它的编辑及保存工作,否则使用系统默认的缺省认证页面。

·     若指定HTTP协议,则HTTP报文的重定向地址格式为:http://设备IP/portal/logon.htm,客户端通过HTTP协议与Portal服务器交互认证信息。

·     若设备上有本地Portal用户在线,则不能取消支持的协议类型。

相关配置可参考命令display portal local-server。

【举例】

# 配置本地Portal服务器支持HTTP协议方式。

<Sysname> system-view

[Sysname] portal local-server http

1.1.17  portal local-server bind

【命令】

portal local-server bind ssid ssidname&<1-10> file filename

undo portal local-server bind { ssid ssidname&<1-10> | all }

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

ssid ssidname&<1-10>:指定要绑定的SSID。其中,ssidname是SSID服务模板的标识,为1~32个字符的字符串,不区分大小写,可以包括字母、数字和空格,但字符串开始和结束位置不可以用空格,且不能是“f”“fi”“fil”和“file”。&<1-10>表示ssidname参数最多可以输入10次。

file filename:指定要绑定的文件。其中,filename表示用户定制的认证页面文件名(不包括文件的保存路径),为1~91个字符的字符串,包括字母、数字和下划线。该文件由用户编辑,保存在设备根目录下的portal目录中。

all:表示所有绑定的SSID。

【描述】

portal local-server bind命令用来配置SSID与定制页面文件的绑定,实现用户认证页面的定制功能。本地Portal服务器会根据绑定的文件向指定的SSID客户端推出相应的认证页面。undo portal local-server bind命令用来取消指定SSID或者所有SSID与认证页面的绑定。

缺省情况下,无任何绑定配置。

用户访问Portal页面时,如果设备上没有配置SSID绑定功能,则向客户端推出缺省的认证页面,否则根据用户登录接口的SSID及其绑定的配置推出对应的认证页面。

需要注意的是:

·     绑定文件的名称或内容有更新时,需要重新绑定文件。

·     要修改绑定关系,只需重新执行绑定命令即可,不必先取消已经存在的绑定关系。

·     对于相同的SSID,若多次执行绑定,则最后一条绑定条目生效。

·     设备上最多允许同时存在128条绑定条目。

相关配置可参考命令display portal local-server

MSR系列路由器各款型对于本节所描述的命令及参数的支持情况有所不同,详细差异信息如下:

型号

命令

描述

MSR800

portal local-server bind

支持

MSR 900

支持

MSR900-E

支持

MSR 930

支持

MSR 20-1X

支持

MSR 20

支持

MSR 30

不支持

MSR 50

不支持

MSR 2600

支持

MSR3600-51F

不支持

 

【举例】

# 配置SSID1、SSID2与定制的认证页面文件file12.zip进行绑定。

<Sysname> system-view

[Sysname] portal local-server bind ssid ssid1 ssid2 file file12.zip

1.1.18  portal local-server enable

【命令】

portal local-server enable

undo portal

【视图】

二层以太网接口视图

【缺省级别】

2:系统级

【参数】

【描述】

portal local-server enable命令用来在端口上使能二层Portal认证。undo portal命令用来恢复缺省配置。

缺省情况下,未使能二层Portal认证。

需要注意的是:

·     为使二层端口上的Portal认证功能正常运行,请保证未在任何三层接口上使能Portal认证,并且不建议端口上同时使能端口安全、802.1X的Guest VLAN或802.1X的EAD快速部署功能。关于端口安全、802.1X的相关介绍,请参考“安全配置指导”中的“端口安全”和“802.1X”。

·     使能该功能前,必须先指定本地Portal服务器的监听IP地址。

相关配置请参考命令portal local-server ip

MSR系列路由器各款型对于本节所描述的命令及参数的支持情况有所不同,详细差异信息如下:

型号

命令

描述

MSR800

portal local-server enable

不支持

MSR 900

不支持

MSR900-E

不支持

MSR 930

不支持

MSR 20-1X

不支持

MSR 20

不支持

MSR 30

MIM二层以太网交换模块支持

MSR 30-11E、MSR 30-11F支持

MSR 50

不支持

MSR 2600

不支持

MSR3600-51F

支持

 

【举例】

# 在端口Ethernet1/1上使能二层Portal认证。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] portal local-server enable

1.1.19  portal local-server ip

【命令】

portal local-server ip ip-address

undo portal local-server ip

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

ip-address:本地Portal服务器的监听IP地址。该地址为接入设备上一个与Portal客户端路由可达的三层接口IP地址(通常为Loopback接口IP)。

【描述】

portal local-server ip命令用来指定二层Portal认证的本地Portal服务器监听IP地址。对于Portal用户输入任意URL地址进行的Web访问请求,设备都将其重定向到该监听地址的认证页面上。undo portal local-server ip命令用来恢复缺省配置。

缺省情况下,没有指定本地Portal服务器的监听IP地址。

需要注意的是,配置的监听IP地址推荐使用LoopBack接口地址,利用LoopBack接口状态稳定的优点,避免因为接口故障导致用户无法打开认证页面的问题。另外,由于发送到LoopBack接口的报文不会被转发到网络中,当请求上线的用户数目较大时,可减轻对系统性能的影响。

MSR系列路由器各款型对于本节所描述的命令及参数的支持情况有所不同,详细差异信息如下:

型号

命令

描述

MSR800

portal local-server ip

不支持

MSR 900

不支持

MSR900-E

不支持

MSR 930

不支持

MSR 20-1X

不支持

MSR 20

不支持

MSR 30

MIM二层以太网交换模块支持

MSR 30-11E、MSR 30-11F支持

MSR 50

不支持

MSR 2600

不支持

MSR3600-51F

支持

 

【举例】

# 配置二层Portal认证的本地Portal服务器监听IP地址为1.1.1.1。

<Sysname> system-view

[Sysname] interface loopback 1

[Sysname-LoopBack1] ip address 1.1.1.1 32

[Sysname-LoopBack1] quit

[Sysname] portal local-server ip 1.1.1.1

1.1.20  portal max-user

【命令】

portal max-user max-number

undo portal max-user

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

max-number:允许同时在线的最大Portal用户数。

【描述】

portal max-user命令用来配置Portal最大用户数。undo portal max-user命令用来恢复缺省情况。

需要注意的是,如果配置的Portal最大用户数小于当前已经在线的Portal用户数,则该命令可以执行成功,且在线Portal用户不受影响,但系统将不允许新的Portal用户接入。

MSR系列路由器各款型对于本节所描述的命令及参数的支持情况有所不同,详细差异信息如下:

型号

命令

参数

描述

MSR800

portal max-user

max-number

取值范围为1~512,缺省值为512

MSR 900

取值范围为1~512,缺省值为512

MSR900-E

取值范围为1~512,缺省值为512

MSR 930

取值范围为1~512,缺省值为512

MSR 20-1X

取值范围为1~512,缺省值为512

MSR 20

取值范围为1~512,缺省值为512

MSR 30

取值范围为1~512,缺省值为512

MSR 50

MPUF:取值范围为1~512,缺省值为512

MPU-G2:取值范围为1~4096,缺省值为4096

MSR 2600

取值范围为1~512,缺省值为512

MSR3600-51F

取值范围为1~512,缺省值为512

 

【举例】

# 配置Portal最大用户数为100。

<Sysname> system-view

[Sysname] portal max-user 100

1.1.21  portal move-mode auto

【命令】

portal move-mode auto

undo portal move-mode

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

【描述】

portal move-mode auto命令用来开启Portal用户认证端口的自动迁移功能。已认证用户离开原认证端口到达新的认证端口后,如果端口的VLAN相同,则用户不需要重新认证,就可以继续访问网络;若端口的VLAN不同,则该用户将在原端口上下线,在新的端口上重新认证后上线。undo portal move-mode用来恢复缺省情况。

缺省情况下,Portal用户认证端口的自动迁移功能处于关闭状态。认证成功的用户从同一设备上的当前认证端口离开并迁移到其它认证端口上接入时,由于原端口上仍然保留该用户的认证信息,从而无法在新端口上认证上线。

需要注意的是,在开启了本功能的情况下,若用户认证端口迁移后原端口状态变为down,则用户也会下线,所以本功能仅能在用户和设备之间存在Hub、二层交换机或AP的组网环境下生效。

MSR系列路由器各款型对于本节所描述的命令及参数的支持情况有所不同,详细差异信息如下:

型号

命令

描述

MSR800

portal move-mode auto

不支持

MSR 900

不支持

MSR900-E

不支持

MSR 930

不支持

MSR 20-1X

不支持

MSR 20

不支持

MSR 30

MIM二层以太网交换模块支持

MSR 30-11E、MSR 30-11F支持

MSR 50

不支持

MSR 2600

不支持

MSR3600-51F

支持

 

【举例】

# 开启Portal用户认证端口的自动迁移功能。

<Sysname> system-view

[Sysname] portal move-mode auto

1.1.22  portal nas-id-profile

【命令】

portal nas-id-profile profile-name

undo portal nas-id-profile

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

profile-name:标识指定VLAN和NAS-ID绑定关系的Profile名称,116个字符的字符串,不区分大小写。该Profile由命令aaa nas-id profile配置,具体情况请参考“安全命令参考”中的“AAA”。

【描述】

portal nas-id-profile命令用来指定接口的NAS-ID Profile。undo portal nas-id-profile命令用来删除指定的NAS-ID Profile。

缺省情况下,未指定NAS-ID Profile。

需要注意的是,如果接口上指定了NAS-ID Profile,则此Profile中定义的绑定关系优先使用。

【举例】

# 在接口Vlan-interface 2上指定名为aaa的NAS-ID Profile 。

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] portal nas-id-profile aaa

1.1.23  portal nas-ip

【命令】

portal nas-ip ip-address

undo portal nas-ip

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

ip-address:接口发送Portal报文的源IP地址,应该为本机的地址,不能为全0地址、全1地址、D类地址、E类地址和环回地址。

【描述】

portal nas-ip命令用来配置接口发送Portal报文使用的源地址。undo portal nas-ip命令用来删除指定的源地址。

缺省情况下,未指定接口发送Portal报文使用的源地址,即以接入用户的接口地址作为发送Portal报文的源地址。

【举例】

# 配置接口Ethernet1/1发送Portal报文使用的源地址为2.2.2.2。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] portal nas-ip 2.2.2.2

1.1.24  portal nas-port-id

【命令】

portal nas-port-id nas-port-id-value

undo portal nas-port-id

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

nas-port-id-value:NAS-Port-ID的名称,为1~253字符的字符串,区分大小写。该值为接口上有Portal用户上线时设备向RADIUS服务器发送的RADIUS请求报文的NAS-Port-ID属性值。

【描述】

portal nas-port-id命令用来配置接口的NAS-Port-ID。指定该接口下接入的Portal用户需要携带的NAS-Port-ID。undo portal nas-port-id命令用来恢复缺省情况。

缺省情况下,未指定接口的NAS-Port-ID,RADIUS请求报文中的NAS-Port-ID属性值为接入设备获取到的用户接入的端口信息。

【举例】

# 配置接口Ethernet1/1的NAS-Port-ID为ap1。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] portal nas-port-id ap1

1.1.25  portal nas-port-type

【命令】

portal nas-port-type { ethernet | wireless }

undo portal nas-port-type

【视图】

接口视图

【缺省级别】

系统级

【参数】

ethernet:指定用户接入的端口类型为Ethernet,对应的编码值为15。

wireless:指定用户接入的端口类型为符合IEEE 802.11标准的无线接口,对应的编码值为19。该参数通常在接入无线Portal用户的接口上指定,可保证接入设备向RADIUS服务器传递的用户端口类型为无线类型。

【描述】

portal nas-port-type命令用来配置接口的NAS-Port-Type,即向RADIUS服务器发送的RADIUS请求报文的NAS-Port-Type属性值。undo portal nas-port-type命令用来恢复缺省情况。

缺省情况下,未指定接口的NAS-Port-Type,RADIUS请求报文中的NAS-Port-Type属性值为接入设备获取到的用户接入的端口类型值。

【举例】

# 配置接口Ethernet1/1的NAS-Port-Type为符合IEEE 802.11标准的无线接口类型。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] portal nas-port-type wireless

1.1.26  portal offline-detect interval

【命令】

portal offline-detect interval offline-detect-interval

undo portal offline-detect interval

【视图】

二层以太网接口视图

【缺省级别】

2:系统级

【参数】

offline-detect-value:用户在线检测时间间隔,取值范围为60~65535。

【描述】

portal offline-detect interval命令用来配置二层Portal用户的在线检测时间间隔。设备会以此为间隔定期检测此端口上所有在线用户的MAC地址表项是否被流量命中过,若检测到某用户的MAC没有被命中过或者该用户的MAC地址表项已经老化,则认为一次检测失败,若连续两次检测失败,设备将强制该用户下线。undo portal offline-detect interval命令用来恢复缺省情况。

缺省情况下,二层Portal用户在线检测时间间隔为300秒。

需要注意的是,由于设备进行检测时若发现用户MAC地址表项已经老化,则会认为检测失败,因此,为避免这种无效检测,建议配置的检测时间间隔小于等于用户MAC地址表项的老化时间。

【举例】

# 配置设备检测Ethernet 1/1端口上二层Portal用户在线状态的时间间隔为3600秒。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-ethernet1/1] portal offline-detect interval 3600

1.1.27  portal redirect-url

【命令】

portal redirect-url url-string [ wait-time period ]

undo portal redirect-url

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

url-string:Portal用户认证成功后,认证页面的自动跳转目的网站地址,为1~127个字符的字符串,必须是以http://开头的完整的URL路径。

period:Portal用户认证成功后认证页面等待进行跳转的时间间隔,取值范围为1~90,单位为秒,缺省值为5。

【描述】

portal redirect-url命令用来指定Portal用户认证成功后认证页面的自动跳转目的网站地址。undo portal redirect-url命令用来恢复缺省情况。

缺省情况下,用户认证成功后认证页面将会跳转到用户初始访问的网站页面。

需要注意的是:

·     对于三层远程Portal认证,该特性需要与支持自动跳转页面功能的iMC服务器配合使用。

·     wait-time参数只对本地Portal认证有效,对于远程Portal认证无效。

【举例】

# 指定Portal用户认证成功后,认证页面在3秒后自动跳转为http://www.testpt.cn网站页面。

<Sysname> system-view

[Sysname] portal redirect-url http://www.testpt.cn wait-time 3

1.1.28  portal server

【命令】

portal server server-name ip ip-address [ key [ cipher | simple ] key-string | port port-id | url url-string | vpn-instance vpn-instance-name ] *

undo portal server server-name [ key | port | url | vpn-instance ]

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

server-name:Portal服务器名称,为1~32个字符的字符串,区分大小写。

ip-address:Portal服务器的IP地址。若指定的是本地Portal服务器,则此地址为接入设备上与Portal客户端路由可达的三层接口IP地址。

key:与Portal服务器通信需要的共享密钥。设备与Portal服务器交互的Portal报文中会携带一个在该共享密钥参与下生成的验证字,该验证字用于接受方校验收到的Portal报文的正确性。

cipher:表示以密文方式设置共享密钥。

simple:表示以明文方式设置共享密钥。

key-string:设置的明文密钥或密文密钥,区分大小写。明文密钥为1~16个字符的字符串;密文密钥为1~53个字符的字符串。不指定ciphersimple时,表示以明文方式设置共享密钥。

port-id:设备向Portal服务器主动发送报文时使用的目的端口号,取值范围为1~65534,缺省值为50100。

url-string:HTTP报文重定向地址。缺省的HTTP报文重定向地址格式为http://ip-address,其中ip-address为Portal服务器的IP地址。重定向地址支持域名解析,但需要使用命令portal free-rule将DNS服务器地址加入Portal的免认证地址范围内。

vpn-instance-name:Portal服务器所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称,为1~31个字符的字符串,区分大小写。如果未指定本参数,则表示Portal服务器位于公网中。

【描述】

portal server命令用来指定三层Portal认证的Portal服务器。undo portal server命令用来删除指定的Portal服务器,或者恢复服务器参数为缺省值。

缺省情况下,没有指定三层Portal认证的Portal服务器。

需要注意的是:

·     若指定名字的Portal服务器存在,但该接口上没有用户,则undo portal server命令不指定任何参数时,将删除指定Portal服务器;否则相同条件下,指定参数porturl时,将恢复指定参数为缺省值。

·     已配置的Portal服务器及其参数仅在该Portal服务器未被任何接口引用时才可以被删除或修改。要删除或修改已经被接口引用的Portal服务器配置,必须首先在引用该Portal服务器的接口上使用命令undo portal取消配置。

·     通常,使用本地Portal服务器时,Portal服务器参数keyporturl均不需配置,若配置也无效。

·     以明文或密文方式设置的共享密钥,均以密文的方式保存在配置文件中。

相关配置可参考命令display portal server

【举例】

# 配置Portal服务器pts的IP地址为192.168.0.111、密钥为明文portal、HTTP重定向的URL为http://192.168.0.111/portal。

<Sysname> system-view

[Sysname] portal server pts ip 192.168.0.111 key simple portal url http://192.168.0.111/portal

1.1.29  portal server banner

【命令】

portal server banner banner-string

undo portal server banner

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

banner-string:用户定制的Web页面欢迎信息,为1~50个字符的字符串,区分大小写,不允许为‘<’、‘&’。字符串中可包括连续多个连续空格,浏览器将会识别为一个空格。

【描述】

portal server banner命令用来配置本地Portal服务器提供的缺省Web页面欢迎信息。undo portal server banner命令用来恢复缺省配置。

缺省情况下,无Web页面欢迎信息。

需要注意的是,配置的Web页面欢迎信息仅对缺省的认证页面有效,对于用户定制的认证页面无效。

【举例】

# 配置本地Portal服务器提供的Web页面欢迎信息为:Welcome to Portal Authentication。

<Sysname> system-view

[Sysname] portal server banner Welcome to Portal Authentication

1.1.30  portal server method

【命令】

portal server server-name method { direct | layer3 | redhcp }

undo portal

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

server-name:Portal服务器名称,为1~32个字符的字符串,区分大小写。

method:认证方式。

·     direct:直接认证方式。

·     layer3:三层认证方式。

·     redhcp:二次地址分配认证方式。

【描述】

portal server method命令用来在接口上使能三层Portal认证,同时指定引用的Portal服务器和认证方式。undo portal命令用来在接口上取消所有的或指定的三层Portal认证。

缺省情况下,接口上没有使能三层Portal认证。

需要注意的是:

·     使能三层Portal认证的接口上所引用的Portal服务器必须已经存在。

·     使用本地Portal服务器的情况下,二次地址分配认证方式可配置但不生效。

相关配置可参考命令display portal server

【举例】

# 在接口Ethernet1/1上使能三层Portal认证。指定Portal服务器pts,并配置为直接认证方式。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] portal server pts method direct

1.1.31  portal server server-detect

【命令】

portal server server-name server-detect method { http | portal-heartbeat } * action { log | permit-all | trap } * [ interval interval ] [ retry retries ]

undo portal server server-name server-detect

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

server-name:Portal服务器名称,为1~32个字符的字符串,区分大小写。该Portal服务器必须已经存在。

server-detect method { http | portal-heartbeat }:Portal服务器探测方式。包括以下两种,且可同时选择。

·     http:表示探测HTTP连接。接入设备定期向Portal服务器的HTTP服务端口发起TCP连接,若连接成功建立则表示此服务器的HTTP服务已开启,就认为一次探测成功且服务器可达。若连接失败则认为一次探测失败。当Portal服务器不支持逃生心跳功能的时候只能使用此探测方式。

·     portal-heartbeat:表示探测Portal心跳报文。设备检测Portal服务器定期发送的Portal心跳报文来判断服务器的可达状态:若设备在指定的周期内收到Portal心跳报文,且验证其正确,则认为此次探测成功且服务器可达,否则认为此次探测失败。该方式仅对支持Portal心跳检测机制(目前仅iMC的Portal服务器支持)的Portal服务器有效。为了配合此类型的探测,还需要在Portal服务器上选择支持逃生心跳功能,且服务器上配置的逃生心跳间隔要小于等于设备上配置的探测间隔。

action { log | permit-all | trap }:Portal服务器可达状态的变化时,可触发执行的操作。包括以下三种,且同时可选择多种。

·     log:Portal服务器可达或者不可达的状态改变时,发送日志信息。日志信息中记录了Portal服务器名以及该服务器状态改变前后的状态。

·     permit-all:也称为Portal逃生,表示在Portal服务器不可达时,暂时取消端口进行的Portal认证,允许所有Portal用户访问网络资源。之后,若端口收到服务器的探测报文,或者收到其它认证报文(上线报文、下线报文等),则恢复其Portal认证功能。

·     trap:Portal服务器可达或者不可达的状态改变时,向网管服务器发送Trap信息。Trap信息中记录了Portal服务器名以及该服务器的当前状态。

interval interval:进行探测尝试的时间间隔,取值范围为20~600,单位为秒,缺省值为20。

retry retries:连续探测失败的最大次数,取值范围为1~5,缺省值为3。若连续探测失败数目达到此值,则认为服务器不可达。

【描述】

portal server server-detect命令用来配置对Portal服务器的探测功能,包括配置探测方法、可触发执行的操作、探测时间间隔以及最大探测失败次数。配置此功能后,设备会周期性地检测指定的Portal服务器状态是否可达,并在可达状态发生变化后执行指定的操作。undo portal server server-detect命令用来取消对指定的Portal服务器的探测功能配置。

缺省情况下,未配置对Portal服务器的探测功能。

需要注意的是:

·     可同时配置多种探测方式和可触发执行的操作。

·     如果同时指定了两种探测方式,则只要使用任何一种探测方式进行探测的失败次数达到最大值就认为服务器不可达。在服务器不可达状态下,只有使用两种探测方式的探测都成功才能认为服务器恢复为可达状态。

·     如果同时指定了多种操作,则Portal服务器可达状态改变时系统可并发执行多种操作。

·     在设备上删除Portal服务器时将会同时删除该服务器的探测功能配置。

·     对同一服务器多次执行探测功能的配置时,新的配置将覆盖原有的配置,可选参数未配置时,使用缺省值。

·     对指定Portal服务器配置的探测功能,只有当该服务器在接口上使能之后才能生效。

·     对于Portal服务器发来的其它认证报文(上线报文,下线报文等)也认为等效于心跳报文。

相关配置可参考命令display portal server

【举例】

# 配置对Portal服务器pts的探测功能:探测方式为同时探测HTTP连接和Portal心跳报文,每次探测间隔时间为600秒,若连续二次探测均失败,则发送服务器不可达的Trap信息和日志信息,并打开网络限制,允许未认证用户访问网络。

<Sysname> system-view

[Sysname] portal server pts server-detect method http portal-heartbeat action log permit-all trap interval 600 retry 2

1.1.32  portal server user-sync

【命令】

portal server server-name user-sync [ interval interval ] [ retry retries ]

undo portal server server-name user-sync

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

server-name:Portal服务器名称,为1~32个字符的字符串,区分大小写。该Portal服务器必须已经存在。

user-sync:开启Portal用户同步功能。

interval interval:检测用户同步报文的时间间隔,取值范围为60~3600,单位为秒,缺省值为300。

retry retries:连续检测失败的最大次数,取值范围为1~5,缺省值为4。如果接入设备上的某用户信息在连续retrie个周期内,都未曾在该服务器发送的用户同步报文中出现过,则认为Portal服务器上已不存在该用户,设备将强制该用户下线。

【描述】

portal server user-sync命令用来配置对指定Portal服务器的Portal用户同步功能。配置此功能后,设备会响应并周期性地检测指定的Portal服务器发来的用户同步报文,以保持设备与该服务器上在线用户信息的一致性。undo portal server user-sync命令用来取消指定的Portal用户同步功能配置。

缺省情况下,未配置Portal用户同步功能。

需要注意的是:

·     只有在支持Portal用户心跳功能(目前仅iMC的Portal服务器支持)的Portal服务器的配合下,本功能才有效。为了实现该功能,还需要在Portal服务器上选择支持用户心跳功能,且服务器上配置的用户心跳间隔要小于等于设备上配置的检测间隔。

·     在设备上删除Portal服务器时将会同时删除该服务器的用户同步功能配置。

·     对同一服务器多次执行用户同步功能的配置时,新的配置将覆盖原有的配置,可选参数未配置时,使用缺省值。

·     对于设备上多余的用户信息,即在N个周期后被判定为Portal服务器上已不存在的用户信息,设备会在第N+1个周期内的某时刻将其删除掉。

【举例】

# 配置对Portal服务器pts的Portal用户同步功能,检测用户同步报文的时间间隔为600秒,如果设备中的某用户信息在连续两个探测周期内都未在该Portal服务器发送的同步报文中出现,设备将强制该用户下线。

<Sysname> system-view

[Sysname] portal server pts user-sync interval 600 retry 2

1.1.33  portal url-param include

【命令】

portal url-param include user-mac [ des-encrypt ] [ param-name param-name ]

undo portal url-param include user-mac [ des-encrypt ] [ param-name ]

【视图】

系统视图/接口视图

【缺省级别】

2:系统级

【参数】

user-mac:指定Portal重定向URL中包含用户MAC地址或者AP MAC地址。

des-encrypt:Portal重定向URL中的用户MAC地址或者AP MAC地址采用DES方式加密。若不指定该参数,则表示明文。

param-name para-name:指定Portal重定向URL中包含的MAC地址参数名称。其中,para-name表示MAC地址参数名,为1~20个字符的字符串,区分大小写,且只支持字母和数字。指定的参数和参数名在Portal重定向URL中的格式为"para-name=param-value"," param-value"即MAC地址。

【描述】

portal url-param include命令用来指定重定向URL需要携带MAC地址参数,并指定它在重定向URL中的参数名。undo portal url include命令用户取消重定向URL携带MAC地址参数。

缺省情况下,重定向URL不携带MAC地址参数。

需要注意的是,重定向URL的具体显示信息与所用的Portal服务器有关,请以实际情况为准。

下面列举各个参数的具体含义及获取方式:

·     user-mac

用户的MAC地址,格式为XX-XX-XX-XX-XX-XX。

·     des-encrypt

用户的MAC地址采用DES算法加密传输。

【举例】

# 在接口上配置Portal重定向URL中包含用户MAC地址,用户的MAC地址采用DES算法加密传输,所包含MAC地址的参数名为wlanusermac。

<Sysname> system-view

[Sysname] interface Vlan-interface10

[Sysname-Vlan-interface10] portal url-param include user-mac des-encrypt param-name wlanusermac

1.1.34  portal web-proxy port

【命令】

portal web-proxy port port-number

undo portal web-proxy port { port-number | all }

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

port-number:Web代理服务器的TCP端口号,取值范围为1~65535。

all:指定所有Web代理服务器的TCP端口号。

【描述】

portal web-proxy port命令用来添加允许触发Portal认证的Web代理服务器端口。undo portal web-proxy port命令用来删除指定或所有的Web代理服务器端口。

缺省情况下,不存在允许触发Portal认证的Web代理服务器端口。

需要注意的是:

·     通过多次执行本命令,最多可以添加4个Web代理服务器端口。

·     如果用户浏览器采用WPAD方式自动配置Web代理,则不仅需要网络管理员在设备上添加Web代理服务器端口,还需要配置免认证规则,允许目的IP为WPAD主机IP地址的用户报文免认证。

对于二层Portal认证,还需要注意的是:除了需要网络管理员在设备上添加指定的Web代理服务器端口,还需要用户在浏览器上将设备的本地Portal服务器监听IP地址配置为Web代理服务器的例外地址,避免Portal用户发送给本地Portal服务器的HTTP报文被发送到Web代理服务器上,从而影响正常的Portal认证。

MSR系列路由器各款型对于本节所描述的特性支持情况有所不同,详细差异信息如下:

型号

命令

描述

MSR800

portal web-proxy port

不支持

MSR 900

不支持

MSR900-E

不支持

MSR 930

不支持

MSR 20-1X

不支持

MSR 20

不支持

MSR 30

支持

MSR 50

不支持

MSR 2600

不支持

MSR3600-51F

支持

 

【举例】

# 某组网环境中,有些Portal客户端浏览器使用Web代理服务器上网,端口号为8080。为了允许这样的Portal用户认证上网,网络管理员需要在Portal接入设备上添加允许触发Portal认证的Web代理服务器端口号8080。

<Sysname> system-view

[Sysname] portal web-proxy port 8080

1.1.35  reset portal connection statistics

【命令】

reset portal connection statistics { all | interface interface-type interface-number }

【视图】

用户视图

【缺省级别】

1:监控级

【参数】

all:清除所有接口上Portal的连接统计信息。

interface interface-type interface-number:清除指定接口上Portal的连接统计信息。interface-type interface-number为接口类型和接口编号。

【描述】

reset portal connection statistics命令用来清除接口上Portal的连接统计信息。

【举例】

# 清除Ethernet1/1接口上Portal的连接统计信息。

<Sysname> reset portal connection statistics interface ethernet 1/1

1.1.36  reset portal server statistics

【命令】

reset portal server statistics { all | interface interface-type interface-number }

【视图】

用户视图

【缺省级别】

1:监控级

【参数】

all:清除所有接口上Portal服务器的统计信息。

interface interface-type interface-number:清除指定接口上Portal服务器的统计信息。interface-type interface-number为接口类型和接口编号。

【描述】

reset portal server statistics命令用来清除接口上Portal服务器的统计信息。

【举例】

# 清除接口Ethernet1/1上的Portal服务器的统计信息。

<Sysname> reset portal server statistics interface ethernet 1/1

1.1.37  reset portal tcp-cheat statistics

【命令】

reset portal tcp-cheat statistics

【视图】

用户视图

【缺省级别】

1:监控级

【参数】

【描述】

reset portal tcp-cheat statistics命令用来清除TCP仿冒统计信息。

【举例】

# 清除TCP仿冒统计信息。

<Sysname> reset portal tcp-cheat statistics

1.1.38  web-redirect

【命令】

web-redirect url url-string [ interval interval ]

undo web-redirect

【视图】

接口视图

【缺省级别】

2:系统级

【参数】

url-string:强推页面的地址,即用户的Web访问请求被重定向的URL地址。

interval:强推页面的周期,取值范围为60~86400,单位为秒,缺省为86400。

【描述】

web-redirect命令用来配置接口的强推页面功能,包括设置强推页面的地址和强推页面的时间间隔。undo web-redirect命令用来恢复缺省情况。

缺省情况下,接口上未配置强推页面功能。

需要注意的是:

·     目前,强推页面功能和Portal功能无法在接口上共存,建议二者不要同时配置使用。

·     多次执行本命令,最后一次的配置生效。

【举例】

# 在接口Ethernet1/1上配置强推页面功能:强推页面地址为http://192.0.0.1,强推页面周期为3600秒。

<Sysname> system-view

[Sysname] interface ethernet 1/1

[Sysname-Ethernet1/1] web-redirect url http://192.0.0.1 interval 3600

 

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!