Skip to content
Snippets Groups Projects
rfc4519.txt 63.5 KiB
Newer Older
  • Learn to ignore specific revisions
  • Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Network Working Group                                  A. Sciberras, Ed.
    Request for Comments: 4519                                       eB2Bcom
    Obsoletes: 2256                                                June 2006
    Updates: 2247, 2798, 2377
    Category: Standards Track
    
                 Lightweight Directory Access Protocol (LDAP):
                          Schema for User Applications
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Status of This Memo
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       This document specifies an Internet standards track protocol for the
       Internet community, and requests discussion and suggestions for
       improvements.  Please refer to the current edition of the "Internet
       Official Protocol Standards" (STD 1) for the standardization state
       and status of this protocol.  Distribution of this memo is unlimited.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Copyright Notice
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       Copyright (C) The Internet Society (2006).
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    Abstract
    
       This document is an integral part of the Lightweight Directory Access
    
       Protocol (LDAP) technical specification.  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                   Standards Track                     [Page 1]
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Table of Contents
    
    
       1. Introduction ....................................................3
          1.1. Relationship with Other Specifications .....................3
          1.2. Conventions ................................................4
          1.3. General Issues .............................................4
       2. Attribute Types .................................................4
          2.1. 'businessCategory' .........................................5
          2.2. 'c' ........................................................5
          2.3. 'cn' .......................................................5
          2.4. 'dc' .......................................................6
          2.5. 'description' ..............................................6
          2.6. 'destinationIndicator' .....................................7
          2.7. 'distinguishedName' ........................................7
          2.8. 'dnQualifier' ..............................................8
          2.9. 'enhancedSearchGuide' ......................................8
          2.10. 'facsimileTelephoneNumber' ................................9
          2.11. 'generationQualifier' .....................................9
          2.12. 'givenName' ...............................................9
          2.13. 'houseIdentifier' .........................................9
          2.14. 'initials' ...............................................10
          2.15. 'internationalISDNNumber' ................................10
          2.16. 'l' ......................................................10
          2.17. 'member' .................................................11
          2.18. 'name' ...................................................11
          2.19. 'o' ......................................................11
          2.20. 'ou' .....................................................12
          2.21. 'owner' ..................................................12
          2.22. 'physicalDeliveryOfficeName' .............................12
          2.23. 'postalAddress' ..........................................13
          2.24. 'postalCode' .............................................13
          2.25. 'postOfficeBox' ..........................................14
          2.26. 'preferredDeliveryMethod' ................................14
          2.27. 'registeredAddress' ......................................14
          2.28. 'roleOccupant' ...........................................15
          2.29. 'searchGuide' ............................................15
          2.30. 'seeAlso' ................................................15
          2.31. 'serialNumber' ...........................................16
          2.32. 'sn' .....................................................16
          2.33. 'st' .....................................................16
          2.34. 'street' .................................................17
          2.35. 'telephoneNumber' ........................................17
          2.36. 'teletexTerminalIdentifier' ..............................17
          2.37. 'telexNumber' ............................................18
          2.38. 'title' ..................................................18
          2.39. 'uid' ....................................................18
          2.40. 'uniqueMember' ...........................................19
          2.41. 'userPassword' ...........................................19
    
    
    
    Sciberras                   Standards Track                     [Page 2]
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
          2.42. 'x121Address' ............................................20
          2.43. 'x500UniqueIdentifier' ...................................20
       3. Object Classes .................................................20
          3.1. 'applicationProcess' ......................................21
          3.2. 'country' .................................................21
          3.3. 'dcObject' ................................................21
          3.4. 'device' ..................................................21
          3.5. 'groupOfNames' ............................................22
          3.6. 'groupOfUniqueNames' ......................................22
          3.7. 'locality' ................................................23
          3.8. 'organization' ............................................23
          3.9. 'organizationalPerson' ....................................24
          3.10. 'organizationalRole' .....................................24
          3.11. 'organizationalUnit' .....................................24
          3.12. 'person' .................................................25
          3.13. 'residentialPerson' ......................................25
          3.14. 'uidObject' ..............................................26
       4. IANA Considerations ............................................26
       5. Security Considerations ........................................28
       6. Acknowledgements ...............................................28
       7. References .....................................................29
          7.1. Normative References ......................................29
          7.2. Informative References ....................................30
       Appendix A  Changes Made Since RFC 2256 ...........................32
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       This document is an integral part of the LDAP technical specification
    
       [RFC4510], which obsoletes the previously defined LDAP technical
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       specification, RFC 3377, in its entirety.  In terms of RFC 2256,
    
       Sections 6 and 8 of RFC 2256 are obsoleted by [RFC4517].  Sections
       5.1, 5.2, 7.1, and 7.2 of RFC 2256 are obsoleted by [RFC4512].  The
       remainder of RFC 2256 is obsoleted by this document.  The technical
       specification for the 'dc' attribute type and 'dcObject' object class
       found in RFC 2247 are superseded by sections 2.4 and 3.3 of this
       document.  The remainder of RFC 2247 remains in force.
    
    
    
    
    Sciberras                   Standards Track                     [Page 3]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       This document updates RFC 2798 by replacing the informative
    
       description of the 'uid' attribute type with the definitive
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       description provided in Section 2.39 of this document.
    
    
       This document updates RFC 2377 by replacing the informative
       description of the 'uidObject' object class with the definitive
       description provided in Section 3.14 of this document.
    
       A number of schema elements that were included in the previous
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       revision of the LDAP Technical Specification are not included in this
       revision of LDAP.  PKI-related schema elements are now specified in
    
       [RFC4523].  Unless reintroduced in future technical specifications,
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       the remainder are to be considered Historic.
    
       The descriptions in this document SHALL be considered definitive for
       use in LDAP.
    
    
    1.2.  Conventions
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       document are to be interpreted as described in RFC 2119 [RFC2119].
    
    
    1.3.  General Issues
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       This document references Syntaxes defined in Section 3 of [RFC4517]
       and Matching Rules defined in Section 4 of [RFC4517].
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The definitions of Attribute Types and Object Classes are written
    
       using the Augmented Backus-Naur Form (ABNF) [RFC4234] of
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       AttributeTypeDescription and ObjectClassDescription given in
    
       [RFC4512].  Lines have been folded for readability.  When such values
       are transferred as attribute values in the LDAP Protocol, the values
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       will not contain line breaks.
    
    2.  Attribute Types
    
    
       The attribute types contained in this section hold user information.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       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.
    
    
    
    
    
    
    
    Sciberras                   Standards Track                     [Page 4]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
    2.1.  'businessCategory'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       Examples: "banking", "transportation", and "real estate".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Examples: "DE", "AU" and "FR".
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       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".
    
    
    
    
    
    
    
    Sciberras                   Standards Track                     [Page 5]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'dc' ('domainComponent' in RFC 1274) attribute type is a string
       holding one component, a label, of a DNS domain name
       [RFC1034][RFC2181] naming a host [RFC1123].  That is, a value of this
       attribute is a string of ASCII characters adhering to the following
       ABNF [RFC4234]:
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       label = (ALPHA / DIGIT) [*61(ALPHA / DIGIT / HYPHEN) (ALPHA / DIGIT)]
       ALPHA   = %x41-5A / %x61-7A     ; "A"-"Z" / "a"-"z"
       DIGIT   = %x30-39               ; "0"-"9"
       HYPHEN  = %x2D                  ; hyphen ("-")
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The encoding of IA5String for use in LDAP is simply the characters of
       the ASCII label.  The equality matching rule is case insensitive, as
       is today's DNS.  (Source: RFC 2247 [RFC2247] and RFC 1274 [RFC 1274])
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
          ( 0.9.2342.19200300.100.1.25 NAME 'dc'
             EQUALITY caseIgnoreIA5Match
             SUBSTR caseIgnoreIA5SubstringsMatch
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
             SINGLE-VALUE )
    
       1.3.6.1.4.1.1466.115.121.1.26 refers to the IA5 String syntax
       [RFC4517].
    
       Examples: Valid values include "example" and "com" but not
       "example.com".  The latter is invalid as it contains multiple domain
       components.
    
       It is noted that the directory service will not ensure that values of
       this attribute conform to the host label restrictions [RFC1123]
       illustrated by the <label> production provided above.  It is the
       directory client's responsibility to ensure that the labels it stores
       in this attribute are appropriately restricted.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       Directory applications supporting International Domain Names SHALL
       use the ToASCII method [RFC3490] to produce the domain component
       label.  The special considerations discussed in Section 4 of RFC 3490
       [RFC3490] should be taken, depending on whether the domain component
       is used for "stored" or "query" purposes.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.5.  'description'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'description' attribute type contains human-readable descriptive
       phrases about the object.  Each description is one value of this
       multi-valued attribute.
       (Source: X.520 [X.520])
    
    
    
    
    Sciberras                   Standards Track                     [Page 6]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
          ( 2.5.4.13 NAME 'description'
             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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Examples: "a color printer", "Maintenance is done every Monday, at
    
                 1pm.", and "distribution list for all technical staff".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.6.  'destinationIndicator'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'destinationIndicator' attribute type contains country and city
    
       strings associated with the object (the addressee) needed to provide
       the Public Telegram Service.  The strings are composed in accordance
       with CCITT Recommendations F.1 [F.1] and F.31 [F.31].  Each string is
       one value of this multi-valued attribute.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       (Source: X.520 [X.520])
    
          ( 2.5.4.27 NAME 'destinationIndicator'
             EQUALITY caseIgnoreMatch
             SUBSTR caseIgnoreSubstringsMatch
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.44 )
    
       1.3.6.1.4.1.1466.115.121.1.44 refers to the Printable String syntax
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Examples: "AASD" as a destination indicator for Sydney, Australia.
                 "GBLD" as a destination indicator for London, United
                 Kingdom.
    
       It is noted that the directory will not ensure that values of this
    
       attribute conform to the F.1 and F.31 CCITT Recommendations.  It is
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       the application's responsibility to ensure destination indicators
       that it stores in this attribute are appropriately constructed.
    
    
    2.7.  'distinguishedName'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'distinguishedName' attribute type is not used as the name of the
       object itself, but it is instead a base type from which some user
       attribute types with a DN syntax can inherit.
    
       It is unlikely that values of this type itself will occur in an
    
       entry.  LDAP server implementations that do not support attribute
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       subtyping need not recognize this attribute in requests.  Client
       implementations MUST NOT assume that LDAP servers are capable of
       performing attribute subtyping.
    
    
    
    
    Sciberras                   Standards Track                     [Page 7]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       (Source: X.520 [X.520])
    
          ( 2.5.4.49 NAME 'distinguishedName'
             EQUALITY distinguishedNameMatch
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
    
    
       1.3.6.1.4.1.1466.115.121.1.12 refers to the DN syntax [RFC4517].
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.8.  'dnQualifier'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'dnQualifier' attribute type contains disambiguating information
       strings to add to the relative distinguished name of an entry.  The
       information is intended for use when merging data from multiple
    
       sources in order to prevent conflicts between entries that would
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       otherwise have the same name.  Each string is one value of this
       multi-valued attribute.  It is recommended that a value of the
       'dnQualifier' attribute be the same for all entries from a particular
       source.
       (Source: X.520 [X.520])
    
          ( 2.5.4.46 NAME 'dnQualifier'
             EQUALITY caseIgnoreMatch
             ORDERING caseIgnoreOrderingMatch
             SUBSTR caseIgnoreSubstringsMatch
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.44 )
    
       1.3.6.1.4.1.1466.115.121.1.44 refers to the Printable String syntax
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Examples: "20050322123345Z" - timestamps can be used to disambiguate
                 information.
                 "123456A" - serial numbers can be used to disambiguate
                 information.
    
    
    2.9.  'enhancedSearchGuide'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'enhancedSearchGuide' attribute type contains sets of information
       for use by directory clients in constructing search filters.  Each
       set is one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
    
          ( 2.5.4.47 NAME 'enhancedSearchGuide'
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.21 )
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       1.3.6.1.4.1.1466.115.121.1.21 refers to the Enhanced Guide syntax
       [RFC4517].
    
    Sciberras                   Standards Track                     [Page 8]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       Examples: "person#(sn$APPROX)#wholeSubtree" and
                 "organizationalUnit#(ou$SUBSTR)#oneLevel".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.10.  'facsimileTelephoneNumber'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'facsimileTelephoneNumber' attribute type contains telephone
       numbers (and, optionally, the parameters) for facsimile terminals.
       Each telephone number is one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.23 NAME 'facsimileTelephoneNumber'
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.22 )
    
       1.3.6.1.4.1.1466.115.121.1.22 refers to the Facsimile Telephone
    
       Number syntax [RFC4517].
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       Examples: "+61 3 9896 7801" and "+81 3 347 7418$fineResolution".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.11.  'generationQualifier'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'generationQualifier' attribute type contains name strings that
    
       are typically the suffix part of a person's name.  Each string is one
       value of this multi-valued attribute.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       (Source: X.520 [X.520])
    
          ( 2.5.4.44 NAME 'generationQualifier'
             SUP name )
    
    
       Examples: "III", "3rd", and "Jr.".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.12.  'givenName'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'givenName' attribute type contains name strings that are the
    
       part of a person's name that is not their surname.  Each string is
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.42 NAME 'givenName'
             SUP name )
    
    
       Examples: "Andrew", "Charles", and "Joanne".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.13.  'houseIdentifier'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'houseIdentifier' attribute type contains identifiers for a
       building within a location.  Each identifier is one value of this
       multi-valued attribute.
       (Source: X.520 [X.520])
    
    
    
    
    Sciberras                   Standards Track                     [Page 9]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
          ( 2.5.4.51 NAME 'houseIdentifier'
             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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       Example: "20" to represent the house number 20.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.14.  'initials'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'initials' attribute type contains strings of initials of some or
       all of an individual's names, except the surname(s).  Each string is
       one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.43 NAME 'initials'
             SUP name )
    
       Examples: "K. A." and "K".
    
    
    2.15.  'internationalISDNNumber'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'internationalISDNNumber' attribute type contains Integrated
       Services Digital Network (ISDN) addresses, as defined in the
       International Telecommunication Union (ITU) Recommendation E.164
       [E.164].  Each address is one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.25 NAME 'internationalISDNNumber'
             EQUALITY numericStringMatch
             SUBSTR numericStringSubstringsMatch
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.36 )
    
       1.3.6.1.4.1.1466.115.121.1.36 refers to the Numeric String syntax
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       Example: "0198 333 333".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'l' ('localityName' in X.500) attribute type contains names of a
       locality or place, such as a city, county, or other geographic
       region.  Each name is one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
    Sciberras                   Standards Track                    [Page 10]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
          ( 2.5.4.7 NAME 'l'
             SUP name )
    
    
       Examples: "Geneva", "Paris", and "Edinburgh".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'member' attribute type contains the distinguished names of
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       objects that are on a list or in a group.  Each name is one value of
       this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.31 NAME 'member'
             SUP distinguishedName )
    
       Examples: "cn=James Clarke,ou=Finance,o=Widget\, Inc." and
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
                 "cn=John Xerri,ou=Finance,o=Widget\, Inc." may
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
                 be two members of the financial team (group) at Widget,
    
                 Inc., in which case, both of these distinguished names
                 would be present as individual values of the member
                 attribute.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'name' attribute type is the attribute supertype from which user
       attribute types with the name syntax inherit.  Such attribute types
       are typically used for naming.  The attribute type is multi-valued.
    
       It is unlikely that values of this type itself will occur in an
    
       entry.  LDAP server implementations that do not support attribute
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       subtyping need not recognize this attribute in requests.  Client
       implementations MUST NOT assume that LDAP servers are capable of
       performing attribute subtyping.
       (Source: X.520 [X.520])
    
          ( 2.5.4.41 NAME 'name'
             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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'o' ('organizationName' in X.500) attribute type contains the
       names of an organization.  Each name is one value of this
       multi-valued attribute.
    
    Sciberras                   Standards Track                    [Page 11]
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       (Source: X.520 [X.520])
    
          ( 2.5.4.10 NAME 'o'
             SUP name )
    
    
       Examples: "Widget", "Widget, Inc.", and "Widget, Incorporated.".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'ou' ('organizationalUnitName' in X.500) attribute type contains
       the names of an organizational unit.  Each name is one value of this
       multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.11 NAME 'ou'
             SUP name )
    
    
       Examples: "Finance", "Human Resources", and "Research and
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
                 Development".
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'owner' attribute type contains the distinguished names of
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       objects that have an ownership responsibility for the object that is
       owned.  Each owner's name is one value of this multi-valued
       attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.32 NAME 'owner'
             SUP distinguishedName )
    
       Example: The mailing list object, whose DN is "cn=All Employees,
                ou=Mailing List,o=Widget\, Inc.", is owned by the Human
                Resources Director.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
                Therefore, the value of the 'owner' attribute within the
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
                mailing list object, would be the DN of the director (role):
                "cn=Human Resources Director,ou=employee,o=Widget\, Inc.".
    
    
    2.22.  'physicalDeliveryOfficeName'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'physicalDeliveryOfficeName' attribute type contains names that a
       Postal Service uses to identify a post office.
       (Source: X.520 [X.520])
    
    
    
    
    
    
    
    
    Sciberras                   Standards Track                    [Page 12]
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
          ( 2.5.4.19 NAME 'physicalDeliveryOfficeName'
             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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Examples: "Bremerhaven, Main" and "Bremerhaven, Bonnstrasse".
    
    
    2.23.  'postalAddress'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'postalAddress' attribute type contains addresses used by a
       Postal Service to perform services for the object.  Each address is
       one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.16 NAME 'postalAddress'
             EQUALITY caseIgnoreListMatch
             SUBSTR caseIgnoreListSubstringsMatch
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.41 )
    
       1.3.6.1.4.1.1466.115.121.1.41 refers to the Postal Address syntax
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Example: "15 Main St.$Ottawa$Canada".
    
    
    2.24.  'postalCode'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'postalCode' attribute type contains codes used by a Postal
       Service to identify postal service zones.  Each code is one value of
       this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.17 NAME 'postalCode'
             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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       Example: "22180", to identify Vienna, VA, in the USA.
    
    
    
    
    Sciberras                   Standards Track                    [Page 13]
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.25.  'postOfficeBox'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'postOfficeBox' attribute type contains postal box identifiers
       that a Postal Service uses when a customer arranges to receive mail
       at a box on the premises of the Postal Service.  Each postal box
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       identifier is a single value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.18 NAME 'postOfficeBox'
             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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Example: "Box 45".
    
    
    2.26.  'preferredDeliveryMethod'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'preferredDeliveryMethod' attribute type contains an indication
       of the preferred method of getting a message to the object.
       (Source: X.520 [X.520])
    
          ( 2.5.4.28 NAME 'preferredDeliveryMethod'
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.14
             SINGLE-VALUE )
    
       1.3.6.1.4.1.1466.115.121.1.14 refers to the Delivery Method syntax
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Example: If the mhs-delivery Delivery Method is preferred over
                telephone-delivery, which is preferred over all other
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
                methods, the value would be: "mhs $ telephone".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.27.  'registeredAddress'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'registeredAddress' attribute type contains postal addresses
       suitable for reception of telegrams or expedited documents, where it
       is necessary to have the recipient accept delivery.  Each address is
       one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.26 NAME 'registeredAddress'
             SUP postalAddress
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.41 )
    
    
    
    
    
    
    Sciberras                   Standards Track                    [Page 14]
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    
       1.3.6.1.4.1.1466.115.121.1.41 refers to the Postal Address syntax
       [RFC4517].
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       Example: "Receptionist$Widget, Inc.$15 Main St.$Ottawa$Canada".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.28.  'roleOccupant'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'roleOccupant' attribute type contains the distinguished names of
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       objects (normally people) that fulfill the responsibilities of a role
       object.  Each distinguished name is one value of this multi-valued
       attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.33 NAME 'roleOccupant'
             SUP distinguishedName )
    
       Example: The role object, "cn=Human Resources
                Director,ou=Position,o=Widget\, Inc.", is fulfilled by two
                people whose object names are "cn=Mary
                Smith,ou=employee,o=Widget\, Inc." and "cn=James
                Brown,ou=employee,o=Widget\, Inc.".  The 'roleOccupant'
                attribute will contain both of these distinguished names,
                since they are the occupants of this role.
    
    
    2.29.  'searchGuide'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'searchGuide' attribute type contains sets of information for use
       by clients in constructing search filters.  It is superseded by
    
       'enhancedSearchGuide', described above in Section 2.9.  Each set is
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.14 NAME 'searchGuide'
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.25 )
    
    
       1.3.6.1.4.1.1466.115.121.1.25 refers to the Guide syntax [RFC4517].
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       Example: "person#sn$EQ".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'seeAlso' attribute type contains the distinguished names of
       objects that are related to the subject object.  Each related object
       name is one value of this multi-valued attribute.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       (Source: X.520 [X.520])
    
          ( 2.5.4.34 NAME 'seeAlso'
             SUP distinguishedName )
    
    
    
    
    Sciberras                   Standards Track                    [Page 15]
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
       Example: The person object "cn=James Brown,ou=employee,o=Widget\,
                Inc." is related to the role objects "cn=Football Team
                Captain,ou=sponsored activities,o=Widget\, Inc." and
                "cn=Chess Team,ou=sponsored activities,o=Widget\, Inc.".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
                Since the role objects are related to the person object, the
                'seeAlso' attribute will contain the distinguished name of
                each role object as separate values.
    
    
    2.31.  'serialNumber'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'serialNumber' attribute type contains the serial numbers of
       devices.  Each serial number is one value of this multi-valued
       attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.5 NAME 'serialNumber'
             EQUALITY caseIgnoreMatch
             SUBSTR caseIgnoreSubstringsMatch
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.44 )
    
       1.3.6.1.4.1.1466.115.121.1.44 refers to the Printable String syntax
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Examples: "WI-3005" and "XF551426".
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'sn' ('surname' in X.500) attribute type contains name strings
       for the family names of a person.  Each string is one value of this
       multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.4 NAME 'sn'
             SUP name )
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       Example: "Smith".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'st' ('stateOrProvinceName' in X.500) attribute type contains the
       full names of states or provinces.  Each name is one value of this
       multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.8 NAME 'st'
             SUP name )
    
       Example: "California".
    
    
    
    
    Sciberras                   Standards Track                    [Page 16]
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'street' ('streetAddress' in X.500) attribute type contains site
       information from a postal address (i.e., the street name, place,
    
       avenue, and the house number).  Each street is one value of this
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.9 NAME 'street'
             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
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       Example: "15 Main St.".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    2.35.  'telephoneNumber'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'telephoneNumber' attribute type contains telephone numbers that
       comply with the ITU Recommendation E.123 [E.123].  Each number is one
       value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.20 NAME 'telephoneNumber'
             EQUALITY telephoneNumberMatch
             SUBSTR telephoneNumberSubstringsMatch
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.50 )
    
       1.3.6.1.4.1.1466.115.121.1.50 refers to the Telephone Number syntax
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       Example: "+1 234 567 8901".
    
    
    2.36.  'teletexTerminalIdentifier'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The withdrawal of Recommendation F.200 has resulted in the withdrawal
       of this attribute.
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       (Source: X.520 [X.520])
    
          ( 2.5.4.22 NAME 'teletexTerminalIdentifier'
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.51 )
    
       1.3.6.1.4.1.1466.115.121.1.51 refers to the Teletex Terminal
    
       Identifier syntax [RFC4517].
    
    Sciberras                   Standards Track                    [Page 17]
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    RFC 4519           LDAP: Schema for User Applications          June 2006
    
    2.37.  'telexNumber'
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
       The 'telexNumber' attribute type contains sets of strings that are a
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       telex number, country code, and answerback code of a telex terminal.
       Each set is one value of this multi-valued attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.21 NAME 'telexNumber'
             SYNTAX 1.3.6.1.4.1.1466.115.121.1.52 )
    
       1.3.6.1.4.1.1466.115.121.1.52 refers to the Telex Number syntax
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
       Example: "12345$023$ABCDE".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'title' attribute type contains the title of a person in their
       organizational context.  Each title is one value of this multi-valued
       attribute.
       (Source: X.520 [X.520])
    
          ( 2.5.4.12 NAME 'title'
             SUP name )
    
       Examples: "Vice President", "Software Engineer", and "CEO".
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
    
    Kurt Zeilenga's avatar
    Kurt Zeilenga committed
    
       The 'uid' ('userid' in RFC 1274) attribute type contains computer
       system login names associated with the object.  Each name is one
       value of this multi-valued attribute.
       (Source: RFC 2798 [RFC2798] and RFC 1274 [RFC1274])
    
          ( 0.9.2342.19200300.100.1.1 NAME 'uid'
             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
    
       [RFC4517].
    
       Examples: "s9709015", "admin", and "Administrator".