Cisco Asr 9000 Diameter Support in BNG
Cisco Asr 9000 Diameter Support in BNG
Cisco Asr 9000 Diameter Support in BNG
DIAMETER provides a base protocol that can be extended in order to provide authentication, authorization,
and accounting (AAA) services to new access technologies. This chapter provides information about
DIAMETER protocol and its support in BNG.
Release Modification
Release 5.3.0 This chapter was introduced for DIAMETER support feature in BNG.
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
1
DIAMETER Support in BNG
DIAMETER Overview
DIAMETER Overview
DIAMETER is a peer-to-peer protocol that is composed of a base protocol and a set of applications that allow
it to extend its services to provide AAA services to new access technologies. The base protocol provides basic
mechanisms for reliable transport, message delivery, and error handling and the base protocol must be used
in conjunction with a DIAMETER application. Each application relies on the services of the base protocol to
support a specific type of network access. Each application is defined by an application identifier and associated
with commands. Each command is defined with mandatory Attribute Value Pairs (AVPs) and non-mandatory
AVPs including vendor-specific AVPs.
DIAMETER allows peers to exchange a variety of messages. The DIAMETER client generates DIAMETER
messages to the DIAMETER server to perform the AAA actions for the user. This protocol also supports
server-initiated messages, such as a request to abort service to a particular user.
Along with the DIAMETER base protocol, these DIAMETER applications are also supported in BNG:
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
2
DIAMETER Support in BNG
Supported DIAMETER Base Messages
These base protocol features are not supported in BNG with DIAMETER:
• Communication with diameter peers that act as proxy, relay or a redirection agent
• Diameter peer discovery
• SCTP as the transport protocol for DIAMETER messages
• Internet Protocol Security (IPSec)
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
3
DIAMETER Support in BNG
DIAMETER NASREQ Application
Disconnect-Peer-Request DPR 282 Sent to the peer to inform about the termination
of the connection. The client or server may initiate
the termination.
Device-Watchdog-Request DWR 280 Sent from the client to the server to monitor the
health of the connection. This happens if, for a
while, there is no traffic between peers, after CER
and CEA messages are exchanged.
For details of DIAMETER attributes and sample packets of DIAMETER messages, see Appendix E,
DIAMETER Attributes.
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
4
DIAMETER Support in BNG
DIAMETER NASREQ Application
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
5
DIAMETER Support in BNG
DIAMETER Accounting
DIAMETER Accounting
The session accounting and service accounting functionality provided by BNG, remain unchanged with the
introduction of the DIAMETER interface. BNG uses accounting messages defined in the DIAMETER base
protocol. The DIAMETER NASREQ application is used for regular AAA services over DIAMETER. The
DIAMETER accounting message construction and transport is supported as part of this application.
The DIAMETER applications in BNG have the option of using either or both of these accounting application
extension models:
• Split Accounting Service - The accounting message carries the Application-ID of the DIAMETER base
accounting application (0x00000003). The respective diameter nodes advertise the DIAMETER base
accounting Application ID during capabilities exchanges (CER and CEA).
• Coupled Accounting Service - The accounting message carries the Application-ID of the application
that is using it (for example, NASREQ). The application itself processes the received accounting records
or forwards them to an accounting server. The accounting application advertisement is not required
during capabilities exchange, and the accounting messages are routed the same way as any of the other
application messages. In the case of BNG, where an application does not define its own accounting
service, the use of the split accounting model is preferred.
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
6
DIAMETER Support in BNG
DIAMETER Gx and Gy Applications
The Gz interface between PCEF and OFCS use DIAMETER base accounting application for offline
charging. Because BNG supports session based and service based accounting, the split accounting model
in which the accounting Application-ID is inserted in all the accounting messages, is preferable.
BNG does not support persistence of accounting records when the DIAMETER server is down.
Supported Gx Messages
This table lists the DIAMETER Gx messages supported by BNG:
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
7
DIAMETER Support in BNG
DIAMETER DCCA Application
Re-Auth-Answer RAA 258 Sent by the PCEF to the PCRF in response to the
RAR command.
Abort Session Request ASR 274 Sent by any server to the access device providing
session service, requesting it to stop the session
identified by the Session-Id.
Abort Session Answer ASA 274 Sent in response to the ASR. The Result-Code
AVP that indicates the disposition of the request
must be present.
Supported Gy Messages
BNG supports these DIAMETER Gy messages:
• CCR-Initial
• CCA-Initial
• CCR-Update message with tariff change units
• CCA-Update
• CCR-Final
• CCA-Final
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
8
DIAMETER Support in BNG
DIAMETER DCCA Application
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
9
DIAMETER Support in BNG
BNG DIAMETER Call Flow
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
10
DIAMETER Support in BNG
BNG DIAMETER Call Flow
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
11
DIAMETER Support in BNG
Guidelines and Restrictions for DIAMETER Support in BNG
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
12
DIAMETER Support in BNG
Configuring DIAMETER Peer in BNG
• For regular AAA services (NASREQ), it is completely based on the AAA configuration on the router.
• For Gx, it can be based on the Gx realm selection.
• For prepaid, it is based on the charging profile associated with the subscriber session on BNG.
For details on configuring AAA for DIAMETER, see Configuring AAA for DIAMETER Peer in BNG, on
page 17.
SUMMARY STEPS
1. configure
2. diameter {gx | gy}
3. diameter peer peer name
4. transport security-type tls
5. transport tcp port port_num
6. destination host host_string
7. destination realm realm_string
8. address [ipv4 | ipv6] ip_addr
9. ip vrf forwarding vrf_table_name
10. source-interface intf-type intf-name
11. peer-type server
12. root
13. diameter origin host host-name
14. diameter origin realm realm-string
15. diameter timer [connection | transaction | watchdog] timer-value
16. diameter vendor supported [cisco | etsi | threegpp | vodafone]
17. diameter tls trustpoint label
18. diameter {gx | gy} [retransmit retansmit-timer-val | tx-timer tx-timer-val]
19. commit
DETAILED STEPS
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
13
DIAMETER Support in BNG
Configuring DIAMETER Peer in BNG
Example:
RP/0/RSP0/CPU0:router(config)# diameter
peer GX_SERVER
Step 4 transport security-type tls [Optional] Configures the DIAMETER security type as TLS.
Example:
RP/0/RSP0/CPU0:router(config-dia-peer)#
transport security-type tcp
Step 5 transport tcp port port_num Configures the DIAMETER transport protocol used for establishing
the connection with the peer, along with the port number (Optional)
Example: that the remote peer uses for DIAMETER messages.
Step 6 destination host host_string Configures the hostname of the peer in Fully Qualified Domain Name
(FQDN) format.
Example: This value is sent in various messages so that intermediate proxies can
RP/0/RSP0/CPU0:router(config-dia-peer)# correctly route the packets.
destination host dcca1.cisco.com
Step 7 destination realm realm_string [Optional] Configures the realm to which the peer belongs to.
The destination realm is added by AAA clients while sending a request
Example: to AAA server, using the AAA_AT_DESTINATION_REALM
RP/0/RSP0/CPU0:router(config-dia-peer)# attribute. If this attribute is not present, then the realm information is
destination realm GX_REALM retrieved using the User name field. If the clients do not add the
attribute, then the value configured in the peer mode is used while
sending messages to the destination peer.
Step 8 address [ipv4 | ipv6] ip_addr Configures IP address of the DIAMETER peer.
Example:
RP/0/RSP0/CPU0:router(config-dia-peer)#
address ipv4 2.2.2.2
Step 9 ip vrf forwarding vrf_table_name [Optional] Configures the VRF associated with the peer, to establish
connections with the peers immediately after configuring the peers.
Example: If this command is not configured, then the global routing table is used
RP/0/RSP0/CPU0:router(config-dia-peer)# for establishing the connection with the peer.
ip vrf forwarding VRF1
If the VRF associated with the name is not configured, then an error
message mentioning that is displayed, and this command does not have
any effect.
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
14
DIAMETER Support in BNG
Configuring DIAMETER Peer in BNG
Step 11 peer-type server Configures the peer type. By default, the peer type is, server.
Example:
RP/0/RSP0/CPU0:router(config-dia-peer)#
peer-type server
Step 12 root Returns the configuration mode back to the global configuration mode.
Example:
RP/0/RSP0/CPU0:router(config-dia-peer)#
root
Step 13 diameter origin host host-name Configures the origin host information.
The origin host information is sent in different requests to the
Example: DIAMETER peer and it maps to multiple IP addresses. If this value is
RP/0/RSP0/CPU0:router(config)# diameter not configured, then a NULL string is sent. Therefore, this is a
origin host 1.1.1.1 mandatory configuration.
Step 14 diameter origin realm realm-string [Optional] Configures the origin realm information.
The origin realm information is sent in each request to the DIAMETER
Example: peer. If this value is not configured, then a NULL string is sent.
RP/0/RSP0/CPU0:router(config)# diameter Therefore, this is a mandatory configuration.
origin realm cisco.com
Step 15 diameter timer [connection | transaction | Configures global timers for DIAMETER.
watchdog] timer-value
• Connection timer is used to delay the connection establishment
or re-establishment of client with the DIAMETER server. It
Example: determines the frequency of transport connection attempts with
RP/0/RSP0/CPU0:router(config)# diameter the peer when there is no active connection with the peer.
timer watchdog 300
• Transaction timer is used for setting the frequency of transaction
attempts. That is, the duration for which the client waits for any
response message from the peer.
• Watchdog timer is used to periodically send the
Device-Watch-Dog to the DIAMETER server to test the link
status.
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
15
DIAMETER Support in BNG
Configuring DIAMETER Peer in BNG
Step 17 diameter tls trustpoint label Specifies the trustpoint name to be used in the certificate to be used
for DIAMETER TLS exchange. If a trustpoint name is not provided,
Example: then the default trustpoint is used.
RP/0/RSP0/CPU0:router(config)# diameter
tls trustpoint DIAMETER_TRUSTPOINT
Step 18 diameter {gx | gy} [retransmit Configures the re-transmit and the transaction timers for Gx and Gy
retansmit-timer-val | tx-timer tx-timer-val] applications.
Example:
RP/0/RSP0/CPU0:router(config)# diameter
gx retransmit 5
RP/0/RSP0/CPU0:router(config)# diameter
gx tx-timer 100
Step 19 commit
DIAMETER-specific configurations:
diameter gx
diameter gy
diameter peer GX_SERVER
destination realm GX_REALM
address ipv4 2.2.2.2
!
diameter peer GY_SERVER
transport tcp port 3869
destination realm GY_REALM
address ipv4 2.2.2.2
!
diameter peer NASREQ_SERVER
address ipv4 1.1.1.2
!
diameter timer watchdog 300
diameter origin host 1.1.1.1
diameter origin realm cisco.com
diameter vendor supported threegpp
diameter vendor supported cisco
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
16
DIAMETER Support in BNG
Configuring AAA for DIAMETER Peer in BNG
SUMMARY STEPS
1. configure
2. aaa group server {diameter | radius} server-group-name
3. server peer_name
4. aaa authentication subscriber {list-name | default} group {server-group-name | diameter | radius}
5. aaa authorization subscriber {list-name | default} group {server-group-name | diameter | radius}
6. aaa accounting subscriber {list-name | default} group {server-group-name | diameter | radius}
7. aaa accounting service {list-name | default} group {server-group-name | diameter | radius}
8. aaa authorization policy-if {list-name | default} group {server-group-name | diameter | radius}
9. aaa authorization prepaid {list-name | default} group {server-group-name | diameter | radius}
10. commit
DETAILED STEPS
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
17
DIAMETER Support in BNG
Configuring AAA for DIAMETER Peer in BNG
Example:
RP/0/RSP0/CPU0:router(config)# aaa authentication
subscriber default group diameter
Step 5 aaa authorization subscriber {list-name | default} group Configures subscriber authorization with DIAMETER
{server-group-name | diameter | radius} protocol using NASREQ application.
Example:
RP/0/RSP0/CPU0:router(config)# aaa authorization
subscriber default group diameter
Step 6 aaa accounting subscriber {list-name | default} group Configures subscriber session accounting to DIAMETER
{server-group-name | diameter | radius} server using Base Accounting Application.
Example:
RP/0/RSP0/CPU0:router(config)# aaa accounting
subscriber default group diameter
Step 7 aaa accounting service {list-name | default} group Configures to carry subscriber service accounting records
{server-group-name | diameter | radius} to DIAMETER server using Base Accounting
Application.
Example:
RP/0/RSP0/CPU0:router(config)# aaa accounting
service default group diameter
Step 8 aaa authorization policy-if {list-name | default} group Configures authorization lists for policy interface (Gx
{server-group-name | diameter | radius} interface).
Example:
RP/0/RSP0/CPU0:router(config)# aaa authorization
policy-if policy_meth group GX_SG
Step 9 aaa authorization prepaid {list-name | default} group Configures authorization lists for prepaid (Gy interface).
{server-group-name | diameter | radius}
Example:
RP/0/RSP0/CPU0:router(config)# aaa authorization
prepaid prepaid_meth group GY_SG
Step 10 commit
AAA configurations:
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
18
DIAMETER Support in BNG
Verification of DIAMETER Configurations in BNG
Prepaid Service:
dynamic-template
type service prepaid
service-policy input qos_in_parent1 merge 10 acct-stats
service-policy output qos_out_parent1 merge 10 acct-stats
accounting aaa list default type service periodic-interval 30
prepaid-config prepaid_config
Prepaid Template:
subscriber
accounting prepaid prepaid_config
threshold volume 100
method-list authorization prepaid_meth
threshold time 100
password cisco
Policy Map:
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
19
DIAMETER Support in BNG
Verification of DIAMETER Configurations in BNG
SUMMARY STEPS
DETAILED STEPS
Example:
RP/0/RSP0/CPU0:router# show tcp brief
Example:
RP/0/RSP0/CPU0:router# show diameter peer
Origin Host :
Origin Realm :
Source Interface :
TLS Trustpoint :
Connection timer value : 30 seconds
Watchdog timer value : 300 seconds
Transaction timer value : 30 seconds
Number of Peers:3
Peer Statistics
------------------------------
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
20
DIAMETER Support in BNG
Verification of DIAMETER Configurations in BNG
IN / OUT
------------------------------
ASR 0 0
ASA 0 0
ACR 0 0
ACA 0 0
CER 0 1
CEA 1 0
DWR 0 0
DWA 0 0
DPR 0 0
DPA 0 0
RAR 0 0
RAA 0 0
STR 0 0
STA 0 0
AAR 0 0
AAA 0 0
CCR 0 0
CCA 0 0
Malformed Rcvd : 0
Prot. Errs Sent : 0 Prot. Errs Rcvd : 0
Trans. Errs Sent : 0 Trans. Errs Rcvd : 0
Perm. Errs Sent : 0 Perm. Errs Rcvd : 0
Example:
RP/0/RSP0/CPU0:router# show diameter gx statistics
CCR Initial Messages : 1
CCR Initial Messages Sent Failed : 0
CCR Initial Messages Timed Out : 0
CCR Initial Messages Retry : 0
CCR Update Messages : 0
CCR Update Messages Sent Failed : 0
CCR Update Messages Timed Out : 0
CCR Update Messages Retry : 0
CCR Terminate Messages : 0
CCR Terminate Messages Sent Failed : 0
CCR Terminate Messages Timed Out : 0
CCR Terminate Messages Retry : 0
CCA Initial Messages : 1
CCA Initial Messages Error : 0
CCA Update Messages : 0
CCA Update Messages Error : 0
CCA Terminate Messages : 0
CCA Terminate Messages Error : 0
RAR Received Messages : 0
RAR Received Messages Error : 0
RAA Sent Messages : 0
RAA Sent Messages Error : 0
ASR Received Messages : 0
ASR Received Messages Error : 0
ASA Sent Messages : 0
ASA Sent Messages Error : 0
Session Termination Messages Recvd : 0
Unknown Request Messages : 0
Restored Sessions : 0
Total Opened Sessions : 1
Total Closed Sessions : 0
Total Active Sessions : 1
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
21
DIAMETER Support in BNG
Verification of DIAMETER Configurations in BNG
Example:
RP/0/RSP0/CPU0:router# show diameter gy statistics
Example:
RP/0/RSP0/CPU0:router# show diameter gx session 461419
Example:
RP/0/RSP0/CPU0:router# show diameter gy session 461421
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
22
DIAMETER Support in BNG
Verification of DIAMETER Configurations in BNG
Example:
RP/0/RSP0/CPU0:router# show diameter nas session
Authentication Status : NA
Authorization Status : SUCCESS
Accounting Status (Start) : NA
Accounting Status (Stop) : NA
Disconnect status : NA
Peer Information :
Server group : NASREQ_SG
Server Used : NASREQ_SERVER
NAS Statistics :
Authentication ::
In : 0 Out : 0
Requests received : 0 Requests send : 0
Response received : 0 Result forwaded : 0
Transaction Succeeded: 0 Transactions Failed : 0
Authorization ::
In : 1 Out : 1
Requests received : 1 Requests send : 1
Response received : 1 Result forwaded : 1
Transaction Succeeded: 1 Transactions Failed : 0
Accounting (Start) ::
In : 0 Out : 0
Requests received : 0 Requests send : 0
Response received : 0 Result forwaded : 0
Transaction Succeeded: 0 Transactions Failed : 0
Accounting (Stop) ::
In : 0 Out : 0
Requests received : 0 Requests send : 0
Response received : 0 Result forwaded : 0
Transaction Succeeded: 0 Transactions Failed : 0
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
23
DIAMETER Support in BNG
Additional References
Accounting (Interim) ::
In : 0 Out : 0
Requests received : 0 Requests send : 0
Response received : 0 Result forwaded : 0
Transaction Succeeded: 0 Transactions Failed : 0
Disconnect ::
In : 0 Out : 0
Requests received : 0 Requests send : 0
Response received : 0 Result forwaded : 0
Transaction Succeeded: 0 Transactions Failed : 0
Coa (RAR) ::
In : 0 Out : 0
Requests received : 0 Requests send : 0
Response received : 0 Result forwaded : 0
Transaction Succeeded: 0 Transactions Failed : 0
POD (ASR) ::
In : 0 Out : 0
Requests received : 0 Requests send : 0
Response received : 0 Result forwaded : 0
Transaction Succeeded: 0 Transactions Failed : 0
Diameter NAS summary
Example:
RP/0/RSP0/CPU0:router# show checkpoint dynamic process diameter
-----------------------------------------------------------------------------------
Additional References
These sections provide references related to implementing DIAMETER.
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
24
DIAMETER Support in BNG
Additional References
Standard/RFC
RFC-6733 Diameter Base Protocol
MIBs
Technical Assistance
Description Link
The Cisco Support website provides extensive online http://www.cisco.com/support
resources, including documentation and tools for
troubleshooting and resolving technical issues with
Cisco products and technologies.
To receive security and technical information about
your products, you can subscribe to various services,
such as the Product Alert Tool (accessed from Field
Notices), the Cisco Technical Services Newsletter,
and Really Simple Syndication (RSS) Feeds.
Access to most tools on the Cisco Support website
requires a Cisco.com user ID and password.
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide, Release
5.3.x
25
DIAMETER Support in BNG
Additional References
Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide,
Release 5.3.x
26