Transport Layer Security Working                               D. Taylor
Group                                             Forge Research Pty Ltd
Internet-Draft                                           August 21, 2002
Expires: February 19, 2003


                    Using SRP for TLS Authentication
                         draft-ietf-tls-srp-02

Status of this Memo

   This document is an Internet-Draft and is in full conformance with
   all provisions of Section 10 of RFC2026.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   The list of current Internet-Drafts can be accessed at http://
   www.ietf.org/ietf/1id-abstracts.txt.

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html.

   This Internet-Draft will expire on February 19, 2003.

Copyright Notice

   Copyright (C) The Internet Society (2002).  All Rights Reserved.

Abstract

   This memo presents a technique for using the SRP [2] (Secure Remote
   Password) protocol as an authentication method for the TLS
   [1](Transport Layer Security) protocol.











Taylor                 Expires February 19, 2003                [Page 1]


Internet-Draft      Using SRP for TLS Authentication         August 2002


Table of Contents

   1.    Introduction . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.    SRP Authentication in TLS  . . . . . . . . . . . . . . . . .  4
   2.1   Modifications to the TLS Handshake Sequence  . . . . . . . .  4
   2.1.1 Message Sequence . . . . . . . . . . . . . . . . . . . . . .  4
   2.1.2 Session Re-use . . . . . . . . . . . . . . . . . . . . . . .  4
   2.2   SRP Verifier Message Digest Selection  . . . . . . . . . . .  5
   2.3   Changes to the Handshake Message Contents  . . . . . . . . .  5
   2.3.1 Client hello . . . . . . . . . . . . . . . . . . . . . . . .  5
   2.3.2 Server hello . . . . . . . . . . . . . . . . . . . . . . . .  5
   2.3.3 Server certificate . . . . . . . . . . . . . . . . . . . . .  5
   2.3.4 Client key exchange  . . . . . . . . . . . . . . . . . . . .  6
   2.3.5 Server key exchange  . . . . . . . . . . . . . . . . . . . .  6
   2.4   Calculating the Pre-master Secret  . . . . . . . . . . . . .  6
   2.5   Cipher Suite Definitions . . . . . . . . . . . . . . . . . .  6
   2.6   New Message Structures . . . . . . . . . . . . . . . . . . .  7
   2.6.1 ExtensionType  . . . . . . . . . . . . . . . . . . . . . . .  7
   2.6.2 Client Hello . . . . . . . . . . . . . . . . . . . . . . . .  7
   2.6.3 Server Hello . . . . . . . . . . . . . . . . . . . . . . . .  8
   2.6.4 Client Key Exchange  . . . . . . . . . . . . . . . . . . . .  8
   2.6.5 Server Key Exchange  . . . . . . . . . . . . . . . . . . . .  8
   3.    Security Considerations  . . . . . . . . . . . . . . . . . . 10
         References . . . . . . . . . . . . . . . . . . . . . . . . . 11
         Author's Address . . . . . . . . . . . . . . . . . . . . . . 11
   A.    Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 12
         Full Copyright Statement . . . . . . . . . . . . . . . . . . 13
























Taylor                 Expires February 19, 2003                [Page 2]


Internet-Draft      Using SRP for TLS Authentication         August 2002


1. Introduction

   At the time of writing, TLS uses public key certificiates with RSA/
   DSA digital signatures, or Kerberos, for authentication.

   These authentication methods do not seem well suited to the
   applications now being adapted to use TLS (IMAP [3], FTP [5], or
   TELNET [6], for example).  Given these protocols (and others like
   them) are designed to use the user name and password method of
   authentication, being able to safely use user names and passwords to
   authenticate the TLS connection provides a much easier route to
   additional security than implementing a public key infrastructure in
   certain situations.

   SRP is an authentication method that allows the use of user names and
   passwords over unencrypted channels without revealing the password to
   an eavesdropper.  SRP also supplies a shared secret at the end of the
   authetication sequence that can be used to generate encryption keys.

   This document describes the use of the SRP authentication method for
   TLS.

   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 RFC 2119.


























Taylor                 Expires February 19, 2003                [Page 3]


Internet-Draft      Using SRP for TLS Authentication         August 2002


2. SRP Authentication in TLS

2.1 Modifications to the TLS Handshake Sequence

   The SRP protocol can not be implemented using the sequence of
   handshake messages defined in [1] due to the sequence in which the
   SRP messages must be sent.

   This document presents a new sequence of handshake messages for
   handshakes using the SRP authentication method.

2.1.1 Message Sequence

   Handshake Message Flow for SRP Authentication

          Client                                 Server
            |                                      |
       Client Hello (U) ------------------------>  |
            |  <---------------------------- Server Hello (g, N, s)
            |  <---------------------------- Certificate*
       Client Key Exchange (A) ----------------->  |
            |  <---------------------------- Server Key Exchange (B)
            |  <---------------------------- Server Hello Done
       change cipher spec                          |
       Finished -------------------------------->  |
            |                                change cipher spec
            |  <---------------------------- Finished
            |                                      |

   * Indicates optional or situation-dependent messages that are not
   always sent.

   The identifiers given after each message name refer to the SRP
   variables included in that message.  The variables U, g, N, s, A, and
   B are defined in [2].

   Extended client and server hello messages, as defined in [7], are
   used to to send the initial client and server values.

   The client key exchange message is sent during the sequence of server
   messages.  This modification is required because the client must send
   its public key (A) before it receives the servers public key (B), as
   stated in Section 3 of [2].

2.1.2 Session Re-use

   The short handshake mechanism for re-using sessions for new
   connections, and renegotiating keys for existing connections will



Taylor                 Expires February 19, 2003                [Page 4]


Internet-Draft      Using SRP for TLS Authentication         August 2002


   still work with the SRP authentication mechanism and handshake.

   When a client attemps to re-use a session that uses SRP
   authentication, it MUST still include the SRP extension carrying the
   user name (U) in the client hello message, in case the server cannot
   or will not allow re-use of the session, meaning a full handshake
   sequence is required.

   If a client requests an existing session and the server agrees to use
   it (meaning the short handshake will be used), the server MAY omit
   the SRP extension from the server hello message, as the information
   it contains is not used in the short handshake.

2.2 SRP Verifier Message Digest Selection

   The cipher suites defined in this document use the SHA-1 message
   digest with the SRP algorithm, as specified in [2].  Implementations
   conforming to this document MUST use the SHA-1 message digest.

   Future documents may define other cipher suites that use different
   message digests, or other similar functions, with the SRP algorithm.

2.3 Changes to the Handshake Message Contents

   This section describes the changes to the TLS handshake message
   contents when SRP is being used for authentication.  The definitions
   of the new message contents and the on-the-wire changes are given in
   Section 2.6.

2.3.1 Client hello

   The user name is appended to the standard client hello message using
   the hello message extension mechanism defined in [7].

2.3.2 Server hello

   The the generator (g), the prime (N), and the salt value (s) read
   from the SRP password file are appended to the server hello message
   using the hello message extension mechanism defined in [7].

2.3.3 Server certificate

   The server MUST send a certificate if it agrees to an SRP cipher
   suite that requires the server to provide additional authentication
   in the form of a digital signature.  See Section 2.5 for details of
   which ciphersuites defined in this document require a server
   certificate to be sent.




Taylor                 Expires February 19, 2003                [Page 5]


Internet-Draft      Using SRP for TLS Authentication         August 2002


   Because the server's certificate is only used for generating a
   digital signature in SRP cipher suites, the certificate sent MUST
   contain a public key that can be used for generating digital
   signatures.

2.3.4 Client key exchange

   The client key exchange message carries the client's public key (A),
   which is calculated using both information known locally, and
   information received in the server hello message.  This message MUST
   be sent before the server key exchange message.

2.3.5 Server key exchange

   The server key exchange message contains the server's public key (B).
   The server key exchange message MUST be sent after the client key
   exchange message.

   If the server has sent a certificate message, the server key exchange
   message MUST be signed.

2.4 Calculating the Pre-master Secret

   The shared secret resulting from the SRP calculations (S) (defined in
   [2]) is used as the pre-master secret.

   The finished messages perform the same function as the client and
   server evidence messages specified in [2].  If either the client or
   the server calculate an incorrect value, the finished messages will
   not be understood, and the connection will be dropped as specified in
   [1].

2.5 Cipher Suite Definitions

   The following cipher suites are added by this draft.  The usage of
   AES ciphersuites is as defined in [4].

      CipherSuite TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA     = { 0x00,0x50 };

      CipherSuite TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA = { 0x00,0x51 };

      CipherSuite TLS_SRP_SHA_DSS_WITH_3DES_EDE_CBC_SHA = { 0x00,0x52 };

      CipherSuite TLS_SRP_SHA_WITH_AES_128_CBC_SHA      = { 0x00,0x53 };

      CipherSuite TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA  = { 0x00,0x54 };

      CipherSuite TLS_SRP_SHA_DSS_WITH_AES_128_CBC_SHA  = { 0x00,0x55 };



Taylor                 Expires February 19, 2003                [Page 6]


Internet-Draft      Using SRP for TLS Authentication         August 2002


      CipherSuite TLS_SRP_SHA_WITH_AES_256_CBC_SHA      = { 0x00,0x56 };

      CipherSuite TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA  = { 0x00,0x57 };

      CipherSuite TLS_SRP_SHA_DSS_WITH_AES_256_CBC_SHA  = { 0x00,0x58 };

   Cipher suites that do not include a digitial signature algorithm
   identifier assume the server is authenticated by its possesion of the
   SRP database.

   Cipher suites that begin with TLS_SRP_SHA_RSA or TLS_SRP_SHA_DSS
   require the server to send a certificate message containing a
   certificate with the specified type of public key, and to sign the
   server key exchange message using a matching private key.

   Implementations conforming to this specification MUST implement the
   TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA ciphersuite, SHOULD implement the
   TLS_SRP_SHA_WITH_AES_128_CBC_SHA and TLS_SRP_SHA_WITH_AES_256_CBC_SHA
   ciphersuites, and MAY implement the remaining ciphersuites.

2.6 New Message Structures

   This section shows the structure of the messages passed during a
   handshake that uses SRP for authentication.  The representation
   language used is the same as that used in [1].

   When encoding the numbers g, N, A, and B as opaque types, if the most
   significant bit is set, an extra byte of value 0x00 (all bits
   cleared) MUST be added as the most significant byte.  This is done as
   a safeguard against implementations that do not assume these numbers
   are positive.

2.6.1 ExtensionType

   A new value, "srp(6)", has been added to the enumerated
   ExtensionType, defined in [7].  This value is used as the extension
   number for the extensions in both the client hello message and the
   server hello message.

2.6.2 Client Hello

   The user name (U) is encoded in an SRPExtension structure, and sent
   in an extended client hello message, using an extension of type
   "srp".







Taylor                 Expires February 19, 2003                [Page 7]


Internet-Draft      Using SRP for TLS Authentication         August 2002


   enum { client, server } ClientOrServerExtension;

   struct {
      select(ClientOrServerExtension) {
         case client:
            opaque srp_U<1..2^8-1>;
         case server:
            opaque srp_s<1..2^8-1>
            opaque srp_N<1..2^16-1>;
            opaque srp_g<1..2^16-1>;
      }
   } SRPExtension;


2.6.3 Server Hello

   The generator (g), the prime (N), and the salt value (s) are encoded
   in an SRPExtension structure, which is sent in an extended server
   hello message, using an extension of type "srp".

2.6.4 Client Key Exchange

   When the value of KeyExchangeAlgorithm is set to "srp", the client's
   ephemeral public key (A) is sent in the client key exchange message,
   encoded in an ClientSRPPublic structure.

   An extra value, srp, has been added to the enumerated
   KeyExchangeAlgorithm, originally defined in TLS [1].

   struct {
      select (KeyExchangeAlgorithm) {
         case rsa: EncryptedPreMasterSecret;
         case diffie_hellman: ClientDiffieHellmanPublic;
         case srp: ClientSRPPublic;   /* new entry */
      } exchange_keys;
   } ClientKeyExchange;

   enum { rsa, diffie_hellman, srp } KeyExchangeAlgorithm;

   struct {
      opaque srp_A<1..2^16-1>;
   } ClientSRPPublic;


2.6.5 Server Key Exchange

   When the value of KeyExchangeAlgorithm is set to "srp", the server's
   ephemeral public key (B) is sent in the server key exchange message,



Taylor                 Expires February 19, 2003                [Page 8]


Internet-Draft      Using SRP for TLS Authentication         August 2002


   encoded in an ServerSRPPublic structure.

   The following table gives the SignatureAlgorithm value to be used for
   each ciphersuite.

      Ciphersuite                            SignatureAlgorithm

      TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA         anonymous

      TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA     rsa

      TLS_SRP_SHA_DSS_WITH_3DES_EDE_CBC_SHA     dsa

      TLS_SRP_SHA_WITH_AES_128_CBC_SHA          anonymous

      TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA      rsa

      TLS_SRP_SHA_DSS_WITH_AES_128_CBC_SHA      dsa

      TLS_SRP_SHA_WITH_AES_256_CBC_SHA          anonymous

      TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA      rsa

      TLS_SRP_SHA_DSS_WITH_AES_256_CBC_SHA      dsa


   struct {
      select (KeyExchangeAlgorithm) {
         case diffie_hellman:
            ServerDHParams params;
            Signature signed_params;
         case rsa:
            ServerRSAParams params;
            Signature signed_params;
         case srp:   /* new entry */
            ServerSRPPublic params;
            Signature signed_params;
      };
   } ServerKeyExchange;

   struct {
      opaque srp_B<1..2^16-1>;
   } ServerSRPPublic;     /* SRP parameters */








Taylor                 Expires February 19, 2003                [Page 9]


Internet-Draft      Using SRP for TLS Authentication         August 2002


3. Security Considerations

   If an attacker is able to steal the SRP verifier file, the attacker
   can masquerade as the real host.  Filesystem based X.509 certificate
   installations are vulnerable to a similar attack unless the server's
   certificate is issued from a PKI that maintains revocation lists, and
   the client TLS code can both contact the PKI and make use of the
   revocation list.











































Taylor                 Expires February 19, 2003               [Page 10]


Internet-Draft      Using SRP for TLS Authentication         August 2002


References

   [1]  Dierks, T. and C. Allen, "The TLS Protocol", RFC 2246, January
        1999.

   [2]  Wu, T., "The SRP Authentication and Key Exchange System", RFC
        2945, September 2000.

   [3]  Newman, C., "Using TLS with IMAP, POP3 and ACAP", RFC 2595, June
        1999.

   [4]  Chown, P., "Advanced Encryption Standard (AES) Ciphersuites for
        Transport Layer Security (TLS)", RFC 3268, June 2002.

   [5]  Ford-Hutchinson, P., Carpenter, M., Hudson, T., Murray, E. and
        V. Wiegand, "Securing FTP with TLS", draft-murray-auth-ftp-ssl-
        09 (work in progress), April 2002.

   [6]  Boe, M. and J. Altman, "TLS-based Telnet Security", draft-ietf-
        tn3270e-telnet-tls-06 (work in progress), April 2002.

   [7]  Blake-Wilson, S., Nystrom, M., Hopwood, D., Mikkelsen, J. and T.
        Wright, "TLS Extensions", draft-ietf-tls-extensions-05 (work in
        progress), July 2002.


Author's Address

   David Taylor
   Forge Research Pty Ltd

   EMail: DavidTaylor@forge.com.au
   URI:   http://www.forge.com.au/


















Taylor                 Expires February 19, 2003               [Page 11]


Internet-Draft      Using SRP for TLS Authentication         August 2002


Appendix A. Acknowledgements

   Thanks to all on the IETF tls mailing list for ideas and analysis.
















































Taylor                 Expires February 19, 2003               [Page 12]


Internet-Draft      Using SRP for TLS Authentication         August 2002


Full Copyright Statement

   Copyright (C) The Internet Society (2002).  All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Acknowledgement

   Funding for the RFC Editor function is currently provided by the
   Internet Society.



















Taylor                 Expires February 19, 2003               [Page 13]