view Side-By-Side changes
Date: Tue, 09 Apr 2002 00:55:42 GMT Server: Apache/1.3.20 (Unix) Last-Modified: Wed, 11 Oct 1995 23:00:00 GMT ETag: "2e9d89-256f-307c4c70" Accept-Ranges: bytes Content-Length: 9583 Connection: close Content-Type: text/plain X.500 URI Attribute Types and Object Class Mark Network Working Group M. SmithINTERNET-DRAFT University of Michigan 11 October 1995Request for Comments: 2079 Netscape Communications Category: Standards Track January 1997 Definition of an X.500 AttributeTypesType and an Object Class to Hold Uniform Resource Identifiers (URIs)Filename: draft-ietf-asid-x500-url-02.txtStatus of this Memo This documentisspecifies anInternet-Draft. Internet-Drafts are working documents ofInternet standards track protocol for the InternetEngineering Task Force (IETF), its areas,community, andits 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 monthsrequests discussion andmay be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet- Drafts as reference material orsuggestions for improvements. Please refer tocite them other than as ``work in progress.'' To learnthe currentstatusedition ofany Internet-Draft, please check the ``1id-abstracts.txt'' listing contained intheInternet- Drafts Shadow Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim)."Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited.Editorial comments should be sent to the author (mcs@umich.edu). Technical discussion will take place on the IETF ASID mailing list (ietf-asid@umich.edu). This Internet Draft expires April 11, 1995.Abstract Uniform Resource Locators (URLs) are being widely used to specify the location of Internet resources. There is an urgent need to be able to include URLs in directories that conform to the LDAP and X.500directory,information models, and a desire to include other types of Uniform Resource Identifiers (URIs) as they are defined. A number of independent groups are already experimenting with the inclusion of URLs intheLDAP and X.500directory.directories. This document builds on the experimentation to date and definestwoa new attributetypestype and an auxiliary object class to allow URIs, including URLs, to be stored in directory entries in a standard way.Smith IETF ASID Working Group [Page 1] INTERNET-DRAFT URI Attribute Types and Object Class 11 October 1995Background and Intended Usage Uniform Resource Locators (URLs) as defined by [1] are the first of several types of Uniform Resource Identifiers (URIs) being defined by the IETF. URIs are widely used on the Internet, most notably within Hypertext Markup Language [2] documents. This document definestwoan X.500[2,3][3,4] attributetypes (labeledURI and labeledURL)type called labeledURI and an auxiliary object class(labeledURIObject)called labeledURIObject to hold all types of URIs, including URLs.It is assumed that as other kinds of URIsThese definitions aredefined, additional attribute types may be created to support storing them in directory entries. The rationale for adding separate attribute typesdesigned forthe different kinds of URIs is to support efficient programmatic access to specific types of URIs. For example, if an indexing service is only interested in URLs, having them availableuse intheir own attribute makes pulling them out of a directory entry straightforwardLDAP andefficient. It is intended that the schema elements defined in this document will be progressed according to the process defined by the InternetX.500Schema Working Group [4].directories, and may be used in other contexts as well. Smith Standards Track [Page 1] RFC 2079 URI Attribute Type and Object Class January 1997 Schema Definition of thelabeledURLlabeledURI Attribute Type Name:labeledURLlabeledURI ShortName: None Description: Uniform ResourceLocatorIdentifier with optional label OID:umichAttributeType.41 (1.3.6.1.4.1.250.1.41)umichAttributeType.57 (1.3.6.1.4.1.250.1.57) Syntax: caseExactString SizeRestriction: None SingleValued: False Discussion of thelabeledURLlabeledURI Attribute Type ThelabeledURLlabeledURI attribute type has the caseExactString syntax (sinceURLsURIs are case-sensitive) and it is multivalued. Values placed in the attribute should consist of aURL as defined in [1]URI (at the present time, a URL) optionally followed by one or more space characters and a label. Since space characters are not allowed to appear un-encoded inURLs,URIs, there is no ambiguity about where the label begins. At the present time, the URI portion must comply with the URL specification [1]. MultiplelabeledURLlabeledURI values will generally indicate different resources that are all related to the X.500 object, but may indicate different locations for the same resource.Smith IETF ASID Working Group [Page 2] INTERNET-DRAFT URI Attribute Types and Object Class 11 October 1995The label is used to describe the resource to which theURLURI points, and is intended as a friendly name fit for human consumption. This document does not propose any specific syntax for the label part.Note that inIn some cases it may be helpful to include in the label some indication of the kind and/or size of the resource referenced by theURL.URI. Note that the label may include any characters allowed by the caseExactString syntax, but that the use of non-IA5 (non-ASCII) characters is discouraged as not all directory clients may handle them in the same manner.Some examples of valid labeledURL values (the first doesIf non-IA5 characters are included, they should be represented using the X.500 conventions, nothavethe HTML conventions (e.g., the character that is an "a" with alabel): ftp://ds.internic.net/rfc/rfc822.txt http://www.umich.edu/ University of Michigan Home Page http://champagne.inria.fr/Unites/rennes.gif Rennes [photo] Schema Definition ofring above it should be encoded using the T.61 sequence 0xCA followed by an "a" character; do not use the HTML escape sequence "å"). Examples of labeledURI AttributeType Name: labeledURI ShortName: None Description: Uniform Resource Identifier with optional label OID: umichAttributeType.57 (1.3.6.1.4.1.250.1.57) Syntax: caseExactString SizeRestriction: None SingleValued: False DiscussionValues An example ofthea labeledURI attribute value that does not include a label: ftp://ds.internic.net/rfc/rfc822.txt Smith Standards Track [Page 2] RFC 2079 URI Attribute TypeThe labeledURI attribute type has the caseExactString syntax (since URIs are case-sensitive)andit is multivalued. Values placed in the attribute should consistObject Class January 1997 An example of aURI (atlabeledURI attribute value that contains a tilde character in thepresent time,URL (special characters in aURL) optionally followedURL must be encoded as specified by the URL document [1]). The label is "LDAP Home Page": http://www.umich.edu/%7Ersug/ldap/ LDAP Home Page Another example. This oneor more space characters andincludes alabel. Since space characters are not allowed to appear un-encodedhint inURIs, there is no ambiguity about wherethe labelbegins. At the present time,to help theURI portion must comply withuser realize that the URLspecification [1]. Multiple labeledURI values will generally indicate different resources that are all relatedpoints to a photo image. http://champagne.inria.fr/Unites/rennes.gif Rennes [photo] Schema Definition of theX.500 object, but may indicate different locations forlabeledURIObject Object Class Name: labeledURIObject Description: object that contains thesame resource. Smith IETF ASID Working Group [Page 3] INTERNET-DRAFTURIAttribute Types andattribute type OID: umichObjectClass.15 (1.3.6.1.4.1.250.3.15) SubclassOf: top MustContain: MayContain: labeledURI Discussion of the labeledURIObject Object Class11 October 1995ThelabellabeledURIObject class isused to describe the resource to which the URI points,a subclass of top and may contain the labeledURI attribute. The intent isintended as a friendly name fitthat this object class can be added to existing directory objects to allow forhuman consumption.inclusion of URI values. Thisdocumentapproach does notpropose any specific syntax forpreclude including thelabel part. Note thatlabeledURI attribute type directly insome cases it may be helpful to includeother object classes as appropriate. Security Considerations Security considerations are not discussed inthe label some indication of the kind and/or size of the resource referenced by the URI. Notethis memo, except to note that blindly inserting the labelmay include any characters allowed by the caseExactString syntax, but that the useportion ofnon-IA5 (non-ASCII) charactersa labeledURI attribute value into an HTML document isdiscouraged asnotall directory clientsrecommended, as this mayhandle themallow a malicious individual to include HTML tags in thesame manner. Schema Definitionlabel that mislead viewers of thelabeledURIObject Object Class Name: labeledURIObject Description: object that containsentire document in which the labeledURI value was inserted. Acknowledgments Paul-Andre Pays, Martijn Koster, Tim Howes, Rakesh Patel, Russ Wright, and Hallvard Furuseth provided invaluable assistance in theURI attribute types OID: umichObjectClass.15 (1.3.6.1.4.1.250.3.15) SubclassOf: top MustContain: MayContain: labeledURI, labeledURL Discussioncreation of this document. This material is based in part upon work supported by thelabeledURIObjectNational Science Foundation under Grant No. NCR-9416667. Smith Standards Track [Page 3] RFC 2079 URI Attribute Type and Object Class January 1997 Appendix: ThelabeledURIObject classlabeledURL Attribute Type (Deprecated) An earlier draft of this document defined an additional attribute type called labeledURL. This attribute type is deprecated, and should not be used when adding new values to directory entries. The original motivation for including asubclassseparate attribute type to hold URLs was that this would better enable efficient progammatic access to specific types oftop and may containURIs. After some deliberation, thelabeledURI and labeledURL attributes.IETF-ASID working group concluded that it was better to simply have one attribute than two. Theintentschema definition for labeledURL isthatincluded here for historical reference only. Directory client software may want to support thisobject class can be addedschema definition (in addition toexisting directory objectslabeledURI) toallow for inclusion of URI values. This approach does not preclude includingease thelabeledURI andtransition away from labeledURLattribute types directly in other object classes as appropriate.for those sites that are using it. Name: labeledURL ShortName: None Description: Uniform Resource Locator with optional label OID: umichAttributeType.41 (1.3.6.1.4.1.250.1.41) Syntax: caseExactString SizeRestriction: None SingleValued: False OID: umichAttributeType.41 (1.3.6.1.4.1.250.1.41) References [1] Berners-Lee, T., Masinter, L., and M. McCahill,M.,"Uniform Resource Locators (URL)", RFC 1738, CERN, Xerox Corporation, University of Minnesota, December1994,1994. <URL:ftp://ds.internic.net/rfc/rfc1738.txt> [2] Berners-Lee, T., and D. Connolly, "Hypertext Markup Language - 2.0", RFC 1866, <URL:ftp://ds.internic.net/rfc/rfc1866.txt> [3] The Directory: Overview of Concepts, Models and Service. CCITT Recommendation X.500, 1988.[3][4] Information Processing Systems -- Open Systems Interconnection -- The Directory: Overview of Concepts, Models and Service. ISO/IEC JTC 1/SC21; International Standard 9594-1, 1988. SmithIETF ASID Working GroupStandards Track [Page 4]INTERNET-DRAFTRFC 2079 URI AttributeTypesType and Object Class11 October 1995 [4] Howes, T., Rossen, K., Sataluri, S., and Wright, R., "Procedures for Formalizing, Evolving, and Maintaining the Internet X.500 Directory Schema", Internet Draft (Work In Progress) of the Schema Working Group, <URL:ftp://ds.internic.net/internet-drafts/ draft-howes-x500-schema-03.txt> Security Considerations Security considerations are not discussed in this memo. Acknowledgments Paul-Andre Pays, Martijn Koster, Tim Howes, Rakesh Patel, and Russ Wright provided invaluable assistance in the creation of this document. This material is based upon work supported by the National Science Foundation under Grant No. NCR-9416667.January 1997 Author's Address Mark SmithUniversity of Michigan Information Technology Division 535 W. William St. Ann Arbor, MI 48103-4943,Netscape Communications Corp. 501 E. Middlefield Rd. Mountain View, CA 94043, USA Phone: +1313 764-2277 Fax: +1 313 765-5140415 937-3477 EMail:mcs@umich.edu This Internet Draft expires April 11, 1995.mcs@netscape.com SmithIETF ASID Working GroupStandards Track [Page 5] ----