mirror of
https://git.openldap.org/openldap/openldap.git
synced 2024-12-21 03:10:25 +08:00
844 lines
28 KiB
Plaintext
844 lines
28 KiB
Plaintext
|
||
|
||
|
||
|
||
|
||
|
||
INTERNET-DRAFT Kurt D. Zeilenga
|
||
Intended Category: Standard Track OpenLDAP Foundation
|
||
Expires in six months 3 May 2003
|
||
|
||
|
||
|
||
LDAP: Grouping of Related Operations
|
||
<draft-zeilenga-ldap-grouping-06.txt>
|
||
|
||
|
||
Status of Memo
|
||
|
||
This document is an Internet-Draft and is in full conformance with all
|
||
provisions of Section 10 of RFC2026.
|
||
|
||
This document is intended to be, after appropriate review and
|
||
revision, submitted to the RFC Editor as a Standard Track document.
|
||
Distribution of this memo is unlimited. Technical discussion of this
|
||
document will take place on the IETF LDAP Extension Working Group
|
||
mailing list <ldapext@ietf.org>. Please send editorial comments
|
||
directly to the author <Kurt@OpenLDAP.org>.
|
||
|
||
Internet-Drafts are working documents of the Internet Engineering Task
|
||
Force (IETF), its areas, and its working groups. Note that other
|
||
groups may also distribute working documents as Internet-Drafts.
|
||
Internet-Drafts are draft documents valid for a maximum of six months
|
||
and may be updated, replaced, or obsoleted by other documents at any
|
||
time. It is inappropriate to use Internet-Drafts as reference
|
||
material or to cite them other than as ``work in progress.''
|
||
|
||
The list of current Internet-Drafts can be accessed at
|
||
<http://www.ietf.org/ietf/1id-abstracts.txt>. The list of
|
||
Internet-Draft Shadow Directories can be accessed at
|
||
<http://www.ietf.org/shadow.html>.
|
||
|
||
Copyright 2003, The Internet Society. All Rights Reserved.
|
||
|
||
Please see the Copyright section near the end of this document for
|
||
more information.
|
||
|
||
|
||
Abstract
|
||
|
||
This document provides a general mechanism for grouping related
|
||
Lightweight Directory Access Protocol (LDAP) operations. Grouping of
|
||
operations can be used to support replication, proxies, and
|
||
transactions.
|
||
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 1]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
Conventions
|
||
|
||
Schema definitions are provided using LDAP description formats
|
||
[RFC2252]. Definitions provided here are formatted (line wrapped) for
|
||
readability.
|
||
|
||
Protocol elements are described using ASN.1 [X.680]. The term
|
||
"BER-encoded" means the element is to be encoded using the Basic
|
||
Encoding Rules [X.690] under the restrictions detailed in Section 5.1
|
||
of [RFC2251].
|
||
|
||
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].
|
||
|
||
|
||
1. Introduction
|
||
|
||
This document provides a general mechanism for grouping related
|
||
Lightweight Directory Access Protocol (LDAP) [RFC3377] operations.
|
||
Grouping of operations can be used to support replication, proxies,
|
||
and high level operations such as transactions [TXNGRP].
|
||
|
||
This document describes a set of LDAP extended operations [RFC2251]
|
||
and other protocol and schema elements to support grouping of related
|
||
operations. Uses of this grouping mechanism will be detailed in
|
||
separate documents.
|
||
|
||
A group of operations is defined as a set of operations within a
|
||
common session identified by a unique cookie. All requests which are
|
||
initiated with the same cookie belong to the same grouping. The
|
||
cookie is obtained using the create group operation and is normally
|
||
valid until the end group operation is completed. A group can end
|
||
prematurely as described below.
|
||
|
||
Operations can be intermixed regardless of their grouping (or lack of
|
||
grouping). Groups can be nested.
|
||
|
||
Each group is of a particular type specified when the group is
|
||
created. This type defines the semantics of the group.
|
||
|
||
|
||
2. Protocol Elements
|
||
|
||
This document describes three extended operations, two unsolicited
|
||
notification, and one control. Extended operations and controls are
|
||
described by LDAP [RFC2251] and provide here for convenience:
|
||
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 2]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
ExtendedRequest ::= [APPLICATION 23] SEQUENCE {
|
||
requestName [0] LDAPOID,
|
||
requestValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
ExtendedResponse ::= [APPLICATION 24] SEQUENCE {
|
||
COMPONENTS of LDAPResult,
|
||
responseName [10] LDAPOID OPTIONAL,
|
||
response [11] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
Control ::= SEQUENCE {
|
||
controlType LDAPOID,
|
||
criticality BOOLEAN DEFAULT FALSE,
|
||
controlValue OCTET STRING OPTIONAL
|
||
}
|
||
|
||
|
||
2.1 Common Protocol Elements
|
||
|
||
groupCookie ::= OCTET STRING
|
||
|
||
A groupCookie is an octet string used to uniquely identify a grouping
|
||
of related operations within the session. A groupCookie is a
|
||
notational convenience.
|
||
|
||
|
||
2.2 Create Grouping Operation
|
||
|
||
The Create Grouping extended operation is used to create or start a
|
||
grouping of related operations. The operation consists of the
|
||
createGroupingRequest and the createGroupingResponse. The object
|
||
identifier createGroupingOID identifies this operation and SHOULD be
|
||
listed as a value of supportedExtension in the root DSE of servers
|
||
which support this operation.
|
||
|
||
createGroupingOID ::= "IANA-ASSIGNED-OID.1"
|
||
|
||
|
||
2.2.1 createGroupingRequest
|
||
|
||
The client initiates this operation by sending a
|
||
createGroupingRequest. This request is an ExtendedRequest where the
|
||
requestName is the object identifier createGroupOID and requestValue
|
||
is BER-encoded createGroupingRequestValue:
|
||
|
||
createGroupingRequestValue ::= SEQUENCE {
|
||
createGroupType [0] LDAPOID,
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 3]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
createGroupValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
where createGroupType is an object identifier that describes the
|
||
specific type of grouping and createGroupValue contains a type
|
||
specific payload.
|
||
|
||
|
||
2.2.2 createGroupingResponse
|
||
|
||
The createGroupingResponse is sent in response to a
|
||
createGroupingRequest. This response is an ExtendedResponse where the
|
||
responseName MUST be the value of the requestName provided in the
|
||
request and the response is a BER-encoded createGroupingResponseValue:
|
||
|
||
createGroupingResponseValue ::= SEQUENCE {
|
||
createGroupCookie [0] groupCookie OPTIONAL,
|
||
createGroupValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
where createGroupCookie, if present, is a cookie uniquely identifying
|
||
the new grouping and createGroupValue is a type specific payload. The
|
||
createGroupCookie only when the operation results in the creation of a
|
||
group. Otherwise, it is absent.
|
||
|
||
|
||
2.3 End Grouping Operation
|
||
|
||
The End Grouping extended operation is used to end or stop a grouping
|
||
of related operations. The operation consists of the
|
||
endGroupingRequest and the endGroupingResponse. The object identifier
|
||
endGroupingOID identifies this operation and SHOULD be listed as a
|
||
value of supportedExtension in the root DSE of servers which support
|
||
this operation.
|
||
|
||
endGroupingOID ::= "IANA-ASSIGNED-OID.2"
|
||
|
||
|
||
2.3.1 endGroupingRequest
|
||
|
||
The client initiates this operation by sending an endGroupingRequest.
|
||
This request is an ExtendedRequest where the requestName is the object
|
||
identifier endGroupOID and requestValue is BER-encoded
|
||
endGroupingRequestValue:
|
||
|
||
endGroupingRequestValue ::= SEQUENCE {
|
||
endGroupCookie [0] groupCookie,
|
||
endGroupValue [1] OCTET STRING OPTIONAL
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 4]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
}
|
||
|
||
where endGroupCookie is a cookie identifying the grouping and
|
||
endGroupValue contains a type specific payload.
|
||
|
||
|
||
2.3.2 endGroupingResponse
|
||
|
||
The endGroupingResponse is sent in response to a endGroupingRequest.
|
||
This response is an ExtendedResponse where the responseName MUST be
|
||
the value of the requestName provided in request and the response is a
|
||
BER-encoded endGroupingResponseValue:
|
||
|
||
endGroupingResponseValue ::= SEQUENCE {
|
||
endGroupValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
where endGroupValue is a type specific payload.
|
||
|
||
|
||
2.4 endGroupingNotice
|
||
|
||
The endGroupingNotice is an LDAP unsolicited notification. The
|
||
notification may be sent to the client to end a grouping which the
|
||
server is unable or unwilling to continue to process. The notice is
|
||
an extendedResponse where the responseName is the object identifier
|
||
endGroupingNoticeOID and the response is a BER-encoded
|
||
endGroupingNoticeValue:
|
||
|
||
endGroupingNoticeOID ::= "IANA-ASSIGNED-OID.3"
|
||
|
||
endGroupingNoticeValue ::= SEQUENCE {
|
||
endGroupingCookie [0] groupCookie,
|
||
endGroupValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
where endGroupingCookie is a cookie uniquely identifying the grouping
|
||
and endGroupValue contains a type specific payload.
|
||
|
||
|
||
2.5 Action Grouping Operation
|
||
|
||
The Action Grouping extended operation is used to take an action
|
||
affecting a grouping of related operations. The operation consists of
|
||
the actionGroupingRequest and the actionGroupingResponse. The object
|
||
identifier actionGroupingOID identifies this operation and SHOULD be
|
||
listed as a value of supportedExtension in the root DSE of servers
|
||
which support this operation.
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 5]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
actionGroupingOID ::= "IANA-ASSIGNED-OID.4"
|
||
|
||
|
||
2.5.1 actionGroupingRequest
|
||
|
||
The client initiates this operation by sending an
|
||
actionGroupingRequest. This request is an ExtendedRequest where the
|
||
requestName is the object identifier actionGroupOID and requestValue
|
||
is BER-encoded actionGroupingRequestValue:
|
||
|
||
actionGroupingRequestValue ::= SEQUENCE {
|
||
actionGroupCookie [0] groupCookie,
|
||
actionGroupValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
where actionGroupCookie is a cookie identifying the grouping and
|
||
actionGroupValue contains a type specific payload.
|
||
|
||
|
||
2.5.2 actionGroupingResponse
|
||
|
||
The actionGroupingResponse is sent in response to a
|
||
actionGroupingRequest. This response is an ExtendedResponse where the
|
||
responseName MUST be the value of the requestName provided in request
|
||
and the response is a BER-encoded actionGroupingResponseValue:
|
||
|
||
actionGroupingResponseValue ::= SEQUENCE {
|
||
actionGroupValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
where actionGroupValue is a type specific payload.
|
||
|
||
|
||
2.6 infoGroupingNotice
|
||
|
||
The infoGroupingNotice is an LDAP unsolicited notification. The
|
||
notice may be sent to the client to provide additional grouping type
|
||
specific information. The notice is an extendedResponse where the
|
||
responseName is the object identifier infoGroupingNoticeOID and the
|
||
response is a BER-encoded infoGroupingNoticeValue:
|
||
|
||
infoGroupingNoticeOID ::= "IANA-ASSIGNED-OID.5"
|
||
|
||
infoGroupingNoticeValue ::= SEQUENCE {
|
||
infoGroupingCookie [0] groupCookie,
|
||
infoGroupValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 6]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
where infoGroupingCookie is a cookie uniquely identifying the grouping
|
||
and infoGroupValue contains a type specific payload.
|
||
|
||
|
||
2.7 groupingControl
|
||
|
||
The groupingControl is used to identify requests and responses as
|
||
belonging to a grouping of operations. The groupingControl is a
|
||
Control where the controlType is the object identifier
|
||
groupingControlOID, the criticality is TRUE, and the controlValue is a
|
||
BER-encoded groupingControlValue:
|
||
|
||
groupingControlOID ::= "IANA-ASSIGNED-OID.6"
|
||
|
||
groupingControlValue ::= SEQUENCE {
|
||
groupingCookie [0] groupCookie,
|
||
groupValue [1] OCTET STRING OPTIONAL
|
||
}
|
||
|
||
where groupingCookie is a cookie uniquely identifying the grouping and
|
||
groupingValue contains a type specific payload.
|
||
|
||
The value groupingControlOID SHOULD be listed as a value of
|
||
supportedControl in the root DSE by servers which support this
|
||
control.
|
||
|
||
The control SHALL NOT appear multiple times in the same LDAP PDU. If
|
||
multiple occurrences of the control are detected, the PDU SHALL be
|
||
treated as a protocol error.
|
||
|
||
|
||
3. Schema Elements
|
||
|
||
The document describes one attribute type.
|
||
|
||
|
||
3.1. supportedGroupingTypes
|
||
|
||
Servers SHOULD publish grouping types they support listing group type
|
||
object identifiers as values of the supportedGroupingTypes attribute
|
||
type in the root DSE. The supportedGroupingTypes attribute type is
|
||
defined as:
|
||
|
||
( IANA-ASSIGNED-OID.7 NAME 'supportedGroupingTypes'
|
||
DESC 'supported types of groupings of operations'
|
||
EQUALITY objectIdentifierMatch
|
||
SYNTAX 1.3.6.1.4.1.1466.115.121.1.38 USAGE dSAOperation )
|
||
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 7]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
The objectIdentifierMatch and OBJECT IDENTIFIER
|
||
(1.3.6.1.4.1.1466.115.121.1.38) are defined in [RFC2252].
|
||
|
||
Servers MUST be capable of recognizing this attribute type by the name
|
||
'supportedGroupingTypes'. Servers MAY recognize the attribute type by
|
||
other names.
|
||
|
||
|
||
4. Operational Semantics
|
||
|
||
This section details the common semantics of groups of related
|
||
operations. Additional semantics may be associated with each
|
||
grouping type as described by other documents.
|
||
|
||
|
||
4.1 Grouping Semantics
|
||
|
||
This subsection details semantics of the protocol elements introduced
|
||
in Section 2.
|
||
|
||
|
||
4.1.1 Create Grouping
|
||
|
||
To group related operations, the client MUST request a groupCookie
|
||
from the server by sending a createGroupingRequest as described in
|
||
Section 2.2.1. The client SHALL provide type specific payload in
|
||
createGroupValue if so required by the grouping type.
|
||
|
||
The server SHALL respond with a createGroupingResponse as described in
|
||
Section 2.2.2. If the server is willing and able to create the
|
||
grouping as requested (and per type requirements), it SHALL respond
|
||
with success, provide a session-unique groupCookie and, if
|
||
appropriate, a type specific payload. Otherwise the server SHALL
|
||
respond with a non-successful response containing no groupCookie, but
|
||
MAY, if appropriate, provide a type specific payload.
|
||
|
||
|
||
4.1.2 End Grouping
|
||
|
||
When the client wishes to end the grouping, the client SHALL send a
|
||
endGroupingRequest as described in Section 2.3.1. The client SHALL
|
||
provide the groupCookie of the grouping to end and MAY provided a type
|
||
specific payload. If the grouping to end contains active nested
|
||
groupings, these are implicitly ended as well without notice. The
|
||
server SHALL respond with an endGroupingResponse as described in
|
||
Section 2.3.2.
|
||
|
||
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 8]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
4.1.3 End Group Notice
|
||
|
||
The server MAY end a group without solicitation for any reason. The
|
||
server SHALL notify the client of this action by sending a endGrouping
|
||
Notice, as described in Section 2.4. The server SHALL provide the
|
||
groupCookie of the group it terminated and MAY provide a type specific
|
||
payload. The notice SHALL have a non-success resultCode.
|
||
|
||
If the group contains nested groups, the nested groups are implicitly
|
||
ended as well without additional notice.
|
||
|
||
|
||
4.1.4 Action Grouping
|
||
|
||
To perform an action within a group of related operations, the client
|
||
sends to the server actionGroupingRequest as described in Section
|
||
2.5.1. The client SHALL provide the groupCookie of the group the
|
||
operation is requested upon and, if required by the grouping type, a
|
||
type specific payload.
|
||
|
||
The server SHALL respond with a actionGroupingResponse as described in
|
||
Section 2.5.2. The server SHALL, if required by the grouping type,
|
||
provide type specific payload.
|
||
|
||
|
||
4.1.5 Info Grouping Notice
|
||
|
||
As allowed by the grouping type, the server MAY provide to the client
|
||
a notice regarding the grouping of related operations in an
|
||
infoGroupingNotice as described in Section 2.6. The server SHALL, if
|
||
required by the grouping type, provide type specific payload.
|
||
|
||
|
||
4.2 Nested groupings
|
||
|
||
Groups of the same or different types MAY be nested. A nested group
|
||
is instantiated by providing a groupingControl containing the parent
|
||
group's cookie with the createGroupingRequest.
|
||
|
||
Group type specifications MAY restrict the types of groupings which
|
||
may be nested. Servers MAY also place additional restrictions upon
|
||
nesting. Clients SHOULD NOT assume support for arbitrary nesting.
|
||
|
||
|
||
4.3 Intermixing of unrelated operations
|
||
|
||
LDAP is designed to allow clients to perform unrelated tasks
|
||
concurrently. In keeping with this design, operations which unrelated
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 9]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
to the grouping are generally allowed be intermixed with grouped
|
||
operations. (See Section 4.5 for specific exceptions to this general
|
||
rule.) It is noted that undue restrictions often unrelated operation
|
||
cause unnecessary serialization of independent tasks, place
|
||
unnecessary burden upon implementors, and can limit extensibility.
|
||
|
||
Group type specifications SHOULD NOT disallow unrelated operations
|
||
from being intermixed with grouped operations.
|
||
|
||
Note: a grouping which disallows unrelated operatoins from being
|
||
intermixed with grouped operations can be viewed as providing
|
||
"framing" semantics.
|
||
|
||
|
||
4.4 Grouped operations
|
||
|
||
Interrogation (compare, search) and update (add, delete, modify,
|
||
rename) MAY be grouped. Certain extended operations MAY also be
|
||
grouped, but those which affect the session as a whole, such as Start
|
||
TLS, MUST NOT be grouped.
|
||
|
||
Requests and Responses associated with grouped operations contain a
|
||
groupingControl control as described in Section 2.7.
|
||
|
||
Group type specifications MAY restrict the kind and/or number of
|
||
operations which may be related. Servers MAY place additional
|
||
restrictions upon groupings. Clients SHOULD NOT assume support for
|
||
arbitrary grouping.
|
||
|
||
|
||
4.5 Other Operations
|
||
|
||
Upon issuing any grouping operation, the semantics of following
|
||
operations listed is modified as described below.
|
||
|
||
|
||
4.5.1 abandon
|
||
|
||
The abandon operation SHOULD NOT be used to cancel grouped operations.
|
||
The Cancel operation is to be used instead (as discussed in 4.5.3).
|
||
|
||
|
||
4.5.2 bind
|
||
|
||
The client SHOULD end all outstanding groupings before issuing a bind
|
||
request. The server SHALL, in addition to the behavior described in
|
||
[RFC2251] and [RFC2829], abandon all outstanding groups. No
|
||
endGroupingNotice notification is sent upon such abandonment.
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 10]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
A Bind operation cannot be related to other operations using this
|
||
grouping mechanism. The bind messages SHOULD NOT contain
|
||
groupingControl controls and, if present, SHALL be treated as a a
|
||
protocol error.
|
||
|
||
|
||
4.5.3 cancel
|
||
|
||
The cancel operation [CANCEL] MAY be used to cancel grouped operations
|
||
but SHOULD NOT contain a groupingControl control unless the group type
|
||
calls for a type specific payload to be provided. The groupingCookie
|
||
in the provided groupingControl control MUST be the same associated
|
||
with the operation to be canceled, otherwise the cancel request SHALL
|
||
be treated as an error.
|
||
|
||
|
||
4.5.4 Start TLS
|
||
|
||
The client SHOULD end all outstanding groupings before issuing a Start
|
||
TLS [RFC2930] request. If there are any outstanding groupings, the
|
||
server MUST return operationsError in response to a StartTLS request.
|
||
Start TLS operation cannot be related to other operations using this
|
||
grouping mechanism and the Start TLS request and response PDUs SHALL
|
||
NOT contain a groupingControl control.
|
||
|
||
|
||
4.5.5 unbind
|
||
|
||
The server SHALL, in addition to the behavior described in [RFC2251],
|
||
abandon all outstanding groups. No endGroupingNotice is sent upon
|
||
such abandonment. An unbind operation cannot be related to other
|
||
operations using this grouping mechanism. The unbind request SHOULD
|
||
NOT contain a groupingControl control and, if present, SHALL be
|
||
ignored.
|
||
|
||
|
||
5. Profiling Requirements
|
||
|
||
Documents detailing extensions using the grouping mechanism MUST
|
||
provide a profile of its use of the mechanism.
|
||
|
||
The profile SHALL specify the object identifier to be used to uniquely
|
||
identify each grouping type it defines. Object identifiers used to
|
||
identity group types, like other protocol elements, SHALL be delegated
|
||
in accordance with BCP 64 [RFC3383] and registered as LDAP Protocol
|
||
Mechanisms [RFC3383] as detailed in Section 7.1 of this document.
|
||
|
||
The profile SHALL state which protocol elements of the mechanism it
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 11]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
uses.
|
||
|
||
Each of the grouping protocol elements defined in this document allow
|
||
transfer of type specific payloads. For each protocol element used,
|
||
the profile SHALL state whether the element is to carry a type
|
||
specific payload or not and SHALL fully describe the syntax and
|
||
semantics associated with each type specific payload.
|
||
|
||
The profile MAY define grouping type specific semantics which place
|
||
further restrictions upon the grouping related operations.
|
||
|
||
|
||
6. Security Considerations
|
||
|
||
This mechanism can be used to support complex groupings of related
|
||
operations. With such complexity comes inherit risk. Specifications
|
||
of uses of this mechanism should take special care to address security
|
||
issues. In particular, denial of service and authentication,
|
||
authorization, and access-control issues should be addressed in
|
||
documents detailing uses of this grouping mechanism.
|
||
|
||
|
||
7. IANA Considerations
|
||
|
||
7.1. Future Registration of Grouping Types
|
||
|
||
Future specifications which detail LDAP grouping types are to register
|
||
each grouping type as a LDAP Protocol Mechanism per guidance given in
|
||
BCP 64 [RFC3383]. A usage of "Grouping Type" in a Protocol Mechanism
|
||
registration template indicates that the value to be registered is
|
||
associated with an LDAP Grouping Type.
|
||
|
||
|
||
7.2. Object Identifier Registration
|
||
|
||
It is requested that IANA register upon Standards Action an LDAP
|
||
Object Identifier to identify protocol elements defined in this
|
||
technical specification. The following registration template is
|
||
suggested:
|
||
|
||
Subject: Request for LDAP OID Registration
|
||
Person & email address to contact for further information:
|
||
Kurt Zeilenga <kurt@OpenLDAP.org>
|
||
Specification: RFCXXXX
|
||
Author/Change Controller: IESG
|
||
Comments:
|
||
Identifies elements of the LDAP Grouping Operation
|
||
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 12]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
7.3. LDAP Protocol Mechanism
|
||
|
||
It is requested that IANA register upon Standards Action the LDAP
|
||
protocol mechanism described in this document. The following
|
||
registration template is suggested:
|
||
|
||
Subject: Request for LDAP Protocol Mechansism Registration
|
||
Object Identifier: IANA-ASSIGNED-OID
|
||
Description: See comments
|
||
Person & email address to contact for further information:
|
||
Kurt Zeilenga <kurt@openldap.org>
|
||
Usage: Extended Operation
|
||
Specification: RFCXXXX
|
||
Author/Change Controller: IESG
|
||
Comments: none
|
||
|
||
Object Identifier Type Description
|
||
------------------- ---- -------------------------
|
||
IANA-ASSIGNED-OID.1 E Create Grouping Operation
|
||
IANA-ASSIGNED-OID.2 E End Grouping Operation
|
||
IANA-ASSIGNED-OID.4 E Action Grouping Operation
|
||
|
||
in 2
|
||
|
||
|
||
7.4. supportedGroupingTypes Registration
|
||
|
||
It is requested that IANA register upon Standards Action the LDAP
|
||
'supportedGroupingTypes' descriptor. The following registration
|
||
template is suggested:
|
||
|
||
Subject: Request for LDAP Descriptor Registration
|
||
Descriptor (short name): supportedGroupingTypes
|
||
Object Identifier: IANA-ASSIGNED-OID.7
|
||
Person & email address to contact for further information:
|
||
Kurt Zeilenga <kurt@OpenLDAP.org>
|
||
Usage: Attribute Type
|
||
Specification: RFCXXXX
|
||
Author/Change Controller: IESG
|
||
|
||
|
||
8. Acknowledgments
|
||
|
||
The author gratefully acknowledges the contributions of the IETF
|
||
LDAPext and LDUP working groups. In particular, Roger Harrison
|
||
provided many useful suggestions. Also, the author notes that this
|
||
document builds upon the early works "Extended Operations for Framing
|
||
LDAP Operations" by Ellen Stokes, Roger Harrison, and Gordon Good and
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 13]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
"Profile for Framing LDAPv3 Operations" by Roger Harrison.
|
||
|
||
|
||
9. Author's Address
|
||
|
||
Kurt D. Zeilenga
|
||
OpenLDAP Foundation
|
||
<Kurt@OpenLDAP.org>
|
||
|
||
|
||
10. References
|
||
|
||
10.1 Normative References
|
||
|
||
[RFC2119] S. Bradner, "Key Words for use in RFCs to Indicate
|
||
Requirement Levels", BCP 14 (also RFC 2119), March 1997.
|
||
|
||
[RFC2251] M. Wahl, S. Kille, T. Howes, "Lightweight Directory Access
|
||
Protocol (v3)", RFC 2251, December 1997.
|
||
|
||
[RFC2252] M. Wahl, A. Coulbeck, T. Howes, S. Kille, "Lightweight
|
||
Directory Access Protocol (v3): Attribute Syntax
|
||
Definitions", RFC 2252, December 1997.
|
||
|
||
[RFC2829] M. Wahl, H. Alvestrand, J. Hodges, R. Morgan,
|
||
"Authentication Methods for LDAP", RFC 2829, May 2000.
|
||
|
||
[RFC2830] J. Hodges, R. Morgan, M. Wahl, "Lightweight Directory
|
||
Access Protocol (v3): Extension for Transport Layer
|
||
Security", RFC 2830, May 2000.
|
||
|
||
[RFC3377] J. Hodges, R. Morgan, "Lightweight Directory Access
|
||
Protocol (v3): Technical Specification", RFC 3377,
|
||
September 2002.
|
||
|
||
[RFC3383] K. Zeilenga, "IANA Considerations for LDAP", BCP 64 (also
|
||
RFC 3383), September 2002.
|
||
|
||
[X.680] ITU-T, "Abstract Syntax Notation One (ASN.1) -
|
||
Specification of Basic Notation", X.680, 1994.
|
||
|
||
[X.690] ITU-T, "Specification of ASN.1 encoding rules: Basic,
|
||
Canonical, and Distinguished Encoding Rules", X.690, 1994.
|
||
|
||
|
||
10.2. Informative References
|
||
|
||
[TXNGRP] K. Zeilenga, "LDAP Transactions" (a work in progress),
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 14]
|
||
|
||
INTERNET-DRAFT draft-zeilenga-ldap-grouping-06 3 May 2003
|
||
|
||
|
||
draft-zeilenga-ldap-txn-xx.txt.
|
||
|
||
|
||
Copyright 2003, The Internet Society. 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 AUTHORS, 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.
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
Zeilenga LDAP Grouping [Page 15]
|
||
|