Use access-limit enable to set the maximum number of online users in an ISP domain. After the number of online users reaches the allowed maximum number, no more users are accepted.

Use undo access-limit enable to restore the default.

Syntax

access-limit enable max-user-number

undo access-limit enable

Default

There is no limit to the number of online users in an ISP domain.

Views

ISP domain view

Default command level

2: System level

Parameters

max-user-number: Maximum number of online users that the ISP domain can accommodate. The value range for this argument is 1 to 2147483646.

Usage guidelines

System resources are limited, and user connections may compete for network resources when there are many users. Setting a proper limit to the number of online users helps provide reliable system performance.

Examples

# Set a limit of 500 user connections for ISP domain test.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] access-limit enable 500

Related commands

display domain

accounting command

Use accounting command to specify the command line accounting method.

Use undo accounting command to restore the default.

Syntax

accounting command hwtacacs-scheme hwtacacs-scheme-name

undo accounting command

Default

The default accounting method for the ISP domain is used for command line accounting.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified HWTACACS scheme must have been configured.

Command line accounting can use only an HWTACACS scheme.

Examples

# In the ISP domain test, perform command line accounting based on the HWTACACS scheme hwtac.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting command hwtacacs-scheme hwtac

Related commands

· accounting default

· hwtacacs scheme

accounting default

Use accounting default to configure the default accounting method for an ISP domain.

Use undo accounting default to restore the default.

Syntax

accounting default { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo accounting default

Default

The default accounting method of an ISP domain is local.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local accounting.

none: Does not perform accounting.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

The default accounting method is used for all users who support the specified accounting method and have no specific accounting method configured.

Local accounting is only used for monitoring and controlling the number of local user connections. It does not provide the statistics function that the accounting feature generally provides.

Examples

# Configure the default accounting method for ISP domain test to use RADIUS accounting scheme rd and use local accounting as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting default radius-scheme rd local

Related commands

· hwtacacs scheme

· local-user

· radius scheme

accounting lan-access

Use accounting lan-access to configure the accounting method for LAN users.

Use undo accounting lan-access to restore the default.

Syntax

accounting lan-access { local | none | radius-scheme radius-scheme-name [ local | none ] }

undo accounting lan-access

Default

The default accounting method for the ISP domain is used for LAN users.

Views

ISP domain view

Default command level

2: System level

Parameters

local: Performs local accounting.

none: Does not perform accounting.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS scheme must have been configured.

Examples

# In the ISP domain test, perform local accounting for LAN users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting lan-access local

# In the ISP domain test, perform RADIUS accounting for LAN users based on the scheme rd and use local accounting as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting lan-access radius-scheme rd local

Related commands

· accounting default

· local-user

· radius scheme

accounting login

Use accounting login to configure the accounting method for login users through the console port or through Telnet.

Use undo accounting login to restore the default.

Syntax

accounting login { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo accounting login

Default

The default accounting method for the ISP domain is used for login users.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local accounting.

none: Does not perform accounting.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

Accounting is not supported for login users who use FTP.

Examples

# In the ISP domain test, perform local accounting for login users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting login local

# In the ISP domain test, perform RADIUS accounting for login users based on the scheme rd and use local accounting as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting login radius-scheme rd local

Related commands

· accounting default

· hwtacacs scheme

· local-user

· radius scheme

accounting optional

Use accounting optional to enable the accounting optional feature.

Use undo accounting optional to disable the feature.

Syntax

accounting optional

undo accounting optional

Default

The feature is disabled.

Views

ISP domain view

Default command level

2: System level

Usage guidelines

After you configure the accounting optional command for a domain, a user who would otherwise be disconnected can continue to use the network resources when no accounting server is available or when communication with the current accounting server fails. However, the device no longer sends real-time accounting updates for the user. The accounting optional feature applies to scenarios where accounting is not important.

After you configure the accounting optional command, the setting configured by the access-limit command in local user view has no effect.

Examples

# Enable the accounting optional feature for users in the domain test.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting optional

accounting portal

Use accounting portal to configure the accounting method for portal users.

Use undo accounting portal to restore the default.

Syntax

accounting portal { local | none | radius-scheme radius-scheme-name [ local ] }

undo accounting portal

Default

The default accounting method for the ISP domain is used for portal users.

Views

ISP domain view

Default command level

2: System level

Parameters

local: Performs local accounting.

none: Does not perform accounting.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS scheme must have been configured.

Examples

# In the ISP domain test, perform local accounting for portal users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting portal local

# In the ISP domain test, perform RADIUS accounting for portal users based on the scheme rd and use local accounting as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting portal radius-scheme rd local

Related commands

· accounting default

· local-user

· radius scheme

accounting ppp

Use accounting ppp to configure the accounting method for PPP users.

Use undo accounting ppp to restore the default.

Syntax

accounting ppp { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo accounting ppp

Default

The default accounting method for the ISP domain is used for PPP users.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local accounting.

none: Does not perform accounting.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

Examples

# In the ISP domain test, perform local accounting for PPP users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting ppp local

# In the ISP domain test, perform RADIUS accounting for PPP users based on the scheme rd and use local accounting as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] accounting ppp radius-scheme rd local

Related commands

· accounting default

· hwtacacs scheme

· local-user

· radius scheme

authentication default

Use authentication default to configure the default authentication method for an ISP domain.

Use undo authentication default to restore the default.

Syntax

authentication default { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo authentication default

Default

The default authentication method of an ISP domain is local.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local authentication.

none: Does not perform authentication.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

The default authentication method is used for all users who support the specified authentication method and have no specific authentication method configured.

Examples

# Configure the default authentication method for ISP domain test to use RADIUS authentication scheme rd and use local authentication as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication default radius-scheme rd local

Related commands

· hwtacacs scheme

· local-user

· radius scheme

authentication lan-access

Use authentication lan-access to configure the authentication method for LAN users.

Use undo authentication lan-access to restore the default.

Syntax

authentication lan-access { local | none | radius-scheme radius-scheme-name [ local | none ] }

undo authentication lan-access

Default

The default authentication method for the ISP domain is used for LAN users.

Views

ISP domain view

Default command level

2: System level

Parameters

local: Performs local authentication.

none: Does not perform authentication.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS scheme must have been configured.

Examples

# In the ISP domain test, perform local authentication for LAN users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication lan-access local

# In the ISP domain test, perform RADIUS authentication for LAN users based on the scheme rd and use local authentication as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication lan-access radius-scheme rd local

Related commands

· authentication default

· local-user

· radius scheme

authentication login

Use authentication login to configure the authentication method for login users through the console port, Telnet, or FTP.

Use undo authentication login to restore the default.

Syntax

authentication login { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo authentication login

Default

The default authentication method for the ISP domain is used for login users.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local authentication.

none: Does not perform authentication.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

Examples

# In the ISP domain test, perform local authentication for login users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication login local

# In the ISP domain test, perform RADIUS authentication for login users based on the scheme rd and use local authentication as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication login radius-scheme rd local

Related commands

· authentication default

· hwtacacs scheme

· local-user

· radius scheme

authentication portal

Use authentication portal to configure the authentication method for portal users.

Use undo authentication portal to restore the default.

Syntax

authentication portal { local | none | radius-scheme radius-scheme-name [ local ] }

undo authentication portal

Default

The default authentication method for the ISP domain is used for portal users.

Views

ISP domain view

Default command level

2: System level

Parameters

local: Performs local authentication.

none: Does not perform authentication.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS scheme must have been configured.

Examples

# In the ISP domain test, perform local authentication for portal users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication portal local

# In the ISP domain test, perform RADIUS authentication for portal users based on the scheme rd and use local authentication as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication portal radius-scheme rd local

Related commands

· authentication default

· local-user

· radius scheme

authentication ppp

Use authentication ppp to configure the authentication method for PPP users.

Use undo authentication ppp to restore the default.

Syntax

authentication ppp { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo authentication ppp

Default

The default authentication method for the ISP domain is used for PPP users.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local authentication.

none: Does not perform authentication.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

Examples

# In the ISP domain test, perform local authentication for PPP users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication ppp local

# In the ISP domain test, perform RADIUS authentication for PPP users based on the scheme rd and use local authentication as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authentication ppp radius-scheme rd local

Related commands

· authentication default

· hwtacacs scheme

· local-user

· radius scheme

authentication super

Use authentication super to configure the authentication method for user privilege level switching.

Use undo authentication super to restore the default.

Syntax

authentication super { hwtacacs-scheme hwtacacs-scheme-name | radius-scheme radius-scheme-name }

undo authentication super

Default

The default authentication method for the ISP domain is used for user privilege level switching authentication.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS authentication scheme must have been configured.

Examples

# In the ISP domain test, perform user privilege level switching authentication based on the HWTACACS scheme tac.

<Sysname> system-view

[Sysname] super authentication-mode scheme

[Sysname] domain test

[Sysname-domain-test] authentication super hwtacacs-scheme tac

Related commands

· hwtacacs scheme

· radius scheme

· super authentication-mode (Fundamentals Command Reference)

authorization command

Use authorization command to configure the command line authorization method.

Use undo authorization command to restore the default.

Syntax

authorization command { hwtacacs-scheme hwtacacs-scheme-name [ local | none ] | local | none }

undo authorization command

Default

The default authorization method for the ISP domain is used for command line authorization.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local authorization.

none: Does not perform authorization. In this case, an authenticated user can access only commands of Level 0.

Usage guidelines

The specified HWTACACS scheme must have been configured.

With command line authorization configured, a user who has logged in to the device can execute only the commands with a level lower than or equal to that of the local user.

Examples

# In the ISP domain test, configure the device to perform local command line authorization.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization command local

# In the ISP domain test, perform command line authorization based on the HWTACACS scheme hwtac and use local authorization as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization command hwtacacs-scheme hwtac local

Related commands

· authorization default

· hwtacacs scheme

· local-user

authorization default

Use authorization default to configure the default authorization method for an ISP domain.

Use undo authorization default to restore the default.

Syntax

authorization default { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo authorization default

Default

The default authorization method for the ISP domain of an ISP domain is local.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local authorization.

none: Does not perform authorization. After passing authentication, non-login users can access the network, FTP users can access the root directory of the device, and other login users can access only the commands of Level 0.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

The default authorization method is used for all users who support the specified authorization method and have no specific authorization method configured.

The RADIUS authorization configuration takes effect only when the authentication method and authorization method of the ISP domain use the same RADIUS scheme.

Examples

# Configure the default authorization method for ISP domain test to use RADIUS authorization scheme rd and use local authorization as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization default radius-scheme rd local

Related commands

· hwtacacs scheme

· local-user

· radius scheme

authorization lan-access

Use authorization lan-access to configure the authorization method for LAN users.

Use undo authorization lan-access to restore the default.

Syntax

authorization lan-access { local | none | radius-scheme radius-scheme-name [ local | none ] }

undo authorization lan-access

Default

The default authorization method for the ISP domain is used for LAN users.

Views

ISP domain view

Default command level

2: System level

Parameters

local: Performs local authorization.

none: Does not perform authorization. In this case, an authenticated LAN user can access the network directly.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS scheme must have been configured.

The RADIUS authorization configuration takes effect only when the authentication method and authorization method of the ISP domain use the same RADIUS scheme.

Examples

# In the ISP domain test, perform local authorization for LAN users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization lan-access local

# In the ISP domain test, perform RADIUS authorization for LAN users based on the scheme rd and use local authorization as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization lan-access radius-scheme rd local

Related commands

· authorization default

· local-user

· radius scheme

authorization login

Use authorization login to configure the authorization method for login users through the console port, Telnet, or FTP.

Use undo authorization login to restore the default.

Syntax

authorization login { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo authorization login

Default

The default authorization method for the ISP domain is used for login users.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local authorization.

none: Does not perform authorization. After passing authentication, FTP users can access the root directory of the device, and other login users can access only the commands of Level 0.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

The RADIUS authorization configuration takes effect only when the authentication method and authorization method of the ISP domain use the same RADIUS scheme.

Examples

# In the ISP domain test, perform local authorization for login users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization login local

# In the ISP domain test, perform RADIUS authorization for login users based on the scheme rd and use local authorization as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization login radius-scheme rd local

Related commands

· authorization default

· hwtacacs scheme

· local-user

· radius scheme

authorization portal

Use authorization portal to configure the authorization method for portal users.

Use undo authorization portal to restore the default.

Syntax

authorization portal { local | none | radius-scheme radius-scheme-name [ local ] }

undo authorization portal

Default

The default authorization method for the ISP domain is used for portal users.

Views

ISP domain view

Default command level

2: System level

Parameters

local: Performs local authorization.

none: Does not perform authorization. In this case, an authenticated portal user can access the network directly.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS scheme must have been configured.

The RADIUS authorization configuration takes effect only when the authentication method and authorization method of the ISP domain use the same RADIUS scheme.

Examples

# In the ISP domain test, perform local authorization for portal users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization portal local

# In the ISP domain test, perform RADIUS authorization for portal users based on the scheme rd and use local authorization as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization portal radius-scheme rd local

Related commands

· authorization default

· local-user

· radius scheme

authorization ppp

Use authorization ppp to configure the authorization method for PPP users.

Use undo authorization ppp to restore the default.

Syntax

authorization ppp { hwtacacs-scheme hwtacacs-scheme-name [ local ] | local | none | radius-scheme radius-scheme-name [ local ] }

undo authorization ppp

Default

The default authorization method for the ISP domain is used for PPP users.

Views

ISP domain view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies an HWTACACS scheme by its name, a case-insensitive string of 1 to 32 characters.

local: Performs local authorization.

none: Does not perform authorization. In this case, an authenticated PPP user can access the network directly.

radius-scheme radius-scheme-name: Specifies a RADIUS scheme by its name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

The specified RADIUS or HWTACACS scheme must have been configured.

The RADIUS authorization configuration takes effect only when the authentication method and authorization method of the ISP domain use the same RADIUS scheme.

Examples

# In the ISP domain test, perform local authorization for PPP users.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization ppp local

# In the ISP domain test, perform RADIUS authorization for PPP users based on the scheme rd and use local authorization as the backup.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] authorization ppp radius-scheme rd local

Related commands

· authorization default

· hwtacacs scheme

· local-user

· radius scheme

cut connection

Use cut connection to tear down the specified user connections forcibly.

Syntax

cut connection { access-type { dot1x | mac-authentication | portal } | all | domain isp-name | interface interface-type interface-number | ip ip-address | mac mac-address | ucibindex ucib-index | user-name user-name | vlan vlan-id }

Views

System view

Default command level

2: System level

Parameters

access-type: Specifies the user connections of the specified access type.

· dot1x: Indicates 802.1X authentication.

· mac-authentication: Indicates MAC address authentication.

· portal: Indicates portal authentication.

all: Specifies all user connections.

domain isp-name: Specifies the user connections of an ISP domain. The isp-name argument represents the name of an existing ISP domain and is a string of 1 to 24 characters.

interface interface-type interface-number: Specifies the user connections on an interface. Only Layer 2 Ethernet interfaces and WLAN virtual interfaces are supported.

ip ip-address: Specifies the user connections for an IP address.

mac mac-address: Specifies the user connections for a MAC address, with mac-address in the format H-H-H.

ucibindex ucib-index: Specifies the user connection that uses the connection index. The value range for the ucib-index argument is 0 to 4294967295.

user-name user-name: Specifies the user connections that use the username. The user-name argument is a case-sensitive string of 1 to 80 characters. For a username entered without a domain name, the system assumes that the user is in the default domain or the mandatory authentication domain.

vlan vlan-id: Specifies the user connections of a VLAN, where vlan-id ranges from 1 to 4094.

Usage guidelines

This command applies to LAN, portal, and PPP user connections.

For 802.1X users whose usernames carry the version number or contain spaces, you cannot cut the connections by username.

For 802.1X users whose usernames use a slash (/) or backslash (\) as the domain name delimiter, you cannot cut their connections by username. For example, the cut connection user-name aaa\bbb command cannot cut the connections of the user aaa\bbb.

An interface that is configured with a mandatory authentication domain treats users of the corresponding access type as users in the mandatory authentication domain. For example, if you configure an 802.1X mandatory authentication domain on an interface, the interface uses the domain's AAA methods for all its 802.1X users. To cut connections of such users, use the cut connection domain isp-name command, and specify the mandatory authentication domain.

Examples

# Tear down all connections of ISP domain test.

<Sysname> system-view

[Sysname] cut connection domain test

Related commands

· display connection

· service-type

display connection

Use display connection to display information about AAA user connections.

Syntax

display connection [ access-type { dot1x | mac-authentication I portal } | domain isp-name | interface interface-type interface-number | ip ip-address | mac mac-address | ucibindex ucib-index | user-name user-name | vlan vlan-id ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

access-type: Specifies the user connections of the specified access type.

· dot1x: Indicates 802.1X authentication.

· mac-authentication: Indicates MAC address authentication.

· portal: Indicates portal authentication.

domain isp-name: Specifies the user connections of an ISP domain. The isp-name argument represents the name of an existing ISP domain and is a case-insensitive string of 1 to 24 characters.

interface interface-type interface-number: Specifies the user connections on an interface. Only Layer 2 Ethernet interfaces and WLAN virtual interfaces are supported.

ip ip-address: Specifies the user connections of an IP address.

mac mac-address: Specifies the user connections of a MAC address, with mac-address in the format H-H-H.

ucibindex ucib-index: Specifies the user connection that uses the connection index. The value range for the ucib-index argument is 0 to 4294967295.

vlan vlan-id: Specifies the user connections of a VLAN, where vlan-id ranges from 1 to 4094.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

This command does not display information about FTP user connections.

With no parameter specified, this command displays brief information about all AAA user connections.

If you specify the ucibindex ucib-index option, this command displays detailed information. Otherwise, this command displays brief information.

If an interface is configured with a mandatory authentication domain (for example, an 802.1X mandatory authentication domain), the device uses the mandatory authentication domain to perform authentication, authorization, and accounting for users who access the interface through the specified access type. To display connections of such users, use the display connection domain isp-name command and specify the mandatory authentication domain.

How the device displays the username of a user on an interface configured with a mandatory authentication domain depends on the format of the username entered by the user at login:

· If the username does not contain the at sign (@), the device displays the username in the format username@mandatory authentication domain name.

· If the username contains the at sign (@), the device displays the entered username. For example, if a user entered the username aaa@123 at login and the name of the mandatory authentication domain is dom, the device displays the username aaa@123, rather than aaa@123@dom.

For 802.1X users whose usernames use a slash (/) or backslash (\) as the domain name delimiter, you cannot query the connections by username. For example, the display connection user-name aaa\bbb command cannot display the connections of the user aaa\bbb.

Examples

# Display information about all AAA user connections.

<Sysname> display connection

Index=0 ,Username=telnet@system

IP=10.0.0.1

IPv6=N/A

Total 1 connection(s) matched.

# Display information about AAA user connections using the index of 0.

<Sysname> display connection ucibindex 0

Index=0 , Username=telnet@system

IP=10.0.0.1

IPv6=N/A

Access=Admin ,AuthMethod=PAP

Port Type=Virtual ,Port Name=N/A

Initial VLAN=999, Authorized VLAN=20

ACL Group=Disable

User Profile=N/A

CAR=Disable

Priority=Disable

SessionTimeout=60(s), Terminate-Action=Radius-Request

Start=2009-07-16 10:53:03 ,Current=2009-07-16 10:57:06 ,Online=00h04m03s

Total 1 connection matched.

Table 1 Command output

Field	Description
Username	Username of the connection, in the format username@domain.
MAC	MAC address of the user.
IP	IPv4 address of the user.
IPv6	IPv6 address of the user.
Access	User access type.
ACL Group	Authorization ACL group. When no authorization ACL group is assigned, this field displays Disable.
User Profile	Authorization user profile. The device does not support authorization user profiles in the current version.
CAR(kbps)	Authorized CAR parameters.
UpPeakRate	Uplink peak rate.
DnPeakRate	Downlink peak rate.
UpAverageRate	Uplink average rate.
DnAverageRate	Downlink average rate.
SessionTimeout	Session timeout value received from the server, in seconds. The value indicates: · The remaining online time of the user if Terminate-Action is Default. · The re-authentication interval for the user if Terminate-Action is Radius-Request.
Terminate-Action	Action to take when the session timeout expires. The action can be: · Default—Cuts off the user. · Radius-Request—Re-authenticates the user.

Related commands

cut connection

display domain

Use display domain to display the configuration of ISP domains.

Syntax

display domain [ isp-name ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

isp-name: Name of an existing ISP domain, a string of 1 to 24 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If you do not specify any ISP domain, the command displays the configuration of all ISP domains.

Examples

# Display the configuration of all ISP domains.

<Sysname> display domain

0 Domain : system

State : Active

Access-limit : Disabled

Accounting method : Required

Default authentication scheme : local

Default authorization scheme : local

Default accounting scheme : local

Domain User Template:

Idle-cut : Disabled

Self-service : Disabled

Authorization attributes :

1 Domain : test

State : Active

Access-limit : Disabled

Accounting method : Required

Default authentication scheme : local

Default authorization scheme : local

Default accounting scheme : local

Lan-access authentication scheme : radius:test, local

Lan-access authorization scheme : hwtacacs:hw, local

Lan-access accounting scheme : local

Domain User Template:

Idle-cut : Disabled

Session-time : exclude-idle-time

Self-service : Disabled

Authorization attributes :

User-profile : profile1

Default Domain Name: system

Total 2 domain(s).

Table 2 Command output

Field	Description
Domain	ISP domain name.
State	Status of the ISP domain: active or blocked. Users in an active ISP domain can request network services, and users in a blocked ISP domain cannot.
Access-limit	Limit on the number of user connections. If there is no limit on the number, this field displays Disabled.
Accounting method	Indicates whether accounting is required. If accounting is required, when no accounting server is available or when communication with the accounting server fails, user connections are torn down. Otherwise, users can continue to use network services.
Default authentication scheme	Default authentication method.
Default authorization scheme	Default authorization method.
Default accounting scheme	Default accounting method.
Lan-access authentication scheme	Authentication method for LAN users.
Lan-access authorization scheme	Authorization method for LAN users.
Lan-access accounting scheme	Accounting method for LAN users.
Domain User Template	Indicates some functions and attributes set for users in the domain.
Idle-cut	Indicates whether the idle cut function is enabled. With the idle cut function enabled for a domain, the system logs out any user in the domain whose traffic is less than the specified minimum traffic during the idle timeout period.
Session-time	Indicates whether the idle cut time is included in the user online time to be uploaded to the server. Options include: · Exclude-idle-time—The idle cut time is excluded from the user online time. · Include-idle-time—The idle cut time is included in the user online time.
Self-service	Indicates whether the self-service function is enabled. With the self-service function enabled, users can launch a browser and enter the self-service URL in the address bar to access the self-service pages and perform self-service operations.
Authorization attributes	Default authorization attributes for the ISP domain.
User-profile	Default authorization user profile. The device does not support authorization user profiles in the current version.

Related commands

· access-limit enable

· domain

· state

domain

Use domain to create an ISP domain and enter ISP domain view.

Use undo domain to remove an ISP domain.

Syntax

domain isp-name

undo domain isp-name

Default

There is a system predefined ISP domain named system in the system.

Views

System view

Default command level

3: Manage level

Parameters

isp-name: Specifies an ISP domain name, a case-insensitive string of 1 to 24 characters that cannot contain the slash (/), backslash (\), colon (:), asterisk (*), question mark (?), left angle bracket (<), right angle bracket (>), quotation marks ("), vertical bar (|), or at sign (@).

Usage guidelines

All ISP domains are in active state when they are created.

The system predefined ISP domain system cannot be deleted, but you can modify its configuration.

To delete the ISP domain that is used as the default ISP domain, you must first change it to a non-default ISP domain by using the undo domain default enable command.

Examples

# Create ISP domain test, and enter ISP domain view.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test]

Related commands

· state

· display domain

domain default enable

Use domain default enable to specify the default ISP domain. Users without any domain name carried in the usernames are considered to be in the default domain.

Use undo domain default enable to restore the default.

Syntax

domain default enable isp-name

undo domain default enable

Default

The default ISP domain is the system predefined ISP domain system.

Views

System view

Default command level

3: Manage level

Parameters

isp-name: Name of the ISP domain, a case-insensitive string of 1 to 24 characters.

Usage guidelines

There can be only one default ISP domain.

The specified domain must already exist. Otherwise, users without a domain name in the username cannot pass authentication.

To delete the ISP domain that is used as the default ISP domain, you must first change it to a non-default ISP domain by using the undo domain default enable command.

Examples

# Create a new ISP domain named test, and configure it as the default ISP domain.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] quit

[Sysname] domain default enable test

Related commands

· domain

· state

· display domain

domain if-unknown

Use domain if-unknown to specify an ISP domain for users with unknown domain names.

Use undo domain if-unknown to restore the default.

Syntax

domain if-unknown isp-name

undo domain if-unknown

Default

No ISP domain is specified for users with unknown domain names.

Views

System view

Default command level

3: Manage level

Parameters

Usage guidelines

The device chooses an authentication domain for each user in the following order:

· The authentication domain specified for the access module

· The ISP domain in the username

· The default ISP domain of the device

· The ISP domain specified for users with unknown domain names

If all the domains are unavailable, user authentication fails.

NOTE:

Support for the authentication domain configuration depends on the access module. You can specify an authentication domain for 802.1X or MAC address authentication.

Examples

# Specify the ISP domain test for users with unknown domain names.

<Sysname> system-view

[Sysname] domain if-unknown test

Related commands

domain default enable

idle-cut enable

Use idle-cut enable to enable the idle cut function and set the relevant parameters.

Use undo idle-cut enable to restore the default.

Syntax

idle-cut enable minute [ flow ]

undo idle-cut enable

Default

The function is disabled.

Views

ISP domain view

Default command level

2: System level

Parameters

minute: Idle timeout period, ranging from 1 to 129600 minutes.

flow: Minimum traffic during the idle timeout period in bytes. It ranges from 1 to 10240000 and defaults to 10240.

Usage guidelines

With the idle cut function enabled for a domain, the device checks the traffic of each online user in the domain at the idle timeout interval, and it logs out any user in the domain whose traffic during the idle timeout period is less than the specified minimum traffic.

You can also set the idle timeout period on the server to make the server log out users whose traffic during the idle timeout period is less than 10240 bytes. However, your setting on the server takes effect only when you disable the idle cut function on the device.

Examples

# Enable the idle cut function and set the idle timeout period to 50 minutes and the traffic threshold to 1024 bytes for ISP domain test.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] idle-cut enable 50 1024

Related commands

domain

self-service-url enable

Use self-service-url enable to enable the self-service server location function and specify the URL of the self-service server.

Use undo self-service-url enable to restore the default.

Syntax

self-service-url enable url-string

undo self-service-url enable

Default

The self-service server location function is disabled.

Views

ISP domain view

Default command level

2: System level

Parameters

url-string: URL of the self-service server, a string of 1 to 64 characters that starts with http:// and contains no question mark. This URL was specified by the RADIUS server administrator during RADIUS server installation.

Usage guidelines

With the self-service function, users can manage and control their accounts and passwords. Only the RADIUS server systems provided by IMC support the self-service function.

Examples

# For ISP domain test, enable the self-service server location function, and specify the URL of the self-service server for changing user password to http://10.153.89.94/selfservice.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] self-service-url enable http://10.153.89.94/selfservice

session-time include-idle-time

Use session-time include-idle-time to include the idle cut time in the user online time to be uploaded to the server.

Use undo session-time include-idle-time to restore the default.

Syntax

session-time include-idle-time

undo session-time include-idle-time

Default

The user online time uploaded to the server excludes the idle cut time.

Views

ISP domain view

Default command level

2: System level

Usage guidelines

The device uploads to the server the online user time when a user is logged off. However, the online user time of an abnormally logged-off user can contain an idle timeout interval when the idle cut function is enabled. You can configure the device to include or exclude the idle cut time before the device uploads the online user time to the server according to your accounting policy.

Examples

# Configure the device to include the idle cut time in the user online time uploaded to the server for ISP domain test.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] session-time include-idle-time

Related commands

idle-cut enable

state (ISP domain view)

Use state to set the status of an ISP domain.

Use undo state to restore the default.

Syntax

state { active | block }

undo state

Default

An ISP domain is in active state.

Views

ISP domain view

Default command level

2: System level

Parameters

active: Places the ISP domain in active state to allow the users in the ISP domain to request network services.

block: Places the ISP domain in blocked state to prevent users in the ISP domain from requesting network services.

Usage guidelines

By blocking an ISP domain, you disable offline users of the domain from requesting network services. The online users are not affected.

Examples

# Place the ISP domain test to the blocked state.

<Sysname> system-view

[Sysname] domain test

[Sysname-isp-test] state block

Local user configuration commands

access-limit

Use access-limit to limit the number of concurrent users of the same local user account.

Use undo access-limit to remove the limitation.

Syntax

access-limit max-user-number

undo access-limit

Default

There is no limit to the number of users who concurrently use the same local user account.

Views

Local user view

Default command level

3: Manage level

Parameters

max-user-number: Maximum number of concurrent users of the same local user account, ranging from 1 to 1024.

Usage guidelines

This command takes effect only when local accounting is used for the user account.

This limit has no effect on FTP users because accounting is not available for FTP users.

Examples

# Limit the maximum number of concurrent users of local user account abc to 5.

<Sysname> system-view

[Sysname] local-user abc

[Sysname-luser-abc] access-limit 5

Related commands

display local-user

authorization-attribute

Use authorization-attribute to configure authorization attributes for the local user or user group. After the local user or a local user of the user group passes authentication, the device assigns these attributes to the user.

Use undo authorization-attribute to remove authorization attributes and restore the defaults.

Syntax

authorization-attribute { acl acl-number | callback-number callback-number | idle-cut minute | level level | user-role { guest | guest-manager | security-audit } | vlan vlan-id | work-directory directory-name } *

undo authorization-attribute { acl | callback-number | idle-cut | level | user-role | vlan | work-directory } *

Default

No authorization attribute is configured for a local user or user group.

Views

Local user view, user group view

Default command level

3: Manage level

Parameters

acl acl-number: Specifies the authorization ACL. The ACL number must range from 2000 to 5999. After passing authentication, a local user is authorized to access the network resources specified by this ACL.

callback-number callback-number: Specifies the authorized PPP callback number. The callback-number argument is a case-sensitive string of 1 to 64 characters. After a local user passes authentication, the device uses this number to call the user.

idle-cut minute: Sets the idle timeout period. With the idle cut function enabled, an online user whose idle period exceeds the specified idle timeout period is logged out. The minute argument indicates the idle timeout period, ranging from 1 to 129600 minutes.

level level: Specifies the user level, which can be 0 for visit level, 1 for monitor level, 2 for system level, and 3 for manage level. A smaller number means a lower level. This parameter determines the command level for login users whose user interfaces perform AAA authentication. By default, the user level is 0, and users can use only commands of level 0 after login.

user-role: Specifies the role for the local user. This keyword is available in only local user view. Users playing different roles can access different levels of commands. If you specify no role for a local user, the access right of the user after login depends on other authorization attributes. Supported roles include:

· guest: A guest user account is usually created through the Web interface.

· guest-manager: An authenticated guest manager can manage guest user accounts on Web pages.

· security-audit: An authenticated security log administrator can manage security log files. The commands that a security log administrator can use are described in the information center commands. For more information, see Network Management and Monitoring Command Reference.

vlan vlan-id: Specifies the authorized VLAN, where vlan-id ranges from 1 to 4094. After passing authentication, a local user can access the resources in this VLAN.

work-directory directory-name: Specifies the work directory, if the user or users use the FTP or SFTP service. The directory-name argument is a case-insensitive string of 1 to 135 characters. The directory must already exist. By default, an FTP or SFTP user can access the root directory of the device.

Usage guidelines

Every configurable authorization attribute has its definite application environments and purposes. Consider the service types of users when assigning authorization attributes.

Authorization attributes configured for a user group are effective for all local users in the group. You can group local users to improve configuration and management efficiency.

An authorization attribute configured in local user view takes precedence over the same attribute configured in user group view. If an authorization attribute is configured in user group view but not in local user view, the setting in user group view takes effect.

If only one user is playing the role of security log administrator in the system, you cannot delete the user account or remove or change the user's role, unless you first configure another user as a security log administrator.

A local user can play only one role at a time. If you perform the role configuration repeatedly, only the last role configuration takes effect.

Examples

# Configure the authorized VLAN of local user abc as VLAN 2.

<Sysname> system-view

[Sysname] local-user abc

[Sysname-luser-abc] authorization-attribute vlan 2

# Configure the authorized VLAN of user group abc as VLAN 3.

<Sysname> system-view

[Sysname] user-group abc

[Sysname-ugroup-abc] authorization-attribute vlan 3

bind-attribute

Use bind-attribute to configure binding attributes for a local user.

Use undo bind-attribute to remove binding attributes of a local user.

Syntax

bind-attribute { call-number call-number [ : subcall-number ] | ip ip-address | location port slot-number subslot-number port-number | mac mac-address | vlan vlan-id } *

undo bind-attribute { call-number | ip | location | mac | vlan } *

Default

No binding attribute is configured for a local user.

Views

Local user view

Default command level

3: Manage level

Parameters

call-number call-number: Specifies a calling number for ISDN user authentication. The call-number argument is a string of 1 to 64 characters. This option applies only to PPP users.

subcall-number: Specifies the sub-calling number. The total length of the calling number and the sub-calling number cannot be more than 62 characters.

ip ip-address: Specifies the IP address of the user. This option applies to Telnet, SSH, FTP, and 802.1X users.

location port slot-number subslot-number port-number: Specifies the port to which the user is bound. The slot-number argument ranges from 0 to 255, the subslot-number argument ranges from 0 to 15, and the port-number argument ranges from 0 to 255. This option applies only to LAN users.

mac mac-address: Specifies the MAC address of the user in the format H-H-H. This option applies only to LAN users.

vlan vlan-id: Specifies the VLAN to which the user belongs. The vlan-id argument ranges from 1 to 4094. This option applies only to LAN users.

Usage guidelines

Binding attributes are checked upon authentication of a local user. If the binding attributes of a local user do not match the configured ones, the user fails checking and authentication.

Binding attribute checking does not take the service types of users into account. A configured binding attribute is effective for all types of users. Configure binding attributes for different types of local users with caution. For example, an IP address binding applies only to 802.1X authentication that supports IP address upload. If the authentication method such as MAC authentication does not support IP address upload, do not configure an IP address binding for the authentication method. Otherwise, local authentication fails.

Examples

# Configure the bound IP of local user abc as 3.3.3.3.

<Sysname> system-view

[Sysname] local-user abc

[Sysname-luser-abc] bind-attribute ip 3.3.3.3

display local-user

Use display local-user to display configuration and statistics information about local users.

Syntax

display local-user [ idle-cut { disable | enable } | service-type { ftp | lan-access | portal | ppp | ssh | telnet | terminal | web } | state { active | block } | user-name user-name | vlan vlan-id ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

idle-cut { disable | enable }: Specifies local users with the idle cut function disabled or enabled.

service-type: Specifies the local users who use a specified type of service.

· ftp: FTP users.

· lan-access: Users accessing the network through Ethernet, such as 802.1X users.

· portal: Portal users.

· ppp: PPP users.

· ssh: SSH users.

· telnet: Telnet users.

· terminal: Users logging in through the console port.

· web: Web users.

state { active | block }: Specifies local users in active or blocked state. A local user in active state can access network services, but a local user in blocked state cannot.

user-name user-name: Specifies all local users using the specified username. The username is a case-sensitive string of 1 to 55 characters, and it does not contain the domain name.

vlan vlan-id: Specifies all local users in a VLAN. The VLAN ID ranges from 1 to 4094.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If you do not specify any parameter, the command displays information about all local users.

Examples

# Display information about all local users.

<Sysname> display local-user

The contents of local user abc:

State: Active

ServiceType: lan-access

Access-limit: Enabled Current AccessNum: 0

Max AccessNum: 300

User-group: system

Bind attributes:

IP address: 1.2.3.4

Bind location: 0/4/1 (SLOT/SUBSLOT/PORT)

MAC address: 00-01-00-02-00-03

Vlan ID: 100

Authorization attributes:

Idle TimeOut: 10(min)

Work Directory: flash:/

User Privilege: 3

Acl ID: 2000

Vlan ID: 100

Expiration date: 12:12:12-2018/09/16

Total 1 local user(s) matched.

Table 3 Command output

Field	Description
State	Status of the local user: active or blocked.
ServiceType	Service types that the local user can use, including FTP, LAN access, portal, PPP, SSH, Telnet, terminal, and Web.
Access-limit	Whether or not to limit the number of concurrent connections of the username.
Current AccessNum	Number of connections that currently use the username.
Max AccessNum	Maximum number of concurrent connections of the username.
Bind attributes	Binding attributes of the local user.
VLAN ID	VLAN to which the user is bound.
Calling Number	Calling number bound for the ISDN user.
Authorization attributes	Authorization attributes of the local user.
Idle TimeOut	Idle timeout period of the user, in minutes.
Callback-number	Authorized PPP callback number of the local user.
Work Directory	Directory that the FTP user can access.
VLAN ID	Authorized VLAN of the local user.
Expiration date	Expiration time of the local user.

Related commands

local-user

display user-group

Use display user-group to display the configuration of user groups.

Syntax

display user-group [ group-name ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

group-name: Specifies a user group name, a case-insensitive string of 1 to 32 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If you do not specify any user group name, the command displays the configuration of all user groups.

Examples

# Display the configuration of user group abc.

<Sysname> display user-group abc

The contents of user group abc:

Authorization attributes:

Idle-cut: 120(min)

Work Directory: FLASH:

Level: 1

Acl Number: 2000

Vlan ID: 1

Callback-number: 1

Total 1 user group(s) matched.

Table 4 Command output

Field	Description
Idle-cut	Idle timeout interval, in minutes.
Work Directory	Directory that FTP/SFTP users in the group can access.
Level	Level of the local users in the group.
ACL Number	Authorization ACL for the local users in the group.
VLAN ID	Authorized VLAN for the local users in the group.
Callback-number	Authorized PPP callback number for the local users in the group.

Related commands

user-group

expiration-date

Use expiration-date to set the expiration time of a local user.

Use undo expiration-date to remove the configuration.

Syntax

expiration-date time

undo expiration-date

Default

A local user has no expiration time, and no time validity checking is performed.

Views

Local user view

Default command level

3: Manage level

Parameters

time: Expiration time of the local user, in the format HH:MM:SS-MM/DD/YYYY, HH:MM:SS-YYYY/MM/DD, MM/DD/YYYY-HH:MM:SS, or YYYY/MM/DD-HH:MM:SS. HH:MM:SS indicates the time, where HH ranges from 0 to 23, and MM and SS range from 0 to 59. MM/DD/YYYY or YYYY/MM/DD indicates the date, where YYYY ranges from 2000 to 2035, MM ranges from 1 to 12, and the range of DD depends on the month. Except for the zeros in 00:00:00, leading zeros can be omitted. For example, 2:2:0-2008/2/2 equals 02:02:00-2008/02/02.

Usage guidelines

For temporary network access requirements, create a guest account, and specify a validity time and an expiration time for the account to control the validity of the account. When a user uses the guest account for local authentication and passes the authentication, the access device checks whether the current system time is between the validity time and the expiration time. If it is, the device permits the user to access the network. Otherwise, the device denies the access request of the user.

Examples

# Set the expiration time of user abc to 12:10:20 on May 31, 2008.

<Sysname> system-view

[Sysname] local-user abc

[Sysname-luser-abc] expiration-date 12:10:20-2008/05/31

Related commands

validity-date

group

Use group to assign a local user to a user group.

Use undo group to restore the default.

Syntax

group group-name

undo group

Default

A local user belongs to the system default user group system.

Views

Local user view

Default command level

3: Manage level

Parameters

group-name: User group name, a case-insensitive string of 1 to 32 characters.

Examples

# Assign local user 111 to user group abc.

<Sysname> system-view

[Sysname] local-user 111

[Sysname-luser-111] group abc

group-attribute allow-guest

Use group-attribute allow-guest to set the guest attribute for a user group so that guest users created by a guest manager through the Web interface can join the group.

Use undo group-attribute allow-guest to restore the default.

Syntax

group-attribute allow-guest

undo group-attribute allow-guest

Default

The guest attribute is not set for a user group, and guest users created by a guest manager through the Web interface cannot join the group.

Views

User group view

Default command level

3: Manage level

Usage guidelines

The guest attribute is set for the system predefined user group system and you cannot remove the attribute for the user group.

Examples

# Set the guest attribute for user group test.

<Sysname> system-view

[Sysname] user-group test

[Sysname-ugroup-test] group-attribute allow-guest

local-user

Use local-user to add a local user and enter local user view.

Use undo local-user to remove the specified local users.

Syntax

local-user user-name

undo local-user { user-name | all [ service-type { ftp | lan-access | portal | ppp | ssh | telnet | terminal | web } ] }

Default

A local user named admin exists on the device.

Views

System view

Default command level

3: Manage level

Parameters

user-name: Name for the local user, a case-sensitive string of 1 to 55 characters that does not contain the domain name. It cannot contain any slash (/), backslash (\), vertical bar (|), colon (:), asterisk (*), question mark (?), left angle bracket (<), right angle bracket (>), or at sign (@), and cannot be a, al, or all.

all: Specifies all users.

service-type: Specifies the users of a type.

· ftp: FTP users.

· lan-access: Users accessing the network through an Ethernet, such as 802.1X users.

· portal: Portal users.

· ppp: PPP users.

· ssh: SSH users.

· telnet: Telnet users.

· terminal: Users logging in through the console port.

· web: Web users.

Examples

# Add a local user named user1.

<Sysname> system-view

[Sysname] local-user user1

[Sysname-luser-user1]

Related commands

· display local-user

· service-type

password

Use password to configure a password for a local user.

Use undo password to delete the password of a local user.

Syntax

password [ { hash simple | cipher | simple } password ]

undo password

Views

Local user view

Default command level

2: System level

Parameters

hash simple: Specifies a plaintext password encrypted by the hash algorithm.

cipher: Specifies a ciphertext password.

simple: Specifies a plaintext password.

password: Specifies the password string. This argument is case sensitive.

· A plaintext password is a string of 1 to 63 characters.

· A hashed password is a string of 1 to 110 characters.

· A ciphertext password is a string of 1 to 117 characters.

Usage guidelines

If you do not specify the hash keyword, all passwords, including passwords configured in plain text, are saved and displayed in cipher text.

Examples

# Set the password to 123456 in plain text for the local user user1 without using the hash algorithm.

<Sysname> system-view

[Sysname] local-user user1

[Sysname-luser-user1] password simple 123456

Related commands

display local-user

service-type

Use service-type to specify the service types that a user can use.

Use undo service-type to delete one or all service types configured for a user.

Syntax

service-type { ftp | lan-access | { ssh | telnet | terminal } * | portal | ppp | web }

undo service-type { ftp | lan-access | { ssh | telnet | terminal } * | portal | ppp | web }

Default

A user is authorized with no service.

Views

Local user view

Default command level

3: Manage level

Parameters

ftp: Authorizes the user to use the FTP service. The user can use the root directory of the FTP server by default.

lan-access: Authorizes the user to use the LAN access service. The users are mainly Ethernet users such as 802.1X users.

ssh: Authorizes the user to use the SSH service.

telnet: Authorizes the user to use the Telnet service.

terminal: Authorizes the user to use the terminal service, allowing the user to log in from the console port.

portal: Authorizes the user to use the portal service.

ppp: Authorizes the user to use the PPP service.

web: Authorizes the user to use the Web service.

Usage guidelines

You can execute the service-type command repeatedly to specify multiple service types for a user.

Examples

# Authorize user user1 to use the Telnet service.

<Sysname> system-view

[Sysname] local-user user1

[Sysname-luser-user1] service-type telnet

state (local user view)

Use state to set the status of a local user.

Use undo state to restore the default.

Syntax

state { active | block }

undo state

Default

A local user is in active state.

Views

Local user view

Default command level

2: System level

Parameters

active: Places the local user in active state to allow the local user to request network services.

block: Places the local user in blocked state to prevent the local user from requesting network services.

Usage guidelines

By blocking a user, you disable the user from requesting network services. No other users are affected.

Examples

# Place local user user1 to the blocked state.

<Sysname> system-view

[Sysname] local-user user1

[Sysname-luser-user1] state block

Related commands

local-user

user-group

Use user-group to create a user group and enter its view.

Use undo user-group to remove a user group.

Syntax

user-group group-name

undo user-group group-name

Views

System view

Default command level

3: Manage level

Parameters

group-name: User group name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

A user group consists of a group of local users and has a set of local user attributes. You can configure local user attributes for a user group to implement centralized management of user attributes for the local users in the group. Configurable user attributes include authorization attributes.

A user group with one or more local users cannot be removed.

The system predefined user group system cannot be removed, but you can modify its configuration.

Examples

# Create a user group named abc, and enter its view.

<Sysname> system-view

[Sysname] user-group abc

[Sysname-ugroup-abc]

Related commands

display user-group

validity-date

Use validity-date to set the validity time of a local user.

Use undo validity-date to remove the configuration.

Syntax

validity-date time

undo validity-date

Default

A local user has no validity time and no time validity checking is performed.

Views

Local user view

Default command level

3: Manage level

Parameters

time: Validity time of the local user, in the format HH:MM:SS-MM/DD/YYYY, HH:MM:SS-YYYY/MM/DD, MM/DD/YYYY-HH:MM:SS, or YYYY/MM/DD-HH:MM:SS. HH:MM:SS indicates the time, where HH ranges from 0 to 23, and MM and SS range from 0 to 59. MM/DD/YYYY or YYYY/MM/DD indicates the date, where YYYY ranges from 2000 to 2035, MM ranges from 1 to 12, and the range of DD depends on the month. Except for the zeros in 00:00:00, leading zeros can be omitted. For example, 2:2:0-2008/2/2 equals 02:02:00-2008/02/02.

Usage guidelines

Examples

# Set the validity time of user abc to 12:10:20 on April 30, 2008, and set the expiration time to 12:10:20 on May 31, 2008.

<Sysname> system-view

[Sysname] local-user abc

[Sysname-luser-abc] validity-date 12:10:20-2008/04/30

[Sysname-luser-abc] expiration-date 12:10:20-2008/05/31

Related commands

expiration-date

RADIUS configuration commands

accounting-on enable

Use accounting-on enable to configure the accounting-on feature.

Use undo accounting-on enable to disable the accounting-on feature.

Syntax

accounting-on enable [ interval seconds | send send-times ] *

undo accounting-on enable

Default

The accounting-on feature is disabled.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

seconds: Time interval for retransmitting an accounting-on packet in seconds, ranging from 1 to 15. The default is 3 seconds.

send-times: Maximum number of accounting-on packet transmission attempts, ranging from 1 to 255. The default is 50.

Usage guidelines

The accounting-on feature enables the device, after rebooting, to automatically send an accounting-on message to the RADIUS accounting server indicated by the RADIUS scheme to stop accounting for and log out online users.

Parameters set with the accounting-on enable command take effect immediately.

After executing the accounting-on enable command, issue the save command to make sure that the command takes effect after the device reboots.

Examples

# Enable the accounting-on feature for RADIUS authentication scheme radius1, and set the retransmission interval to 5 seconds and the transmission attempts to 15.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] accounting-on enable interval 5 send 15

Related commands

radius scheme

data-flow-format (RADIUS scheme view)

Use data-flow-format to set the traffic statistics unit for data flows or packets.

Use undo data-flow-format to restore the default.

Syntax

data-flow-format { data { byte | giga-byte | kilo-byte | mega-byte } | packet { giga-packet | kilo-packet | mega-packet | one-packet } } *

undo data-flow-format { data | packet }

Default

The unit for data flows is byte and that for data packets is one-packet.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

data { byte | giga-byte | kilo-byte | mega-byte }: Specifies the unit for data flows, which can be byte, kilobyte, megabyte, or gigabyte.

packet { giga-packet | kilo-packet | mega-packet | one-packet }: Specifies the unit for data packets, which can be one-packet, kilo-packet, mega-packet, or giga-packet.

Usage guidelines

The unit for data flows and that for packets must be consistent with those on the RADIUS server. Otherwise, accounting cannot be performed correctly.

Examples

# Set the traffic statistics unit for data flows and that for packets to kilobytes and kilo-packets, respectively, in RADIUS scheme radius1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] data-flow-format data kilo-byte packet kilo-packet

Related commands

display radius scheme

Use display radius scheme to display the configuration of RADIUS schemes.

Syntax

display radius scheme [ radius-scheme-name ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

radius-scheme-name: RADIUS scheme name.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If you do not specify any RADIUS scheme, the command displays the configuration of all RADIUS schemes.

Examples

# Display the configuration of all RADIUS schemes.

<Sysname> display radius scheme

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

SchemeName : radius1

Index : 0 Type : extended

Primary Auth Server:

IP: 1.1.1.1 Port: 1812 State: active

Encryption Key : ******

Probe username : test

Probe interval : 60 min

Primary Acct Server:

IP: 1.1.1.1 Port: 1813 State: active

Encryption Key : ******

Second Auth Server:

IP: 1.1.2.1 Port: 1812 State: active

Encryption Key : N/A

Probe username : test

Probe interval : 60 min

IP: 1.1.3.1 Port: 1812 State: active

Encryption Key : N/A

Probe username : N/A

Probe interval : N/A

Second Acct Server:

IP: 1.1.2.1 Port: 1813 State: block

Encryption Key : N/A

Auth Server Encryption Key : ******

Acct Server Encryption Key : N/A

Accounting-On packet disable, send times : 50 , interval : 3s

Interval for timeout(second) : 3

Retransmission times for timeout : 3

Interval for realtime accounting(minute) : 12

Retransmission times of realtime-accounting packet : 5

Retransmission times of stop-accounting packet : 500

Quiet-interval(min) : 5

Username format : without-domain

Data flow unit : Byte

Packet unit : one

NAS-IP address : 1.1.1.1

Attribute 25 : car

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

Total 1 RADIUS scheme(s).

Table 5 Command output

Field	Description
SchemeName	Name of the RADIUS scheme.
Index	Index number of the RADIUS scheme.
Type	Type of the RADIUS server that the device supports. Options include: · Extended—The RADIUS server uses the proprietary RADIUS protocol of H3C for packet exchange. · Standard—The RADIUS server uses the standard RADIUS protocol for packet exchange. The protocol is compliant to RFC 2865 and RFC 2866 or later.
Primary Auth Server	Information about the primary authentication server.
Primary Acct Server	Information about the primary accounting server.
Second Auth Server	Information about the secondary authentication server.
Second Acct Server	Information about the secondary accounting server.
IP	IP address of the server.
Port	Service port of the server. If no port configuration is performed, the default port number is displayed.
State	Status of the server: active or blocked.
Encryption Key	Shared key for secure authentication or accounting communication, displayed as a series of asterisks (******). If no shared key is configured, this field displays N/A.
Probe username	Username used for server status detection.
Probe interval	Server status detection interval, in minutes.
Auth Server Encryption Key	Shared key for secure authentication communication, displayed as a series of asterisks (******). If no shared key is configured, this field displays N/A.
Acct Server Encryption Key	Shared key for secure accounting communication, displayed as a series of asterisks (******). If no shared key is configured, this field displays N/A.
Accounting-On packet disable	The accounting-on feature is disabled.
send times	Retransmission times of accounting-on packets.
interval	Interval at which the device retransmits accounting-on packets.
Interval for timeout(second)	RADIUS server response timeout period, in seconds.
Retransmission times for timeout	Maximum number of attempts for transmitting a RADIUS packet to a single RADIUS server.
Interval for realtime accounting(minute)	Interval for real-time accounting, in minutes.
Retransmission times of realtime-accounting packet	Maximum number of accounting attempts.
Retransmission times of stop-accounting packet	Maximum number of stop-accounting attempts.
Quiet-interval(min)	Quiet interval for the primary server.
Username format	Format of the usernames to be sent to the RADIUS server.
Data flow unit	Unit for data flows sent to the RADIUS server.
Packet unit	Unit for packets sent to the RADIUS server.
NAS-IP address	Source IP address for RADIUS packets to be sent.
Attribute 25	Interprets RADIUS attribute 25 as the CAR parameters. The device cannot interpret RADIUS attribute 25 as the CAR parameters in the current version.

Related commands

radius scheme

display radius statistics

Use display radius statistics to display statistics about RADIUS packets.

Syntax

display radius statistics [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display statistics about RADIUS packets.

<Sysname> display radius statistics

state statistic(total=128):

DEAD = 128 AuthProc = 0 AuthSucc = 0

AcctStart = 0 RLTSend = 0 RLTWait = 0

AcctStop = 0 OnLine = 0 Stop = 0

Received and Sent packets statistic:

Sent PKT total = 1547 Received PKT total = 23

Resend Times Resend total

1 508

2 508

Total 1016

RADIUS received packets statistic:

Code = 2 Num = 15 Err = 0

Code = 3 Num = 4 Err = 0

Code = 5 Num = 4 Err = 0

Code = 11 Num = 0 Err = 0

Running statistic:

RADIUS received messages statistic:

Auth request Num = 24 Err = 0 Succ = 24

Account request Num = 4 Err = 0 Succ = 4

Account off request Num = 503 Err = 0 Succ = 503

PKT auth timeout Num = 15 Err = 5 Succ = 10

PKT acct_timeout Num = 1509 Err = 503 Succ = 1006

Realtime Account timer Num = 0 Err = 0 Succ = 0

PKT response Num = 23 Err = 0 Succ = 23

Session ctrl pkt Num = 0 Err = 0 Succ = 0

Normal author request Num = 0 Err = 0 Succ = 0

Set policy result Num = 0 Err = 0 Succ = 0

Accounting on request Num = 0 Err = 0 Succ = 0

Accounting on response Num = 0 Err = 0 Succ = 0

Dynamic Author Ext request Num = 0 Err = 0 Succ = 0

RADIUS sent messages statistic:

Auth accept Num = 10

Auth reject Num = 14

EAP auth replying Num = 0

Account success Num = 4

Account failure Num = 3

Server ctrl req Num = 0

RecError_MSG_sum = 0

SndMSG_Fail_sum = 0

Timer_Err = 0

Alloc_Mem_Err = 0

State Mismatch = 0

Other_Error = 0

No-response-acct-stop packet = 1

Discarded No-response-acct-stop packet for buffer overflow = 0

Table 6 Command output

Field	Description
state statistic	User statistics, by state.
DEAD	Number of idle users.
AuthProc	Number of users waiting for authentication.
AuthSucc	Number of users who have passed authentication.
AcctStart	Number of users for whom accounting has been started.
RLTSend	Number of users for whom the system sends real-time accounting packets.
RLTWait	Number of users waiting for real-time accounting.
AcctStop	Number of users in the state of accounting waiting stopped.
OnLine	Number of online users.
Stop	Number of users in the state of stop.
Received and Sent packets statistic	Statistics for packets received and sent by the RADIUS module.
Sent PKT total	Number of packets sent.
Received PKT total	Number of packets received.
Resend Times	Number of transmission attempts.
Resend total	Number of packets retransmitted.
Total	Total number of packets retransmitted.
RADIUS received packets statistic	Statistics for packets received by the RADIUS module.
Code	Packet type.
Num	Total number of packets.
Err	Number of packets that the device failed to process.
Succ	Number of messages that the device successfully processed.
Running statistic	Statistics for RADIUS messages received and sent by the RADIUS module.
RADIUS received messages statistic	Statistics for received RADIUS messages.
Auth request	Counts of normal authentication requests.
Account request	Counts of accounting requests.
Account off request	Counts of stop-accounting requests.
PKT auth timeout	Counts of authentication timeout messages.
PKT acct_timeout	Counts of accounting timeout messages.
Realtime Account timer	Counts of real-time accounting requests.
PKT response	Counts of responses from servers.
Session ctrl pkt	Counts of session control messages.
Normal author request	Counts of normal authorization requests.
Set policy result	Counts of responses to the Set policy packets.
Accounting on request	Counts of accounting-on requests.
Accounting on response	Counts of accounting-on responses.
Dynamic Author Ext request	Counts of dynamic authorization extension requests.
RADIUS sent messages statistic	Statistics for sent RADIUS messages.
Auth accept	Number of accepted authentication packets.
Auth reject	Number of rejected authentication packets.
EAP auth replying	Number of replying packets of EAP authentication.
Account success	Number of accounting succeeded packets.
Account failure	Number of accounting failed packets.
Server ctrl req	Number of server control requests.
RecError_MSG_sum	Number of received packets in error.
SndMSG_Fail_sum	Number of packets that failed to be sent out.
Timer_Err	Number of packets for indicating timer startup failures.
Alloc_Mem_Err	Number of packets for indicating memory allocation failures.
State Mismatch	Number of packets for indicating mismatching status.
Other_Error	Number of packets for indicating other types of errors.
No-response-acct-stop packet	Number of times that no response was received for stop-accounting packets.
Discarded No-response-acct-stop packet for buffer overflow	Number of stop-accounting packets that were buffered but then discarded due to full memory.

Related commands

radius scheme

display stop-accounting-buffer (for RADIUS)

Use display stop-accounting-buffer to display information about buffered stop-accounting requests.

Syntax

display stop-accounting-buffer { radius-scheme radius-scheme-name | session-id session-id | time-range start-time stop-time | user-name user-name } [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

radius-scheme radius-scheme-name: Specifies buffered stop-accounting requests that are destined for the accounting server defined in a RADIUS scheme. The RADIUS scheme name is a case-insensitive string of 1 to 32 characters.

session-id session-id: Specifies the stop-accounting requests buffered for a session. The session ID is a string of 1 to 50 characters.

time-range start-time stop-time: Specifies the stop-accounting requests buffered in a time range. The start time and end time must be in the format HH:MM:SS-MM/DD/YYYY or HH:MM:SS-YYYY/MM/DD.

user-name user-name: Specifies the stop-accounting requests buffered for a user. The username is a case-sensitive string of 1 to 80 characters. Whether the user-name argument should include the domain name depends on the setting configured by the user-name-format command for the RADIUS scheme.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If the device sends a stop-accounting request to a RADIUS server but receives no response, it retransmits it up to a certain number of times (defined by the retry command). If the device still receives no response, it considers the stop-accounting attempt a failure, buffers the request, and makes another stop-accounting attempt. The maximum number of the stop-accounting attempts is defined by the retry stop-accounting command. If all attempts fail, the device discards the request.

Examples

# Display information about the stop-accounting requests buffered for user abc.

<Sysname> display stop-accounting-buffer user-name abc

RDIdx Session-ID user name Happened time

1 1000326232325010 abc 23:27:16-08/31/2006

1 1000326232326010 abc 23:33:01-08/31/2006

Total 2 record(s) Matched

key (RADIUS scheme view)

Use key to set the shared key for secure RADIUS authentication/authorization or accounting communication.

Use undo key to remove the configuration.

Syntax

key { accounting | authentication } [ cipher | simple ] key

undo key { accounting | authentication }

Default

No shared key is configured.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

accounting: Sets the shared key for secure RADIUS accounting communication.

authentication: Sets the shared key for secure RADIUS authentication/authorization communication.

cipher: Sets a cipher text shared key.

simple: Sets a plain text shared key.

key: Specifies the shared key string. This argument is case sensitive. If simple is specified, it must be a string of 1 to 64 characters. If cipher is specified, it must be a ciphertext string of 1 to 117 characters. If neither cipher nor simple is specified, you set a plaintext shared key string.

Usage guidelines

For secrecy, all shared keys, including keys configured in plain text, are saved in cipher text.

The shared keys specified during the configuration of the RADIUS servers take precedence.

The shared keys configured on the device must match those configured on the RADIUS servers.

Examples

# For RADIUS scheme radius1, set the shared key for secure accounting communication to ok in plain text.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] key accounting simple ok

# For RADIUS scheme radius1, set the shared key for secure accounting communication to ok in plain text.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] key accounting ok

# For RADIUS scheme radius1, set the shared key for secure authentication/authorization communication to $c$3$NMCbVjyIutaV6csCOGp4zsKRTlg2eT3B in cipher text.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] key authentication cipher $c$3$NMCbVjyIutaV6csCOGp4zsKRTlg2eT3B

Related commands

display radius scheme

nas-ip (RADIUS scheme view)

Use nas-ip to specify a source IP address for outgoing RADIUS packets.

Use undo nas-ip to restore the default.

Syntax

nas-ip { ipv4-address | ipv6 ipv6-address }

undo nas-ip

Default

The source IP address of an outgoing RADIUS packet is that configured by the radius nas-ip command in system view. If the radius nas-ip command is not configured, the source IP address is the IP address of the outbound interface.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

ipv4-address: IPv4 address in dotted decimal notation. It must be an address of the device and cannot be 0.0.0.0, 255.255.255.255, a class D address, or a class E address.

ipv6 ipv6-address: Specifies an IPv6 address. It must be a unicast address of the device and cannot be a link-local address.

Usage guidelines

The source IP address of RADIUS packets that a NAS sends must match the IP address of the NAS that is configured on the RADIUS server. A RADIUS server identifies a NAS by its IP address. Upon receiving a RADIUS packet, a RADIUS server checks whether the source IP address of the packet is the IP address of any managed NAS. If it is, the server processes the packet. If it is not, the server drops the packet.

The source IP address specified for outgoing RADIUS packets must be of the same IP version as the IP addresses of the RADIUS servers in the RADIUS scheme. Otherwise, the source IP address configuration does not take effect.

A RADIUS scheme can have only one source IP address for outgoing RADIUS packets. If you specify a new source IP address for the same RADIUS scheme, the new one overwrites the old one.

The setting configured by the nas-ip command in RADIUS scheme view is only for the RADIUS scheme, whereas that configured by the radius nas-ip command in system view is for all RADIUS schemes. The setting in RADIUS scheme view takes precedence.

Examples

# Set the source IP address for outgoing RADIUS packets to 10.1.1.1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] nas-ip 10.1.1.1

Related commands

radius nas-ip

primary accounting (RADIUS scheme view)

Use primary accounting to specify the primary RADIUS accounting server.

Use undo primary accounting to remove the configuration.

Syntax

primary accounting { ipv4-address | ipv6 ipv6-address } [ port-number | key [ cipher | simple ] key | probe username name [ interval interval ] ] *

undo primary accounting

Default

No primary RADIUS accounting server is specified.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

ipv4-address: Specifies the IPv4 address of the primary RADIUS accounting server.

ipv6 ipv6-address: Specifies the IPv6 address of the primary RADIUS accounting server, which must be a valid global unicast address.

port-number: Specifies the service port number of the primary RADIUS accounting server, a UDP port number ranging from 1 to 65535. The default setting is 1813.

key [ cipher | simple ] key: Specifies the shared key for secure communication with the primary RADIUS accounting server.

· cipher key: Specifies a ciphertext shared key, a case-sensitive ciphertext string of 1 to 117 characters.

· simple key: Specifies a plaintext shared key, a case-sensitive string of 1 to 64 characters.

· If neither cipher nor simple is specified, you set a plaintext shared key string.

probe: Enables the device to detect the status of the primary RADIUS accounting server.

username name: Specifies the username in the accounting request for server status detection.

interval interval: Specifies the detection interval. The value range for the interval argument is 1 to 3600, in minutes. The default setting is 10 minutes.

Usage guidelines

Make sure the port number and shared key settings of the primary RADIUS accounting server are the same as those configured on the server.

The IP addresses of the accounting servers and those of the authentication/authorization servers must be of the same IP version.

The IP addresses of the primary and secondary accounting servers must be different from each other. Otherwise, the configuration fails.

The shared key configured by this command takes precedence over that configured by using the key accounting [ cipher | simple ] key command.

If you change the primary accounting server when the device has already sent a start-accounting request to the server, the communication with the primary server times out, and the device looks for a server in active state from the new primary server on.

If you remove an accounting server being used by users, the device can no longer send real-time accounting requests or stop-accounting requests for the users, and it does not buffer the stop-accounting requests.

For secrecy, all shared keys, including keys configured in plain text, are saved in cipher text.

With the server status detection feature enabled, the device sends an accounting request that carries the specified username to the primary server at the specified interval. If the device receives no response from the server within the time interval specified by the timer response-timeout command, the device sends the request again.

If the maximum number of retries (specified by the retry command) is reached and the device still receives no response from the server, the device considers the server as unreachable. If the device receives a response from the server before the maximum number of retries is reached, the device considers the server as reachable. The device sets the status of the server to block or active according to the status detection result, regardless of the current status of the server.

To ensure that the device can set the server to its actual status, set a longer quiet timer for the primary server by using the timer quiet command.

Examples

# For RADIUS scheme radius1, set the IP address of the primary accounting server to 10.110.1.2, the UDP port to 1813, and the shared key to hello in plain text.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] primary accounting 10.110.1.2 1813 key simple hello

Related commands

key

primary authentication (RADIUS scheme view)

Use primary authentication to specify the primary RADIUS authentication/authorization server.

Use undo primary authentication to remove the configuration.

Syntax

primary authentication { ipv4-address | ipv6 ipv6-address } [ port-number | key [ cipher | simple ] key | probe username name [ interval interval ] ] *

undo primary authentication

Default

No primary RADIUS authentication/authorization server is specified.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

ipv4-address: Specifies the IPv4 address of the primary RADIUS authentication/authorization server.

ipv6 ipv6-address: Specifies the IPv6 address of the primary RADIUS authentication/authorization server, which must be a valid global unicast address.

port-number: Specifies the service port number of the primary RADIUS authentication/authorization server, a UDP port number ranging from 1 to 65535. The default setting is 1812.

key [ cipher | simple ] key: Specifies the shared key for secure communication with the primary RADIUS authentication/authorization server.

· cipher key: Specifies a ciphertext shared key, a case-sensitive ciphertext string of 1 to 117 characters.

· simple key: Specifies a plaintext shared key, a case-sensitive string of 1 to 64 characters.

· If neither cipher nor simple is specified, you set a plaintext shared key string.

probe: Enables the device to detect the status of the primary RADIUS authentication/authorization server.

username name: Specifies the username in the authentication request for server status detection.

interval interval: Specifies the detection interval. The value ranges from 1 to 3600, in minutes. The default setting is 10 minutes.

Usage guidelines

Make sure the port number and shared key settings of the primary RADIUS authentication/authorization server are the same as those configured on the server.

The shared key configured by this command takes precedence over that configured by using the key authentication [ cipher | simple ] key command.

The IP addresses of the authentication/authorization servers and those of the accounting servers must be of the same IP version.

The IP addresses of the primary and secondary authentication/authorization servers must be different from each other. Otherwise, the configuration fails.

If you remove the primary authentication server when an authentication process is in progress, the communication with the primary server times out, and the device looks for a server in active state from the new primary server on.

For secrecy, all shared keys, including keys configured in plain text, are saved in cipher text.

With the server status detection feature enabled, the device sends an authentication request that carries the specified username to the primary server at the specified interval. If the device receives no response from the server within the time interval specified by the timer response-timeout command, the device sends the authentication request again.

To ensure that the device can set the server to its actual status, set a longer quiet timer for the primary server with the timer quiet command.

Examples

# For RADIUS scheme radius1, set the IP address of the primary authentication/authorization server to 10.110.1.1, the UDP port to 1812, and the shared key to hello in plain text.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] primary authentication 10.110.1.1 1812 key hello

# In RADIUS scheme radius1, set the username used for status detection of the primary authentication/authorization server to test, and set the server status detection interval to 120 minutes.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] primary authentication 10.110.1.1 probe username test interval 120

Related commands

key

radius client

Use radius client enable to enable the RADIUS client service.

Use undo radius client to disable the RADIUS client service.

Syntax

radius client enable

undo radius client

Default

The RADIUS client service is enabled.

Views

System view

Default command level

2: System level

Usage guidelines

When the RADIUS client service is disabled, the following events occur:

· No more stop-accounting requests of online users can be sent out or buffered, and the RADIUS server can no longer receive logoff requests from online users. After a user goes offline, the RADIUS server still has the user's record during a certain period of time.

· The buffered accounting packets cannot be sent out and are deleted from the buffer when the configured maximum number of attempts is reached, affecting the precision of user accounting.

· If local authentication, authorization, or accounting is configured as the backup, the device performs local authentication, authorization, or accounting instead after the RADIUS request fails. Local accounting is only for monitoring and controlling the number of local user connections. It does not provide the statistics function that the accounting feature generally provides.

Examples

# Enable the RADIUS client service.

<Sysname> system-view

[Sysname] radius client enable

radius nas-ip

Use radius nas-ip to specify a source address for outgoing RADIUS packets.

Use undo radius nas-ip to remove the configuration.

Syntax

radius nas-ip { ipv4-address | ipv6 ipv6-address }

undo radius nas-ip { ipv4-address | ipv6 ipv6-address }

Default

The source IP address of an outgoing RADIUS packet is the IP address of the outbound interface.

Views

System view

Default command level

2: System level

Parameters

ipv4-address: IPv4 address in dotted decimal notation. It must be an address of the device and cannot be 0.0.0.0, 255.255.255.255, a class D address, or a class E address.

ipv6 ipv6-address: Specifies an IPv6 address. It must be a unicast address of the device and cannot be a link-local address.

Usage guidelines

You can specify only one public-network source IP address. A newly specified public-network source IP address overwrites the previous one.

Examples

# Set the IP address for the device to use as the source address of the RADIUS packets to 129.10.10.1.

<Sysname> system-view

[Sysname] radius nas-ip 129.10.10.1

Related commands

nas-ip

radius scheme

Use radius scheme to create a RADIUS scheme and enter RADIUS scheme view.

Use undo radius scheme to delete a RADIUS scheme.

Syntax

radius scheme radius-scheme-name

undo radius scheme radius-scheme-name

Default

No RADIUS scheme is defined.

Views

System view

Default command level

3: Manage level

Parameters

radius-scheme-name: RADIUS scheme name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

A RADIUS scheme can be referenced by more than one ISP domain at the same time.

A RADIUS scheme referenced by ISP domains cannot be removed.

Examples

# Create a RADIUS scheme named radius1 and enter RADIUS scheme view.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1]

Related commands

display radius scheme

radius trap

Use radius trap to enable the trap function for RADIUS.

Use undo radius trap to disable the trap function for RADIUS.

Syntax

radius trap { accounting-server-down | authentication-error-threshold | authentication-server-down }

undo radius trap { accounting-server-down | authentication-error-threshold | authentication-server-down }

Default

The trap function is disabled for RADIUS.

Views

System view

Default command level

2: System level

Parameters

accounting-server-down: Sends traps when the reachability of the accounting server changes.

authentication-error-threshold: Sends traps when the number of authentication failures exceeds the specified threshold. The threshold is represented by the ratio of the number of failed request transmission attempts to the total number of transmission attempts. It ranges from 1 to 100 and defaults to 30. This threshold can only be configured through the MIB.

authentication-server-down: Sends traps when the reachability of the authentication server changes.

Usage guidelines

With the trap function for RADIUS, a NAS sends a trap message in the following cases:

· When the status of a RADIUS server changes. If a NAS sends a request but receives no response before the maximum number of attempts is exceeded, it places the server to the blocked state and sends a trap message. If a NAS receives a response from a RADIUS server it considered unreachable, it considers that the RADIUS server is reachable again and also sends a trap message.

· When the ratio of the number of failed transmission attempts to the total number of authentication request transmission attempts reaches the threshold.

Examples

# Enable the device to send traps in response to accounting server reachability changes.

<Sysname> system-view

[Sysname] radius trap accounting-server-down

reset radius statistics

Use reset radius statistics to clear RADIUS statistics.

Syntax

reset radius statistics

Views

User view

Default command level

2: System level

Examples

# Clear RADIUS statistics.

<Sysname> reset radius statistics

Related commands

display radius statistics

reset stop-accounting-buffer (for RADIUS)

Use reset stop-accounting-buffer to clear buffered stop-accounting requests for which no responses have been received.

Syntax

reset stop-accounting-buffer { radius-scheme radius-scheme-name | session-id session-id | time-range start-time stop-time | user-name user-name }

Views

User view

Default command level

2: System level

Parameters

session-id session-id: Specifies the stop-accounting requests buffered for a session. The session ID is a string of 1 to 50 characters.

time-range start-time stop-time: Specifies the stop-accounting requests buffered in a time range. The start time and end time must be in the format HH:MM:SS-MM/DD/YYYY or HH:MM:SS-YYYY/MM/DD.

Examples

# Clear the stop-accounting requests buffered for user user0001@test.

<Sysname> reset stop-accounting-buffer user-name user0001@test

# Clear the stop-accounting requests buffered in the time range from 0:0:0 to 23:59:59 on August 31, 2006.

<Sysname> reset stop-accounting-buffer time-range 0:0:0-08/31/2006 23:59:59-08/31/2006

Related commands

· stop-accounting-buffer enable

· display stop-accounting-buffer

retry

Use retry to set the maximum number of attempts for transmitting a RADIUS packet to a single RADIUS server.

Use undo retry to restore the default.

Syntax

retry retry-times

undo retry

Default

The maximum number of RADIUS packet transmission attempts is 3.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

retry-times: Maximum number of RADIUS packet transmission attempts, ranging from 1 to 20.

Usage guidelines

Because RADIUS uses UDP packets to transmit data, the communication is not reliable. If the device does not receive a response to its request from the RADIUS server within the response timeout period, it retransmits the RADIUS request. If the number of transmission attempts exceeds the limit but the device still receives no response from the RADIUS server, the device considers the request a failure.

The maximum number of packet transmission attempts multiplied by the RADIUS server response timeout period cannot be greater than 75.

Examples

# Set the maximum number of RADIUS request transmission attempts to 5 for RADIUS scheme radius1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] retry 5

Related commands

· radius scheme

· timer response-timeout

retry realtime-accounting

Use retry realtime-accounting to set the maximum number of accounting attempts.

Use undo retry realtime-accounting to restore the default.

Syntax

retry realtime-accounting retry-times

undo retry realtime-accounting

Default

The maximum number of accounting attempts is 5.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

retry-times: Maximum number of accounting attempts, ranging from 1 to 255.

Usage guidelines

A RADIUS server usually checks whether a user is online by using a timeout timer. If it receives no real-time accounting request for a user in the timeout period from the NAS, it considers that there may be line or device failures and stops accounting for the user. This may happen when some unexpected failure occurs. To cooperate with this feature of the RADIUS server, the NAS must keep pace with the server in disconnecting the user. The maximum number of accounting attempts, together with some other parameters, enables the NAS to promptly disconnect the user.

The maximum number of accounting attempts, together with some other parameters, controls how the NAS sends accounting request packets.

Suppose that the RADIUS server response timeout period is 3 seconds (set with the timer response-timeout command), the maximum number of RADIUS packet transmission attempts is 3 (set with the retry command), the real-time accounting interval is 12 minutes (set with the timer realtime-accounting command), and the maximum number of accounting attempts is five (set with the retry realtime-accounting command). In this case, the device generates an accounting request every 12 minutes, and retransmits the request if it sends the request but receives no response within 3 seconds. If the device receives no response after transmitting the request three times, it considers the accounting attempt a failure, and it makes another accounting attempt. If five consecutive accounting attempts fail, the device cuts the user connection.

Examples

# Set the maximum number of accounting attempts to 10 for RADIUS scheme radius1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] retry realtime-accounting 10

Related commands

· retry

· timer response-timeout

· timer realtime-accounting

retry stop-accounting (RADIUS scheme view)

Use retry stop-accounting to set the maximum number of stop-accounting request transmission attempts.

Use undo retry stop-accounting to restore the default.

Syntax

retry stop-accounting retry-times

undo retry stop-accounting

Default

The maximum number of stop-accounting request transmission attempts is 500.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

retry-times: Maximum number of stop-accounting request transmission attempts, ranging from 10 to 65535.

Usage guidelines

The maximum number of stop-accounting request transmission attempts, together with some other parameters, controls how the NAS deals with stop-accounting request packets.

Suppose that the RADIUS server response timeout period is 3 seconds (set with the timer response-timeout command), the maximum number of transmission attempts is five (set with the retry command), and the maximum number of stop-accounting request transmission attempts is 20 (set with the retry stop-accounting command). For each stop-accounting request, if the device receives no response within 3 seconds, it retransmits the request. If it receives no responses after retransmitting the request five times, it considers the attempt a failure, buffers the request, and makes another attempt. If 20 consecutive attempts fail, the device discards the request.

Examples

# Set the maximum number of stop-accounting request transmission attempts to 1000 for RADIUS scheme radius1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] retry stop-accounting 1000

Related commands

· retry

· retry stop-accounting

· timer response-timeout

· display stop-accounting-buffer

secondary accounting (RADIUS scheme view)

Use secondary accounting to specify a secondary RADIUS accounting server.

Use undo secondary accounting to remove the configuration.

Syntax

secondary accounting { ipv4-address | ipv6 ipv6-address } [ port-number | key [ cipher | simple ] key | probe username name [ interval interval ] ] *

undo secondary accounting [ ipv4-address | ipv6 ipv6-address ]

Default

No secondary RADIUS accounting server is specified.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

ipv4-address: Specifies the IPv4 address of the secondary RADIUS accounting server.

ipv6 ipv6-address: Specifies the IPv6 address of the secondary RADIUS accounting server, which must be a valid global unicast address.

port-number: Specifies the service port number of the secondary RADIUS accounting server, a UDP port number ranging from 1 to 65535. The default setting is 1813.

key [ cipher | simple ] key: Specifies the shared key for secure communication with the secondary RADIUS accounting server.

· cipher key: Specifies a ciphertext shared key, a case-sensitive ciphertext string of 1 to 117 characters.

· simple key: Specifies a plaintext shared key, a case-sensitive string of 1 to 64 characters.

· If neither cipher nor simple is specified, you set a plaintext shared key string.

probe: Enables the device to detect the status of the secondary RADIUS accounting server.

username name: Specifies the username in the accounting request for server status detection.

interval interval: Specifies the detection interval. The value range for the interval argument is 1 to 3600, in minutes. The default setting is 10 minutes.

Usage guidelines

Make sure the port number and shared key settings of the secondary RADIUS accounting server are the same as those configured on the server.

You can configure up to 16 secondary RADIUS accounting servers for a RADIUS scheme by executing this command repeatedly. After the configuration, if the primary server fails, the device looks for a secondary server in active state (a secondary RADIUS accounting server configured earlier has a higher priority) and tries to communicate with it.

The IP addresses of the accounting servers and those of the authentication/authorization servers must be of the same IP version.

The IP addresses of the primary and secondary accounting servers must be different from each other. Otherwise, the configuration fails.

The shared key configured by this command takes precedence over that configured by using the key accounting [ cipher | simple ] key command.

If you remove a secondary accounting server when the device has already sent a start-accounting request to the server, the communication with the secondary server times out, and the device looks for a server in active state from the primary server on.

If you remove an accounting server being used by online users, the device can no longer send real-time accounting requests or stop-accounting requests for the users, and it does not buffer the stop-accounting requests.

For secrecy, all shared keys, including keys configured in plain text, are saved in cipher text.

With the server status detection feature enabled, the device sends an accounting request that carries the specified username to the secondary server at the specified interval. If the device receives no response from the server within the time interval specified by the timer response-timeout command, the device sends the request again.

To ensure that the device can set the server to its actual status, set a longer quiet timer for the secondary server by using the timer quiet command.

Examples

# For RADIUS scheme radius1, specify two secondary accounting servers with the server IP addresses of 10.110.1.1 and 10.110.1.2 and the UDP port number of 1813. Set the shared keys to hello in plain text.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] secondary accounting 10.110.1.1 1813 key hello

[Sysname-radius-radius1] secondary accounting 10.110.1.2 1813 key hello

# For RADIUS scheme radius2, set the IP address of the secondary accounting server to 10.110.1.1, the UDP port to 1813, and the shared key to $c$3$NMCbVjyIutaV6csCOGp4zsKRTlg2eT3B in cipher text.

<Sysname> system-view

[Sysname] radius scheme radius2

[Sysname-radius-radius2] secondary accounting 10.110.1.1 1813 key cipher $c$3$NMCbVjyIutaV6csCOGp4zsKRTlg2eT3B

Related commands

· key

· state

secondary authentication (RADIUS scheme view)

Use secondary authentication to specify a secondary RADIUS authentication/authorization server.

Use undo secondary authentication to remove the configuration.

Syntax

secondary authentication { ipv4-address | ipv6 ipv6-address } [ port-number | key [ cipher | simple ] key | probe username name [ interval interval ] ] *

undo secondary authentication [ ipv4-address | ipv6 ipv6-address ]

Default

No secondary RADIUS authentication/authorization server is specified.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

ipv4-address: Specifies the IPv4 address of the secondary RADIUS authentication/authorization server.

ipv6 ipv6-address: Specifies the IPv6 address of the secondary RADIUS authentication/authorization server, which must be a valid global unicast address.

port-number: Specifies the service port number of the secondary RADIUS authentication/authorization server, a UDP port number ranging from 1 to 65535. The default setting is 1812.

key [ cipher | simple ] key: Specifies the shared key for secure communication with the secondary RADIUS authentication/authorization server.

· cipher key: Specifies a ciphertext shared key, a case-sensitive ciphertext string of 1 to 117 characters.

· simple key: Specifies a plaintext shared key, a case-sensitive string of 1 to 64 characters.

· If neither cipher nor simple is specified, you set a plaintext shared key string.

probe: Enables the device to detect the status of the secondary RADIUS authentication/authorization server.

username name: Specifies the username in the authentication request for server status detection.

interval interval: Specifies the detection interval. The value ranges from 1 to 3600, in minutes. The default setting is 10 minutes.

Usage guidelines

Make sure the port number and shared key settings of the secondary RADIUS authentication/authorization server are the same as those configured on the server.

The shared key configured by this command takes precedence over that configured by using the key accounting [ cipher | simple ] key command.

You can configure up to 16 secondary RADIUS authentication/authorization servers for a RADIUS scheme by executing this command repeatedly. After the configuration, if the primary server fails, the device looks for a secondary server in active state (a secondary RADIUS authentication/authorization server configured earlier has a higher priority) and tries to communicate with it.

The IP addresses of the authentication/authorization servers and those of the accounting servers must be of the same IP version.

The IP addresses of the primary and secondary authentication/authorization servers must be different from each other. Otherwise, the configuration fails.

If you remove a secondary authentication server in use in the authentication process, the communication with the secondary server times out, and the device looks for a server in active state from the primary server on.

For secrecy, all shared keys, including keys configured in plain text, are saved in cipher text.

With the server status detection feature enabled, the device sends an authentication request that carries the specified username to the secondary server at the specified interval. If the device receives no response from the server within the time interval specified by the timer response-timeout command, the device sends the authentication request again.

To ensure that the device can set the server to its actual status, set a longer quiet timer for the secondary server with the timer quiet command.

Examples

# Specify two secondary authentication/authorization servers for RADIUS scheme radius1, with the server IP addresses of 10.110.1.1 and 10.110.1.2 and the UDP port number of 1813. Set the shared keys to hello in plain text.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] secondary authentication 10.110.1.1 1812 key simple hello

[Sysname-radius-radius1] secondary authentication 10.110.1.2 1812 key simple hello

# For RADIUS scheme radius2, set the IP address of the secondary authentication/authorization server to 10.110.1.2, the UDP port to 1812, and the shared key to $c$3$NMCbVjyIutaV6csCOGp4zsKRTlg2eT3B in cipher text.

<Sysname> system-view

[Sysname] radius scheme radius2

[Sysname-radius-radius2] secondary authentication 10.110.1.2 1812 key cipher $c$3$NMCbVjyIutaV6csCOGp4zsKRTlg2eT3B

# In RADIUS scheme radius1, set the username used for status detection of the secondary authentication/authorization server to test, and set the server status detection interval to 120 minutes.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] secondary authentication 10.110.1.1 probe username test interval 120

Related commands

· key

· state

security-policy-server

Use security-policy-server to specify a security policy server for a RADIUS scheme.

Use undo security-policy-server to remove one or all security policy servers for a RADIUS scheme.

Syntax

security-policy-server ip-address

undo security-policy-server { ip-address | all }

Default

No security policy server is specified for a RADIUS scheme.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

ip-address: Specifies a security policy server by its IP address.

all: Specifies all security policy servers.

Usage guidelines

You can specify up to eight security policy servers for a RADIUS scheme.

You can change security policy servers for a RADIUS scheme only when no user is using the scheme.

Examples

# Specify security policy server 10.110.1.2 for RADIUS scheme radius1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] security-policy-server 10.110.1.2

server-type

Use server-type to specify the RADIUS server type.

Use undo server-type to restore the default.

Syntax

server-type { extended | standard }

undo server-type

Default

The supported RADIUS server type is standard.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

extended: Specifies the extended RADIUS server (generally running on IMC), which requires the RADIUS client and RADIUS server to interact according to the procedures and packet formats provisioned by the proprietary RADIUS protocol.

standard: Specifies the standard RADIUS server, which requires the RADIUS client and RADIUS server to interact according to the procedures and packet format of the standard RADIUS protocol (RFC 2865 and 2866 or their successors).

Examples

# Configure the RADIUS server type of RADIUS scheme radius1 as standard.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] server-type standard

state primary

Use state primary to set the status of a primary RADIUS server.

Syntax

state primary { accounting | authentication } { active | block }

Default

The primary RADIUS server specified for a RADIUS scheme is in active state.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

accounting: Sets the status of the primary RADIUS accounting server.

authentication: Sets the status of the primary RADIUS authentication/authorization server.

active: Specifies the active state, the normal operation state.

block: Specifies the blocked state, the out-of-service state.

Usage guidelines

During an authentication or accounting process, the device first tries to communicate with the primary server if the primary server is in active state. If the primary server is unavailable, the device changes the status of the primary server to blocked, starts a quiet timer for the server, and then tries to communicate with a secondary server in active state (a secondary RADIUS server configured earlier has a higher priority). When the quiet timer of the primary server times out, the status of the server changes to active automatically. If you set the status of the server to blocked before the quiet timer times out, the status of the server cannot change back to active automatically unless you set the status to active manually.

When the primary server and secondary servers are both in blocked state, the device communicates with the primary server.

Examples

# Set the status of the primary server in RADIUS scheme radius1 to blocked.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] state primary authentication block

Related commands

· display radius scheme

· state secondary

state secondary

Use state secondary to set the status of a secondary RADIUS server.

Syntax

state secondary { accounting | authentication } [ ip ipv4-address | ipv6 ipv6-address ] { active | block }

Default

Every secondary RADIUS server specified in a RADIUS scheme is in active state.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

accounting: Sets the status of the secondary RADIUS accounting server.

authentication: Sets the status of the secondary RADIUS authentication/authorization server.

ip ipv4-address: Specifies the IPv4 address of the secondary RADIUS server.

ipv6 ipv6-address: Specifies the IPv6 address of the secondary RADIUS server.

active: Specifies the active state, the normal operation state.

block: Specifies the blocked state, the out-of-service state.

Usage guidelines

If no IP address is specified, this command changes the status of all configured secondary servers for authentication/authorization or accounting.

If the device finds that a secondary server in active state is unreachable, the device changes the status of the secondary server to blocked, starts a quiet timer for the server, and continues to try to communicate with the next secondary server in active state (a secondary RADIUS server configured earlier has a higher priority). When the quiet timer of a server times out, the status of the server changes to active automatically. If you set the status of the server to blocked before the quiet timer times out, the status of the server cannot change back to active automatically unless you set the status to active manually. If all configured secondary servers are unreachable, the device considers the authentication or accounting attempt a failure.

Examples

# Set the status of all secondary servers in RADIUS scheme radius1 to blocked.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] state secondary authentication block

Related commands

· display radius scheme

· state primary

stop-accounting-buffer enable (RADIUS scheme view)

Use stop-accounting-buffer enable to enable the device to buffer stop-accounting requests to which no responses are received.

Use undo stop-accounting-buffer enable to disable the buffering function.

Syntax

stop-accounting-buffer enable

undo stop-accounting-buffer enable

Default

The device buffers stop-accounting requests to which no responses are received.

Views

RADIUS scheme view

Default command level

2: System level

Usage guidelines

Stop-accounting requests affect the charge to users. A NAS must make its best effort to send every stop-accounting request to the RADIUS accounting servers. For each stop-accounting request that receives no response in the specified period of time, the NAS buffers and resends the packet until it receives a response or the number of transmission attempts reaches the configured limit. In the latter case, the NAS discards the packet. However, if you have removed the accounting server, stop-accounting messages are not buffered.

Examples

# Enable the device to buffer the stop-accounting requests to which no responses are received.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] stop-accounting-buffer enable

Related commands

· reset stop-accounting-buffer

· display stop-accounting-buffer

timer quiet (RADIUS scheme view)

Use timer quiet to set the quiet timer for servers.

Use undo timer quiet to restore the default.

Syntax

timer quiet minutes

undo timer quiet

Default

The server quiet period is 5 minutes.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

minutes: Server quiet period in minutes, ranging from 0 to 255. If you set this argument to 0, when the device attempts to send an authentication or accounting request but the current server is unreachable, the device sends the request to the next server in active state, without changing the current server's status. As a result, when the device attempts to send a request of the same type for another user, it still tries to send the request to the current server because the current server is in active state.

Usage guidelines

The quiet timer controls whether the device changes the status of an unreachable server from active to blocked and how long the device keeps an unreachable server in blocked state.

If you determine that the primary server is unreachable because the device's port connected to the server is out of service temporarily or the server is busy, you can set the server quiet period to 0 so that the device uses the primary server whenever possible.

Be sure to set the server quiet timer properly. Too short a quiet timer may result in frequent authentication or accounting failures because the device has to repeatedly try to communicate with an unreachable server that is in active state.

Examples

# Set the quiet timer for the servers to 10 minutes.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] timer quiet 10

Related commands

display radius scheme

timer realtime-accounting

Use timer realtime-accounting to set the real-time accounting interval.

Use undo timer realtime-accounting to restore the default.

Syntax

timer realtime-accounting minutes

undo timer realtime-accounting

Default

The real-time accounting interval is 12 minutes.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

minutes: Real-time accounting interval in minutes. The value can be 0 or a multiple of 3, ranging from 3 to 60.

Usage guidelines

For real-time accounting, a NAS must transmit the accounting information of online users to the RADIUS accounting server periodically. This command sets the interval.

When the real-time accounting interval on the device is 0, the device sends online user accounting information to the RADIUS accounting server at the real-time accounting interval configured on the server, or does not send online user accounting information.

Different real-time accounting intervals impose different performance requirements on the NAS and the RADIUS server. A shorter interval helps achieve higher accounting precision but requires higher performance. Use a longer interval when there are a large number of users (1000 or more).

Number of users	Real-time accounting interval (in minutes)
1 to 99	3
100 to 499	6
500 to 999	12
1000 or more	15 or longer

Examples

# Set the real-time accounting interval to 51 minutes for RADIUS scheme radius1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] timer realtime-accounting 51

Related commands

retry realtime-accounting

timer response-timeout (RADIUS scheme view)

Use timer response-timeout to set the RADIUS server response timeout timer.

Use undo timer response-timeout to restore the default.

Syntax

timer response-timeout seconds

undo timer response-timeout

Default

The RADIUS server response timeout period is 3 seconds.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

seconds: RADIUS server response timeout period in seconds, ranging from 1 to 10.

Usage guidelines

If a NAS receives no response from the RADIUS server in a period of time after sending a RADIUS request (authentication/authorization or accounting request), it resends the request so that the user has more opportunity to obtain the RADIUS service. The NAS uses the RADIUS server response timeout timer to control the transmission interval.

The maximum number of RADIUS packet transmission attempts multiplied by the RADIUS server response timeout period cannot be greater than 75.

Examples

# Set the RADIUS server response timeout timer to 5 seconds for RADIUS scheme radius1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] timer response-timeout 5

Related commands

retry

user-name-format (RADIUS scheme view)

Use user-name-format to specify the format of the username to be sent to a RADIUS server.

Syntax

user-name-format { keep-original | with-domain | without-domain }

Default

The ISP domain name is included in the username.

Views

RADIUS scheme view

Default command level

2: System level

Parameters

keep-original: Sends the username to the RADIUS server as it is entered.

with-domain: Includes the ISP domain name in the username sent to the RADIUS server.

without-domain: Excludes the ISP domain name from the username sent to the RADIUS server.

Usage guidelines

A username is generally in the format userid@isp-name, of which isp-name is used by the device to determine the ISP domain to which a user belongs. Some earlier RADIUS servers, however, cannot recognize a username including an ISP domain name. Before sending a username including a domain name to such a RADIUS server, the device must remove the domain name. This command allows you to specify whether to include a domain name in a username to be sent to a RADIUS server.

If a RADIUS scheme defines that the username is sent without the ISP domain name, do not apply the RADIUS scheme to more than one ISP domain, avoiding the confused situation where the RADIUS server regards two users in different ISP domains but with the same userid as one.

For 802.1X users using EAP authentication, the user-name-format command configured for a RADIUS scheme does not take effect and the device does not change the usernames from clients before forwarding them to the RADIUS server.

If the RADIUS scheme is used for roaming wireless users, specify the keep-original keyword. Otherwise, authentication of the wireless users may fail.

Examples

# Specify the device to remove the domain name in the username sent to the RADIUS servers for the RADIUS scheme radius1.

<Sysname> system-view

[Sysname] radius scheme radius1

[Sysname-radius-radius1] user-name-format without-domain

Related commands

radius scheme

HWTACACS configuration commands

data-flow-format (HWTACACS scheme view)

Use data-flow-format to set the traffic statistics unit for data flows or packets.

Use undo data-flow-format to restore the default.

Syntax

data-flow-format { data { byte | giga-byte | kilo-byte | mega-byte } | packet { giga-packet | kilo-packet | mega-packet | one-packet } } *

undo data-flow-format { data | packet }

Default

The unit for data flows is byte and that for data packets is one-packet.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

data { byte | giga-byte | kilo-byte | mega-byte }: Specifies the unit for data flows, which can be byte, kilobyte, megabyte, or gigabyte.

packet { giga-packet | kilo-packet | mega-packet | one-packet }: Specifies the unit for data packets, which can be one-packet, kilo-packet, mega-packet, or giga-packet.

Usage guidelines

The unit for data flows and that for packets must be consistent with those on the HWTACACS server. Otherwise, accounting cannot be performed correctly.

Examples

# Set the traffic statistics unit for data flows and that for packets to kilobytes and kilo-packets, respectively, in HWTACACS scheme hwt1.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] data-flow-format data kilo-byte packet kilo-packet

Related commands

display hwtacacs

Use display hwtacacs to display the configuration of HWTACACS schemes or the statistics for the HWTACACS servers specified in HWTACACS schemes.

Syntax

display hwtacacs [ hwtacacs-scheme-name [ statistics ] ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

hwtacacs-scheme-name: HWTACACS scheme name.

statistics: Displays the statistics for the HWTACACS servers specified in the HWTACACS scheme. Without this keyword, the command displays the configuration of the HWTACACS scheme.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If no HWTACACS scheme is specified, the command displays the configuration of all HWTACACS schemes.

Examples

# Display the configuration of HWTACACS scheme gy.

<Sysname> display hwtacacs gy

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

HWTACACS-server template name : gy

Primary-authentication-server : 172.31.1.11:49

Primary-authorization-server : 172.31.1.11:49

Primary-accounting-server : 172.31.1.11:49

Secondary-authentication-server : 0.0.0.0:0

Secondary-authorization-server : 0.0.0.0:0

Secondary-accounting-server : 0.0.0.0:0

Current-authentication-server : 172.31.1.11:49

Current-authorization-server : 172.31.1.11:49

Current-accounting-server : 172.31.1.11:49

NAS-IP-address : 0.0.0.0

key authentication : ******

key authorization : ******

key accounting : ******

Quiet-interval(min) : 5

Realtime-accounting-interval(min) : 12

Response-timeout-interval(sec) : 5

Acct-stop-PKT retransmit times : 100

Username format : with-domain

Data traffic-unit : B

Packet traffic-unit : one-packet

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

Table 8 Command output

Field	Description
HWTACACS-server template name	Name of the HWTACACS scheme.
Primary-authentication-server	IP address and port number of the primary authentication server. If no primary authentication server is specified, this field displays 0.0.0.0:0. This rule also applies to the following eight fields.
Primary-authorization-server	IP address and port number of the primary authorization server.
Primary-accounting-server	IP address and port number of the primary accounting server.
Secondary-authentication-server	IP address and port number of the secondary authentication server.
Secondary-authorization-server	IP address and port number of the secondary authorization server.
Secondary-accounting-server	IP address and port number of the secondary accounting server.
Current-authentication-server	IP address and port number of the currently used authentication server.
Current-authorization-server	IP address and port number of the currently used authorization server.
Current-accounting-server	IP address and port number of the currently used accounting server.
NAS-IP-address	IP address of the NAS. If no NAS is specified, this field displays 0.0.0.0.
key authentication	Key for authentication, displayed as a series of asterisks (******). If no key is configured, this field displays N/A.
key authorization	Key for authorization, displayed as a series of asterisks (******). If no key is configured, this field displays N/A.
key accounting	Key for accounting, displayed as a series of asterisks (******). If no key is configured, this field displays N/A.
Realtime-accounting-interval	Realtime accounting interval. The device does not support HWTACACS realtime accounting in the current version.
Acct-stop-PKT retransmit times	Number of stop-accounting packet transmission attempts.
Data traffic-unit	Unit for data flows.
Packet traffic-unit	Unit for data packets.

# Display the statistics for the servers specified in HWTACACS scheme gy.

<Sysname> display hwtacacs gy statistics

---[HWTACACS template gy primary authentication]---

HWTACACS server open number: 10

HWTACACS server close number: 10

HWTACACS authen client access request packet number: 10

HWTACACS authen client access response packet number: 6

HWTACACS authen client unknown type number: 0

HWTACACS authen client timeout number: 4

HWTACACS authen client packet dropped number: 4

HWTACACS authen client access request change password number: 0

HWTACACS authen client access request login number: 5

HWTACACS authen client access request send authentication number: 0

HWTACACS authen client access request send password number: 0

HWTACACS authen client access connect abort number: 0

HWTACACS authen client access connect packet number: 5

HWTACACS authen client access response error number: 0

HWTACACS authen client access response failure number: 0

HWTACACS authen client access response follow number: 0

HWTACACS authen client access response getdata number: 0

HWTACACS authen client access response getpassword number: 5

HWTACACS authen client access response getuser number: 0

HWTACACS authen client access response pass number: 1

HWTACACS authen client access response restart number: 0

HWTACACS authen client malformed access response number: 0

HWTACACS authen client round trip time(s): 5

---[HWTACACS template gy primary authorization]---

HWTACACS server open number: 1

HWTACACS server close number: 1

HWTACACS author client request packet number: 1

HWTACACS author client response packet number: 1

HWTACACS author client timeout number: 0

HWTACACS author client packet dropped number: 0

HWTACACS author client unknown type number: 0

HWTACACS author client request EXEC number: 1

HWTACACS author client request PPP number: 0

HWTACACS author client request VPDN number: 0

HWTACACS author client response error number: 0

HWTACACS author client response EXEC number: 1

HWTACACS author client response PPP number: 0

HWTACACS author client response VPDN number: 0

HWTACACS author client round trip time(s): 3

---[HWTACACS template gy primary accounting]---

HWTACACS server open number: 0

HWTACACS server close number: 0

HWTACACS account client request packet number: 0

HWTACACS account client response packet number: 0

HWTACACS account client unknown type number: 0

HWTACACS account client timeout number: 0

HWTACACS account client packet dropped number: 0

HWTACACS account client request command level number: 0

HWTACACS account client request connection number: 0

HWTACACS account client request EXEC number: 0

HWTACACS account client request network number: 0

HWTACACS account client request system event number: 0

HWTACACS account client request update number: 0

HWTACACS account client response error number: 0

HWTACACS account client round trip time(s): 0

Related commands

hwtacacs scheme

display stop-accounting-buffer (for HWTACACS)

Use display stop-accounting-buffer to display information about buffered stop-accounting requests.

Syntax

display stop-accounting-buffer hwtacacs-scheme hwtacacs-scheme-name [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

hwtacacs-scheme hwtacacs-scheme-name: Specifies buffered stop-accounting requests that are destined for the accounting server defined in an HWTACACS scheme. The HWTACACS scheme name is a case-insensitive string of 1 to 32 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display information about stop-accounting requests buffered for HWTACACS scheme hwt1.

<Sysname> display stop-accounting-buffer hwtacacs-scheme hwt1

Total 0 record(s) Matched

Related commands

· reset stop-accounting-buffer

· stop-accounting-buffer enable

· retry stop-accounting

hwtacacs nas-ip

Use hwtacacs nas-ip to specify a source IP address for outgoing HWTACACS packets.

Use undo hwtacacs nas-ip to remove the configuration.

Syntax

hwtacacs nas-ip ip-address

undo hwtacacs nas-ip ip-address

Default

The source IP address of a packet sent to the server is the IP address of the outbound interface.

Views

System view

Default command level

2: System level

Parameters

ip-address: IP address in dotted decimal notation. It must be an address of the device and cannot be 0.0.0.0, 255.255.255.255, a class D address, or a class E address.

Usage guidelines

The source IP address of HWTACACS packets that a NAS sends must match the IP address of the NAS that is configured on the HWTACACS server. An HWTACACS server identifies a NAS by IP address. Upon receiving an HWTACACS packet, an HWTACACS server checks whether the source IP address of the packet is the IP address of any managed NAS. If it is, the server processes the packet. If it is not, the server drops the packet.

You can specify only one public-network source IP address. A newly specified public-network source IP address overwrites the previous one.

The setting configured by the nas-ip command in HWTACACS scheme view is only for the HWTACACS scheme, whereas that configured by the hwtacacs nas-ip command in system view is for all HWTACACS schemes. The setting in HWTACACS scheme view takes precedence.

Examples

# Set the IP address for the device to use as the source address of the HWTACACS packets to 129.10.10.1.

<Sysname> system-view

[Sysname] hwtacacs nas-ip 129.10.10.1

Related commands

nas-ip

hwtacacs scheme

Use hwtacacs scheme to create an HWTACACS scheme and enter HWTACACS scheme view.

Use undo hwtacacs scheme to delete an HWTACACS scheme.

Syntax

hwtacacs scheme hwtacacs-scheme-name

undo hwtacacs scheme hwtacacs-scheme-name

Default

No HWTACACS scheme exists.

Views

System view

Default command level

3: Manage level

Parameters

hwtacacs-scheme-name: HWTACACS scheme name, a case-insensitive string of 1 to 32 characters.

Usage guidelines

An HWTACACS scheme can be referenced by more than one ISP domain at the same time.

An HWTACACS scheme referenced by ISP domains cannot be removed.

Examples

# Create an HWTACACS scheme named hwt1, and enter HWTACACS scheme view.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1]

key (HWTACACS scheme view)

Use key to set the shared key for secure HWTACACS authentication, authorization, or accounting communication.

Use undo key to remove the configuration.

Syntax

key { accounting | authentication | authorization } [ cipher | simple ] key

undo key { accounting | authentication | authorization }

Default

No shared key is configured.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

accounting: Sets the shared key for secure HWTACACS accounting communication.

authentication: Sets the shared key for secure HWTACACS authentication communication.

authorization: Sets the shared key for secure HWTACACS authorization communication.

cipher: Sets a ciphertext shared key.

simple: Sets a plaintext shared key.

key: Specifies the shared key string. This argument is case sensitive. If simple is specified, it must be a string of 1 to 255 characters. If cipher is specified, it must be a ciphertext string of 1 to 373 characters. If neither cipher nor simple is specified, you set a plaintext shared key string.

Usage guidelines

The shared keys configured on the device must match those configured on the HWTACACS servers.

For secrecy, all shared keys, including keys configured in plain text, are saved in cipher text.

Examples

# Set the shared key for secure HWTACACS accounting communication to hello in plain text for HWTACACS scheme hwt1.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] key accounting simple hello

# Set the shared key for secure HWTACACS accounting communication to hello in plain text for HWTACACS scheme hwt1.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] key accounting hello

# Set the shared key for secure HWTACACS accounting communication to $c$3$jaeN0ej15fjuHKeuVh8mqicHzaHdMw== in cipher text for HWTACACS scheme hwt1.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] key accounting cipher $c$3$jaeN0ej15fjuHKeuVh8mqicHzaHdMw==

Related commands

display hwtacacs

nas-ip (HWTACACS scheme view)

Use nas-ip to specify a source IP address for outgoing HWTACACS packets.

Use undo nas-ip to restore the default.

Syntax

nas-ip ip-address

undo nas-ip

Default

The source IP address of an outgoing HWTACACS packet is configured by the hwtacacs nas-ip command in system view. If the hwtacacs nas-ip command is not configured, the source IP address is the IP address of the outbound interface.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

ip-address: IP address in dotted decimal notation. It must be an address of the device and cannot be 0.0.0.0, 255.255.255.255, a class D address, or a class E address.

Usage guidelines

If you configure the command repeatedly, only the last configuration takes effect.

Examples

# Set the source address for outgoing HWTACACS packets to 10.1.1.1.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] nas-ip 10.1.1.1

Related commands

hwtacacs nas-ip

primary accounting (HWTACACS scheme view)

Use primary accounting to specify the primary HWTACACS accounting server.

Use undo primary accounting to remove the configuration.

Syntax

primary accounting ip-address [ port-number ]

undo primary accounting

Default

No primary HWTACACS accounting server is specified.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

ip-address: IP address of the primary HWTACACS accounting server in dotted decimal notation. The default is 0.0.0.0.

port-number: Service port number of the primary HWTACACS accounting server. It ranges from 1 to 65535 and defaults to 49.

Usage guidelines

The IP addresses of the primary and secondary accounting servers must be different. Otherwise, the configuration fails.

If you configure the command repeatedly, only the last configuration takes effect.

You can remove an accounting server only when it is not used by any active TCP connection to send accounting packets. Removing an accounting server only affects accounting processes that occur after the remove operation.

Examples

# Specify the IP address and port number of the primary accounting server for HWTACACS scheme test1 as 10.163.155.12 and 49.

<Sysname> system-view

[Sysname] hwtacacs scheme test1

[Sysname-hwtacacs-test1] primary accounting 10.163.155.12 49

Related commands

display hwtacacs

primary authentication (HWTACACS scheme view)

Use primary authentication to specify the primary HWTACACS authentication server.

Use undo primary authentication to remove the configuration.

Syntax

primary authentication ip-address [ port-number ]

undo primary authentication

Default

No primary HWTACACS authentication server is specified.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

ip-address: IP address of the primary HWTACACS authentication server in dotted decimal notation. The default is 0.0.0.0.

port-number: Service port number of the primary HWTACACS authentication server. It ranges from 1 to 65535 and defaults to 49.

Usage guidelines

The IP addresses of the primary and secondary authentication servers must be different. Otherwise, the configuration fails.

If you configure the command repeatedly, only the last configuration takes effect.

You can remove an authentication server only when it is not used by any active TCP connection to send authentication packets. Removing an authentication server only affects authentication processes that occur after the remove operation.

Examples

# Specify the IP address and port number of the primary authentication server for HWTACACS scheme hwt1 as 10.163.155.13 and 49.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] primary authentication 10.163.155.13 49

Related commands

display hwtacacs

primary authorization

Use primary authorization to specify the primary HWTACACS authorization server.

Use undo primary authorization to remove the configuration.

Syntax

primary authorization ip-address [ port-number ]

undo primary authorization

Default

No primary HWTACACS authorization server is specified.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

ip-address: IP address of the primary HWTACACS authorization server in dotted decimal notation. The default is 0.0.0.0.

port-number: Service port number of the primary HWTACACS authorization server. It ranges from 1 to 65535 and defaults to 49.

Usage guidelines

The IP addresses of the primary and secondary authorization servers must be different. Otherwise, the configuration fails.

If you configure the command repeatedly, only the last configuration takes effect.

You can remove an authorization server only when it is not used by any active TCP connection to send authorization packets. Removing an authorization server only affects authorization processes that occur after the remove operation.

Examples

# Configure the IP address and port number of the primary authorization server for HWTACACS scheme hwt1 as 10.163.155.13 and 49.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] primary authorization 10.163.155.13 49

Related commands

display hwtacacs

reset hwtacacs statistics

Use reset hwtacacs statistics to clear HWTACACS statistics.

Syntax

reset hwtacacs statistics { accounting | all | authentication | authorization }

Views

User view

Default command level

1: Monitor level

Parameters

accounting: Specifies the HWTACACS accounting statistics.

all: Specifies all HWTACACS statistics.

authentication: Specifies the HWTACACS authentication statistics.

authorization: Specifies the HWTACACS authorization statistics.

Examples

# Clear all HWTACACS statistics.

<Sysname> reset hwtacacs statistics all

Related commands

display hwtacacs

reset stop-accounting-buffer (for HWTACACS)

Use reset stop-accounting-buffer to clear the buffered stop-accounting requests for which no responses have been received.

Syntax

reset stop-accounting-buffer hwtacacs-scheme hwtacacs-scheme-name

Views

User view

Default command level

2: System level

Parameters

Examples

# Clear the stop-accounting requests buffered for HWTACACS scheme hwt1.

<Sysname> reset stop-accounting-buffer hwtacacs-scheme hwt1

Related commands

· stop-accounting-buffer enable

· display stop-accounting-buffer

retry stop-accounting (HWTACACS scheme view)

Use retry stop-accounting to set the maximum number of stop-accounting request transmission attempts.

Use undo retry stop-accounting to restore the default.

Syntax

retry stop-accounting retry-times

undo retry stop-accounting

Default

The maximum number of stop-accounting request transmission attempts is 100.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

retry-times: Maximum number of stop-accounting request transmission attempts, ranging from 1 to 300.

Examples

# Set the maximum number of stop-accounting request transmission attempts to 50 for HWTACACS scheme hwt1.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] retry stop-accounting 50

Related commands

· reset stop-accounting-buffer

· display stop-accounting-buffer

secondary accounting (HWTACACS scheme view)

Use secondary accounting to specify a secondary HWTACACS accounting server.

Use undo secondary accounting to remove the configuration.

Syntax

secondary accounting ip-address [ port-number ]

undo secondary accounting

Default

No secondary HWTACACS accounting server is specified.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

ip-address: IP address of the secondary HWTACACS accounting server in dotted decimal notation. The default is 0.0.0.0.

port-number: Service port number of the secondary HWTACACS accounting server. It ranges from 1 to 65535 and defaults to 49.

Usage guidelines

The IP addresses of the primary and secondary accounting servers must be different. Otherwise, the configuration fails.

If you configure the command repeatedly, only the last configuration takes effect.

Examples

# Specify the IP address and port number of the secondary accounting server for HWTACACS scheme hwt1 as 10.163.155.12 with TCP port number 49.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] secondary accounting 10.163.155.12 49

Related commands

display hwtacacs

secondary authentication (HWTACACS scheme view)

Use secondary authentication to specify a secondary HWTACACS authentication server.

Use undo secondary authentication to remove the configuration.

Syntax

secondary authentication ip-address [ port-number ]

undo secondary authentication

Default

No secondary HWTACACS authentication server is specified.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

ip-address: IP address of the secondary HWTACACS authentication server in dotted decimal notation. The default is 0.0.0.0.

port-number: Service port number of the secondary HWTACACS authentication server. It ranges from 1 to 65535 and defaults to 49.

Usage guidelines

The IP addresses of the primary and secondary authentication servers must be different. Otherwise, the configuration fails.

If you configure the command repeatedly, only the last configuration takes effect.

You can remove an authentication server only when it is not used by any active TCP connection to send authentication packets is using it. Removing an authentication server only affects authentication processes that occur after the remove operation.

Examples

# Specify the IP address and port number of the secondary authentication server for HWTACACS scheme hwt1 as 10.163.155.13 with TCP port number 49.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] secondary authentication 10.163.155.13 49

Related commands

display hwtacacs

secondary authorization

Use secondary authorization to specify a secondary HWTACACS authorization server.

Use undo secondary authorization to remove the configuration.

Syntax

secondary authorization ip-address [ port-number ]

undo secondary authorization

Default

No secondary HWTACACS authorization server is specified.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

ip-address: IP address of the secondary HWTACACS authorization server in dotted decimal notation. The default is 0.0.0.0.

port-number: Service port number of the secondary HWTACACS authorization server. It ranges from 1 to 65535 and defaults to 49.

Usage guidelines

The IP addresses of the primary and secondary authorization servers cannot be the same. Otherwise, the configuration fails.

If you configure the command repeatedly, only the last configuration takes effect.

Examples

# Configure the secondary authorization server 10.163.155.13 with TCP port number 49.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] secondary authorization 10.163.155.13 49

Related commands

display hwtacacs

stop-accounting-buffer enable (HWTACACS scheme view)

Use stop-accounting-buffer enable to enable the device to buffer stop-accounting requests to which no responses are received.

Use undo stop-accounting-buffer enable to disable the buffering function.

Syntax

stop-accounting-buffer enable

undo stop-accounting-buffer enable

Default

The device buffers stop-accounting requests to which no responses are received.

Views

HWTACACS scheme view

Default command level

2: System level

Usage guidelines

Stop-accounting requests affect the charge to users. A NAS must make its best effort to send every stop-accounting request to the HWTACACS accounting servers. For each stop-accounting request that receives no response in the specified period of time, the NAS buffers and resends the packet until it receives a response or until the number of transmission attempts reaches the configured limit. In the latter case, the NAS discards the packet.

Examples

# In HWTACACS scheme hwt1, enable the device to buffer the stop-accounting requests that receive no responses.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] stop-accounting-buffer enable

Related commands

· reset stop-accounting-buffer

· display stop-accounting-buffer

timer quiet (HWTACACS scheme view)

Use timer quiet to set the quiet timer for the primary server.

Use undo timer quiet to restore the default.

Syntax

timer quiet minutes

undo timer quiet

Default

The primary server quiet period is 5 minutes.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

minutes: Primary server quiet period. The value ranges from 1 to 255, in minutes.

Usage guidelines

When the primary server is found unreachable, the device changes the status of the server from active to blocked and keeps the server in blocked state until the quiet timer expires.

Examples

# Set the quiet timer for the primary server to 10 minutes.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] timer quiet 10

Related commands

display hwtacacs

timer response-timeout (HWTACACS scheme view)

Use timer response-timeout to set the HWTACACS server response timeout timer.

Use undo timer response-timeout to restore the default.

Syntax

timer response-timeout seconds

undo timer response-timeout

Default

The HWTACACS server response timeout time is 5 seconds.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

seconds: HWTACACS server response timeout period in seconds, ranging from 1 to 300.

Usage guidelines

HWTACACS is based on TCP. When the server response timeout timer or the TCP timeout timer times out, the device is disconnected from the HWTACACS server.

Examples

# Set the HWTACACS server response timeout timer to 30 seconds for HWTACACS scheme hwt1.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] timer response-timeout 30

Related commands

display hwtacacs

user-name-format (HWTACACS scheme view)

Use user-name-format to specify the format of the username to be sent to an HWTACACS server.

Syntax

user-name-format { keep-original | with-domain | without-domain }

Default

The ISP domain name is included in the username.

Views

HWTACACS scheme view

Default command level

2: System level

Parameters

keep-original: Sends the username to the HWTACACS server as it is entered.

with-domain: Includes the ISP domain name in the username sent to the HWTACACS server.

without-domain: Excludes the ISP domain name from the username sent to the HWTACACS server.

Usage guidelines

A username is generally in the format userid@isp-name, of which isp-name is used by the device to determine the ISP domain to which a user belongs. Some earlier HWTACACS servers, however, cannot recognize a username that includes an ISP domain name. Before sending a username including a domain name to such an HWTACACS server, the device must remove the domain name. This command allows you to specify whether to include a domain name in a username to be sent to an HWTACACS server.

If an HWTACACS scheme defines that the username is sent without the ISP domain name, do not apply the HWTACACS scheme to more than one ISP domain. This avoids the confusing situation in which the HWTACACS server regards two users in different ISP domains but with the same userid as one.

If the HWTACACS scheme is used for wireless users, specify the keep-original keyword. Otherwise, authentication of the wireless users may fail.

Examples

# Specify the device to remove the ISP domain name in the username sent to the HWTACACS servers for the HWTACACS scheme hwt1.

<Sysname> system-view

[Sysname] hwtacacs scheme hwt1

[Sysname-hwtacacs-hwt1] user-name-format without-domain

07-Security Command Reference

access-limit enable

authentication default

cut connection

display domain

domain

domain default enable

idle-cut enable

self-service-url enable

session-time include-idle-time

state (ISP domain view)

Local user configuration commands

accounting-on enable

data-flow-format (RADIUS scheme view)

display radius scheme

display radius statistics

display stop-accounting-buffer (for RADIUS)

key (RADIUS scheme view)

nas-ip (RADIUS scheme view)

primary accounting (RADIUS scheme view)

primary authentication (RADIUS scheme view)

radius nas-ip

reset radius statistics

reset stop-accounting-buffer (for RADIUS)

retry

retry stop-accounting (RADIUS scheme view)

secondary accounting (RADIUS scheme view)

secondary authentication (RADIUS scheme view)

state primary

state secondary

stop-accounting-buffer enable (RADIUS scheme view)

timer response-timeout (RADIUS scheme view)

user-name-format (RADIUS scheme view)

display stop-accounting-buffer (for HWTACACS)

nas-ip (HWTACACS scheme view)

primary accounting (HWTACACS scheme view)

primary authentication (HWTACACS scheme view)

reset stop-accounting-buffer (for HWTACACS)

retry stop-accounting (HWTACACS scheme view)

timer quiet (HWTACACS scheme view)

timer response-timeout (HWTACACS scheme view)

user-name-format (HWTACACS scheme view)

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us