Improve GTK-DOC coverage.
[gnutls.git] / doc / protocol / draft-ietf-tls-psk-null-03.txt
blob20ac868f74189b5187be6be00c34ad12ee74d304
1 TLS Working Group                                         U. Blumenthal 
2 Internet Draft                                                  P. Goel 
3 Expires: April 2007                                   Intel Corporation 
4                                                        October 20, 2006 
5                                     
6  
7                                       
8           Pre-Shared Key Cipher Suites with NULL Encryption for 
9                       Transport Layer Security (TLS) 
12                       draft-ietf-tls-psk-null-03.txt 
15 Status of this Memo 
17    By submitting this Internet-Draft, each author represents that       
18    any applicable patent or other IPR claims of which he or she is       
19    aware have been or will be disclosed, and any of which he or she       
20    becomes aware will be disclosed, in accordance with Section 6 of       
21    BCP 79. 
23    Internet-Drafts are working documents of the Internet Engineering 
24    Task Force (IETF), its areas, and its working groups.  Note that 
25    other groups may also distribute working documents as Internet-
26    Drafts. 
28    Internet-Drafts are draft documents valid for a maximum of six months 
29    and may be updated, replaced, or obsoleted by other documents at any 
30    time.  It is inappropriate to use Internet-Drafts as reference 
31    material or to cite them other than as "work in progress." 
33    The list of current Internet-Drafts can be accessed at 
34         http://www.ietf.org/ietf/1id-abstracts.txt 
36    The list of Internet-Draft Shadow Directories can be accessed at 
37         http://www.ietf.org/shadow.html 
39    This Internet-Draft will expire on April 20, 2007. 
41 Abstract 
43    This document specifies authentication-only cipher suites (with no 
44    encryption) for the Pre-Shared Key based Transport Layer Security 
45    (TLS) protocol. These cipher suites are useful when authentication 
46    and integrity protection is desired, but confidentiality is not 
47    needed or not permitted. 
52 Blumenthal & Goel       Expires April 20, 2007                 [Page 1] 
54 Internet-Draft   PSK NULL-encryption Cipher Suites for TLS    October 
55 2006 
56     
58 Conventions used in this document 
60    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 
61    "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 
62    document are to be interpreted as described in [RFC2119]. 
64 Table of Contents 
66     
67    1. Introduction...................................................2 
68    2. Cipher Usage...................................................2 
69    3. Security Considerations........................................3 
70    4. IANA Considerations............................................3 
71    5. Acknowledgments................................................3 
72    6. References.....................................................4 
73       6.1. Normative References......................................4 
74    Author's Addresses................................................4 
75    Intellectual Property Statement...................................5 
76    Disclaimer of Validity............................................5 
77    Copyright Statement...............................................5 
78    Acknowledgment....................................................4 
79     
80 1. Introduction 
82    The RFC for Pre-Shared Key based TLS [TLS-PSK] specifies cipher 
83    suites for supporting TLS using pre-shared symmetric keys. However 
84    all the cipher suites defined in [TLS-PSK] require encryption. 
85    However there are cases when only authentication and integrity 
86    protection is required, and confidentiality is not needed. There are 
87    also cases when confidentiality is not permitted -  e.g. for 
88    implementations that must meet import restrictions in some countries. 
89    Even though no encryption is used, these cipher suites support 
90    authentication of the client and server to each other, and message 
91    integrity. This document augments [TLS-PSK] by adding three more 
92    cipher suites (PSK, DHE_PSK, RSA_PSK) with authentication and 
93    integrity only - no encryption. The reader is expected to become 
94    familiar with [TLS-PSK] standard prior to studying this document. 
96     
98 2. Cipher Usage 
100    The three new cipher suites proposed here match the three cipher 
101    suites defined in [TLS-PSK], except that we define suites with null 
102    encryption. 
105 Blumenthal & Goel       Expires April 20, 2007                 [Page 2] 
107 Internet-Draft   PSK NULL-encryption Cipher Suites for TLS    October 
108 2006 
109     
111    The cipher suites defined here use the following options for key 
112    exchange and hash part of the protocol: 
114     
116    CipherSuite                     Key Exchange   Cipher      Hash 
118    TLS_PSK_WITH_NULL_SHA           PSK            NULL        SHA 
119    TLS_DHE_PSK_WITH_NULL_SHA       DHE_PSK        NULL        SHA 
120    TLS_RSA_PSK_WITH_NULL_SHA       RSA_PSK        NULL        SHA 
121     
122    For the meaning of the terms PSK please refer to section 1 in [TLS-
123    PSK]. For the meaning of the terms DHE, RSA and SHA please refer to 
124    sections A.5 and Appendix B in [TLS].  
126 3. Security Considerations 
128    As with all schemes involving shared keys, special care should be 
129    taken to protect the shared values and to limit their exposure over 
130    time. As this document augments [TLS-PSK], everything stated in its 
131    Security Consideration section applies here. In addition, as cipher 
132    suites defined here do not support confidentiality - care should be 
133    taken not to send sensitive information (such as passwords) over 
134    connection protected with one of the cipher suites defined in this 
135    document. 
137 4. IANA Considerations 
139    This document defines three new cipher suites, whose values are to be 
140    assigned from the TLS Cipher Suite registry defined in [TLS]. 
142    CipherSuite   TLS_PSK_WITH_NULL_SHA      = { 0x00, 0xTBD1 }; 
143    CipherSuite   TLS_DHE_PSK_WITH_NULL_SHA  = { 0x00, 0xTBD2 }; 
144    CipherSuite   TLS_RSA_PSK_WITH_NULL_SHA  = { 0x00, 0xTBD3 }; 
145     
146 5. Acknowledgments 
148    The cipher suites defined in this document are an augmentation to and 
149    based on [TLS-PSK]. 
154 Blumenthal & Goel       Expires April 20, 2007                 [Page 3] 
156 Internet-Draft   PSK NULL-encryption Cipher Suites for TLS    October 
157 2006 
158     
160 6. References 
162 6.1. Normative References 
164    [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 
165              Requirement Levels", BCP 14, RFC 2119, March 1997. 
167    [TLS]     Dierks, T. and Rescorla, E., "The TLS Protocol Version 
168              1.1", RFC 4346, April 2006. 
170    [TLS-PSK] Eronen, P., Tschofenig, H., "Pre-Shared Key CipherSuites 
171              for Transport Layer Security (TLS)", RFC 4279, December 
172              2005. 
174     
176 Author's Addresses 
178    Uri Blumenthal 
179    Intel Corporation 
180    1515 State Route 10,  
181    PY2-1 10-4 
182    Parsippany, NJ 07054 
183    USA 
184        
185    Email: Uri.Blumenthal@intel.com 
186     
188    Purushottam Goel 
189    Intel Corporation 
190    2111 N.E. 25 Ave. 
191    JF3-414 
192    Hillsboro, OR 97124 
193    USA 
194        
195    Email: Purushottam.Goel@intel.com 
200 Acknowledgment 
202    Funding for the RFC Editor function is currently provided by the 
203    Internet Society. 
207 Blumenthal & Goel       Expires April 20, 2007                 [Page 4] 
209 Internet-Draft   PSK NULL-encryption Cipher Suites for TLS    October 
210 2006 
211     
213     
215 Intellectual Property Statement 
217    The IETF takes no position regarding the validity or scope of any 
218    Intellectual Property Rights or other rights that might be claimed to 
219    pertain to the implementation or use of the technology described in 
220    this document or the extent to which any license under such rights 
221    might or might not be available; nor does it represent that it has 
222    made any independent effort to identify any such rights.  Information 
223    on the procedures with respect to rights in RFC documents can be 
224    found in BCP 78 and BCP 79. 
226    Copies of IPR disclosures made to the IETF Secretariat and any 
227    assurances of licenses to be made available, or the result of an 
228    attempt made to obtain a general license or permission for the use of 
229    such proprietary rights by implementers or users of this 
230    specification can be obtained from the IETF on-line IPR repository at 
231    http://www.ietf.org/ipr. 
233    The IETF invites any interested party to bring to its attention any 
234    copyrights, patents or patent applications, or other proprietary 
235    rights that may cover technology that may be required to implement 
236    this standard.  Please address the information to the IETF at 
237    ietf-ipr@ietf.org. 
239 Disclaimer of Validity 
241    This document and the information contained herein are provided on an 
242    "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS 
243    OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET 
244    ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, 
245    INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE 
246    INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED 
247    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 
249 Copyright Statement 
251    Copyright (C) The Internet Society (2006). 
253    This document is subject to the rights, licenses and restrictions 
254    contained in BCP 78, and except as set forth therein, the authors 
255    retain all their rights. 
257   
260 Blumenthal & Goel       Expires April 20, 2007                 [Page 5]