1. Accounting Guide
  2. Using RADIUS with the OCSBC
  3. Standard RADIUS Attributes

Standard RADIUS Attributes

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

The Standard RADIUS Attributes Dictionary is a dictionary of the standard RADIUS attributes included in Accounting Request messages sent by the OCSBC 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 OCSBC 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 OCSBC hard reset occurred: A hard reset occurs when you use the front panel’s orange Reset button; it reboots the OCSBC. Off
Admin Reboot 7 OCSBC gracefully rebooted. Off
NAS Request 10 RADIUS server is disabled; session terminated for non-error reason. Off