RADIUS

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(Adding new attributes.)
m (Typo)
Line 199: Line 199:
 
| align="center" | 20<br>  
 
| align="center" | 20<br>  
 
| Telcob-TerminationCause
 
| Telcob-TerminationCause
| align="center" | |Integer<br>  
+
| align="center" | Integer<br>  
 
| TerminationCause
 
| TerminationCause
 
| Integer that represents the Termination Cause
 
| Integer that represents the Termination Cause

Revision as of 08:36, 30 May 2012

Remote Authentication Dial In User Service, more popularly known as RADIUS, is used by telecom service providers for the purpose of authenticating, authorizing, and accounting for the use of services by subscribers. A RADIUS server is an application server that provides this functionality. It can take as input as well as output Call detail record (CDR) data.


Contents

TelcoBridges and RADIUS

Starting with release v2.3 of Toolpack, explicit support for the accounting function of RADIUS is now offered. Previously, Toolpack stored Call detail record (CDR) data in a local database. Starting with Toolpack v2.3, CDR data is stored on a dedicated, external server running an implementation of the RADIUS standard. Configuration of the location of the RADIUS server is performed through the Toolpack web portal. For this initial release, Toolpack only supports the Accounting functionality of RADIUS; it does not support the Authorization or Authentication options. That type of functionality can be performed outside of RADIUS using Toolpack.

Starting with release v2.6 of Toolpack, multiple RADIUS servers can now be configured for backup purposes.

Prerequisites

In order to enable RADIUS functionality in Toolpack, you must have a RADIUS server already up and running. It is highly recommended that the RADIUS server software being running on a separate machine from the one running the Toolpack software. Before configuring Toolpack, you will need the IP address of the RADIUS server(s). You will need to specify a ‘secret key’ which will authenticate the Toolpack server so that it can send CDR data to the RADIUS server and the RADIUS server will accept it.

Configuration

Assuming that you have already set up and configured a RADIUS server, you also need to configure Toolpack.

Toolpack to Radius CDR attributes remapping

AVP Id Radius IETF param name Type Toolpack param Description
4
NAS-Identifier string
Application Name Application name of the CDR provider
2
Acct-Session-Id integer
Leg Id Call Leg Identifier
21 Telcob-Other-Leg-Id integer
Other Leg Id Call Leg Identifier of the other call leg joined with current call leg
9 Telcob-ChargeIndicator string
Charge indicator Represent the charge indicator value
5
Cisco-NAS-Port string
NAP name Network Access Point name for the call leg
7
Called-Sation-Id string
Called Number Called party number
6
Calling-Station-Id string
Calling Number Calling party number
10
h323-call-type string
Protocol Type If protocol is SIP the value is "VOIP", otherwise it is "Telephony"
17
h323-setup-time string
Start Time Represent the call leg setup time - Coordinated Universal Time (UTC)
8
h323-call-origin string
Originator Name "answer" for an outgoing leg - "originate" for an incoming leg
18
h323-connect-time string
  Connected Time Represent the call leg answer time (connect time) - Coordinated Universal Time (UTC)
19
h323-disconnect-time string
  EndTime Represent the call leg disconnect time - Coordinated Universal Time (UTC)
3
h323-conf-id string
  Unique Id Unique call identifier for the two initial legs (incoming and outgoing) - 128 bits integer formated as xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

h323-incoming-conf-id string
  Unique Id Contains the original h323-conf-id in case of call transfer for subsequent outgoing legs - 128 bits integer formated as xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx
1
User-Name string
- For now this value is hardcoded to "100"
30
h323-disconnect-cause string
Termination Reason Q.931 disconnect (1 to 160) cause, TB Toolpack system cause (200 to 300) and SIP cause (400 to 600)
115 release-source string
Termination Source "localLeg" if this leg terminate the call or "connectedLeg" if its the connected leg - We use a Cisco string field with our own value definition
40
Acct-Status-Type integer
- Start or Stop
10
Telcob-Protocol String
Protocol Protocol used for this LegID. Ex. SIP, ISDN, etc.
11
Telcob-Codec String
Codec Codec used for this LegID
12
Telcob-RemoteIP IP address
RemoteIP RemoteIP used for the media. This is only for VOIP.
13
Telcob-RemotePort Integer
RemotePort RTP Port of the remote peer. This is only for VOIP.
14
Telcob-TrunkName String
TrunkName Name of the trunk (ex. "LS004400E1_0_00").

This attribute is only for non-VOIP.

15
Telcob-TimeslotNumber Integer
TimeslotNumber This is the Timeslot Number.

This attribute is only for non-VOIP.

16
Telcob-MediaInfo String
MediaInfo String that represents the MediaInfo (ex. "PCMU@10.3.10.124:20054" for SIP and "LS_T1_BITS_00:1" for ISDN)
17
Telcob-StartTime String
StartTime String that represents the StartTime of the call.
18
Telcob-ConnectedTime String
ConnectedTime String that represents the time when the call was connected
19
Telcob-EndTime String
EndTime String that represents when the call was completed.
20
Telcob-TerminationCause Integer
TerminationCause Integer that represents the Termination Cause
21
Telcob-Other-Leg-Id Integer
Other-Leg-Id Integer that represents the other LegID bridged for this call
22
Telcob-TerminationCauseString String
TerminationCauseString String that represents the TerminationCause, but in a String format.
23
Telcob-TerminationSource String
TerminationSource String that represents the Termination Source
24
Telcob-LocalSipIP String
LocalSipIP IP Address that represents the Local IP used for SIP. Not currently implemented.
25
Telcob-LocalSipPort Integer
LocalSipPort Integer that represents the Local port used for SIP. Not currently implemented.
26
Telcob-LocalMediaIP IPAddr
LocalMediaIP IP Address that represents the Local IP used for the media.
27
Telcob-LocalMediaPort String
LocalMediaPort Integer that represents the Local port used for the media.
28
Telcob-LocalMediaInfo String
LocalMediaInfo String that represents the Local Media Info.(ex. "PCMU@10.3.10.124:20054")

Only for VOIP calls.

29
Telcob-RemoteMediaInfo String
RemoteMediaInfo String that represents the Remote Media Info.(ex. "PCMU@10.3.10.124:20054")

This is the same as Telcob-MediaInfo. Only for VOIP calls.

References

Personal tools