Standard RADIUS Attributes

This section describes the standard RADIUS attributes that the SBC supports. These attributes appear along with VSAs (Vendor-Specific Attributes) in the CDRs that the SBC generates.

The Standard RADIUS Attributes Dictionary is a dictionary of the standard RADIUS attributes included in Accounting Request messages sent by the SBC to the RADIUS server. The CDR event information determines which messages are generated and which RADIUS attributes are included in the messages. Standard RADIUS messages and attributes are used whenever possible; however, RADIUS does not have attributes to record all important session information.

Possible messages are:

  • Start—Marks the start of service delivery and describes the type of service being delivered and the user to whom it is being delivered
  • Interim-Update—Indicates to the accounting server that the session parameters have changed
  • Stop—
    • Marks the end of service delivery
    • Describes the type of service that was delivered
    • Sometimes describes statistics such as elapsed time, input and output octets, or input and output packets
  • On—Marks the start of accounting
  • Off—Marks the end of accounting

VSAs are used to record the necessary session information missing from this list of standard RADIUS attributes.

For more information about RADIUS, see to the following Internet Engineering Task Force Request for Comments (IETF RFCs):

Standard RADIUS Attributes Dictionary

The table below lists and describes standard RADIUS attributes.

Attribute Name Attribute Description Attribute Value Attribute Value Type Messages
NAS-IP-Address IP address of the SIP proxy or the H.323 stack’s call signaling address. 4 IP address
  • Start
  • Interim-Update
  • Stop
  • On
  • Off
NAS-Port SIP proxy port or the H.323 stack’s call signaling RAS port. 5 integer
  • Start
  • Interim-Update
  • Stop
  • On
  • Off
Called-Station-Id To field value of the SIP INVITE message (a type of message used to initiate a session) or the calledPartyNumber of the H.323 message. 30 string
  • Start
  • Interim-Update
  • Stop
Calling-Station-Id From field value of the SIP INVITE message or the callingPartyNumber of the H.323 message. 31 string
  • Start
  • Interim-Update
  • Stop
NAS-Identifier Value, if any, set in the optional NAS-ID field for the accounting server that you configure as part of the accounting configuration. This identifier sets the value that the remote server (the accounting server) uses to identify the SBC so that RADIUS messages can be transmitted.

The remote server to which the accounting configuration will send messages uses at least one of two pieces of information for identification:

NAS IP address: always included in the accounting message

NAS identifier: configured in the NAS-ID parameter of the accounting server; if configured, the NAS identifier is sent to the remote server

This attribute only appears if a value is configured in the NAS-ID field.

32 string
  • Start
  • Interim-Update
  • Stop
  • On
  • Off
Acct-Status-Type Whether this Accounting Request marks the beginning of the RADIUS message (Start), the middle (Interim-Update), or the end (Stop), and whether the accounting function is on or off (Accounting-On or Accounting-Off). 40 integer
  • Start (1)
  • Interim-Update
  • Stop (2)
  • On
  • Off
Acct-Session-Id Either the Call-ID field value of the SIP INVITE message, the callIdentifier of the H.323 message, or RADIUS client information. 44 string
  • Start
  • Interim-Update
  • Stop
  • On
  • Off
Acct-Session-Time How much time in seconds (or milliseconds if so configured) the user has received service. 46 integer
  • Interim-Update
  • Stop
  • Off
Acct-Terminate-Cause How or why the session ended. 49 integer
  • Stop
  • Off

RADIUS Accounting Termination Causes

The table below describes the possible session termination causes for the Acct-Terminate-Cause RADIUS attribute.

RADIUS Termination Cause Related Integer Value (per RFC 2059) Termination Event Message
User Request 1 A SIP BYE message. Stop
User Error 17 Input from user is erroneous; for example, SIP signaling failed to establish the session. Used in combination with the Cisco Systems Disconnect Cause.

(This termination cause is not used for H.323.)

Stop
Lost Service 3 Service cannot be sustained for reasons such as a lost connection. Stop
idle-timeout 4 Idle timer expired. Stop
session-timeout 5 Maximum session length timer expired. Stop
Admin Reset 6 SBC hard reset occurred: A hard reset occurs when you use the front panel’s orange Reset button; it reboots the SBC. Off
Admin Reboot 7 SBC gracefully rebooted. Off
NAS Request 10 RADIUS server is disabled; session terminated for non-error reason. Off

Cisco Systems RADIUS Decodes

The following table is a dictionary of the Cisco Systems (vendor identification number is 9) accounting VSAs. These attribute names are vendor-specific and subject to change without notice.

You can use the information in this table to translate the Cisco Systems VSAs that sometimes appear in SBC RADIUS messages into a more human-readable form.

Attribute Name Attribute Description Attribute Value Attribute Value Type Messages
Setup Time The SETUP message is used to request a connection (and therefore corresponds with the SIP INVITE).

Start record—Time that the first SIP INVITE or H.323 SETUP message was received.

Interim record—Time that the applicable SIP REINVITE message was received.

Stop record—Time that the last SIP REINVITE message was received.

25 string Start

Interim

Stop

Connect Time Time that a SIP or H.323 session was accepted. This is the time a 200 OK SIP response to the SIP INVITE message was received or the time that a call ANSWERED/CONNECTED response to the H.323 SETUP message was received. 28 string Start

Interim-Update

Stop

Disconnect Time Time that a SIP BYE or H.323 Release Complete message was received or the session terminated. This is the time a SIP INVITE or H.323 SETUP transaction terminates for any reason. 29 string Stop
Disconnect Cause SIP Reasons for Disconnection (normal, redirection, client error, network error, global error, time-out, or user abandon) or the H.323 Release Complete Reason code (bad format address, unavailable, destination rejection, adaptive busy, etc.).

For more information, refer to this guide’s Mappings and Disconnect Cause Values section.

30 string Stop