rfc-3671

Collective Attributes in the Lightweight Directory Access Protocol (LDAP)

K. Zeilenga
date2003-12 streamIETF wgnon working group statusPROPOSED STANDARD pages10 canonicalhttps://www.rfc-editor.org/rfc/rfc3671 doi10.17487/RFC3671
X.500 collective attributes allow common characteristics to be shared between collections of entries. This document summarizes the X.500 information model for collective attributes and describes use of collective attributes in LDAP (Lightweight Directory Access Protocol). This document provides schema definitions for collective attributes for use in LDAP.

Extracted elements (21)

design-rationale §1.2

Collective attributes are visible but not updateable by clients accessing entries within the collection; they must be modified via the associated collective attributes subentry. This separation enforces administrative control over shared values.

ldap

design-rationale §5

OIDs used in this document were assigned by ISO/IEC JTC1-SC6 for X.500 schema elements; this document makes no new OID assignments and only provides LDAP schema descriptions mapping to existing X.500 schema.

ldap, registry

design-rationale §1.2

When an entry belongs to multiple entry collections, values of each collective attribute are combined such that independent sources are not manifested to clients — the entry presents a unified view of all applicable collective values.

ldap

interoperability-note §3

Collective attributes are derived from X.520 definitions, with superior attribute types described in RFC 2256 for use with LDAP. Implementations must align with X.500 Directory Models (X.501) for interoperability.

ldap

normative-requirement §2.1 SHOULD

A collective attribute subentry SHOULD contain at least one collective attribute. The collective attributes are available for finding, searching, and comparison at every entry within scope, but administered via the subentry.

ldap

normative-requirement §3 MUST NOT

Collective attributes SHALL NOT be SINGLE-VALUED, and collective attribute types SHALL NOT appear in the attribute types of an object class definition.

ldap

normative-requirement §2.1 SHOULD

Implementations SHOULD support collective attribute subentries in both collectiveAttributeSpecificArea (2.5.23.5) and collectiveAttributeInnerArea (2.5.23.6) administrative areas.

ldap

normative-requirement §3 SHOULD

Implementations SHOULD support the collective attributes defined in section 3 (c-l, c-st, c-street, c-o, c-ou, c-PostalAddress, c-PostalCode, c-PostOfficeBox, c-PhysicalDeliveryOfficeName, c-TelephoneNumber, c-TelexNumber, c-FacsimileTelephoneNumber, c-InternationalISDNNumber) and MAY support additional collective attributes.

ldap

normative-requirement §2 MUST

LDAP servers MUST act in accordance with the X.500 Directory Models (X.501) when providing the collective attributes service.

ldap

normative-requirement §3 MUST NOT

Non-collective attribute types SHALL NOT subtype collective attributes.

ldap

normative-requirement §3 MUST NOT

Operational attributes SHALL NOT be defined to be collective.

ldap

normative-requirement §2.3 MAY

The collectiveExclusions operational attribute MAY appear in any entry and MAY have multiple values, allowing particular collective attributes to be excluded from an entry.

ldap

protocol-element §3.1

c-l (OID 2.5.4.7.1) is the collective locality name attribute, defined as SUP l COLLECTIVE, specifying a shared locality name for a collection of entries.

ldap

protocol-element §3.4

c-o (OID 2.5.4.10.1) is the collective organization name attribute, defined as SUP o COLLECTIVE, and c-ou (OID 2.5.4.11.1) is the collective organizational unit name, defined as SUP ou COLLECTIVE.

ldap

protocol-element §3.10

c-TelephoneNumber (OID 2.5.4.20.1) specifies a collective telephone number (SUP telephoneNumber COLLECTIVE); c-FacsimileTelephoneNumber (OID 2.5.4.23.1) specifies a collective facsimile number (SUP facsimileTelephoneNumber COLLECTIVE).

ldap

protocol-element §3

Collective attribute types are defined as userApplications attributes with the COLLECTIVE flag. By convention, they are named by prefixing the non-collective supertype name with 'c-' (e.g., c-TelephoneNumber subtypes telephoneNumber).

ldap

protocol-element §2.2

The collectiveAttributeSubentries operational attribute (OID 2.5.18.12) identifies all collective attribute subentries that affect a given entry. It uses distinguishedNameMatch equality and DN syntax, is directoryOperation usage, and is NO-USER-MODIFICATION.

ldap

protocol-element §2.1

The collectiveAttributeSubentry auxiliary object class (OID 2.5.17.2) is used to administer collective attributes. Subentries of this class are collective attribute subentries whose contained attributes apply to all entries within the subentry's scope.

ldap

protocol-element §2.3

The collectiveExclusions operational attribute (OID 2.5.18.7) uses objectIdentifierMatch equality and OID syntax. When the OID 2.5.18.0 (excludeAllCollectiveAttributes) is present as a value, all collective attributes are excluded from the entry.

ldap

registry §5

IANA registered 13 collective attribute type descriptors (c-l, c-st, c-street, c-o, c-ou, c-PostalAddress, c-PostalCode, c-PostOfficeBox, c-PhysicalDeliveryOfficeName, c-TelephoneNumber, c-TelexNumber, c-FacsimileTelephoneNumber, c-InternationalISDNNumber) plus collectiveAttributeSubentries and collectiveExclusions as attributes, and collectiveAttributeSubentry as an object class, in the LDAP Descriptor registry.

ldap, registry

security-consideration §4

Collective attributes are subject to access control restrictions and other administrative policy. Access via an entry in a collection is governed by rules for that entry's attributes; access via a subentry is governed by rules for that subentry's attributes. Because LDAP lacks a standard access model, server implementations may differ in specifics.

ldap, security