draft-zeilenga-ldap-uuid-06.txt  -->   rfc4530.txt

view Side-By-Side changes






INTERNET-DRAFT                                      Kurt D.





Network Working Group                                        K. Zeilenga
Intended Category: Standard Track
Request for Comments: 4530                           OpenLDAP Foundation
Expires in six months                               18 July 2005



                 The LDAP
Category: Standards Track                                      June 2006


              Lightweight Directory Access Protocol (LDAP)
                    entryUUID operational attribute
                    <draft-zeilenga-ldap-uuid-06.txt> Operational Attribute


Status of this This Memo

   This document is intended to be, after appropriate review and
  revision, submitted to the RFC Editor as specifies an Standard Track document.
  Distribution of this memo is unlimited.  Technical discussion of this
  document will take place on Internet standards track protocol for the IETF LDAP Extensions mailing list
  <ldapext@ietf.org>.
   Internet community, and requests discussion and suggestions for
   improvements.  Please send editorial comments directly refer to the
  author <Kurt@OpenLDAP.org>.

  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 current edition 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 "Internet
   Official Protocol Standards" (STD 1) for a maximum of six months the standardization state
   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 status of current Internet-Drafts can be accessed at
  http://www.ietf.org/1id-abstracts.html

  The list this protocol.  Distribution of Internet-Draft Shadow Directories can be accessed at
  http://www.ietf.org/shadow.html this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (2005).  All Rights Reserved.

  Please see the Full Copyright section near the end of this document
  for more information. (2006).

Abstract



Zeilenga               draft-zeilenga-ldap-uuid-06              [Page 1]

INTERNET-DRAFT               LDAP entryUUID                 18 July 2005

   This document describes the LDAP/X.500 'entryUUID' operational
   attribute and associated matching rules and syntax.  The attribute
   holds a server-assigned Universally Unique Identifier (UUID) for the
   object.  Directory clients may use this attribute to distinguish
   objects identified by a distinguished name or to locate an object
   after renaming.






















Zeilenga                    Standards Track                     [Page 1]

RFC 4530                     LDAP entryUUID                    June 2006


Table of Contents

   1. Background and Intended Use .....................................2
   2. UUID Schema Elements ............................................3
      2.1. UUID Syntax ................................................3
      2.2. 'uuidMatch' Matching Rule ..................................3
      2.3. 'uuidOrderingMatch' Matching Rule ..........................3
      2.4. 'entryUUID' Attribute ......................................4
   3. Security Considerations .........................................4
   4. IANA Considerations .............................................5
      4.1. Object Identifier Registration .............................5
      4.2. UUID Syntax Registration ...................................5
      4.3. 'uuidMatch' Descriptor Registration ........................5
      4.4. 'uuidOrderingMatch' Descriptor Registration ................5
      4.5. 'entryUUID' Descriptor Registration ........................6
   5. Acknowledgements ................................................6
   6. References ......................................................6
      6.1. Normative References .......................................6
      6.2. Informative References .....................................7

1.  Background and Intended Use

   In X.500 Directory Services [X.501], such as those accessible using
   the Lightweight Directory Access Protocol (LDAP) [Roadmap], [RFC4510], an object
   is identified by its distinguished name (DN).  However, DNs are not
   stable identifiers.  That is, a new object may be identified by a DN
  which
   that previously identified another (now renamed or deleted) object.

   A Universally Unique Identifier (UUID) is "an identifier unique
   across both space and time, with respect to the space of all UUIDs"
  [UUIDURN].
   [RFC4122].  UUIDs are used in a wide range of systems.

   This document describes the 'entryUUID' operational attribute attribute, which
   holds the UUID assigned to the object by the server.  Clients may use
   this attribute to distinguish objects identified by a particular
   distinguished name or to locate a particular object after renaming.

   This document defines the UUID syntax, the 'uuidMatch' and
   'uuidOrderingMatch' matching rules, and the 'entryUUID' attribute
   type.

   Schema definitions are provided using LDAP description formats
  [Models].
   [RFC4512].  Definitions provided here are formatted (line wrapped)
   for readability.

  The







Zeilenga                    Standards Track                     [Page 2]

RFC 4530                     LDAP entryUUID                    June 2006


   In this document, 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.  UUID Schema Elements

2.1

2.1.  UUID Syntax

   A Universally Unique Identifier (UUID) [UUIDURN] [RFC4122] is a 16-octet
  (128-bit) (128-
   bit) value which that identifies an object.  The ASN.1 [X.680] type UUID is
   defined to represent UUIDs as follows:

       UUID ::= OCTET STRING (SIZE(16))
             -- constrained to an UUID [UUIDURN]



Zeilenga               draft-zeilenga-ldap-uuid-06              [Page 2]

INTERNET-DRAFT               LDAP entryUUID                 18 July 2005 [RFC4122]

   In LDAP, UUID values are encoded using the [ASCII] character string
   representation described in [UUIDURN]. [RFC4122].  For example,
   "597ae2f6-16a6-1027-98f4-d28b5365dc14".

   The following is a an LDAP syntax description suitable for publication
   in subschema subentries.

       ( IANA-ASSIGNED-OID.1 1.3.6.1.1.16.1 DESC 'UUID' )


2.2

2.2.  'uuidMatch' Matching Rule

   The 'uuidMatch' matching rule compares an asserted UUID with a stored
   UUID for equality.  Its semantics are the same as the
   'octetStringMatch'
  [X.520][Syntaxes] [X.520][RFC4517] matching rule.  The rule differs
   from 'octetStringMatch' in that the assertion value is encoded using
   the UUID string representation instead of the normal OCTET STRING
   string representation.

   The following is a an LDAP matching rule description suitable for
   publication in subschema subentries.

       ( IANA-ASSIGNED-OID.2 1.3.6.1.1.16.2 NAME 'uuidMatch'
           SYNTAX IANA-ASSIGNED-OID.1 1.3.6.1.1.16.1 )


2.3

2.3.  'uuidOrderingMatch' Matching Rule

   The 'uuidOrderingMatch' matching rule compares an asserted UUID with
   a stored UUID for ordering.  Its semantics are the same as the
   'octetStringOrderingMatch' [X.520][Syntaxes] [X.520][RFC4517] matching rule.  The rule
   differs from 'octetStringOrderingMatch' in that the assertion value
   is encoded using the UUID string representation instead of the normal
   OCTET STRING string representation.



Zeilenga                    Standards Track                     [Page 3]

RFC 4530                     LDAP entryUUID                    June 2006


   The following is a an LDAP matching rule description suitable for
   publication in subschema subentries.

       ( IANA-ASSIGNED-OID.3 1.3.6.1.1.16.3 NAME 'uuidOrderingMatch'
           SYNTAX IANA-ASSIGNED-OID.1 1.3.6.1.1.16.1 )

  It is noted

   Note that not all UUID variants have a defined ordering and, ordering; and even
   where so, it does, servers are not obligated to assign UUIDs in any
   particular order.  This matching rule is provided for completeness.

2.4.  'entryUUID' attribute




Zeilenga               draft-zeilenga-ldap-uuid-06              [Page 3]

INTERNET-DRAFT               LDAP entryUUID                 18 July 2005 Attribute

   The 'entryUUID' operational attribute provides the Universally Unique
   Identifier (UUID) assigned to the entry.

   The following is a an LDAP attribute type description suitable for
   publication in subschema subentries.

       ( IANA-ASSIGNED-OID.4 1.3.6.1.1.16.4 NAME 'entryUUID'
           DESC 'UUID of the entry'
           EQUALITY uuidMatch
           ORDERING uuidOrderingMatch
           SYNTAX IANA-ASSIGNED-OID.1 1.3.6.1.1.16.1
           SINGLE-VALUE
           NO-USER-MODIFICATION
           USAGE directoryOperation )

   Servers SHALL generate and assign a new UUID to each entry upon its
   addition to the directory and provide that UUID as the value of the
   'entryUUID' operational attribute.  An entry's UUID is immutable.

   UUID are to be generated in accordance with Section 4 of [UUIDURN]. [RFC4122].
   In particular, servers MUST ensure that each generated UUID is unique
   in space and time.

3.  Security Considerations

   An entry's relative distinguish name (RDN) is composed from attribute
   values of the entry, values which are commonly descriptive of the object the
   entry represents.  While  Although deployers are encouraged to use naming
   attributes whose values are widely disclosable [LDAPDN], [RFC4514], entries are
   often named using information which that cannot be disclosed to all
   parties.  As UUIDs do not contain any descriptive information of the
   object they identify, UUIDs may be used to identify a particular
   entry without disclosure of its contents.

   General UUID security considerations [UUIDURN] [RFC4122] apply.




Zeilenga                    Standards Track                     [Page 4]

RFC 4530                     LDAP entryUUID                    June 2006


   General LDAP security considerations [RFC3377] [RFC4510] apply.

4.  IANA Considerations

  It is requested that

   The IANA register upon Standards Action has registered the LDAP values [RFC4520] specified in this
   document.

4.1.  Object Identifier Registration




Zeilenga               draft-zeilenga-ldap-uuid-06              [Page 4]

INTERNET-DRAFT               LDAP entryUUID                 18 July 2005

       Subject: Request for LDAP OID Registration
       Person & email address to contact for further information:
           Kurt Zeilenga <kurt@OpenLDAP.org>
       Specification: RFC XXXX 4530
       Author/Change Controller: IESG
       Comments:
           Identifies the UUID schema elements

4.2.  UUID Syntax Registration

       Subject: Request for LDAP Syntax Registration
       Object Identifier: IANA-ASSIGNED-OID.1 1.3.6.1.1.16.1
       Description: UUID
       Person & email address to contact for further information:
           Kurt Zeilenga <kurt@OpenLDAP.org>
       Specification: RFC XXXX 4530
       Author/Change Controller: IESG
       Comments:
            Identifies the UUID syntax

4.3.  'uuidMatch' Descriptor Registration

       Subject: Request for LDAP Descriptor Registration
       Descriptor (short name): uuidMatch
       Object Identifier: IANA-ASSIGNED-OID.2 1.3.6.1.1.16.2
       Person & email address to contact for further information:
           Kurt Zeilenga <kurt@OpenLDAP.org>
       Usage: Matching Rule
       Specification: RFC XXXX 4530
       Author/Change Controller: IESG


4.3.

4.4.  'uuidOrderingMatch' Descriptor Registration

       Subject: Request for LDAP Descriptor Registration
       Descriptor (short name): uuidOrderingMatch
       Object Identifier: IANA-ASSIGNED-OID.3 1.3.6.1.1.16.3
       Person & email address to contact for further information:
           Kurt Zeilenga <kurt@OpenLDAP.org>
       Usage: Matching Rule



Zeilenga                    Standards Track                     [Page 5]

RFC 4530                     LDAP entryUUID                    June 2006


       Specification: RFC XXXX 4530
       Author/Change Controller: IESG


5.4.

4.5.  'entryUUID' Descriptor Registration




Zeilenga               draft-zeilenga-ldap-uuid-06              [Page 5]

INTERNET-DRAFT               LDAP entryUUID                 18 July 2005


  It is requested that

   The IANA register upon Standards Action has registered the LDAP 'entryUUID' descriptor.

       Subject: Request for LDAP Descriptor Registration
       Descriptor (short name): entryUUID
       Object Identifier: IANA-ASSIGNED-OID.4 1.3.6.1.1.16.4
       Person & email address to contact for further information:
           Kurt Zeilenga <kurt@OpenLDAP.org>
       Usage: Attribute Type
       Specification: RFC XXXX 4530
       Author/Change Controller: IESG


6. Acknowledgments

5.  Acknowledgements

   This document is based upon discussions in the LDAP Update and
   Duplication Protocols (LDUP) WG.  Members of the LDAP Directorate
   provided review.


7. Author's Address

  Kurt D. Zeilenga
  OpenLDAP Foundation

  Email: Kurt@OpenLDAP.org


8.

6.  References

  [[Note to the RFC Editor: please replace the citation tags used in
  referencing Internet-Drafts with tags of the form RFCnnnn where
  possible.]]


8.1.

6.1.  Normative References

   [RFC2119]     Bradner, S., "Key words for use in RFCs to Indicate
                 Requirement Levels", BCP 14 (also 14, RFC 2119), 2119, March 1997.

  [Roadmap]     Zeilenga, K. (editor), "LDAP: Technical Specification
                Road Map", draft-ietf-ldapbis-roadmap-xx.txt, a work in
                progress.

  [UUIDURN]

   [RFC4122]     Leach, P, M. P., Mealling, M., and R. Salz, "A UUID Universally
                 Unique IDentifier (UUID) URN Namespace",
                a work in progress.

  [Models] RFC 4122, July
                 2005.

   [RFC4510]     Zeilenga, K. (editor), "LDAP: K., Ed., "Lightweight Directory Access
                 Protocol (LDAP): Technical Specification Road Map", RFC
                 4510, June 2006.

   [RFC4512]     Zeilenga, K., "Lightweight Directory Access Protocol
                 (LDAP): Directory Information



Zeilenga               draft-zeilenga-ldap-uuid-06              [Page 6]

INTERNET-DRAFT               LDAP entryUUID                 18 July 2005 Models", draft-ietf-ldapbis-models-xx.txt, a work in
                progress.

  [Syntaxes] RFC 4512, June
                 2006.

   [RFC4517]     Legg, S. (editor), "LDAP: S., Ed., "Lightweight Directory Access Protocol
                 (LDAP): Syntaxes and Matching Rules",
                draft-ietf-ldapbis-syntaxes-xx.txt, a work in progress. RFC 4517, June
                 2006.

   [ASCII]       Coded Character Set--7-bit American Standard Code for
                 Information Interchange, ANSI X3.4-1986.




Zeilenga                    Standards Track                     [Page 6]

RFC 4530                     LDAP entryUUID                    June 2006


   [X.501]       International Telecommunication Union -
                 Telecommunication Standardization Sector, "The
                 Directory -- Models," X.501(1993) (also ISO/IEC 9594-2:1994). 9594-
                 2:1994).

   [X.520]       International Telecommunication Union -
                 Telecommunication Standardization Sector, "The
                 Directory: Selected Attribute Types", X.520(1993) (also
                 ISO/IEC 9594-6:1994).

   [X.680]       International Telecommunication Union -
                 Telecommunication Standardization Sector, "Abstract
                 Syntax Notation One (ASN.1) - Specification of Basic
                 Notation", X.680(2002) (also ISO/IEC 8824-1:2002).



8.2.

6.2.  Informative References

  [LDAPDN]

   [RFC4514]     Zeilenga, K. (editor), "LDAP: K., Ed., "Lightweight Directory Access
                 Protocol (LDAP): String Representation of Distinguished
                 Names", draft-ietf-ldapbis-dn-xx.txt, a
                work in progress.

  [BCP64bis] RFC 4514, June 2006.

   [RFC4520]     Zeilenga, K., "IANA "Internet Assigned Numbers Authority
                 (IANA) Considerations for LDAP",
                draft-ietf-ldapbis-bcp64-xx.txt, a work the Lightweight Directory
                 Access Protocol (LDAP)", BCP 64, RFC 4520, June 2006.

Author's Address

   Kurt D. Zeilenga
   OpenLDAP Foundation

   EMail: Kurt@OpenLDAP.org




















Zeilenga                    Standards Track                     [Page 7]

RFC 4530                     LDAP entryUUID                    June 2006


Full Copyright Statement

   Copyright (C) The Internet Society (2006).

   This document is subject to the rights, licenses and restrictions
   contained in progress. 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 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 Rights

   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



Zeilenga               draft-zeilenga-ldap-uuid-06              [Page 7]

INTERNET-DRAFT               LDAP entryUUID                 18 July 2005
   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 Internet Society (2005).

  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

Acknowledgement

   Funding for the information contained herein are RFC Editor function is provided on an
  "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
  OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY 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. by the IETF
   Administrative Support Activity (IASA).







Zeilenga               draft-zeilenga-ldap-uuid-06                    Standards Track                     [Page 8]

----