idnits 2.17.1 draft-ietf-asid-ldapv3-protocol-05.txt: ** The Abstract section seems to be numbered Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** Cannot find the required boilerplate sections (Copyright, IPR, etc.) in this document. Expected boilerplate is as follows today (2024-04-19) according to https://trustee.ietf.org/license-info : IETF Trust Legal Provisions of 28-dec-2009, Section 6.a: This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 2: Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 3: This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- ** Missing expiration date. The document expiration date should appear on the first and last page. ** The document seems to lack a 1id_guidelines paragraph about Internet-Drafts being working documents. ** The document seems to lack a 1id_guidelines paragraph about the list of current Internet-Drafts. ** The document seems to lack a 1id_guidelines paragraph about the list of Shadow Directories. == The page length should not exceed 58 lines per page, but there was 41 longer pages, the longest (page 2) being 59 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) ** There are 56 instances of too long lines in the document, the longest one being 2 characters in excess of 72. ** The document seems to lack a both a reference to RFC 2119 and the recommended RFC 2119 boilerplate, even if it appears to use RFC 2119 keywords. RFC 2119 keyword, line 115: '...e distinguished name (RDN), which MUST...' RFC 2119 keyword, line 129: '...ing or shadowing MUST ensure that they...' RFC 2119 keyword, line 163: '... Each entry MUST have an objectClass...' RFC 2119 keyword, line 182: '... Servers MUST NOT permit clients to ...' RFC 2119 keyword, line 190: '... Entries MAY contain, among others, ...' (125 more instances...) Miscellaneous warnings: ---------------------------------------------------------------------------- == Line 28 has weird spacing: '...listing conta...' -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (5 June 1997) is 9815 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) -- Missing reference section? '1' on line 2107 looks like a reference -- Missing reference section? '2' on line 2045 looks like a reference -- Missing reference section? '5' on line 2029 looks like a reference -- Missing reference section? '6' on line 2030 looks like a reference -- Missing reference section? '3' on line 2046 looks like a reference -- Missing reference section? '11' on line 2112 looks like a reference -- Missing reference section? '0' on line 2106 looks like a reference -- Missing reference section? '13' on line 1820 looks like a reference -- Missing reference section? '14' on line 1823 looks like a reference -- Missing reference section? '4' on line 2047 looks like a reference -- Missing reference section? '15' on line 1826 looks like a reference -- Missing reference section? '7' on line 2031 looks like a reference -- Missing reference section? '9' on line 2033 looks like a reference -- Missing reference section? 'APPLICATION 0' on line 1987 looks like a reference -- Missing reference section? '12' on line 1817 looks like a reference -- Missing reference section? '8' on line 2032 looks like a reference -- Missing reference section? 'APPLICATION 1' on line 2001 looks like a reference -- Missing reference section? 'APPLICATION 2' on line 2005 looks like a reference -- Missing reference section? 'APPLICATION 3' on line 2006 looks like a reference -- Missing reference section? 'APPLICATION 4' on line 2049 looks like a reference -- Missing reference section? 'APPLICATION 19' on line 2057 looks like a reference -- Missing reference section? 'APPLICATION 5' on line 2059 looks like a reference -- Missing reference section? 'APPLICATION 6' on line 2060 looks like a reference -- Missing reference section? 'APPLICATION 7' on line 2073 looks like a reference -- Missing reference section? 'APPLICATION 8' on line 2075 looks like a reference -- Missing reference section? 'APPLICATION 9' on line 2083 looks like a reference -- Missing reference section? 'APPLICATION 10' on line 2085 looks like a reference -- Missing reference section? 'APPLICATION 11' on line 2087 looks like a reference -- Missing reference section? 'APPLICATION 12' on line 2089 looks like a reference -- Missing reference section? 'APPLICATION 13' on line 2095 looks like a reference -- Missing reference section? 'APPLICATION 14' on line 2097 looks like a reference -- Missing reference section? 'APPLICATION 15' on line 2101 looks like a reference -- Missing reference section? 'APPLICATION 16' on line 2103 looks like a reference -- Missing reference section? 'APPLICATION 23' on line 2105 looks like a reference -- Missing reference section? 'APPLICATION 24' on line 2109 looks like a reference -- Missing reference section? '10' on line 2111 looks like a reference Summary: 9 errors (**), 0 flaws (~~), 2 warnings (==), 38 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 Network Working Group M. Wahl 2 INTERNET-DRAFT Critical Angle Inc. 3 Replaces: RFC 1777 T. Howes 4 Netscape Communications Corp. 5 S. Kille 6 Isode Limited 7 Expires in six months from 5 June 1997 8 Intended Category: Standards Track 10 Lightweight Directory Access Protocol (v3) 11 13 Table of Contents - see end of document. 15 1. Status of this Memo 17 This document is an Internet-Draft. Internet-Drafts are working 18 documents of the Internet Engineering Task Force (IETF), its areas, and 19 its working groups. Note that other groups may also distribute working 20 documents as Internet-Drafts. 22 Internet-Drafts are draft documents valid for a maximum of six months 23 and may be updated, replaced, or obsoleted by other documents at any 24 time. It is inappropriate to use Internet-Drafts as reference material 25 or to cite them other than as "work in progress." 27 To learn the current status of any Internet-Draft, please check the 28 "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow 29 Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe), 30 ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim). 32 2. Abstract 34 The protocol described in this document is designed to provide access 35 to directories supporting the X.500 models, while not incurring the 36 resource requirements of the X.500 Directory Access Protocol (DAP). 37 This protocol is specifically targeted at management applications and 38 browser applications that provide read/write interactive access to 39 directories. When used with a directory supporting the X.500 40 protocols, it is intended to be a complement to the X.500 DAP. 42 Key aspects of this version of LDAP are: 44 - All protocol elements of LDAPv2 (RFC 1777) are supported. The 45 protocol is carried directly over TCP or other transport, bypassing 46 much of the session/presentation overhead of X.500 DAP. 48 - Most protocol data elements can be encoded as ordinary strings 49 (e.g., Distinguished Names). 51 - Referrals to other servers may be returned. 53 - SASL and TLS mechanisms may be used with LDAP to provide association 54 security services. 56 - Attribute values and Distinguished Names have been internationalized 57 through the use of the ISO 10646 character set. 59 - The protocol can be extended to support new operations, and controls 60 may be used to extend existing operations. 62 - Schema may be published in the directory for use by clients. 64 3. Models 66 Interest in X.500 [1] directory technologies in the Internet has led 67 to efforts to reduce the high cost of entry associated with use of 68 these technologies. This document continues the efforts to define 69 directory protocol alternatives, updating the LDAP [2] protocol 70 specification. 72 3.1. Protocol Model 74 The general model adopted by this protocol is one of clients 75 performing protocol operations against servers. In this model, a 76 client transmits a protocol request describing the operation to be 77 performed to a server. The server is then responsible for performing 78 the necessary operation(s) in the directory. Upon completion of 79 the operation(s), the server returns a response containing any results 80 or errors to the requesting client. 82 In keeping with the goal of easing the costs associated with use of 83 the directory, it is an objective of this protocol to minimize the 84 complexity of clients so as to facilitate widespread deployment of 85 applications capable of using the directory. 87 Note that although servers are required to return responses whenever 88 such responses are defined in the protocol, there is no requirement 89 for synchronous behavior on the part of either clients or servers. 90 Requests and responses for multiple operations may be exchanged 91 between a client and server in any order, provided the client 92 eventually receives a response for every request that requires one. 94 In LDAP versions 1 and 2, no provision was made for protocol servers 95 returning referrals to clients. However, for improved performance and 96 distribution this version of the protocol permits servers to return to 97 clients referrals to other servers. This allows servers to offload 98 the work of contacting other servers to progress operations. 100 Note that the core protocol operations defined in this document can be 101 mapped to a strict subset of the X.500(1997) directory abstract 102 service, so it can be cleanly provided by the DAP. However there is 103 not a one-to-one mapping between LDAP protocol operations and DAP 104 operations: server implementations acting as a gateway to X.500 105 directories may need to make multiple DAP requests. 107 3.2. Data Model 109 This section provides a brief introduction to the X.500 data model, as 110 used by LDAP. 112 The LDAP protocol assumes there are one or more servers which jointly 113 provide access to a Directory Information Tree (DIT). The tree is 114 made up of entries. Entries have names: one or more attribute values 115 from the entry form its relative distinguished name (RDN), which MUST 116 be unique among all its siblings. The concatenation of the relative 117 distinguished names of the sequence of entries from a particular 118 entry to an immediate subordinate of the root of the tree forms that 119 entry's Distinguished Name (DN), which is unique in the tree. An 120 example of a Distinguished Name is 122 CN=Steve Kille, O=Isode Limited, C=GB 124 Some servers may hold cache or shadow copies of entries, which can be 125 used to answer search and comparison queries, but will return 126 referrals or contact other servers if modification operations are 127 requested. 129 Servers which perform caching or shadowing MUST ensure that they do 130 not violate any access control constraints placed on the data by the 131 originating server. 133 The largest collection of entries, starting at an entry that is 134 mastered by a particular server, and including all its subordinates 135 and their subordinates, down to the entries which are mastered by 136 different servers, is termed a naming context. The root of the DIT 137 is a DSA-specific Entry (DSE) and not part of any naming context: 138 each server has different attribute values in the root DSE. (DSA is 139 an X.500 term for the directory server). 141 3.2.1. Attributes of Entries 143 Entries consist of a set of attributes. An attribute is a type with 144 one or more associated values. The attribute type is identified by a 145 short descriptive name and an OID (object identifier). The attribute 146 type governs whether there can be more than one value of an 147 attribute of that type in an entry, the syntax to which the values 148 must conform, the kinds of matching which can be performed on values 149 of that attribute, and other functions. 151 An example of an attribute is "mail". There may be one or more values 152 of this attribute, they must be IA5 (ASCII) strings, and they are 153 case insensitive (e.g. "foo@bar.com" will match "FOO@BAR.COM"). 155 Schema is the collection of attribute type definitions, object class 156 definitions and other information which a server uses to determine 157 how to match a filter or attribute value assertion (in a compare 158 operation) against the attributes of an entry, and whether to permit 159 add and modify operations. The definition of schema for use with 160 LDAP is given in [5] and [6]. Additional schema elements may be 161 defined in other documents. 163 Each entry MUST have an objectClass attribute. The objectClass 164 attribute specifies the object classes of an entry, which along with 165 the system and user schema determine the permitted attributes of an 166 entry. Values of this attribute may be modified by clients, but the 167 objectClass attribute cannot be removed. Servers may restrict the 168 modifications of this attribute to prevent the basic structural 169 class of the entry from being changed (e.g. one cannot change a 170 person into a country). When creating an entry or adding an 171 objectClass value to an entry, all superclasses of the named classes 172 are implicitly added as well if not already present, and the client 173 must supply values for any mandatory attributes of new superclasses. 175 Some attributes, termed operational attributes, are used by servers 176 for administering the directory system itself. They are not returned 177 in search results unless explicitly requested by name. Attributes 178 which are not operational, such as "mail", will have their schema and 179 syntax constraints enforced by servers, but servers will generally 180 not make use of their values. 182 Servers MUST NOT permit clients to add attributes to an entry unless 183 those attributes are permitted by the object class definitions, the 184 schema controlling that entry (specified in the subschema - see 185 below), or are operational attributes known to that server and used 186 for administrative purposes. Note that there is a particular 187 objectClass 'extensibleObject' defined in [5] which permits all user 188 attributes to be present in an entry. 190 Entries MAY contain, among others, the following operational 191 attributes, defined in [5]. These attributes are maintained 192 automatically by the server and are not modifiable by clients: 194 - creatorsName: the Distinguished Name of the user who added this 195 entry to the directory. 197 - createTimestamp: the time this entry was added to the directory. 199 - modifiersName: the Distinguished Name of the user who last modified 200 this entry. 202 - modifyTimestamp: the time this entry was last modified. 204 - subschemaSubentry: the Distinguished Name of the subschema entry 205 (or subentry) which controls the schema for this entry. 207 3.2.2. Subschema Entries and Subentries 209 Subschema entries are used for administering information about the 210 directory schema, in particular the object classes and attribute types 211 supported by directory servers. A single subschema entry contains 212 all schema definitions used by entries in a particular part of the 213 directory tree. 215 Servers which follow X.500(93) models SHOULD implement subschema 216 using the X.500 subschema mechanisms, and so these subschemas are not 217 ordinary entries. LDAP clients SHOULD NOT assume that servers 218 implement any of the other aspects of X.500 subschema. 220 A server which masters entries and permits clients to modify these 221 entries MUST implement and provide access to these subschema entries, 222 so that its clients may discover the attributes and object classes 223 which are permitted to be present. It is strongly recommended that 224 all other servers implement this as well. 226 The following four attributes MUST be present in all subschema 227 entries: 229 - cn: this attribute MUST be used to form the RDN of the subschema 230 entry. 232 - objectClass: the attribute MUST have at least the values "top" and 233 "subschema". 235 - objectClasses: each value of this attribute specifies an object 236 class known to the server. 238 - attributeTypes: each value of this attribute specifies an attribute 239 type known to the server. 241 These are defined in [5]. Other attributes MAY be present in subschema 242 entries, to reflect additional supported capabilities. These include 243 matchingRules, matchingRuleUse, dITStructureRules, dITContentRules, 244 nameForms and ldapSyntaxes. 246 Servers SHOULD provide the attributes createTimestamp and 247 modifyTimestamp in subschema entries, in order to allow clients to 248 maintain their caches of schema information. 250 Clients MUST only retrieve attributes from a subschema entry by 251 requesting a base object search of the entry, where the search filter 252 is "(objectClass=subschema)". (This will allow LDAPv3 servers which 253 gateway to X.500(93) to detect that subentry information is being 254 requested.) 256 3.3. Relationship to X.500 258 This document defines LDAP in terms of X.500 as an X.500 access 259 mechanism. An LDAP server MUST act in accordance with the 260 X.500(1993) series of ITU recommendations when providing the service. 261 However, it is not required that an LDAP server make use of any X.500 262 protocols in providing this service, e.g. LDAP can be mapped onto any 263 other directory system so long as the X.500 data and service model as 264 used in LDAP is not violated in the LDAP interface. 266 3.4. Server-specific Data Requirements 268 An LDAP server MUST provide information about itself and other 269 information that is specific to each server. This is represented as 270 a group of attributes located in the root DSE (DSA-Specific Entry), 271 which is named with the zero-length LDAPDN. These attributes 272 are retrievable if a client performs a base object search of the 273 root with filter "(objectClass=*)", however they are subject to 274 access control restrictions. 276 The root DSE MUST NOT be included if the client performs a subtree 277 search starting from the root. 279 Servers may allow clients to modify these attributes. 281 The following attributes of the root DSE are defined in section 5 282 of [5]. Additional attributes may be defined in other documents. 284 - namingContexts: naming contexts held in the server. Naming contexts 285 are defined in section 17 of X.501 [6]. 287 - subschemaSubentry: subschema entries (or subentries) known by this 288 server. 290 - altServer: alternative servers in case this one is later 291 unavailable. 293 - supportedExtension: list of supported extended operations. 295 - supportedControl: list of supported controls. 297 - supportedSASLMechanisms: list of supported SASL security features. 299 - supportedLDAPVersion: LDAP versions implemented by the server. 301 If the server does not master entries and does not know the locations 302 of schema information, the subschemaSubentry attribute is not present 303 in the root DSE. If the server masters directory entries under one or 304 more schema rules, there may be any number of values of the 305 subschemaSubentry attribute in the root DSE. 307 4. Elements of Protocol 309 The LDAP protocol is described using Abstract Syntax Notation 1 310 (ASN.1) [3], and is typically transferred using a subset of ASN.1 311 Basic Encoding Rules [11]. In order to support future extensions to 312 this protocol, clients and servers MUST ignore elements of SEQUENCEs 313 whose tags they do not recognize. 315 Note that unlike X.500, each change to the LDAP protocol other than 316 through the extension mechanisms will have a different version 317 number. A client will indicate the version it supports as part of 318 the bind request, described in section 4.2. If a client has not sent 319 a bind, the server MUST assume that version 3 is supported in the 320 client (since version 2 required that the client bind first). 322 Clients may determine the protocol version a server supports by 323 reading the supportedLDAPVersion attribute from the root DSE. 324 Servers which implement version 3 or later versions MUST provide this 325 attribute. Servers which only implement version 2 may not provide 326 this attribute. 328 4.1. Common Elements 330 This section describes the LDAPMessage envelope PDU (Protocol Data 331 Unit) format, as well as data type definitions which are used in the 332 protocol operations. 334 4.1.1. Message Envelope 336 For the purposes of protocol exchanges, all protocol operations are 337 encapsulated in a common envelope, the LDAPMessage, which is defined 338 as follows: 340 LDAPMessage ::= SEQUENCE { 341 messageID MessageID, 342 protocolOp CHOICE { 343 bindRequest BindRequest, 344 bindResponse BindResponse, 345 unbindRequest UnbindRequest, 346 searchRequest SearchRequest, 347 searchResEntry SearchResultEntry, 348 searchResDone SearchResultDone, 349 searchResRef SearchResultReference, 350 modifyRequest ModifyRequest, 351 modifyResponse ModifyResponse, 352 addRequest AddRequest, 353 addResponse AddResponse, 354 delRequest DelRequest, 355 delResponse DelResponse, 356 modDNRequest ModifyDNRequest, 357 modDNResponse ModifyDNResponse, 358 compareRequest CompareRequest, 359 compareResponse CompareResponse, 360 abandonRequest AbandonRequest, 361 extendedReq ExtendedRequest, 362 extendedResp ExtendedResponse }, 363 controls [0] Controls OPTIONAL } 365 MessageID ::= INTEGER (0 .. maxInt) 367 maxInt INTEGER ::= 2147483647 -- (2^^31 - 1) -- 369 The function of the LDAPMessage is to provide an envelope containing 370 common fields required in all protocol exchanges. At this time the 371 only common fields are the message ID and the controls. 373 If the server receives a PDU from the client in which the LDAPMessage 374 SEQUENCE tag cannot be recognized, the messageID cannot be parsed, 375 the tag of the protocolOp is not recognized as a request, or the 376 encoding structures or lengths of data fields are found to be 377 incorrect, then the server MUST return the notice of disconnection 378 described in section 4.4.1, with resultCode protocolError, and 379 immediately close the connection. In other cases that the server 380 cannot parse the request received by the client, the server MUST 381 return an appropriate response to the request, with the resultCode 382 set to protocolError. 384 If the client receives a PDU from the server which cannot be parsed, 385 the client may discard the PDU, or may abruptly close the connection. 387 The ASN.1 type Controls is defined in section 4.1.12. 389 4.1.1.1. Message ID 391 All LDAPMessage envelopes encapsulating responses contain the 392 messageID value of the corresponding request LDAPMessage. 394 The message ID of a request MUST have a value different from the 395 values of any other requests outstanding in the LDAP session of which 396 this message is a part. 398 A client MUST NOT send a second request with the same message ID as 399 an earlier request on the same connection if the client has not 400 received the final response from the earlier request. Otherwise the 401 behavior is undefined. Typical clients increment a counter for each 402 request. 404 A client MUST NOT reuse the message id of an abandonRequest or of the 405 abandoned operation until it has received a response from the server 406 for another request invoked subsequent to the abandonRequest, as the 407 abandonRequest itself does not have a response. 409 4.1.2. String Types 411 The LDAPString is a notational convenience to indicate that, although 412 strings of LDAPString type encode as OCTET STRING types, the ISO 10646 413 [13] character set (a superset of Unicode) is used, encoded following 414 the UTF-8 algorithm [14]. Note that in the UTF-8 algorithm characters 415 which are the same as ASCII (0x0000 through 0x007F) are represented 416 as that same ASCII character in a single byte. The other byte values 417 are used to form a variable-length encoding of an arbitrary character. 419 LDAPString ::= OCTET STRING 421 The LDAPOID is a notational convenience to indicate that the permitted 422 value of this string is a (UTF-8 encoded) dotted-decimal 423 representation of an OBJECT IDENTIFIER. 425 LDAPOID ::= OCTET STRING 427 For example, 429 1.3.6.1.4.1.1466.1.2.3 431 4.1.3. Distinguished Name and Relative Distinguished Name 433 An LDAPDN and a RelativeLDAPDN are respectively defined to be the 434 representation of a Distinguished Name and a Relative Distinguished 435 Name after encoding according to the specification in [4], such that 437 ::= 439 ::= 441 where and are as defined in [4]. 443 LDAPDN ::= LDAPString 445 RelativeLDAPDN ::= LDAPString 447 Only Attribute Types can be present in a relative distinguished name 448 component; the options of Attribute Descriptions (next section) 449 MUST NOT be used in specifying distinguished names. 451 4.1.4. Attribute Type 453 An AttributeType takes on as its value the textual string associated 454 with that AttributeType in its specification. 456 AttributeType ::= LDAPString 458 Each attribute type has a unique OBJECT IDENTIFIER which has been 459 assigned to it. This identifier may be written as decimal digits 460 with components separated by periods, e.g. "2.5.4.10". 462 A specification may also assign one or more textual names for an 463 attribute type. These names MUST begin with a letter, and only 464 contain ASCII letters, digit characters and hyphens. They are case 465 insensitive. (These ASCII characters are identical to ISO 10646 466 characters whose UTF-8 encoding is a single byte between 0x00 and 467 0x7F.) 469 If the server has a textual name for an attribute type, it MUST use 470 that name for attributes returned in search results. The dotted- 471 decimal OBJECT IDENTIFIER is only used if there is no textual name 472 for an attribute type. 474 Attribute type names are non-unique, as two different specifications 475 may choose the same name. 477 A server which masters or shadows entries SHOULD list all the 478 attribute types it supports in the subschema entries, using the 479 attributeTypes attribute. Servers which support an open-ended set of 480 attributes SHOULD include at least the attributeTypes value for the 481 'objectClass' attribute. Clients MAY retrieve the attributeTypes 482 value from subschema entries in order to obtain the OBJECT IDENTIFIER 483 and other information associated with attribute types. 485 Some attribute type names which are used in this version of LDAP are 486 described in [5]. Servers may implement additional attribute types. 488 4.1.5. Attribute Description 490 An AttributeDescription is a superset of the definition of the 491 AttributeType. It has the same ASN.1 definition, but allows 492 additional options to be specified. They are also case insensitive. 494 AttributeDescription ::= LDAPString 496 A value of AttributeDescription is based on the following BNF: 498 ::= [ ";" ] 500 ::=