INTERNET-DRAFT Editor: A. Sciberras Intended Category: Standard Track eB2Bcom Updates: RFC 2247, RFC 2798, RFC 2377 July 11, 2005 Obsoletes: RFC 2256 LDAP: Schema for User Applications draft-ietf-ldapbis-user-schema-10.txt Copyright (C) The Internet Society (2005). All Rights Reserved. Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. By submitting this Internet-Draft, I accept the provisions of Section 3 of BCP 78. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress". The list of current Internet-Drafts can be accessed at http://www.ietf.org/1id-abstracts.html The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html This document is intended to be, after appropriate review and revision, submitted to the RFC Editor as a Standard Track document. Distribution of this document is unlimited. Technical discussion of this document should take place on the IETF LDAP Revision Working Group (LDAPbis) mailing list . Please send editorial comments directly to the editor . This Internet-Draft expires on 11 January 2006. Sciberras Expires 11 January 2006 [Page 1] INTERNET-DRAFT LDAP: Schema for User Applications July 11, 2005 Abstract This document is an integral part of the Lightweight Directory Access Protocol (LDAP) technical specification [Roadmap]. It provides a technical specification of attribute types and object classes intended for use by LDAP directory clients for many directory services, such as, White Pages. These objects are widely used as a basis for the schema in many LDAP directories. This document does not cover attributes used for the administration of directory servers, nor does it include directory objects defined for specific uses in other documents. Sciberras Expires 11 January 2006 [Page 2] INTERNET-DRAFT LDAP: Schema for User Applications July 11, 2005 Table of Contents Status of this Memo . . . . . . . . . . . . . . . . . . . . . . . 1 Copyright Notice. . . . . . . . . . . . . . . . . . . . . . . . . 1 Abstract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . 3 1. Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 5 1.1 Relationship with other specifications . . . . . . . . . 5 1.2 Conventions. . . . . . . . . . . . . . . . . . . . . . . 5 1.3 General Issues . . . . . . . . . . . . . . . . . . . . . 5 2. Attribute Types . . . . . . . . . . . . . . . . . . . . . . . 6 2.1 'businessCategory' . . . . . . . . . . . . . . . . . . . 6 2.2 'c'. . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.3 'cn' . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.4 'dc' . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.5 'description'. . . . . . . . . . . . . . . . . . . . . . 8 2.6 'destinationIndicator' . . . . . . . . . . . . . . . . . 8 2.7 'distinguishedName'. . . . . . . . . . . . . . . . . . . 8 2.8 'dnQualifier'. . . . . . . . . . . . . . . . . . . . . . 9 2.9 'enhancedSearchGuide'. . . . . . . . . . . . . . . . . . 9 2.10 'facsimileTelephoneNumber' . . . . . . . . . . . . . . . 10 2.11 'generationQualifier'. . . . . . . . . . . . . . . . . . 10 2.12 'givenName'. . . . . . . . . . . . . . . . . . . . . . . 10 2.13 'houseIdentifier'. . . . . . . . . . . . . . . . . . . . 11 2.14 'initials' . . . . . . . . . . . . . . . . . . . . . . . 11 2.15 'internationalISDNNumber'. . . . . . . . . . . . . . . . 11 2.16 'l'. . . . . . . . . . . . . . . . . . . . . . . . . . . 12 2.17 'member' . . . . . . . . . . . . . . . . . . . . . . . . 12 2.18 'name' . . . . . . . . . . . . . . . . . . . . . . . . . 12 2.19 'o'. . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2.20 'ou' . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2.21 'owner'. . . . . . . . . . . . . . . . . . . . . . . . . 13 2.22 'physicalDeliveryOfficeName' . . . . . . . . . . . . . . 13 2.23 'postalAddress'. . . . . . . . . . . . . . . . . . . . . 14 2.24 'postalCode' . . . . . . . . . . . . . . . . . . . . . . 14 2.25 'postOfficeBox'. . . . . . . . . . . . . . . . . . . . . 14 2.26 'preferredDeliveryMethod'. . . . . . . . . . . . . . . . 15 2.27 'registeredAddress'. . . . . . . . . . . . . . . . . . . 15 2.28 'roleOccupant' . . . . . . . . . . . . . . . . . . . . . 16 2.29 'searchGuide'. . . . . . . . . . . . . . . . . . . . . . 16 2.30 'seeAlso'. . . . . . . . . . . . . . . . . . . . . . . . 16 2.31 'serialNumber' . . . . . . . . . . . . . . . . . . . . . 17 2.32 'sn' . . . . . . . . . . . . . . . . . . . . . . . . . . 17 2.33 'st' . . . . . . . . . . . . . . . . . . . . . . . . . . 17 2.34 'street' . . . . . . . . . . . . . . . . . . . . . . . . 18 2.35 'telephoneNumber'. . . . . . . . . . . . . . . . . . . . 18 2.36 'teletexTerminalIdentifier'. . . . . . . . . . . . . . . 18 Sciberras Expires 11 January 2006 [Page 3] INTERNET-DRAFT LDAP: Schema for User Applications July 11, 2005 2.37 'telexNumber'. . . . . . . . . . . . . . . . . . . . . . 19 2.38 'title'. . . . . . . . . . . . . . . . . . . . . . . . . 19 2.39 'uid'. . . . . . . . . . . . . . . . . . . . . . . . . . 19 2.40 'uniqueMember' . . . . . . . . . . . . . . . . . . . . . 19 2.41 'userPassword' . . . . . . . . . . . . . . . . . . . . . 20 2.42 'x121Address'. . . . . . . . . . . . . . . . . . . . . . 21 2.43 'x500UniqueIdentifier' . . . . . . . . . . . . . . . . . 21 3. Object Classes. . . . . . . . . . . . . . . . . . . . . . . . 22 3.1 'applicationProcess' . . . . . . . . . . . . . . . . . . 22 3.2 'country'. . . . . . . . . . . . . . . . . . . . . . . . 22 3.3 'dcObject' . . . . . . . . . . . . . . . . . . . . . . . 22 3.4 'device' . . . . . . . . . . . . . . . . . . . . . . . . 23 3.5 'groupOfNames' . . . . . . . . . . . . . . . . . . . . . 23 3.6 'groupOfUniqueNames' . . . . . . . . . . . . . . . . . . 23 3.7 'locality' . . . . . . . . . . . . . . . . . . . . . . . 24 3.8 'organization' . . . . . . . . . . . . . . . . . . . . . 24 3.9 'organizationalPerson' . . . . . . . . . . . . . . . . . 24 3.10 'organizationalRole' . . . . . . . . . . . . . . . . . . 25 3.11 'organizationalUnit' . . . . . . . . . . . . . . . . . . 25 3.12 'person' . . . . . . . . . . . . . . . . . . . . . . . . 26 3.13 'residentialPerson'. . . . . . . . . . . . . . . . . . . 26 3.14 'uidObject'. . . . . . . . . . . . . . . . . . . . . . . 26 4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 27 5. Security Considerations . . . . . . . . . . . . . . . . . . . 28 6. Acknowledgements. . . . . . . . . . . . . . . . . . . . . . . 29 7. References. . . . . . . . . . . . . . . . . . . . . . . . . . 30 7.1 Normative. . . . . . . . . . . . . . . . . . . . . . . . 30 7.2 Informative. . . . . . . . . . . . . . . . . . . . . . . 31 8. Author's Address. . . . . . . . . . . . . . . . . . . . . . . 31 9. Intellectual Property Statement . . . . . . . . . . . . . . . 32 10. Full Copyright Statement. . . . . . . . . . . . . . . . . . . 32 Sciberras Expires 11 January 2006 [Page 4] INTERNET-DRAFT LDAP: Schema for User Applications July 11, 2005 1. Introduction This document provides an overview of attribute types and object classes intended for use by Lightweight Directory Access Protocol (LDAP) directory clients for many directory services, such as, White Pages. Originally specified in the X.500 [X.500] documents, these objects are widely used as a basis for the schema in many LDAP directories. This document does not cover attributes used for the administration of directory servers, nor does it include directory objects defined for specific uses in other documents. 1.1 Relationship with other specifications This document is an integral part of the LDAP technical specification [Roadmap] which obsoletes the previously defined LDAP technical specification, RFC 3377, in its entirety. In terms of RFC 2256, Sections 6 and 8 of RFC 2256 are obsoleted by [Syntaxes]. Sections 5.1, 5.2, 7.1 and 7.2 of RFC 2256 are obsoleted by [Models]. The remainder of RFC 2256 is obsoleted by this document. Section 2.4 of this document supersedes the technical specification for the 'dc' attribute type and 'dcObject' object class found in RFC 2247. The remainder of RFC 2247 remains in force. This document updates RFC 2798 by replacing the informative description of the 'uid' attribute type, with the definitive description provided in Section 2.39 of this document. A number of schema elements which were included in the previous revision of the LDAP Technical Specification are not included in this revision of LDAP. PKI-related schema elements are now specified in [LDAP-PKI]. Unless reintroduced in future technical specifications, the remainder are to be considered Historic. The descriptions in this document SHALL be considered definitive for use in LDAP. 1.2 Conventions 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 [RFC2119]. 1.3 General Issues This document references Syntaxes defined in Section 3 of [Syntaxes] and Matching Rules defined in Section 4 of [Syntaxes]. The definitions of Attribute Types and Object Classes are written Sciberras Expires 11 January 2006 [Page 5] INTERNET-DRAFT LDAP: Schema for User Applications July 11, 2005 using the Augmented Backus-Naur Form (ABNF) [RFC2234] of AttributeTypeDescription and ObjectClassDescription given in [Models]. Lines have been folded for readability. When such values are transferred as attribute values in the LDAP Protocol the values will not contain line breaks. 2. Attribute Types The Attribute Types contained in this section hold user information. There is no requirement that servers implement the 'searchGuide' and 'teletexTerminalIdentifier' attribute types. In fact, their use is greatly discouraged. An LDAP server implementation SHOULD recognize the rest of the attribute types described in this section. 2.1 'businessCategory' The 'businessCategory' attribute type describes the kinds of business performed by an organization. Each kind is one value of this multi-valued attribute. (Source: X.520 [X.520]) ( 2.5.4.15 NAME 'businessCategory' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 ) 1.3.6.1.4.1.1466.115.121.1.15 refers to the Directory String syntax [Syntaxes]. Examples: "banking", "transportation" and "real estate". 2.2 'c' The 'c' ('countryName' in X.500) attribute type contains a two-letter ISO 3166 [ISO3166] country code. (Source: X.520 [X.520]) ( 2.5.4.6 NAME 'c' SUP name SYNTAX 1.3.6.1.4.1.1466.115.121.1.11 SINGLE-VALUE ) 1.3.6.1.4.1.1466.115.121.1.11 refers to the Country String syntax [Syntaxes]. Sciberras Expires 11 January 2006 [Page 6] INTERNET-DRAFT LDAP: Schema for User Applications July 11, 2005 Examples: "DE", "AU" and "FR". 2.3 'cn' The 'cn' ('commonName' in X.500) attribute type contains names of an object. Each name is one value of this multi-valued attribute. If the object corresponds to a person, it is typically the person's full name. (Source: X.520 [X.520]) ( 2.5.4.3 NAME 'cn' SUP name ) Examples: "Martin K Smith", "Marty Smith" and "printer12". 2.4 'dc' The 'dc' ('domainComponent' in RFC 2247) attribute type is a string holding one component, a