|
OM LDAP |
|
1.
Introduktion |
| |
Det här är ett formatterat utdrag ur RFC 2256, A Summary of the X.500(96) User Schema for use with LDAPv3
Sammanfattning och inledning ur RFC 2256:
This document provides an overview of the attribute types and object classes defined by the ISO and ITU-T committees in the 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].
The schema definitions in this document are based on those found in X.500 [2],[3],[4],[5], and updates to these documents, specifically:
Sections - Source
Three new attributes supportedAlgorithms, deltaRevocationList and dmdName, and the objectClass dmd, are defined in the X.500(96) documents.
5. Attribute Types |
|
|
An LDAP server implementation SHOULD recognize the attribute types described in this section. |
|
| 5.1. objectClass |
The values of the objectClass attribute describe the kind of object which an entry represents. The objectClass attribute is present in every entry, with at least two values. One of the values is either "top" or "alias". ( 2.5.4.0
NAME 'objectClass' |
|
5.2. aliasedObjectName |
The aliasedObjectName attribute is used by the directory service if the entry containing this attribute is an alias. ( 2.5.4.1
NAME 'aliasedObjectName' |
|
5.3. knowledgeInformation |
This attribute is no longer used. ( 2.5.4.2
NAME 'knowledgeInformation' |
|
5.4. cn |
This is the X.500 commonName attribute, 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 ) |
|
5.5. sn |
This is the X.500 surname attribute, which contains the family name of a person. ( 2.5.4.4 NAME 'sn' SUP name ) |
|
5.6. serialNumber |
This attribute contains the serial number of a device. ( 2.5.4.5
NAME 'serialNumber' EQUALITY caseIgnoreMatch |
|
5.7. c |
This attribute contains a two-letter ISO 3166 country code (countryName). ( 2.5.4.6 NAME 'c' SUP name SINGLE-VALUE ) |
|
5.8. l |
This attribute contains the name of a locality, such as a city, county or other geographic region (localityName). ( 2.5.4.7 NAME 'l' SUP name ) |
|
5.9. st |
This attribute contains the full name of a state or province (stateOrProvinceName). ( 2.5.4.8 NAME 'st' SUP name ) |
|
5.10. street |
This attribute contains the physical address of the object to which the entry corresponds, such as an address for package delivery (streetAddress). ( 2.5.4.9
NAME 'street' EQUALITY caseIgnoreMatch |
|
5.11. o |
This attribute contains the name of an organization (organizationName). ( 2.5.4.10 NAME 'o' SUP name ) |
|
5.12. ou |
This attribute contains the name of an organizational unit (organizationalUnitName). ( 2.5.4.11 NAME 'ou' SUP name ) |
|
5.13. 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 ) |
|
5.14. description |
This attribute contains a human-readable description of the object. ( 2.5.4.13 NAME 'description' EQUALITY caseIgnoreMatch |
|
5.15. searchGuide |
This attribute is for use by X.500 clients in constructing search filters. It is obsoleted by enhancedSearchGuide, described below in 5.48. ( 2.5.4.14 NAME 'searchGuide' |
|
5.16. businessCategory |
This attribute describes the kind of business performed by an organization. ( 2.5.4.15 NAME 'businessCategory' EQUALITY caseIgnoreMatch |
|
5.17. postalAddress |
( 2.5.4.16 NAME 'postalAddress' EQUALITY caseIgnoreListMatch |
|
5.18. postalCode |
( 2.5.4.17 NAME 'postalCode' EQUALITY caseIgnoreMatch |
|
5.19. postOfficeBox |
( 2.5.4.18 NAME 'postOfficeBox' EQUALITY caseIgnoreMatch |
|
5.20. physicalDeliveryOfficeName |
( 2.5.4.19 NAME 'physicalDeliveryOfficeName' EQUALITY caseIgnoreMatch |
|
5.21. telephoneNumber |
( 2.5.4.20 NAME 'telephoneNumber' EQUALITY telephoneNumberMatch |
|
5.22. telexNumber |
( 2.5.4.21 NAME 'telexNumber' |
|
5.23. teletexTerminalIdentifier |
( 2.5.4.22 NAME 'teletexTerminalIdentifier' |
|
5.24. facsimileTelephoneNumber |
( 2.5.4.23 NAME 'facsimileTelephoneNumber' |
|
5.25. x121Address |
( 2.5.4.24 NAME 'x121Address' EQUALITY numericStringMatch |
|
5.26. internationaliSDNNumber |
( 2.5.4.25 NAME 'internationaliSDNNumber' EQUALITY numericStringMatch |
|
5.27. 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 |
|
5.28. destinationIndicator |
This attribute is used for the telegram service. ( 2.5.4.27 NAME 'destinationIndicator' EQUALITY caseIgnoreMatch |
|
5.29. preferredDeliveryMethod |
( 2.5.4.28 NAME 'preferredDeliveryMethod' |
|
5.30. presentationAddress |
This attribute contains an OSI presentation address. ( 2.5.4.29 NAME
'presentationAddress' |
|
5.31. supportedApplicationContext |
This attribute contains the identifiers of OSI application contexts. ( 2.5.4.30 NAME 'supportedApplicationContext' |
|
5.32. member |
( 2.5.4.31 NAME 'member' SUP distinguishedName ) |
|
5.33. owner |
( 2.5.4.32 NAME 'owner' SUP distinguishedName ) |
|
5.34. roleOccupant |
( 2.5.4.33 NAME 'roleOccupant' SUP distinguishedName ) |
|
5.35. seeAlso |
( 2.5.4.34 NAME 'seeAlso' SUP distinguishedName ) |
|
5.36. userPassword |
Passwords are stored using an Octet String syntax and are not encrypted. Transfer of cleartext passwords are strongly discouraged where the underlying transport service cannot guarantee confidentiality and may result in disclosure of the password to unauthorized parties. ( 2.5.4.35 NAME 'userPassword' EQUALITY octetStringMatch |
|
5.37. userCertificate |
This attribute is to be stored and requested in the binary form, as 'userCertificate;binary'. ( 2.5.4.36 NAME 'userCertificate' |
|
5.38. cACertificate |
This attribute is to be stored and requested in the binary form, as 'cACertificate;binary'. ( 2.5.4.37 NAME
'cACertificate' |
|
5.39. authorityRevocationList |
This attribute is to be stored and requested in the binary form, as 'authorityRevocationList;binary'. ( 2.5.4.38 NAME
'authorityRevocationList' |
|
5.40. certificateRevocationList |
This attribute is to be stored and requested in the binary form, as 'certificateRevocationList;binary'. ( 2.5.4.39 NAME
'certificateRevocationList' |
|
5.41. crossCertificatePair |
This attribute is to be stored and requested in the binary form, as 'crossCertificatePair;binary'. ( 2.5.4.40 NAME
'crossCertificatePair' |
|
5.42. name |
The name attribute type is the attribute supertype from which string attribute 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 |
|
5.43. givenName |
The givenName attribute 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 ) |
|
5.44. initials |
The initials attribute contains the initials of some or all of an individuals names, but not the surname(s). ( 2.5.4.43 NAME 'initials' SUP name ) |
|
5.45. generationQualifier |
The generationQualifier attribute contains the part of the name which typically is the suffix, as in "IIIrd". ( 2.5.4.44 NAME 'generationQualifier' SUP name ) |
|
5.46. x500UniqueIdentifier |
The x500UniqueIdentifier attribute is used to distinguish between objects when a distinguished name has been reused. This is a different attribute type from both the "uid" and "uniqueIdentifier" types. ( 2.5.4.45 NAME
'x500UniqueIdentifier' EQUALITY bitStringMatch |
|
5.47. dnQualifier |
The dnQualifier attribute 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 |
|
5.48. enhancedSearchGuide |
This attribute is for use by X.500 clients in constructing search filters. ( 2.5.4.47 NAME 'enhancedSearchGuide' |
|
5.49. protocolInformation |
This attribute is used in conjunction with the presentationAddress attribute, to provide additional information to the OSI network service. ( 2.5.4.48 NAME 'protocolInformation' |
|
5.50. distinguishedName |
This attribute 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 |
|
5.51. uniqueMember |
( 2.5.4.50 NAME 'uniqueMember' EQUALITY uniqueMemberMatch |
|
5.52. houseIdentifier |
This attribute is used to identify a building within a location. ( 2.5.4.51 NAME 'houseIdentifier' EQUALITY caseIgnoreMatch |
|
5.53. supportedAlgorithms |
This attribute is to be stored and requested in the binary form, as 'supportedAlgorithms;binary'. ( 2.5.4.52 NAME 'supportedAlgorithms' |
|
5.54. deltaRevocationList |
This attribute is to be stored and requested in the binary form, as 'deltaRevocationList;binary'. ( 2.5.4.53 NAME 'deltaRevocationList' |
|
5.55. dmdName |
The value of this attribute specifies a directory management domain (DMD), the administrative authority which operates the directory server. ( 2.5.4.54 NAME 'dmdName' SUP name ) |
| 8. Matching Rules | |
|
Servers MAY implement additional matching rules. |
|
|
8.1. octetStringMatch |
Servers which implement the extensibleMatch filter SHOULD allow the matching rule listed in this section to be used in the extensibleMatch. In general these servers SHOULD allow matching rules to be used with all attribute types known to the server, when the assertion syntax of the matching rule is the same as the value syntax of the attribute. ( 2.5.13.17 NAME 'octetStringMatch' |
| 9. Security Considerations | |
|
|
The definitions on which this document have been developed by committees for telecommunications and international standards. No new attribute definitions have been added. The syntax definitions are based on the ISODE "QUIPU" implementation of X.500.
[1] Wahl, M., Coulbeck, A., Howes, T., and S. Kille, "Lightweight X.500 Directory Access Protocol (v3): Attribute Syntax Definitions", RFC 2252, December 1997.
[2] The Directory: Models. ITU-T Recommendation X.501, 1996.
[3] The Directory: Authentication Framework. ITU-T Recommendation X.509, 1996.
[4] The Directory: Selected Attribute Types. ITU-T Recommendation X.520, 1996.
[5] The Directory: Selected Object Classes. ITU-T Recommendation X.521, 1996.
[6] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119, March 1997.
Mark Wahl, Critical
Angle Inc., 4815 West Braker Lane #502-385, Austin, TX 78759, USA
Phone: +1 512 372 3160, EMail: M.Wahl@critical-angle.com
Copyright (C) The Internet Society (1997). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English.
The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns.
This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.