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):
- 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
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 |
|
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 | 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 |