RADIUS attributes

Link copied to clipboard

To ensure compatibility with future releases of PortaBilling, it is highly recommended that you follow the Cisco guidelines regarding which attributes must be contained in each authentication or accounting request. For more information, please refer to the RADIUS Vendor-Specific Attributes Voice Implementation Guide at Cisco website.

Authentication/Authorization requests

Currently, the following attributes are required for correct processing of authentication/authorization requests:

Attribute

Description

NAS-IP-Address (required)

Specifies the IP address of the network access server that is requesting authentication

NAS-Identifier

Specifies the name (e.g., the hostname) of the network access server that is requesting authentication. Either NAS-IP-Address or NAS-Identifier attributes must be present in the authentication request

User-Name (required)

Indicates the name of the user being authenticated by the RADIUS server

Password

Indicates the user’s password

Called-Station-Id

The telephone number the user called. Only for authorization requests

Message-Authenticator

Used to authenticate and protect the integrity of Access-Requests in order to prevent spoofing

h323-conf-id

The unique call identifier generated by the gateway. Used to identify the separate billable events (calls) within a single calling session

h323-incoming-conf-id

The unique number for identifying a parent session on a gateway, where a session is closed when the calling party hangs up. It is used to:

  • Match the outbound and inbound call legs for a session on a particular gateway;

  • Collect and match all records for multiple calls placed (within the bounds of a session) on the gateway.

The value used for legs 1 and 2 on the originating gateway can differ from that for legs 3 and 4 on a terminating gateway. The h323-incoming-conf-id is different from h323-conf-id.

h323-ivr-out

User-definable attribute-value pairs sent from the NAS to the RADIUS server

PortaOne-*

PortaOne specific attributes sent from the NAS to the RADIUS server. The list of attributes is described in the PortaBilling custom attributes section

Authentication/Authorization responses

Link copied to clipboard

Currently, the following standard attributes are used (A1 = authentication, A2 = authorization):

Attribute

A1

A2

Description

h323-billing-model

Y

Type of billing service for a specific session (0 Credit, 1 Debit)

h323-return-code

Y

Y

Return codes are the server’s instructions to the network access server. The list of possible values are described in the RADIUS Return Codes section

h323-currency

Y

Y

Currency used with h323-credit-amount (in ISO_4217 format, for example USD, EUR)

h323-preferred-lang

Y

Y

Language to use for the audio prompt (in ISO 639-1 format, for example en, es, de)

h323-credit-amount

Y

Amount of credit (in currency) in the account

h323-redirect-number

Y

Optional

Phone number to which the call is redirected

h323-ivr-in

Y

Y

User-definable attribute-value pairs sent from the RADIUS server back to the NAS

Message-Authenticator

Y

Y

Used to authenticate and protect the integrity of Access-Requests in order to prevent spoofing

Reply-Message

Y

Y

The description of the accept or reject message

PortaOne-*

Y

Y

PortaOne specific attributes sent from the RADIUS server to the NAS. The list of attributes is described in the PortaBilling custom attributes section

Accounting requests

Link copied to clipboard

Currently, the following attributes are required for the correct processing of accounting requests:

Attribute

Description

NAS-IP-Address

Specifies the IP address of the network access server that is sending accounting requests

NAS-Identifier

Specifies the name (e.g., the hostname) of the network access server that is requesting authentication. Either NAS-IP-Address or NAS-Identifier attributes must be present in the request

NAS-Port-Name

Indicates the name of the physical NAS port that is authenticating the user

User-Name

Indicates the name of the user for the accounting request

Calling-Station-Id

The telephone number the call or message came from

Called-Station-Id

The telephone number the user called/sent a message

Acct-Session-Time

Indicates how long (in seconds) the user has received service

Acct-Status-Type

Indicates the stage of the session, whether this Accounting-Request marks the beginning of the user service (Start), interim update (Alive) or the end (Stop)

h323-remote-address

IP address of the remote voice equipment. PortaBilling uses it to disambiguate different IP route paths on a NAS

h323-setup-time

Indicates the setup time in Network Time Protocol (NTP) format: hour, minutes, seconds, microseconds, time_zone, day, month, day_of_month, year

h323-connect-time

Indicates the connect time in Network Time Protocol (NTP) format: hour, minutes, seconds, microseconds, time_zone, day, month, day_of_month, and year

h323-disconnect-time

Indicates the disconnect time in Network Time Protocol (NTP) format: hour, minutes, seconds, microseconds, time_zone, day, month, day_of_month, year

h323-conf-id

The unique call identifier generated by the gateway. Used to identify the separate billable events (calls) within a single session. When this attribute is not present, PortaBilling calculates the equivalent ID from other attributes, for example Acct-Session-Id

h323-incoming-conf-id

The unique number for identifying a calling session on a NAS, where a session is closed when the calling party hangs up. The h323-incoming-conf-id number is used to:

  • Match the outbound and inbound call legs for a session on a particular NAS

  • Collect and match all records for multiple calls placed (within the bounds of a session) on the gateway

h323-disconnect-cause

Specifies the reason a call was disconnected (e.g., 0x10 – normal ending, 0x3 no route, 0x11 user busy, 0x1F normal unspecified)

h323-call-origin

The NAS’es behavior in relation to the connection that is active for this leg. Possible values: answer, originate. For example, answer on leg 1; originate on leg 2

h323-call-type

Protocol type or family used on this leg of the call. Possible values: VoIP, Telephony

h323-ivr-out

User-definable attribute-value (AV) pairs sent from the NAS to the RADIUS server

On this page