draft-ietf-ldapext-authmeth-01.txt  -->   draft-ietf-ldapext-authmeth-02.txt

view Side-By-Side changes


                      Authentication Methods for LDAP
                   <draft-ietf-ldapext-authmeth-01.txt>
                   <draft-ietf-ldapext-authmeth-02.txt>

1. Status of this Memo

   This document is an Internet-Draft.  Internet-Drafts are working docu-
   ments 
   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 "work in progress.'' 
   progress."

   To learn view the current status entire list of any Internet-Draft, current Internet-Drafts, please check
   the
   ``1id-abstracts.txt'' "1id-abstracts.txt" listing contained in the Internet-Drafts
   Shadow Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe), ftp.nordu.net
   (Northern Europe), ftp.nis.garr.it (Southern Europe), munnari.oz.au
   (Pacific Rim), ds.internic.net ftp.ietf.org (US East Coast), or ftp.isi.edu
   (US West Coast).

2. Abstract

   This document specifies particular combinations of SASL [2] security 
   mechanisms
   and extensions which are required and recommended in LDAP [1] 
   implementations.

   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 [3].

3. Introduction

   LDAP version 3 is a powerful access protocol for directories.

   It offers means of searching, fetching and manipulating directory
   content, and ways to access a rich set of security functions.

   In order to function for the best of the Internet, it is vital
   that these security functions be interoperable; therefore there
   has to be a minimum subset of security functions that is common to
   all implementations that claim LDAPv3 conformance.






Wahl et al.



Wahl, Alvestrand, Hodges, Morgan                              Page 1

INTERNET-DRAFT        Authentication Methods for LDAP           [Page 1]

INTERNET-DRAFT     draft-ietf-ldapext-authmeth-01.txt      January         July 1998

    2.  Threats to an LDAP directory

   The basic threats to the an LDAP directory service are:

     (1)   Unauthorized access to data via data-fetching operations,

     (2)   Unauthorized access to data reusable client authentication
           information by monitoring others' access,

     (3)   Unauthorized access to data by monitoring others' access,

     (4)   Unauthorized modification of data,

     (4)

     (5)   Unauthorized modification of configuration,

     (5)

     (6)   Unauthorized or excessive use of resources (denial of 
           service), and

     (6)

     (7)   Spoofing of directory: Tricking a client into believing
           that information came from the directory when in fact it
           did not. not, either by modifying data in transit or misdirecting
           the client's connection.

   Threats (1), (4), (5) and (6) are due to hostile clients.  Threats
   (2), (3) and (7) are due to hostile agents on the path between client
   and server, or posing as a server.

   The LDAP protocol suite can be protected with the following
   security mechanisms:

     (1)   Client authentication by means of the SASL mechanism set,
           possibly backed by the TLS credentials exchange mechanism,

     (2)   Client authorization by means of access control based on
           the requestor's authenticated identity,

     (3)   Snoop   Data integrity protection by means of the TLS protocol, protocol or
           data-integrity SASL mechanisms,

     (4)   Protection against snooping by means of the TLS protocol 
           or data-encrypting SASL mechanisms,

     (5)   Resource limitation by means of administrative limits on
           service controls, and

     (5)

     (6)   Server authentication by means of the TLS protocol. protocol or SASL
           mechanism.

   At the moment, imposition of access controls is done by means
   outside the scope of the LDAP protocol.  

   In this document, the term "user" represents any application which
   is an LDAP client using the directory to retrieve or store information.

Wahl, Alvestrand, Hodges, Morgan                              Page 2

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

   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 [3].

4.  Deployment scenarios

   The following scenarios make sense are typical for LDAP, LDAP directories, and have vastly
   different security requirements. (In the following, "sensitive"
   means data that will cause real damage to the owner if revealed;
   there may be data that is protected but not sensitive)

     (1)   A read-only directory, containing no sensitive data,
           accessible to "anyone". "anyone", and TCP connection hijacking
           or IP spoofing is not a problem.  This directory requires 
           no security functions except the service limits.





Wahl et al.          Authentication Methods for LDAP           [Page 2]

INTERNET-DRAFT     draft-ietf-ldapext-authmeth-01.txt      January 1998  

     (2)   A read-only directory containing no sensitive data; read
           access is granted based on identity.  This scenario requires 
	   a secure authentication function.  TCP connection 
           hijacking is not currently a problem. This scenario requires 
	   a secure authentication function.  

     (3)   A read-only directory containing no sensitive data; and
           the client needs to ensure that the directory data is 
           authenticated by the server not and modified while being 
           returned from the server.

     (4)   A read-write directory, containing no sensitive data; read
           access is available to "anyone", update access to properly
           authorized persons.  This scenario requires a secure 
           authentication function.  TCP connection hijacking is not 
           currently a problem.

     (4)  This scenario requires a secure 
           authentication function.  

     (5)   A directory containing sensitive data.  This scenario
           requires session confidentiality protection AND secure 
           authentication.

   Other scenarios are possible. 

   This document does not describe the requirements for use of LDAP
   in physically protected networks; this is concerned with LDAP used
   on the Internet.

5.  Choice of mandatory security mechanisms

    It is clear that allowing any implementation, faced with the above
    requirements, to pick  Authentication and choose among the possible alternatives
    is not Authorization:  Definitions and Concepts

   This section defines basic terms, concepts, and interrelationships
   regarding authentication, authorization, credentials, and identity.
   These concepts are used in describing how various security 
   approaches are utilized in client authentication and authorization.




Wahl, Alvestrand, Hodges, Morgan                              Page 3

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

5.1.  Access Control Policy

   An access control policy is a strategy that set of rules defining the protection 
   of resources, generally in terms of the capabilities of persons or 
   other entities accessing those resources.  A common expression of an 
   access control policy is likely an access control list.  Security objects 
   and mechanisms, such as those described here, enable the expression of 
   access control policies and their enforcement.  Access control 
   policies are typically expressed in terms of access control attributes 
   as described below.

5.2.  Access Control Factors

   A request, when it is being processed by a server, may be associated
   with a wide variety of security-related factors (section 4.2 of [1]). 
   The server uses these factors to lead determine whether and how to interoperability. In process 
   the absence request.  These are called access control factors (ACFs).  They
   might include source IP address, encryption strength, the type of mandates, clients will
   operation being requested, time of day, etc.  Some factors may be written that do not
    support any security function supported by
   specific to the server, or worse,
    support only mechanisms like cleartext passwords that provide
    clearly inadequate security.

    Given request itself, others may be associated with the presence of 
   connection via which the Directory, there request is transmitted, others (e.g. time of 
   day) may be "environmental".

   Access control policies are expressed in terms of access control 
   factors.  E.g., a strong desire request having ACFs i,j,k can perform operation Y 
   on resource Z. The set of ACFs that a server makes available for such
   expressions is implementation-specific.

5.3.  Authentication, Credentials, Identity

   Authentication credentials are the evidence supplied by one party to
    see mechanisms where identities take
   another, asserting the form identity of the supplying party (e.g. a Distinguished
    Name user) 
   who is attempting to establish an association with the other party 
   (typically a server).  Authentication is the process of generating, 
   transmitting, and authentication data can be stored in verifying these credentials and thus the directory; this
    means that either this data identity
   they assert.  An authentication identity is useless for faking the name presented in a 
   credential.

   There are many forms of authentication
    (like credentials -- the Unix "/etc/passwd" file format form used to be), or its
    content is never passed across
   depends upon the wire unprotected - that is,
    it's either updated outside particular authentication mechanism negotiated by the protocol or it
   parties.  For example: X.509 certificates, Kerberos tickets, simple
   identity and password pairs.  Note that an authentication mechanism may
   constrain the form of authentication identities used with it.

5.4.  Authorization Identity

   An authorization identity is one kind of access control factor.  It is only updated in
    sessions well protected against snooping.

    At
   the moment, only implementations using public key cryptography
    satisfy name of the requirement user or other entity that it requests that operations be useless for faking
    authentication.

    Therefore, the following mandates
   performed.  Access control policies are often expressed in place:

     (1)   For a read-only, public directory, anonymous authentication, 
	   described in section 6, terms of
   authorization identities; e.g., entity X can be used.

     (2)   Implementations MUST support password-based authentication 
           using CRAM-MD5, as described in section 7.1.




Wahl et al. perform operation Y on
   resource Z.

Wahl, Alvestrand, Hodges, Morgan                              Page 4

INTERNET-DRAFT        Authentication Methods for LDAP           [Page 3]

INTERNET-DRAFT     draft-ietf-ldapext-authmeth-01.txt      January         July 1998

     (3)   For a directory needing session protection and
           authentication, Start TLS with

   The authorization identity bound to an association is often exactly the
   same as the authentication identity presented by the client, but it may
   be different.  SASL EXTERNAL mechanism
	   is allows clients to be used.  Implementations SHOULD support specify an authorization identity
   distinct from the authentication
           with a password identity asserted by the client's
   credentials.  This permits agents such as described in section 7.2, and SHOULD
           support proxy servers to authenticate
   using their own credentials, yet request the access privileges of the
   identity for which they are proxying [SASL].  Also, the form of 
   authentication with identity supplied by a certificate as described in 
           section 8.1.

6. Anonymous authentication

   Anonymous authentication is suitable for users who do service like TLS may not intend 
   correspond to
   modify directory entries and do not require access the authorization identities used to protected 
   attributes or entries.

   LDAP implementations MUST support anonymous authentication, as 
   defined in section 6.1.

   While there MAY be express a server's 
   access control restrictions to prevent access  policy, requiring a server-specific mapping to 
   directory entries, an LDAP be done.
   The method by which a server MUST allow composes and validates an anonymously-bound 
   client to retrieve authorization 
   identity from the authentication credentials supplied by a client is 
   implementation-specific.

6. Required security mechanisms

   It is clear that allowing any implementation, faced with the above
   requirements, to pick and choose among the possible alternatives
   is not a strategy that is likely to lead to interoperability. In
   the absence of mandates, clients will be written that do not
   support any security function supported by the server, or worse,
   support only mechanisms like cleartext passwords that provide
   clearly inadequate security.

   Active intermediary attacks are the most difficult for an attacker 
   to perform, and for an implementation to protect against.  Methods 
   that protect only against hostile client and passive eavesdropping 
   attacks are useful in situations where the cost of protection 
   against active intermediary attacks is not justified based on the
   perceived risk of active intermediary attacks.

   Given the presence of the Directory, there is a strong desire to
   see mechanisms where identities take the form of a Distinguished
   Name and authentication data can be stored in the directory; this
   means that either this data is useless for faking authentication
   (like the Unix "/etc/passwd" file format used to be), or its
   content is never passed across the wire unprotected - that is,
   it's either updated outside the protocol or it is only updated in
   sessions well protected against snooping.  It is also desirable 
   to allow authentication methods to carry authorization identities
   based on existing forms of user identities for backwards compatibility 
   with non-LDAP-based authentication services.

   At the moment, only implementations using public key cryptography
   satisfy the requirement that data stored in the directory be 
   insufficient for faking authentication.






Wahl, Alvestrand, Hodges, Morgan                              Page 5

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

   Therefore, the following implementation conformance requirements
   are in place:

     (1)   For a read-only, public directory, anonymous authentication, 
	   described in section 7, can be used.

     (2)   Implementations providing password-based authenticated access
           MUST support authentication using CRAM-MD5, as described in 
           section 8.1.  This provides client authentication with 
           protection against passive eavesdropping attacks, but does
           not provide protection against active intermediary attacks.

     (3)   For a directory needing session protection and
           authentication, The Start TLS extended operation, and either
           the simple authentication choice or the SASL EXTERNAL 
           mechanism, are to be used together.  Implementations SHOULD 
           support authentication with a password as described in 
           section 8.2, and SHOULD support authentication with a 
           certificate as described in section 9.1.  Together, these
           can provide integrity and disclosure protection of 
           transmitted data, and authentication of client and server,
           including protection against active intermediary attacks.

7. Anonymous authentication

   Directory operations which modify entries or access protected 
   attributes or entries generally require client authentication.  
   Clients which do not intend to perform any of these operations 
   typically use anonymous authentication.

   LDAP implementations MUST support anonymous authentication, as 
   defined in section 7.1.

   LDAP implementations MAY support anonymous authentication with TLS,
   as defined in section 7.2.  

   While there MAY be access control restrictions to prevent access to 
   directory entries, an LDAP server MUST allow an anonymously-bound 
   client to retrieve the supportedSASLMechanisms attribute of the root 
   DSE.

   An LDAP server MAY use other information about the client provided
   by the lower layers or external means to grant or deny access even
   to anonymously authenticated clients. 

7.1. Anonymous authentication procedure

   An LDAP client which has not successfully completed a bind operation 
   on a connection is anonymously authenticated.



Wahl, Alvestrand, Hodges, Morgan                              Page 6

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

   An LDAP client MAY also specify anonymous authentication in a bind 
   request by using a zero-length OCTET STRING with the simple
   authentication choice.

7.2. Anonymous authentication and TLS

   An LDAP client MAY use the Start TLS operation [5] to negotiate the
   use of TLS security [6].  If the client has not bound beforehand,
   then until the client uses the EXTERNAL SASL mechanism to negotiate
   the recognition of the client's certificate, the client is 
   anonymously authenticated.  

   Recommendations on TLS ciphersuites is given in section 12.

   An LDAP server which requests that clients provide their certificate
   during TLS negotiation MAY use a local security policy to determine
   whether to successfully complete TLS negotiation if the client did not 
   present a certificate which could be validated.

8. Password-based authentication

   LDAP implementations MUST support authentication with a password using
   the CRAM-MD5 mechanism for password protection, as defined in section 
   8.1.  

   LDAP implementations SHOULD support authentication with the "simple"
   password choice when the connection is protected against eavesdropping
   using TLS, as defined in section 8.2.  
  
   LDAP implementations MAY also support authentication with the 
   "CRAM-MD5" authentication choice when the connection is protected 
   using TLS, as defined in section 8.3.

8.1. CRAM-MD5 authentication

   A client which has a password available to the directory (e.g. stored
   in the userPassword attribute of the client's directory entry) MAY
   authenticate to the directory by performing a protected password 
   bind sequence based on the CRAM-MD5 mechanism [4].  

   An LDAP client may determine whether the server supports this 
   mechanism by performing a search request on the root DSE, requesting
   the supportedSASLMechanisms attribute attribute, and checking whether the 
   string "CRAM-MD5" is present as a value of this attribute.

   In the first stage of authentication, the client sends a bind 
   request in which the version number is 3, the name field is the name 
   of the user's entry (if known to the client), the authentication choice
   is sasl, the sasl mechanism name is "CRAM-MD5", and the credentials 
   are absent.  The client then waits for a response from the server to 
   this request.

Wahl, Alvestrand, Hodges, Morgan                              Page 7

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

   The server shall generate a challenge and return a bind response in
   which the resultCode is saslBindInProgress, and the serverSaslCreds
   field is present.  The contents of the serverSaslCreds string is 
   the challenge, which is not base64 encoded.  An example challenge is
   "<1896.697170952@postoffice.reston.mci.net>".  Note that in this 
   stage of the mechanism, the server need not access the user's password.
   The server will save the challenge internally, associated with the
   connection, until the next stage of the bind operation is completed.
   The challenge string MUST NOT be reused.
   
   Upon receipt of the challenge, the client will generate the response
   digest value, which is a string of 32 hexadecimal digits.  An 
   example digest derived from the above challenge and the password 
   "tanstaaftanstaaf" is "b913a602c7eda7a495b4e6e7334d3890". The client
   will send a bind request, with a different message id, in which the
   version number is 3, the name field is the name of the root 
   DSE.

6.1. Anonymous user's entry
   (if known), the authentication procedure

   An LDAP client which has not successfully completed choice is sasl, the sasl mechanism name 
   is "CRAM-MD5", and the credentials field contains a bind operation 
   on concatenation of 
   the user's authorization identity (of the authzId form defined in 
   section 11), a connection is anonymously authenticated. space character (ASCII 32), and the digest value. An LDAP
   example of the credentials field would be:
   
   dn: cn=J Smith\, Esq.,dc=acme,dc=com b913a602c7eda7a495b4e6e7334d3890
    
   The client MAY also specify anonymous then will wait for another response from the server.

   If the server performs password authentication based on the 
   userPassword attribute, the server will then, for each value of the 
   userPassword attribute in a bind 
   request the named user's entry, generate the digest 
   value itself, and compare the result with the client's presented 
   digest.  A similar process can be used by using servers which maintain
   password through other means.

   If there is a zero-length OCTET STRING match, then the server will respond with resultCode 
   success, otherwise the simple
   authentication choice.

6.2. Anonymous authentication and TLS

   An LDAP client MAY use server will respond with resultCode 
   invalidCredentials.  The serverSaslCreds field will be absent.

   The server will delete the Start TLS operation [5] to negotiate challenge from memory when the
   use of TLS security [6].  If SASL 
   negotiation completes, or if the client has not bound beforehand and does not present a certificate during TLS negotiation, then complete the SASL 
   negotiation, as challenge strings MUST never be used twice.  A client is anonymously authenticated.

7. Password-based authentication

   LDAP implementations 
   MUST support authentication with a password using
   the CRAM-MD5 mechanism for password protection, as defined NOT send more than one bind request containing response digest 
   values in section 
   7.1.  

   LDAP implementations SHOULD support authentication with which the same challenge string was used.  If a client 
   wishes to change authentication, it MUST start from the beginning 
   and request a new challenge.

8.2. "simple"
   password choice when the connection is protected against eavesdropping
   using TLS, as defined in section 7.2.






Wahl et al.          Authentication Methods for LDAP           [Page 4]

INTERNET-DRAFT     draft-ietf-ldapext-authmeth-01.txt      January 1998

7.1. CRAM-MD5 authentication choice under encryption

   A user who has a directory entry containing a userPassword attribute
   may
   MAY authenticate to the directory by performing a protected simple password
   bind sequence based on the CRAM-MD5 mechanism [4].

   An LDAP client may determine whether the server supports this 
   mechanism by performing a search request on the root DSE, requesting
   the supportedSASLMechanisms attribute, and checking whether the 
   string "CRAM-MD5" is present as a value of this attribute.

   In following the first stage negotiation of authentication, the client sends a bind 
   request in which the version number is 3, the name field is the name 
   of the user's entry, the authentication choice is sasl, the sasl 
   mechanism name is "CRAM-MD5", and the credentials are absent. TLS ciphersuite 
   providing connection confidentiality [6].

Wahl, Alvestrand, Hodges, Morgan                              Page 8

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

   The client then waits for a response from will use the server Start TLS operation [5] to this request.

   The server shall generate a challenge and return a bind response in
   which the resultCode is saslBindInProgress, and the serverSaslCreds
   field is present.  The contents of the serverSaslCreds string is negotiate the challenge, which is not base64 encoded.  An example challenge is
   "<1896.697170952@postoffice.reston.mci.net>".  Note that in this 
   stage 
   use of TLS security [6] on the mechanism, the server need not access the user's entry.
   The server will save the challenge internally, associated with the
   connection, until the next stage of connection to the bind operation is completed. LDAP server.  The challenge string will
   client need not reused, however.
   
   Upon receipt of have bound to the challenge, directory beforehand.

   For this authentication procedure to be successful, the client will generate the response
   digest value, and 
   server MUST negotiate a ciphersuite which is contains a string bulk encryption
   algorithm of 32 hexadecimal digits.  An 
   example digest derived from appropriate strength.  Recommendations on cipher
   suites are given in section 12. 

   Following the above challenge and successful completion of TLS negotiation, the password 
   "tanstaaftanstaaf" is "b913a602c7eda7a495b4e6e7334d3890". The client
   will
   MUST send a an LDAP bind request, request with a different message id, in which the version number is of 3, the 
   name field is containing the name of the user's entry,
   the authentication choice is sasl, the sasl mechanism name is 
   "CRAM-MD5", and the credentials field contains a concatenation of 
   the name of the user's entry, "simple" 
   authentication choice, containing a space character (ASCII 32), and the 
   digest string.  The client then will waits for another response from 
   the server. password.

   The server will then, will, for each value of the userPassword attribute in 
   the named user's entry, generate the digest value itself, and compare the result these for case-sensitive equality 
   with the client's presented digest. password.  If there is a match, then the 
   server will respond with resultCode success, otherwise the server will
   respond with resultCode invalidCredentials.
   The serverSaslCreds field will be absent.







Wahl et al.          Authentication Methods for LDAP           [Page 5]

INTERNET-DRAFT     draft-ietf-ldapext-authmeth-01.txt      January 1998

   If

8.3. CRAM-MD5 authentication choice under encryption
   
   It is also possible to perform CRAM-MD5 authentication following 
   the negotiation of TLS.  The client does not complete the SASL negotiation, the and server 
   MUST delete the challenge from memory, as challenge strings MUST
   never be used twice.  A client MUST NOT send more than one bind 
   request containing response digest values in need not negotiate a
   ciphersuite which provides confidentiality if the same challenge
   string was used.  If only service 
   required is data integrity.

9. Certificate-based authentication

   LDAP implementations SHOULD support authentication via a client wishes to change authentication, it
   MUST start from the beginning and request a new challenge.

7.2. "simple" 
   certificate in TLS, as defined in section 9.1.  

9.1. Certificate-based authentication choice under encryption with TLS

   A user who has a directory entry containing public/private key pair in which the public key has
   been signed by a userPassword attribute
   can Certification Authority may use this key pair to
   authenticate to the directory server if the user's certificate is 
   requested by performing a simple password
   bind sequence following the negotiation server.  The user's certificate subject field 
   SHOULD be the name of a TLS ciphersuite 
   providing connection confidentiality [6]. the user's directory entry, and the 
   Certification Authority must be sufficiently trusted by the 
   directory server to have issued the certificate in order that the 
   server can process the certificate.  The means by which servers
   validate certificate paths is outside the scope of this document.

   A server MAY support mappings for certificates in which the subject 
   field name is different from the name of the user's directory entry. 
   A server which supports mappings of names MUST be capable of being
   configured to support certificates for which no mapping is required.




Wahl, Alvestrand, Hodges, Morgan                              Page 9

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

   The client will use the Start TLS operation [5] to negotiate the 
   use of TLS security [6] on the connection to the LDAP server.  The
   client need not have bound to the directory beforehand.

   For this authentication procedure

   In the TLS negotiation, the server MUST request a certificate.  The
   client will provide its certificate to be successful, the server, and MUST perform 
   a private key-based encryption, proving it has it private key 
   associated with the certificate.  

   As deployments will require protection of sensitive data in transit,
   the client and server MUST negotiate a ciphersuite which contains a 
   bulk encryption algorithm of appropriate strength.  Recommendations
   of cipher 
   algorithm.  The following suites are NOT permitted:

         TLS_NULL_WITH_NULL_NULL
         TLS_RSA_WITH_NULL_MD5
         TLS_RSA_WITH_NULL_SHA given in section 12.

   The RECOMMENDED ciphersuite server MUST verify that the client's certificate is TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA. valid. 
   The server will normally check that the certificate is issued by a 
   known CA, and that none of the certificates on the client's 
   certificate chain are invalid or revoked.  There are several 
   procedures by which the server can perform these checks.

   Following the successful completion of TLS negotiation, the client
   MUST
   will send an LDAP bind request with the version number of 3, the 
   name field containing the name of the user's entry, and the SASL "EXTERNAL" mechanism.  

10. Other mechanisms

   The LDAP "simple" authentication choice, containing a password.

   The server will, for each value of the userPassword attribute in 
   the named user's entry, compare these choice is not suitable for case-sensitive equality 
   with 
   authentication on the client's presented password.  If Internet where there is a match, then the 
   server will respond with resultCode success, otherwise the server will
   respond with resultCode invalidCredentials.

8. Certificate-based authentication no network or transport 
   layer confidentiality.

   As LDAP implementations SHOULD support authentication via includes a client 
   certificate in TLS, as defined in section 8.1.  









Wahl et al.          Authentication Methods for LDAP           [Page 6]

INTERNET-DRAFT     draft-ietf-ldapext-authmeth-01.txt      January 1998

8.1. Certificate-based native anonymous and plaintext authentication 
   methods, the "ANONYMOUS" and "PLAIN" SASL mechanisms are not used 
   with TLS

   A user who has LDAP.  If an authorization identity of a public/private key pair in which the public key has
   been signed by form different from
   a Certification Authority may use this key pair to
   authenticate to the directory server.  The user's certificate 
   subject field SHOULD be the name of the user's directory entry, and
   the Certification Authority must be sufficiently trusted DN is requested by the 
   directory server to have issued client, the certificate. CRAM-MD5 mechanism can be used.

   The client will use the Start TLS operation [5] following SASL-based mechanisms are not considered in this 
   document: KERBEROS_V4, GSSAPI and SKEY.  

   The "EXTERNAL" SASL mechanism can be used to negotiate request the LDAP server
   make use of TLS security [6] on the connection to the LDAP server.  The
   client need credentials exchanged by a lower layer. If a 
   TLS session has not have bound been established between the client and server 
   prior to making the directory beforehand.

   In SASL EXTERNAL Bind request and there is no other 
   external source of authentication credentials (e.g.  IP-level 
   security RFC 1825), or if, during the process of establishing the 
   TLS negotiation, session, the server MUST did not request a certificate.  The
   client will provide its certificate to the server, and client's authentication 
   credentials, the SASL EXTERNAL bind MUST perform 
   a private key-based encryption, proving it has it private key 
   associated fail with a result code of 
   inappropriateAuthentication. Any authentication identity and 
   authorization identity, as well as TLS connection, which were in 
   effect prior to making the certificate.  

   As deployments will require protection Bind request, MUST remain in force.




Wahl, Alvestrand, Hodges, Morgan                              Page 10

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

11. Authorization Identity

   The authorization identity is carried as part of sensitive data the SASL credentials
   field in transit, the client LDAP Bind request and server MUST negotiate a ciphersuite which response.  

   When the "EXTERNAL" mechanism is being negotiated, if the 
   credentials field is present, it contains a 
   cipher algorithm.  The following are NOT permitted:

         TLS_NULL_WITH_NULL_NULL
         TLS_RSA_WITH_NULL_MD5
         TLS_RSA_WITH_NULL_SHA

   The RECOMMENDED ciphersuite an authorization identity
   of the authzId form described below.

   When the "CRAM-MD5" mechanism is TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA.

   The server MUST verify that being negotiated, if the client's certificate
   credentials field is valid, 
   issued by present, it contains a known CA, concatenation of an 
   authorization identity of the authzId form, a space character, and that none 
   the digest string.

   Other mechanisms define the location of the certificates on authorization 
   identity in the 
   client's certificate chain credentials field.
 
   The authorization identity is a string in the UTF-8 character set, 
   corresponding to the following ABNF [7]:

   ; Specific predefined authorization (authz) id schemes are invalid
   ; defined below -- new schemes may be defined in the future.

   authzId    = dnAuthzId / uAuthzId

   ; distinguished-name-based authz id.
   dnAuthzId  = "dn:" dn
   dn         = utf8string    ; with syntax defined in RFC 2253

   ; unspecified userid, UTF-8 encoded.
   uAuthzId   = "u:" userid
   userid     = utf8string    ; syntax unspecified

   A utf8string is defined to be the UTF-8 encoding of one or revoked.

   Following more
   ISO 10646 characters.

   All servers which support the successful completion storage of TLS negotiation, authentication credentials, 
   such as passwords or certificates, in the client directory MUST send an LDAP bind request with support the SASL "EXTERNAL" mechanism. 
   dnAuthzId choice. 

   The uAuthzId choice allows for compatibility with client applications 
   which wish to authenticate to a local directory but do not know their
   own Distinguished Name or have a directory entry.  The format of this bind request and the server's behavior 
   string is defined 
   in section 6.2 of [5].

   If the server receives as only a bind request with sequence of UTF-8 encoded ISO 10646 
   characters, and further interpretation is subject to prior agreement 
   between the EXTERNAL SASL
   mechanism name client and TLS has not been negotiated, it SHOULD return server.  

   For example, the userid could identify a
   resultCode user of invalidCredentials.

9. Limited Use

   The LDAP "simple" authentication choice is not suitable for 
   authentication on the Internet where there is no network a specific directory 
   service, or transport 
   layer confidentiality.

   As LDAP includes be a native anonymous and plaintext authentication 
   methods, login name or the "ANONYMOUS" and "PLAIN" SASL mechanisms are not used 
   with LDAP.


Wahl et al. local-part of an RFC 822 email 
   address. In general a uAuthzId MUST NOT be assumed to be globally 
   unique.

Wahl, Alvestrand, Hodges, Morgan                              Page 11

INTERNET-DRAFT        Authentication Methods for LDAP           [Page 7]

INTERNET-DRAFT     draft-ietf-ldapext-authmeth-01.txt      January         July 1998

   Additional authorization identity schemes MAY be defined in future
   versions of this document.

12. TLS Ciphersuites

   The following SASL-based mechanisms are not considered ciphersuites defined in this 
   document: KERBEROS_V4, GSSAPI [6] MUST NOT be used for
   confidentiality protection of passwords or data:

         TLS_NULL_WITH_NULL_NULL
         TLS_RSA_WITH_NULL_MD5
         TLS_RSA_WITH_NULL_SHA

   The following ciphersuites defined in [6] can be cracked easily
   (less than a week of CPU time on a standard CPU in 1997).  The 
   client and SKEY.

10. server SHOULD carefully consider the value of the
   password or data being protected before using these ciphersuites:

         TLS_RSA_EXPORT_WITH_RC2_40_MD5
         TLS_RSA_EXPORT_WITH_RC2_CBC_40_MD5
         TLS_RSA_EXPORT_WITH_DES40_CBC_SHA
         TLS_DH_DSS_EXPORT_WITH_DES40_CBC_SHA
         TLS_DH_RSA_EXPORT_WITH_DES40_CBC_SHA
         TLS_DHE_DSS_EXPORT_WITH_DES40_CBC_SHA
         TLS_DHE_RSA_EXPORT_WITH_DES40_CBC_SHA
         TLS_DH_anon_EXPORT_WITH_RC4_40_MD5
         TLS_DH_anon_EXPORT_WITH_DES40_CBC_SHA

   The following ciphersuites are vulnerable to man-in-the-middle
   attacks, and SHOULD NOT be used to protect passwords or sensitive
   data, unless the network configuration is such that the danger of
   a man-in-the-middle attack is tolerable:
        
         TLS_DH_anon_EXPORT_WITH_RC4_40_MD5
         TLS_DH_anon_WITH_RC4_128_MD5
         TLS_DH_anon_EXPORT_WITH_DES40_CBC_SHA
         TLS_DH_anon_WITH_DES_CBC_SHA
         TLS_DH_anon_WITH_3DES_EDE_CBC_SHA

   The RECOMMENDED ciphersuite is TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA.

13. Security Considerations

   Security issues are discussed throughout this memo; the
   (unsurprising) conclusion is that mandatory security is important,
   and that session encryption is required when snooping is a
   problem.






Wahl, Alvestrand, Hodges, Morgan                              Page 12

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

   Servers are encouraged to prevent DIT modifications by anonymous 
   users. Servers may also wish to minimize denial of service attacks 
   by timing out idle connections, and returning the unwillingToPerform
   result code rather than performing computationally expensive 
   operations requested by unauthorized clients.

   A connection on which the client has not performed the Start TLS 
   operation or negotiated a suitable SASL mechanism for connection 
   integrity and encryption services is subject to man-in-the-middle 
   attacks to view and modify information in transit.

   Additional security considerations relating to the CRAM-MD5 
   mechanism can be found in [4], and security considerations relating
   to the EXTERNAL mechanism to negotiate TLS can be found in [2], [5]
   and [6].  

11.  

14. Acknowledgements

   This document is a product of the LDAPEXT Working Group of the 
   IETF.  The contributions of its members is greatly appreciated.

12.

15. Bibliography

   [1] M. Wahl, T. Howes, S. Kille, "Lightweight Directory Access 
       Protocol (v3)", Dec. 1997, RFC 2251.

   [2] J. Myers, "Simple Authentication and Security Layer (SASL)", 
       Oct. 1997, RFC 2222.

   [3] S. Bradner, "Key words for use in RFCs to Indicate Requirement
       Levels", RFC 2119.

   [4] J. Klensin, R. Catoe, P. Krumviede, "IMAP/POP AUTHorize
       Extension for Simple Challenge/Response", Sep. 1997, RFC 2195.

   [5] J. Hodges, RL Morgan, M. Wahl, "LDAPv3 Extension for Transport
       Layer Security", Aug. 1997, INTERNET DRAFT
       <draft-ietf-asid-ldapv3-tls-02.txt>.
       <draft-ietf-ldapext-ldapv3-tls-00.txt>.

   [6] T. Diers, C. Allen, "The TLS Protocol Version 1.0", Oct. 1997,
       INTERNET DRAFT <draft-ietf-tls-protocol-04.txt>.

Wahl et al.

   [7] D. Crocker, Ed., P. Overell, "Augmented BNF for Syntax
       Specifications: ABNF", RFC 2234.








Wahl, Alvestrand, Hodges, Morgan                              Page 13

INTERNET-DRAFT        Authentication Methods for LDAP           [Page 8]

INTERNET-DRAFT     draft-ietf-ldapext-authmeth-01.txt      January         July 1998

13.

16. Authors Address

    Mark Wahl
    Critical Angle
    Innosoft International, Inc.
    4815 West Braker Lane #502-385
    8911 Capital of Texas Hwy, Suite 4140
    Austin, TX 78759 
    USA

    Phone: +1 626 919 3600
    EMail:  M.Wahl@critical-angle.com  Mark.Wahl@innosoft.com


    Harald Tveit Alvestrand
    EMail: Harald.Alvestrand@maxware.no


    Jeff Hodges
    Computing & Communication Services
    Stanford University
    Pine Hall
    241 Panama Street
    Stanford, CA 94305-4122
    USA

    Phone: +1-650-723-2452
    EMail: Jeff.Hodges@Stanford.edu


    RL "Bob" Morgan
    Computing & Communication Services
    Stanford University
    Pine Hall
    241 Panama Street
    Stanford, CA 94305-4122
    USA

    Phone: +1-650-723-9711
    EMail: Bob.Morgan@Stanford.edu














Wahl, Alvestrand, Hodges, Morgan                              Page 14

INTERNET-DRAFT        Authentication Methods for LDAP         July 1998

Full Copyright Statement

   Copyright (C) The Internet Society (1998).  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.












Wahl et al.          Authentication Methods for LDAP           [Page 9]

























Wahl, Alvestrand, Hodges, Morgan                              Page 15

----