The AAA accounting feature allows the services that users are accessing and the amount of network resources that users are consuming to be tracked. When AAA accounting is enabled, the network access server reports user activity to the TACACS+ or RADIUS security server (depending on which security method is implemented) in the form of accounting records. Each accounting record contains accounting attribute-value (AV) pairs and is stored on the security server. This data can then be analyzed for network management, client billing, and auditing.
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to
www.cisco.com/go/cfn. An account on Cisco.com is not required.
Prerequisites for Configuring Accounting
The following tasks must be performed before configuring accounting using named method lists:
Enable AAA on the network access server.
Define the characteristics of the RADIUS or TACACS+ security server if RADIUS or TACACS+ authorization is issued. For more information about configuring the Cisco network access server to communicate with the RADIUS security server, see the chapter Configuring RADIUS. For more information about configuring the Cisco network access server to communicate with the TACACS+ security server, see the chapter Configuring TACACS+.
Restrictions for Configuring Accounting
The AAA Accounting feature has the following restrictions:
Accounting information can be sent simultaneously to a maximum of four AAA servers.
Service Selection Gateway (SSG) restriction--For SSG systems, the aaaaccountingnetworkbroadcast command broadcasts only start-stop accounting records. If interim accounting records are configured using thessgaccountinginterval command, the interim accounting records are sent only to the configured default RADIUS server.
Like authentication and authorization method lists, method lists for accounting define the way accounting is performed and the sequence in which these methods are performed.
Named accounting method lists allow a particular security protocol to be designated and used on specific lines or interfaces for accounting services. The only exception is the default method list (which, by coincidence, is named “default”). The default method list is automatically applied to all interfaces except those that have a named method list explicitly defined. A defined method list overrides the default method list.
A method list is a named list describing the accounting methods to be queried (such as RADIUS or TACACS+), in sequence. Method lists allow one or more security protocols to be designated and used for accounting, thus ensuring a backup system for accounting if the initial method fails. Cisco IOS XE software uses the first method listed to support accounting; if that method fails to respond, the Cisco IOS XE software selects the next accounting method listed in the method list. This process continues until there is successful communication with a listed accounting method, or all methods defined are exhausted.
Note
The Cisco IOS XE software attempts accounting with the next listed accounting method only when there is no response from the previous method. If accounting fails at any point in this cycle--meaning that the security server responds by denying the user access--the accounting process stops and no other accounting methods are attempted.
Accounting method lists are specific to the type of accounting being requested. AAA supports six different types of accounting:
Network--Provides information for all PPP, SLIP, or ARAP sessions, including packet and byte counts.
EXEC--Provides information about user EXEC terminal sessions of the network access server.
Command--Provides information about the EXEC mode commands that a user issues. Command accounting generates accounting records for all EXEC mode commands, including global configuration commands, associated with a specific privilege level.
Connection--Provides information about all outbound connections made from the network access server, such as Telnet, local-area transport (LAT), TN3270, packet assembler/disassembler (PAD), and rlogin.
System--Provides information about system-level events.
Resource--Provides “start” and “stop” records for calls that have passed user authentication, and provides “stop” records for calls that fail to authenticate.
Note
System accounting does not use named accounting lists; only the default list for system accounting can be defined.
When a named method list is created, a particular list of accounting methods for the indicated accounting type are defined.
Accounting method lists must be applied to specific lines or interfaces before any of the defined methods are performed. The only exception is the default method list (which is named “default”). If the aaaaccounting command for a particular accounting type is issued without a named method list specified, the default method list is automatically applied to all interfaces or lines except those that have a named method list explicitly defined. (A defined method list overrides the default method list.) If no default method list is defined, then no accounting takes place.
A server group is a way to group existing RADIUS or TACACS+ server hosts for use in method lists. The figure below shows a typical AAA network configuration that includes four security servers: R1 and R2 are RADIUS servers, and T1 and T2 are TACACS+ servers. R1 and R2 comprise the group of RADIUS servers. T1 and T2 comprise the group of TACACS+ servers.
In Cisco IOS XE software, RADIUS and TACACS+ server configurations are global. A subset of the configured server hosts can be specified using server groups. These server groups can be used for a particular service. For example, server groups allow R1 and R2 to be defined as separate server groups (SG1 and SG2), and T1 and T2 as separate server groups (SG3 and SG4). This means either R1 and T1 (SG1 and SG3) can be specified in the method list or R2 and T2 (SG2 and SG4) in the method list, which provides more flexibility in the way that RADIUS and TACACS+ resources are assigned.
Server groups also can include multiple host entries for the same server, as long as each entry has a unique identifier. The combination of an IP address and a UDP port number creates a unique identifier, allowing different ports to be individually defined as RADIUS hosts providing a specific 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 configured acts as failover 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 in which they are configured.)
For more information about configuring server groups and about configuring server groups based on DNIS numbers, see Configuring RADIUS module or Configuring TACACS+ module in the
Cisco IOS XE Security Configuration Guide: Securing User Services Release 2.
AAA Accounting Methods
Cisco IOS XE supports the following two methods for accounting:
TACACS+--The network access server reports user activity to the TACACS+ security server in the form of accounting records. Each accounting record contains accounting attribute-value (AV) pairs and is stored on the security server.
RADIUS--The network access server reports user activity to the RADIUS security server in the form of accounting records. Each accounting record contains accounting attribute-value (AV) pairs and is stored on the security server.
For minimal accounting, use the stop-only keyword, which instructs the specified method (RADIUS or TACACS+) to send a stop record accounting notice at the end of the requested user process. For more accounting information, use the start-stop keyword to send a start accounting notice at the beginning of the requested event and a stop accounting notice at the end of the event. To stop all accounting activities on this line or interface, use the none keyword.
Accounting Methods
The table below lists the supported accounting keywords.
Table 1 AAA Accounting Methods
Keyword
Description
groupradius
Uses the list of all RADIUS servers for accounting.
grouptacacs+
Uses the list of all TACACS+ servers for accounting.
group group-name
Uses a subset of RADIUS or TACACS+ servers for accounting as defined by the server group
group-name.
The method argument refers to the actual method the authentication algorithm tries. Additional methods of authentication are used only if the previous method returns an error, not if it fails. To specify that the authentication should succeed even if all other methods return an error, specify additional methods in the command. For example, to create a method list named acct_tac1 that specifies RADIUS as the backup method of authentication in the event that TACACS+ authentication returns an error, enter the following command:
aaa accounting network acct_tac1 stop-only group tacacs+ group radius
To create a default list that is used when a named list is
not specified in the
aaaaccountingcommand, use the
default keyword followed by the methods that are wanted to be used in default situations. The default method list is automatically applied to all interfaces.
For example, to specify RADIUS as the default method for user authentication during login, enter the following command:
aaa accounting network default stop-only group radius
AAA accounting supports the following methods:
grouptacacs--To have the network access server send accounting information to a TACACS+ security server, use the
grouptacacs+method keyword.
groupradius--To have the network access server send accounting information to a RADIUS security server, use the
groupradiusmethod keyword.
Note
Accounting method lists for SLIP follow whatever is configured for PPP on the relevant interface. If no lists are defined and applied to a particular interface (or no PPP settings are configured), the default setting for accounting applies.
groupgroup-name--To specify a subset of RADIUS or TACACS+ servers to use as the accounting method, use the
aaaaccountingcommand with the
groupgroup-name method. To specify and define the group name and the members of the group, use the
aaagroupserver command. For example, use the
aaagroupserver command to first define the members of
grouploginrad:
aaa group server radius loginrad
server 172.16.2.3
server 172.16.2 17
server 172.16.2.32
This command specifies RADIUS servers 172.16.2.3, 172.16.2.17, and 172.16.2.32 as members of the group
loginrad.
To specify
grouploginrad as the method of network accounting when no other method list has been defined, enter the following command:
aaa accounting network default start-stop group loginrad
Before a group name can be used as the accounting method, communication with the RADIUS or TACACS+ security server must be enabled.
AAA Accounting Types
Named accounting method lists are specific to the indicated type of accounting.
network--To create a method list to enable authorization for all network-related service requests (including SLIP, PPP, PPP NCPs, and ARAP protocols), use the
network keyword. For example, to create a method list that provides accounting information for ARAP (network) sessions, use the
arap keyword.
exec--To create a method list that provides accounting records about user EXEC terminal sessions on the network access server, including username, date, start and stop times, use the
exec keyword.
commands--To create a method list that provides accounting information about specific, individual EXEC commands associated with a specific privilege level, use the
commandskeyword.
connection--To create a method list that provides accounting information about all outbound connections made from the network access server, use the
connection keyword.
resource --To creates a method list to provide accounting records for calls that have passed user authentication or calls that failed to be authenticated.
Note
System accounting does not support named method lists.
EXEC accounting provides information about user EXEC terminal sessions (user shells) on the network access server, including username, date, start and stop times, the access server IP address, and (for dial-in users) the telephone number the call originated from.
The following example shows the information contained in a RADIUS EXEC accounting record for a dial-in user:
Command accounting provides information about the EXEC shell commands for a specified privilege level that are being executed on a network access server. Each command accounting record includes a list of the commands executed for that privilege level, as well as the date and time each command was executed, and the user who executed it.
The following example shows the information contained in a TACACS+ command accounting record for privilege level 1:
Wed Jun 27 03:46:47 2001 172.16.25.15 username1 tty3 5622329430/4327528 stop task_id=3 service=shell priv-lvl=1 cmd=show version <cr>
Wed Jun 27 03:46:58 2001 172.16.25.15 username1 tty3 5622329430/4327528 stop task_id=4 service=shell priv-lvl=1 cmd=show interfaces <cr>
Wed Jun 27 03:47:03 2001 172.16.25.15 username1 tty3 5622329430/4327528 stop task_id=5 service=shell priv-lvl=1 cmd=show ip route <cr>
The following example shows the information contained in a TACACS+ command accounting record for privilege level 15:
The Cisco Systems implementation of RADIUS does not support command accounting.
Connection Accounting
Connection accounting provides information about all outbound connections made from the network access server, such as Telnet, LAT, TN3270, PAD, and rlogin.
The following example shows the information contained in a RADIUS connection accounting record for an outbound Telnet connection:
Additional tasks for measuring system resources are covered in the Cisco IOS XE software configuration guides. For example, IP accounting tasks are described in the Configuring IP Services chapter in the
CiscoIOS XE Application Services Configuration Guide,
Release 2.
Resource Accounting
The Cisco implementation of AAA accounting provides “start” and “stop” record support for calls that have passed user authentication. The additional feature of generating “stop” records for calls that fail to authenticate as part of user authentication is also supported. Such records are necessary for users employing accounting records to manage and monitor their networks.
Before AAA resource failure stop accounting, there was no method of providing accounting records for calls that failed to reach the user authentication stage of a call setup sequence. Such records are necessary for users employing accounting records to manage and monitor their networks and their wholesale customers.
This functionality generates a “stop” accounting record for any calls that do not reach user authentication; “stop” records are generated from the moment of call setup. All calls that pass user authentication behave as they did before; that is, no additional accounting records are seen.
The figure below illustrates a call setup sequence with normal call flow (no disconnect) and without AAA resource failure stop accounting enabled.
Figure 1. Modem Dial-In Call Setup Sequence with Normal Flow and Without Resource Failure Stop Accounting Enabled
The figure below illustrates a call setup sequence with normal call flow (no disconnect) and with AAA resource failure stop accounting enabled.
Figure 2. Modem Dial-In Call Setup Sequence with Normal Flow and wIth Resource Failure Stop Accounting Enabled
The figure below illustrates a call setup sequence with call disconnect occurring before user authentication and with AAA resource failure stop accounting enabled.
Figure 3. Modem Dial-In Call Setup Sequence with Call Disconnect Occurring Before User Authentication and with Resource Failure Stop Accounting Enabled
The figure below illustrates a call setup sequence with call disconnect occurring before user authentication and without AAA resource failure stop accounting enabled.
Figure 4. Modem Dial-In Call Setup Sequence with Call Disconnect Occurring Before User Authentication and Without Resource Failure Stop Accounting Enabled
AAA Resource Accounting for Start-Stop Records
AAA resource accounting for start-stop records supports the ability to send a “start” record at each call setup, followed by a corresponding “stop” record at the call disconnect. This functionality can be used to manage and monitor wholesale customers from one source of data reporting, such as accounting records.
With this feature, a call setup and call disconnect “start-stop” accounting record tracks the progress of the resource connection to the device. A separate user authentication “start-stop” accounting record tracks the user management progress. These two sets of accounting records are interlinked by using a unique session ID for the call.
The figure below illustrates a call setup sequence with AAA resource start-stop accounting enabled.
AAA broadcast accounting allows accounting information to be sent to multiple AAA servers at the same time; that is, accounting information can be broadcast to one or more AAA servers simultaneously. This functionality allows service providers to send accounting information to their own private AAA servers and to the AAA servers of their end customers. It also provides redundant billing information for voice applications.
Broadcasting is allowed among groups of RADIUS or TACACS+ servers, and each server group can define its backup servers for failover independently of other groups.
Thus, service providers and their end customers can use different protocols (RADIUS or TACACS+) for the accounting server. Service providers and their end customers can also specify their backup servers independently. As for voice applications, redundant accounting information can be managed independently through a separate group with its own failover sequence.
AAA Session MIB
The AAA session MIB feature allows customers to monitor and terminate their authenticated client connections using Simple Network Management Protocol (SNMP). The data of the client is presented so that it correlates directly to the AAA accounting information reported by either the RADIUS or the TACACS+ server. AAA session MIB provides the following information:
Statistics for each AAA function (when used in conjunction with the show radius statistics command)
Status of servers providing AAA functions
Identities of external AAA servers
Real-time information (such as idle times), providing additional criteria for use by SNMP networks for assessing whether to terminate an active call
The table below shows the SNMP user-end data objects that can be used to monitor and terminate authenticated client connections with the AAA session MIB feature.
Table 2 SNMP End-User Data Objects
Field
Descriptions
SessionId
The session identification used by the AAA accounting protocol (same value as reported by RADIUS attribute 44 (Acct-Session-ID)).
UserId
The user login ID or zero-length string if a login is unavailable.
IpAddr
The IP address of the session or 0.0.0.0 if an IP address is not applicable or unavailable.
IdleTime
The elapsed time in seconds that the session has been idle.
Disconnect
The session termination object used to disconnect the given client.
CallId
The entry index corresponding to this accounting session that the Call Tracker record stored.
The table below describes the AAA summary information provided by the AAA session MIB feature using SNMP on a per-system basis.
Table 3 SNMP AAA Session Summary
Field
Descriptions
ActiveTableEntries
Number of sessions currently active.
ActiveTableHighWaterMark
Maximum number of sessions present since last system reinstallation.
TotalSessions
Total number of sessions since the last system reinstallation.
DisconnectedSessions
Total number of sessions that have been disconnected since the last system reinstallation.
Accounting Attribute-Value Pairs
The network access server monitors the accounting functions defined in either TACACS+ attribute-value (AV) pairs or RADIUS attributes, depending on which security method is implemented.
Applies the accounting method list to a line or set of lines.
or
Applies the accounting method list to an interface or set of interfaces.
What to Do Next
Note
System accounting does not use named method lists. For system accounting, define only the default method list.
Suppressing Generation of Accounting Records for Null Username Sessions
When AAA accounting is activated, the Cisco IOS XE software issues accounting records for all users on the system, including users whose username string, because of protocol translation, is NULL. An example of this is users who come in on lines where the aaaauthenticationloginmethod-listnone command is applied. To prevent accounting records from being generated for sessions that do not have usernames associated with them, use the following command in global configuration mode:
Prevents accounting records from being generated for users whose username string is NULL.
Generating Interim Accounting Records
To enable periodic interim accounting records to be sent to the accounting server, use the following command in global configuration mode:
Command or Action
Purpose
Router(config)# aaaaccountingupdate [newinfo] [periodic] number
Enables periodic interim accounting records to be sent to the accounting server.
When the aaaaccountingupdatecommandis activated, the Cisco IOS XE software issues interim accounting records for all users on the system. If the newinfo keyword is used, interim accounting records are sent to the accounting server every time there is new accounting information to report. An example of this would be when Internet Protocol Control Protocol (IPCP) completes IP address negotiation with the remote peer. The interim accounting record includes the negotiated IP address used by the remote peer.
When aaaaccountingupdatecommand is used with the keyword periodic, interim accounting records are sent periodically as defined by the argument number. The interim accounting record contains all of the accounting information recorded for that user up to the time the interim accounting record is sent.
Caution
Using the aaaaccountingupdateperiodic command can cause heavy congestion when many users are logged in to the network.
Configuring an Alternate Method to Enable Periodic Accounting Records
You can use the following alternative method to enable periodic interim accounting records to be sent to the accounting server.
Specifies the type of action to be performed on accounting records.
(Optional) The periodic keyword specifies periodic accounting action.
The interval keyword specifies the periodic accounting interval.
The value argument specifies the intervals for accounting update records (in minutes).
The disable keyword disables periodic accounting.
Step 5
exit
Example:
Router(cfg-acct-mlist)# exit
Returns to global configuration mode.
Generating Interim Service Accounting Records
Perform this task to enable the generation of interim service accounting records at periodic intervals for subscribers.
Before You Begin
RADIUS Attribute 85 in the user service profile always takes precedence over the configured interim-interval value. RADIUS Attribute 85 must be in the user service profile. See the RADIUS Attributes Overview and RADIUS IETF Attributes feature document for more information.
Note
If RADIUS Attribute 85 is not in the user service profile, then the interim-interval value configured in Generating Interim Accounting Records is used for service interim accounting records.
Router(config)# subscriber service accounting interim-interval 10
Enables the generation of interim service accounting records at periodic intervals for subscribers. The
minutes argument indicates the number of periodic intervals to send accounting update records from 1 to 71582 minutes.
Generating Accounting Records for a Failed Login or Session
When AAA accounting is activated, the Cisco IOS XE software does not generate accounting records for system users who fail login authentication, or who succeed in login authentication but fail PPP negotiation for some reason.
To specify that accounting stop records be generated for users who fail to authenticate at login or during session negotiation, use the following command in global configuration mode:
Generates “stop” records for users who fail to authenticate at login or during session negotiation using PPP.
Specifying Accounting NETWORK-Stop Records Before EXEC-Stop Records
For PPP users who start EXEC terminal sessions, it can be specified that NETWORK records be generated before EXEC-stop records. In some cases, such as billing customers for specific services, is can be desirable to keep network start and stop records together, essentially “nesting” them within the framework of the EXEC start and stop messages. For example, a user dialing in using PPP can create the following records: EXEC-start, NETWORK-start, EXEC-stop, NETWORK-stop. By nesting the network accounting records, NETWORK-stop records follow NETWORK-start messages: EXEC-start, NETWORK-start, NETWORK-stop, EXEC-stop.
To nest accounting records for user sessions, use the following command in global configuration mode:
Command or Action
Purpose
Router(config)# aaaaccountingnested
Nests network accounting records.
Suppressing System Accounting Records over Switchover
To suppress the system accounting-on and accounting-off messages during switchover, use the following command in global configuration mode:
Generates a “stop” record for any calls that do not reach user authentication.
Note
Before configuring the AAA Resource Failure Stop Accounting feature, the tasks described in thePrerequisites for Configuring Accounting section must be performed, and SNMP must be enabled on the network access server. For more information about enabling SNMP on a Cisco ASR 1000 Series Aggregation Services Router, see the Configuring SNMP Support chapter in the Cisco IOS XE Network Management Configuration Guide.
Configuring AAA Resource Accounting for Start-Stop Records
To enable full resource accounting for start-stop records, use the following command in global configuration mode:
Supports the ability to send a “start” record at each call setup. followed with a corresponding “stop” record at the call disconnect.
Note
Before configuring this feature, the tasks described in the section
Prerequisites for Configuring Accounting must be performed, and SNMP must be enabled on the network access server. For more information about enabling SNMP on a Cisco ASR 1000 Series Aggregation Services Router, see the chapter Configuring SNMP Support in the Cisco IOS XE Network Management Configuration Guide, Release 2.
Configuring AAA Broadcast Accounting
To configure AAA broadcast accounting, use the aaaaccounting command in global configuration mode. This command has been modified to allow the broadcast keyword.
Enables sending accounting records to multiple AAA servers. Simultaneously sends accounting records to the first server in each group. If the first server is unavailable, failover occurs using the backup servers defined within that group.
Configuring per-DNIS AAA Broadcast Accounting
To configure AAA broadcast accounting per DNIS, use the aaadnismapaccountingnetworkcommand in global configuration mode. This command has been modified to allow the broadcast keyword and multiple server groups.
Allows per-DNIS accounting configuration. This command has precedence over the global aaaaccounting command.
Enables sending accounting records to multiple AAA servers. Simultaneously sends accounting records to the first server in each group. If the first server is unavailable, failover occurs using the backup servers defined within that group.
Configuring the AAA Session MIB
The following tasks must be performed before configuring the AAA session MIB feature:
Configure SNMP. For information on SNMP, see the Configuring SNMP Support chapter in the Cisco IOS XE Network Management Configuration Guide.
Configure AAA.
Define the RADIUS or TACACS+ server characteristics.
Note
Overusing SNMP can affect the overall system performance; therefore, normal network management performance must be considered when this feature is used.
To configure the AAA session MIB, use the following command in global configuration mode:
Command or Action
Purpose
Router(config)# aaasession-mibdisconnect
Monitors and terminates authenticated client connections using SNMP.
To terminate the call,use the disconnect keyword .
Establishing a Session with a Router if the AAA Server Is Unreachable
To establish a console session with a router if the AAA server is unreachable, use the following command in global configuration mode:
The aaaaccountingsystemguarantee-first command guarantees system accounting as the first record, which is the default condition.
In some situations, users may be prevented from starting a session on the console or terminal connection until after the system reloads, which can take more than three minutes. To resolve this problem, use the noaaaaccountingsystemguarantee-first command.
Monitoring Accounting
No specific show command exists for either RADIUS or TACACS+ accounting. To obtain accounting records displaying information about users logged in, use the following command in privileged EXEC mode:
Command or Action
Purpose
Router# showaccounting
Allows display of the active accountable events on the network and helps collect information in the event of a data loss on the accounting server.
Troubleshooting Accounting
To troubleshoot accounting information, use the following command in privileged EXEC mode:
Command or Action
Purpose
Router# debugaaaaccounting
Displays information on accountable events as they occur.
The following example shows how to configure a Cisco AS5200 (enabled for AAA and communication with a RADIUS security server) in order for AAA services to be provided by the RADIUS server. If the RADIUS server fails to respond, then the local database is queried for authentication and authorization information, and accounting services are handled by a TACACS+ server.
aaa new-model
aaa authentication login admins local
aaa authentication ppp dialins group radius local
aaa authorization network network1 group radius local
aaa accounting network network2 start-stop group radius group tacacs+
username root password ALongPassword
tacacs-server host 172.31.255.0
tacacs-server key goaway
radius-server host 172.16.2.7
radius-server key myRaDiUSpassWoRd
interface group-async 1
group-range 1 16
encapsulation ppp
ppp authentication chap dialins
ppp authorization network1
ppp accounting network2
line 1 16
autoselect ppp
autoselect during-login
login authentication admins
modem dialin
The lines in this sample RADIUS AAA configuration are defined as follows:
The
aaanew-model command enables AAA network security services.
The
aaaauthenticationloginadminslocal command defines a method list, “admins”, for login authentication.
The
aaaauthenticationpppdialinsgroupradiuslocal command defines the authentication method list “dialins”, which specifies that first RADIUS authentication and then (if the RADIUS server does not respond) local authentication is used on serial lines using PPP.
The
aaaauthorizationnetworknetwork1groupradiuslocal command defines the network authorization method list named “network1”, which specifies that RADIUS authorization is used on serial lines using PPP. If the RADIUS server fails to respond, then local network authorization is performed.
The
aaaaccountingnetworknetwork2start-stopgroupradiusgrouptacacs+command defines the network accounting method list named “network2”, which specifies that RADIUS accounting services (in this case, start and stop records for specific events) are used on serial lines using PPP. If the RADIUS server fails to respond, accounting services are handled by a TACACS+ server.
The
username command defines the username and password to be used for the PPP Password Authentication Protocol (PAP) caller identification.
The
tacacs-serverhost command defines the name of the TACACS+ server host.
The
tacacs-serverkey command defines the shared secret text string between the network access server and the TACACS+ server host.
The
radius-serverhost command defines the name of the RADIUS server host.
The
radius-serverkey command defines the shared secret text string between the network access server and the RADIUS server host.
The
interfacegroup-async command selects and defines an asynchronous interface group.
The
group-range command defines the member asynchronous interfaces in the interface group.
Theencapsulationppp command sets PPP as the encapsulation method used on the specified interfaces.
Thepppauthenticationchapdialinscommand selects Challenge Handshake Authentication Protocol (CHAP) as the method of PPP authentication and applies the “dialins” method list to the specified interfaces.
Thepppauthorizationnetwork1command applies the blue1 network authorization method list to the specified interfaces.
Thepppaccountingnetwork2command applies the red1 network accounting method list to the specified interfaces.
The
line command switches the configuration mode from global configuration to line configuration and identifies the specific lines being configured.
The
autoselectppp command configures the Cisco IOS XE software to allow a PPP session to start up automatically on these selected lines.
The
autoselectduring-login command is used to display the username and password prompt without pressing the Return key. After the user logs in, the autoselect function (in this case, PPP) begins.
The
loginauthenticationadmins command applies the admins method list for login authentication.
Themodemdialin command configures modems attached to the selected lines to accept only incoming calls.
The
showaccountingcommand yields the following output for the preceding configuration:
Active Accounted actions on tty1, User username2 Priv 1
Task ID 5, Network Accounting record, 00:00:52 Elapsed
task_id=5 service=ppp protocol=ip address=10.0.0.98
The table below describes the fields contained in the preceding output.
Table 4 show accounting Field Descriptions
Field
Description
Active Accounted actions on
Terminal line or interface name user with which the user logged in.
User
User’s ID.
Priv
User’s privilege level.
Task ID
Unique identifier for each accounting session.
Accounting Record
Type of accounting session.
Elapsed
Length of time (hh:mm:ss) for this session type.
attribute=value
AV pairs associated with this accounting session.
Configuring AAA Resource Accounting Example
The following example shows how to configure the resource failure stop accounting and resource accounting for start-stop records functions:
!Enable AAA on your network access server.
aaa new-model
!Enable authentication at login and list the AOL string name to use for login authentication.
aaa authentication login AOL group radius local
!Enable authentication for ppp and list the default method to use for PPP authentication.
aaa authentication ppp default group radius local
!Enable authorization for all exec sessions and list the AOL string name to use for authorization.
aaa authorization exec AOL group radius if-authenticated
!Enable authorization for all network-related service requests and list the default method to use for all network-related authorizations.
aaa authorization network default group radius if-authenticated
!Enable accounting for all exec sessions and list the default method to use for all start-stop accounting services.
aaa accounting exec default start-stop group radius
!Enable accounting for all network-related service requests and list the default method to use for all start-stop accounting services.
aaa accounting network default start-stop group radius
!Enable failure stop accounting.
aaa accounting resource default stop-failure group radius
!Enable resource accounting for start-stop records.
aaa accounting resource default start-stop group radius
Configuring AAA Broadcast Accounting Example
The following example shows how to turn on broadcast accounting using the global aaaaccounting command:
aaa group server radius isp
server 10.0.0.1
server 10.0.0.2
aaa group server tacacs+ isp_customer
server 172.0.0.1
aaa accounting network default start-stop broadcast group isp group isp_customer
radius-server host 10.0.0.1
radius-server host 10.0.0.2
radius-server key key1
tacacs-server host 172.0.0.1 key key2
The broadcast keyword causes “start” and “stop” accounting records for network connections to be sent simultaneously to server 10.0.0.1 in the group isp and to server 172.0.0.1 in the group isp_customer. If server 10.0.0.1 is unavailable, failover to server 10.0.0.2 occurs. If server 172.0.0.1 is unavailable, no failover occurs because backup servers are not configured for the group isp_customer.
Configuring per-DNIS AAA Broadcast Accounting Example
The following example shows how to turn on per-DNIS broadcast accounting using the global aaadnismapaccountingnetworkcommand:
aaa group server radius isp
server 10.0.0.1
server 10.0.0.2
aaa group server tacacs+ isp_customer
server 172.0.0.1
aaa dnis map enable
aaa dnis map 7777 accounting network start-stop broadcast group isp group isp_customer
radius-server host 10.0.0.1
radius-server host 10.0.0.2
radius-server key key_1
tacacs-server host 172.0.0.1 key key_2
The broadcast keyword causes “start” and “stop” accounting records for network connection calls having DNIS number 7777 to be sent simultaneously to server 10.0.0.1 in the group isp and to server 172.0.0.1 in the group isp_customer. If server 10.0.0.1 is unavailable, failover to server 10.0.0.2 occurs. If server 172.0.0.1 is unavailable, no failover occurs because backup servers are not configured for the group isp_customer.
AAA Session MIB Example
The following example shows how to set up the AAA session MIB feature to disconnect authenticated client connections for PPP users:
aaa new-model
aaa authentication ppp default group radius
aaa authorization network default group radius
aaa accounting network default start-stop group radius
aaa session-mib disconnect
Additional References
The following sections provide references related to the Configuring Accounting feature.
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
--
MIBs
MIB
MIBs Link
CISCO-AAA-SESSION-MIB
To locate and download MIBs for selected platforms, Cisco IOS XE software releases , and feature sets, use Cisco MIB Locator found at the following URL:
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
--
Technical Assistance
Description
Link
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.
To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.
Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to
www.cisco.com/go/cfn. An account on Cisco.com is not required.
Table 5 Feature Information for Configuring Accounting
Feature Name
Releases
Feature Information
AAA Broadcast Accounting
Cisco IOS XE Release 2.1
AAA broadcast accounting allows accounting information to be sent to multiple AAA servers at the same time; that is, accounting information can be broadcast to one or more AAA servers simultaneously.
In Cisco IOS XE Release 2.1, this feature was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
The following commands were introduced or modified:
aaaaccounting.
AAA Session MIB
Cisco IOS XE Release 2.1
The AAA session MIB feature allows customers to monitor and terminate their authenticated client connections using Simple Network Management Protocol (SNMP).
In Cisco IOS XE Release 2.1, this feature was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
The following commands were introduced or modified:
aaasession-mibdisconnect.
Connection Accounting
Cisco IOS XE Release 2.1
Connection accounting provides information about all outbound connections made from the network access server, such as Telnet, local-area transport (LAT), TN3270, packet assembler/disassembler (PAD), and rlogin.
In Cisco IOS XE Release 2.1, this feature was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
AAA Interim Accounting
Cisco IOS XE Release 2.4
AAA interim accounting allows accounting records to be sent to the accounting server every time there is new accounting information to report, or on a periodic basis.
In Cisco IOS XE Release 2.4, this feature was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.
The following commands were introduced or modified:
aaaaccountingupdate and
subscriberserviceaccountinginterim-interval.