System Security Command Reference for Cisco CRS Routers

aaa accounting

To create a method list for accounting, use the aaa accounting command in Global Configuration mode. To remove a list name from the system, use the no form of this command.

aaa accounting {commands | exec | network | subscriber | system } {default | list-name} {start-stop | stop-only} {none | method}

Syntax Description


commands	Enables accounting for EXEC shell commands.
exec	Enables accounting of an EXEC session.
network	Enables accounting for all network-related service requests, such as Internet Key Exchange (IKE) and Point-to-Point Protocol (PPP).
subscriber	Sets accounting lists for subscribers.
system	Enables accounting for all system-related events.
default	Uses the listed accounting methods that follow this keyword as the default list of methods for accounting services.
`list-name`	Character string used to name the accounting method list.
start-stop	Sends a “start accounting” notice at the beginning of a process and a “stop accounting” notice at the end of a process. The requested user process begins regardless of whether the “start accounting” notice was received by the accounting server.
stop-only	Sends a “stop accounting” notice at the end of the requested user process. Note: This is not supported with system accounting.
none	Uses no accounting.
`method`	Method used to enable AAA system accounting. The value is one of the following options: group tacacs+—Uses the list of all TACACS+ servers for accounting. group radius—Uses the list of all RADIUS servers for accounting. group named-group—Uses a named subset of TACACS+ or RADIUS servers for accounting, as defined by the aaa group server tacacs+ or aaa group server radius command.

Command Default

AAA accounting is disabled.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.4.0	The network keyword and `method` argument were added.

Usage Guidelines

Use the aaa accounting command to create default or named method lists defining specific accounting methods and that can be used on a per-line or per-interface basis. You can specify up to four methods in the method list. The list name can be applied to a line (console, aux, or vty template) to enable accounting on that particular line.

The Cisco IOS XR software supports both TACACS+ and RADIUS methods for accounting. The router reports user activity to the security server in the form of accounting records, which are stored on the security server.

Method lists for accounting define the way accounting is performed, enabling you to designate a particular security protocol that is used on specific lines or interfaces for particular types of accounting services.

For minimal accounting, include the stop-only keyword to send a “stop accounting” notice after the requested user process. For more accounting, you can include the start-stop keyword, so that TACACS+ or RADIUS sends a “start accounting” notice at the beginning of the requested process and a “stop accounting” notice after the process. The accounting record is stored only on the TACACS+ or RADIUS server.

The requested user process begins regardless of whether the “start accounting” notice was received by the accounting server.

Note

This command cannot be used with TACACS or extended TACACS.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to define a default commands accounting method list, where accounting services are provided by a TACACS+ security server, with a stop-only restriction:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa accounting commands default stop-only group tacacs+

Related Commands


Command	Description
aaa authorization	Creates a method list for authorization.

aaa accounting system default

To enable authentication, authorization, and accounting (AAA) system accounting, use the aaa accounting system default command in Global Configuration mode. To disable system accounting, use the no form of this command.

aaa accounting system default {start-stop | stop-only} {none | method}

Syntax Description


start-stop	Sends a “start accounting” notice during system bootup and a “stop accounting” notice during system shutdown or reload.
stop-only	Sends a “stop accounting” notice during system shutdown or reload.
none	Uses no accounting.
`method`	Method used to enable AAA system accounting. The value is one of the following options: group tacacs+—Uses the list of all TACACS+ servers for accounting. group radius—Uses the list of all RADIUS servers for accounting. group named-group—Uses a named subset of TACACS+ or RADIUS servers for accounting, as defined by the aaa group server tacacs+ or aaa group server radius command.

Command Default

AAA accounting is disabled.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.3.0	The `method` argument was added to specify either group tacacs+ , group radius, or group `named-group` options.

Usage Guidelines

System accounting does not use named accounting lists; you can define only the default list for system accounting.

The default method list is automatically applied to all interfaces or lines. If no default method list is defined, then no accounting takes place.

You can specify up to four methods in the method list.

Task ID


Task ID	Operations
aaa	read, write

Examples

This example shows how to cause a “start accounting” record to be sent to a TACACS+ server when a router initially boots. A “stop accounting” record is also sent when a router is shut down or reloaded.


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa accounting system default start-stop group tacacs+

Related Commands


Command	Description
aaa authentication	Creates a method list for authentication.
aaa authorization	Creates a method list for authorization.

aaa accounting system rp-failover

To create an accounting list to send rp-failover or rp-switchover start or stop accounting messages, use the aaa accounting system rp-failover command in Global Configuration mode. To disable the system accounting for rp-failover, use the no form of this command.

aaa accounting system rp-failover {list_name {start-stop | stop-only} | default {start-stop | stop-only}}

Syntax Description


`list_name`	Specifies the accounting list name.
default	Specifies the default accounting list.
start-stop	Enables the start and stop records.
stop-only	Enables the stop records only.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
aaa	read, write

Examples

This is an example of configuring the aaa accounting system rp-failover command for default accounting list:


RP/0/RP0/CPU0:router(config)# aaa accounting system rp-failover default start-stop none

Related Commands


Command	Description
aaa attribute format	Create an AAA attribute format name.

aaa accounting update

To enable periodic interim accounting records to be sent to the accounting server, use the aaa accounting update command in Global Configuration mode. To disable the interim accounting updates, use the no form of this command.

aaa accounting update {periodic minutes}

Syntax Description


periodic `minutes`	(Optional) Sends an interim accounting record to the accounting server periodically, as defined by the `minutes` argument, which is an integer that specifies the number of minutes. The range is from 1 to 35791394 minutes.

Command Default

AAA accounting update is disabled.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.4.0	This command was introduced.

Usage Guidelines

When used with the periodic keyword, interim accounting records are sent periodically as defined by the minutes argument. The interim accounting record contains all the accounting information recorded for that user up to the time the accounting record is sent.

Caution

Using the aaa accounting update command with the periodic keyword can cause heavy congestion when many users are logged into the network.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to send periodic interim accounting records to the RADIUS server at 30-minute intervals:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa accounting update periodic 30

Related Commands


Command	Description
aaa accounting	Creates a method list for accounting.
aaa authorization	Creates a method list for authorization.

aaa authentication

To create a method list for authentication, use the aaa authentication command. To disable this authentication method, use the no form of this command.

aaa authentication {login | ppp} {default | list-name | remote} method-list

Syntax Description

login

Sets authentication for login.

ppp

Sets authentication for Point-to-Point Protocol.

default

Uses the listed authentication methods that follow this keyword as the default list of methods for authentication.

subscriber

Sets the authentication list for the subscriber.

list-name

Character string used to name the authentication method list.

remote

Uses the listed authentication methods that follow this keyword as the default list of methods for administrative authentication on a remote non-owner secure domain router. The remote keyword is used only with the login keyword and not with the ppp keyword.

Note

The remote keyword is available only on the administration plane.

method-list

Method used to enable AAA system accounting. The value is one of the following options:

group tacacs+—Specifies a method list that uses the list of all configured TACACS+ servers for authentication.
group radius—Specifies a method list that uses the list of all configured RADIUS servers for authentication.
group named-group —Specifies a method list that uses a named subset of TACACS+ or RADIUS servers for authentication, as defined by the aaa group server tacacs+ or aaa group server radius command.
local—Specifies a method list that uses the local username database method for authentication. AAA method rollover happens beyond the local method if username is not defined in the local group.
line—Specifies a method list that uses the line password for authentication.

Command Default

Default behavior applies the local authentication on all ports.

Command Modes

Global Configuration mode

Admin Configuration mode

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.3.0	The `method-list` argument was added to specify either group tacacs+ , group radius, group named-group, local, or line options.

Usage Guidelines

Use the aaa authentication command to create a series of authentication methods, or method list. You can specify up to four methods in the method list. A method list is a named list describing the authentication methods (such as TACACS+ or RADIUS) in sequence. The subsequent methods of authentication are used only if the initial method is not available, not if it fails.

The default method list is applied for all interfaces for authentication, except when a different named method list is explicitly specified—in which case the explicitly specified method list overrides the default list.

For console and vty access, if no authentication is configured, a default of local method is applied.

Note

The group tacacs+, group radius, and group group-name forms of this command refer to a set of previously defined TACACS+ or RADIUS servers.
Use the tacacs-server host or radius-server host command to configure the host servers.
Use the aaa group server tacacs+ or aaa group server radius command to create a named subset of servers.
The login keyword, remote keyword, local option, and group option are available only in administration configuration mode.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to specify the default method list for authentication, and also enable authentication for console in global configuration mode:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa authentication login default group tacacs+

The following example shows how to specify the remote method list for authentication, and also enable authentication for console in administration configuration mode:


RP/0/RP0/CPU0:router# admin
RP/0/RP0/CPU0:router (admin)# configure
RP/0/RP0/CPU0:router(admin-config)# aaa authentication login remote local group tacacs+

Related Commands


Command	Description
aaa accounting	Creates a method list for accounting.
aaa authorization	Creates a method list for authorization.
aaa group server radius	Groups different RADIUS server hosts into distinct lists and distinct methods.
aaa group server tacacs+	Groups different TACACS+ server hosts into distinct lists and distinct methods.
login authentication	Enables AAA authentication for logins.
tacacs-server host	Specifies a TACACS+ host.

aaa authorization

To create a method list for authorization, use the aaa authorization command in Global Configuration mode. To disable authorization for a function, use the no form of this command.

aaa authorization { commands | eventmanager | exec | network | subscriber | nacm } { default | list-name } { none | local | only-external | group { tacacs | + | radius | group-name } }

Syntax Description


commands	Configures authorization for all EXEC shell commands.
eventmanager	Applies an authorization method for authorizing an event manager (fault manager).
exec	Configures authorization for an interactive ( EXEC) session.
network	Configures authorization for network services, such as PPP or Internet Key Exchange (IKE).
subscriber	Sets the authorization lists for the subscriber.
nacm	Enables the nacm functionality.
default	Uses the listed authorization methods that follow this keyword as the default list of methods for authorization.
`list-name`	Character string used to name the list of authorization methods.
none	Uses no authorization. If you specify none , no subsequent authorization methods is attempted. However, the task ID authorization is always required and cannot be disabled.
local	Uses local authorization.
group tacacs+	Uses the list of all configured TACACS+ servers for authorization.
group radius	Uses the list of all configured RADIUS servers for authorization. This method of authorization is not available for command authorization.
group `group-name`	Uses a named subset of TACACS+ or RADIUS servers for authorization as defined by the aaa group server tacacs+ or aaa group server radius command.

Command Default

Authorization is disabled for all actions (equivalent to the method none keyword).

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.6.0	The eventmanager keyword (fault manager) was added.

Usage Guidelines

Use the aaa authorization command to create method lists defining specific authorization methods that can be used on a per line or a per interface basis. You can specify up to four methods in the method list.

Note

NACM authorization cannot be configured on a per line or a per interface basis.

Note

The NACM authorization mentioned here applies to the one performed by an external AAA server and not for task-based authorization.

Method lists for authorization define the ways authorization will be performed and the sequence in which these methods will be performed. A method list is a named list describing the authorization methods (such as TACACS+), in sequence. Method lists enable you to designate one or more security protocols for authorization, thus ensuring a backup system in case the initial method fails. Cisco IOS XR software uses the first method listed to authorize users for specific network services; if that method fails to respond, Cisco IOS XR software selects the next method listed in the method list. This process continues until there is successful communication with a listed authorization method or until all methods defined have been exhausted.

Note

Cisco IOS XR software attempts authorization with the next listed method only when there is no response (not a failure) from the previous method. If authorization fails at any point in this cycle—meaning that the security server or local username database responds by denying the user services—the authorization process stops and no other authorization methods are attempted.

The Cisco IOS XR software supports the following methods for authorization:

none—The router does not request authorization information; authorization is not performed over this line or interface.
local—Use the local database for authorization.
prefer-external—Use the external database for authorization. The external group names are added to the list of local group names list to determine the access control rules. External group names are preferred from the list. If the option is not mentioned, the local group names are preferred from the list.
only-external—Use only external group names to determine the access control rules.
group tacacs+—Use the list of all configured TACACS+ servers for authorization.
group radius—Use the list of all configured RADIUS servers for authorization.

group group-name—Uses a named subset of TACACS+ or RADIUS servers for authorization.

Note

The group RADIUS is not applicable to NACM and command authorizations.

Method lists are specific to the type of authorization being requested. Cisco IOS XR software supports four types of AAA authorization:

Commands authorization—Applies to the EXEC mode commands a user issues. Command authorization attempts authorization for all EXEC mode commands.

Note

“Command” authorization is distinct from “task-based” authorization, which is based on the task profile established during authentication.

EXEC authorization—Applies authorization for starting an EXEC session.

Note

The exec keyword is no longer used to authorize the fault manager service. The eventmanager keyword (fault manager) is used to authorize the fault manager service. The exec keyword is used for EXEC authorization.

Network authorization—Applies authorization for network services, such as IKE.

Event manager authorization—Applies an authorization method for authorizing an event manager (fault manager). RADIUS servers are not allowed to be configured for the event manager (fault manager) authorization. You are allowed to use TACACS+ or LOCAL.

Note

The eventmanager keyword (fault manager) replaces the exec keyword to authorize event managers (fault managers).

When you create a named method list, you are defining a particular list of authorization methods for the indicated authorization type. When defined, method lists must be applied to specific lines or interfaces before any of the defined methods are performed.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to define the network authorization method list named listname1, which specifies that TACACS+ authorization is used:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa authorization commands listname1 group tacacs+

Examples

The following example shows how to enable the NACM authorization to use the external group names for determining the access control rules. NACM is disabled by default. To enable NACM, you must have root-lr or aaa write task privilege to enable or disable NACM.


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa authorization nacm default only-external local

Related Commands


Command	Description
aaa accounting	Creates a method list for accounting.

show nacm (XR-VM)

To display information about NETCONF Access Control information such as users, groups, rule-lists and traces, use the show nacm command in Global Configuration mode. To disable authorization for a function, use the no form of this command.

show nacm {summary | | | users | [ | <user-name> | ] | | | groups | [ | <group-name> | ] | | | rule-list | [ | <rule-list-name> | [ | rule | [ | <rule-name> | ] | ] | ] | | | trace}

Syntax Description


summary	Displays NACM summary information.
Users	Displays list of users in NACM database.
user-name	Displays info for a given user-name.
groups	Displas list of groups in the NACM database.
`group-name`	Displays information for a given group name.
rule-list	Displays list of rule-lists in the NACM database.
`rule-list-name`	Displays info for given rule-list-name.
rule	Displays list of rules under the rule-list in the NACM database.
`rule-name`	Displays info for given rule-name under rule-name in the NACM database.
trace tacacs+	Displays NACM process traces.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 6.4.1	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operations
nacm	read

Examples

The following example shows how to use the show nacm command:


RP/0/RP0/CPU0:xr-nacm #show nacm summary
 NACM SUMMARY
 --------------------------------------------------------------------------------
 Enable Nacm : False
 Enable External Groups : True
 Number of Groups : 2
 Number of Users : 2
 Number of Rules : 2
 Number of Rulelist : 2
 Default Read : permit
 Default Write : permit
 Default Exec : permit
 Denied Operations : 0
 Denied Data Writes : 0
 Denied Notifications : 0
 --------------------------------------------------------------------------------
RP/0/RP0/CPU0:xr-nacm#
RP/0/RP0/CPU0:xr-nacm#show nacm users
USERS LIST:
--------------------------------------------------------------------------------
lab,    admin,
--------------------------------------------------------------------------------
RP/0/RP0/CPU0:xr-nacm#
RP/0/RP0/CPU0:xr-nacm#show nacm users lab

USER NAME: lab
--------------------------------------------------------------------------------
Groups List For User:
root-lr,    root-system,
--------------------------------------------------------------------------------

RP/0/RP0/CPU0:xr-nacm#


RP/0/RP0/CPU0:xr-nacm#show nacm groups

GROUPS LIST:
--------------------------------------------------------------------------------
root-system,    root-lr,
--------------------------------------------------------------------------------
RP/0/RP0/CPU0:xr-nacm#
RP/0/RP0/CPU0:xr-nacm#show nacm groups root-system

GROUP NAME: root-system
--------------------------------------------------------------------------------
Users List:
admin,    lab, 
Rules List:
rule-list-1,    rule-list-2,
--------------------------------------------------------------------------------
RP/0/RP0/CPU0:xr-nacm#
RP/0/RP0/CPU0:xr-nacm#show nacm rule-list
RULELISTS:
--------------------------------------------------------------------------------
   Rulelist Index       Rulelist Name
     rule-list-2        rule-list-2
     rule-list-1        rule-list-1
--------------------------------------------------------------------------------
RP/0/RP0/CPU0:xr-nacm#
RP/0/RP0/CPU0:xr-nacm#show nacm rule-list rule-list-1,rule-list-1
RULELIST NAME: rule-list-1
--------------------------------------------------------------------------------
   Rule Index              Rule Name
           rule1        rule1
           rule2        rule2
   Group List
root-system,    root-lr,
--------------------------------------------------------------------------------
RP/0/RP0/CPU0:xr-nacm#
RP/0/RP0/CPU0:xr-nacm#show nacm rule-list rule-list-1,rule-list-1 rule

Rule Info:
        Name:                   rule1
        Index:                  rule1
        Value:                  edit-config
        ModuleName:             *
        Action:                 permit
        RuleType:               Rpc
        Comment:
        AccessOperations:       All
        HitCount:               0
 --------------------------------------------------------------------------------
 Rule Info:
        Name:                   rule2
        Index:                  rule2
        Value:                  /nacm/rule-list
        ModuleName:             ietf-netconf-acm
        Action:                 deny
        RuleType:               Data
        Comment:
        AccessOperations:       Read,
        HitCount:               0
 --------------------------------------------------------------------------------
RP/0/RP0/CPU0:xr-nacm#
RP/0/RP0/CPU0:xr-nacm#show nacm rule-list rule-list-1,rule-list-1 rule rule2,rule2
RULELIST NAME: rule-list-1
 --------------------------------------------------------------------------------
Rule Info:
        Name:                   rule2
        Index:                  rule2
        Value:                  /nacm/rule-list
        ModuleName:             ietf-netconf-acm
        Action:                 deny
        RuleType:               Data
        Comment:
        AccessOperations:       Read,
        HitCount:               0
 --------------------------------------------------------------------------------
RP/0/RP0/CPU0:xr-nacm#

Related Commands


Command	Description
aaa accounting	Creates a method list for accounting.

aaa default-taskgroup

To specify a task group for both remote TACACS+ authentication and RADIUS authentication, use the aaa default-taskgroup command in Global Configuration mode. To remove this default task group, enter the no form of this command.

aaa default-taskgroup taskgroup-name

Syntax Description


`taskgroup-name`	Name of an existing task group.

Command Default

No default task group is assigned for remote authentication.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.2	This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the aaa default-taskgroup command to specify an existing task group for remote TACACS+ authentication.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to specify taskgroup1 as the default task group for remote TACACS+ authentication:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa default-taskgroup taskgroup1

aaa group server radius

To group different RADIUS server hosts into distinct lists, use the aaa group server radius command in Global Configuration mode. To remove a group server from the configuration list, enter the no form of this command.

aaa group server radius group-name

Syntax Description


`group-name`	Character string used to name the group of servers.

Command Default

This command is not enabled.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.2	This command was introduced.

Usage Guidelines

Use the aaa group server radius command to group existing server hosts, which allows you to select a subset of the configured server hosts and use them for a particular service. A server group is used in conjunction with a global server-host list. The server group lists the IP addresses or hostnames of the selected server hosts.

Server groups can also include multiple host entries for the same server, as long as each entry has a unique identifier. The combination of an IP address and User Datagram Protocol (UDP) port number creates a unique identifier, allowing different ports to be individually defined as RADIUS hosts providing a specific authentication, authorization, and accounting (AAA) service. In other words, this unique identifier enables RADIUS requests to be sent to different UDP ports on a server at the same IP address. If two different host entries on the same RADIUS server are configured for the same service, for example, accounting, the second host entry acts as an automatic switchover backup to the first host entry. Using this example, if the first host entry fails to provide accounting services, the network access server tries the second host entry on the same device for accounting services. The RADIUS host entries are tried in the order in which they are configured in the server group.

All members of a server group must be the same type, that is, RADIUS.

The server group cannot be named radius or tacacs.

This command enters server group configuration mode. You can use the server command to associate a particular RADIUS server with the defined server group.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows the configuration of an AAA group server named radgroup1, which comprises three member servers:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa group server radius radgroup1
RP/0/RP0/CPU0:router(config-sg-radius)# server 10.0.0.5 auth-port 1700 acct-port 1701
RP/0/RP0/CPU0:router(config-sg-radius)# server 10.0.0.10 auth-port 1702 acct-port 1703
RP/0/RP0/CPU0:router(config-sg-radius)# server 10.0.0.20 auth-port 1705 acct-port 1706

Note

If the auth-port port-number and acct-port port-number keywords and arguments are not specified, the default value of the port-number argument for the auth-port keyword is 1645 and the default value of the port-number argument for the acct-port keyword is 1646.

Related Commands


Command	Description
key (RADIUS)	Specifies the authentication and encryption key that is used between the router and the RADIUS daemon running on the RADIUS server.
radius source-interface(BNG)	Forces RADIUS to use the IP address of a specified interface or subinterface for all outgoing RADIUS packets.
retransmit (RADIUS)	Specifies the number of times a RADIUS request is resent to a server if the server is not responding or is responding slowly.
server (RADIUS)	Associates a RADIUS server with a defined server group.
server-private (RADIUS)	Configures the IP address of the private RADIUS server for the group server.
timeout (RADIUS)	Specifies the number of seconds the router waits for the RADIUS server to reply before retransmitting.
vrf (RADIUS)	Configures the Virtual Private Network (VPN) routing and forwarding (VRF) reference of an AAA RADIUS server group.

aaa group server tacacs+

To group different TACACS+ server hosts into distinct lists, use the aaa group server tacacs+ command in Global Configuration mode. To remove a server group from the configuration list, enter the no form of this command.

aaa group server tacacs+ group-name

Syntax Description


`group-name`	Character string used to name a group of servers.

Command Default

This command is not enabled.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 5.3.0	IPv6 support was introduced on this command.

Usage Guidelines

The AAA server-group feature introduces a way to group existing server hosts. The feature enables you to select a subset of the configured server hosts and use them for a particular service.

The aaa group server tacacs+ command enters server group configuration mode. The server command associates a particular TACACS+ server with the defined server group.

A server group is a list of server hosts of a particular type. The supported server host type is TACACS+ server hosts. A server group is used with a global server host list. The server group lists the IP addresses or hostnames of the selected server hosts.

The server group cannot be named radius or tacacs.

Note

Group name methods refer to a set of previously defined TACACS+ servers. Use the tacacs-server host command to configure the host servers.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows the configuration of an AAA group server named tacgroup1, which comprises three member servers:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa group server tacacs+ tacgroup1
RP/0/RP0/CPU0:router(config-sg-tacacs)# server 192.168.200.226
RP/0/RP0/CPU0:router(config-sg-tacacs)# server 192.168.200.227
RP/0/RP0/CPU0:router(config-sg-tacacs)# server 192.168.200.228

Related Commands


Command	Description
aaa accounting	Creates a method list for accounting.
aaa authentication	Creates a method list for authentication.
aaa authorization	Creates a method list for authorization.
server (TACACS+)	Specifies the host name or IP address of an external TACACS+ server.
tacacs-server host	Specifies a TACACS+ host.

aaa password-policy

To define a AAA password security policy, use the aaa password-policy command in Global Configuration mode. To remove the AAA password security policy, use the no form of this command.

aaa password-policy policy-name {min-length min-length | max-length max-length | special-char special-char | upper-case upper-case | lower-case lower-case | numeric numeric | lifetime {years | months | days | hours | minutes | seconds} lifetime | min-char-change min-char-change | authen-max-attempts authen-max-attempts | lockout-time {days | hours | minutes | seconds} lockout-time | warn-interval { years | months | days | hours | minutes | seconds } | restrict-old-time { years | months | days } | max-char-repetition max-char-repetition | restrict-old-count restrict-old-count | restrict-password-advanced | restrict-password-reverse | restrict-username | restrict-username-reverse }

Syntax Description


`policy-name`	Specifies the name of the password, in characters.
min-length	Specifies the minimum length of the password, in integer.
max-length	Specifies the maximum length of the password, in integer.
special-char	Specifies the number of special characters allowed in the password policy, in integer.
upper-case	Specifies the number of upper case alphabets allowed in the password policy, in integer.
lower-case	Specifies the number of lower case alphabets allowed in the password policy, in integer.
numeric	Specifies the number of numerals allowed in the password policy, in integer.
lifetime	Specifies the maximum lifetime for the password, the value of which is specified in integer, as years, months, days, hours, minutes or seconds.
min-char-change	Specifies the number of character change required between subsequent passwords, in integer.
authen-max-attempts	Specifies, in integer, the maximum number of authentication failure attempts allowed for a user, in order to restrict users who authenticate with invalid login credentials.
lockout-time	Specifies, in integer, the duration (in days, hours, minutes or seconds) for which the user is locked out when he exceeds the maximum limit of authentication failure attempts allowed.
warn-interval	Specifies the amount of time to notify the user about an expiring password, the value of which is specified in integer, as years, months, days, hours, minutes or seconds.
restrict-old-time	Specifies, in integer, the amount of time for which an old password is considered as valid. The value is specified in years, months, or days.
max-char-repetition	Specifies the consecutive number of times a character can be repeated in a password.
restrict-old-count	Specifies the count for the number of old passwords that cannot be reused.
restrict-password-advanced	Specifies the advanced restrictions on a new password.
restrict-password-reverse	Restricts the new password from being the same as the reversed old password.
restrict-username	Restricts the use of an associated username as a password.
restrict-username-reverse	Restricts the usage of associated username reversed as a password.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 6.2.1	This command was introduced.

Usage Guidelines

AAA password security policy works as such for Cisco IOS XR platforms. Whereas, this feature is supported only on XR VM, for Cisco IOS XR 64 bit platforms.

For more details on the usage of each option of this command, refer the section on AAA Password Security for FIPS Compliance in Configuring AAA Services chapter in the System Security Configuration Guide for Cisco CRS Routers.

You must configure both authen-max-attempts and lockout-time in order for the lock out functionality to take effect.

The min-char-change option is effective only for password change through logon, and not for password change by configuration.

Use username command along with password-policy option, in the Global Configuration mode, to associate the password policy with a particular user.

When warn-interval is enabled and it expires, the user is prompted at login to change the password or has the option to skip. If warn-interval and lifetime have both expired, the user must change their password.

From Cisco IOS XR Software Release 7.2.1 and later, most of the options of the aaa password-policy command listed in the syntax above are applicable to user password as well as secret. Whereas, the options listed below are supported only for password, and not for secret:

max-char-repetition
min-char-change
restrict-password-reverse
restrict-password-advanced

This table lists the default, maximum and minimum values of various command variables:


Command Variables	Default Value	Maximum Value	Minimum Value
`policy-name`	None	253	1
`max-length`	253	253	2
`min-length`	2	253	2
`special-char`	0	253	0
`upper-case`	0	253	0
`lower-case`	0	253	0
`numeric`	0	253	0
For lifetime :
years	0	99	1
months	0	11	1
days	0	30	1
hours	0	23	1
minutes	0	59	1
seconds	0	59	1
`min-char-change`	4	253	0
`authen-max-attempts`	0	24	1
For lockout-time :
days	0	225	1
hours	0	23	1
minutes	0	59	1
seconds	0	59	1
For warn-interval :
years	0	99	1
months	0	11	1
days	0	30	1
hours	0	23	1
minutes	0	59	1
seconds	0	59	1
For restrict-old-time :
years	0	99	1
months	0	11	1
days	0	30	1
`max-char-repetition`	0	5	2
`restrict-old-count`	0	10	1

Task ID


Task ID	Operation
aaa	read, write

Examples

This example shows how to define a AAA password security policy:


RP/0/RP0/CPU0:router(config)#aaa password-policy test-policy
RP/0/RP0/CPU0:router(config-aaa)#min-length 8
RP/0/RP0/CPU0:router(config-aaa)#max-length 15
RP/0/RP0/CPU0:router(config-aaa)#lifetime months 3
RP/0/RP0/CPU0:router(config-aaa)#min-char-change 5
RP/0/RP0/CPU0:router(config-aaa)#authen-max-attempts 3
RP/0/RP0/CPU0:router(config-aaa)#lockout-time days 1
RP/0/RP0/CPU0:router(config-aaa)#warn-interval months 2
RP/0/RP0/CPU0:router(config-aaa)#restrict-old-time years 3
RP/0/RP0/CPU0:router(config-aaa)#max-char-repetition 3
RP/0/RP0/CPU0:router(config-aaa)#restrict-old-count 3
RP/0/RP0/CPU0:router(config-aaa)#restrict-password-reverse
RP/0/RP0/CPU0:router(config-aaa)#restrict-password-advanced
RP/0/RP0/CPU0:router(config-aaa)#restrict-username
RP/0/RP0/CPU0:router(config-aaa)#restrict-username-reverse

Related Commands

Command	Description
show aaa password-policy	Displays the details of AAA password policy.
username

accounting (line)

To enable authentication, authorization, and accounting (AAA) accounting services for a specific line or group of lines, use the accounting command in line template configuration mode. To disable AAA accounting services, use the no form of this command.

accounting {commands | exec} {default | list-name}

Syntax Description


commands	Enables accounting on the selected lines for all EXEC shell commands.
exec	Enables accounting of EXEC session.
default	The name of the default method list, created with the aaa accounting command.
`list-name`	Specifies the name of a list of accounting methods to use. The list is created with the aaa accounting command.

Command Default

Accounting is disabled.

Command Modes

Line template configuration

Command History


Release	Modification
Release 2.0	This command was introduced.

Usage Guidelines

After you enable the aaa accounting command and define a named accounting method list (or use the default method list) for a particular type of accounting, you must apply the defined lists to the appropriate lines for accounting services to take place. Use the accounting command to apply the specified method lists to the selected line or group of lines. If a method list is not specified this way, no accounting is applied to the selected line or group of lines.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to enable command accounting services using the accounting method list named listname2 on a line template named configure:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# line template configure
RP/0/RP0/CPU0:router(config-line)# accounting commands listname2

Related Commands


Command	Description
aaa accounting	Creates a method list for accounting.

authorization (line)

To enable authentication, authorization, and accounting (AAA) authorization for a specific line or group of lines, use the authorization command in line template configuration mode. To disable authorization, use the no form of this command.

authorization {commands | exec | eventmanager} {default | list-name}

Syntax Description


commands	Enables authorization on the selected lines for all commands.
exec	Enables authorization for an interactive (EXEC) session.
default	Applies the default method list, created with the aaa authorization command.
eventmanager	Sets eventmanager authorization method. This method is used for the embedded event manager.
`list-name`	Specifies the name of a list of authorization methods to use. If no list name is specified, the system uses the default. The list is created with the aaa authorization command.

Command Default

Authorization is not enabled.

Command Modes

Line template configuration

Command History


Release	Modification
Release 2.0	This command was introduced.

Usage Guidelines

After you use the aaa authorization command to define a named authorization method list (or use the default method list) for a particular type of authorization, you must apply the defined lists to the appropriate lines for authorization to take place. Use the authorization command to apply the specified method lists (or, if none is specified, the default method list) to the selected line or group of lines.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to enable command authorization using the method list named listname4 on a line template named configure:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# line template configure
RP/0/RP0/CPU0:router(config-line)# authorization commands listname4

Related Commands


Command	Description
aaa authorization	Creates a method list for authorization.

deadtime (server-group configuration)

To configure the deadtime value at the RADIUS server group level, use the deadtime command in server-group configuration mode. To set deadtime to 0, use the no form of this command.

deadtime minutes

Syntax Description


`minutes`	Length of time, in minutes, for which a RADIUS server is skipped over by transaction requests, up to a maximum of 1440 (24 hours). The range is from 1 to 1440.

Command Default

Deadtime is set to 0.

Command Modes

Server-group configuration

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

The value of the deadtime set in the server groups overrides the deadtime that is configured globally. If the deadtime is omitted from the server group configuration, the value is inherited from the primary list. If the server group is not configured, the default value of 0 applies to all servers in the group. If the deadtime is set to 0, no servers are marked dead.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example specifies a one-minute deadtime for RADIUS server group group1 when it has failed to respond to authentication requests for the deadtime command:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa group server radius group1
RP/0/RP0/CPU0:router(config-sg-radius)# server 10.1.1.1 auth-port 1645 acct-port 1646
RP/0/RP0/CPU0:router(config-sg-radius)# server 10.2.2.2 auth-port 2000 acct-port 2001
RP/0/RP0/CPU0:router(config-sg-radius)# deadtime 1

Related Commands


Command	Description
aaa group server tacacs+	Groups different RADIUS server hosts into distinct lists and distinct methods.
radius-server dead-criteria time	Forces one or both of the criteria that is used to mark a RADIUS server as dead.
radius-server deadtime	Defines the length of time in minutes for a RADIUS server to remain marked dead.

description (AAA)

To create a description of a task group or user group during configuration, use the description command in task group configuration or user group configuration mode. To delete a task group description or user group description, use the no form of this command.

description string

Syntax Description


`string`	Character string describing the task group or user group.

Command Default

None

Command Modes

Task group configuration

User group configuration

Command History


Release	Modification
Release 2.0	This command was introduced.

Usage Guidelines

Use the description command inside the task or user group configuration submode to define a description for the task or user group, respectively.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows the creation of a task group description:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# taskgroup alpha
RP/0/RP0/CPU0:router(config-tg)# description this is a sample taskgroup

The following example shows the creation of a user group description:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# usergroup alpha
RP/0/RP0/CPU0:router(config-ug)# description this is a sample user group

Related Commands


Command	Description
taskgroup	Accesses task group configuration mode and configures a task group by associating it with a set of task IDs.
usergroup	Accesses user group configuration mode and configures a user group by associating it with a set of task groups.

group (AAA)

To add a user to a group, use the group command in username configuration mode. To remove the user from a group, use the no form of this command.

group {root-system | root-lr | netadmin | sysadmin | operator | cisco-support | serviceadmin | group-name}

Syntax Description

root-system

Adds the user to the predefined root-system group and provides access to commands included in the cisco-support group. Only users with root-system authority may use this option.

root-lr

Adds the user to the predefined root-lr group. Only users with root-system authority or root-lr authority may use this option.

netadmin

Adds the user to the predefined network administrators group.

sysadmin

Adds the user to the predefined system administrators group.

operator

Adds the user to the predefined operator group.

cisco-support

Adds the user to the predefined Cisco support personnel group.

Note

Starting from IOS XR 4.3.1 release, the cisco-support group is combined with the root-system group. This means a user who is part of the root-system group can also access commands that are included in the cisco-support group.

serviceadmin

Adds the user to the predefined service administrators group.

group-name

Adds the user to a named user group that has already been defined with the usergroup command.

Command Modes

Username configuration

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.3.0	The serviceadmin keyword was added.
Release 3.3.0	The root-system group includes privileges for cisco-support groupd.

Usage Guidelines

The predefined group root-system may be specified only by root-system users while configuring administration.

Use the group command in username configuration mode. To access username configuration mode, use the username command in global configuration mode.

If the group command is used in administration configuration mode, only root-system and cisco-support keywords can be specified.

The privileges associated with the cisco-support group are now included in the root-system group. The cisco-support group is no longer required to be used for configuration.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to assign the user group operator to the user named user1:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# username user1
RP/0/RP0/CPU0:router(config-un)# group operator

Related Commands


Command	Description
password (AAA)	Creates a login password for a user.
usergroup	Configures a user group and associates it with a set of task groups.
username	Accesses username configuration mode, configures a new user with a username, and establishes a password and permissions for that user.

inherit taskgroup

To enable a task group to derive permissions from another task group, use the inherit taskgroup command in task group configuration mode.

inherit taskgroup {taskgroup-name | netadmin | operator | sysadmin | cisco-support | root-lr | root-system | serviceadmin}

Syntax Description


`taskgroup-name`	Name of the task group from which permissions are inherited.
netadmin	Inherits permissions from the network administrator task group.
operator	Inherits permissions from the operator task group.
sysadmin	Inherits permissions from the system administrator task group.
cisco-support	Inherits permissions from the cisco support task group.
root-lr	Inherits permissions from the root-lr task group.
root-system	Inherits permissions from the root system task group.
serviceadmin	Inherits permissions from the service administrators task group.

Command Default

None

Command Modes

Task group configuration

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.3.0	The serviceadmin keyword was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the inherit taskgroup command to inherit the permissions (task IDs) from one task group into another task group. Any changes made to the taskgroup from which they are inherited are reflected immediately in the group from which they are inherited.

Task ID


Task ID	Operations
aaa	read, write

Examples

In the following example, the permissions of task group tg2 are inherited by task group tg1:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# taskgroup tg1
RP/0/RP0/CPU0:router(config-tg)# inherit taskgroup tg2
RP/0/RP0/CPU0:router(config-tg)# end

inherit usergroup

To enable a user group to derive characteristics of another user group, use the inherit usergroup command in user group configuration mode.

inherit usergroup usergroup-name

Syntax Description


`usergroup-name`	Name of the user group from which permissions are to be inherited.

Command Default

None

Command Modes

User group configuration

Command History


Release	Modification
Release 2.0	This command was introduced.

Usage Guidelines

Each user group is associated with a set of task groups applicable to the users in that group. A task group is defined by a collection of task IDs. Task groups contain task ID lists for each class of action. The task permissions for a user are derived (at the start of the EXEC or XML session) from the task groups associated with the user groups to which that user belongs.

User groups support inheritance from other user groups. Use the inherit usergroup command to copy permissions (task ID attributes) from one user group to another user group. The “destination” user group inherits the properties of the inherited group and forms a union of all task IDs specified in those groups. For example, when user group A inherits user group B, the task map of the user group A is a union of that of A and B. Cyclic inclusions are detected and rejected. User groups cannot inherit properties from predefined groups, such as root-system users, root-sdr users, netadmin users, and so on. Any changes made to the usergroup from which it is inherited are reflected immediately in the group from which it is inherited.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to enable the purchasing user group to inherit properties from the sales user group:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# usergroup purchasing
RP/0/RP0/CPU0:router(config-ug)# inherit usergroup sales

Related Commands


Command	Description
description (AAA)	Creates a description of a task group in task group configuration mode, or creates a description of a user group in user group configuration mode.
taskgroup	Configures a task group to be associated with a set of task IDs.
usergroup	Configures a user group to be associated with a set of task groups.

key (RADIUS)

To specify the authentication and encryption key that is used between the router and the RADIUS daemon running on the RADIUS server, use the key (RADIUS) command in RADIUS server-group private configuration mode.

key {0 clear-text-key | 7 encrypted-key | clear-text-key}

Syntax Description


0 `clear-text-key`	Specifies an unencrypted (cleartext) shared key.
7 `encrypted-key`	Specifies an encrypted shared key.
`clear-text-key`	Specifies an unencrypted (cleartext) user password.

Command Default

For submode key commands, the default is to use the radius-server key command in global configuration mode, if defined. If the global key is also not defined, the configuration is not complete.

Command Modes

RADIUS server-group private configuration

Command History


Release	Modification
Release 3.4.0	This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to set the encrypted key to anykey:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# aaa group server radius group1
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.1.1.1 auth-port 300
RP/0/RP0/CPU0:router(config-sg-radius-private)# key anykey

Related Commands


Command	Description
aaa group server tacacs+	Groups different RADIUS server hosts into distinct lists.
radius-server key(BNG)	Sets the authentication and encryption key for all RADIUS communications between the router and the RADIUS daemon.
retransmit (RADIUS)	Specifies the number of times a RADIUS request is resent to a server if the server is not responding or is responding slowly.
server-private (RADIUS)	Configures the IP address of the private RADIUS server for the group server.
timeout (RADIUS)	Specifies the number of seconds the router waits for the RADIUS server to reply before retransmitting.

key (TACACS+)

To specify an authentication and encryption key shared between the AAA server and the TACACS+ server, use the key (TACACS+) command in TACACS host configuration mode. To disable this feature, use the no form of this command.

key {0 clear-text-key | 7 encrypted-key | auth-key}

Syntax Description


0 `clear-text-key`	Specifies an unencrypted (cleartext) shared key.
7 `encrypted-key`	Specifies an encrypted shared key.
`auth-key`	Specifies the unencrypted key between the AAA server and the TACACS+ server.

Command Default

None

Command Modes

TACACS host configuration

Command History


Release	Modification
Release 3.6.0	This command was introduced.

Usage Guidelines

The TACACS+ packets are encrypted using the key, and it must match the key used by the TACACS+ daemon. Specifying this key overrides the key set by the tacacs-server key command for this server only.

The key is used to encrypt the packets that are going from TACACS+, and it should match with the key configured on the external TACACS+ server so that the packets are decrypted properly. If a mismatch occurs, the result fails.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to set the encrypted key to anykey


RP/0/RP0/CPU0:router(config)# tacacs-server host 209.165.200.226
RP/0/RP0/CPU0:router(config-tacacs-host)# key anykey

Related Commands


Command	Description
tacacs-server host	Specifies a TACACS+ host.
tacacs-server key	Globally sets the authentication encryption key used for all TACACS+ communications between the router and the TACACS+ daemon.

login authentication

To enable authentication, authorization, and accounting (AAA) authentication for logins, use the login authentication command in line template configuration mode. To return to the default authentication settings, use the no form of this command.

login authentication {default | list-name}

Syntax Description


default	Default list of AAA authentication methods, as set by the aaa authentication login command.
`list-name`	Name of the method list used for authenticating. You specify this list with the aaa authentication login command.

Command Default

This command uses the default set with the aaa authentication login command.

Command Modes

Line template configuration

Command History


Release	Modification
Release 2.0	This command was introduced.

Usage Guidelines

The login authentication command is a per-line command used with AAA that specifies the name of a list of AAA authentication methods to try at login.

Caution

If you use a list-name value that was not configured with the aaa authentication login command, the configuration is rejected.

Entering the no form of the login authentication command has the same effect as entering the command with the default keyword.

Before issuing this command, create a list of authentication processes by using the aaa authentication login command.

Task ID


Task ID	Operations
aaa	read, write
tty-access	read, write

Examples

The following example shows that the default AAA authentication is used for the line template template1:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# line template template1
RP/0/RP0/CPU0:router(config-line)# login authentication default

The following example shows that the AAA authentication list called list1 is used for the line template template2:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# line template template2
RP/0/RP0/CPU0:router(config-line)# login authentication list1

Related Commands


Command	Description
aaa authentication	Creates a method list for authentication.

password (AAA)

To create a login password for a user, use the password command in username configuration mode or line template configuration mode. To remove the password, use the no form of this command.

password { [0] | 7 password}

Syntax Description


0	(Optional) Specifies that an unencrypted clear-text password follows.
7	Specifies that an encrypted password follows.
`password`	Specifies the unencrypted password text to be entered by the user to log in, for example, “lab”. If encryption is configured, the password is not visible to the user. Can be up to 253 characters in length.

Command Default

The password is in unencrypted clear text.

Command Modes

Username configuration

Line template configuration

Command History


Release	Modification
Release 2.0	This command was introduced.

Usage Guidelines

You can specify one of two types of passwords: encrypted or clear text.

When an EXEC process is started on a line that has password protection, the process prompts for the password. If the user enters the correct password, the process issues the prompt. The user can try three times to enter a password before the process exits and returns the terminal to the idle state.

Passwords are two-way encrypted and should be used for applications such as PPP that need decryptable passwords that can be decrypted.

Note

The show running-config command always displays the clear-text login password in encrypted form when the 0 option is used.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to establish the unencrypted password pwd1 for user. The output from the show command displays the password in its encrypted form.


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# username user1
RP/0/RP0/CPU0:router(config-un)# password 0 pwd1
RP/0/RP0/CPU0:router(config-un)# commit
RP/0/RP0/CPU0:router(config-un)# show running-config
Building configuration...
username user1
 password 7 141B1309

Related Commands


Command	Description
group (AAA)	Adds a user to a group.
usergroup	Accesses user group configuration mode and configures a user group, associating it with a set of task groups.
username	Accesses username configuration mode and configures a new user with a username, establishing a password and granting permissions for that user.
line	Enters line template configuration mode for the specified line template. For more information, see the Cisco IOS XR System Management Command Reference.

radius-server dead-criteria time

To specify the minimum amount of time, in seconds, that must elapse from the time that the router last received a valid packet from the RADIUS server to the time the server is marked as dead, use the radius-server dead-criteria time command in Global Configuration mode mode. To disable the criteria that were set, use the no form of this command.

radius-server dead-criteria time seconds

Syntax Description

seconds

Length of time, in seconds. The range is from 1 to120 seconds. If the seconds argument is not configured, the number of seconds ranges from 10 to 60, depending on the transaction rate of the server.

Note

The time criterion must be met for the server to be marked as dead.

Command Default

If this command is not used, the number of seconds ranges from 10 to 60 seconds, depending on the transaction rate of the server.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

Note

If you configure the radius-server dead-criteria time command before the radius-server deadtime command, the radius-server dead-criteria time command may not be enforced.

If a packet has not been received since the router booted and there is a timeout, the time criterion is treated as though it were met.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to establish the time for the dead-criteria conditions for a RADIUS server to be marked as dead for the radius-server dead-criteria time command:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# radius-server dead-criteria time 5

Related Commands


Command	Description
radius-server dead-criteria tries	Specifies the number of consecutive timeouts that must occur on the router before the RADIUS server is marked as dead.
radius-server deadtime	Defines the length of time, in minutes, for a RADIUS server to remain marked dead.
show radius dead-criteria	Displays information for the dead-server detection criteria.

radius-server dead-criteria tries

To specify the number of consecutive timeouts that must occur on the router before the RADIUS server is marked as dead, use the radius-server dead-criteria tries command in Global Configuration mode. To disable the criteria that were set, use the no form of this command.

radius-server dead-criteria tries

Syntax Description

tries

Number of timeouts from 1 to 100. If the tries argument is not configured, the number of consecutive timeouts ranges from 10 to 100, depending on the transaction rate of the server and the number of configured retransmissions.

Note

The tries criterion must be met for the server to be marked as dead.

Command Default

If this command is not used, the number of consecutive timeouts ranges from 10 to 100, depending on the transaction rate of the server and the number of configured retransmissions.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

If the server performs both authentication and accounting, both types of packet are included in the number. Improperly constructed packets are counted as though they were timeouts. All transmissions, including the initial transmit and all retransmits, are counted.

Note

If you configure the radius-server dead-criteria tries command before the radius-server deadtime command, the radius-server dead-criteria tries command may not be enforced.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to establish the number of tries for the dead-criteria conditions for a RADIUS server to be marked as dead for the radius-server dead-criteria tries command:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# radius-server dead-criteria tries 4

Related Commands


Command	Description
radius-server dead-criteria time	Defines the length of time in seconds that must elapse from the time that the router last received a valid packet from the RADIUS server to the time the server is marked as dead.
radius-server deadtime	Defines the length of time, in minutes, for a RADIUS server to remain marked dead.
show radius dead-criteria	Displays information for the dead-server detection criteria.

radius-server deadtime

To improve RADIUS response times when some servers are unavailable and cause the unavailable servers to be skipped immediately, use the radius-server deadtime command in Global Configuration mode. To set deadtime to 0, use the no form of this command.

radius-server deadtime minutes

Syntax Description


`minutes`	Length of time, in minutes, for which a RADIUS server is skipped over by transaction requests, up to a maximum of 1440 (24 hours). The range is from 1 to 1440. The default value is 0.

Command Default

Dead time is set to 0.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

A RADIUS server marked as dead is skipped by additional requests for the duration of minutes unless all other servers are marked dead and there is no rollover method.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example specifies five minutes of deadtime for RADIUS servers that fail to respond to authentication requests for the radius-server deadtime command:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# radius-server deadtime 5

radius-server key(BNG)

To set the authentication and encryption key for all RADIUS communications between the router and the RADIUS daemon, use the radius-server key command in Global Configuration mode. To disable the key, use the no form of this command.

radius-server key {0 clear-text-key | 7 encrypted-key | clear-text-key}

Syntax Description


0 `clear-text-key`	Specifies an unencrypted (cleartext) shared key.
7 `encrypted-key`	Specifies a encrypted shared key.
`clear-text-key`	Specifies an unencrypted (cleartext) shared key.

Command Default

The authentication and encryption key is disabled.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.2	This command was introduced.

Usage Guidelines

The key entered must match the key used on the RADIUS server. All leading spaces are ignored, but spaces within and at the end of the key are used. If you use spaces in your key, do not enclose the key in quotation marks unless the quotation marks themselves are part of the key.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to set the cleartext key to “samplekey:”


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# radius-server key 0 samplekey

The following example shows how to set the encrypted shared key to “anykey:”


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# radius-server key 7 anykey

Related Commands


Command	Description
key (RADIUS)	Specifies the authentication and encryption key that is used between the router and the RADIUS daemon running on the RADIUS server.
server-private (RADIUS)	Configures the IP address of the private RADIUS server for the group server.

radius-server retransmit(BNG)

To specify the number of times the Cisco IOS XR software retransmits a packet to a server before giving up, use the radius-server retransmit command in Global Configuration mode. To disable retransmission, use the no form of this command.

radius-server retransmit retries

Syntax Description


`retries`	Maximum number of retransmission attempts. The range is from 1 to 100. Default is 3.

Command Default

The RADIUS servers are retried three times, or until a response is received.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.2	This command was introduced.

Usage Guidelines

The RADIUS client tries all servers, allowing each one to time out before increasing the retransmit count.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to specify a retransmit counter value of five times:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# radius-server retransmit 5

Related Commands


Command	Description
radius-server key(BNG)	Sets the authentication and encryption key for all RADIUS communications between the router and the RADIUS daemon.
retransmit (RADIUS)	Specifies the number of times a RADIUS request is resent to a server if the server is not responding or is responding slowly.
server-private (RADIUS)	Configures the IP address of the private RADIUS server for the group server.

radius-server timeout(BNG)

To set the interval for which a router waits for a server host to reply before timing out, use the radius-server timeout command in Global Configuration mode. To restore the default, use the no form of this command.

radius-server timeout seconds

Syntax Description


`seconds`	Number that specifies the timeout interval, in seconds. Range is from 1 to 1000.

Command Default

5 seconds

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.2	This command was introduced.

Usage Guidelines

Use the radius-server timeout command to set the number of seconds a router waits for a server host to reply before timing out.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to change the interval timer to 10 seconds:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# radius-server timeout 10

Related Commands


Command	Description
radius-server key(BNG)	Sets the authentication and encryption key for all RADIUS communications between the router and the RADIUS daemon.
server-private (RADIUS)	Configures the IP address of the private RADIUS server for the group server.
timeout (RADIUS)	Specifies the number of seconds the router waits for the RADIUS server to reply before retransmitting.

radius source-interface(BNG)

To force RADIUS to use the IP address of a specified interface or subinterface for all outgoing RADIUS packets, use the radius source-interface command in Global Configuration mode. To prevent only the specified interface from being the default and not from being used for all outgoing RADIUS packets, use the no form of this command.

radius source-interface interface-name [vrf vrf-id]

Syntax Description


`interface-name`	Name of the interface that RADIUS uses for all of its outgoing packets.
vrf `vrf-id`	Specifies the name of the assigned VRF.

Command Default

If a specific source interface is not configured, or the interface is down or does not have an IP address configured, the system selects an IP address.

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 3.2	This command was introduced.
Release 3.4.0	The vrf keyword was added.

Usage Guidelines

Use the radius source-interface command to set the IP address of the specified interface or subinterface for all outgoing RADIUS packets. This address is used as long as the interface or subinterface is in the up state. In this way, the RADIUS server can use one IP address entry for every network access client instead of maintaining a list of IP addresses.

The specified interface or subinterface must have an IP address associated with it. If the specified interface or subinterface does not have an IP address or is in the down state, then RADIUS reverts to the default. To avoid this, add an IP address to the interface or subinterface or bring the interface to the up state.

The radius source-interface command is especially useful in cases in which the router has many interfaces or subinterfaces and you want to ensure that all RADIUS packets from a particular router have the same IP address.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to make RADIUS use the IP address of subinterface s2 for all outgoing RADIUS packets:


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# radius source-interface Loopback 10 vrf wal-mart

Related Commands


Command	Description
aaa group server tacacs+	Groups different RADIUS server hosts into distinct lists.
radius-server key(BNG)	Sets the authentication and encryption key for all RADIUS communications between the router and the RADIUS daemon.

retransmit (RADIUS)

To specify the number of times a RADIUS request is resent to a server if the server is not responding or is responding slowly, use the retransmit command in RADIUS server-group private configuration mode.

retransmit retries

Syntax Description


`retries`	The `retries` argument specifies the retransmit value. The range is from 1 to 100. If no retransmit value is specified, the global value is used.

Command Default

The default value is 3.

Command Modes

RADIUS server-group private configuration

Command History


Release	Modification
Release 3.4.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to set the retransmit value:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# aaa group server radius group1 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.1.1.1 auth-port 300 
RP/0/RP0/CPU0:router(config-sg-radius-private)# retransmit 100

Related Commands


Command	Description
aaa group server tacacs+	Groups different RADIUS server hosts into distinct lists.
server-private (RADIUS)	Configures the IP address of the private RADIUS server for the group server.
timeout (RADIUS)	Specifies the number of seconds the router waits for the RADIUS server to reply before retransmitting.

secret

To configure an encrypted or clear-text password for the user, use the secret command in username configuration mode or line template configuration mode. To remove this configuration, use the no form of this command.

secret [0 [enc-type enc-type-value] | 5 | 8 | 9] secret-login

Syntax Description

0

(Optional) Specifies that an unencrypted (clear-text) password follows.

5

Specifies that an MD5-encrypted password (secret) follows.

8

(Optional) Specifies that SHA256-encrypted password follows.

9

(Optional) Specifies that scrypt-encrypted password follows.

secret-login

Configures the specified secret for the user.

Can be clear text (for Type 0 secret) or text string in alphanumeric characters that is stored as encrypted password entered by the user in association with the user’s login ID.

Can be up to 253 characters in length.

Note

The characters entered must conform to the respective encryption standards.

enc-type

(Optional) Configures the encryption type for a password entered in clear text.

enc-type-value

Specifies the encryption type to be used.

Prior to Release 6.3.1, the only supported value was 5. (See Release History and Usage Guidelines sections for the currently supported values).

Command Default

No password is specified.

Command Modes

Username configuration

Line template configuration

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.3.0	The `password` argument was replaced with the `secret-login` argument.
Release 6.3.1	Added the support for Type 8 (SHA256) and Type 9 (scrypt) encryption for secret configuration. Added the support for enc-type option under secret 0 to specify the type of encryption for password entered in clear-text format.

Usage Guidelines

Prior to Release 6.3.1, Cisco IOS XR software allows you to configure only Message Digest 5 (MD5) encryption for username logins and passwords. MD5 encryption is a one-way hash function that makes reversal of an encrypted password impossible, providing strong encryption protection. Using MD5 encryption, you cannot retrieve clear-text passwords. Therefore, MD5 encrypted passwords cannot be used with protocols that require the clear-text password to be retrievable, such as Challenge Handshake Authentication Protocol (CHAP).

When an EXEC process is started on a line that has password protection, the process prompts for the secret. If the user enters the correct secret, the process issues the prompt. The user can try entering the secret thrice before the terminal returns to the idle state.

Secrets are one-way encrypted and should be used for login activities that do not require a decryptable secret.

To verify that respective password encryption has been enabled, use the show running-config command. For example, if the command output shows “username name secret 5”, it means that enhanced password security with MD5 encryption is enabled.

Note

The show running-config command does not display the login password in clear text when the 0 option is used to specify an unencrypted password. See the “Examples” section.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to establish the clear-text secret “lab” for the user user2 :


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# username user2    
RP/0/RP0/CPU0:router(config-un)# secret 0 lab   
RP/0/RP0/CPU0:router(config-un)# commit 
RP/0/RP0/CPU0:router(config-un)# show running-config 
Building configuration...
username user2
 secret 5 $1$DTmd$q7C6fhzje7Cc7Xzmu2Frx1
!
end

Related Commands


Command	Description
group (AAA)	Adds a user to a group.
password (AAA)	Creates a login password for a user.
usergroup	Accesses user group configuration mode and configures a user group, associating it with a set of task groups.
username	Accesses username configuration mode and configures a new user with a username, establishing a password and granting permissions for that user.

server (RADIUS)

To associate a particular RADIUS server with a defined server group, use the server command in RADIUS server-group configuration mode. To remove the associated server from the server group, use the no form of this command.

server ip-address [auth-port port-number] [acct-port port-number]

Syntax Description


`ip-address`	IP address of the RADIUS server host.
auth-port `port-number`	(Optional) Specifies the User Datagram Protocol (UDP) destination port for authentication requests. The port-number argument specifies the port number for authentication requests. The host is not used for authentication if this value is set to 0. Default is 1645.
acct-port `port-number`	(Optional) Specifies the UDP destination port for accounting requests. The port-number argument specifies the port number for accounting requests. The host is not used for accounting services if this value is set to 0. Default is 1646.

Command Default

If no port attributes are defined, the defaults are as follows:

Authentication port: 1645
Accounting port: 1646

Command Modes

RADIUS server-group configuration

Command History


Release	Modification
Release 3.2	This command was introduced.

Usage Guidelines

Use the server command to associate a particular RADIUS server with a defined server group.

There are two different ways in which you can identify a server, depending on the way you want to offer AAA services. You can identify the server simply by using its IP address, or you can identify multiple host instances or entries using the optional auth-port and acct-port keywords.

When you use the optional keywords, the network access server identifies RADIUS security servers and host instances associated with a group server based on their IP address and specific UDP port numbers. The combination of the IP address and UDP port number creates a unique identifier, allowing different ports to be individually defined as RADIUS host entries providing a specific AAA service. If two different host entries on the same RADIUS server are configured for the same service, for example, accounting, the second host entry configured acts as an automatic switchover backup to the first one. Using this example, if the first host entry fails to provide accounting services, the network access server tries the second host entry configured on the same device for accounting services. (The RADIUS host entries are tried in the order they are configured.)

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to use two different host entries on the same RADIUS server that are configured for the same services—authentication and accounting. The second host entry configured acts as switchover backup to the first one.


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# aaa group server radius group1 
RP/0/RP0/CPU0:router(config-sg-radius)# server 10.1.1.1 auth-port 1645 acct-port 1646 
RP/0/RP0/CPU0:router(config-sg-radius)# server 10.2.2.2 auth-port 2000 acct-port 2001

Related Commands


Command	Description
aaa group server radius	Groups different RADIUS server hosts into distinct lists and distinct methods.
deadtime (server-group configuration)	Configures the deadtime value at the RADIUS server group level.
server-private (RADIUS)	Configures the IP address of the private RADIUS server for the group server.

server (TACACS+)

To associate a particular TACACS+ server with a defined server group, use the server command in TACACS+ server-group configuration mode. To remove the associated server from the server group, use the no form of this command.

server {hostname | ip-address}

Syntax Description


`hostname`	Character string used to name the server host.
`ip-address`	IP address of the server host.

Command Default

None

Command Modes

TACACS+ server-group configuration

Command History


Release	Modification
Release 2.0	This command was introduced.

Usage Guidelines

The server need not be accessible during configuration. Later, you can reference the configured server group from the method lists used to configure authentication, authorization, and accounting (AAA).

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to associate the TACACS+ server with the IP address 192.168.60.15 with the server group tac1:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# aaa group server tacacs+ tac1 
RP/0/RP0/CPU0:router(config-sg-tacacs+)# server 192.168.60.15

Related Commands


Command	Description
aaa group server tacacs+	Groups different TACACS+ server hosts into distinct lists.

server-private (RADIUS)

To configure the IP address of the private RADIUS server for the group server, use the server-private command in RADIUS server-group configuration mode. To remove the associated private server from the AAA group server, use the no form of this command .

server-private ip-address [auth-port port-number] [acct-port port-number] [timeout seconds] [retransmit retries] [key string]

Syntax Description


`ip-address`	IP address of the RADIUS server host.
auth-port `port-number`	(Optional) Specifies the User Datagram Protocol (UDP) destination port for authentication requests. The port-number argument specifies the port number for authentication requests. The host is not used for authentication if this value is set to 0. The default value is 1645.
acct-port `port-number`	(Optional) Specifies the UDP destination port for accounting requests. The port-number argument specifies the port number for accounting requests. The host is not used for accounting services if this value is set to 0. The default value is 1646.
timeout `seconds`	(Optional) Specifies the number of seconds the router waits for the RADIUS server to reply before retransmitting. The setting overrides the global value of the radius-server timeout command. If no timeout is specified, the global value is used. The `seconds` argument specifies the timeout value in seconds. The range is from 1 to 1000. If no timeout is specified, the global value is used.
retransmit `retries`	(Optional) Specifies the number of times a RADIUS request is resent to a server if the server is not responding or is responding slowly. The setting overrides the global setting of the radius-server transmit command. The `retries` argument specifies the retransmit value. The range is from 1 to 100. If no retransmit value is specified, the global value is used.
key `string`	(Optional) Specifies the authentication and encryption key that is used between the router and the RADIUS daemon running on the RADIUS server. This key overrides the global setting of the radius-server key command. If no key string is specified, the global value is used.

Command Default

If no port attributes are defined, the defaults are as follows:

Authentication port: 1645
Accounting port: 1646

Command Modes

RADIUS server-group configuration

Command History


Release	Modification
Release 3.4.0	This command was introduced.

Usage Guidelines

Use the server-private command to associate a particular private server with a defined server group. Possible overlapping of IP addresses between VRF instances are permitted. Private servers (servers with private addresses) can be defined within the server group and remain hidden from other groups, while the servers in the global pool (for example, default radius server group) can still be referred to by IP addresses and port numbers. Thus, the list of servers in server groups includes references to the hosts in the configuration and the definitions of private servers.

Both the auth-port and acct-port keywords enter RADIUS server-group private configuration mode.

Task ID


Task ID	Operations
aaa	read, write

Examples

The following example shows how to define the group1 RADIUS group server, to associate private servers with it, and to enter RADIUS server-group private configuration mode:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# aaa group server radius group1 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.1.1.1 timeout 5 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.1.1.1 retransmit 3 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.1.1.1 key coke 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.1.1.1 auth-port 300 
RP/0/RP0/CPU0:router(config-sg-radius-private)# exit 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.2.2.2 timeout 5 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.2.2.2 retransmit 3 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.2.2.2 key coke 
RP/0/RP0/CPU0:router(config-sg-radius)# server-private 10.2.2.2 auth-port 300 
RP/0/RP0/CPU0:router(config-sg-radius-private)#

Related Commands


Command	Description
aaa group server tacacs+	Groups different RADIUS server hosts into distinct lists and distinct methods.
radius-server key(BNG)	Sets the authentication and encryption key for all RADIUS communication between the router and the RADIUS daemon.
radius-server retransmit(BNG)	Specifies the number of times the Cisco IOS XR software retransmits a packet to a server before giving up.
radius-server timeout(BNG)	Sets the interval for which a router waits for a server host to reply before timing out.
key (RADIUS)	Specifies the authentication and encryption key that is used between the router and the RADIUS daemon running on the RADIUS server.
retransmit (RADIUS)	Specifies the number of times a RADIUS request is resent to a server if the server is not responding or is responding slowly.
timeout (RADIUS)	Specifies the number of seconds the router waits for the RADIUS server to reply before retransmitting.
vrf (RADIUS)	Configures the Virtual Private Network (VPN) routing and forwarding (VRF) reference of an AAA RADIUS server group.

server-private (TACACS+)

To configure the IP address of the private TACACS+ server for the group server, use the server-private command in TACACS+ server-group configuration mode. To remove the associated private server from the AAA group server, use the no form of this command.

server-private {hostname | ip-address} [port port-number] [timeout seconds] [key string]

Syntax Description


`hostname`	Character string used to name the server host.
`ip-address`	IP address of the TACACS+ server host. Both IPv4 and IPv6 addresses are supported.
port `port-number`	(Optional) Specifies a server port number. This option overrides the default, which is port 49. Valid port numbers range from 1 to 65535.
timeout `seconds`	(Optional) Specifies, in seconds, a timeout value that sets the length of time the authentication, authorization, and accounting (AAA) server waits to receive a response from the TACACS+ server. This option overrides the global timeout value set with the tacacs-server timeout command for only this server. The range is from 1 to 1000. The default is 5.
key `string`	(Optional) Specifies the authentication and encryption key that is used between the router and the TACACS+ daemon running on the TACACS+ server. This key overrides the global setting of the tacacs-server key command. If no key string is specified, the global value is used.

Command Default

The port-name argument, if not specified, defaults to the standard port 49.

The seconds argument, if not specified, defaults to 5 seconds.

Command Modes

TACACS+ server-group configuration

Command History


Release	Modification
Release 5.3.0	IPv6 support was introduced.
Release 4.1.0	This command was introduced.

Usage Guidelines

Use the server-private command to associate a particular private server with a defined server group. Possible overlapping of IP addresses between VRF instances are permitted. Private servers (servers with private addresses) can be defined within the server group and remain hidden from other groups, while the servers in the global pool (for example, default tacacs+ server group) can still be referred by IP addresses and port numbers. Therefore, the list of servers in server groups includes references to the hosts in the global configuration and the definitions of private servers.

Task ID


Task ID	Operations
aaa	read, write

Examples

This example shows how to define the myserver TACACS+ group server, to associate private servers with it, and to enter TACACS+ server-group private configuration mode:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# aaa group server tacacs+ myserver 
RP/0/RP0/CPU0:router(config-sg-tacacs+)# server-private 10.1.1.1 timeout 5 
RP/0/RP0/CPU0:router(config-sg-tacacs+)# server-private 10.1.1.1 key a_secret 
RP/0/RP0/CPU0:router(config-sg-tacacs+)# server-private 10.1.1.1 port 51 
RP/0/RP0/CPU0:router(config-sg-tacacs-private)# exit 
RP/0/RP0/CPU0:router(config-sg-tacacs+)# server-private 10.2.2.2 timeout 5 
RP/0/RP0/CPU0:router(config-sg-tacacs+)# server-private 10.2.2.2 key coke 
RP/0/RP0/CPU0:router(config-sg-tacacs+)# server-private 10.2.2.2 port 300 
RP/0/RP0/CPU0:router(config-sg-tacacs-private)#

Related Commands


Command	Description
aaa group server tacacs+	Groups different TACACS+ server hosts into distinct lists and distinct methods.
tacacs-server key	Sets the authentication encryption key used for all TACACS+ communications between the router and the TACACS+ daemon.
tacacs-server timeout	Sets the interval for which a router waits for a server host to reply before timing out.
key (TACACS+)	Specifies an authentication and encryption key shared between the AAA server and the TACACS+ server.
timeout (TACACS+)	Specifies a timeout value that sets the length of time the authentication, authorization, and accounting (AAA) server waits to receive a response from the TACACS+ server.
vrf (TACACS+)	Configures the Virtual Private Network (VPN) routing and forwarding (VRF) reference of an AAA TACACS+ server group.

show aaa

To display information about an Internet Key Exchange (IKE) Security Protocol group, user group, local user, login traces, or task group; to list all task IDs associated with all IKE groups, user groups, local users, or task groups in the system; or to list all task IDs for a specified IKE group, user group, local user, or task group, use the show aaa command in EXEC mode.

show aaa {ikegroup ikegroup-name | login trace | usergroup [usergroup-name] | trace | userdb [username] | task supported | taskgroup [root-lr | netadmin | operator | sysadmin | root-system | service-admin | cisco-support | askgroup-name]}

Syntax Description

ikegroup

Displays details for all IKE groups.

ikegroup-name

(Optional) IKE group whose details are to be displayed.

login trace

Displays trace data for login subsystem.

usergroup

Displays details for all user groups.

root-lr

(Optional) Usergroup name.

netadmin

(Optional) Usergroup name.

operator

(Optional) Usergroup name.

sysadmin

(Optional) Usergroup name.

root-system

(Optional) Usergroup name.

cisco-support

(Optional) Usergroup name.

usergroup-name

(Optional) Usergroup name.

trace

Displays trace data for AAA subsystem.

userdb

Displays details for all local users and the usergroups to which each user belongs.

username

(Optional) User whose details are to be displayed.

task supported

Displays all AAA task IDs available.

taskgroup

Displays details for all task groups.

Note

For taskgroup keywords, see optional usergroup name keyword list.

taskgroup-name

(Optional) Task group whose details are to be displayed.

Command Default

Details for all user groups, or all local users, or all task groups are listed if no argument is entered.

Command Modes

EXEC mode

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.4.0	The ikegroup keyword was added.
Release 3.5.0	The show task supported command was removed andits topic was added as a keyword for the show aaa command.

Usage Guidelines

Use the show aaa command to list details for all IKE groups, user groups, local users, AAA task IDs, or task groups in the system. Use the optional ikegroup-name , usergroup-name , username , or taskgroup-name argument to display the details for a specified IKE group, user group, user, or task group, respectively.

Task ID


Task ID	Operations
aaa	read

Examples

The following sample output is from the show aaa command, using the ikegroup keyword:


RP/0/RP0/CPU0:router# show aaa ikegroup

IKE Group ike-group
        Max-Users = 50
IKE Group ikeuser
        Group-Key = test-password
        Default Domain = cisco.com
IKE Group ike-user

The following sample output is from the show aaa command, using the usergroup command:


RP/0/RP0/CPU0:router# show aaa usergroup operator

User group 'operator'
  Inherits from task group 'operator'
User group 'operator' has the following combined set
of task IDs (including all inherited groups):
Task:       basic-services  : READ    WRITE    EXECUTE DEBUG
Task:                  cdp  : READ
Task:                 diag  : READ
Task:           ext-access  : READ             EXECUTE
Task:              logging  : READ

The following sample output is from the show aaa command, using the taskgroup keyword for a task group named netadmin:


RP/0/RP0/CPU0:router# show aaa taskgroup netadmin

Task group 'netadmin'

Task group 'netadmin' has the following combined set
  of task IDs (including all inherited groups):

Task:                  aaa  : READ                             
Task:                  acl  : READ    WRITE    EXECUTE    DEBUG
Task:                admin  : READ                             
Task:                 ancp  : READ    WRITE    EXECUTE    DEBUG
Task:                  atm  : READ    WRITE    EXECUTE    DEBUG
Task:       basic-services  : READ    WRITE    EXECUTE    DEBUG
Task:                 bcdl  : READ                             
Task:                  bfd  : READ    WRITE    EXECUTE    DEBUG
Task:                  bgp  : READ    WRITE    EXECUTE    DEBUG
Task:                 boot  : READ    WRITE    EXECUTE    DEBUG
Task:               bundle  : READ    WRITE    EXECUTE    DEBUG
Task:                  cdp  : READ    WRITE    EXECUTE    DEBUG
Task:                  cef  : READ    WRITE    EXECUTE    DEBUG
Task:                  cgn  : READ    WRITE    EXECUTE    DEBUG
Task:          config-mgmt  : READ    WRITE    EXECUTE    DEBUG
Task:      config-services  : READ    WRITE    EXECUTE    DEBUG
Task:               crypto  : READ    WRITE    EXECUTE    DEBUG
Task:                 diag  : READ    WRITE    EXECUTE    DEBUG
Task:              drivers  : READ                             
Task:                 dwdm  : READ    WRITE    EXECUTE    DEBUG
Task:                  eem  : READ    WRITE    EXECUTE    DEBUG
Task:                eigrp  : READ    WRITE    EXECUTE    DEBUG
Task:    ethernet-services  : READ                             
Task:           ext-access  : READ    WRITE    EXECUTE    DEBUG
Task:               fabric  : READ    WRITE    EXECUTE    DEBUG
Task:            fault-mgr  : READ    WRITE    EXECUTE    DEBUG
Task:           filesystem  : READ    WRITE    EXECUTE    DEBUG
Task:             firewall  : READ    WRITE    EXECUTE    DEBUG
Task:                   fr  : READ    WRITE    EXECUTE    DEBUG
Task:                 hdlc  : READ    WRITE    EXECUTE    DEBUG
Task:        host-services  : READ    WRITE    EXECUTE    DEBUG
Task:                 hsrp  : READ    WRITE    EXECUTE    DEBUG
Task:            interface  : READ    WRITE    EXECUTE    DEBUG
Task:            inventory  : READ                             
Task:          ip-services  : READ    WRITE    EXECUTE    DEBUG
Task:                 ipv4  : READ    WRITE    EXECUTE    DEBUG
Task:                 ipv6  : READ    WRITE    EXECUTE    DEBUG
Task:                 isis  : READ    WRITE    EXECUTE    DEBUG
Task:                l2vpn  : READ    WRITE    EXECUTE    DEBUG
Task:                   li  : READ    WRITE    EXECUTE    DEBUG
Task:              logging  : READ    WRITE    EXECUTE    DEBUG
Task:                 lpts  : READ    WRITE    EXECUTE    DEBUG
Task:              monitor  : READ                             
Task:             mpls-ldp  : READ    WRITE    EXECUTE    DEBUG
Task:          mpls-static  : READ    WRITE    EXECUTE    DEBUG
Task:              mpls-te  : READ    WRITE    EXECUTE    DEBUG
Task:            multicast  : READ    WRITE    EXECUTE    DEBUG
Task:              netflow  : READ    WRITE    EXECUTE    DEBUG
Task:              network  : READ    WRITE    EXECUTE    DEBUG
Task:                 ospf  : READ    WRITE    EXECUTE    DEBUG
Task:                 ouni  : READ    WRITE    EXECUTE    DEBUG
Task:             pkg-mgmt  : READ                             
Task:              pos-dpt  : READ    WRITE    EXECUTE    DEBUG
Task:                  ppp  : READ    WRITE    EXECUTE    DEBUG
Task:                  qos  : READ    WRITE    EXECUTE    DEBUG
Task:                  rib  : READ    WRITE    EXECUTE    DEBUG
Task:                  rip  : READ    WRITE    EXECUTE    DEBUG
Task:              root-lr  : READ                              (reserved)
Task:            route-map  : READ    WRITE    EXECUTE    DEBUG
Task:         route-policy  : READ    WRITE    EXECUTE    DEBUG
Task:                  sbc  : READ    WRITE    EXECUTE    DEBUG
Task:                 snmp  : READ    WRITE    EXECUTE    DEBUG
Task:            sonet-sdh  : READ    WRITE    EXECUTE    DEBUG
Task:               static  : READ    WRITE    EXECUTE    DEBUG
Task:               sysmgr  : READ                             
Task:               system  : READ    WRITE    EXECUTE    DEBUG
Task:            transport  : READ    WRITE    EXECUTE    DEBUG
Task:           tty-access  : READ    WRITE    EXECUTE    DEBUG
Task:               tunnel  : READ    WRITE    EXECUTE    DEBUG
Task:            universal  : READ                              (reserved)
Task:                 vlan  : READ    WRITE    EXECUTE    DEBUG
Task:                 vrrp  : READ    WRITE    EXECUTE    DEBUG

The following sample output is from the show aaa command, using the taskgroup keyword for an operator. The task group operator has the following combined set of task IDs, which includes all inherited groups:


Task:       basic-services  : READ    WRITE    EXECUTE    DEBUG
Task:                  cdp  : READ                              
Task:                 diag  : READ                              
Task:           ext-access  : READ             EXECUTE          
Task:              logging  : READ

The following sample output is from the show aaa command, using the taskgroup keyword for a root system. The task-group root system has the following combined set of task IDs, which includes all inherited groups:


Task:                  aaa  : READ    WRITE    EXECUTE    DEBUG
Task:                  acl  : READ    WRITE    EXECUTE    DEBUG
Task:               admin  : READ    WRITE    EXECUTE    DEBUG
Task:                  atm  : READ    WRITE    EXECUTE    DEBUG
Task:       basic-services  : READ    WRITE    EXECUTE    DEBUG
Task:                 bcdl  : READ    WRITE    EXECUTE    DEBUG
Task:                  bfd  : READ    WRITE    EXECUTE    DEBUG
Task:                  bgp  : READ    WRITE    EXECUTE    DEBUG
Task:                 boot  : READ    WRITE    EXECUTE    DEBUG
Task:               bundle  : READ    WRITE    EXECUTE    DEBUG
Task:                  cdp  : READ    WRITE    EXECUTE    DEBUG
Task:                  cef  : READ    WRITE    EXECUTE    DEBUG
Task:         config-mgmt  : READ    WRITE    EXECUTE    DEBUG
Task:          config-services  : READ    WRITE    EXECUTE    DEBUG
Task:               crypto  : READ    WRITE    EXECUTE    DEBUG
Task:                 diag  : READ    WRITE    EXECUTE    DEBUG
Task:              drivers  : READ    WRITE    EXECUTE    DEBUG
Task:           ext-access  : READ    WRITE    EXECUTE    DEBUG
Task:               fabric  : READ    WRITE    EXECUTE    DEBUG
Task:            fault-mgr  : READ    WRITE    EXECUTE    DEBUG
Task:           filesystem  : READ    WRITE    EXECUTE    DEBUG
Task:                   fr  : READ    WRITE    EXECUTE    DEBUG
Task:                 hdlc  : READ    WRITE    EXECUTE    DEBUG
Task:        host-services  : READ    WRITE    EXECUTE    DEBUG
Task:                 hsrp  : READ    WRITE    EXECUTE    DEBUG
Task:            interface  : READ    WRITE    EXECUTE    DEBUG
Task:            inventory  : READ    WRITE    EXECUTE    DEBUG
Task:         ip-services  : READ    WRITE    EXECUTE    DEBUG
Task:                 ipv4  : READ    WRITE    EXECUTE    DEBUG
Task:                 ipv6  : READ    WRITE    EXECUTE    DEBUG
Task:                 isis  : READ    WRITE    EXECUTE    DEBUG
Task:              logging  : READ    WRITE    EXECUTE    DEBUG
Task:                 lpts  : READ    WRITE    EXECUTE    DEBUG
Task:              monitor  : READ    WRITE    EXECUTE    DEBUG
Task:             mpls-ldp  : READ    WRITE    EXECUTE    DEBUG
Task:              mpls-static  : READ    WRITE    EXECUTE    DEBUG
Task:              mpls-te  : READ    WRITE    EXECUTE    DEBUG
Task:           multicast  : READ    WRITE    EXECUTE    DEBUG
Task:              netflow  : READ    WRITE    EXECUTE    DEBUG
Task:              network  : READ    WRITE    EXECUTE    DEBUG
Task:                 ospf  : READ    WRITE    EXECUTE    DEBUG
Task:                 ouni  : READ    WRITE    EXECUTE    DEBUG
Task:             pkg-mgmt  : READ    WRITE    EXECUTE    DEBUG
Task:              pos-dpt  : READ    WRITE    EXECUTE    DEBUG
Task:                  ppp  : READ    WRITE    EXECUTE    DEBUG
Task:                  qos  : READ    WRITE    EXECUTE    DEBUG
Task:                  rib  : READ    WRITE    EXECUTE    DEBUG
Task:                  rip  : READ    WRITE    EXECUTE    DEBUG
Task:              root-lr  : READ    WRITE    EXECUTE    DEBUG
Task:          root-system  : READ    WRITE    EXECUTE    DEBUG
Task:            route-map  : READ    WRITE    EXECUTE    DEBUG
Task:         route-policy  : READ    WRITE    EXECUTE    DEBUG
Task:                 snmp  : READ    WRITE    EXECUTE    DEBUG
Task:            sonet-sdh  : READ    WRITE    EXECUTE    DEBUG
Task:               static  : READ    WRITE    EXECUTE    DEBUG
Task:               sysmgr  : READ    WRITE    EXECUTE    DEBUG
Task:               system  : READ    WRITE    EXECUTE    DEBUG
Task:            transport  : READ    WRITE    EXECUTE    DEBUG
Task:           tty-access  : READ    WRITE    EXECUTE    DEBUG
Task:               tunnel  : READ    WRITE    EXECUTE    DEBUG
Task:            universal  : READ    WRITE    EXECUTE    DEBUG
Task:                 vlan  : READ    WRITE    EXECUTE    DEBUG
Task:                 vrrp  : READ    WRITE    EXECUTE    DEBUG

The following sample output is from show aaa command with the userdb keyword:


RP/0/RP0/CPU0:router# show aaa userdb

Username lab (admin plane)
User group root-system
User group cisco-support
Username acme
User group root-system

The following sample output is from the show aaa command, using the task supported keywords. Task IDs are displayed in alphabetic order.


RP/0/RP0/CPU0:router# show aaa task supported

aaa
acl
admin
atm
basic-services
bcdl
bfd
bgp
boot
bundle
cdp
cef
cisco-support
config-mgmt
config-services
crypto
diag
disallowed
drivers
eigrp
ext-access
fabric
fault-mgr
filesystem
firewall
fr
hdlc
host-services
hsrp
interface
inventory
ip-services
ipv4
ipv6
isis
logging
lpts
monitor
mpls-ldp
mpls-static
mpls-te
multicast
netflow
network
ospf
ouni
pkg-mgmt
pos-dpt
ppp
qos
rib
rip
root-lr
root-system
route-map
route-policy
sbc
snmp
sonet-sdh
static
sysmgr
system
transport
tty-access
tunnel
universal
vlan
vrrp

Related Commands


Command	Description
show user	Displays task IDs enabled for the currently logged-in user.

show aaa password-policy

To display the details of AAA password policy configured in a system, use the show aaa password-policy command in EXEC mode.

show aaa password-policy [policy-name]

Syntax Description


`policy-name`	Specifies the name of password policy.

Command Default

None

Command Modes

EXEC mode

Command History


Release	Modification
Release 6.2.1	This command was introduced.
Release 7.2.1	This release introduces the following output: Warning Interval Restrict Old Time Maximum Char Repetition Restrict Old Count Restrict Username Restrict Username Reverse Restrict Password Reverse Restrict Password Advanced

Usage Guidelines

If the option policy-name is not specified, the command output displays the details of all password policies configured in the system.

Refer aaa password-policy command details of each field in this command output.

Task ID


Task ID	Operation
aaa	read

Examples

This is a sample out of show aaa password-policy command:


RP/0/RP0/CPU0:router#show aaa password-policy test-policy

Fri Feb  3 16:50:58.086 EDT
Password Policy Name : test-policy
  Number of Users : 1
  Minimum Length : 2
  Maximum Length : 253
  Special Character Len : 0
  Uppercase Character Len : 0
  Lowercase Character Len : 1
  Numeric Character Len : 0
  Policy Life Time :
    seconds : 0
    minutes : 0
    hours : 0
    days : 0
    months : 0
    years : 0
 Warning Interval :
    seconds : 0
    minutes : 0
    hours : 0
    days : 0
    months : 2
    years : 0
Lockout Time :
    seconds : 0
    minutes : 0
    hours : 0
    days : 0
    months : 0
    years : 0
 Restrict Old Time :
    days : 0
    months : 0
    years : 3
Character Change Len : 4
Maximum Failure Attempts : 3
Reference Count : 0
Error Count : 0
Lockout Count Attempts : 0
Maximum char repetition : 3
Restrict Old count : 3
Restrict Username : 1
Restrict Username Reverse  : 1
Restrict Password Reverse  : 1
Restrict Password Advanced : 1
RP/0/RSP0/CPU0:ios#

Related Commands

Command	Description
aaa password-policy	Defines the FIPS-compliant AAA password security policy.

show radius

To display information about the RADIUS servers that are configured in the system, use the show radius command in EXEC mode.

show radius

Syntax Description

This command has no keywords or arguments.

Command Default

If no radius servers are configured, no output is displayed.

Command Modes

EXEC mode

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

Use the show radius command to display statistics for each configured RADIUS server.

Task ID


Task ID	Operations
aaa	read

Examples

The following sample output is for the show radius command:

Output for IPV4 server


RP/0/RP0/CPU0:router# show radius

Global dead time: 0 minute(s)
Number of Servers: 1

Server: 2.3.4.5/2000/2001  is UP
  Address family: IPv6
  Total Deadtime: 0s Last Deadtime: 0s
  Timeout: 5 sec, Retransmit limit: 3
  Quarantined: No

Output for IPV6 server


RP/0/RP0/CPU0:router# show radius

Global dead time: 0 minute(s)
Number of Servers: 1

Server: 2001:b::2/2000/2001  is UP
  Address family: IPv6
  Total Deadtime: 0s Last Deadtime: 0s
  Timeout: 5 sec, Retransmit limit: 3
  Quarantined: No

This table describes the significant fields shown in the display.

Table 1. show radius Field Descriptions
Field	Description
Server	Server IP address/UDP destination port for authentication requests/UDP destination port for accounting requests.
Timeout	Number of seconds the router waits for a server host to reply before timing out.
Retransmit limit	Number of times the Cisco IOS XR software searches the list of RADIUS server hosts before giving up.

Related Commands


Command	Description
vrf (RADIUS)	Configures the Virtual Private Network (VPN) routing and forwarding (VRF) reference of an AAA RADIUS server group.
radius-server retransmit(BNG)	Specifies how many times Cisco IOS XR software searches the list of RADIUS server hosts before giving up.
radius-server timeout(BNG)	Sets the interval for which a router waits for a server host to reply.

show radius accounting

To obtain information and detailed statistics for the RADIUS accounting server and port, use the show radius accounting command in EXEC mode.

show radius accounting

Syntax Description

This command has no keywords or arguments.

Command Default

If no RADIUS servers are configured on the router, the output is empty. If the default values are for the counter (for example, request and pending), the values are all zero because the RADIUS server was just defined and not used yet.

Command Modes

EXEC mode

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operations
aaa	read

Examples

The following sample output is displayed on a per-server basis for the show radius accounting command:


RP/0/RP0/CPU0:router# show radius accounting

Server: 12.26.25.61, port: 1813
0 requests, 0 pending, 0 retransmits
0 responses, 0 timeouts, 0 bad responses
0 bad authenticators, 0 unknown types, 0 dropped
0 ms latest rtt

Server: 12.26.49.12, port: 1813
0 requests, 0 pending, 0 retransmits
0 responses, 0 timeouts, 0 bad responses
0 bad authenticators, 0 unknown types, 0 dropped
0 ms latest rtt

Server: 12.38.28.18, port: 29199
0 requests, 0 pending, 0 retransmits
0 responses, 0 timeouts, 0 bad responses
0 bad authenticators, 0 unknown types, 0 dropped
0 ms latest rtt

This table describes the significant fields shown in the display.

Table 2. show radius accounting Field Descriptions
Field	Description
Server	Server IP address/UDP destination port for authentication requests; UDP destination port for accounting requests.

Related Commands


Command	Description
aaa accounting	Creates a method list for accounting.
aaa authentication	Creates a method list for authentication.
show radius authentication	Obtains information and detailed statistics for the RADIUS authentication server and port.

show radius authentication

To obtain information and detailed statistics for the RADIUS authentication server and port, use the show radius authentication command in EXEC mode.

show radius authentication

Syntax Description

This command has no keywords or arguments.

Command Default

If no RADIUS servers are configured on the router, the output is empty. If the default values are for the counter (for example, request and pending), the values are all zero because the RADIUS server was just defined and not used yet.

Command Modes

EXEC mode

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operations
aaa	read

Examples

The following sample output is for the show radius authentication command:


RP/0/RP0/CPU0:router# show radius authentication 

Server: 12.26.25.61, port: 1812
0 requests, 0 pending, 0 retransmits
0 accepts, 0 rejects, 0 challenges
0 timeouts, 0 bad responses, 0 bad authenticators
0 unknown types, 0 dropped, 0 ms latest rtt

Server: 12.26.49.12, port: 1812
0 requests, 0 pending, 0 retransmits
0 accepts, 0 rejects, 0 challenges
0 timeouts, 0 bad responses, 0 bad authenticators
0 unknown types, 0 dropped, 0 ms latest rtt

Server: 12.38.28.18, port: 21099
0 requests, 0 pending, 0 retransmits
0 accepts, 0 rejects, 0 challenges
0 timeouts, 0 bad responses, 0 bad authenticators
0 unknown types, 0 dropped, 0 ms latest rtt

This table describes the significant fields shown in the display.

Table 3. show radius authentication Field Descriptions
Field	Description
Server	Server IP address/UDP destination port for authentication requests; UDP destination port for accounting requests.

Related Commands


Command	Description
aaa accounting	Creates a method list for accounting.
aaa authentication	Creates a method list for authentication.
show radius accounting	Obtains information and detailed statistics for the RADIUS accounting server and port.

show radius client

To obtain general information about the RADIUS client on Cisco IOS XR software, use the show radius client command in EXEC mode.

show radius client

Syntax Description

This command has no keywords or arguments.

Command Default

The default value for the counters (for example, an invalid address) is 0. The network access server (NAS) identifier is the hostname that is defined on the router.

Command Modes

EXEC mode

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

The show radius client command displays the authentication and accounting responses that are received from the invalid RADIUS servers, for example, unknown to the NAS. In addition, the show radius client command displays the hostname or NAS identifier for the RADIUS authentication client, accounting client, or both.

Task ID


Task ID	Operations
aaa	read

Examples

The following sample output is for the show radius client command:


RP/0/RP0/CPU0:router# show radius client 

Client NAS identifier:                          miniq
Authentication responses from invalid addresses:      0
Accounting responses from invalid addresses:          0

This table describes the significant fields shown in the display.

Table 4. show radius client Field Descriptions
Field	Description
Client NAS identifier	Identifies the NAS-identifier of the RADIUS authentication client.

Related Commands


Command	Description
server (RADIUS)	Associates a particular RADIUS server with a defined server group.
show radius	Displays information about the RADIUS servers that are configured in the system.

show radius dead-criteria

To obtain information about the dead server detection criteria, use the show radius dead-criteria command in EXEC mode.

show radius dead-criteria host ip-addr [auth-port auth-port] [acct-port acct-port]

Syntax Description


host `ip-addr`	Specifies the name or IP address of the configured RADIUS server.
auth-port `auth-port`	(Optional) Specifies the authentication port for the RADIUS server. The default value is 1645.
acct-port `acct-port`	(Optional) Specifies the accounting port for the RADIUS server. The default value is 1646.

Command Default

The default values for time and tries are not fixed to a single value; therefore, they are calculated and fall within a range of 10 to 60 seconds for time and 10 to 100 for tries.

Command Modes

EXEC mode

Command History


Release	Modification
Release 3.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operations
aaa	read

Examples

The following sample output is for the show radius dead-criteria command:


RP/0/RP0/CPU0:router# show radius dead-criteria host 12.26.49.12 auth-port 11000 acct-port 11001 

Server: 12.26.49.12/11000/11001
Dead criteria time: 10 sec (computed) tries: 10 (computed)

This table describes the significant fields shown in the display.

Table 5. show radius dead-criteria Field Descriptions
Field	Description
Server	Server IP address/UDP destination port for authentication requests/UDP destination port for accounting requests.
Timeout	Number of seconds the router waits for a server host to reply before timing out.
Retransmits	Number of times Cisco IOS XR software searches the list of RADIUS server hosts before giving up.

Related Commands


Command	Description
radius-server dead-criteria time	Forces one or both of the criteria that is used to mark a RADIUS server as dead.
radius-server deadtime	Defines the length of time in minutes for a RADIUS server to remain marked dead.

show radius server-groups

To display information about the RADIUS server groups that are configured in the system, use the show radius server-groups command in EXEC mode.

show radius server-groups [group-name [detail]]

Syntax Description


`group-name`	(Optional) Name of the server group.The properties are displayed.
detail	(Optional) Displays properties for all the server groups.

Command Default

None

Command Modes

EXEC mode

Command History


Release	Modification
Release 3.2	This command was introduced.
Release 3.4.0	Support was added for the `group-name` argument and detail keyword.

Usage Guidelines

Use the show radius server-groups command to display information about each configured RADIUS server group, including the group name, numbers of servers in the group, and a list of servers in the named server group. A global list of all configured RADIUS servers, along with authentication and accounting port numbers, is also displayed.

Task ID


Task ID	Operations
aaa	read

Examples

The inherited global message is displayed if no group level deadtime is defined for this group; otherwise, the group level deadtime value is displayed and this message is omitted. The following sample output is for the show radius server-groups command:


RP/0/RP0/CPU0:router# show radius server-groups 

Global list of servers
  Contains 2 server(s)
    Server 10.1.1.1/1645/1646 
    Server 10.2.2.2/1645/1646 

Server group 'radgrp1' has 2 server(s)
  Dead time: 0 minute(s) (inherited from global)
  Contains 2 server(s)
    Server 10.1.1.1/1645/1646 
    Server 10.2.2.2/1645/1646 

Server group 'radgrp-priv' has 1 server(s)
  Dead time: 0 minute(s) (inherited from global)
  Contains 1 server(s)
    Server 10.3.3.3/1645/1646 [private]

The following sample output shows the properties for all the server groups in group “radgrp1:”


RP/0/RP0/CPU0:router# show radius server-groups radgrp1 detail 

Server group 'radgrp1' has 2 server(s)
    VRF default (id 0x60000000)
    Dead time: 0 minute(s) (inherited from global)
    Contains 2 server(s)
      Server 10.1.1.1/1645/1646
    Authentication:
      0 requests, 0 pending, 0 retransmits
      0 accepts, 0 rejects, 0 challenges
      0 timeouts, 0 bad responses, 0 bad authenticators
      0 unknown types, 0 dropped, 0 ms latest rtt
    Accounting:
      0 requests, 0 pending, 0 retransmits
      0 responses, 0 timeouts, 0 bad responses
      0 bad authenticators, 0 unknown types, 0 dropped
      0 ms latest rtt
      Server 10.2.2.2/1645/1646
    Authentication:
      0 requests, 0 pending, 0 retransmits
      0 accepts, 0 rejects, 0 challenges
      0 timeouts, 0 bad responses, 0 bad authenticators
      0 unknown types, 0 dropped, 0 ms latest rtt
    Accounting:
      0 requests, 0 pending, 0 retransmits
      0 responses, 0 timeouts, 0 bad responses
      0 bad authenticators, 0 unknown types, 0 dropped
      0 ms latest rtt

The following sample output shows the properties for all the server groups in detail in the group “raddgrp-priv:”


RP/0/RP0/CPU0:router# show radius server-groups radgrp-priv detail 

Server group 'radgrp-priv' has 1 server(s)
    VRF default (id 0x60000000)
    Dead time: 0 minute(s) (inherited from global)
    Contains 1 server(s)
      Server 10.3.3.3/1645/1646 [private]
    Authentication:
      0 requests, 0 pending, 0 retransmits
      0 accepts, 0 rejects, 0 challenges
      0 timeouts, 0 bad responses, 0 bad authenticators
      0 unknown types, 0 dropped, 0 ms latest rtt
    Accounting:
      0 requests, 0 pending, 0 retransmits
      0 responses, 0 timeouts, 0 bad responses
      0 bad authenticators, 0 unknown types, 0 dropped
      0 ms latest rtt

This table describes the significant fields shown in the display.

Table 6. show radius server-groups Field Descriptions
Field	Description
Server	Server IP address/UDP destination port for authentication requests/UDP destination port for accounting requests.

Related Commands


Command	Description
vrf (RADIUS)	Configures the Virtual Private Network (VPN) routing and forwarding (VRF) reference of an AAA RADIUS server group.

show tacacs

To display information about the TACACS+ servers that are configured in the system, use the show tacacs command in EXEC mode.

show tacacs

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC mode

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 5.3.0	IPv6 support was introduced on this command.

Usage Guidelines

Use the show tacacs command to display statistics for each configured TACACS+ server.

Task ID


Task ID	Operations
aaa	read

Examples

The following is sample output from the show tacacs command:


RP/0/RP0/CPU0:router# show tacacs

For IPv4 IP addresses:
Server:10.1.1.1/21212 opens=0 closes=0 aborts=0 errors=0
        packets in=0 packets out=0
        status=up single-connect=false

Server:10.2.2.2/21232 opens=0 closes=0 aborts=0 errors=0
        packets in=0 packets out=0
        status=up single-connect=false

For IPv6 IP addresses:
Server: 10.2.3.5/49  family = AF_INET opens=0 closes=0 aborts=0 errors=0
        packets in=0 packets out=0
        status=up single-connect=false

This table describes the significant fields shown in the display.

Table 7. show tacacs Field Descriptions
Field	Description
Server	Server IP address.
opens	Number of socket opens to the external server.
closes	Number of socket closes to the external server.
aborts	Number of tacacs requests that have been terminated midway.
errors	Number of error replies from the external server.
packets in	Number of TCP packets that have been received from the external server.
packets out	Number of TCP packets that have been sent to the external server.

show tacacs server-groups

To display information about the TACACS+ server groups that are configured in the system, use the show tacacs server-groups command in EXEC mode.

show tacacs server-groups

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC mode

Command History


Release	Modification
Release 3.2	This command was introduced.

Usage Guidelines

Use the show tacacs server-groups command to display information about each configured TACACS+ server group, including the group name, numbers of servers in the group, and a list of servers in the named server group. A global list of all configured TACACS+ servers is also displayed.

Task ID


Task ID	Operations
aaa	read

Examples

The following is sample output from the show tacacs server-groups command:


RP/0/RP0/CPU0:router# show tacacs server-groups

Global list of servers
  Server 192.168.25.61/23456
  Server 192.168.49.12/12345
  Server 192.168.49.12/9000
  Server 192.168.25.61/23432
  Server 10.5.5.5/23456
  Server 10.1.1.1/49
Server group ‘tac100’ has 1 servers
Server 192.168.49.12

This table describes the significant fields shown in the display.

Table 8. show tacacs server-groups Field Descriptions
Field	Description
Server	Server IP address.

Related Commands


Command	Description
tacacs-server host	Specifies a TACACS+ host.

show user

To display all user groups and task IDs associated with the currently logged-in user, use the show user command in EXEC mode.

show user [all | authentication | group | tasks]

Syntax Description


all	(Optional) Displays all user groups and task IDs for the currently logged-in user.
authentication	(Optional) Displays authentication method parameters for the currently logged-in user.
group	(Optional) Displays the user groups associated with the currently logged-in user.
tasks	(Optional) Displays task IDs associated with the currently logged-in user. The tasks keyword indicates which task is reserved in the sample output.

Command Default

When the show user command is used without any option, it displays the ID of the user who is logged in currently.

Command Modes

EXEC mode

Command History


Release	Modification
Release 2.0	This command was introduced.
Release 3.3.0	The following enhancements are added: An example was added to display all the group and tasks. The authentication keyword was added. The sample output for the group keyword was updated. The sample output to display whether or not a task is reserved for the tasks keyword was updated.

Usage Guidelines

Use the show user command to display all user groups and task IDs associated with the currently logged-in user.

Task ID


Task ID	Operations

Bias-Free Language

Results

Chapter: Authentication, Authorization, and Accounting Commands

Authentication, Authorization, and Accounting Commands

aaa accounting

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

aaa accounting system default

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

aaa accounting system rp-failover

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

aaa accounting update

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

aaa authentication

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

aaa authorization

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Examples

Related Commands

show nacm (XR-VM)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

aaa default-taskgroup

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

aaa group server radius

Syntax Description

Command Default