git.sur5r.net Git - openldap/blob - doc/drafts/draft-zeilenga-ldap-features-xx.txt

   1
   2
   3
   4
   5
   6
   7 INTERNET-DRAFT                                      Kurt D. Zeilenga
   8 Intended Category: Standard Track                   OpenLDAP Foundation
   9 Expires: 26 December 2001                           26 June 2001
  10
  11
  12                         Feature Discovery in LDAP
  13                   <draft-zeilenga-ldap-features-01.txt>
  14
  15
  16 Status of this Memo
  17
  18   This document is an Internet-Draft and is in full conformance with all
  19   provisions of Section 10 of RFC2026.
  20
  21   This document is intended to be, after appropriate review and
  22   revision, submitted to the RFC Editor as an Standard Track document.
  23   Distribution of this memo is unlimited.  Technical discussion of this
  24   document will take place on the IETF LDAP Extension Working Group
  25   mailing list <ietf-ldapext@netscape.com>.  Please send editorial
  26   comments directly to the author <Kurt@OpenLDAP.org>.
  27
  28   Internet-Drafts are working documents of the Internet Engineering Task
  29   Force (IETF), its areas, and its working groups.  Note that other
  30   groups may also distribute working documents as Internet-Drafts.
  31   Internet-Drafts are draft documents valid for a maximum of six months
  32   and may be updated, replaced, or obsoleted by other documents at any
  33   time.  It is inappropriate to use Internet-Drafts as reference
  34   material or to cite them other than as ``work in progress.''
  35
  36   The list of current Internet-Drafts can be accessed at
  37   <http://www.ietf.org/ietf/1id-abstracts.txt>. The list of
  38   Internet-Draft Shadow Directories can be accessed at
  39   <http://www.ietf.org/shadow.html>.
  40
  41   Copyright 2001, The Internet Society.  All Rights Reserved.
  42
  43   Please see the Copyright section near the end of this document for
  44   more information.
  45
  46
  47 1. Overview
  48
  49   LDAP [RFC2251] is an extensible protocol with numerous elective
  50   features.  LDAP provides mechanisms for a client to discover supported
  51   protocol versions, controls, extended operations, SASL mechanisms, and
  52   subschema information.  However, these mechanisms are not designed to
  53   support general feature discovery.
  54
  55
  56
  57
  58 Zeilenga             draft-zeilenga-ldap-features-01            [Page 1]
  59 \f
  60 INTERNET-DRAFT           LDAP supportedFeatures             26 June 2001
  61
  62
  63   This document describes a simple, general-purpose mechanism which
  64   clients may use to discovery the set of features supported by a
  65   server.
  66
  67   The key words ``MUST'', ``MUST NOT'', ``REQUIRED'', ``SHALL'', ``SHALL
  68   NOT'', ``SHOULD'', ``SHOULD NOT'', ``RECOMMENDED'',  and ``MAY'' in
  69   this document are to be interpreted as described in RFC 2119
  70   [RFC2119].
  71
  72
  73 2. Discovery of supported features
  74
  75   Each feature whose support may be discovered SHALL be identified by an
  76   Object Identifier (OID).  A server advertises its support for a given
  77   feature by providing the OID associated with the feature as a value of
  78   the supportedFeatures attribute held in the root DSE.  A client may
  79   examine the values of this attribute to determine if a particular
  80   feature is supported by the server.
  81
  82   The supportedFeatures attribute type is described [RFC2252] as
  83   follows:
  84
  85       ( 1.3.6.1.4.1.4203.1.3.5
  86         NAME 'supportedFeatures'
  87         DESC 'features supported by the server'
  88         EQUALITY objectIdentifierMatch
  89         SYNTAX 1.3.6.1.4.1.1466.115.121.1.38
  90         USAGE dSAOperation )
  91
  92
  93 3. Security Considerations
  94
  95   As rogue clients can discover features of a server by other means
  96   (such as by trial and error), this feature discovery mechanism is not
  97   believed to introduce any new security risk to LDAP.
  98
  99
 100 4. Acknowledgment
 101
 102   This document is based upon input from the IETF LDAPext working group.
 103
 104
 105 5. Author's Address
 106
 107   Kurt D. Zeilenga
 108   OpenLDAP Foundation
 109   <Kurt@OpenLDAP.org>
 110
 111
 112
 113
 114 Zeilenga             draft-zeilenga-ldap-features-01            [Page 2]
 115 \f
 116 INTERNET-DRAFT           LDAP supportedFeatures             26 June 2001
 117
 118
 119 References
 120
 121   [RFC2219] S. Bradner, "Key words for use in RFCs to Indicate
 122             Requirement Levels", RFC 2119, March 1997.
 123
 124   [RFC2251] M. Wahl, T. Howes, S. Kille, "Lightweight Directory Access
 125             Protocol (v3)", RFC 2251, December 1997.
 126
 127   [RFC2252] M. Wahl, A. Coulbeck, T. Howes, S. Kille, "Lightweight
 128             Directory Access Protocol (v3):  Attribute Syntax
 129             Definitions", RFC 2252, December 1997.
 130
 131
 132 Full Copyright
 133
 134   Copyright 2001, The Internet Society.  All Rights Reserved.
 135
 136   This document and translations of it may be copied and furnished to
 137   others, and derivative works that comment on or otherwise explain it
 138   or assist in its implementation may be prepared, copied, published and
 139   distributed, in whole or in part, without restriction of any kind,
 140   provided that the above copyright notice and this paragraph are
 141   included on all such copies and derivative works.  However, this
 142   document itself may not be modified in any way, such as by removing
 143   the copyright notice or references to the Internet Society or other
 144   Internet organizations, except as needed for the  purpose of
 145   developing Internet standards in which case the procedures for
 146   copyrights defined in the Internet Standards process must be followed,
 147   or as required to translate it into languages other than English.
 148
 149   The limited permissions granted above are perpetual and will not be
 150   revoked by the Internet Society or its successors or assigns.
 151
 152   This document and the information contained herein is provided on an
 153   "AS IS" basis and THE AUTHORS, THE INTERNET SOCIETY, AND THE INTERNET
 154   ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED,
 155   INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
 156   INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
 157   WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
 158
 159
 160
 161
 162
 163
 164
 165
 166
 167
 168
 169
 170 Zeilenga             draft-zeilenga-ldap-features-01            [Page 3]
 171 \f