< draft-ietf-dime-app-design-guide-12.txt   draft-ietf-dime-app-design-guide-13.txt >
Diameter Maintanence and V. Fajardo, Ed. Diameter Maintanence and Extensions V. Fajardo
Extensions (DIME) (DIME)
Internet-Draft H. Tschofenig Internet-Draft H. Tschofenig
Intended status: Informational Nokia Siemens Networks Intended status: Informational Nokia Siemens Networks
Expires: March 5, 2011 L. Morand Expires: July 14, 2012 L. Morand, Ed.
Orange Labs Orange Labs
September 1, 2010 January 11, 2012
Diameter Applications Design Guidelines Diameter Applications Design Guidelines
draft-ietf-dime-app-design-guide-12.txt draft-ietf-dime-app-design-guide-13
Abstract Abstract
The Diameter Base protocol provides updated rules on how to extend The Diameter Base protocol provides facilities for protocol
Diameter by modifying and/or deriving from existing applications or extensibility enabling to define new Diameter applications or modify
creating entirely new applications. This is a companion document to existing applications. This document is a companion document to the
the Diameter Base protocol that further explains and clarifies these Diameter Base protocol that further explains and clarifies the rules
rules. It is meant as a guidelines document and therefore it does to extend the Diameter Base protocol. It is meant as a guidelines
not add, remove or change existing rules. document and therefore it does not add, remove or change existing
rules.
Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [RFC2119].
Status of this Memo Status of this Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79. provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on March 5, 2011. This Internet-Draft will expire on July 14, 2012.
Copyright Notice Copyright Notice
Copyright (c) 2010 IETF Trust and the persons identified as the Copyright (c) 2012 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 4 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 5
3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4. Adding a new command . . . . . . . . . . . . . . . . . . . . . 7 4. Adding a new command . . . . . . . . . . . . . . . . . . . . . 8
5. Deleting a Command . . . . . . . . . . . . . . . . . . . . . . 8 5. Deleting a Command . . . . . . . . . . . . . . . . . . . . . . 9
6. Reusing Existing Commands . . . . . . . . . . . . . . . . . . 9 6. Reusing Existing Commands . . . . . . . . . . . . . . . . . . 10
6.1. Adding AVPs to a Command . . . . . . . . . . . . . . . . . 9 6.1. Adding AVPs to a Command . . . . . . . . . . . . . . . . . 10
6.2. Deleting AVPs from a Command . . . . . . . . . . . . . . . 10 6.2. Deleting AVPs from a Command . . . . . . . . . . . . . . . 11
7. Reusing Existing AVPs . . . . . . . . . . . . . . . . . . . . 12 7. Reusing Existing AVPs . . . . . . . . . . . . . . . . . . . . 13
8. Rules for new Applications . . . . . . . . . . . . . . . . . . 13 8. Rules for new Applications . . . . . . . . . . . . . . . . . . 14
8.1. Use of Application-Id in a Message . . . . . . . . . . . . 13 8.1. Use of Application-Id in a Message . . . . . . . . . . . . 14
8.2. Application Specific Session State Machine . . . . . . . . 14 8.2. Application Specific Session State Machine . . . . . . . . 15
9. End-to-End Applications Capabilities Exchange . . . . . . . . 15 9. End-to-End Applications Capabilities Exchange . . . . . . . . 16
10. Diameter Accounting Support . . . . . . . . . . . . . . . . . 16 10. Diameter Accounting Support . . . . . . . . . . . . . . . . . 17
11. Generic Diameter Extensions . . . . . . . . . . . . . . . . . 18 11. Generic Diameter Extensions . . . . . . . . . . . . . . . . . 19
12. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 20 12. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 21
13. Security Considerations . . . . . . . . . . . . . . . . . . . 21 13. Security Considerations . . . . . . . . . . . . . . . . . . . 22
14. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 22 14. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 23
15. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 23 15. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 24
16. References . . . . . . . . . . . . . . . . . . . . . . . . . . 24 16. References . . . . . . . . . . . . . . . . . . . . . . . . . . 25
16.1. Normative References . . . . . . . . . . . . . . . . . . . 24 16.1. Normative References . . . . . . . . . . . . . . . . . . . 25
16.2. Informative References . . . . . . . . . . . . . . . . . . 25 16.2. Informative References . . . . . . . . . . . . . . . . . . 26
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 26 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 27
1. Introduction 1. Introduction
The Diameter Base protocol document defines rules on how one would The Diameter Base protocol provides facilities to extend the Diameter
extend Diameter (see Section 1.2 of [I-D.ietf-dime-rfc3588bis]). In Base protocol (see Section 1.3 of [I-D.ietf-dime-rfc3588bis]). In
the context of this document, extending Diameter means one of the the context of this document, extending Diameter means one of the
following: following:
1. A new functionality is being added to an existing Diameter 1. A new functionality is being added to an existing Diameter
application without defining a new application. application without defining a new application.
2. A new Diameter application is being defined by extending an 2. A new Diameter application is being defined by extending an
existing application. existing application.
3. A completely new application is being defined that has nothing in 3. A completely new application is being defined that has nothing in
skipping to change at page 24, line 18 skipping to change at page 25, line 18
[I-D.ietf-dime-diameter-qos] [I-D.ietf-dime-diameter-qos]
Sun, D., McCann, P., Tschofenig, H., ZOU), T., Doria, A., Sun, D., McCann, P., Tschofenig, H., ZOU), T., Doria, A.,
and G. Zorn, "Diameter Quality of Service Application", and G. Zorn, "Diameter Quality of Service Application",
draft-ietf-dime-diameter-qos-15 (work in progress), draft-ietf-dime-diameter-qos-15 (work in progress),
March 2010. March 2010.
[I-D.ietf-dime-mip6-integrated] [I-D.ietf-dime-mip6-integrated]
Korhonen, J., Bournelle, J., Tschofenig, H., Perkins, C., Korhonen, J., Bournelle, J., Tschofenig, H., Perkins, C.,
and K. Chowdhury, "Diameter Mobile IPv6: Support for and K. Chowdhury, "Diameter Mobile IPv6: Support for
Network Access Server to Diameter Server Interaction", Network Access Server to Diameter Server Interaction",
draft-ietf-dime-mip6-integrated-12 (work in progress), draft-ietf-dime-mip6-integrated-12 (work in progress),
January 2009. January 2009.
[I-D.ietf-dime-mip6-split] [I-D.ietf-dime-mip6-split]
Korhonen, J., Tschofenig, H., Bournelle, J., Giaretta, G., Korhonen, J., Tschofenig, H., Bournelle, J., Giaretta, G.,
and M. Nakhjiri, "Diameter Mobile IPv6: Support for Home and M. Nakhjiri, "Diameter Mobile IPv6: Support for Home
Agent to Diameter Server Interaction", Agent to Diameter Server Interaction",
draft-ietf-dime-mip6-split-17 (work in progress), draft-ietf-dime-mip6-split-17 (work in progress),
April 2009. April 2009.
[I-D.ietf-dime-qos-attributes] [I-D.ietf-dime-qos-attributes]
Korhonen, J., Tschofenig, H., Arumaithurai, M., Jones, M., Korhonen, J., Tschofenig, H., Arumaithurai, M., Jones, M.,
and A. Lior, "Traffic Classification and Quality of and A. Lior, "Traffic Classification and Quality of
Service Attributes for Diameter", Service Attributes for Diameter",
draft-ietf-dime-qos-attributes-15 (work in progress), draft-ietf-dime-qos-attributes-15 (work in progress),
December 2009. December 2009.
[I-D.ietf-dime-rfc3588bis] [I-D.ietf-dime-rfc3588bis]
Fajardo, V., Arkko, J., Loughney, J., and G. Zorn, Fajardo, V., Arkko, J., Loughney, J., and G. Zorn,
"Diameter Base Protocol", draft-ietf-dime-rfc3588bis-24 "Diameter Base Protocol", draft-ietf-dime-rfc3588bis-29
(work in progress), August 2010. (work in progress), August 2011.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC3588] Calhoun, P., Loughney, J., Guttman, E., Zorn, G., and J. [RFC3588] Calhoun, P., Loughney, J., Guttman, E., Zorn, G., and J.
Arkko, "Diameter Base Protocol", RFC 3588, September 2003. Arkko, "Diameter Base Protocol", RFC 3588, September 2003.
[RFC4006] Hakala, H., Mattila, L., Koskinen, J-P., Stura, M., and J. [RFC4006] Hakala, H., Mattila, L., Koskinen, J-P., Stura, M., and J.
Loughney, "Diameter Credit-Control Application", RFC 4006, Loughney, "Diameter Credit-Control Application", RFC 4006,
August 2005. August 2005.
[TS29.228] [TS29.228]
3GPP, "IMS Cx and Dx interfaces : signalling flows and 3rd Generation Partnership Project, "3GPP TS 29.228;
message contents", 3GPP TS 29.228 Version 7.0.0 2006. Technical Specification Group Core Network and Terminals;
IP Multimedia (IM) Subsystem Cx and Dx Interfaces;
Signalling flows and message contents",
<http://www.3gpp.org/ftp/Specs/html-info/29272.htm>.
[TS29.229] [TS29.229]
3GPP, "IMS Cx and Dx interfaces based on the Diameter 3rd Generation Partnership Project, "3GPP TS 29.229;
protocol; Protocol details", 3GPP TS 29.229 Version Technical Specification Group Core Network and Terminals;
7.0.0 2006. Cx and Dx interfaces based on the Diameter protocol;
Protocol details",
<http://www.3gpp.org/ftp/Specs/html-info/29229.htm>.
[TS29.328] [TS29.328]
3GPP, "IMS Sh interface : signalling flows and message 3rd Generation Partnership Project, "3GPP TS 29.328;
content", 3GPP TS 29.328 Version 6.8.0 2005. Technical Specification Group Core Network and Terminals;
IP Multimedia (IM) Subsystem Sh interface; signalling
flows and message content",
<http://www.3gpp.org/ftp/Specs/html-info/29328.htm>.
[TS29.329] [TS29.329]
3GPP, "IMS Sh interface based on the Diameter protocol; 3rd Generation Partnership Project, "3GPP TS 29.329;
Protocol details", 3GPP TS 29.329 Version 6.6.0 2005. Technical Specification Group Core Network and Terminals;
Sh Interface based on the Diameter protocol; Protocol
details",
<http://www.3gpp.org/ftp/Specs/html-info/29329.htm>.
16.2. Informative References 16.2. Informative References
[I-D.asveren-dime-dupcons] [I-D.asveren-dime-dupcons]
Asveren, T., "Diameter Duplicate Detection Cons.", Asveren, T., "Diameter Duplicate Detection Cons.",
draft-asveren-dime-dupcons-00 (work in progress), draft-asveren-dime-dupcons-00 (work in progress),
August 2006. August 2006.
[I-D.calhoun-diameter-res-mgmt] [I-D.calhoun-diameter-res-mgmt]
Calhoun, P., "Diameter Resource Management Extensions", Calhoun, P., "Diameter Resource Management Extensions",
draft-calhoun-diameter-res-mgmt-08.txt (work in progress), draft-calhoun-diameter-res-mgmt-08.txt (work in progress),
March 2001. March 2001.
Authors' Addresses Authors' Addresses
Victor Fajardo (editor) Victor Fajardo
Email: vf0213@gmail.com Email: vf0213@gmail.com
Hannes Tschofenig Hannes Tschofenig
Nokia Siemens Networks Nokia Siemens Networks
Linnoitustie 6 Linnoitustie 6
Espoo 02600 Espoo 02600
Finland Finland
Phone: +358 (50) 4871445 Phone: +358 (50) 4871445
Email: Hannes.Tschofenig@gmx.net Email: Hannes.Tschofenig@gmx.net
URI: http://www.tschofenig.priv.at URI: http://www.tschofenig.priv.at
Lionel Morand Lionel Morand (editor)
Orange Labs Orange Labs
Phone: +33 1 4529 6257 Phone: +33 1 4529 6257
Email: lionel.morand@orange-ftgroup.com Email: lionel.morand@orange-ftgroup.com
 End of changes. 17 change blocks. 
52 lines changed or deleted 73 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/