09-Voice RADIUS Configuration
09-Voice RADIUS Configuration
Table of Contents
i
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
1.1 Overview
1.1.1 Fundamentals
Remote access dial in user service (RADIUS) is a protocol standard developed for
implementing authentication, authorization and accounting (AAA) for access users,
who can be PPP users or voice users. The voice RADIUS function provided by the
voice gateway is suitable for small- and medium-sized network operators or enterprises
to control voice calls and perform voice call accounting statistics.
As a whole, voice RADIUS is a part of the whole voice module that implements AAA for
voices users on the voice gateway. When a user initiates a voice call, the voice gateway
interacts with the user according to the configured parameters, encapsulates the
obtained user information and statistics into RADIUS AAA messages, and sends the
messages to the RADIUS server. The voice gateway then determines whether to
connect the call according to the response. After the call ends, the voice gateway
reports to the RADIUS server the statistics information (such as call duration, number
of messages, and number of bytes) about the call to complete call accounting and other
operations.
Figure 1-1 shows the networking environment where voice RADIUS is applied.
1-1
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
1-2
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Note:
z In the above call setup process, accounting is divided into four segments to facilitate
charge settlement between service providers as well as control of voice channel by
segment.
z The call setup process and call clearing process are briefly described here. In
practice, the call setup process and messages exchanged differ greatly, because
message exchange in the entire process is quite complicated, access procedures
differ, AAA fails, calls are exceptionally terminated, or the called party hangs up.
Obviously, RADIUS cannot operate normally without the RADIUS server. AAA
messages exchanged between the voice gateway and the RADIUS server should
comply with RFC 2865 and RFC 2866. A list of voice call users of the voice gateway
should also be configured on the RADIUS server.
1-3
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
There are two types of dialing process for voice calls: one-stage dialing and two-stage
dialing. Two-stage dialing falls into caller number process, caller number process with
interactive voice response (IVR), and card number/password process.
1) One-stage dialing: The calling party directly dials a called number. The RADIUS
server performs authentication for the calling party, authorization for the called
party, and accounting according to the AAA configuration for one-stage dialing
process.
2) Two-stage dialing: The calling party first needs to dial an access number and then
a called number. The RADIUS server performs different AAA operations for
different access numbers.
z Caller number process: The calling party first dials an access number, and after
hearing a dial tone, dials a called number. The system originates a call according
to the called number.
z Caller number process with IVR: The calling party first dials an access number.
The system plays a prompt tone. The calling party performs operations as
prompted, and then dials a called number. The system originates a call according
to the called number.
z Card number/password process: The calling party first dials an access number.
The system plays a prompt tone. The calling party enters a card number and
password as prompted, and then dials a called number. The system originates a
call according to the called number.
The RADIUS server needs to obtain the caller’s identity information, which may be the
calling number or the preset card number and password, before performing AAA
operations for a voice call. The system uses the collected calling number or card
number and password to originate an authentication request to the RADIUS server,
and determines whether call origination is allowed according to the returned result.
The AAA function for one-stage dialing process applies to all one-stage dialing users.
For two-stage dialing users, you can configure different access numbers. For these
access numbers, you can configure different AAA schemes and different two-stage
dialing attribute parameters (for example, redial attempts and number of digits in a card
number/password). In addition, you can customize the detailed access procedure
according to the specific requirements. For example, you can set these access
numbers as private line auto ring-down (PLAR) numbers on voice subscriber lines to
implement the auto-dialing of access numbers.
1-4
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Note:
z If a voice call is originated from an IP network, the voice gateway does not support
the direct dialing of access numbers, and for one-stage dialing, it supports only
accounting, instead of authentication and authorization.
z The voice gateway does not support the nested dialing of access numbers. That is,
a user cannot dial an access number again after dialing it during a call originated
from or terminated to a voice gateway.
Voice prompts in Chinese and English are available in the card number/password
process and caller number process with IVR.
This function records detailed information of each voice call. You can use the cdr
command to set the lifetime and number of records. The following call information is
recorded:
z Calling number
z Called number
z Voice port number
z IP address of the peer voice gateway
z Call setup time, call-connected time, call release time, and call duration.
z Number of received/sent bytes, and number of received/sent packets
You can retrieve the call information by calling number, called number, prepaid card
number, voice subscriber line number, and peer IP address.
Note:
For specific configurations of the RADIUS server, refer to AAA RADIUS HWTACACS
Configuration in Security Volume.
When configuring voice RADIUS, pay attention to the sequence and the applicable
scope of configuration tasks.
z The authentication function must be enabled before the authorization function
because the former is a prerequisite for the latter.
z The AAA function differs in the enabling method and application scope between
one-stage dialing users and two-stage dialing users. The one-stage dialing
1-5
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
configuration applies to all one-stage dialing users, while the two-stage dialing
configuration applies to only the users who use a specific access number.
z The setting of the accounting function is independent of the enabling of
authentication and authorization functions, and the accounting function applies to
both one-stage dialing users and two-stage dialing users. Of course, you must
ensure that necessary information (including IP address of the voice gateway,
voice port number, calling number, and card number/password) is configured on
the RADIUS server.
Read through the following sections and acquaint yourself with the views, steps, and
applicable scope of all commands.
Voice RADIUS configuration tasks include the following:
z Enter voice AAA client view
z Configure the accounting method
z Enable the AAA functions for one-stage dialing users
z Configure a rule for saving call detail records (CDRs)
z Configure access numbers
z Configure a two-stage dialing process
z Enable the AAA functions for two-stage dialing users
z Configure the method of collecting digits of called numbers
z Configure the number of digits in a card number and that in a password
z Configure the number of redial attempts
z Enable the language selection function
The configuration tasks for the one-stage dialing process differ from those for the
two-stage dialing process. The configuration tasks for the one-stage dialing process
apply to all one-stage dialing calls, while those for the two-stage dialing process apply
to different access numbers.
The configuration tasks common to the one-stage and two-stage dialing processes
include:
z Configure the accounting method
z Configure a rule for saving CDRs
The configuration tasks for the one-stage dialing process include:
z Enter voice AAA client view
z Enable the authentication function for one-stage dialing users
z Enable the authorization function for one-stage dialing users
z Enable the accounting function for one-stage dialing users
The configuration tasks for the two-stage dialing process include:
z Configure access numbers
z Configure a two-stage dialing process
z Enable the authentication function for two-stage dialing users.
z Enable the authorization function for two-stage dialing users.
1-6
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Task Remarks
Configuring Accounting Method Optional
Enabling the Accounting Function for
Optional
One-Stage Dialing Users
Enabling Authentication Function for
Optional
One-Stage Dialing Users
Enabling Authorization Function for
Optional
One-Stage Dialing Users
Configuring Rule for Saving CDRs Optional
The RADIUS client (voice gateway) processes RADIUS Accounting requests and
responses in multiple ways. The RADIUS client sends accounting messages to the
RADIUS server in different ways at different accounting time. You can select the
1-7
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
I. Configuration prerequisites
A voice interface card (for example, an FXS interface card) is inserted in the router.
For one-stage dialing users, there is no access number. It is impossible to enable the
accounting function for an individual user according to the identification. Therefore, the
accounting function can only be enabled for all one-stage dialing users.
Before enabling the accounting function, you must ensure that the RADIUS server and
RADIUS client (voice gateway) can communicate with each other at the network layer
and that a list of one-stage dialing users as well as accounting policies has been
configured on the RADIUS server.
I. Configuration prerequisites
A voice interface card (for example, an FXS interface card) is inserted in the router.
Follow these steps to enable the accounting function for one-stage dialing users:
1-8
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Note:
z For direct inward dialing (DID), it is unnecessary to dial an access number before a
called number, relative to two-stage dialing.
z If you want to prohibit users from making calls when their account balance in the
RADIUS server which is a composite access management server (CAMS) is 0, and
allow them to make calls when there is sufficient account balance, you must
configure the authentication, authorization, and accounting functions on the voice
gateway. This rule applies to one-stage dialing users and two-stage dialing users.
For one-stage dialing users, there is no access number. It is impossible to enable the
authentication function for an individual user according to the identification. Therefore,
the authentication function can only be enabled for all one-stage dialing users.
Before enabling the authentication function, you must ensure that the RADIUS server
and RADIUS client (voice gateway) can communicate with each other at the network
layer and that a list of one-stage dialing users as well as authentication policies has
been configured on the RADIUS server.
I. Configuration prerequisites
A voice interface card (for example, an FXS interface card) is inserted in the router.
Follow these steps to enable the authentication function for one-stage dialing users
1-9
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
I. Configuration prerequisites
A voice interface card (for example, an FXS interface card) is inserted in the router.
The authentication function is enabled for one-stage dialing users. Authentication is a
prerequisite for authorization. The authentication function must be enabled before the
authorization function. If the authentication function is not enabled for one-stage dialing
users, the authorization-did command is unavailable. If the authentication function is
disabled, the authorization function will automatically be disabled.
Follow these steps to enable the authorization function for one-stage dialing users:
Note:
Consecutive authorizations except the first one performed within the authentication
time limit will fail if the number of online users is limited to one for an account in a CAMS
serving as the RADIUS server. This rule applies to one-stage dialing users and
two-stage dialing users.
1-10
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Each time a call is terminated, a CDR will be generated in the following two cases, no
matter whether the call is connected:
z Any of the authentication, authorization, and accounting functions is enabled for
calls originated from the local voice gateway.
z The accounting function is enabled for incoming calls of the local voice gateway.
In view of the limited memory of the voice gateway, only limited number of CDRs can be
saved. Therefore, you can set a limit on saved CDRs. There are two ways to limit CDRs
saved in the voice gateway: One is to limit the number of CDRs and the other is to limit
the lifetime of CDRs. You can also set a CDR alarm threshold.
I. Configuration prerequisites
A voice interface card (for example, an FXS interface card) is inserted in the router.
Note:
At most 500 CDRs can be saved in a voice gateway. That is to say, the number of
CDRs saved in the system cannot exceed 500 even if none of the saved CDRs in the
system has reached the lifetime. In the case that bursty traffic is generated during a
period of time, the CDRs for the calls completed earliest are removed to keep the
number of saved CDRs under 500 even if they have not reached the lifetime.
1-11
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Two-stage dialing users must dial a specific access number before making an IP call.
Therefore, you must configure corresponding access numbers on the voice gateway
before providing the two-stage dialing service to end-users. Currently, you can
configure at most 100 access numbers on a voice gateway.
I. Configuration prerequisites
A voice interface card (for example, an FXS interface card) is inserted in the router.
An access number itself is only a code for a dialing process. You need to configure a
series of attribute parameters to form a complete dialing process.
There are three types of two-stage dialing process: caller number process (calling
number authentication), caller number process with IVR (calling number
authentication), and card number/password process (card number/password
authentication). Therefore, it is necessary to specify a dialing process for each access
number. When a dialing process is switched to another dialing process, the default
parameters will be restored.
Differences between the caller number process and the caller number process with IVR
are as follows:
z In the caller number process, after a user dials an access number, the voice
gateway plays only dial tones (long tones).
z In the caller number process with IVR, a user can select a language in which
prompt tones are played. After the user selects a language, the voice gateway
plays tones in the selected language to prompt for a called number.
I. Configuration prerequisites
1-12
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
After configuring access numbers, you can enable the RADIUS accounting function for
two-stage dialing users. Before enabling the accounting function, you must ensure that
the RADIUS server and the RADIUS client (voice gateway) can communicate with
each other at the network layer and that a list of corresponding two-stage dialing users
as well as accounting policies has been configured on the RADIUS server.
I. Configuration prerequisites
Follow these steps to enable the accounting function for two-stage dialing users:
1-13
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Note:
The accounting function for two-stage dialing users is enabled for a specific access
number, while the accounting function for one-stage dialing users is enabled in voice
AAA client view.
After configuring access numbers, you can enable the RADIUS authentication function
for two-stage dialing users. Before enabling the authentication function, you must
ensure that the RADIUS server and the RADIUS client can communicate with each
other at the network layer and that a list of corresponding two-stage dialing users as
well as authentication policies has been configured on the RADIUS server.
I. Configuration prerequisites
Follow these steps to enable the authentication function for two-stage dialing users:
Note:
The authentication function for two-stage dialing users is enabled for a specific access
number, while the authentication function for one-stage dialing users is enabled in
voice AAA client view.
1-14
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
z The RADIUS server and the RADIUS client can communicate with each other at
the network layer.
z Access numbers have been configured and the authentication function has been
enabled on the RADIUS server.
z A list of user authorities as well as authorization policies has been configured on
the RADIUS server.
I. Configuration prerequisites
Follow these steps to enable the authorization function for two-stage dialing users:
Note:
The authorization function for two-stage dialing users is enabled for a specific access
number, while the authorization function for one-stage dialing users is enabled in voice
AAA client view
1-15
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
You can use the callednumber receive-method command to configure the device to
originate a call immediately all digits of a called number are collected or after a dial
terminator # is collected.
The configuration applies to the card number/password process, caller number
process, and caller number process with IVR.
I. Configuration prerequisites
Follow these steps to configure the method of collecting digits of a called number:
Note:
If a user first dials the dial terminator #, the device will ignore it and will not consider it
as an error, and the user can continue to dial a number. This rule applies to both card
numbers and passwords.
For the card number/password process, it is necessary to stipulate the number of digits
in a card number/password. This facilitates user management and access control.
I. Configuration prerequisites
1-16
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Follow these steps to configure the number of digits in a card number and that in a
password:
Note:
z The card-digit and password-digit commands apply only to the card
number/password process. They are unavailable in the case of the caller number
process and caller number process with IVR.
z If a user is required to press the dial terminator # after dialing a card number but fails
to do so, the system will prompt timeout and require the user to redial the card
number. This rule also applies to a password.
The redialtimes command applies only to the card number/password process and the
caller number process with IVR. This command is unavailable in the case of the caller
number process.
For the card number/password process, a user first dials an access number, then
selects a language option, next enters a prepaid card number and password, and finally
dials a called number. The user can retry in each step of this process. To prevent any
dial mistake from causing a failure of the entire dialing process, you need to specify the
maximum number of dial attempts to provide fault tolerance.
1-17
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
For the caller number process with IVR, the number of redial attempts refers to the
times a called number can be redialed, and if you have enabled the language selection
function, you should also specify the maximum number of language selection attempts.
I. Configuration prerequisites
Note:
Pay attention to the following points when configuring the number of redial attempts:
z For the card number/password process, the number of redial attempts applies to
each dial step, including selecting a language option, and dialing a card number,
password, or called number.
z The redialtimes command is used to configure the number of redial attempts.
Therefore, the number of dial attempts is the number of redial attempts plus 1. For
example, if the number of redial attempts is n (redialtimes-number = n), then the
number of dial attempts is n + 1.
The language selection function applies to only the caller number process with IVR.
With the language selection function enabled, the voice gateway will play tones to
prompt for a language first and then a called number after a user dials an access
number.
1-18
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
I. Configuration prerequisites
You have configured an access number and entered access number view.
1-19
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
I. Network requirements
Local telephone users are connected to voice subscriber lines of routers directly or via
PBXs. The routers are connected to the IP network via WAN ports. The RADIUS server
is deployed on the IP network. The number of digits in a card number is 10 and that in a
password is 4.
The access number is 12345. Authentication, authorization, and accounting are
required for users who dial this access number. The maximum number of redial
attempts is 3, that is, the maximum number of dial attempts is 4.
When making an IP call, users first dial the access number 12345, then select a
language option and enter a card number and password as prompted, and finally dial
the called number if the card number/password authentication succeeds.
1-20
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
# Configure an IP address for the primary authentication and authorization server and
the primary accounting server.
[RouterA-radius-sch1] primary authentication 1.1.1.3 1812
[RouterA-radius-sch1] primary accounting 1.1.1.3 1813
# Configure the access number and set the dialing process to the card
number/password process.
[RouterA-voice] dial-program
[RouterA-voice-dial] gw-access-number 12345
[RouterA-voice-dial-anum12345] process-config cardnumber
1-21
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
# Configure an IP address for the primary authentication and authorization server and
the primary accounting server.
[RouterB-radius-sch1] primary authentication 1.1.1.3 1812
[RouterB-radius-sch1] primary accounting 1.1.1.3 1813
# Configure the access number and set the dialing process to the card
number/password process.
[RouterB-voice] dial-program
[RouterB-voice-dial] gw-access-number 12345
[RouterB-voice-dial-anum12345] process-config cardnumber
1-22
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
Note:
z The RADIUS scheme for voice RADIUS must be applied to the default domain
named system.
z The configuration procedure does not cover the configurations of route, voice
subscriber line, and called number on the routers.
z If a voice call is originated from an IP network to the voice gateway, the voice
gateway does not support the dialing of access numbers, and for one-stage dialing,
it supports only accounting, instead of authentication and authorization
After the accounting function is enabled and the accounting method is set to start-ack
or the authentication/authorization function is enabled, the system fails to connect calls.
Follow the steps below to remove the fault:
1) Use the display voice access-number command to check that the current
settings are correct.
2) Check that the RADIUS server (CAMS) works normally. For example, check that
an IP service module is installed on the CAMS, that the IP address of the voice
gateway is allowed to access to the CAMS, and that the CAMS and the voice
gateway can communicate with each other by using the ping command.
3) Check that the IP address, port number, and key of the RADIUS server on the
RADIUS server are consistent with those on the CAMS.
4) If the calling number authentication fails, check that an account is generated for
the calling number and that the account is bound to the calling number correctly.
5) If the card number/password authentication fails, check that the card number and
password are consistent with the ones generated on the CAMS.
6) If the authorization fails, check that call or access restriction is not set for the IP
phone service on the CAMS.
1-23
Operation Manual – Voice RADIUS (Voice Volume) Chapter 1 Voice RADIUS Configuration
7) Check the log generated on the CAMS and remove the fault according to the
errors.
II. Symptom 2
1-24