> IPSG RADIUS Server Configuration Mode Commands
> The IP Services Gateway (IPSG) RADIUS Server Configuration Mode is used to create and configure IPSG services in the current system context. The IPSG RADIUS Server Mode configures the system to receive RADIUS accounting requests as if it is a RADIUS Accounting Server, and reply after accessing those requests for user information.
> Important: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
> bind
> This command binds the IPSG RADIUS Server service to a logical AAA interface and specifies the number of allowed subscriber sessions.
> Product
> IPSG
> Privilege
> Security Administrator, Administrator
> Syntax
> bind { accounting-proxy address ip_address | address ip_address } [ max-subscribers max_sessions | port port_number | source-context source_context ]
> bind authentication-proxy address ip_address [ acct-port port_number | auth-port port_number | max-subscribers max-sessions | source-context source_context ]
> no bind
> no
> Removes the binding for the service.
> accounting-proxy address ip_address | address ip_address } [ max-subscribers max_sessions | port port_number | source-context source_context ]

> • | accounting-proxy address ip_address: Specifies IP address of the interface where accounting proxy requests are received by this service.

> ip_address must be specified using standard IPv4 or IPv6 dotted decimal notation.

> • | address ip_address: Specifies IP address of the interface where accounting requests are received by this service.

> ip_address must be specified using standard IPv4 or IPv6 dotted decimal notation.

> • | max-subscribers max_sessions: Specifies the maximum number of subscriber sessions allowed for the service. If this option is not configured, the system defaults to the license limit.

> On an ASR 5000 chassis, in Release 8.x, max_sessions must be an integer from 0 through 3000000. In Release 9.x and later, max_sessions must be an integer from 0 through 4000000.

> • | port port_number: Specifies the port number of the interface where accounting requests are received by this service.

> port_number must be an integer from 0 through 65535.
> Default: 1813

> • | source-context source_context: Specifies the source context where RADIUS accounting requests are received.

> source_context must be an alpha and/or numeric string of 1 through 79 characters in length.
> This keyword should be configured if the source of the RADIUS requests is in a different context than the IPSG service. If this keyword is not configured, the system will default to the context in which the IPSG service is configured.
> authentication-proxy address ip_address [ acct-port port_number | auth-port port_number | max-subscribers max_sessions | source-context source_context ]

> • | authentication-proxy address ip_address: Specifies IP address of the interface where authentication proxy requests are received by this service.

> ip_address must be specified using standard IPv4 or IPv6 dotted decimal notation.
> Important: Enabling authentication proxy also enables accounting proxy.

> • | acct-port port_number: Specifies the port number of the interface where accounting proxy requests are received by this service.

> port_number must be an integer from 0 through 65535.
> Default: 1813

> • | auth-port port_number: Specifies the port number of the interface where authentication proxy requests are received by this service.

> port_number must be an integer from 0 through 65535.
> Default: 1812

> • | max-subscribers max_sessions: Specifies the maximum number of subscriber sessions allowed for the service. If this option is not configured, the system defaults to the license limit.

> On an ASR 5000 chassis, in Release 8.x, max_sessions must be an integer from 0 through 3000000. In Release and 9.0 and later, max_sessions must be an integer from 0 through 4000000.

> • | source-context source_context: Specifies the source context where RADIUS accounting requests are received.

> source_context must be an alpha and/or numeric string of 1 through 79 characters in length.
> This keyword should be configured if the source of the RADIUS requests is in a different context then the IPSG service. If this keyword is not configured, the system will default to the context in which the IPSG service is configured.
> Usage
> Use this command to bind the IPSG RADIUS Server service to a logical AAA interface and specify the number of allowed subscriber sessions. If the AAA interface is not located in this context, configure the source-context parameter.
> Use the accounting and authentication proxy settings to enable RADIUS proxy server functionality on the IPSG. These commands are used when the NAS providing the RADIUS request messages is incapable of sending them to two separate devices. The IPSG in RADIUS Server mode proxies the RADIUS request and response messages while performing the user identification task in order to provide services to the session.
> Example
> The following command binds the service to a AAA interface with and IP address of 1.2.3.4 located in the source context named aaa_ingress:
> bind address 1.2.3.4 source-context aaa_ingress
> connection authorization
> This command configures the RADIUS authorization password that must be matched by the RADIUS accounting requests received by this service.
> Product
> IPSG
> Privilege
> Security Administrator, Administrator
> Syntax
> connection authorization { [ encrypted ] password password }
> no connection authorization
> no
> Removes the RADIUS authorization for the IPSG RADIUS server service.
> [ encrypted ] password password

> • | encrypted: Specifies that the RADIUS authorization password is encrypted.

> • | password password: Specifies the password that must be matched by incoming RADIUS accounting requests.

> password must be an alpha and/or numeric string of 1 through 63 characters in length.
> Usage
> The IPSG RADIUS server service does not terminate RADIUS user authentication so the user password is unknown.
> Use this command to configure the authorization password that the RADIUS accounting requests must match in order for the service to examine and extract user information.
> Example
> The following command sets the RADIUS authorization password that must be matched by the RADIUS accounting requests sent to this service. The password must be encrypted and the example provided is the word “secret”.
> connection authorization encrypted password secret
> end
> This command exits the IPSG RADIUS Server Configuration Mode and returns the CLI prompt to the Exec Mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> end
> Usage
> Use this command to change to the Exec Mode.
> exit
> This command exits the IPSG RADIUS Server Configuration Mode and returns the CLI prompt to the Context Configuration Mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> exit
> Usage
> Use this command to return to the Context Configuration Mode.
> profile
> This command configures the service to use APN or subscriber profiles.
> Product
> IPSG
> Privilege
> Security Administrator, Administrator
> Syntax
> profile { APN | subscriber }
> default profile
> default
> Configures the default setting for this command.
> Default: APN
> APN
> Sets the service to support APN configuration required to enable Gx support.
> subscriber
> Sets the service to support subscriber profile lookup.
> Usage
> Use this command to set the service to support APN profiles (supporting Gx through the enabling of ims-auth-service) or for basic subscriber profile lookup.
> radius accounting
> Specifies the IP address and shared secret of the RADIUS accounting client from which RADIUS accounting requests are received. The RADIUS client can be either the access gateway or the RADIUS accounting server depending on which device is sending accounting requests.
> Product
> IPSG
> Privilege
> Security Administrator, Administrator
> Syntax
> radius accounting { { client { ip_address | ip_address/mask } [ encrypted ] key secret [ dictionary dictionary ] [ disconnect-message [ dest-port destination_port ] ] } | { interim create-new-call } }
> no radius accounting client { ip_address | ip_address/mask }
> default radius accounting interim create-new-call
> no
> Removes the RADIUS accounting client address identifier from the service.
> ip_address | ip_address/mask
> Specifies the IP address and, optionally, subnet mask of the RADIUS client from which RADIUS accounting requests are received.
> ip_address and ip_address/mask must be specified using standard IPv4 or IPv6 dotted decimal notation.
> Up to 16 addresses can be configured.
> dictionary dictionary
> Specifies what dictionary database to use. The possible values for dictionary are described in the following table:

> Dictionary | Description
> 3gpp2 | This dictionary consists not only of all of the attributes in the standard dictionary, but also all of the attributes specified in IS-835-A.
> 3gpp2-835 | This dictionary consists not only of all of the attributes in the standard dictionary, but also all of the attributes specified in IS-835.
> custom X | These are dictionaries that can be customized to fit your needs. Customization information can be attained by contacting your local service representative. X is the integer value of the custom dictionary.
> standard | This dictionary consists only of the attributes specified in RFC 2865, RFC 2866, and RFC 2869.
> starent | This dictionary consists of all of the attributes in the starent-vsa1 dictionary and incorporates additional Starent Networks VSAs by using a two-byte VSA Type field. This dictionary is the master-set of all of the attributes in all of the dictionaries supported by the system.
> starent-835 | This dictionary consists of all of the attributes in the starent-vsa1-835 dictionary and incorporates additional Starent Networks VSAs by using a two-byte VSA Type field. This dictionary is the master-set of all of the attributes in all of the -835 dictionaries supported by the system.
> starent-vsa1 | This dictionary consists not only of the 3gpp2 dictionary, but also includes Starent Networks vendor-specific attributes (VSAs) as well. The VSAs in this dictionary support a one-byte wide VSA Type field in order to support certain RADIUS applications. The one-byte limit allows support for only 256 VSAs (0 - 255). This is the default dictionary.
> starent-vsa1-835 | This dictionary consists not only of the 3gpp2-835 dictionary, but also includes Starent Networks vendor-specific attributes (VSAs) as well. The VSAs in this dictionary support a one-byte wide VSA Type field in order to support certain RADIUS applications. The one-byte limit allows support for only 256 VSAs (0 - 255). This is the default dictionary.

> ‌
> [ encrypted ] key secret

> • | encrypted: Specifies that the shared key between the RADIUS client and this service is encrypted.

> • | key secret: Specifies the shared key between the RADIUS client and this service.

> secret must be an alpha and/or numeric string of 1 through 127 characters in length, and is case sensitive.
> disconnect-message [ dest-port destination_port ]
> Specifies sending disconnect message.
> dest-port destination_port: Optionally, the port number to which the disconnect message must be sent can be specified.
> destination_port must be an integer from 1 through 65535.
> interim create-new-call
> Enables the ability to create a new session upon receipt of a RADIUS interim message.
> Default: Disabled
> Usage
> Use this command to configure the communication with the RADIUS client from which RADIUS accounting requests are received.
> Example
> The following command configures the service to communicate with a RADIUS client with an IP address of 1.2.3.4 and an encrypted shared secret of secret_1234:
> radius accounting client 1.2.3.4 encrypted key secret_1234
> radius dictionary
> Configures the RADIUS database dictionary to use for the IPSG service.
> Product
> IPSG
> Privilege
> Security Administrator, Administrator
> Syntax
> radius dictionary dictionary
> default radius dictionary
> dictionary dictionary
> Default: starent-vsa1
> Specifies what dictionary database to use. The possible values for dictionary are described in the table that follows:

> Dictionary | Description
> 3gpp2 | This dictionary consists not only of all of the attributes in the standard dictionary, but also all of the attributes specified in IS-835-A.
> 3gpp2-835 | This dictionary consists not only of all of the attributes in the standard dictionary, but also all of the attributes specified in IS-835.
> custom XX | These are dictionaries that can be customized to fit your needs. Customization information can be attained by contacting your local service representative. XX is the integer value of the custom dictionary.
> standard | This dictionary consists only of the attributes specified in RFC 2865, RFC 2866, and RFC 2869.
> starent | This dictionary consists of all of the attributes in the starent-vsa1 dictionary and incorporates additional Starent Networks VSAs by using a two-byte VSA Type field. This dictionary is the master-set of all of the attributes in all of the dictionaries supported by the system.
> starent-835 | This dictionary consists of all of the attributes in the starent-vsa1-835 dictionary and incorporates additional Starent Networks VSAs by using a two-byte VSA Type field. This dictionary is the master-set of all of the attributes in all of the -835 dictionaries supported by the system.
> starent-vsa1 | This dictionary consists not only of the 3gpp2 dictionary, but also includes Starent Networks vendor-specific attributes (VSAs) as well. The VSAs in this dictionary support a one-byte wide VSA Type field in order to support certain RADIUS applications. The one-byte limit allows support for only 256 VSAs (0 - 255). This is the default dictionary.
> starent-vsa1-835 | This dictionary consists not only of the 3gpp2-835 dictionary, but also includes Starent Networks vendor-specific attributes (VSAs) as well. The VSAs in this dictionary support a one-byte wide VSA Type field in order to support certain RADIUS applications. The one-byte limit allows support for only 256 VSAs (0 - 255). This is the default dictionary.

> ‌
> Usage
> Use this command to specify the RADIUS database dictionary to use for the IPSG service.
> Example
> The following command configures the IPSG service to use the custom10 RADIUS database dictionary:
> radius dictionary custom10
> setup-timeout
> Configures a timeout value for IPSG session set up attempts.
> Product
> IPSG
> Privilege
> Security Administrator, Administrator
> Syntax
> setup-timeout seconds
> default setup-timeout
> seconds
> Specifies the time period, in seconds, the IPSG session setup is allowed to continue before the set up attempt is terminated.
> seconds must be an integer from 1 through 100000.
> Default: 60
> Usage
> Use this command to prevent IPSG session set up attempts from continuing without termination.
> Example
> The following command sets the session setup timeout to 20 seconds:
> setup-timeout 20

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883