rfc6733 Diameter Base Protocol

Internet Engineering Task Force (IETF) V. Fajardo, Ed.

Request for Comments: 6733 Telcordia Technologies

Obsoletes:

3588, 5719 J. Arkko

Category: Standards Track Ericsson Research

ISSN: 2070-1721 J. Loughney

Nokia Research Center

G. Zorn, Ed.

Network Zen

situations. This document specifies the message format, transport,

error reporting, accounting, and security services used by all

Diameter applications. The Diameter base protocol as defined in this

document obsoletes

RFC 3588 and RFC 5719, and it must be supported by

all new Diameter implementations.

Status of This Memo

This is an Internet Standards Track document.

This document is a product of the Internet Engineering Task Force

(IETF). It represents the consensus of the IETF community. It has

http://www.rfc-editor.org/info/rfc6733.

Fajardo, et al. Standards Track [Page 1]

RFC 6733

Diameter Base Protocol October 2012

Copyright Notice

Copyright (c) 2012 IETF Trust and the persons identified as the

document authors. All rights reserved.

This document is subject to

BCP 78 and the IETF Trust’s Legal

Provisions Relating to IETF Documents

the Trust Legal Provisions and are provided without warranty as

described in the Simplified BSD License.

This document may contain material from IETF Documents or IETF

Contributions published or made publicly available before November

10, 2008. The person(s) controlling the copyright in some of this

material may not have granted the IETF Trust the right to allow

modifications of such material outside the IETF Standards Process.

Without obtaining an adequate license from the person(s) controlling

the copyright in such materials, this document may not be modified

outside the IETF Standards Process, and derivative works of it may

1.1. Diameter Protocol ..........................................9

1.1.1. Description of the Document Set ....................10

1.1.2. Conventions Used in This Document ..................11

1.1.3. Changes from RFC 3588 ..............................11

1.2. Terminology ...............................................12

1.3. Approach to Extensibility .................................17

1.3.1. Defining New AVP Values ............................18

1.3.2. Creating New AVPs ..................................18

1.3.3. Creating New Commands ..............................18

1.3.4. Creating New Diameter Applications .................19

2. Protocol Overview ..............................................20

2.6. Peer Table ................................................26

Fajardo, et al. Standards Track [Page 2]

RFC 6733

Diameter Base Protocol October 2012

2.7. Routing Table .............................................27

2.8. Role of Diameter Agents ...................................28

2.8.1. Relay Agents .......................................30

2.8.2. Proxy Agents .......................................31

2.8.3. Redirect Agents ....................................31

2.8.4. Translation Agents .................................32

2.9. Diameter Path Authorization ...............................33

3.1. Command Codes .............................................37

3.2. Command Code Format Specification .........................38

3.3. Diameter Command Naming Conventions .......................40

4.4. Grouped AVP Values ........................................51

4.5. Diameter Base Protocol AVPs ...............................55

5. Diameter Peers .................................................58

5.1. Peer Connections ..........................................58

5.2. Diameter Peer Discovery ...................................59

5.3. Capabilities Exchange .....................................60

5.3.1. Capabilities-Exchange-Request ......................62

5.3.2. Capabilities-Exchange-Answer .......................63

5.3.3. Vendor-Id AVP ......................................63

5.3.7. Product-Name AVP ...................................64

5.4. Disconnecting Peer Connections ............................64

5.4.1. Disconnect-Peer-Request ............................65

5.4.2. Disconnect-Peer-Answer .............................65

5.4.3. Disconnect-Cause AVP ...............................66

5.5. Transport Failure Detection ...............................66

5.5.1. Device-Watchdog-Request ............................67

5.5.2. Device-Watchdog-Answer .............................67

5.5.3. Transport Failure Algorithm ........................67

5.5.4. Failover and Failback Procedures ...................67

5.6. Peer State Machine ........................................68

Fajardo, et al. Standards Track [Page 3]

RFC 6733

Diameter Base Protocol October 2012

6. Diameter Message Processing ....................................74

6.1. Diameter Request Routing Overview .........................74

6.1.1. Originating a Request ..............................75

6.1.2. Sending a Request ..................................76

6.1.3. Receiving Requests .................................76

6.1.4. Processing Local Requests ..........................76

6.1.5. Request Forwarding .................................77

6.1.7. Predictive Loop Avoidance ..........................77

6.1.8. Redirecting Requests ...............................78

6.1.9. Relaying and Proxying Requests .....................79

6.6. Destination-Realm AVP .....................................82

6.7.1. Route-Record AVP ...................................83

6.7.2. Proxy-Info AVP .....................................83

6.7.3. Proxy-Host AVP .....................................83

6.7.4. Proxy-State AVP ....................................83

6.8. Auth-Application-Id AVP ...................................83

6.9. Acct-Application-Id AVP ...................................84

6.10. Inband-Security-Id AVP ...................................84

6.11. Vendor-Specific-Application-Id AVP .......................84

7. Error Handling .................................................87

7.1. Result-Code AVP ...........................................89

7.1.1. Informational ......................................90

7.1.2. Success ............................................90

7.1.3. Protocol Errors ....................................90

7.1.4. Transient Failures .................................92

7.1.5. Permanent Failures .................................92

7.2. Error Bit .................................................95

7.3. Error-Message AVP .........................................96

7.4. Error-Reporting-Host AVP ..................................96

7.5. Failed-AVP AVP ............................................96

Fajardo, et al. Standards Track [Page 4]

RFC 6733

Diameter Base Protocol October 2012

8.3. Server-Initiated Re-Auth .................................110

8.3.1. Re-Auth-Request ...................................110

8.3.2. Re-Auth-Answer ....................................110

8.4. Session Termination ......................................111

8.4.1. Session-Termination-Request .......................112

8.4.2. Session-Termination-Answer ........................113

8.5. Aborting a Session .......................................113

8.5.2. Abort-Session-Answer ..............................114

8.6. Inferring Session Termination from Origin-State-Id .......115

8.7. Auth-Request-Type AVP ....................................116

8.14. User-Name AVP ...........................................119

8.16. Origin-State-Id AVP .....................................120

8.17. Session-Binding AVP .....................................120

8.18. Session-Server-Failover AVP .............................121

8.19. Multi-Round-Time-Out AVP ................................122

8.20. Class AVP ...............................................122

8.21. Event-Timestamp AVP .....................................122

9. Accounting ....................................................123

9.1. Server Directed Model ....................................123

9.5. Accounting Records .......................................125

9.6. Correlation of Accounting Records ........................126

9.7. Accounting Command Codes .................................127

9.7.1. Accounting-Request ................................127

9.7.2. Accounting-Answer .................................128

9.8. Accounting AVPs ..........................................129

9.8.1. Accounting-Record-Type AVP ........................129

9.8.2. Acct-Interim-Interval AVP .........................130

9.8.3. Accounting-Record-Number AVP ......................131

9.8.4. Acct-Session-Id AVP ...............................131

9.8.5. Acct-Multi-Session-Id AVP .........................131

Fajardo, et al. Standards Track [Page 5]