view Side-By-Side changes
Intended Category: Standard Track The MITRE Corp. Expires20 May 2001 20 November 200127 August 2002 27 February 2002 Obsoletes: RFC 2256 A Summary of the X.500(2nd edition) User Schema for use with LDAPv3<draft-ietf-ldapbis-user-schema-01><draft-ietf-ldapbis-user-schema-02> [Editor's note: This Internet-Draft (I-D) is a modified version of the text of RFC 2256, in order to bring it up to date. This action is part of the maintenance activity that is needed in order to progressLDAPv3LDAP (v3) to Draft Standard. The changes are described in Annex A of this document. End of Editor's note] Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 ofRFC2026.RFC 2026. This document is intended to be, after appropriate review and revision, submitted to the RFC Editor as a Standard Track document. Distribution of this memo is unlimited. Technical discussion of this document will take place on the IETF LDAP Revision Working Group (LDAPbis) mailing list <ietf-ldapbis@openldap.org>. Please send editorial comments directly to the author <kdally@mitre.org>. 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/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Copyright 2000, The Internet Society. All Rights Reserved. Please see the Copyright section near the end of this document for more information. Dally Expires20 May27 August 2002 [Page 1] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001draft-ietf-ldapbis-user-schema-02 27 February 2002 Abstract This document provides an overview of the attribute types and object classes defined by the ISO/IEC JTC1 and ITU-T committees in the IS0/IEC 9594 and X.500 documents, in particular those intended for use by directory clients. This is the most widely used schema for LDAP/X.500 directories, and many other schema definitions for white pages objects use it as a basis. This document does not cover attributes used for the administration of X.500 directory servers, nor does it include attributes defined by other ISO/ITU-T documents. 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[6].[KEYWD]. Dally Expires20 May27 August 2002 [Page 2] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001draft-ietf-ldapbis-user-schema-02 27 February 2002 Table of Contents Status of this Memo 1 Abstract 2 1. General Issues 5 2. Source 5 3. Attribute Types 6 3.1 aliasedObjectName 6 3.2authorityRevocationListbusinessCategory 6 3.3businessCategoryc 6 3.4ccn 7 3.5cACertificatedescription 7 3.6certificateRevocationListdestinationIndicator 7 3.7cndistinguishedName 7 3.8crossCertificatePair 7dnQualifier 8 3.9deltaRevocationListenhancedSearchGuide 8 3.10descriptionfacsimileTelephoneNumber 8 3.11destinationIndicatorgenerationQualifier 8 3.12distinguishedNamegivenName 8 3.13dmdName 8houseIdentifier 9 3.14dnQualifierinitials 9 3.15enhancedSearchGuideinternationalISDNNumber 9 3.16facsimileTelephoneNumberknowledgeInformation 9 3.17generationQualifierl 9 3.18givenName 9member 10 3.19houseIdentifiername 10 3.20initialso 10 3.21internationalISDNNumberobjectClass 10 3.22knowledgeInformationou 10 3.23l 10owner 11 3.24member 10physicalDeliveryOfficeName 11 3.25namepostalAddress 11 3.26opostalCode 11 3.27objectClasspostOfficeBox 11 3.28ou 11preferredDeliveryMethod 12 3.29owner 11presentationAddress 12 3.30physicalDeliveryOfficeNameprotocolInformation 12 3.31postalAddressregisteredAddress 12 3.32postalCode 12roleOccupant 13 3.33postOfficeBox 12searchGuide 13 3.34preferredDeliveryMethod 12seeAlso 13 3.35presentationAddressserialNumber 13 3.36protocolInformationsn 13 3.37registeredAddressst 13 3.38roleOccupant 13street 14 3.39searchGuide 13supportedApplicationContext 14 3.40seeAlsotelephoneNumber 14 3.41 teletexTerminalIdentifier 14 Dally Expires20 May27 August 2002 [Page 3] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001 3.41 serialNumber 14draft-ietf-ldapbis-user-schema-02 27 February 2002 3.42sn 14 3.43 st 14 3.44 street 14 3.45 supportedAlgorithms 14 3.46 supportedApplicationContext 15 3.47 telephoneNumber 15 3.48 teletexTerminalIdentifier 15 3.49telexNumber 153.503.43 title 153.513.44 uniqueMember16 3.52 userCertificate 16 3.5315 3.45 userPassword16 3.5415 3.46 x121Address 163.553.47 x500UniqueIdentifier1716 4. Object Classes1817 4.1 alias1817 4.2 applicationEntity1817 4.3 applicationProcess1817 4.4certificationAuthoritycountry 18 4.5certificationAuthority-V2 19device 18 4.6country 19dSA 18 4.7cRLDistributionPoint 19groupOfNames 18 4.8devicegroupOfUniqueNames 19 4.9dmd 20locality 19 4.10dSA 20organization 19 4.11groupOfNamesorganizationalPerson 20 4.12groupOfUniqueNames 21organizationalRole 20 4.13locality 21organizationalUnit 20 4.14organizationperson 21 4.15organizationalPersonresidentialPerson 21 4.16organizationalRole 22 4.17 organizationalUnit 22 4.18 person 23 4.19 residentialPerson 23 4.20 strongAuthenticationUser 23 4.21top23 4.22 userSecurityInformation 2421 5. Security Considerations2422 6. Acknowledgements2422 7. References2523 7.1 Normative 23 7.2 Informative 23 8. Author's Address2524 Annex A Change Log2625 Dally Expires20 May27 August 2002 [Page 4] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001draft-ietf-ldapbis-user-schema-02 27 February 2002 1. General Issues This document referencessyntaxesSyntaxes given insectionSection 3 of[1].[SYNTAX] and Matchingrules are listedRules specified insectionSection 4 of[1].[SYNTAX]. Theattribute typeAttribute Type andobject classObject Class definitions are written using theBNFABNF form of AttributeTypeDescription and ObjectClassDescription given in[1].[SYNTAX]. Lines have been folded for readability. 2. Source The schema definitions in this document are based on those found in X.500[2], [3], [4],[X501], [X509], [X520], and[5],[X521], specifically: Sections Source ============ ============ 3.1 X.501[2][X501] 3.2X.509 [3] 3.3-3.43.20 X.520[4] 3.5 - 3.6 X.509 [3] 3.7 X.520 [4] 3.8 - 3.9 X.509 [3] 3.10[X520] 3.21 X.501 [X501] 3.22 - 3.44 X.520[4][X520] 3.45 X.509[3][X509] 3.46 -3.51 X.520 [4] 3.52 - 3.53 X.509 [3] 3.54 - 3.553.47 X.520[4][X520] 4.1 X.501[2][X501] 4.2 -4.3 X.521 [5] 4.4 - 4.5 X.509 [3] 4.6 X.521 [5] 4.7 X.509 [3] 4.8 - 4.194.15 X.521[5] 4.20 X.509 [3] 4.21[X521] 4.16 X.501[2] 4.22 X.509 [3] Three new attributes: supportedAlgorithms, deltaRevocationList and dmdName, and the new objectClass dmd, which were not specified in X.500 edition 2 (1993), are defined in the X.500 edition 3 (1997)[2, 3, 4, 5] documents. [Editor's note: Should these items be removed so that they are not bringing in a second set of X.500 references. Perhaps they could be put into a non-normative annex with reference to the later X.500 edition. End editor's note.][X501] Dally Expires20 May27 August 2002 [Page 5] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001draft-ietf-ldapbis-user-schema-02 27 February 2002 3. Attribute Types Theattribute typesAttribute Types contained in this section hold user information. An LDAP server implementation MUST recognize the objectClassattribute type.Attribute Type. There is no requirement that servers implement the followingattribute types:Attribute Types: knowledgeInformation searchGuide teletexTerminalIdentifier In fact, their use is greatly discouraged. An LDAP server implementation SHOULD recognize the rest of theattribute typesAttribute Types described in this section. 3.1 aliasedObjectName The aliasedObjectNameattributeAttribute Type is used by the directory service if the entry containing this attribute is an alias. InX.500,X.501 [X501], thisattributeAttribute Type is called aliasedEntryName. ( 2.5.4.1 NAME 'aliasedObjectName' EQUALITY distinguishedNameMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.12; DNSINGLE-VALUE )3.2 authorityRevocationList A value of this attribute is a list of CA certificates that are no longer valid. This attribute is to be stored and requested in the binary form, as 'authorityRevocationList;binary'. ( 2.5.4.38 NAME 'authorityRevocationList'The SYNTAX1.3.6.1.4.1.1466.115.121.1.9 ) ; CertificateList 3.3oid indicates the DN syntax. 3.2 businessCategory ThisattributeAttribute Type describes the kind of business performed by an organization. ( 2.5.4.15 NAME 'businessCategory' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} ); DirectoryString Dally Expires 20 May 2002 [Page 6] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001 3.4The SYNTAX oid indicates the Directory String syntax. 3.3 c This is theX.500X.520 [X520] countryNameattribute,Attribute Type, which contains a two-letter ISO 3166country[Codes]country code. ( 2.5.4.6 NAME 'c' SUP name SINGLE-VALUE )3.5 cACertificate A value of this attribute is a set of information that is used to establish a traceable chain of authority for issuing user certificates. This attribute is to be stored and requested in the binary form, as 'cACertificate;binary'. ( 2.5.4.37 NAME 'cACertificate' SYNTAX 1.3.6.1.4.1.1466.115.121.1.8 ) ; Certificate 3.6 certificateRevocationList A value of this attribute is a list of user certificates that are no longer valid. This attribute is to be stored and requested in the binary form, as 'certificateRevocationList;binary'. ( 2.5.4.39 NAME 'certificateRevocationList' SYNTAX 1.3.6.1.4.1.1466.115.121.1.9 ) ; CertificateList 3.7Dally Expires 27 August 2002 [Page 6] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 3.4 cn This is theX.500X.520 [X520] commonNameattribute,Attribute Type, which contains a name of an object. If the object corresponds to a person, it is typically the person's full name. ( 2.5.4.3 NAME 'cn' SUP name )3.8 crossCertificatePair A value of this attribute is a set of two certificates that are used to enable the certificates issued in two security domains to be usable in both domains. This attribute is to be stored and requested in the binary form, as 'crossCertificatePair;binary'. ( 2.5.4.40 NAME 'crossCertificatePair' SYNTAX 1.3.6.1.4.1.1466.115.121.1.10 ) ; CertificatePair Dally Expires 20 May 2002 [Page 7] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001 3.9 deltaRevocationList This attribute contains a list of revoked user certificates that is an addition to a previous certificate revocation list. This attribute is to be stored and requested in the binary form, as 'deltaRevocationList;binary'. ( 2.5.4.53 NAME 'deltaRevocationList' SYNTAX 1.3.6.1.4.1.1466.115.121.1.9 ) ; CertificateList 3.103.5 description ThisattributeAttribute Type contains a human-readable description of the object. ( 2.5.4.13 NAME 'description' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{1024} ); DirectoryString 3.11The SYNTAX oid indicates the Directory String syntax. 3.6 destinationIndicator This attribute is used for the telegram service. ( 2.5.4.27 NAME 'destinationIndicator' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.44{128} ); PrintableString 3.12The SYNTAX oid indicates the Printable String syntax. 3.7 distinguishedName Thisattribute typeAttribute Type is not used as the name of the object itself, but it is instead a base type from which attributes with DN syntax inherit. It is unlikely that values of this type itself will occur in an entry. LDAP server implementations which do not support attribute subtyping need not recognize this attribute in requests. Client implementations MUST NOT assume that LDAP servers are capable of performing attribute subtyping. ( 2.5.4.49 NAME 'distinguishedName' EQUALITY distinguishedNameMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )3.13 dmdNameThevalue of this attribute specifies a directory management domain (DMD), the administrative authority which operatesSYNTAX oid indicates thedirectory server.DN syntax. Dally Expires20 May27 August 2002 [Page8]7] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001 ( 2.5.4.54 NAME 'dmdName' SUP name ) 3.14draft-ietf-ldapbis-user-schema-02 27 February 2002 3.8 dnQualifier The dnQualifierattribute typeAttribute Type specifies disambiguating information to add to the relative distinguished name of an entry. It is intended for use when merging data from multiple sources in order to prevent conflicts between entries which would otherwise have the same name. It is recommended that the value of the dnQualifier attribute be the same for all entries from a particular source. ( 2.5.4.46 NAME 'dnQualifier' EQUALITY caseIgnoreMatch ORDERING caseIgnoreOrderingMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.44 ); PrintableString 3.2.15The SYNTAX oid indicates the Printable String syntax. 3.9 enhancedSearchGuide This attribute is for use by X.500 clients in constructing search filters. ( 2.5.4.47 NAME 'enhancedSearchGuide' SYNTAX 1.3.6.1.4.1.1466.115.121.1.21 ); EnhancedGuide 3.16The SYNTAX oid indicates the Enhanced Guide syntax. 3.10 facsimileTelephoneNumber A value of thisattributeAttribute Type is a telephone number for a facsimile terminal (and, optionally, its parameters). ( 2.5.4.23 NAME 'facsimileTelephoneNumber' SYNTAX 1.3.6.1.4.1.1466.115.121.1.22 ); FacsimileTelephoneNumber 3.17The SYNTAX oid indicates the Facsimile Telephone Number syntax. 3.11 generationQualifier The generationQualifierattributeAttribute Type contains the part ofthea person's name which typically is the suffix, as in "IIIrd". ( 2.5.4.44 NAME 'generationQualifier' SUP name )3.183.12 givenName The givenNameattributeAttribute Type is used to hold the part of a person's name which is not their surname nor middle name. ( 2.5.4.42 NAME 'givenName' SUP name ) Dally Expires20 May27 August 2002 [Page9]8] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001 3.19draft-ietf-ldapbis-user-schema-02 27 February 2002 3.13 houseIdentifier ThisattributeAttribute Type is used to identify a building within a location. ( 2.5.4.51 NAME 'houseIdentifier' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{32768} ); DirectoryString 3.20The SYNTAX oid indicates the Directory String syntax. 3.14 initials The initialsattributeAttribute Type contains the initials of some or all of an individuals names,but notexcept the surname(s). ( 2.5.4.43 NAME 'initials' SUP name )3.213.15 internationalISDNNumber A value of thisattributeAttribute Type is an ISDN address, as defined inCCITTITU RecommendationE.164.E.164 [ISDN]. ( 2.5.4.25 NAME 'internationalISDNNumber' EQUALITY numericStringMatch SUBSTR numericStringSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.36{16} ); NumericString 3.22i The SYNTAX oid indicates the Numeric String syntax. 3.16 knowledgeInformation This attribute is superseded by the system schema attributes which hold the pointers to other LDAP servers. ( 2.5.4.2 NAME 'knowledgeInformation' EQUALITY caseIgnoreMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{32768} ); DirectoryString 3.23The SYNTAX oid indicates the Directory String syntax. 3.17 l This is theX.500X.520 [X520] localityNameattribute,Attribute Type, which contains the name of alocality,locality or place, such as a city, county or other geographic region. ( 2.5.4.7 NAME 'l' SUP name )3.24Dally Expires 27 August 2002 [Page 9] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 3.18 member A value of thisattributeAttribute Type is the Distinguished Name of an object that is on a listor in a group. Dally Expires 20 May 2002 [Page 10] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001or in a group. ( 2.5.4.31 NAME 'member' SUP distinguishedName )3.253.19 name The nameattribute typeAttribute Type is the attribute supertype from which stringattribute typesAttribute Types typically used for naming may be formed. It is unlikely that values of this type itself will occur in an entry. LDAP server implementations which do not support attribute subtyping need not recognize this attribute in requests. Client implementations MUST NOT assume that LDAP servers are capable of performing attribute subtyping. ( 2.5.4.41 NAME 'name' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{32768} ); DirectoryString 3.26The SYNTAX oid indicates the Directory String syntax. 3.20 o This is theX.500X.520 [X520] organizationNameattribute,Attribute Type, which contains the name of an organization. ( 2.5.4.10 NAME 'o' SUP name )3.273.21 objectClass The values of the objectClassattributeAttribute Type describe the kind of object which an entry represents. The objectClass attribute is present in every entry. ( 2.5.4.0 NAME 'objectClass' EQUALITY objectIdentifierMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.38 );The SYNTAX oid indicates the OID3.28syntax. 3.22 ou This is theX.500X.520 [X520] organizationalUnitNameattribute,Attribute Type, which contains the name of an organizational unit. ( 2.5.4.11 NAME 'ou' SUP name )3.29Dally Expires 27 August 2002 [Page 10] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 3.23 owner A value of thisattributeAttribute Type is the Distinguished Name of an object that has an ownership responsibility for the object that is owned.Dally Expires 20 May 2002 [Page 11] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001( 2.5.4.32 NAME 'owner' SUP distinguishedName )3.303.24 physicalDeliveryOfficeName This attribute contains the name that a Postal Service uses to identify a post office. ( 2.5.4.19 NAME 'physicalDeliveryOfficeName' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} ); DirectoryString 3.31The SYNTAX oid indicates the Directory String syntax. 3.25 postalAddress This attribute contains an address used by a Postal Service to perform services for the object. ( 2.5.4.16 NAME 'postalAddress' EQUALITY caseIgnoreListMatch SUBSTR caseIgnoreListSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.41 ); PostalAddress 3.32The SYNTAX oid indicates the Postal Address syntax. 3.26 postalCode This attribute contains a code used by a Postal Service to identify a postal service zone, such as the southern quadrant of a city. ( 2.5.4.17 NAME 'postalCode' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{40} ); DirectoryString 3.33The SYNTAX oid indicates the Directory String syntax. 3.27 postOfficeBox This attribute contains the number that a Postal Service uses when a customer arranges to receive mail at a box on premises of the Postal Service. Dally Expires 27 August 2002 [Page 11] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 ( 2.5.4.18 NAME 'postOfficeBox' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{40} ); DirectoryString 3.34The SYNTAX oid indicates the Directory String syntax. 3.28 preferredDeliveryMethod This attribute contains an indication of the preferred method of getting a message to the object.Dally Expires 20 May 2002 [Page 12] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001( 2.5.4.28 NAME 'preferredDeliveryMethod' SYNTAX 1.3.6.1.4.1.1466.115.121.1.14; DeliveryMethodSINGLE-VALUE )3.35The SYNTAX oid indicates the Delivery Method syntax. 3.29 presentationAddress This attribute contains an OSI presentation layer address. ( 2.5.4.29 NAME 'presentationAddress' EQUALITY presentationAddressMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.43; PresentationAddressSINGLE-VALUE )3.36The SYNTAX oid indicates the Presentation Address syntax. 3.30 protocolInformation ThisattributeAttribute Type is used in conjunction with the presentationAddressattribute,Attribute Type, to provide additional information to the OSI network service. ( 2.5.4.48 NAME 'protocolInformation' EQUALITY protocolInformationMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.42 ); ProtocolInformation 3.37The SYNTAX oid indicates the Protocol Information syntax. 3.31 registeredAddress This attribute holds a postal address suitable for reception of telegrams or expedited documents, where it is necessary to have the recipient accept delivery. ( 2.5.4.26 NAME 'registeredAddress' SUP postalAddress SYNTAX 1.3.6.1.4.1.1466.115.121.1.41 ); PostalAddress 3.38The SYNTAX oid indicates the Postal Address syntax. Dally Expires 27 August 2002 [Page 12] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 3.32 roleOccupant A value of thisattributeAttribute Type is the Distinguished Name of an object (normally a person) that fulfills the responsibilities of a role object. ( 2.5.4.33 NAME 'roleOccupant' SUP distinguishedName )3.393.33 searchGuide ThisattributeAttribute Type is for use by clients in constructing search filters. It is superseded by enhancedSearchGuide, described above in3.15.section 3.9. ( 2.5.4.14 NAME 'searchGuide' SYNTAX 1.3.6.1.4.1.1466.115.121.1.25 ) ; GuideDally Expires 20 May 2002 [Page 13] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001 3.40The SYNTAX oid indicates the Guide syntax. 3.34 seeAlso A value of thisattributeAttribute Type is the Distinguished Name of an object that is related to the subject object. ( 2.5.4.34 NAME 'seeAlso' SUP distinguishedName )3.413.35 serialNumber This attribute contains the serial number of a device. ( 2.5.4.5 NAME 'serialNumber' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.44{64} ); PrintableString 3.42The SYNTAX oid indicates the Printable String syntax. 3.36 sn This is theX.500X.520 [X520] surnameattribute,Attribute Type, which contains the family name of a person. ( 2.5.4.4 NAME 'sn' SUP name )3.433.37 st This is theX.500X.520 [X520] stateOrProvinceName attribute, which contains the full name of a state or province. Dally Expires 27 August 2002 [Page 14] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 ( 2.5.4.8 NAME 'st' SUP name ) 3.44 street This is theX.500X.520 [X520] streetAddress attribute, which contains the physical address of the object to which the entry corresponds, such as an address for package delivery. ( 2.5.4.9 NAME 'street' EQUALITY caseIgnoreMatch SUBSTR caseIgnoreSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} )DirectoryString 3.45 supportedAlgorithms This attribute contains the identifiers of cryptographic algorithms that the object implements. This attribute is to be stored and requested in the binary form, as 'supportedAlgorithms;binary'. Dally Expires 20 May 2002 [Page 14] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001 ( 2.5.4.52 NAME 'supportedAlgorithms'The SYNTAX1.3.6.1.4.1.1466.115.121.1.49 ) ; SupportedAlgorithm 3.46oid indicates the Directory String syntax. 3.39 supportedApplicationContext This attribute contains the identifiers of OSI application contexts. ( 2.5.4.30 NAME 'supportedApplicationContext' EQUALITY objectIdentifierMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.38 );The SYNTAX oid indicates the OID3.47syntax. 3.40 telephoneNumber A value of thisattributeAttribute Type is a telephone number complying withCCITT Rec. E.123.ITU Recommendation E.123 [E123]. ( 2.5.4.20 NAME 'telephoneNumber' EQUALITY telephoneNumberMatch SUBSTR telephoneNumberSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.50{32} ) ; TelephoneNumber3.48The SYNTAX oid indicates the Telephone Number syntax. 3.41 teletexTerminalIdentifier The withdrawal of Rec. F.200 has resulted in the withdrawal of this attribute. ( 2.5.4.22 NAME 'teletexTerminalIdentifier' SYNTAX 1.3.6.1.4.1.1466.115.121.1.51 ); TeletexTerminalIdentifier 3.49The SYNTAX oid indicates the Teletex Terminal Identifier syntax. Dally Expires 27 August 2002 [Page 14] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 3.42 telexNumber A value of thisattributeAttribute Type is a telexnumber ,number, country code, and answerback code of a telex terminal. ( 2.5.4.21 NAME 'telexNumber' SYNTAX 1.3.6.1.4.1.1466.115.121.1.52 ); TelexNumber 3.50The SYNTAX oid indicates the Telex Number syntax. 3.43 title This attribute contains the title, such as "Vice President", of a person in their organizational context. The "personalTitle" attribute would be used for a person's title independent of their job function. ( 2.5.4.12 NAME 'title' SUP name )Dally Expires 20 May 2002 [Page 15] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001 3.513.44 uniqueMember A value of thisattributeAttribute Type is the Distinguished Name of an object that is on a list or in a group, where the Relative Distinguished Name of the object includes a value that distinguishs between objects when a distinguished name has been reused. ( 2.5.4.50 NAME 'uniqueMember' EQUALITY uniqueMemberMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.34 ); NameAndOptionalUID 3.52 userCertificate A value of this attribute is a set of information that is used to protect business systems, including the directory system and its contents, from a number of threats.Theprotection is realized by verifying the object is authorized to useSYNTAX oid indicates thebusiness system for certain purposes. This attribute is to be storedName andrequested in the binary form, as 'userCertificate;binary'. ( 2.5.4.36 NAME 'userCertificate' SYNTAX 1.3.6.1.4.1.1466.115.121.1.8 ) ; Certificate 3.53Optional UID syntax. 3.45 userPassword A value of thisattributeAttribute Type is a character string that is known only to the user and the system to which the user has access. ( 2.5.4.35 NAME 'userPassword' EQUALITY octetStringMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.40{128} ); OctetStringThe SYNTAX oid indicates the Octet String syntax. Passwords are stored using an Octet String syntax and are not encrypted. Transfer of cleartext passwords is strongly discouraged where the underlying transport service cannot guarantee confidentiality and may result in disclosure of the password to unauthorized parties.3.54Dally Expires 27 August 2002 [Page 15] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 3.46 x121Address A value of thisattributeAttribute Type is a data network address as defined byCCITTITU RecommendationX.121.X.121 [X121]. ( 2.5.4.24 NAME 'x121Address' EQUALITY numericStringMatch SUBSTR numericStringSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.36{15} ); NumericString Dally Expires 20 May 2002 [Page 16] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001The SYNTAX oid indicates the Numeric String syntax. 3.55 x500UniqueIdentifier The x500UniqueIdentifierattributeAttribute Type is used to distinguish between objects when a distinguished name has been reused. InX.500,X.520 [X520], thisattributeAttribute Type is called uniqueIdentifier. This is a differentattribute typeAttribute Type from both the "uid" and "uniqueIdentifier"(defined in ??) types.Attribute Types. ( 2.5.4.45 NAME 'x500UniqueIdentifier' EQUALITY bitStringMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.6 ); BitStringThe SYNTAX oid indicates the Bit String syntax. Dally Expires20 May27 August 2002 [Page17]16] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001draft-ietf-ldapbis-user-schema-02 27 February 2002 4. Object Classes LDAP servers MUST recognize theobject classObject Class "top". LDAP servers SHOULD recognize all the otherobject classesObject Classes listed here as values of the objectClass attribute. 4.1 alias The aliasobject classObject Class enables more than one Distinguished Name to designate an entry by providing an alias entry. The alias entry contains a pointer to the other entry. The pointer is automatically followed when the alias entry is found in the process of locating the target entry(s) of an operation. ( 2.5.6.1 NAME 'alias' SUP top STRUCTURAL MUST aliasedObjectName ) 4.2 applicationEntity The applicationEntityobject classObject Class definition is the basis of an entry which represents the interconnection aspects of an application process in a distributed environment. ( 2.5.6.12 NAME 'applicationEntity' SUP top STRUCTURAL MUST ( presentationAddress $ cn ) MAY ( supportedApplicationContext $ seeAlso $ ou $ o $ l $ description ) ) 4.3 applicationProcess The applicationProcessobject classObject Class definition is the basis of an entry which represents an application executing in a computer system. ( 2.5.6.11 NAME 'applicationProcess' SUP top STRUCTURAL MUST cn MAY ( seeAlso $ ou $ l $ description ) )4.4 certificationAuthority The certificationAuthority object class is the collection of attributes that are needed in an entry which represents an issuer of certificates in a security system.Dally Expires20 May27 August 2002 [Page18]17] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001 ( 2.5.6.16 NAME 'certificationAuthority' SUP top AUXILIARY MUST ( authorityRevocationList $ certificateRevocationList $ cACertificate ) MAY crossCertificatePair ) 4.5 certificationAuthority-V2 The certificationAuthority-V2 object class adds the deltaRevocationList attribute to the collection in the certificationAuthority object class, as an option. ( 2.5.6.16.2 NAME 'certificationAuthority-V2' SUP certificationAuthority AUXILIARY MAY ( deltaRevocationList ) ) 4.6draft-ietf-ldapbis-user-schema-02 27 February 2002 4.4 country The countryobject classObject Class definition is the basis of an entrywhich represents a country. ( 2.5.6.2 NAME 'country' SUP top STRUCTURAL MUST c MAY ( searchGuide $ description ) ) 4.7 cRLDistributionPoint The cRLDistributionPoint object class is the basis of an entry which represents a source of certificate revocation lists inwhich represents asecurity system.country. (2.5.6.192.5.6.2 NAME'cRLDistributionPoint''country' SUP top STRUCTURAL MUST( cn )c MAY (certificateRevocationList $ authorityRevocationListsearchGuide $deltaRevocationListdescription ) )4.84.5 device The deviceobject classObject Class is the basis of an entry which represents an appliance or computer or network element.Dally Expires 20 May 2002 [Page 19] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001( 2.5.6.14 NAME 'device' SUP top STRUCTURAL MUST cn MAY ( serialNumber $ seeAlso $ owner $ ou $ o $ l $ description ) )4.9 dmd The dmd object class is the basis of an entry which represents the set of one or more DSAs and zero or more DUAs managed by a single organization, i.e., a Directory Management Domain. ( 2.5.6.20 NAME 'dmd' SUP top STRUCTURAL MUST ( dmdName ) MAY ( userPassword $ searchGuide $ seeAlso $ businessCategory $ x121Address $ registeredAddress $ destinationIndicator $ preferredDeliveryMethod $ telexNumber $ teletexTerminalIdentifier $ telephoneNumber $ internationaliSDNNumber $ facsimileTelephoneNumber $ street $ postOfficeBox $ postalCode $ postalAddress $ physicalDeliveryOfficeName $ st $ l $ description ) ) 4.104.6 dSA The dSA (Directory System Agent)object classObject Class is the basis of an entry which represents a server in a directory system. ( 2.5.6.13 NAME 'dSA' SUP applicationEntity STRUCTURAL MAY knowledgeInformation )4.114.7 groupOfNames The groupOfNamesobject classObject Class is the basis of an entry which represents a set of named objects including information related to the purpose or maintenance of the set. ( 2.5.6.9 NAME 'groupOfNames' SUP top STRUCTURAL MUST ( member $ cn ) MAY ( businessCategory $ seeAlso $ Dally Expires 27 August 2002 [Page 18] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 owner $ ou $ o $ description ) )Dally Expires 20 May 2002 [Page 20] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001 4.124.8 groupOfUniqueNames The groupOfUniqueNamesobject classObject Class is the same as the groupOfNames object class except that the object names are not repeated or reassigned within a set scope. ( 2.5.6.17 NAME 'groupOfUniqueNames' SUP top STRUCTURAL MUST ( uniqueMember $ cn ) MAY ( businessCategory $ seeAlso $ owner $ ou $ o $ description ) )4.134.9 locality The localityobject classObject Class is the basis of an entry which represents a place in the physical world. ( 2.5.6.3 NAME 'locality' SUP top STRUCTURAL MAY ( street $ seeAlso $ searchGuide $ st $ l $ description ) )4.144.10 organization The organizationobject classObject Class is the basis of an entry which represents a structured group of people. ( 2.5.6.4 NAME 'organization' SUP top STRUCTURAL MUST o MAY ( userPassword $ searchGuide $ seeAlso $ businessCategory $ x121Address $ registeredAddress $ destinationIndicator $ preferredDeliveryMethod $ telexNumber $ teletexTerminalIdentifier $ telephoneNumber $ internationaliSDNNumber $ facsimileTelephoneNumber $ Dally Expires 27 August 2002 [Page 19] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 street $ postOfficeBox $ postalCode $ postalAddress $ physicalDeliveryOfficeName $ st $ l $ description ) )4.154.11 organizationalPerson The organizationalPersonobject classObject Class is the basis of an entry which represents a person in relation to an organization.Dally Expires 20 May 2002 [Page 21] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001( 2.5.6.7 NAME 'organizationalPerson' SUP person STRUCTURAL MAY ( title $ x121Address $ registeredAddress $ destinationIndicator $ preferredDeliveryMethod $ telexNumber $ teletexTerminalIdentifier $ telephoneNumber $ internationaliSDNNumber $ facsimileTelephoneNumber $ street $ postOfficeBox $ postalCode $ postalAddress $ physicalDeliveryOfficeName $ ou $ st $ l ) )4.164.12 organizationalRole The organizationalRoleobject classObject Class is the basis of an entry which represents a job or function or position in an organization. ( 2.5.6.8 NAME 'organizationalRole' SUP top STRUCTURAL MUST cn MAY ( x121Address $ registeredAddress $ destinationIndicator $ preferredDeliveryMethod $ telexNumber $ teletexTerminalIdentifier $ telephoneNumber $ internationaliSDNNumber $ facsimileTelephoneNumber $ seeAlso $ roleOccupant $ preferredDeliveryMethod $ street $ postOfficeBox $ postalCode $ postalAddress $ physicalDeliveryOfficeName $ ou $ st $ l $ description ) )4.174.13 organizationalUnit The organizationalUnitobject classObject Class is the basis of an entry which represents a piece of an organization. ( 2.5.6.5 NAME 'organizationalUnit' SUP top STRUCTURAL MUST ou MAY ( userPassword $ searchGuide $ seeAlso $ businessCategory $ x121Address $ registeredAddress $ destinationIndicator $ preferredDeliveryMethod $ telexNumber $ teletexTerminalIdentifier $ telephoneNumber $ internationaliSDNNumber $ facsimileTelephoneNumber $ street $ postOfficeBox $ postalCode $ postalAddress $ physicalDeliveryOfficeName $ st $ l $ description ) ) Dally Expires20 May27 August 2002 [Page22]20] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001 4.18draft-ietf-ldapbis-user-schema-02 27 February 2002 4.14 person The personobject classObject Class is the basis of an entry which represents a human being. ( 2.5.6.6 NAME 'person' SUP top STRUCTURAL MUST ( sn $ cn ) MAY ( userPassword $ telephoneNumber $ seeAlso $ description ) )4.194.15 residentialPerson The residentialPersonobject classObject Class is the basis of an entry which includes a person's residence in the representation of the person. ( 2.5.6.10 NAME 'residentialPerson' SUP person STRUCTURAL MUST l MAY ( businessCategory $ x121Address $ registeredAddress $ destinationIndicator $ preferredDeliveryMethod $ telexNumber $ teletexTerminalIdentifier $ telephoneNumber $ internationaliSDNNumber $ facsimileTelephoneNumber $ preferredDeliveryMethod $ street $ postOfficeBox $ postalCode $ postalAddress $ physicalDeliveryOfficeName $ st $ l ) )4.20 strongAuthenticationUser The strongAuthenticationUser object class adds the userCertificate attribute, as a mandatory attribute, to the collection of attributes in an entry. ( 2.5.6.15 NAME 'strongAuthenticationUser' SUP top AUXILIARY MUST userCertificate ) 4.214.16 top The topobject classObject Class is the conceptual beginning of the inheritance hierarchy of object classes. Top guarantees that every entry has the objectClass attribute,which identifies the type of the entry. ( 2.5.6.0 NAME 'top' ABSTRACT MUST objectClass ) Dally Expires 20 May 2002 [Page 23] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 2001 4.22 userSecurityInformation The userSecurityInformation object class adds the supportedAlgorithms attribute, as an optional attribute, towhich identifies thecollectiontype ofattributes in anthe entry. (2.5.6.182.5.6.0 NAME'userSecurityInformation' SUP top AUXILIARY MAY ( supportedAlgorithms )'top' ABSTRACT MUST objectClass ) Dally Expires 27 August 2002 [Page 21] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 5. Security Considerations Attributes of directory entries are used to provide descriptive information about the real-world objects they represent, which can be people, organizations or devices. Most countries have privacy laws regarding the publication of information about people. Transfer of cleartext passwords is strongly discouraged where the underlying transport service cannot guarantee confidentiality and may result in disclosure of the password to unauthorized parties. It is required that strong authentication be performed in order to modify directory entries using LDAP. Several X.500 Attribute Types and Object Classes, such as, the userCertificate Attribute Type or the certificationAuthority Object Class, are used to include key-based security information in directory entries. The Attribute Types are: authorityRevocationList cACertificate certificateRevocationList crossCertificatePair deltaRevocationList supportedAlgorithms userCertificate The Object Classes are: certificationAuthority certificationAuthority-V2 cRLDistributionPoint strongAuthenticationUser userSecurityInformation These Attribute Types and Object Classes are specified for LDAP by the PKIX Working Group, and so, are not included in this document. The BNF notation in RFC 1778 [Syn String] for User Certificate, Authority Revocation List, and Certificate Pair are not recommended to be used. 6. Acknowledgements The definitions, on which this document is based, have been developed by committees for telecommunications and international standards. No new attribute definitions have been added. This document is an update of RFC 2256 by Mark Wahl. RFC 2256 was a product of the IETF ASID Working Group. Dally Expires 27 August 2002 [Page 22] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 This document is based upon input of the IETF LDAPBIS working group. Theauthors wishauthor wishes to thank___S. Legg and K. Zeilenga for their significant contribution to this update.Dally Expires 20 May 2002 [Page 24] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-01 20 November 20017. References[1]7.1 Normative [Codes] ISO 3166, "Codes for the representation of names of countries". [E123] Notation for national and international telephone numbers, ITU-T Recommendation E.123, 1988 [ISDN] The international public telecommunication numbering plan, ITU-T Recommendation E.164, 1997 [KEYWD] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119, March 1997 [SYNTAX] replacement(draft-ietf-ldapbis-syntaxes-01)(draft-ietf-ldapbis-syntaxes-02) for Wahl, M., Coulbeck, A., Howes, T., and S. Kille, "Lightweight X.500 Directory Access Protocol(v3): Attribute Syntax Definitions", RFC 2252, December 1997[2][X121] International numbering plan for public data networks, ITU-T Recommendation X.121, 1996 [X501] The Directory: Models, ITU-T Recommendation X.501, 1995[3][X509] The Directory: Authentication Framework, ITU-T Recommendation X.509, 1995[4][X520] The Directory: Selected Attribute Types, ITU-T Recommendation X.520, 1995[5][X521] The Directory: Selected Object Classes. ITU-T Recommendation X.521, 1995[6] Bradner,7.2 Informative [Syn String] Howes, T., Kille, S.,"Key words for use in RFCs to Indicate Requirement Levels",Yeong, W., Robbins, C., "The String Representation of Standard Attribute Syntaxes", RFC2119,1778, March19971995. Dally Expires 27 August 2002 [Page 23] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 8. Author's Address Kathy Dally The MITRE Corp. 1575 Colshire Dr., ms-W650 McLean VA 22102 USA Phone: +1 703 883 6058 Email: kdally@mitre.org Dally Expires20 May27 August 2002 [Page25]24] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001draft-ietf-ldapbis-user-schema-02 27 February 2002 Annex A Change Log This annex lists the changes that have been made from RFC 2256 to this I-D. Changes to RFC 2256 resulting in draft-ietf-ldapbis-user-schema-00.txt: 1. Revision of the Status of this Memo. 2. Dependencies on RFC 1274 have been eliminated. 3. The references to X.500(96) have been expressed in terms of the "edition", rather than the standard date. Note that the version of X.500 which is the basis for this document, is the third edition, which was finalized in 1996, but approved in 1997. 4. The "teletexTerminalNumber" attribute and syntax are marked as obsolete. 5. Removed "The syntax definitions are based on the ISODE "QUIPU" implementation of X.500." from section 6. 6. Added text to 6.1, the octetString syntax, in accordance with X.520. 7. Some of the attribute types MUST be recognized by servers. Also, several attributes are obsolete. Therefore, the various kinds of attribute types have been placed in separate sections: - necessary for the directory to operate (section 3.1) - for holding user information (section 3.2) - superseded or withdrawn (section 3.3). 8. Since "top" may be implicitly specified and "alias" is not abstract, the last sentence in the description of the "objectClass" attribute type, section 3.1.1, has been deleted. The clause that preceded the deleted sentence has been removed, also. 9. Add a description to the definition of the "telephoneNumber" attribute type, section 3.2.17. 10. Add text to mark the "teletexTerminalIdentifier" attribute type as obsolete. Dally Expires20 May27 August 2002 [Page26]25] INTERNET-DRAFTdraft-ietf-ldapbis-user-schema-01 20 November 2001draft-ietf-ldapbis-user-schema-02 27 February 2002 11. Add a security consideration requiring strong authentication in order to modify directory entries. Changes to draft-ietf-ldapbis-user-schema-00.txt, resulting in draft- ietf-ldapbis-user-schema-01.txt: 12. Delete the conformance requirement for subschema object classes in favor of a statement in[1].[SYNTAX]. 13. Add a Table of Contents 14. Replace the term "obsolete" with "superseded or withdrawn" 15. Added explanations to many attributes. 16. In the title, correct the X.500 reference to have the second edition as the basis. 17. Throughout this I-D, cleaned up whitespace in the BNF definitions. 18. Removed Section 4, Syntaxes, and Section 6, Matching Rules, (moved to draft-ietf-ldapbis-syntaxes-01.txt). 19. Reorganized Section 3, Attributes, to eliminate grouping attributes according to conformance requirements. Reordered Section 3, Attributes, and Section 4, Object Classes, alphabetically. 20. Added an explanation for each object class. Changes to draft-ietf-ldapbis-user-schema-01.txt, resulting in draft- ietf-ldapbis-user-schema-02.txt: 21. Removed the certificate-related Attribute Types: authorityRevocationList, cACertificate, certificateRevocationList, crossCertificatePair, deltaRevocationList, supportedAlgorithms, and userCertificate. Removed the certificate-related Object Classes: certificationAuthority, certificationAuthority-V2, cRLDistributionPoint, strongAuthenticationUser, and userSecurityInformation Noted in the Security Considerations (Section 7) that they are covered in PKIX WG documents. Dally Expires20 May27 August 2002 [Page 26] INTERNET-DRAFT draft-ietf-ldapbis-user-schema-02 27 February 2002 22. Removed the dmdName Attribute Type and dmd Object Class because they are not in the version of X.500 which is referenced. 23. Removed embedded comments from the ABNF productions throughout the document. 24. Cleaned up the references; adopted word instead of number tags; split Section 7 into normative and informative subsections. Dally Expires 27 August 2002 [Page 27] ----