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):
- RFC 2865, Remote Authentication Dial In User Service (RADIUS), Rigney, et al., June 2000 (http://www.ietf.org/rfc/rfc2865.txt)
- RFC 2866, RADIUS Accounting, C. Rigney, June 2000 (http://www.ietf.org/rfc/rfc2866.txt)
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 |
|
NAS-Port | SIP proxy port or the H.323 stack’s call signaling RAS port. | 5 | integer |
|
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 |
|
Calling-Station-Id | From field value of the SIP INVITE message or the callingPartyNumber of the H.323 message. | 31 | string |
|
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 |
|
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 |
|
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 |
|
Acct-Session-Time | How much time in seconds (or milliseconds if so configured) the user has received service. | 46 | integer |
|
Acct-Terminate-Cause | How or why the session ended. | 49 | integer |
|
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 |