Improve GTK-DOC coverage.
[gnutls.git] / doc / protocol / draft-ietf-tls-rfc3546bis-00.txt
blob468f6bc6afbc25d4be4050bac252d89667c829a1
2 TLS Working Group                                        S. Blake-Wilson
3 Internet-Draft                                                       BCI
4 Obsoletes: 3546 (if approved)                                 M. Nystrom
5 Updates: 2246                                               RSA Security
6 Category: Standards Track                                     D. Hopwood
7 Expires: May 2005                                 Independent Consultant
8                                                             J. Mikkelsen
9                                                          Transactionware
10                                                                T. Wright
11                                                                 Vodafone
12                                                            November 2004
15                Transport Layer Security (TLS) Extensions
16                    <draft-ietf-tls-rfc3546bis-00.txt>
18 Status of this Memo
20    This document is an Internet-Draft and is subject to all provisions
21    of section 3 of RFC 3667.  By submitting this Internet-Draft, each
22    author represents that any applicable patent or other IPR claims of
23    which he or she is aware have been or will be disclosed, and any of
24    which he or she become aware will be disclosed, in accordance with
25    RFC 3668.
27    Internet-Drafts are working documents of the Internet Engineering
28    Task Force (IETF), its areas, and its working groups.  Note that
29    other groups may also distribute working documents as Internet-
30    Drafts.
32    Internet-Drafts are draft documents valid for a maximum of six months
33    and may be updated, replaced, or obsoleted by other documents at any
34    time.  It is inappropriate to use Internet-Drafts as reference
35    material or to cite them other than as "work in progress."
37    The list of current Internet-Drafts can be accessed at http://
38    www.ietf.org/ietf/1id-abstracts.txt.
40    The list of Internet-Draft Shadow Directories can be accessed at
41    http://www.ietf.org/shadow.html.
43    This Internet-Draft will expire in May 2005.
45 Copyright Notice
47    Copyright (C) The Internet Society (2004).  All Rights Reserved.
49 Abstract
51    This document describes extensions that may be used to add
52    functionality to Transport Layer Security (TLS).  It provides both
53    generic extension mechanisms for the TLS handshake client and server
54    hellos, and specific extensions using these generic mechanisms.
56    The extensions may be used by TLS clients and servers.  The
57    extensions are backwards compatible - communication is possible
58    between TLS 1.0 clients that support the extensions and TLS 1.0
59    servers that do not support the extensions, and vice versa.
61 Blake-Wilson, et. al.       Standards Track                     [Page 1]
63 Internet-Draft               TLS Extensions                November 2004
65 Conventions used in this Document
67    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
68    "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
69    document are to be interpreted as described in BCP 14, RFC 2119
70    [KEYWORDS].
72 Table of Contents
74    1.  Introduction .............................................  2
75    2.  General Extension Mechanisms .............................  4
76        2.1. Extended Client Hello ...............................  5
77        2.2. Extended Server Hello ...............................  5
78        2.3. Hello Extensions ....................................  6
79        2.4. Extensions to the handshake protocol ................  7
80    3.  Specific Extensions ......................................  8
81        3.1. Server Name Indication ..............................  8
82        3.2. Maximum Fragment Length Negotiation ................. 10
83        3.3. Client Certificate URLs ............................. 11
84        3.4. Trusted CA Indication ............................... 14
85        3.5. Truncated HMAC ...................................... 15
86        3.6. Certificate Status Request........................... 16
87    4. Error alerts .............................................. 18
88    5. Procedure for Defining New Extensions...................... 20
89    6.  Security Considerations .................................. 21
90        6.1. Security of server_name ............................. 21
91        6.2. Security of max_fragment_length ..................... 21
92        6.3. Security of client_certificate_url .................. 22
93        6.4. Security of trusted_ca_keys ......................... 23
94        6.5. Security of truncated_hmac .......................... 23
95        6.6. Security of status_request .......................... 24
96    7.  Internationalization Considerations ...................... 24
97    8.  IANA Considerations ...................................... 24
98    9.  Intellectual Property Rights ............................. 26
99    10. Acknowledgments .......................................... 26
100    11. Normative References ..................................... 27
101    12. Informative References ................................... 28
102    13. Authors' Addresses ....................................... 28
103    14. Full Copyright Statement ................................. 29
105 1. Introduction
107    This document describes extensions that may be used to add
108    functionality to Transport Layer Security (TLS).  It provides both
109    generic extension mechanisms for the TLS handshake client and server
110    hellos, and specific extensions using these generic mechanisms.
112    TLS is now used in an increasing variety of operational environments
113    - many of which were not envisioned when the original design criteria
114    for TLS were determined.  The extensions introduced in this document
115    are designed to enable TLS to operate as effectively as possible in
116    new environments like wireless networks.
118 Blake-Wilson, et. al.       Standards Track                     [Page 2]
120 Internet-Draft               TLS Extensions                November 2004
123    Wireless environments often suffer from a number of constraints not
124    commonly present in wired environments.  These constraints may
125    include bandwidth limitations, computational power limitations,
126    memory limitations, and battery life limitations.
128    The extensions described here focus on extending the functionality
129    provided by the TLS protocol message formats.  Other issues, such as
130    the addition of new cipher suites, are deferred.
132    Specifically, the extensions described in this document are designed
133    to:
135    -  Allow TLS clients to provide to the TLS server the name of the
136       server they are contacting.  This functionality is desirable to
137       facilitate secure connections to servers that host multiple
138       'virtual' servers at a single underlying network address.
140    -  Allow TLS clients and servers to negotiate the maximum fragment
141       length to be sent.  This functionality is desirable as a result of
142       memory constraints among some clients, and bandwidth constraints
143       among some access networks.
145    -  Allow TLS clients and servers to negotiate the use of client
146       certificate URLs.  This functionality is desirable in order to
147       conserve memory on constrained clients.
149    -  Allow TLS clients to indicate to TLS servers which CA root keys
150       they possess.  This functionality is desirable in order to prevent
151       multiple handshake failures involving TLS clients that are only
152       able to store a small number of CA root keys due to memory
153       limitations.
155    -  Allow TLS clients and servers to negotiate the use of truncated
156       MACs.  This functionality is desirable in order to conserve
157       bandwidth in constrained access networks.
159    -  Allow TLS clients and servers to negotiate that the server sends
160       the client certificate status information (e.g., an Online
161       Certificate Status Protocol (OCSP) [OCSP] response) during a TLS
162       handshake.  This functionality is desirable in order to avoid
163       sending a Certificate Revocation List (CRL) over a constrained
164       access network and therefore save bandwidth.
166    In order to support the extensions above, general extension
167    mechanisms for the client hello message and the server hello message
168    are introduced.
174 Blake-Wilson, et. al.       Standards Track                     [Page 3]
176 Internet-Draft               TLS Extensions                November 2004
179    The extensions described in this document may be used by TLS 1.0
180    clients and TLS 1.0 servers.  The extensions are designed to be
181    backwards compatible - meaning that TLS 1.0 clients that support the
182    extensions can talk to TLS 1.0 servers that do not support the
183    extensions, and vice versa.
185    Backwards compatibility is primarily achieved via two considerations:
187    -  Clients typically request the use of extensions via the extended
188       client hello message described in Section 2.1. TLS 1.0 [TLS]
189       requires servers to accept extended client hello messages, even if
190       the server does not "understand" the extension.
192    -  For the specific extensions described here, no mandatory server
193       response is required when clients request extended functionality.
195    Note however, that although backwards compatibility is supported,
196    some constrained clients may be forced to reject communications with
197    servers that do not support the extensions as a result of the limited
198    capabilities of such clients.
200    The remainder of this document is organized as follows.  Section 2
201    describes general extension mechanisms for the client hello and
202    server hello handshake messages.  Section 3 describes specific
203    extensions to TLS 1.0.  Section 4 describes new error alerts for use
204    with the TLS extensions.  The final sections of the document address
205    IPR, security considerations, registration of the application/pkix-
206    pkipath MIME type, acknowledgements, and references.
208 2. General Extension Mechanisms
210    This section presents general extension mechanisms for the TLS
211    handshake client hello and server hello messages.
213    These general extension mechanisms are necessary in order to enable
214    clients and servers to negotiate whether to use specific extensions,
215    and how to use specific extensions.  The extension formats described
216    are based on [MAILING LIST].
218    Section 2.1 specifies the extended client hello message format,
219    Section 2.2 specifies the extended server hello message format, and
220    Section 2.3 describes the actual extension format used with the
221    extended client and server hellos.
230 Blake-Wilson, et. al.       Standards Track                     [Page 4]
232 Internet-Draft               TLS Extensions                November 2004
234 2.1. Extended Client Hello
236    Clients MAY request extended functionality from servers by sending
237    the extended client hello message format in place of the client hello
238    message format.  The extended client hello message format is:
240       struct {
241           ProtocolVersion client_version;
242           Random random;
243           SessionID session_id;
244           CipherSuite cipher_suites<2..2^16-1>;
245           CompressionMethod compression_methods<1..2^8-1>;
246           Extension client_hello_extension_list<0..2^16-1>;
247       } ClientHello;
249    Here the new "client_hello_extension_list" field contains a list of
250    extensions.  The actual "Extension" format is defined in Section 2.3.
252    In the event that a client requests additional functionality using
253    the extended client hello, and this functionality is not supplied by
254    the server, the client MAY abort the handshake.
256    Note that [TLS], Section 7.4.1.2, allows additional information to be
257    added to the client hello message.  Thus the use of the extended
258    client hello defined above should not "break" existing TLS 1.0
259    servers.
261    A server that supports the extensions mechanism MUST accept only
262    client hello messages in either the original or extended ClientHello
263    format, and (as for all other messages) MUST check that the amount of
264    data in the message precisely matches one of these formats; if not
265    then it MUST send a fatal "decode_error" alert.  This overrides the
266    "Forward compatibility note" in [TLS].
268 2.2. Extended Server Hello
270    The extended server hello message format MAY be sent in place of the
271    server hello message when the client has requested extended
272    functionality via the extended client hello message specified in
273    Section 2.1.  The extended server hello message format is:
285 Blake-Wilson, et. al.       Standards Track                     [Page 5]
287 Internet-Draft               TLS Extensions                November 2004
289       struct {
290           ProtocolVersion server_version;
291           Random random;
292           SessionID session_id;
293           CipherSuite cipher_suite;
294           CompressionMethod compression_method;
295           Extension server_hello_extension_list<0..2^16-1>;
296       } ServerHello;
298    Here the new "server_hello_extension_list" field contains a list of
299    extensions.  The actual "Extension" format is defined in Section 2.3.
301    Note that the extended server hello message is only sent in response
302    to an extended client hello message.  This prevents the possibility
303    that the extended server hello message could "break" existing TLS 1.0
304    clients.
306 2.3. Hello Extensions
308    The extension format for extended client hellos and extended server
309    hellos is:
311       struct {
312           ExtensionType extension_type;
313           opaque extension_data<0..2^16-1>;
314       } Extension;
316    Here:
318    - "extension_type" identifies the particular extension type.
320    - "extension_data" contains information specific to the particular
321    extension type.
323    The extension types defined in this document are:
325       enum {
326           server_name(0), max_fragment_length(1),
327           client_certificate_url(2), trusted_ca_keys(3),
328           truncated_hmac(4), status_request(5), (65535)
329       } ExtensionType;
331    The list of defined extension types is maintained by the IANA. The
332    current list can be found at XXX (suggest 
333    http://www.iana.org/assignments/tls-extensions). See sections 5 and
334    8 for more information on how new values are added.
336    Note that for all extension types (including those defined in
337    future), the extension type MUST NOT appear in the extended server
338    hello unless the same extension type appeared in the corresponding
339    client hello.  Thus clients MUST abort the handshake if they receive
340    an extension type in the extended server hello that they did not
341    request in the associated (extended) client hello.
343 Blake-Wilson, et. al.       Standards Track                     [Page 6]
345 Internet-Draft               TLS Extensions                November 2004
347    Nonetheless "server initiated" extensions may be provided in the
348    future within this framework by requiring the client to first send an
349    empty extension to indicate that it supports a particular extension.
351    Also note that when multiple extensions of different types are
352    present in the extended client hello or the extended server hello,
353    the extensions may appear in any order.  There MUST NOT be more than
354    one extension of the same type.
356    Finally note that an extended client hello may be sent both when
357    starting a new session and when requesting session resumption.
358    Indeed a client that requests resumption of a session does not in 
359    general know whether the server will accept this request, and 
360    therefore it SHOULD send an extended client hello if it would normally 
361    do so for a new session. In general the specification of each
362    extension type must include a discussion of the effect of the
363    extension both during new sessions and during resumed sessions.
365 2.4. Extensions to the handshake protocol
367    This document suggests the use of two new handshake messages,
368    "CertificateURL" and "CertificateStatus".  These messages are
369    described in Section 3.3 and Section 3.6, respectively. The new
370    handshake message structure therefore becomes:
372       enum {
373           hello_request(0), client_hello(1), server_hello(2),
374           certificate(11), server_key_exchange (12),
375           certificate_request(13), server_hello_done(14),
376           certificate_verify(15), client_key_exchange(16),
377           finished(20), certificate_url(21), certificate_status(22),
378           (255)
379       } HandshakeType;
394 Blake-Wilson, et. al.       Standards Track                     [Page 7]
396 Internet-Draft               TLS Extensions                November 2004
398       struct {
399           HandshakeType msg_type;    /* handshake type */
400           uint24 length;             /* bytes in message */
401           select (HandshakeType) {
402               case hello_request:       HelloRequest;
403               case client_hello:        ClientHello;
404               case server_hello:        ServerHello;
405               case certificate:         Certificate;
406               case server_key_exchange: ServerKeyExchange;
407               case certificate_request: CertificateRequest;
408               case server_hello_done:   ServerHelloDone;
409               case certificate_verify:  CertificateVerify;
410               case client_key_exchange: ClientKeyExchange;
411               case finished:            Finished;
412               case certificate_url:     CertificateURL;
413               case certificate_status:  CertificateStatus;
414           } body;
415       } Handshake;
417 3. Specific Extensions
419    This section describes the specific TLS extensions specified in this
420    document.
422    Note that any messages associated with these extensions that are sent
423    during the TLS handshake MUST be included in the hash calculations
424    involved in "Finished" messages.
426    Note also that all the extensions defined in this Section are
427    relevant only when a session is initiated. When a client includes
428    one or more of the defined extension types in an extended client hello
429    while requesting session resumption:
431    - If the resumption request is denied, the use of the extensions
432    is negotiated as normal.  
434    - If, on the other hand, the older session is resumed, then the server 
435    MUST ignore the extensions and send a server hello containing none
436    of the extension types; in this case the functionality of these
437    extensions negotiated during the original session initiation is applied
438    to the resumed session.
440    Section 3.1 describes the extension of TLS to allow a client to
441    indicate which server it is contacting.  Section 3.2 describes the
442    extension to provide maximum fragment length negotiation.  Section
443    3.3 describes the extension to allow client certificate URLs.
444    Section 3.4 describes the extension to allow a client to indicate
445    which CA root keys it possesses.  Section 3.5 describes the extension
446    to allow the use of truncated HMAC.  Section 3.6 describes the
447    extension to support integration of certificate status information
448    messages into TLS handshakes.
450 Blake-Wilson, et. al.       Standards Track                     [Page 8]
452 Internet-Draft               TLS Extensions                November 2004
454 3.1. Server Name Indication
456    [TLS] does not provide a mechanism for a client to tell a server the
457    name of the server it is contacting.  It may be desirable for clients
458    to provide this information to facilitate secure connections to
459    servers that host multiple 'virtual' servers at a single underlying
460    network address.
462    In order to provide the server name, clients MAY include an extension
463    of type "server_name" in the (extended) client hello.  The
464    "extension_data" field of this extension SHALL contain
465    "ServerNameList" where:
467       struct {
468           NameType name_type;
469           select (name_type) {
470               case host_name: HostName;
471           } name;
472       } ServerName;
474       enum {
475           host_name(0), (255)
476       } NameType;
478       opaque HostName<1..2^16-1>;
480       struct {
481           ServerName server_name_list<1..2^16-1>
482       } ServerNameList;
484    Currently the only server names supported are DNS hostnames, however
485    this does not imply any dependency of TLS on DNS, and other name
486    types may be added in the future (by an RFC that Updates this
487    document).  TLS MAY treat provided server names as opaque data and
488    pass the names and types to the application.
490    "HostName" contains the fully qualified DNS hostname of the server,
491    as understood by the client. The hostname is represented as a byte
492    string using UTF-8 encoding [UTF8], without a trailing dot.
494    If the hostname labels contain only US-ASCII characters, then the
495    client MUST ensure that labels are separated only by the byte 0x2E,
496    representing the dot character U+002E (requirement 1 in section 3.1
497    of [IDNA] notwithstanding). If the server needs to match the HostName
498    against names that contain non-US-ASCII characters, it MUST perform
499    the conversion operation described in section 4 of [IDNA], treating
500    the HostName as a "query string" (i.e. the AllowUnassigned flag MUST
501    be set). Note that IDNA allows labels to be separated by any of the
502    Unicode characters U+002E, U+3002, U+FF0E, and U+FF61, therefore
503    servers MUST accept any of these characters as a label separator.  If
505 Blake-Wilson, et. al.       Standards Track                     [Page 9]
507 Internet-Draft               TLS Extensions                November 2004
509    the server only needs to match the HostName against names containing
510    exclusively ASCII characters, it MUST compare ASCII names case-
511    insensitively.
513    Literal IPv4 and IPv6 addresses are not permitted in "HostName".
515    It is RECOMMENDED that clients include an extension of type
516    "server_name" in the client hello whenever they locate a server by a
517    supported name type.
519    A server that receives a client hello containing the "server_name"
520    extension, MAY use the information contained in the extension to
521    guide its selection of an appropriate certificate to return to the
522    client, and/or other aspects of security policy.  In this event, the
523    server SHALL include an extension of type "server_name" in the
524    (extended) server hello.  The "extension_data" field of this
525    extension SHALL be empty.
527    If the server understood the client hello extension but does not
528    recognize the server name, it SHOULD send an "unrecognized_name"
529    alert (which MAY be fatal).
531    If an application negotiates a server name using an application
532    protocol, then upgrades to TLS, and a server_name extension is sent,
533    then the extension SHOULD contain the same name that was negotiated
534    in the application protocol.  If the server_name is established in
535    the TLS session handshake, the client SHOULD NOT attempt to request a
536    different server name at the application layer.
538 3.2. Maximum Fragment Length Negotiation
540    [TLS] specifies a fixed maximum plaintext fragment length of 2^14
541    bytes.  It may be desirable for constrained clients to negotiate a
542    smaller maximum fragment length due to memory limitations or
543    bandwidth limitations.
545    In order to negotiate smaller maximum fragment lengths, clients MAY
546    include an extension of type "max_fragment_length" in the (extended)
547    client hello.  The "extension_data" field of this extension SHALL
548    contain:
550       enum{
551           2^9(1), 2^10(2), 2^11(3), 2^12(4), (255)
552       } MaxFragmentLength;
554    whose value is the desired maximum fragment length.  The allowed
555    values for this field are: 2^9, 2^10, 2^11, and 2^12.
558 Blake-Wilson, et. al.       Standards Track                    [Page 10]
560 Internet-Draft               TLS Extensions                November 2004
562    Servers that receive an extended client hello containing a
563    "max_fragment_length" extension, MAY accept the requested maximum
564    fragment length by including an extension of type
565    "max_fragment_length" in the (extended) server hello.  The
566    "extension_data" field of this extension SHALL contain
567    "MaxFragmentLength" whose value is the same as the requested maximum
568    fragment length.
570    If a server receives a maximum fragment length negotiation request
571    for a value other than the allowed values, it MUST abort the
572    handshake with an "illegal_parameter" alert.  Similarly, if a client
573    receives a maximum fragment length negotiation response that differs
574    from the length it requested, it MUST also abort the handshake with
575    an "illegal_parameter" alert.
577    Once a maximum fragment length other than 2^14 has been successfully
578    negotiated, the client and server MUST immediately begin fragmenting
579    messages (including handshake messages), to ensure that no fragment
580    larger than the negotiated length is sent.  Note that TLS already
581    requires clients and servers to support fragmentation of handshake
582    messages.
584    The negotiated length applies for the duration of the session
585    including session resumptions.
587    The negotiated length limits the input that the record layer may
588    process without fragmentation (that is, the maximum value of
589    TLSPlaintext.length; see [TLS] section 6.2.1).  Note that the output
590    of the record layer may be larger.  For example, if the negotiated
591    length is 2^9=512, then for currently defined cipher suites (those
592    defined in [TLS], [KERB], and [AESSUITES]), and when null compression
593    is used, the record layer output can be at most 793 bytes: 5 bytes of
594    headers, 512 bytes of application data, 256 bytes of padding, and 20
595    bytes of MAC.  That means that in this event a TLS record layer peer
596    receiving a TLS record layer message larger than 793 bytes may
597    discard the message and send a "record_overflow" alert, without
598    decrypting the message.
600 3.3. Client Certificate URLs
602    [TLS] specifies that when client authentication is performed, client
603    certificates are sent by clients to servers during the TLS handshake.
604    It may be desirable for constrained clients to send certificate URLs
605    in place of certificates, so that they do not need to store their
606    certificates and can therefore save memory.
613 Blake-Wilson, et. al.       Standards Track                    [Page 11]
615 Internet-Draft               TLS Extensions                November 2004
617    In order to negotiate to send certificate URLs to a server, clients
618    MAY include an extension of type "client_certificate_url" in the
619    (extended) client hello.  The "extension_data" field of this
620    extension SHALL be empty.
622    (Note that it is necessary to negotiate use of client certificate
623    URLs in order to avoid "breaking" existing TLS 1.0 servers.)
625    Servers that receive an extended client hello containing a
626    "client_certificate_url" extension, MAY indicate that they are
627    willing to accept certificate URLs by including an extension of type
628    "client_certificate_url" in the (extended) server hello.  The
629    "extension_data" field of this extension SHALL be empty.
631    After negotiation of the use of client certificate URLs has been
632    successfully completed (by exchanging hellos including
633    "client_certificate_url" extensions), clients MAY send a
634    "CertificateURL" message in place of a "Certificate" message:
636       enum {
637           individual_certs(0), pkipath(1), (255)
638       } CertChainType;
640       enum {
641           false(0), true(1)
642       } Boolean;
644       struct {
645           CertChainType type;
646           URLAndOptionalHash url_and_hash_list<1..2^16-1>;
647       } CertificateURL;
649       struct {
650           opaque url<1..2^16-1>;
651           Boolean hash_present;
652           select (hash_present) {
653               case false: struct {};
654               case true: SHA1Hash;
655           } hash;
656       } URLAndOptionalHash;
658       opaque SHA1Hash[20];
660    Here "url_and_hash_list" contains a sequence of URLs and optional
661    hashes.
668 Blake-Wilson, et. al.       Standards Track                    [Page 12]
670 Internet-Draft               TLS Extensions                November 2004
672    When X.509 certificates are used, there are two possibilities:
674    -  if CertificateURL.type is "individual_certs", each URL refers to a
675       single DER-encoded X.509v3 certificate, with the URL for the
676       client's certificate first, or
678    -  if CertificateURL.type is "pkipath", the list contains a single
679       URL referring to a DER-encoded certificate chain, using the type
680       PkiPath described in Section 8.
682    When any other certificate format is used, the specification that
683    describes use of that format in TLS should define the encoding format
684    of certificates or certificate chains, and any constraint on their
685    ordering.
687    The hash corresponding to each URL at the client's discretion is
688    either not present or is the SHA-1 hash of the certificate or
689    certificate chain (in the case of X.509 certificates, the DER-encoded
690    certificate or the DER-encoded PkiPath).
692    Note that when a list of URLs for X.509 certificates is used, the
693    ordering of URLs is the same as that used in the TLS Certificate
694    message (see [TLS] Section 7.4.2), but opposite to the order in which
695    certificates are encoded in PkiPath.  In either case, the self-signed
696    root certificate MAY be omitted from the chain, under the assumption
697    that the server must already possess it in order to validate it.
699    Servers receiving "CertificateURL" SHALL attempt to retrieve the
700    client's certificate chain from the URLs, and then process the
701    certificate chain as usual.  A cached copy of the content of any URL
702    in the chain MAY be used, provided that a SHA-1 hash is present for
703    that URL and it matches the hash of the cached copy.
705    Servers that support this extension MUST support the http: URL scheme
706    for certificate URLs, and MAY support other schemes.
708    If the protocol used to retrieve certificates or certificate chains
709    returns a MIME formatted response (as HTTP does), then the following
710    MIME Content-Types SHALL be used: when a single X.509v3 certificate
711    is returned, the Content-Type is "application/pkix-cert" [PKIOP], and
712    when a chain of X.509v3 certificates is returned, the Content-Type is
713    "application/pkix-pkipath" (see Section 8).
723 Blake-Wilson, et. al.       Standards Track                    [Page 13]
725 Internet-Draft               TLS Extensions                November 2004
727    If a SHA-1 hash is present for an URL, then the server MUST check
728    that the SHA-1 hash of the contents of the object retrieved from that
729    URL (after decoding any MIME Content-Transfer-Encoding) matches the
730    given hash.  If any retrieved object does not have the correct SHA-1
731    hash, the server MUST abort the handshake with a
732    "bad_certificate_hash_value" alert.
734    Note that clients may choose to send either "Certificate" or
735    "CertificateURL" after successfully negotiating the option to send
736    certificate URLs. The option to send a certificate is included to
737    provide flexibility to clients possessing multiple certificates.
739    If a server encounters an unreasonable delay in obtaining
740    certificates in a given CertificateURL, it SHOULD time out and signal
741    a "certificate_unobtainable" error alert.
743 3.4. Trusted CA Indication
745    Constrained clients that, due to memory limitations, possess only a
746    small number of CA root keys, may wish to indicate to servers which
747    root keys they possess, in order to avoid repeated handshake
748    failures.
750    In order to indicate which CA root keys they possess, clients MAY
751    include an extension of type "trusted_ca_keys" in the (extended)
752    client hello.  The "extension_data" field of this extension SHALL
753    contain "TrustedAuthorities" where:
755       struct {
756           TrustedAuthority trusted_authorities_list<0..2^16-1>;
757       } TrustedAuthorities;
759       struct {
760           IdentifierType identifier_type;
761           select (identifier_type) {
762               case pre_agreed: struct {};
763               case key_sha1_hash: SHA1Hash;
764               case x509_name: DistinguishedName;
765               case cert_sha1_hash: SHA1Hash;
766           } identifier;
767       } TrustedAuthority;
769       enum {
770           pre_agreed(0), key_sha1_hash(1), x509_name(2),
771           cert_sha1_hash(3), (255)
772       } IdentifierType;
774       opaque DistinguishedName<1..2^16-1>;
778 Blake-Wilson, et. al.       Standards Track                    [Page 14]
780 Internet-Draft               TLS Extensions                November 2004
782    Here "TrustedAuthorities" provides a list of CA root key identifiers
783    that the client possesses.  Each CA root key is identified via
784    either:
786    -  "pre_agreed" - no CA root key identity supplied.
788    -  "key_sha1_hash" - contains the SHA-1 hash of the CA root key.  For
789       DSA and ECDSA keys, this is the hash of the "subjectPublicKey"
790       value.  For RSA keys, the hash is of the big-endian byte string
791       representation of the modulus without any initial 0-valued bytes.
792       (This copies the key hash formats deployed in other environments.)
794    -  "x509_name" - contains the DER-encoded X.509 DistinguishedName of
795       the CA.
797    -  "cert_sha1_hash" - contains the SHA-1 hash of a DER-encoded
798       Certificate containing the CA root key.
800    Note that clients may include none, some, or all of the CA root keys
801    they possess in this extension.
803    Note also that it is possible that a key hash or a Distinguished Name
804    alone may not uniquely identify a certificate issuer - for example if
805    a particular CA has multiple key pairs - however here we assume this
806    is the case following the use of Distinguished Names to identify
807    certificate issuers in TLS.
809    The option to include no CA root keys is included to allow the client
810    to indicate possession of some pre-defined set of CA root keys.
812    Servers that receive a client hello containing the "trusted_ca_keys"
813    extension, MAY use the information contained in the extension to
814    guide their selection of an appropriate certificate chain to return
815    to the client.  In this event, the server SHALL include an extension
816    of type "trusted_ca_keys" in the (extended) server hello.  The
817    "extension_data" field of this extension SHALL be empty.
819 3.5. Truncated HMAC
821    Currently defined TLS cipher suites use the MAC construction HMAC
822    with either MD5 or SHA-1 [HMAC] to authenticate record layer
823    communications.  In TLS the entire output of the hash function is
824    used as the MAC tag.  However it may be desirable in constrained
825    environments to save bandwidth by truncating the output of the hash
826    function to 80 bits when forming MAC tags.
833 Blake-Wilson, et. al.       Standards Track                    [Page 15]
835 Internet-Draft               TLS Extensions                November 2004
837    In order to negotiate the use of 80-bit truncated HMAC, clients MAY
838    include an extension of type "truncated_hmac" in the extended client
839    hello.  The "extension_data" field of this extension SHALL be empty.
841    Servers that receive an extended hello containing a "truncated_hmac"
842    extension, MAY agree to use a truncated HMAC by including an
843    extension of type "truncated_hmac", with empty "extension_data", in
844    the extended server hello.
846    Note that if new cipher suites are added that do not use HMAC, and
847    the session negotiates one of these cipher suites, this extension
848    will have no effect.  It is strongly recommended that any new cipher
849    suites using other MACs consider the MAC size as an integral part of
850    the cipher suite definition, taking into account both security and
851    bandwidth considerations.
853    If HMAC truncation has been successfully negotiated during a TLS
854    handshake, and the negotiated cipher suite uses HMAC, both the client
855    and the server pass this fact to the TLS record layer along with the
856    other negotiated security parameters.  Subsequently during the
857    session, clients and servers MUST use truncated HMACs, calculated as
858    specified in [HMAC].  That is, CipherSpec.hash_size is 10 bytes, and
859    only the first 10 bytes of the HMAC output are transmitted and
860    checked.  Note that this extension does not affect the calculation of
861    the PRF as part of handshaking or key derivation.
863    The negotiated HMAC truncation size applies for the duration of the
864    session including session resumptions.
866 3.6. Certificate Status Request
868    Constrained clients may wish to use a certificate-status protocol
869    such as OCSP [OCSP] to check the validity of server certificates, in
870    order to avoid transmission of CRLs and therefore save bandwidth on
871    constrained networks.  This extension allows for such information to
872    be sent in the TLS handshake, saving roundtrips and resources.
874    In order to indicate their desire to receive certificate status
875    information, clients MAY include an extension of type
876    "status_request" in the (extended) client hello.  The
877    "extension_data" field of this extension SHALL contain
878    "CertificateStatusRequest" where:
888 Blake-Wilson, et. al.       Standards Track                    [Page 16]
890 Internet-Draft               TLS Extensions                November 2004
892       struct {
893           CertificateStatusType status_type;
894           select (status_type) {
895               case ocsp: OCSPStatusRequest;
896           } request;
897       } CertificateStatusRequest;
899       enum { ocsp(1), (255) } CertificateStatusType;
901       struct {
902           ResponderID responder_id_list<0..2^16-1>;
903           Extensions  request_extensions;
904       } OCSPStatusRequest;
906       opaque ResponderID<1..2^16-1>;
907       opaque Extensions<0..2^16-1>;
909    In the OCSPStatusRequest, the "ResponderIDs" provides a list of OCSP
910    responders that the client trusts.  A zero-length "responder_id_list"
911    sequence has the special meaning that the responders are implicitly
912    known to the server - e.g., by prior arrangement.  "Extensions" is a
913    DER encoding of OCSP request extensions.
915    Both "ResponderID" and "Extensions" are DER-encoded ASN.1 types as
916    defined in [OCSP].  "Extensions" is imported from [PKIX].  A zero-
917    length "request_extensions" value means that there are no extensions
918    (as opposed to a zero-length ASN.1 SEQUENCE, which is not valid for
919    the "Extensions" type).
921    In the case of the "id-pkix-ocsp-nonce" OCSP extension, [OCSP] is
922    unclear about its encoding; for clarification, the nonce MUST be a
923    DER-encoded OCTET STRING, which is encapsulated as another OCTET
924    STRING (note that implementations based on an existing OCSP client
925    will need to be checked for conformance to this requirement).
927    Servers that receive a client hello containing the "status_request"
928    extension, MAY return a suitable certificate status response to the
929    client along with their certificate.  If OCSP is requested, they
930    SHOULD use the information contained in the extension when selecting
931    an OCSP responder, and SHOULD include request_extensions in the OCSP
932    request.
934    Servers return a certificate response along with their certificate by
935    sending a "CertificateStatus" message immediately after the
936    "Certificate" message (and before any "ServerKeyExchange" or
937    "CertificateRequest" messages).  If a server returns a
943 Blake-Wilson, et. al.       Standards Track                    [Page 17]
945 Internet-Draft               TLS Extensions                November 2004
947    "CertificateStatus" message, then the server MUST have included an
948    extension of type "status_request" with empty "extension_data" in the
949    extended server hello.
951       struct {
952           CertificateStatusType status_type;
953           select (status_type) {
954               case ocsp: OCSPResponse;
955           } response;
956       } CertificateStatus;
958       opaque OCSPResponse<1..2^24-1>;
960    An "ocsp_response" contains a complete, DER-encoded OCSP response
961    (using the ASN.1 type OCSPResponse defined in [OCSP]).  Note that
962    only one OCSP response may be sent.
964    The "CertificateStatus" message is conveyed using the handshake
965    message type "certificate_status".
967    Note that a server MAY also choose not to send a "CertificateStatus"
968    message, even if it receives a "status_request" extension in the
969    client hello message.
971    Note in addition that servers MUST NOT send the "CertificateStatus"
972    message unless it received a "status_request" extension in the client
973    hello message.
975    Clients requesting an OCSP response, and receiving an OCSP response
976    in a "CertificateStatus" message MUST check the OCSP response and
977    abort the handshake if the response is not satisfactory.
979 4. Error Alerts
981    This section defines new error alerts for use with the TLS extensions
982    defined in this document.
984    The following new error alerts are defined.  To avoid "breaking"
985    existing clients and servers, these alerts MUST NOT be sent unless
986    the sending party has received an extended hello message from the
987    party they are communicating with.
989    -  "unsupported_extension" - this alert is sent by clients that
990       receive an extended server hello containing an extension that they
991       did not put in the corresponding client hello (see Section 2.3).
992       This message is always fatal.
998 Blake-Wilson, et. al.       Standards Track                    [Page 18]
1000 Internet-Draft               TLS Extensions                November 2004
1002    -  "unrecognized_name" - this alert is sent by servers that receive a
1003       server_name extension request, but do not recognize the server
1004       name.  This message MAY be fatal.
1006    -  "certificate_unobtainable" - this alert is sent by servers who are
1007       unable to retrieve a certificate chain from the URL supplied by
1008       the client (see Section 3.3).  This message MAY be fatal - for
1009       example if client authentication is required by the server for the
1010       handshake to continue and the server is unable to retrieve the
1011       certificate chain, it may send a fatal alert.
1013    -  "bad_certificate_status_response" - this alert is sent by clients
1014       that receive an invalid certificate status response (see Section
1015       3.6).  This message is always fatal.
1017    -  "bad_certificate_hash_value" - this alert is sent by servers when
1018       a certificate hash does not match a client provided
1019       certificate_hash.  This message is always fatal.
1021    These error alerts are conveyed using the following syntax:
1023       enum {
1024           close_notify(0),
1025           unexpected_message(10),
1026           bad_record_mac(20),
1027           decryption_failed(21),
1028           record_overflow(22),
1029           decompression_failure(30),
1030           handshake_failure(40),
1031           /* 41 is not defined, for historical reasons */
1032           bad_certificate(42),
1033           unsupported_certificate(43),
1034           certificate_revoked(44),
1035           certificate_expired(45),
1036           certificate_unknown(46),
1037           illegal_parameter(47),
1038           unknown_ca(48),
1039           access_denied(49),
1040           decode_error(50),
1041           decrypt_error(51),
1042           export_restriction(60),
1043           protocol_version(70),
1044           insufficient_security(71),
1045           internal_error(80),
1046           user_canceled(90),
1047           no_renegotiation(100),
1048           unsupported_extension(110),           /* new */
1049           certificate_unobtainable(111),        /* new */
1053 Blake-Wilson, et. al.       Standards Track                    [Page 19]
1055 Internet-Draft               TLS Extensions                November 2004
1057           unrecognized_name(112),               /* new */
1058           bad_certificate_status_response(113), /* new */
1059           bad_certificate_hash_value(114),      /* new */
1060           (255)
1061       } AlertDescription;
1063 5. Procedure for Defining New Extensions
1065    The list of extension types, as defined in Section 2.3, is 
1066    maintained by the Internet Assigned Numbers Authority (IANA). Thus 
1067    an application needs to be made to the IANA in order to obtain a new  
1068    extension type value. Since there are subtle (and not so subtle) 
1069    interactions that may occur in this protocol between new features and 
1070    existing features which may result in a significant reduction in 
1071    overall security, new values SHALL be defined only through the IETF 
1072    Consensus process specified in [IANA].
1074    (This means that new assignments can be made only via RFCs approved 
1075    by the IESG.)
1077    The following considerations should be taken into account when
1078    designing new extensions:
1080    -  All of the extensions defined in this document follow the
1081       convention that for each extension that a client requests and that
1082       the server understands, the server replies with an extension of
1083       the same type.
1085    -  Some cases where a server does not agree to an extension are error
1086       conditions, and some simply a refusal to support a particular
1087       feature.  In general error alerts should be used for the former,
1088       and a field in the server extension response for the latter.
1090    -  Extensions should as far as possible be designed to prevent any
1091       attack that forces use (or non-use) of a particular feature by
1092       manipulation of handshake messages.  This principle should be
1093       followed regardless of whether the feature is believed to cause a
1094       security problem.
1096       Often the fact that the extension fields are included in the
1097       inputs to the Finished message hashes will be sufficient, but
1098       extreme care is needed when the extension changes the meaning of
1099       messages sent in the handshake phase. Designers and implementors
1100       should be aware of the fact that until the handshake has been
1101       authenticated, active attackers can modify messages and insert,
1102       remove, or replace extensions.
1106 Blake-Wilson, et. al.       Standards Track                    [Page 20]
1108 Internet-Draft               TLS Extensions                November 2004
1110    -  It would be technically possible to use extensions to change major
1111       aspects of the design of TLS; for example the design of cipher
1112       suite negotiation.  This is not recommended; it would be more
1113       appropriate to define a new version of TLS - particularly since
1114       the TLS handshake algorithms have specific protection against
1115       version rollback attacks based on the version number, and the
1116       possibility of version rollback should be a significant
1117       consideration in any major design change.
1119 6. Security Considerations
1121    Security considerations for the extension mechanism in general, and
1122    the design of new extensions, are described in the previous section.
1123    A security analysis of each of the extensions defined in this
1124    document is given below.
1126    In general, implementers should continue to monitor the state of the
1127    art, and address any weaknesses identified.
1129    Additional security considerations are described in the TLS 1.0 RFC
1130    [TLS].
1132 6.1. Security of server_name
1134    If a single server hosts several domains, then clearly it is
1135    necessary for the owners of each domain to ensure that this satisfies
1136    their security needs.  Apart from this, server_name does not appear
1137    to introduce significant security issues.
1139    Implementations MUST ensure that a buffer overflow does not occur
1140    whatever the values of the length fields in server_name.
1142    Although this document specifies an encoding for internationalized
1143    hostnames in the server_name extension, it does not address any
1144    security issues associated with the use of internationalized
1145    hostnames in TLS - in particular, the consequences of "spoofed" names
1146    that are indistinguishable from another name when displayed or
1147    printed.  It is recommended that server certificates not be issued
1148    for internationalized hostnames unless procedures are in place to
1149    mitigate the risk of spoofed hostnames.
1151 6.2. Security of max_fragment_length
1153    The maximum fragment length takes effect immediately, including for
1154    handshake messages.  However, that does not introduce any security
1155    complications that are not already present in TLS, since [TLS]
1156    requires implementations to be able to handle fragmented handshake
1157    messages.
1161 Blake-Wilson, et. al.       Standards Track                    [Page 21]
1163 Internet-Draft               TLS Extensions                November 2004
1165    Note that as described in section 3.2, once a non-null cipher suite
1166    has been activated, the effective maximum fragment length depends on
1167    the cipher suite and compression method, as well as on the negotiated
1168    max_fragment_length.  This must be taken into account when sizing
1169    buffers, and checking for buffer overflow.
1171 6.3. Security of client_certificate_url
1173    There are two major issues with this extension.
1175    The first major issue is whether or not clients should include
1176    certificate hashes when they send certificate URLs.
1178    When client authentication is used *without* the
1179    client_certificate_url extension, the client certificate chain is
1180    covered by the Finished message hashes.  The purpose of including
1181    hashes and checking them against the retrieved certificate chain, is
1182    to ensure that the same property holds when this extension is used -
1183    i.e., that all of the information in the certificate chain retrieved
1184    by the server is as the client intended.
1186    On the other hand, omitting certificate hashes enables functionality
1187    that is desirable in some circumstances - for example clients can be
1188    issued daily certificates that are stored at a fixed URL and need not
1189    be provided to the client.  Clients that choose to omit certificate
1190    hashes should be aware of the possibility of an attack in which the
1191    attacker obtains a valid certificate on the client's key that is
1192    different from the certificate the client intended to provide.
1193    Although TLS uses both MD5 and SHA-1 hashes in several other places,
1194    this was not believed to be necessary here.  The property required of
1195    SHA-1 is second pre-image resistance.
1197    The second major issue is that support for client_certificate_url
1198    involves the server acting as a client in another URL protocol.  The
1199    server therefore becomes subject to many of the same security
1200    concerns that clients of the URL scheme are subject to, with the
1201    added concern that the client can attempt to prompt the server to
1202    connect to some, possibly weird-looking URL.
1204    In general this issue means that an attacker might use the server to
1205    indirectly attack another host that is vulnerable to some security
1206    flaw.  It also introduces the possibility of denial of service
1207    attacks in which an attacker makes many connections to the server,
1208    each of which results in the server attempting a connection to the
1209    target of the attack.
1216 Blake-Wilson, et. al.       Standards Track                    [Page 22]
1218 Internet-Draft               TLS Extensions                November 2004
1220    Note that the server may be behind a firewall or otherwise able to
1221    access hosts that would not be directly accessible from the public
1222    Internet; this could exacerbate the potential security and denial of
1223    service problems described above, as well as allowing the existence
1224    of internal hosts to be confirmed when they would otherwise be
1225    hidden.
1227    The detailed security concerns involved will depend on the URL
1228    schemes supported by the server.  In the case of HTTP, the concerns
1229    are similar to those that apply to a publicly accessible HTTP proxy
1230    server.  In the case of HTTPS, the possibility for loops and
1231    deadlocks to be created exists and should be addressed.  In the case
1232    of FTP, attacks similar to FTP bounce attacks arise.
1234    As a result of this issue, it is RECOMMENDED that the
1235    client_certificate_url extension should have to be specifically
1236    enabled by a server administrator, rather than being enabled by
1237    default.  It is also RECOMMENDED that URI protocols be enabled by the
1238    administrator individually, and only a minimal set of protocols be
1239    enabled, with unusual protocols offering limited security or whose
1240    security is not well-understood being avoided.
1242    As discussed in [URI], URLs that specify ports other than the default
1243    may cause problems, as may very long URLs (which are more likely to
1244    be useful in exploiting buffer overflow bugs).
1246    Also note that HTTP caching proxies are common on the Internet, and
1247    some proxies do not check for the latest version of an object
1248    correctly.  If a request using HTTP (or another caching protocol)
1249    goes through a misconfigured or otherwise broken proxy, the proxy may
1250    return an out-of-date response.
1252 6.4. Security of trusted_ca_keys
1254    It is possible that which CA root keys a client possesses could be
1255    regarded as confidential information.  As a result, the CA root key
1256    indication extension should be used with care.
1258    The use of the SHA-1 certificate hash alternative ensures that each
1259    certificate is specified unambiguously.  As for the previous
1260    extension, it was not believed necessary to use both MD5 and SHA-1
1261    hashes.
1263 6.5. Security of truncated_hmac
1265    It is possible that truncated MACs are weaker than "un-truncated"
1266    MACs.  However, no significant weaknesses are currently known or
1267    expected to exist for HMAC with MD5 or SHA-1, truncated to 80 bits.
1271 Blake-Wilson, et. al.       Standards Track                    [Page 23]
1273 Internet-Draft               TLS Extensions                November 2004
1275    Note that the output length of a MAC need not be as long as the
1276    length of a symmetric cipher key, since forging of MAC values cannot
1277    be done off-line: in TLS, a single failed MAC guess will cause the
1278    immediate termination of the TLS session.
1280    Since the MAC algorithm only takes effect after the handshake
1281    messages have been authenticated by the hashes in the Finished
1282    messages, it is not possible for an active attacker to force
1283    negotiation of the truncated HMAC extension where it would not
1284    otherwise be used (to the extent that the handshake authentication is
1285    secure).  Therefore, in the event that any security problem were
1286    found with truncated HMAC in future, if either the client or the
1287    server for a given session were updated to take into account the
1288    problem, they would be able to veto use of this extension.
1290 6.6. Security of status_request
1292    If a client requests an OCSP response, it must take into account that
1293    an attacker's server using a compromised key could (and probably
1294    would) pretend not to support the extension.  A client that requires
1295    OCSP validation of certificates SHOULD either contact the OCSP server
1296    directly in this case, or abort the handshake.
1298    Use of the OCSP nonce request extension (id-pkix-ocsp-nonce) may
1299    improve security against attacks that attempt to replay OCSP
1300    responses; see section 4.4.1 of [OCSP] for further details.
1302 7. Internationalization Considerations
1304    None of the extensions defined here directly use strings subject to
1305    localization.  Domain Name System (DNS) hostnames are encoded using
1306    UTF-8.  If future extensions use text strings, then
1307    internationalization should be considered in their design.
1309 8. IANA Considerations
1311    Sections 2.3 and 5 describes a registry of ExtensionType values to be
1312    maintained by the IANA. ExtensionType values are to be assigned via 
1313    IETF Consensus as defined in RFC 2434 [IANA].
1315    The MIME type "application/pkix-pkipath" has been registered by the
1316    IANA with the following template:
1318    To: ietf-types@iana.org Subject: Registration of MIME media type
1319    application/pkix-pkipath
1321    MIME media type name: application
1323    MIME subtype name: pkix-pkipath
1325    Required parameters: none
1327 Blake-Wilson, et. al.       Standards Track                    [Page 24]
1329 Internet-Draft               TLS Extensions                November 2004
1331    Optional parameters: version (default value is "1")
1333    Encoding considerations:
1334       This MIME type is a DER encoding of the ASN.1 type PkiPath,
1335       defined as follows:
1336         PkiPath ::= SEQUENCE OF Certificate
1337         PkiPath is used to represent a certification path.  Within the
1338         sequence, the order of certificates is such that the subject of
1339         the first certificate is the issuer of the second certificate,
1340         etc.
1342       This is identical to the definition published in [X509-4th-TC1]; 
1343       note that it is different from that in [X509-4th].
1345       All Certificates MUST conform to [PKIX].  (This should be
1346       interpreted as a requirement to encode only PKIX-conformant
1347       certificates using this type.  It does not necessarily require
1348       that all certificates that are not strictly PKIX-conformant must
1349       be rejected by relying parties, although the security consequences
1350       of accepting any such certificates should be considered
1351       carefully.)
1353       DER (as opposed to BER) encoding MUST be used.  If this type is
1354       sent over a 7-bit transport, base64 encoding SHOULD be used.
1356    Security considerations:
1357       The security considerations of [X509-4th] and [PKIX] (or any
1358       updates to them) apply, as well as those of any protocol that uses
1359       this type (e.g., TLS).
1361       Note that this type only specifies a certificate chain that can be
1362       assessed for validity according to the relying party's existing
1363       configuration of trusted CAs; it is not intended to be used to
1364       specify any change to that configuration.
1366    Interoperability considerations:
1367       No specific interoperability problems are known with this type,
1368       but for recommendations relating to X.509 certificates in general,
1369       see [PKIX].
1371    Published specification: this memo, and [PKIX].
1373    Applications which use this media type: TLS.  It may also be used by
1374       other protocols, or for general interchange of PKIX certificate
1375       chains.
1382 Blake-Wilson, et. al.       Standards Track                    [Page 25]
1384 Internet-Draft               TLS Extensions                November 2004
1386    Additional information:
1387       Magic number(s): DER-encoded ASN.1 can be easily recognized.
1388         Further parsing is required to distinguish from other ASN.1
1389         types.
1390       File extension(s): .pkipath
1391       Macintosh File Type Code(s): not specified
1393    Person & email address to contact for further information:
1394       Magnus Nystrom <magnus@rsasecurity.com>
1396    Intended usage: COMMON
1398    Author/Change controller:
1399       Magnus Nystrom <magnus@rsasecurity.com>
1401 9. Intellectual Property Rights
1403    The IETF takes no position regarding the validity or scope of any
1404    intellectual property or other rights that might be claimed to
1405    pertain to the implementation or use of the technology described in
1406    this document or the extent to which any license under such rights
1407    might or might not be available; neither does it represent that it
1408    has made any effort to identify any such rights.  Information on the
1409    IETF's procedures with respect to rights in standards-track and
1410    standards-related documentation can be found in RFC 2028.  Copies of
1411    claims of rights made available for publication and any assurances of
1412    licenses to be made available, or the result of an attempt made to
1413    obtain a general license or permission for the use of such
1414    proprietary rights by implementors or users of this specification can
1415    be obtained from the IETF Secretariat.
1417    The IETF invites any interested party to bring to its attention any
1418    copyrights, patents or patent applications, or other proprietary
1419    rights which may cover technology that may be required to practice
1420    this document.  Please address the information to the IETF Executive
1421    Director.
1423 10. Acknowledgments
1425    The authors wish to thank the TLS Working Group and the WAP Security
1426    Group.  This document is based on discussion within these groups.
1437 Blake-Wilson, et. al.       Standards Track                    [Page 26]
1439 Internet-Draft               TLS Extensions                November 2004
1441 11. Normative References
1443    [HMAC]         Krawczyk, H., Bellare, M. and R. Canetti, "HMAC:
1444                   Keyed-hashing for message authentication", RFC 2104,
1445                   February 1997.
1447    [HTTP]         Fielding, R., Gettys, J., Mogul, J., Frystyk, H.,
1448                   Masinter, L., Leach, P. and T. Berners-Lee, "Hypertext
1449                   Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.
1451    [IANA]         Narten, T. and H. Alvestrand, "Guidelines for Writing
1452                   an IANA Considerations Section in RFCs", RFC 2434,
1453                   October 1998.
1455    [IDNA]         Faltstrom, P., Hoffman, P. and A. Costello,
1456                   "Internationalizing Domain Names in Applications
1457                   (IDNA)", RFC 3490, March 2003.
1459    [KEYWORDS]     Bradner, S., "Key words for use in RFCs to Indicate
1460                   Requirement Levels", BCP 14, RFC 2119, March 1997.
1462    [OCSP]         Myers, M., Ankney, R., Malpani, A., Galperin, S. and
1463                   C. Adams, "Internet X.509 Public Key Infrastructure:
1464                   Online Certificate Status Protocol - OCSP", RFC 2560,
1465                   June 1999.
1467    [PKIOP]        Housley, R. and P. Hoffman, "Internet X.509 Public Key
1468                   Infrastructure - Operation Protocols: FTP and HTTP",
1469                   RFC 2585, May 1999.
1471    [PKIX]         Housley, R., Polk, W., Ford, W. and D. Solo, "Internet
1472                   Public Key Infrastructure - Certificate and
1473                   Certificate Revocation List (CRL) Profile", RFC 3280,
1474                   April 2002.
1476    [TLS]          Dierks, T. and C. Allen, "The TLS Protocol Version
1477                   1.0", RFC 2246, January 1999.
1479    [URI]          Berners-Lee, T., Fielding, R. and L. Masinter,
1480                   "Uniform Resource Identifiers (URI): Generic Syntax",
1481                   RFC 2396, August 1998.
1483    [UTF8]         Yergeau, F., "UTF-8, a transformation format of ISO
1484                   10646", RFC 3629, November 2003.
1486    [X509-4th]     ITU-T Recommendation X.509 (2000) | ISO/IEC 9594-
1487                   8:2001, "Information Systems - Open Systems
1488                   Interconnection - The Directory:  Public key and
1489                   attribute certificate frameworks."
1492 Blake-Wilson, et. al.       Standards Track                    [Page 27]
1494 Internet-Draft               TLS Extensions                November 2004
1496    [X509-4th-TC1] ITU-T Recommendation X.509(2000) Corrigendum 1(2001) |
1497                   ISO/IEC 9594-8:2001/Cor.1:2002, Technical Corrigendum
1498                   1 to ISO/IEC 9594:8:2001.
1500 12. Informative References
1502    [KERB]         Medvinsky, A. and M. Hur, "Addition of Kerberos Cipher
1503                   Suites to Transport Layer Security (TLS)", RFC 2712,
1504                   October 1999.
1506    [MAILING LIST] J. Mikkelsen, R. Eberhard, and J. Kistler, "General
1507                   ClientHello extension mechanism and virtual hosting,"
1508                   ietf-tls mailing list posting, August 14, 2000.
1510    [AESSUITES]    Chown, P., "Advanced Encryption Standard (AES)
1511                   Ciphersuites for Transport Layer Security (TLS)", RFC
1512                   3268, June 2002.
1514 13. Authors' Addresses
1516    Simon Blake-Wilson
1517    BCI
1518    EMail: sblakewilson@bcisse.com
1520    Magnus Nystrom
1521    RSA Security
1522    EMail: magnus@rsasecurity.com
1524    David Hopwood
1525    Independent Consultant
1526    EMail: david.hopwood@blueyonder.co.uk
1528    Jan Mikkelsen
1529    Transactionware
1530    EMail: janm@transactionware.com
1532    Tim Wright
1533    Vodafone
1534    EMail: timothy.wright@vodafone.com
1547 Blake-Wilson, et. al.       Standards Track                    [Page 28]
1549 Internet-Draft               TLS Extensions                November 2004
1551 14.  Full Copyright Statement
1553    Copyright (C) The Internet Society (year). This document is subject 
1554    to the rights, licenses and restrictions contained in BCP 78, and 
1555    except as set forth therein, the authors retain all their rights."
1557    This document and translations of it may be copied and furnished to
1558    others, and derivative works that comment on or otherwise explain it
1559    or assist in its implementation may be prepared, copied, published
1560    and distributed, in whole or in part, without restriction of any
1561    kind, provided that the above copyright notice and this paragraph are
1562    included on all such copies and derivative works.  However, this
1563    document itself may not be modified in any way, such as by removing
1564    the copyright notice or references to the Internet Society or other
1565    Internet organizations, except as needed for the purpose of
1566    developing Internet standards in which case the procedures for
1567    copyrights defined in the Internet Standards process must be
1568    followed, or as required to translate it into languages other than
1569    English.
1571    The limited permissions granted above are perpetual and will not be
1572    revoked by the Internet Society or its successors or assigns.
1574    This document and the information contained herein are provided on an 
1575    "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS 
1576    OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET 
1577    ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, 
1578    INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE 
1579    INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED 
1580    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE."
1582 Acknowledgement
1584    Funding for the RFC Editor function is currently provided by the
1585    Internet Society.
1599 Blake-Wilson, et. al.       Standards Track                    [Page 29]