Bump versions.
[gsasl.git] / doc / specification / draft-ietf-sasl-anon-02.txt
blobbcff00a037adfe10904816cf2b4e7892cd2d519e
7 INTERNET-DRAFT                           Editor: Kurt D. Zeilenga
8 Intended Category: Standards Track            OpenLDAP Foundation
9 Expires in six months                                30 June 2003
10 Obsoletes: RFC 2245
13                        The Anonymous SASL Mechanism
14                       <draft-ietf-sasl-anon-02.txt>
17 Status of Memo
19   This document is an Internet-Draft and is in full conformance with all
20   provisions of Section 10 of RFC2026.
22   This document is intended to be, after appropriate review and
23   revision, submitted to the RFC Editor as a Standards Track document.
24   Distribution of this memo is unlimited.  Technical discussion of this
25   document will take place on the IETF SASL mailing list
26   <ietf-sasl@imc.org>.  Please send editorial comments directly to the
27   document editor <Kurt@OpenLDAP.org>.
29   Internet-Drafts are working documents of the Internet Engineering Task
30   Force (IETF), its areas, and its working groups.  Note that other
31   groups may also distribute working documents as Internet-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
38   <http://www.ietf.org/ietf/1id-abstracts.txt>. The list of
39   Internet-Draft Shadow Directories can be accessed at
40   <http://www.ietf.org/shadow.html>.
42   Copyright (C) The Internet Society (2003).  All Rights Reserved.
44   Please see the Full Copyright section near the end of this document
45   for more information.
48 Abstract
50   It is common practice on the Internet to permit anonymous access to
51   various services.  Traditionally, this has been done with a plain text
52   password mechanism using "anonymous" as the user name and optional
53   trace information, such as an email address, as the password.  As
54   plain text login commands are not permitted in new IETF protocols, a
58 Zeilenga                Anonymous SASL Mechanism                [Page 1]
60 INTERNET-DRAFT         draft-ietf-sasl-anon-02.txt          30 June 2003
63   new way to provide anonymous login is needed within the context of the
64   Simple Authentication and Security Layer (SASL) framework.
67 Conventions
69   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
70   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
71   document are to be interpreted as described in [Keywords].
74 1. Anonymous SASL mechanism
76   This document defines an anonymous mechanism for the Simple
77   Authentication and Security Layer ([SASL]) framework.  The name
78   associated with this mechanism is "ANONYMOUS".
80   This document replaces RFC 2245.  Changes since RFC 2245 are detailed
81   in Appendix A.
83   The mechanism consists of a single message from the client to the
84   server.  The client sends optional trace information in the form of a
85   string of [UTF-8] encoded [Unicode] characters prepared in accordance
86   with [StringPrep] and the "trace" stringprep profile defined in
87   Section 2 of this document.  The trace information, which has no
88   semantical value, should take one of three forms: an Internet email
89   address, an opaque string which does not contain the '@' (U+0040)
90   character and can be interpreted by the system administrator of the
91   client's domain, or nothing.  For privacy reasons, an Internet email
92   address or other information identifying the user should only be used
93   with permission from the user.
95   A server which permits anonymous access will announce support for the
96   ANONYMOUS mechanism, and allow anyone to log in using that mechanism,
97   usually with restricted access.
99   This mechanism does not provide a security layer.
101   A formal grammar for the client message using Augmented BNF [ABNF] is
102   provide below as a tool for understanding this technical
103   specification.
105       message     = [ email / token ]
106                        ;; MUST be prepared in accordance with Section 2
108       UTF1        = %x00-3F / %x41-7F ;; less '@' (U+0040)
109       UTF2        = %xC2-DF UTF0
110       UTF3        = %xE0 %xA0-BF UTF0 / %xE1-EC 2(UTF0) /
114 Zeilenga                Anonymous SASL Mechanism                [Page 2]
116 INTERNET-DRAFT         draft-ietf-sasl-anon-02.txt          30 June 2003
119                     %xED %x80-9F UTF0 / %xEE-EF 2(UTF0)
120       UTF4        = %xF0 %x90-BF 2(UTF0) / %xF1-F3 3(UTF0) /
121                     %xF4 %x80-8F 2(UTF0)
122       UTF0        = %x80-BF
124       TCHAR       = UTF1 / UTF2 / UTF3 / UTF4
125                     ;; any UTF-8 encoded Unicode character
126                     ;; except '@' (U+0040)
128       email       = addr-spec
129                     ;; as defined in [IMAIL], except with no free
130                     ;; insertion of linear-white-space, and the
131                     ;; local-part MUST either be entirely enclosed in
132                     ;; quotes or entirely unquoted
134       token       = 1*255TCHAR
136   Note to implementors:
137       The <token> production is restricted to 255 UTF-8 encoded Unicode
138       characters.   As the encoding of a characters uses a sequence of 1
139       to 4 octets, a token may be long as 1020 octets.
142 2. The "trace" profile of "Stringprep"
144   This section defines the "trace" profile of [StringPrep].  This
145   profile is designed for use with the SASL ANONYMOUS Mechanism.
146   Specifically, the client MUST prepare the <message> production in
147   accordance with this profile.
149   The character repertoire of this profile is Unicode 3.2 [Unicode].
151   No mapping is required by this profile.
153   No Unicode normalization is required by this profile.
155   The list of unassigned code points for this profile is that provided
156   in appendix A of [RFC 3454].  Unassigned code points are not
157   prohibited.
159   Characters from the following tables of [StringPrep] are prohibited:
160       - C.2.1 (ASCII control characters)
161       - C.2.2 (Non-ASCII control characters)
162       - C.3 (Private use characters)
163       - C.4 (Non-character code points)
164       - C.5 (Surrogate codes)
165       - C.6 (Inappropriate for plain text)
166       - C.8 (Change display properties are deprecated)
170 Zeilenga                Anonymous SASL Mechanism                [Page 3]
172 INTERNET-DRAFT         draft-ietf-sasl-anon-02.txt          30 June 2003
175       - C.9 (Tagging characters)
177   No additional characters are prohibited.
179   This profile requires bidirectional character checking per Section 6
180   of [StringPrep].
183 3. Example
185   Here is a sample ANONYMOUS login between an IMAP client and server.
186   In this example, "C:" and "S:" indicate lines sent by the client and
187   server respectively.  If such lines are wrapped without a new "C:" or
188   "S:" label, then the wrapping is for editorial clarity and is not part
189   of the command.
191   Note that this example uses the IMAP profile [IMAP4] of SASL.  The
192   base64 encoding of challenges and responses, as well as the "+ "
193   preceding the responses are part of the IMAP4 profile, not part of
194   SASL itself.  Newer profiles of SASL will include the client message
195   with the AUTHENTICATE command itself so the extra round trip below
196   (the server response with an empty "+ ") can be eliminated.
198   In this example, the user's opaque identification token is "sirhc".
200       S: * OK IMAP4 server ready
201       C: A001 CAPABILITY
202       S: * CAPABILITY IMAP4 IMAP4rev1 AUTH=DIGEST-MD5 AUTH=ANONYMOUS
203       S: A001 OK done
204       C: A002 AUTHENTICATE ANONYMOUS
205       S: +
206       C: c2lyaGM=
207       S: A003 OK Welcome, trace information has been logged.
210 4. Security Considerations
212   The ANONYMOUS mechanism grants access to information by anyone.  For
213   this reason it should be disabled by default so the administrator can
214   make an explicit decision to enable it.
216   If the anonymous user has any write privileges, a denial of service
217   attack is possible by filling up all available space.  This can be
218   prevented by disabling all write access by anonymous users.
220   If anonymous users have read and write access to the same area, the
221   server can be used as a communication mechanism to anonymously
222   exchange information.  Servers which accept anonymous submissions
226 Zeilenga                Anonymous SASL Mechanism                [Page 4]
228 INTERNET-DRAFT         draft-ietf-sasl-anon-02.txt          30 June 2003
231   should implement the common "drop box" model which forbids anonymous
232   read access to the area where anonymous submissions are accepted.
234   If the anonymous user can run many expensive operations (e.g., an IMAP
235   SEARCH BODY command), this could enable a denial of service attack.
236   Servers are encouraged to reduce the priority of anonymous users or
237   limit their resource usage.
239   While servers may impose a limit on the number of anonymous users, it
240   is noted that such limits enable denial of service attacks and should
241   be used with caution.
243   The trace information is not authenticated so it can be falsified.
244   This can be used as an attempt to get someone else in trouble for
245   access to questionable information.  Administrators trying to trace
246   abuse need to realize this information may be falsified.
248   A client which uses the user's correct email address as trace
249   information without explicit permission may violate that user's
250   privacy.  Information about who accesses an anonymous archive on a
251   sensitive subject (e.g., sexual abuse) has strong privacy needs.
252   Clients should not send the email address without explicit permission
253   of the user and should offer the option of supplying no trace token --
254   thus only exposing the source IP address and time.  Anonymous proxy
255   servers could enhance this privacy, but would have to consider the
256   resulting potential denial of service attacks.
258   Anonymous connections are susceptible to man in the middle attacks
259   which view or alter the data transferred.  Clients and servers are
260   encouraged to support external integrity and encryption mechanisms.
262   Protocols which fail to require an explicit anonymous login are more
263   susceptible to break-ins given certain common implementation
264   techniques.  Specifically, Unix servers which offer user login may
265   initially start up as root and switch to the appropriate user id after
266   an explicit login command.  Normally such servers refuse all data
267   access commands prior to explicit login and may enter a restricted
268   security environment (e.g., the Unix chroot(2) function) for anonymous
269   users.  If anonymous access is not explicitly requested, the entire
270   data access machinery is exposed to external security attacks without
271   the chance for explicit protective measures.  Protocols which offer
272   restricted data access should not allow anonymous data access without
273   an explicit login step.
275   General [SASL] security considerations apply to this mechanism.
277   [StringPrep] security considerations as well as [Unicode] security
278   considerations discussed in [StringPrep] apply to this mechanism.
282 Zeilenga                Anonymous SASL Mechanism                [Page 5]
284 INTERNET-DRAFT         draft-ietf-sasl-anon-02.txt          30 June 2003
287   [UTF-8] security considerations also apply.
290 5. IANA Considerations
292   It is requested that the SASL Mechanism registry [IANA-SASL] entry for
293   the ANONYMOUS mechanism be updated to reflect that this document now
294   provides its technical specification.
296       To: iana@iana.org
297       Subject: Updated Registration of SASL mechanism ANONYMOUS
299       SASL mechanism name: ANONYMOUS
300       Security considerations: See RFC XXXX.
301       Published specification (optional, recommended): RFC XXXX
302       Person & email address to contact for further information:
303            Kurt Zeilenga <kurt@openldap.org>
304            Chris Neuman <chris.newman@innosoft.com>
305       Intended usage: COMMON
306       Author/Change controller: IESG <iesg@ietf.org>
307       Note: Updates existing entry for ANONYMOUS
310   It is requested that the [Stringprep] profile "trace", first defined
311   in this RFC, be registered:
313       To: iana@iana.org
314       Subject: Initial Registration of Stringprep "trace" profile
316       Stringprep profile: trace
317       Published specification: RFC XXXX
318       Person & email address to contact for further information:
319           Kurt Zeilenga <kurt@openldap.org>
322 6. Acknowledgment
324   This document is a revision of RFC 2245 by Chris Newman.  Portions of
325   the grammar defined in Section 1 were borrowed from [UTF-8] by
326   Francois Yergeau.
328   This document is a product of the IETF SASL WG.
331 7. Normative References
333   [ABNF]        Crocker, D. and P. Overell, "Augmented BNF for Syntax
334                 Specifications: ABNF", RFC 2234, November 1997.
338 Zeilenga                Anonymous SASL Mechanism                [Page 6]
340 INTERNET-DRAFT         draft-ietf-sasl-anon-02.txt          30 June 2003
343   [IMAIL]       Crocker, D., "Standard for the Format of Arpa Internet
344                 Text Messages", STD 11, RFC 822, August 1982.
346   [Keywords]    Bradner, S., "Key words for use in RFCs to Indicate
347                 Requirement Levels", BCP 14, RFC 2119, March 1997
349   [SASL]        Myers, J., "Simple Authentication and Security Layer
350                 (SASL)", draft-myers-saslrev-xx.txt, a work in progress.
352   [StringPrep]  Hoffman P. and M. Blanchet, "Preparation of
353                 Internationalized Strings ('stringprep')", RFC 3454,
354                 December 2002.
356   [Unicode]     The Unicode Consortium, "The Unicode Standard, Version
357                 3.2.0" is defined by "The Unicode Standard, Version 3.0"
358                 (Reading, MA, Addison-Wesley, 2000. ISBN 0-201-61633-5),
359                 as amended by the "Unicode Standard Annex #27: Unicode
360                 3.1" (http://www.unicode.org/reports/tr27/) and by the
361                 "Unicode Standard Annex #28: Unicode 3.2"
362                 (http://www.unicode.org/reports/tr28/).
364                 [UTF-8]       Yergeau, F., "UTF-8, a transformation
365                 format of ISO 10646", draft-yergeau-rfc2279bis, a work
366                 in progress.
369 8. Informative References
371   [IMAP4]       Crispin, M., "Internet Message Access Protocol - Version
372                 4rev1", RFC 2060, December 1996.
374   [IANA-SASL]   IANA, "SIMPLE AUTHENTICATION AND SECURITY LAYER (SASL)
375                 MECHANISMS", http://www.iana.org/assignments/sasl-
376                 mechanisms.
379 9. Editor's Address
381   Kurt Zeilenga
382   OpenLDAP Foundation
384   Email: kurt@OpenLDAP.org
387 Appendix A.  Changes since RFC 2245
389   This appendix is non-normative.
394 Zeilenga                Anonymous SASL Mechanism                [Page 7]
396 INTERNET-DRAFT         draft-ietf-sasl-anon-02.txt          30 June 2003
399   RFC 2245 allows the client to send optional trace information in the
400   form of a human readable string.  RFC 2245 restricted this string to
401   US-ASCII.  As the Internet is international, this document uses a
402   string restricted to UTF-8 encoded Unicode characters.  A "stringprep"
403   profile is defined to precisely define which Unicode characters are
404   allowed in this string.  While the string remains restricted to 255
405   characters, the encoded length of each character may now range from 1
406   to 4 octets.
408   Additionally, a number of editorial changes were made.
412 Intellectual Property Rights
414   The IETF takes no position regarding the validity or scope of any
415   intellectual property or other rights that might be claimed to pertain
416   to the implementation or use of the technology described in this
417   document or the extent to which any license under such rights might or
418   might not be available; neither does it represent that it has made any
419   effort to identify any such rights.  Information on the IETF's
420   procedures with respect to rights in standards-track and
421   standards-related documentation can be found in BCP-11.  Copies of
422   claims of rights made available for publication and any assurances of
423   licenses to be made available, or the result of an attempt made to
424   obtain a general license or permission for the use of such proprietary
425   rights by implementors or users of this specification can be obtained
426   from the IETF Secretariat.
428   The IETF invites any interested party to bring to its attention any
429   copyrights, patents or patent applications, or other proprietary
430   rights which may cover technology that may be required to practice
431   this standard.  Please address the information to the IETF Executive
432   Director.
436 Full Copyright
438   Copyright (C) The Internet Society (2003). All Rights Reserved.
440   This document and translations of it may be copied and furnished to
441   others, and derivative works that comment on or otherwise explain it
442   or assist in its implmentation may be prepared, copied, published and
443   distributed, in whole or in part, without restriction of any kind,
444   provided that the above copyright notice and this paragraph are
445   included on all such copies and derivative works.  However, this
446   document itself may not be modified in any way, such as by removing
450 Zeilenga                Anonymous SASL Mechanism                [Page 8]
452 INTERNET-DRAFT         draft-ietf-sasl-anon-02.txt          30 June 2003
455   the copyright notice or references to the Internet Society or other
456   Internet organizations, except as needed for the  purpose of
457   developing Internet standards in which case the procedures for
458   copyrights defined in the Internet Standards process must be followed,
459   or as required to translate it into languages other than English.
506 Zeilenga                Anonymous SASL Mechanism                [Page 9]