home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_a_c / draft-ietf-asid-ldapv3-attributes-07.txt < prev    next >
Text File  |  1997-08-21  |  53KB  |  1,502 lines
  1.  
  2. Network Working Group                                            M. Wahl
  3. INTERNET-DRAFT                                       Critical Angle Inc.
  4. Obsoletes: RFC 1778                                          A. Coulbeck
  5.                                                               Isode Inc.
  6.                                                                 T. Howes
  7.                                            Netscape Communications Corp.
  8.                                                                 S. Kille
  9.                                                            Isode Limited
  10. Intended Category: Standards Track                         5 August 1997
  11.  
  12.  
  13.                   Lightweight Directory Access Protocol (v3):
  14.                        Attribute Syntax Definitions
  15.                  <draft-ietf-asid-ldapv3-attributes-07.txt> 
  16.  
  17. 1. Status of this Memo
  18.  
  19.    This document is an Internet-Draft.  Internet-Drafts are working 
  20.    documents of the Internet Engineering Task Force (IETF), its areas, and
  21.    its working groups.  Note that other groups may also distribute working
  22.    documents as Internet-Drafts.
  23.  
  24.    Internet-Drafts are draft documents valid for a maximum of six months
  25.    and may be updated, replaced, or obsoleted by other documents at any
  26.    time.  It is inappropriate to use Internet-Drafts as reference material
  27.    or to cite them other than as "work in progress."
  28.  
  29.    To learn the current status of any Internet-Draft, please check the
  30.    "1id-abstracts.txt" listing  contained in the Internet-Drafts Shadow
  31.    Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe),
  32.    ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim).
  33.  
  34. 2. Abstract
  35.  
  36.    The Lightweight Directory Access Protocol (LDAP) [1] requires that 
  37.    the contents of AttributeValue fields in protocol elements be octet 
  38.    strings.  This document defines a set of syntaxes for LDAPv3, and the
  39.    rules by which attribute values of these syntaxes are represented as
  40.    octet strings for transmission in the LDAP protocol.  The syntaxes 
  41.    defined in this document are referenced by this and other documents 
  42.    that define attribute types.  This document also defines the set of 
  43.    attribute types which LDAP servers should support.
  44.  
  45. 3. Overview
  46.  
  47.    This document defines the framework for developing schemas for 
  48.    directories accessible via the Lightweight Directory Access Protocol.
  49.  
  50.    Schema is the collection of attribute type definitions, object class
  51.    definitions and other information which a server uses to determine
  52.    how to match a filter or attribute value assertion (in a compare 
  53.    operation) against the attributes of an entry, and whether to permit 
  54.    add and modify operations.  
  55.  
  56.    Section 4 states the general requirements and notations for attribute
  57.    types, object classes, syntax and matching rule definitions.
  58.  
  59.  
  60. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 1
  61.  
  62. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  63.  
  64.    Section 5 lists attributes, section 6 syntaxes and section 7 object 
  65.    classes.
  66.  
  67.    Additional documents define schemas for representing real-world 
  68.    objects as directory entries.
  69.  
  70. 4. General Issues
  71.  
  72.    This document describes encodings used in an Internet protocol. 
  73.  
  74.    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 
  75.    "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in 
  76.    this document are to be interpreted as described in RFC 2119 [4].
  77.  
  78.    Attribute Type and Object Class definitions are written in a 
  79.    string representation of the AttributeTypeDescription and 
  80.    ObjectClassDescription data types defined in X.501(93) [3].  
  81.    Implementors are strongly advised to first read the description
  82.    of how schema is represented in X.500 before reading the rest of 
  83.    this document.
  84.  
  85. 4.1. Common Encoding Aspects
  86.  
  87.    For the purposes of defining the encoding rules for attribute 
  88.    syntaxes, the following BNF definitions will be used.  They are 
  89.    based on the BNF styles of RFC 822 [13].
  90.  
  91.      a     = "a" / "b" / "c" / "d" / "e" / "f" / "g" / "h" / "i" /
  92.              "j" / "k" / "l" / "m" / "n" / "o" / "p" / "q" / "r" /
  93.              "s" / "t" / "u" / "v" / "w" / "x" / "y" / "z" / "A" /
  94.              "B" / "C" / "D" / "E" / "F" / "G" / "H" / "I" / "J" /
  95.              "K" / "L" / "M" / "N" / "O" / "P" / "Q" / "R" / "S" /
  96.              "T" / "U" / "V" / "W" / "X" / "Y" / "Z"
  97.  
  98.      d               = "0" / "1" / "2" / "3" / "4" / 
  99.                        "5" / "6" / "7" / "8" / "9"
  100.  
  101.      hex-digit       =  d / "a" / "b" / "c" / "d" / "e" / "f" /
  102.                             "A" / "B" / "C" / "D" / "E" / "F"
  103.  
  104.      k               = a / d / "-"
  105.  
  106.      p               = a / d / """ / "(" / ")" / "+" / "," / 
  107.                        "-" / "." / "/" / ":" / "?" / " "
  108.  
  109.      letterstring    = 1*a
  110.  
  111.      numericstring   = 1*d
  112.  
  113.      anhstring       = 1*k
  114.  
  115.      keystring       = a [ anhstring ]
  116.  
  117.      printablestring = 1*p
  118.  
  119.  
  120. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 2
  121.  
  122. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  123.  
  124.      space           = 1*" " 
  125.  
  126.      whsp            = [ space ]
  127.  
  128.      utf8            = <any sequence of octets formed from the UTF-8 [9] 
  129.                         transformation of a character from ISO10646 [10]>
  130.  
  131.      dstring         = 1*utf8
  132.  
  133.      qdstring        = whsp "'" dstring "'" whsp
  134.  
  135.      qdstringlist    = [ qdstring *( qdstring ) ]
  136.  
  137.      qdstrings       = qdstring / ( whsp "(" qdstringlist ")" whsp )
  138.  
  139.    In the following BNF for the string representation of OBJECT 
  140.    IDENTIFIERs, descr is the syntactic representation of an object 
  141.    descriptor, which consists of letters and digits, starting with a 
  142.    letter.  An OBJECT IDENTIFIER in the numericoid format should not 
  143.    have leading zeroes (e.g. "0.9.3" is permitted but "0.09.3" should 
  144.    not be generated).
  145.  
  146.    When encoding 'oid' elements in a value, the descr encoding option 
  147.    SHOULD be used in preference to the numericoid. An object descriptor is
  148.    a more readable alias for a number OBJECT IDENTIFIER, and these 
  149.    (where assigned and known by the implementation) SHOULD be used in
  150.    preference to numeric oids to the greatest extent possible.  
  151.    Examples of object descriptors in LDAP are attribute type, object 
  152.    class and matching rule names. 
  153.  
  154.      oid             = descr / numericoid 
  155.  
  156.      descr           = keystring 
  157.  
  158.      numericoid      = numericstring *( "." numericstring )
  159.  
  160.      woid            = whsp oid whsp
  161.  
  162.      ; set of oids of either form
  163.      oids            = woid / ( "(" oidlist ")" )
  164.  
  165.      oidlist         = woid *( "$" woid )
  166.  
  167.      ; object descriptors used as schema element names
  168.      qdescrs         = qdescr / ( whsp "(" qdescrlist ")" whsp )
  169.  
  170.      qdescrlist      = [ qdescr *( qdescr ) ]
  171.  
  172.      qdescr          = whsp "'" descr "'" whsp
  173.  
  174.      
  175.  
  176.  
  177.  
  178.  
  179.  
  180. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 3
  181.  
  182. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  183.  
  184. 4.2. Attribute Types
  185.  
  186.    The attribute types are described by sample values for the subschema 
  187.    "attributeTypes" attribute, which is written in the 
  188.    AttributeTypeDescription syntax.  While lines have been folded for 
  189.    readability, the values transferred in protocol would not contain 
  190.    newlines.  
  191.  
  192.    The AttributeTypeDescription is encoded according to the following 
  193.    BNF, and the productions for oid, qdescrs and qdstring are given
  194.    in section 4.1.  Implementors should note that future versions of 
  195.    this document may have expanded this BNF to include additional terms.
  196.    Terms which begin with the characters "X-" are reserved for private
  197.    experiments.
  198.  
  199.       AttributeTypeDescription = "(" whsp
  200.             numericoid whsp              ; AttributeType identifier
  201.           [ "NAME" qdescrs ]             ; name used in AttributeType
  202.           [ "DESC" qdstring ]            ; description
  203.           [ "OBSOLETE" whsp ]
  204.           [ "SUP" woid ]                 ; derived from this other 
  205.                                          ; AttributeType
  206.           [ "EQUALITY" woid              ; Matching Rule name
  207.           [ "ORDERING" woid              ; Matching Rule name
  208.           [ "SUBSTR" woid ]              ; Matching Rule name 
  209.           [ "SYNTAX" whsp noidlen whsp ] ; see section 4.3
  210.           [ "SINGLE-VALUE" whsp ]        ; default multi-valued
  211.           [ "COLLECTIVE" whsp ]          ; default not collective
  212.           [ "NO-USER-MODIFICATION" whsp ]; default user modifiable
  213.           [ "USAGE" whsp AttributeUsage ]; default userApplications
  214.           whsp ")"
  215.     
  216.       AttributeUsage =
  217.           "userApplications"     /
  218.           "directoryOperation"   /
  219.           "distributedOperation" / ; DSA-shared
  220.           "dSAOperation"          ; DSA-specific, value depends on server
  221.  
  222.    Servers are not required to provide the same or any text 
  223.    in the description part of the subschema values they maintain.
  224.    Servers SHOULD provide at least one of the "SUP" and "SYNTAX" fields 
  225.    for each AttributeTypeDescription.
  226.  
  227.    Servers MUST implement all the attribute types referenced in 
  228.    sections 5.1, 5.2 and 5.3.  
  229.  
  230.    Servers MAY recognize additional names and attributes not listed in 
  231.    this document, and if they do so, MUST publish the definitions of 
  232.    the types in the attributeTypes attribute of their subschema 
  233.    entries.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 4
  241.  
  242. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  243.  
  244.    Schema developers MUST NOT create attribute definitions whose names
  245.    conflict with attributes defined for use with LDAP in existing 
  246.    standards-track RFCs.
  247.  
  248.    An AttributeDescription can be used as the value in a NAME part of an
  249.    AttributeTypeDescription.  Note that these are case insensitive.
  250.  
  251.    Note that the AttributeTypeDescription does not list the matching 
  252.    rules which can can be used with that attribute type in an 
  253.    extensibleMatch search filter.  This is done using the matchingRuleUse
  254.    attribute described in section 4.5.
  255.  
  256.    This document refines the schema description of X.501 by requiring 
  257.    that the syntax field in an AttributeTypeDescription be a string
  258.    representation of an OBJECT IDENTIFIER for the LDAP string syntax
  259.    definition, and an optional indication of the maximum length of
  260.    a value of this attribute.
  261.  
  262. 4.3. Syntaxes
  263.  
  264.    This section defines general requirements for LDAP attribute value
  265.    syntax encodings. All documents defining attribute syntax encodings 
  266.    for use with LDAP are expected to conform to these requirements.
  267.  
  268.    The encoding rules defined for a given attribute syntax must produce
  269.    octet strings.  To the greatest extent possible, encoded octet
  270.    strings should be usable in their native encoded form for display
  271.    purposes. In particular, encoding rules for attribute syntaxes
  272.    defining non-binary values should produce strings that can be
  273.    displayed with little or no translation by clients implementing 
  274.    LDAP.  There are a few cases (e.g. audio) however, when it is not 
  275.    sensible to produce a printable representation, and clients MUST NOT 
  276.    assume that an unrecognized syntax is a string representation.
  277.  
  278.    In encodings where an arbitrary string, not a Distinguished Name, is 
  279.    used as part of a larger production, and other than as part of a 
  280.    Distinguished Name, a backslash quoting mechanism is used to escape
  281.    the following separator symbol character (such as "'", "$" or "#") if 
  282.    it should occur in that string.  The backslash is followed by a pair 
  283.    of hexadecimal digits representing the next character.  A backslash 
  284.    itself in the string which forms part of a larger syntax is always 
  285.    transmitted as '\5C' or '\5c'. An example is given in section 6.27.
  286.  
  287.    Syntaxes are also defined for matching rules whose assertion value 
  288.    syntax is different from the attribute value syntax.
  289.  
  290. 4.3.1  Binary Transfer of Values
  291.  
  292.    This encoding format is used if the binary encoding is requested by 
  293.    the client for an attribute, or if the attribute syntax name is 
  294.    "1.3.6.1.4.1.1466.115.121.1.5".  The value, an instance of the ASN.1 
  295.    AttributeValue type, is BER-encoded, and the result is used as the
  296.    value: the first byte inside the OCTET STRING wrapper is a tag byte. 
  297.    However the OCTET STRING is still encoded in primitive form.)
  298.  
  299.  
  300. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 5
  301.  
  302. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  303.  
  304.    All servers MUST implement this form for both generating attribute 
  305.    values in search responses, and parsing attribute values in add, 
  306.    compare and modify requests, if the attribute type is recognized and 
  307.    the attribute syntax name is that of Binary.  Clients which request 
  308.    that all attributes be returned from entries MUST be prepared 
  309.    to receive values in binary (e.g. userCertificate), and SHOULD NOT
  310.    simply display binary or unrecognized values to users.
  311.  
  312. 4.3.2. Syntax Object Identifiers
  313.  
  314.    Syntaxes for use with LDAP are named by OBJECT IDENTIFIERs, which
  315.    are dotted-decimal strings.  These are not intended to be displayed 
  316.    to users.
  317.  
  318.    noidlen = numericoid [ "{" len "}" ]
  319.  
  320.    len     = numericstring
  321.  
  322.    The following table lists some of the syntaxes that have been defined 
  323.    for LDAP thus far.  The H-R column suggests whether a value in that 
  324.    syntax would likely be a human readable string.  Clients and servers 
  325.    need not implement all the syntaxes listed here, and MAY implement 
  326.    other syntaxes.
  327.  
  328.    Other documents may define additional syntaxes.  However, the 
  329.    definition of additional arbitrary syntaxes is strongly deprecated
  330.    since it will hinder interoperability: today's client and server
  331.    implementations generally do not have the ability to dynamically
  332.    recognize new syntaxes.  In most cases attributes will be defined 
  333.    with the syntax for directory strings.
  334.  
  335.    Value being represented        H-R OBJECT IDENTIFIER
  336.    =================================================================
  337.    ACI Item                        N  1.3.6.1.4.1.1466.115.121.1.1
  338.    Access Point                    Y  1.3.6.1.4.1.1466.115.121.1.2
  339.    Attribute Type Description      Y  1.3.6.1.4.1.1466.115.121.1.3
  340.    Audio                           N  1.3.6.1.4.1.1466.115.121.1.4
  341.    Binary                          N  1.3.6.1.4.1.1466.115.121.1.5
  342.    Bit String                      Y  1.3.6.1.4.1.1466.115.121.1.6
  343.    Boolean                         Y  1.3.6.1.4.1.1466.115.121.1.7
  344.    Certificate                     N  1.3.6.1.4.1.1466.115.121.1.8
  345.    Certificate List                N  1.3.6.1.4.1.1466.115.121.1.9
  346.    Certificate Pair                N  1.3.6.1.4.1.1466.115.121.1.10
  347.    Country String                  Y  1.3.6.1.4.1.1466.115.121.1.11
  348.    DN                              Y  1.3.6.1.4.1.1466.115.121.1.12
  349.    Data Quality Syntax             Y  1.3.6.1.4.1.1466.115.121.1.13
  350.    Delivery Method                 Y  1.3.6.1.4.1.1466.115.121.1.14
  351.    Directory String                Y  1.3.6.1.4.1.1466.115.121.1.15
  352.    DIT Content Rule Description    Y  1.3.6.1.4.1.1466.115.121.1.16
  353.    DIT Structure Rule Description  Y  1.3.6.1.4.1.1466.115.121.1.17
  354.    DL Submit Permission            Y  1.3.6.1.4.1.1466.115.121.1.18
  355.    DSA Quality Syntax              Y  1.3.6.1.4.1.1466.115.121.1.19
  356.    DSE Type                        Y  1.3.6.1.4.1.1466.115.121.1.20
  357.    Enhanced Guide                  Y  1.3.6.1.4.1.1466.115.121.1.21
  358.  
  359.  
  360. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 6
  361.  
  362. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  363.  
  364.    Facsimile Telephone Number      Y  1.3.6.1.4.1.1466.115.121.1.22
  365.    Fax                             N  1.3.6.1.4.1.1466.115.121.1.23
  366.    Generalized Time                Y  1.3.6.1.4.1.1466.115.121.1.24
  367.    Guide                           Y  1.3.6.1.4.1.1466.115.121.1.25
  368.    IA5 String                      Y  1.3.6.1.4.1.1466.115.121.1.26
  369.    INTEGER                         Y  1.3.6.1.4.1.1466.115.121.1.27
  370.    JPEG                            N  1.3.6.1.4.1.1466.115.121.1.28
  371.    LDAP Syntax Description         Y  1.3.6.1.4.1.1466.115.121.1.54
  372.    Master And Shadow Access Points Y  1.3.6.1.4.1.1466.115.121.1.29
  373.    Matching Rule Description       Y  1.3.6.1.4.1.1466.115.121.1.30
  374.    Matching Rule Use Description   Y  1.3.6.1.4.1.1466.115.121.1.31
  375.    Mail Preference                 Y  1.3.6.1.4.1.1466.115.121.1.32
  376.    MHS OR Address                  Y  1.3.6.1.4.1.1466.115.121.1.33
  377.    Modify Rights                   Y  1.3.6.1.4.1.1466.115.121.1.55
  378.    Name And Optional UID           Y  1.3.6.1.4.1.1466.115.121.1.34
  379.    Name Form Description           Y  1.3.6.1.4.1.1466.115.121.1.35
  380.    Numeric String                  Y  1.3.6.1.4.1.1466.115.121.1.36
  381.    Object Class Description        Y  1.3.6.1.4.1.1466.115.121.1.37
  382.    Octet String                    Y  1.3.6.1.4.1.1466.115.121.1.40
  383.    OID                             Y  1.3.6.1.4.1.1466.115.121.1.38
  384.    Other Mailbox                   Y  1.3.6.1.4.1.1466.115.121.1.39
  385.    Postal Address                  Y  1.3.6.1.4.1.1466.115.121.1.41
  386.    Protocol Information            Y  1.3.6.1.4.1.1466.115.121.1.42
  387.    Presentation Address            Y  1.3.6.1.4.1.1466.115.121.1.43
  388.    Printable String                Y  1.3.6.1.4.1.1466.115.121.1.44
  389.    Subtree Specification           Y  1.3.6.1.4.1.1466.115.121.1.45
  390.    Supplier Information            Y  1.3.6.1.4.1.1466.115.121.1.46
  391.    Supplier Or Consumer            Y  1.3.6.1.4.1.1466.115.121.1.47
  392.    Supplier And Consumer           Y  1.3.6.1.4.1.1466.115.121.1.48
  393.    Supported Algorithm             N  1.3.6.1.4.1.1466.115.121.1.49
  394.    Telephone Number                Y  1.3.6.1.4.1.1466.115.121.1.50
  395.    Teletex Terminal Identifier     Y  1.3.6.1.4.1.1466.115.121.1.51
  396.    Telex Number                    Y  1.3.6.1.4.1.1466.115.121.1.52
  397.    UTC Time                        Y  1.3.6.1.4.1.1466.115.121.1.53
  398.  
  399.    A suggested minimum upper bound on the number of characters in value 
  400.    with a string-based syntax, or the number of bytes in a value for all 
  401.    other syntaxes, may be indicated by appending this bound count inside 
  402.    of curly braces following the syntax name's OBJECT IDENTIFIER in an
  403.    Attribute Type Description.  This bound is not part of the syntax name
  404.    itself.  For instance, "1.3.6.4.1.1466.0{64}" suggests that server 
  405.    implementations should allow a string to be 64 characters long, 
  406.    although they may allow longer strings.  Note that a single character 
  407.    of the Directory String syntax may be encoded in more than one byte 
  408.    since UTF-8 is a variable-length encoding.
  409.  
  410. 4.3.3. Syntax Description
  411.  
  412.    The following BNF may be used to associate a short description with
  413.    a syntax OBJECT IDENTIFIER. Implementors should note that future 
  414.    versions of this document may expand this definition to include 
  415.    additional terms.  Terms whose identifier begins with "X-" are 
  416.    reserved for private experiments.
  417.  
  418.  
  419.  
  420. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 7
  421.  
  422. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  423.  
  424.       SyntaxDescription = "(" whsp
  425.           numericoid whsp
  426.           [ "DESC" qdstring ]
  427.           whsp ")"
  428.  
  429. 4.4. Object Classes
  430.  
  431.    The format for representation of object classes is defined in X.501 
  432.    [3]. In general every entry will contain an abstract class ("top" or 
  433.    "alias"), at least one structural object class, and zero or more 
  434.    auxiliary object classes.  Whether an object class is abstract,
  435.    structural or auxiliary is defined when the object class identifier 
  436.    is assigned.  An object class definition should not be changed 
  437.    without having a new identifier assigned to it.
  438.    
  439.    Object class descriptions are written according to the following BNF.
  440.    Implementors should note that future versions of this document may 
  441.    expand this definition to include additional terms.  Terms whose
  442.    identifier begins with "X-" are reserved for private experiments.
  443.  
  444.       ObjectClassDescription = "(" whsp
  445.           numericoid whsp      ; ObjectClass identifier
  446.           [ "NAME" qdescrs ]
  447.           [ "DESC" qdstring ]
  448.           [ "OBSOLETE" whsp ]
  449.           [ "SUP" oids ]       ; Superior ObjectClasses
  450.           [ ( "ABSTRACT" / "STRUCTURAL" / "AUXILIARY" ) whsp ]
  451.                                ; default structural
  452.           [ "MUST" oids ]      ; AttributeTypes
  453.           [ "MAY" oids ]       ; AttributeTypes
  454.       whsp ")"
  455.  
  456.    These are described as sample values for the subschema 
  457.    "objectClasses" attribute for a server which implements the LDAP 
  458.    schema. While lines have been folded for readability, the values 
  459.    transferred in protocol would not contain newlines.
  460.  
  461.    Servers SHOULD implement all the object classes referenced in 
  462.    section 7, except for extensibleObject, which is optional.
  463.  
  464.    Servers MAY implement additional object classes not listed in this 
  465.    document, and if they do so, MUST publish the definitions of the 
  466.    classes in the objectClasses attribute of their subschema entries.
  467.    Later documents may define additional object classes.
  468.  
  469.    Schema developers MUST NOT create object class definitions whose 
  470.    names conflict with attributes defined for use with LDAP in existing 
  471.    standards-track RFCs.
  472.  
  473. 4.5. Matching Rules
  474.  
  475.    Matching rules are used by servers to compare attribute values 
  476.    against assertion values when performing Search and Compare 
  477.    operations.  They are also used to identify the value to be added 
  478.    or deleted when modifying entries, and are used when comparing a 
  479.    purported distinguished name with the name of an entry.
  480. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 8
  481.  
  482. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  483.   
  484.    Most of the attributes given in this document will have an equality 
  485.    matching rule defined.
  486.  
  487.    Matching rule descriptions are written according to the following 
  488.    BNF.  Implementors should note that future versions of this document 
  489.    may have expanded this BNF to include additional terms.
  490.  
  491.       MatchingRuleDescription = "(" whsp
  492.           numericoid whsp  ; MatchingRule identifier
  493.           [ "NAME" qdescrs ]
  494.           [ "DESC" qdstring ]
  495.           [ "OBSOLETE" whsp ]
  496.           "SYNTAX" numericoid 
  497.       whsp ")"
  498.  
  499.    Values of the matchingRuleUse list the attributes which are suitable
  500.    for use with an extensible matching rule.
  501.  
  502.       MatchingRuleUseDescription = "(" whsp
  503.           numericoid whsp  ; MatchingRule identifier
  504.           [ "NAME" qdescrs ]
  505.           [ "DESC" qdstring ]
  506.           [ "OBSOLETE" ]
  507.          "APPLIES" oids    ; AttributeType identifiers
  508.       whsp ")"
  509.  
  510.    Servers which support matching rules and the extensibleMatch SHOULD 
  511.    implement all the matching rules in section 8.
  512.  
  513.    Servers MAY implement additional matching rules not listed in this 
  514.    document, and if they do so, MUST publish the definitions of the 
  515.    matching rules in the matchingRules attribute of their 
  516.    subschema entries. If the server supports the extensibleMatch, then 
  517.    the server MUST publish the relationship between the matching rules
  518.    and attributes in the matchingRuleUse attribute.
  519.  
  520.    For example, a server which implements a privately-defined matching
  521.    rule for performing sound-alike matches on Directory String-valued 
  522.    attributes would include the following in the subschema entry 
  523.    (1.2.3.4.5 is an example, the OID of an actual matching rule would be 
  524.    different):
  525.  
  526.    matchingRule: ( 1.2.3.4.5 NAME 'soundAlikeMatch' 
  527.     SYNTAX '1.3.6.1.4.1.1466.115.121.1.15' )
  528.  
  529.    If this matching rule could be used with the attributes 2.5.4.41 and
  530.    2.5.4.15, the following would also be present:
  531.  
  532.    matchingRuleUse: ( 1.2.3.4.5 APPLIES (2.5.4.41 $ 2.5.4.15) )
  533.  
  534.    A client could then make use of this matching rule by sending a 
  535.    search operation in which the filter is of the extensibleMatch choice,
  536.    the matchingRule field is "soundAlikeMatch", and the type field is 
  537.    "2.5.4.41" or "2.5.4.15".
  538.  
  539.  
  540. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 9
  541.  
  542. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  543.  
  544. 5. Attribute Types
  545.  
  546.    All LDAP server implementations MUST recognize the attribute types 
  547.    defined in this section.  
  548.  
  549.    Servers SHOULD also recognize all the attributes from section 5 of 
  550.    [12].
  551.  
  552. 5.1. Standard Operational Attributes
  553.  
  554.    Servers MUST maintain values of these attributes in accordance with 
  555.    the definitions in X.501(93).
  556.  
  557. 5.1.1. createTimestamp
  558.  
  559.    This attribute SHOULD appear in entries which were created using 
  560.    the Add operation.
  561.  
  562.     ( 2.5.18.1 NAME 'createTimestamp' EQUALITY generalizedTimeMatch
  563.       ORDERING generalizedTimeOrderingMatch 
  564.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.24' 
  565.       SINGLE-VALUE NO-USER-MODIFICATION USAGE directoryOperation ) 
  566.  
  567. 5.1.2. modifyTimestamp
  568.  
  569.    This attribute SHOULD appear in entries which have been modified 
  570.    using the Modify operation.
  571.  
  572.     ( 2.5.18.2 NAME 'modifyTimestamp' EQUALITY generalizedTimeMatch
  573.       ORDERING generalizedTimeOrderingMatch 
  574.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.24' 
  575.       SINGLE-VALUE NO-USER-MODIFICATION USAGE directoryOperation ) 
  576.  
  577. 5.1.3. creatorsName
  578.  
  579.    This attribute SHOULD appear in entries which were created using 
  580.    the Add operation.
  581.  
  582.     ( 2.5.18.3 NAME 'creatorsName' EQUALITY distinguishedNameMatch 
  583.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.12' 
  584.       SINGLE-VALUE NO-USER-MODIFICATION USAGE directoryOperation ) 
  585.  
  586. 5.1.4. modifiersName
  587.  
  588.    This attribute SHOULD appear in entries which have been modified 
  589.    using the Modify operation.
  590.  
  591.     ( 2.5.18.4 NAME 'modifiersName' EQUALITY distinguishedNameMatch 
  592.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.12' 
  593.       SINGLE-VALUE NO-USER-MODIFICATION USAGE directoryOperation ) 
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 10
  601.  
  602. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  603.  
  604. 5.1.5. subschemaSubentry
  605.  
  606.    The value of this attribute is the name of a subschema entry (or
  607.    subentry if the server is based on X.500(93)) in which the server
  608.    makes available attributes specifying the schema. 
  609.  
  610.     ( 2.5.18.10 NAME 'subschemaSubentry' 
  611.       EQUALITY distinguishedNameMatch 
  612.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.12' NO-USER-MODIFICATION 
  613.       SINGLE-VALUE USAGE directoryOperation )
  614.  
  615. 5.1.6. attributeTypes
  616.  
  617.    This attribute is typically located in the subschema entry.
  618.  
  619.     ( 2.5.21.5 NAME 'attributeTypes' 
  620.       EQUALITY objectIdentifierFirstComponentMatch
  621.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.3' USAGE directoryOperation ) 
  622.  
  623. 5.1.7. objectClasses
  624.  
  625.    This attribute is typically located in the subschema entry.
  626.  
  627.     ( 2.5.21.6 NAME 'objectClasses' 
  628.       EQUALITY objectIdentifierFirstComponentMatch
  629.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.37' USAGE directoryOperation ) 
  630.  
  631. 5.1.8. matchingRules
  632.  
  633.    This attribute is typically located in the subschema entry.
  634.  
  635.     ( 2.5.21.4 NAME 'matchingRules' 
  636.       EQUALITY objectIdentifierFirstComponentMatch
  637.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.30' USAGE directoryOperation ) 
  638.  
  639. 5.1.9. matchingRuleUse
  640.  
  641.    This attribute is typically located in the subschema entry.
  642.  
  643.     ( 2.5.21.8 NAME 'matchingRuleUse' 
  644.       EQUALITY objectIdentifierFirstComponentMatch
  645.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.31' USAGE directoryOperation ) 
  646.  
  647. 5.2. LDAP Operational Attributes
  648.  
  649.    These attributes are only present in the root DSE (see [1] and [3]).
  650.  
  651.    Servers MUST recognize these attribute names, but it is not required 
  652.    that a server provide values for these attributes, when the 
  653.    attribute corresponds to a feature which the server does not 
  654.    implement.
  655.  
  656.  
  657.  
  658.  
  659.  
  660. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 11
  661.  
  662. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  663.  
  664. 5.2.1. namingContexts
  665.  
  666.    The values of this attribute correspond to naming contexts which this
  667.    server masters or shadows.  If the server does not master any 
  668.    information (e.g. it is an LDAP gateway to a public X.500 directory) 
  669.    this attribute will be absent.  If the server believes it contains 
  670.    the entire directory, the attribute will have a single value, and 
  671.    that value will be the empty string (indicating the null DN of the 
  672.    root). This attribute will allow a client to choose suitable base 
  673.    objects for searching when it has contacted a server.
  674.  
  675.     ( 1.3.6.1.4.1.1466.101.120.5 NAME 'namingContexts'
  676.      SYNTAX '1.3.6.1.4.1.1466.115.121.1.12' USAGE dSAOperation )
  677.  
  678. 5.2.2. altServer
  679.  
  680.    The values of this attribute are URLs of other servers which may be 
  681.    contacted when this server becomes unavailable.  If the server does 
  682.    not know of any other servers which could be used this attribute 
  683.    will be absent. Clients may cache this information in case their 
  684.    preferred LDAP server later becomes unavailable.
  685.  
  686.     ( 1.3.6.1.4.1.1466.101.120.6 NAME 'altServer'
  687.      SYNTAX '1.3.6.1.4.1.1466.115.121.1.26' USAGE dSAOperation )
  688.  
  689. 5.2.3. supportedExtension
  690.  
  691.    The values of this attribute are OBJECT IDENTIFIERs identifying the 
  692.    supported extended operations which the server supports.   
  693.  
  694.    If the server does not support any extensions this attribute will be 
  695.    absent.
  696.  
  697.     ( 1.3.6.1.4.1.1466.101.120.7 NAME 'supportedExtension'
  698.      SYNTAX '1.3.6.1.4.1.1466.115.121.1.38' USAGE dSAOperation )
  699.  
  700. 5.2.4. supportedControl
  701.  
  702.    The values of this attribute are the OBJECT IDENTIFIERs identifying 
  703.    controls which the server supports.  If the server does not 
  704.    support any controls, this attribute will be absent.
  705.  
  706.     ( 1.3.6.1.4.1.1466.101.120.13 NAME 'supportedControl'
  707.      SYNTAX '1.3.6.1.4.1.1466.115.121.1.38' USAGE dSAOperation )
  708.  
  709. 5.2.5. supportedSASLMechanisms
  710.  
  711.    The values of this attribute are the names of supported SASL
  712.    mechanisms which the server supports.  If the server does not 
  713.    support any mechanisms this attribute will be absent.
  714.  
  715.     ( 1.3.6.1.4.1.1466.101.120.14 NAME 'supportedSASLMechanisms'
  716.      SYNTAX '1.3.6.1.4.1.1466.115.121.1.15' USAGE dSAOperation )
  717.  
  718.  
  719.  
  720. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 12
  721.  
  722. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  723.  
  724. 5.2.6. supportedLDAPVersion
  725.  
  726.    The values of this attribute are the versions of the LDAP protocol 
  727.    which the server implements.
  728.  
  729.     ( 1.3.6.1.4.1.1466.101.120.15 NAME 'supportedLDAPVersion'
  730.      SYNTAX '1.3.6.1.4.1.1466.115.121.1.27' USAGE dSAOperation )
  731.  
  732. 5.3. LDAP Subschema Attribute
  733.  
  734.    This attribute is typically located in the subschema entry.
  735.  
  736. 5.3.1. ldapSyntaxes
  737.  
  738.    Servers MAY use this attribute to list the syntaxes which are 
  739.    implemented.  Each value corresponds to one syntax. 
  740.  
  741.     ( 1.3.6.1.4.1.1466.101.120.16 NAME 'ldapSyntaxes'
  742.       EQUALITY objectIdentifierFirstComponentMatch
  743.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.54' USAGE directoryOperation )
  744.  
  745. 6. Syntaxes
  746.  
  747.    Servers SHOULD recognize all the syntaxes described in this section. 
  748.  
  749. 6.1. Attribute Type Description
  750.  
  751.    ( 1.3.6.1.4.1.1466.115.121.1.3 DESC 'Attribute Type Description' )
  752.  
  753.    Values in this syntax are encoded according to the BNF given at the
  754.    start of section 4.2. For example,
  755.  
  756.         ( 2.5.4.0 NAME 'objectClass' 
  757.           SYNTAX '1.3.6.1.4.1.1466.115.121.1.38' )
  758.  
  759. 6.2. Binary
  760.  
  761.    ( 1.3.6.1.4.1.1466.115.121.1.5 DESC 'Binary' )
  762.  
  763.    Values in this syntax are encoded as described in section 4.3.1.
  764.  
  765. 6.3. Bit String
  766.  
  767.    ( 1.3.6.1.4.1.1466.115.121.1.6 DESC 'Bit String' )
  768.  
  769.    Values in this syntax are encoded according to the following BNF:
  770.  
  771.       bitstring = "'" *binary-digit "'B"
  772.  
  773.       binary-digit = "0" / "1"
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 13
  781.  
  782. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  783.  
  784.    Example:
  785.   
  786.         '0101111101'B
  787.  
  788. 6.4. Boolean
  789.  
  790.    ( 1.3.6.1.4.1.1466.115.121.1.7 DESC 'Boolean' )
  791.  
  792.    Values in this syntax are encoded according to the following BNF:
  793.  
  794.       boolean = "TRUE" / "FALSE"
  795.  
  796.    Boolean values have an encoding of "TRUE" if they are logically true,
  797.    and have an encoding of "FALSE" otherwise.
  798.  
  799. 6.5. Certificate
  800.  
  801.    ( 1.3.6.1.4.1.1466.115.121.1.8 DESC 'Certificate' )
  802.  
  803.    Because of the changes from X.509(1988) and X.509(1993) and 
  804.    additional changes to the ASN.1 definition to support certificate 
  805.    extensions, no string representation is defined, and values in
  806.    this syntax MUST only be transferred using the binary encoding, by 
  807.    requesting or returning the attributes with descriptions 
  808.    "userCertificate;binary" or "caCertificate;binary".  The BNF notation 
  809.    in RFC 1778 for "User Certificate" is not recommended to be used.
  810.  
  811. 6.6. Certificate List
  812.  
  813.    ( 1.3.6.1.4.1.1466.115.121.1.9 DESC 'Certificate List' )
  814.  
  815.    Because of the incompatibility of the X.509(1988) and X.509(1993) 
  816.    definitions of revocation lists, values in this syntax MUST only be 
  817.    transferred using a binary encoding, by requesting or returning the 
  818.    attributes with descriptions "certificateRevocationList;binary" or 
  819.    "authorityRevocationList;binary".  The BNF notation in RFC 1778 for 
  820.    "Authority Revocation List" is not recommended to be used.
  821.  
  822. 6.7. Certificate Pair
  823.  
  824.    ( 1.3.6.1.4.1.1466.115.121.1.10 DESC 'Certificate Pair' )
  825.  
  826.    Because the Certificate is being carried in binary, values in this 
  827.    syntax MUST only be transferred using a binary encoding, by requesting 
  828.    or returning the attribute description "crossCertificatePair;binary". 
  829.    The BNF notation in RFC 1778 for "Certificate Pair" is not 
  830.    recommended to be used.
  831.  
  832. 6.8. Country String
  833.  
  834.    ( 1.3.6.1.4.1.1466.115.121.1.11 DESC 'Country String' )
  835.  
  836.    A value in this syntax is encoded the same as a value of
  837.    Directory String syntax.  Note that this syntax is limited to values
  838.    of exactly two printable string characters, as listed in ISO 3166 [14].
  839.  
  840. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 14
  841.  
  842. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  843.  
  844.       CountryString  = p p
  845.  
  846.    Example:
  847.       US
  848.  
  849. 6.9. DN
  850.  
  851.    ( 1.3.6.1.4.1.1466.115.121.1.12 DESC 'DN' )
  852.  
  853.    Values in the Distinguished Name syntax are encoded to have the
  854.    representation defined in [5].  Note that this representation is not 
  855.    reversible to an ASN.1 encoding used in X.500 for Distinguished 
  856.    Names, as the CHOICE of any DirectoryString element in an RDN is no 
  857.    longer known.
  858.  
  859.    Examples (from [5]):
  860.       CN=Steve Kille,O=Isode Limited,C=GB
  861.       OU=Sales+CN=J. Smith,O=Widget Inc.,C=US
  862.       CN=L. Eagle,O=Sue\, Grabbit and Runn,C=GB
  863.       CN=Before\0DAfter,O=Test,C=GB
  864.       1.3.6.1.4.1.1466.0=#04024869,O=Test,C=GB
  865.       SN=Lu\C4\8Di\C4\87
  866.  
  867. 6.10. Directory String
  868.  
  869.    ( 1.3.6.1.4.1.1466.115.121.1.15 DESC 'Directory String' )
  870.  
  871.    A string in this syntax is encoded in the UTF-8 form of ISO 10646 
  872.    (a superset of Unicode).  Servers and clients MUST be prepared to 
  873.    receive encodings of arbitrary Unicode characters, including 
  874.    characters not presently assigned to any character set.
  875.  
  876.    For characters in the PrintableString form, the value is encoded as 
  877.    the string value itself.
  878.  
  879.    If it is of the TeletexString form, then the characters are 
  880.    transliterated to their equivalents in UniversalString, and encoded 
  881.    in UTF-8 [9].
  882.  
  883.    If it is of the UniversalString or BMPString forms [10], UTF-8 is 
  884.    used to encode them. 
  885.  
  886.    Note: the form of DirectoryString is not indicated in protocol 
  887.    unless the attribute value is carried in binary.  Servers which 
  888.    convert to DAP MUST choose an appropriate form.  Servers MUST NOT 
  889.    reject values merely because they contain legal Unicode characters 
  890.    outside of the range of printable ASCII.
  891.  
  892.    Example:
  893.  
  894.       This is a string of DirectoryString containing #!%#@
  895.  
  896.  
  897.  
  898.  
  899.  
  900. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 15
  901.  
  902. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  903.  
  904. 6.11. DIT Content Rule Description
  905.  
  906.    ( 1.3.6.1.4.1.1466.115.121.1.16 DESC 'DIT Content Rule Description' )
  907.  
  908.    Values in this syntax are encoded according to the following BNF.
  909.    Implementors should note that future versions of this document 
  910.    may have expanded this BNF to include additional terms.
  911.  
  912.       DITContentRuleDescription = "("
  913.           numericoid   ; Structural ObjectClass identifier
  914.           [ "NAME" qdescrs ]
  915.           [ "DESC" qdstring ]
  916.           [ "OBSOLETE" ]
  917.           [ "AUX" oids ]    ; Auxiliary ObjectClasses
  918.           [ "MUST" oids ]   ; AttributeType identifiers
  919.           [ "MAY" oids ]    ; AttributeType identifiers
  920.           [ "NOT" oids ]    ; AttributeType identifiers
  921.          ")"
  922.  
  923. 6.12. Facsimile Telephone Number
  924.  
  925.    ( 1.3.6.1.4.1.1466.115.121.1.22 DESC 'Facsimile Telephone Number' )
  926.  
  927.    Values in this syntax are encoded according to the following BNF:
  928.  
  929.       fax-number    = printablestring [ "$" faxparameters ]
  930.  
  931.       faxparameters = faxparm / ( faxparm "$" faxparameters )
  932.  
  933.       faxparm = "twoDimensional" / "fineResolution" / 
  934.                 "unlimitedLength" /
  935.                 "b4Length" / "a3Width" / "b4Width" / "uncompressed"
  936.  
  937.    In the above, the first printablestring is the telephone number,
  938.    based on E.123 [15], and the faxparm tokens represent fax parameters.
  939.  
  940. 6.13. Fax
  941.  
  942.    ( 1.3.6.1.4.1.1466.115.121.1.23 DESC 'Fax' )
  943.  
  944.    Values in this syntax are encoded as if they were octet strings
  945.    containing Group 3 Fax images as defined in [7].
  946.  
  947. 6.14. Generalized Time
  948.  
  949.    ( 1.3.6.1.4.1.1466.115.121.1.24 DESC 'Generalized Time' )
  950.  
  951.    Values in this syntax are encoded as printable strings, represented 
  952.    as specified in X.208.  Note that the time zone must be specified.
  953.    It is strongly recommended that GMT time be used.  For example,
  954.  
  955.                 199412161032Z
  956.  
  957.  
  958.  
  959.  
  960. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 16
  961.  
  962. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  963.  
  964. 6.15. IA5 String
  965.  
  966.    ( 1.3.6.1.4.1.1466.115.121.1.26 DESC 'IA5 String' )
  967.  
  968.    The encoding of a value in this syntax is the string value itself.
  969.  
  970. 6.16. INTEGER
  971.  
  972.    ( 1.3.6.1.4.1.1466.115.121.1.27 DESC 'INTEGER' )
  973.  
  974.    Values in this syntax are encoded as the decimal representation 
  975.    of their values, with each decimal digit represented by the its 
  976.    character equivalent. So the number 1321 is represented by the 
  977.    character string "1321".
  978.  
  979. 6.17. JPEG
  980.  
  981.    ( 1.3.6.1.4.1.1466.115.121.1.28 DESC 'JPEG' )
  982.  
  983.    Values in this syntax are encoded as strings containing JPEG images in 
  984.    the JPEG File Interchange Format (JFIF), as described in [8].
  985.  
  986. 6.18. Matching Rule Description
  987.  
  988.    ( 1.3.6.1.4.1.1466.115.121.1.30 DESC 'Matching Rule Description' )
  989.  
  990.    Values of type matchingRules are encoded as strings according to
  991.    the BNF given in section 4.5. 
  992.  
  993. 6.19. Matching Rule Use Description
  994.  
  995.    ( 1.3.6.1.4.1.1466.115.121.1.31 DESC 'Matching Rule Use Description' )
  996.  
  997.    Values of type matchingRuleUse are encoded as strings according to
  998.    the BNF given in section 4.5.
  999.  
  1000. 6.20. MHS OR Address
  1001.  
  1002.    ( 1.3.6.1.4.1.1466.115.121.1.33 DESC 'MHS OR Address' )
  1003.  
  1004.    Values in this syntax are encoded as strings, according to the format 
  1005.    defined in [11].
  1006.  
  1007. 6.21. Name And Optional UID
  1008.  
  1009.    ( 1.3.6.1.4.1.1466.115.121.1.34 DESC 'Name And Optional UID' )
  1010.  
  1011.    Values in this syntax are encoded according to the following BNF:
  1012.  
  1013.       NameAndOptionalUID = DistinguishedName [ "#" bitstring ]
  1014.  
  1015.    Although the '#' character may occur in a string representation of a 
  1016.    distinguished name, no additional special quoting is done.  This 
  1017.    syntax has been added subsequent to RFC 1778.
  1018.  
  1019.  
  1020. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 17
  1021.  
  1022. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  1023.  
  1024.    Example:
  1025.  
  1026.       1.3.6.1.4.1.1466.0=#04024869,O=Test,C=GB#'0101'B
  1027.  
  1028. 6.22. Name Form Description
  1029.  
  1030.    ( 1.3.6.1.4.1.1466.115.121.1.35 DESC 'Name Form Description' )
  1031.  
  1032.    Values in this syntax are encoded according to the following BNF.
  1033.    Implementors should note that future versions of this document 
  1034.    may have expanded this BNF to include additional terms.
  1035.  
  1036.       NameFormDescription = "(" whsp
  1037.           numericoid whsp  ; NameForm identifier
  1038.           [ "NAME" qdescrs ]
  1039.           [ "DESC" qdstring ]
  1040.           [ "OBSOLETE" whsp ]
  1041.           "OC" woid         ; Structural ObjectClass
  1042.           "MUST" oids       ; AttributeTypes
  1043.           [ "MAY" oids ]    ; AttributeTypes
  1044.       whsp ")"
  1045.  
  1046. 6.23. Numeric String
  1047.  
  1048.    ( 1.3.6.1.4.1.1466.115.121.1.36 DESC 'Numeric String' )
  1049.  
  1050.    The encoding of a string in this syntax is the string value itself. 
  1051.    Example:
  1052.   
  1053.       1997
  1054.  
  1055. 6.24. Object Class Description
  1056.  
  1057.    ( 1.3.6.1.4.1.1466.115.121.1.37 DESC 'Object Class Description' )
  1058.  
  1059.    Values in this syntax are encoded according to the BNF in section 4.4.
  1060.  
  1061. 6.25. OID
  1062.  
  1063.    ( 1.3.6.1.4.1.1466.115.121.1.38 DESC 'OID' )
  1064.  
  1065.    Values in the Object Identifier syntax are encoded according to 
  1066.    the BNF in section 4.1 for "oid".
  1067.  
  1068.    Example:
  1069.  
  1070.        1.2.3.4
  1071.        cn
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 18
  1081.  
  1082. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  1083.  
  1084. 6.26. Other Mailbox
  1085.  
  1086.    ( 1.3.6.1.4.1.1466.115.121.1.39 DESC 'Other Mailbox' )
  1087.  
  1088.    Values in this syntax are encoded according to the following BNF:
  1089.  
  1090.       otherMailbox = mailbox-type "$" mailbox
  1091.  
  1092.       mailbox-type = printablestring
  1093.  
  1094.       mailbox = <an encoded IA5 String>
  1095.  
  1096.    In the above, mailbox-type represents the type of mail system in
  1097.    which the mailbox resides, for example "MCIMail"; and mailbox is 
  1098.    the actual mailbox in the mail system defined by mailbox-type.
  1099.  
  1100. 6.27. Postal Address
  1101.  
  1102.    ( 1.3.6.1.4.1.1466.115.121.1.41 DESC 'Postal Address' )
  1103.  
  1104.    Values in this syntax are encoded according to the following BNF:
  1105.  
  1106.       postal-address = dstring *( "$" dstring )
  1107.  
  1108.    In the above, each dstring component of a postal address value is
  1109.    encoded as a value of type Directory String syntax.  Backslashes and 
  1110.    dollar characters, if they occur in the component, are quoted as 
  1111.    described in section 4.3.   Many servers limit the postal address to
  1112.    six lines of up to thirty characters.
  1113.  
  1114.    Example:
  1115.  
  1116.       1234 Main St.$Anytown, CA 12345$USA
  1117.       \241,000,000 Sweepstakes$PO Box 1000000$Anytown, CA 12345$USA
  1118.  
  1119. 6.28. Presentation Address
  1120.  
  1121.    ( 1.3.6.1.4.1.1466.115.121.1.43 DESC 'Presentation Address' )
  1122.  
  1123.    Values in this syntax are encoded with the representation described
  1124.    in RFC 1278 [6].
  1125.  
  1126. 6.29. Printable String
  1127.  
  1128.    ( 1.3.6.1.4.1.1466.115.121.1.44 DESC 'Printable String' )
  1129.  
  1130.    The encoding of a value in this syntax is the string value itself.  
  1131.    PrintableString is limited to the characters in production p of 
  1132.    section 4.1.
  1133.  
  1134.    Example:
  1135.  
  1136.       This is a PrintableString
  1137.  
  1138.  
  1139.  
  1140. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 19
  1141.  
  1142. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  1143.  
  1144. 6.30. Telephone Number
  1145.  
  1146.    ( 1.3.6.1.4.1.1466.115.121.1.50 DESC 'Telephone Number' )
  1147.  
  1148.    Values in this syntax are encoded as if they were Printable String 
  1149.    types.  Telephone numbers are recommended in X.520 to be in 
  1150.    international form, as described in E.123 [15].  
  1151.  
  1152.    Example:
  1153.  
  1154.       +1 512 305 0280
  1155.  
  1156. 6.31. UTC Time
  1157.  
  1158.    ( 1.3.6.1.4.1.1466.115.121.1.53 DESC 'UTC Time' )
  1159.  
  1160.    Values in this syntax are encoded as if they were printable
  1161.    strings with the strings containing a UTCTime value.  This is 
  1162.    historical; new attribute definitions SHOULD use GeneralizedTime 
  1163.    instead.
  1164.  
  1165. 6.32. LDAP Syntax Description
  1166.  
  1167.    ( 1.3.6.1.4.1.1466.115.121.1.54 DESC 'LDAP Syntax Description' )
  1168.  
  1169.    Values in this syntax are encoded according to the BNF in section
  1170.    4.3.3.
  1171.  
  1172. 7. Object Classes
  1173.  
  1174.    Servers SHOULD recognize all the names of standard classes from 
  1175.    section 7 of [12].
  1176.  
  1177. 7.1. Extensible Object Class
  1178.  
  1179.    The extensibleObject object class, if present in an entry, permits 
  1180.    that entry to optionally hold any attribute.  The MAY attribute list 
  1181.    of this class is implicitly the set of all attributes.
  1182.  
  1183.     ( 1.3.6.1.4.1.1466.101.120.111 NAME 'extensibleObject' 
  1184.       SUP top AUXILIARY )  
  1185.  
  1186.    The mandatory attributes of the other object classes of this entry 
  1187.    are still required to be present. 
  1188.  
  1189.    Note that not all servers will implement this object class, and those
  1190.    which do not will reject requests to add entries which contain this 
  1191.    object class, or modify an entry to add this object class.
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 20
  1201.  
  1202. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  1203.  
  1204. 8. Matching Rules
  1205.  
  1206.    Servers which implement the extensibleMatch filter SHOULD allow 
  1207.    all the matching rules listed in this section to be used in the 
  1208.    extensibleMatch.  In general these servers SHOULD allow matching 
  1209.    rules to be used with all attribute types known to the server, when
  1210.    the assertion syntax of the matching rule is the same as the value 
  1211.    syntax of the attribute.
  1212.  
  1213.    Servers MAY implement additional matching rules. 
  1214.  
  1215. 8.1. Matching Rules used in Equality Filters
  1216.  
  1217.    Servers SHOULD be capable of performing the following matching rules.
  1218.  
  1219.    For all these rules, the assertion syntax is the same as the value 
  1220.    syntax.
  1221.  
  1222.     ( 2.5.13.0 NAME 'objectIdentifierMatch' 
  1223.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.38' )
  1224.  
  1225.    If the client supplies a filter using an objectIdentifierMatch whose 
  1226.    matchValue oid is in the "descr" form, and the oid is not recognized 
  1227.    by the server, then the filter is Undefined. 
  1228.  
  1229.     ( 2.5.13.1 NAME 'distinguishedNameMatch' 
  1230.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.12' )
  1231.  
  1232.     ( 2.5.13.2 NAME 'caseIgnoreMatch' 
  1233.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.15' )
  1234.  
  1235.     ( 2.5.13.8 NAME 'numericStringMatch' 
  1236.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.36' )
  1237.  
  1238.     ( 2.5.13.11 NAME 'caseIgnoreListMatch' 
  1239.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.41' )
  1240.  
  1241.     ( 2.5.13.14 NAME 'integerMatch' 
  1242.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.27' )
  1243.  
  1244.     ( 2.5.13.16 NAME 'bitStringMatch' 
  1245.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.6' )
  1246.  
  1247.     ( 2.5.13.20 NAME 'telephoneNumberMatch' 
  1248.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.50' )
  1249.  
  1250.     ( 2.5.13.22 NAME 'presentationAddressMatch' 
  1251.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.43' )
  1252.  
  1253.     ( 2.5.13.23 NAME 'uniqueMemberMatch' 
  1254.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.34' )
  1255.  
  1256.     ( 2.5.13.24 NAME 'protocolInformationMatch'
  1257.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.42' )
  1258.  
  1259.  
  1260. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 21
  1261.  
  1262. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  1263.  
  1264.     ( 2.5.13.27 NAME 'generalizedTimeMatch' 
  1265.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.24' )
  1266.  
  1267.     ( 1.3.6.1.4.1.1466.109.114.1 NAME 'caseExactIA5Match' 
  1268.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.26' )
  1269.  
  1270.     ( 1.3.6.1.4.1.1466.109.114.2 NAME 'caseIgnoreIA5Match' 
  1271.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.26' )
  1272.  
  1273.    When performing the caseIgnoreMatch, caseIgnoreListMatch, 
  1274.    telephoneNumberMatch, caseExactIA5Match and caseIgnoreIA5Match,
  1275.    multiple adjoining whitespace characters are treated the same as an 
  1276.    individual space, and leading and trailing whitespace is ignored.
  1277.  
  1278.    Clients MUST NOT assume that servers are capable of transliteration
  1279.    of Unicode values.
  1280.  
  1281. 8.2. Matching Rules used in Inequality Filters
  1282.  
  1283.    Servers SHOULD be capable of performing the following matching rules,
  1284.    which are used in greaterOrEqual and lessOrEqual filters.
  1285.  
  1286.     ( 2.5.13.28 NAME 'generalizedTimeOrderingMatch'
  1287.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.24' )
  1288.  
  1289.     ( 2.5.13.3 NAME 'caseIgnoreOrderingMatch' 
  1290.       SYNTAX '1.3.6.1.4.1.1466.115.121.1.15' )
  1291.  
  1292.    The sort ordering for a caseIgnoreOrderingMatch is
  1293.    implementation-dependent.
  1294.  
  1295. 8.3. Matching Rules for Subschema Attributes
  1296.  
  1297.    Servers which allow subschema entries to be modified by clients MUST 
  1298.    support the following matching rule, as it is the equality matching
  1299.    rule for several of the subschema attributes. 
  1300.  
  1301.    ( 2.5.13.30 NAME 'objectIdentifierFirstComponentMatch'
  1302.      SYNTAX '1.3.6.1.4.1.1466.115.121.1.38' )
  1303.  
  1304.    Implementors should note that the assertion syntax of this matching 
  1305.    rule, an OID, is different from the value syntax of attributes for 
  1306.    which this is the equality matching rule.
  1307.  
  1308.    If the client supplies a filter using an 
  1309.    objectIdentifierFirstComponentMatch whose matchValue oid is in the 
  1310.    "descr" form, and the oid is not recognized by the server, then the 
  1311.    filter is Undefined. 
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 22
  1321.  
  1322. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  1323.  
  1324. 9. Security Considerations
  1325.  
  1326. 9.1. Disclosure
  1327.  
  1328.    Attributes of directory entries are used to provide descriptive 
  1329.    information about the real-world objects they represent, which can
  1330.    be people, organizations or devices.  Most countries have privacy
  1331.    laws regarding the publication of information about people.
  1332.  
  1333. 9.2. Use of Attribute Values in Security Applications
  1334.  
  1335.    The transformations of an AttributeValue value from its X.501 form to
  1336.    an LDAP string representation are not always reversible back to the 
  1337.    same BER or DER form.  An example of a situation which requires the 
  1338.    DER form of a distinguished name is the verification of an X.509 
  1339.    certificate.
  1340.  
  1341.    For example, a distinguished name consisting of one RDN with one AVA,
  1342.    in which the type is commonName and the value is of the TeletexString 
  1343.    choice with the letters 'Sam' would be represented in LDAP as the
  1344.    string CN=Sam.  Another distinguished name in which the value is 
  1345.    still 'Sam' but of the PrintableString choice would have the same 
  1346.    representation CN=Sam.
  1347.  
  1348.    Applications which require the reconstruction of the DER form of the 
  1349.    value SHOULD NOT use the string representation of attribute syntaxes
  1350.    when converting a value to LDAP format.  Instead it SHOULD use the 
  1351.    Binary syntax.
  1352.  
  1353. 10. Acknowledgements
  1354.  
  1355.    This document is based substantially on RFC 1778, written by Tim 
  1356.    Howes, Steve Kille, Wengyik Yeong and Colin Robbins.
  1357.  
  1358.    Many of the attribute syntax encodings defined in this and 
  1359.    related documents are adapted from those used in the QUIPU and the 
  1360.    IC R3 X.500 implementations. The contributions of the authors of both 
  1361.    these implementations in the specification of syntaxes are gratefully 
  1362.    acknowledged.
  1363.  
  1364. 11. Authors Addresses
  1365.  
  1366.        Mark Wahl
  1367.        Critical Angle Inc.
  1368.        4815 West Braker Lane #502-385
  1369.        Austin, TX 78759
  1370.        USA
  1371.  
  1372.        Phone:  +1 512 372-3160
  1373.        EMail:  M.Wahl@critical-angle.com
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 23
  1381.  
  1382. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  1383.  
  1384.        Andy Coulbeck
  1385.        Isode Inc.
  1386.        3925 West Braker Lane #333
  1387.        Austin, TX 78759 
  1388.        USA
  1389.  
  1390.        Phone:  +1 512 305-0280
  1391.        EMail:  A.Coulbeck@isode.com
  1392.  
  1393.        Tim Howes
  1394.        Netscape Communications Corp.
  1395.        501 E. Middlefield Rd
  1396.        Mountain View, CA 94043
  1397.        USA
  1398.        
  1399.        Phone:  +1 415 254-1900
  1400.        EMail:   howes@netscape.com
  1401.  
  1402.        Steve Kille
  1403.        Isode Limited
  1404.        The Dome, The Square
  1405.        Richmond
  1406.        TW9 1DT
  1407.        UK
  1408.  
  1409.        Phone:  +44-181-332-9091
  1410.        EMail:  S.Kille@isode.com
  1411.  
  1412. 12. Bibliography
  1413.  
  1414.    [1] M. Wahl, T. Howes, S. Kille, "Lightweight Directory Access 
  1415.        Protocol (Version 3)", INTERNET-DRAFT 
  1416.        <draft-ietf-asid-ldapv3-protocol-07.txt>, Aug. 1997.
  1417.  
  1418.    [2] The Directory: Selected Attribute Types.  ITU-T Recommendation 
  1419.        X.520, 1993.
  1420.  
  1421.    [3] The Directory: Models. ITU-T Recommendation X.501, 1993.
  1422.  
  1423.    [4] S. Bradner, "Key words for use in RFCs to Indicate Requirement 
  1424.        Levels", RFC 2119.
  1425.    
  1426.    [5] M. Wahl, S. Kille, "A UTF-8 String Representation of 
  1427.        Distinguished Names", INTERNET-DRAFT 
  1428.        <draft-ietf-asid-ldapv3-dn-03.txt>, April 1997.
  1429.  
  1430.    [6] S. Kille, "A String Representation for Presentation Addresses",
  1431.        RFC 1278, University College London, November 1991.
  1432.  
  1433.    [7] Terminal Equipment and Protocols for Telematic Services -
  1434.        Standardization of Group 3 facsimile apparatus for document
  1435.        transmission.  CCITT, Recommendation T.4.
  1436.  
  1437.    [8] JPEG File Interchange Format (Version 1.02).  Eric Hamilton, 
  1438.        C-Cube Microsystems, Milpitas, CA, September 1, 1992.
  1439.  
  1440. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 24
  1441.  
  1442. INTERNET-DRAFT    draft-ietf-asid-ldapv3-attributes-07.txt   Aug. 1997
  1443.  
  1444.    [9] F. Yergeau, "UTF-8, a transformation format of Unicode and ISO 
  1445.        10646", RFC 2044, October 1996.
  1446.  
  1447.    [10] Universal Multiple-Octet Coded Character Set (UCS) - 
  1448.         Architecture and Basic Multilingual Plane, ISO/IEC 10646-1 : 
  1449.         1993 (With amendments).
  1450.  
  1451.    [11] S. Hardcastle-Kille, "Mapping between X.400(1988) / ISO 10021 
  1452.         and RFC 822", RFC 1327, May 1992.
  1453.  
  1454.    [12] M. Wahl, "X.500(96) User Schema for use with LDAP", 
  1455.         INTERNET-DRAFT <draft-ietf-asid-ldapv3schema-x500-02.txt>,
  1456.         Aug. 1997.
  1457.  
  1458.    [13] D. Crocker, "Standard of the Format of ARPA-Internet Text
  1459.         Messages", STD 11, RFC 822, August 1982.
  1460.  
  1461.    [14] ISO 3166, "Codes for the representation of names of countries".
  1462.  
  1463.    [15] ITU-T Rec. E.123, Notation for national and international 
  1464.         telephone numbers, 1988.
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498. <draft-ietf-asid-ldapv3-attributes-07.txt> Expires: February 1998
  1499. Wahl,Coulbeck,Howes,Kille   LDAPv3 Attribute Syntax Defns.   Page 25
  1500.  
  1501.  
  1502.