From 5e836e59d9c84fef5da2603eabeb715c02d012c7 Mon Sep 17 00:00:00 2001 From: Kurt Zeilenga Date: Mon, 13 Aug 2007 16:17:32 +0000 Subject: [PATCH] Add RFC 5020 (entryDN). --- doc/drafts/draft-zeilenga-ldap-entrydn-xx.txt | 283 ------------------ doc/rfc/INDEX | 1 + doc/rfc/rfc5020.txt | 283 ++++++++++++++++++ 3 files changed, 284 insertions(+), 283 deletions(-) delete mode 100644 doc/drafts/draft-zeilenga-ldap-entrydn-xx.txt create mode 100644 doc/rfc/rfc5020.txt diff --git a/doc/drafts/draft-zeilenga-ldap-entrydn-xx.txt b/doc/drafts/draft-zeilenga-ldap-entrydn-xx.txt deleted file mode 100644 index 083ed39f09..0000000000 --- a/doc/drafts/draft-zeilenga-ldap-entrydn-xx.txt +++ /dev/null @@ -1,283 +0,0 @@ - - - - - - -INTERNET-DRAFT Kurt D. Zeilenga -Intended Category: Standard Track Isode Limited -Expires in six months 14 February 2007 - - - - The LDAP entryDN Operational Attribute - - - - -Status of this Memo - - This document is intended to be, after appropriate review and - revision, submitted to the RFC Editor as an Standard Track document. - Distribution of this memo is unlimited. Technical discussion of this - document will take place on the IETF LDAP Extensions mailing list - . Please send editorial comments directly to the - author . - - By submitting this Internet-Draft, each author represents that any - applicable patent or other IPR claims of which he or she is aware have - been or will be disclosed, and any of which he or she becomes aware - will be disclosed, in accordance with Section 6 of BCP 79. - - Internet-Drafts are working documents of the Internet Engineering Task - Force (IETF), its areas, and its working groups. Note that other - groups may also distribute working documents as Internet-Drafts. - - Internet-Drafts are draft documents valid for a maximum of six months - and may be updated, replaced, or obsoleted by other documents at any - time. It is inappropriate to use Internet-Drafts as reference material - or to cite them other than as "work in progress." - - The list of current Internet-Drafts can be accessed at - http://www.ietf.org/1id-abstracts.html. - - The list of Internet-Draft Shadow Directories can be accessed at - http://www.ietf.org/shadow.html. - - - Copyright (C) The IETF Trust (2007). All Rights Reserved. - - Please see the Full Copyright section near the end of this document - for more information. - - - - - - -Zeilenga draft-zeilenga-ldap-entrydn-01 [Page 1] - -INTERNET-DRAFT LDAP entryDN 14 February 2007 - - -Abstract - - This document describes the LDAP/X.500 'entryDN' operational - attribute. The attribute provides a copy of the entry's distinguished - name for use in attribute value assertions. - - -1. Background and Intended Use - - In X.500 Directory Services [X.501], such as those accessible using - the Lightweight Directory Access Protocol (LDAP) [RFC4510], an entry - is identified by its distinguished name (DN) [RFC4512]. However, as - an entry's DN is not an attribute of the entry, it is not possible to - perform attribute value assertions [RFC4511] against it. - - This document describes the 'entryDN' operational attribute which - holds a copy of the entry's distributed name. This attribute may be - used in search filters. For instance, searching the subtree - with the filter: - (entryDN:componentFilterMatch:=or:{ - item:{ component "3", rule rdnMatch, value "ou=A" }, - item:{ component "3", rule rdnMatch, value "ou=B" } }) - would return entries in the subtree and - entries in subtree , but would not return any - other entries in the subtree . - - In this document, DNs are presented using the string representation - defined in [RFC4514]. Search filters above is described using the - string representation defined in [RFC4515] with whitespace (line - breaks and indentation) added to improve readability. The - 'componetFilterMatch' and 'rdnMatch' rules are specified in [RFC3687]. - - Schema definitions are provided using LDAP description formats - [RFC4512]. Definitions provided here are formatted (line wrapped) for - readability. - - 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 BCP 14 [RFC2119]. - - -2. 'entryDN' Operational Attribute - - The 'entryDN' operational attribute provides a copy of the entry's - current DN. - - The following is a LDAP attribute type description suitable for - publication in subschema subentries. - - - -Zeilenga draft-zeilenga-ldap-entrydn-01 [Page 2] - -INTERNET-DRAFT LDAP entryDN 14 February 2007 - - - ( IANA-ASSIGNED-OID NAME 'entryDN' - DESC 'DN of the entry' - EQUALITY distinguishedNameMatch - SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 - SINGLE-VALUE - NO-USER-MODIFICATION - USAGE directoryOperation ) - - Note that the DN of the entry cannot be modified through this - attribute. - - -3. Security Considerations - - As this attribute only provides an additional mechanism to access an - entry's DN, the introduction of this attribute is not believed to - introduce new security considerations. - - -4. IANA Considerations - -4.1. Object Identifier Registration - - It is requested that IANA register upon Standards Action assign an - LDAP Object Identifier [RFC4520] for use in this document. - - Subject: Request for LDAP OID Registration - Person & email address to contact for further information: - Kurt Zeilenga - Specification: RFC XXXX - Author/Change Controller: IESG - Comments: - Identifies the 'entryDN' attribute type - - -5.4. 'entryDN' Descriptor Registration - - It is requested that IANA register upon Standards Action the LDAP - 'entryDN' descriptor [RFC4520]. - - Subject: Request for LDAP Descriptor Registration - Descriptor (short name): entryDN - Object Identifier: IANA-ASSIGNED-OID - Person & email address to contact for further information: - Kurt Zeilenga - Usage: Attribute Type - Specification: RFC XXXX - Author/Change Controller: IESG - - - -Zeilenga draft-zeilenga-ldap-entrydn-01 [Page 3] - -INTERNET-DRAFT LDAP entryDN 14 February 2007 - - -6. Acknowledgments - - TBD. - - -7. Author's Address - - Kurt D. Zeilenga - Isode Limited - - Email: Kurt.Zeilenga@Isode.COM - - -8. References - - -8.1. Normative References - - [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate - Requirement Levels", BCP 14 (also RFC 2119), March 1997. - - [RFC4510] Zeilenga, K. (editor), "LDAP: Technical Specification - Road Map", RFC 4510, June 2006. - - [RFC4512] Zeilenga, K. (editor), "LDAP: Directory Information - Models", RFC 4512, June 2006. - - [X.501] International Telecommunication Union - - Telecommunication Standardization Sector, "The Directory - -- Models," X.501(1993) (also ISO/IEC 9594-2:1994). - - -8.2. Informative References - - [RFC3687] Legg, S., "Lightweight Directory Access Protocol (LDAP) - and X.500 Component Matching Rules", RFC 3687, February - 2004. - - [RFC4511] Sermersheim, J. (editor), "LDAP: The Protocol", RFC - 4511, June 2006. - - [RFC4514] Zeilenga, K. (editor), "LDAP: String Representation of - Distinguished Names", RFC 4514, June 2006. - - [RFC4515] Smith, M. (editor), "LDAP: String Representation of - Search Filters", RFC 4515, June 2006. - - [RFC4520] Zeilenga, K., "Internet Assigned Numbers Authority - - - -Zeilenga draft-zeilenga-ldap-entrydn-01 [Page 4] - -INTERNET-DRAFT LDAP entryDN 14 February 2007 - - - (IANA) Considerations for the Lightweight Directory - Access Protocol (LDAP)", RFC 4520, BCP 64, June 2006. - - - -Intellectual Property - - The IETF takes no position regarding the validity or scope of any - Intellectual Property Rights or other rights that might be claimed to - pertain to the implementation or use of the technology described in - this document or the extent to which any license under such rights - might or might not be available; nor does it represent that it has - made any independent effort to identify any such rights. Information - on the procedures with respect to rights in RFC documents can be found - in BCP 78 and BCP 79. - - Copies of IPR disclosures made to the IETF Secretariat and any - assurances of licenses to be made available, or the result of an - attempt made to obtain a general license or permission for the use of - such proprietary rights by implementers or users of this specification - can be obtained from the IETF on-line IPR repository at - http://www.ietf.org/ipr. - - The IETF invites any interested party to bring to its attention any - copyrights, patents or patent applications, or other proprietary - rights that may cover technology that may be required to implement - this standard. Please address the information to the IETF at - ietf-ipr@ietf.org. - - - -Full Copyright - - Copyright (C) The IETF Trust (2007). - - This document is subject to the rights, licenses and restrictions - contained in BCP 78, and except as set forth therein, the authors - retain all their rights. - - This document and the information contained herein are provided on an - "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS - OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND - THE INTERNET ENGINEERING TASK FORCE DISCLAIM 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. - - - - - -Zeilenga draft-zeilenga-ldap-entrydn-01 [Page 5] - diff --git a/doc/rfc/INDEX b/doc/rfc/INDEX index 4420833bff..3908e3265d 100644 --- a/doc/rfc/INDEX +++ b/doc/rfc/INDEX @@ -64,6 +64,7 @@ rfc4530.txt LDAP: entryUUID (PS) rfc4531.txt LDAP Turn Operation (E) rfc4532.txt LDAP Who am I? Operation (PS) rfc4533.txt LDAP Content Sync Operation (E) +rfc5020.txt LDAP 'entryDN' operational attribute (PS) Legend: STD Standard diff --git a/doc/rfc/rfc5020.txt b/doc/rfc/rfc5020.txt new file mode 100644 index 0000000000..e289f8b337 --- /dev/null +++ b/doc/rfc/rfc5020.txt @@ -0,0 +1,283 @@ + + + + + + +Network Working Group K. Zeilenga +Request for Comments: 5020 Isode Limited +Category: Standards Track August 2007 + + + The Lightweight Directory Access Protocol (LDAP) entryDN + Operational Attribute + +Status of This Memo + + 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. + +Copyright Notice + + Copyright (C) The IETF Trust (2007). + +Abstract + + This document describes the Lightweight Directory Access Protocol + (LDAP) / X.500 'entryDN' operational attribute. The attribute + provides a copy of the entry's distinguished name for use in + attribute value assertions. + + + + + + + + + + + + + + + + + + + + + + + + + +Zeilenga Standards Track [Page 1] + +RFC 5020 LDAP entryDN August 2007 + + +1. Background and Intended Use + + In X.500 Directory Services [X.501], such as those accessible using + the Lightweight Directory Access Protocol (LDAP) [RFC4510], an entry + is identified by its distinguished name (DN) [RFC4512]. However, as + an entry's DN is not an attribute of the entry, it is not possible to + perform attribute value assertions [RFC4511] against it. + + This document describes the 'entryDN' operational attribute which + holds a copy of the entry's distinguished name. This attribute may + be used in search filters. For instance, searching the subtree + with the filter: + + (entryDN:componentFilterMatch:=or:{ + item:{ component "3", rule rdnMatch, value "ou=A" }, + item:{ component "3", rule rdnMatch, value "ou=B" } }) + + would return entries in the subtree and + entries in subtree , but would not return any + other entries in the subtree . + + In the above paragraph, DNs are presented using the string + representation defined in [RFC4514], and the example search filter is + presented using the string representation defined in [RFC4515] with + whitespace (line breaks and indentation) added to improve + readability. The 'componentFilterMatch' and 'rdnMatch' rules are + specified in [RFC3687]. + + Schema definitions are provided using LDAP description formats + [RFC4512]. Definitions provided here are formatted (line wrapped) + for readability. + +2. 'entryDN' Operational Attribute + + The 'entryDN' operational attribute provides a copy of the entry's + current DN. + + The following is an LDAP attribute type description suitable for + publication in subschema subentries. + + ( 1.3.6.1.1.20 NAME 'entryDN' + DESC 'DN of the entry' + EQUALITY distinguishedNameMatch + SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 + SINGLE-VALUE + NO-USER-MODIFICATION + USAGE directoryOperation ) + + + + +Zeilenga Standards Track [Page 2] + +RFC 5020 LDAP entryDN August 2007 + + + Note that the DN of the entry cannot be modified through this + attribute. + +3. Security Considerations + + As this attribute only provides an additional mechanism to access an + entry's DN, the introduction of this attribute is not believed to + introduce new security considerations. + +4. IANA Considerations + +4.1. Object Identifier Registration + + IANA has registered (upon Standards Action) an LDAP Object Identifier + [RFC4520] for use in this document. + + Subject: Request for LDAP OID Registration + Person & email address to contact for further information: + Kurt Zeilenga + Specification: RFC 5020 + Author/Change Controller: IESG + Comments: + Identifies the 'entryDN' attribute type + +4.2. 'entryDN' Descriptor Registration + + IANA has registered (upon Standards Action) the LDAP 'entryDN' + descriptor [RFC4520]. + + Subject: Request for LDAP Descriptor Registration + Descriptor (short name): entryDN + Object Identifier: 1.3.6.1.1.20 + Person & email address to contact for further information: + Kurt Zeilenga + Usage: Attribute Type + Specification: RFC 5020 + Author/Change Controller: IESG + + + + + + + + + + + + + + +Zeilenga Standards Track [Page 3] + +RFC 5020 LDAP entryDN August 2007 + + +5. References + +5.1. Normative References + + [RFC4510] Zeilenga, K., Ed., "Lightweight Directory Access Protocol + (LDAP): Technical Specification Road Map", RFC 4510, June + 2006. + + [RFC4512] Zeilenga, K., Ed., "Lightweight Directory Access Protocol + (LDAP): Directory Information Models", RFC 4512, June + 2006. + + [X.501] International Telecommunication Union - Telecommunication + Standardization Sector, "The Directory -- Models," + X.501(1993) (also ISO/IEC 9594-2:1994). + +5.2. Informative References + + [RFC3687] Legg, S., "Lightweight Directory Access Protocol (LDAP) + and X.500 Component Matching Rules", RFC 3687, February + 2004. + + [RFC4511] Sermersheim, J., Ed., "Lightweight Directory Access + Protocol (LDAP): The Protocol", RFC 4511, June 2006. + + [RFC4514] Zeilenga, K., Ed., "Lightweight Directory Access Protocol + (LDAP): String Representation of Distinguished Names", + RFC 4514, June 2006. + + [RFC4515] Smith, M., Ed., and T. Howes, "Lightweight Directory + Access Protocol (LDAP): String Representation of Search + Filters", RFC 4515, June 2006. + + [RFC4520] Zeilenga, K., "Internet Assigned Numbers Authority (IANA) + Considerations for the Lightweight Directory Access + Protocol (LDAP)", BCP 64, RFC 4520, June 2006. + +Author's Address + + Kurt D. Zeilenga + Isode Limited + + EMail: Kurt.Zeilenga@Isode.COM + + + + + + + + +Zeilenga Standards Track [Page 4] + +RFC 5020 LDAP entryDN August 2007 + + +Full Copyright Statement + + Copyright (C) The IETF Trust (2007). + + This document is subject to the rights, licenses and restrictions + contained in BCP 78, and except as set forth therein, the authors + retain all their rights. + + This document and the information contained herein are provided on an + "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS + OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND + THE INTERNET ENGINEERING TASK FORCE DISCLAIM 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. + +Intellectual Property + + The IETF takes no position regarding the validity or scope of any + Intellectual Property Rights or other rights that might be claimed to + pertain to the implementation or use of the technology described in + this document or the extent to which any license under such rights + might or might not be available; nor does it represent that it has + made any independent effort to identify any such rights. Information + on the procedures with respect to rights in RFC documents can be + found in BCP 78 and BCP 79. + + Copies of IPR disclosures made to the IETF Secretariat and any + assurances of licenses to be made available, or the result of an + attempt made to obtain a general license or permission for the use of + such proprietary rights by implementers or users of this + specification can be obtained from the IETF on-line IPR repository at + http://www.ietf.org/ipr. + + The IETF invites any interested party to bring to its attention any + copyrights, patents or patent applications, or other proprietary + rights that may cover technology that may be required to implement + this standard. Please address the information to the IETF at + ietf-ipr@ietf.org. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + + + + + + +Zeilenga Standards Track [Page 5] + -- 2.39.5