git.sur5r.net Git - openldap/blob - doc/drafts/draft-zeilenga-ldap-user-schema-xx.txt

   1
   2
   3
   4
   5
   6
   7 INTERNET-DRAFT                           Editor:  Kurt D. Zeilenga
   8 Intended Category: Standard Track                 OpenLDAP Foundation
   9 Expires: 22 April 2002                            22 October 2001
  10 Obsoletes: RFC 1274
  11 Updates: RFC 2798
  12
  13
  14
  15                    LDAPv3: A Collection of User Schema
  16                  <draft-zeilenga-ldap-user-schema-03.txt>
  17
  18
  19 Status of this Memo
  20
  21   This document is an Internet-Draft and is in full conformance with all
  22   provisions of Section 10 of RFC2026.
  23
  24   This document is intended to be, after appropriate review and
  25   revision, submitted to the RFC Editor as a Standard Track document.
  26   Distribution of this memo is unlimited.  Technical discussion of this
  27   document will take place on the IETF Directory Interest mailing list
  28   <directory@apps.ietf.org>.  Please send editorial comments directly to
  29   the author <Kurt@OpenLDAP.org>.
  30
  31   Internet-Drafts are working documents of the Internet Engineering Task
  32   Force (IETF), its areas, and its working groups.  Note that other
  33   groups may also distribute working documents as Internet-Drafts.
  34   Internet-Drafts are draft documents valid for a maximum of six months
  35   and may be updated, replaced, or obsoleted by other documents at any
  36   time.  It is inappropriate to use Internet-Drafts as reference
  37   material or to cite them other than as ``work in progress.''
  38
  39   The list of current Internet-Drafts can be accessed at
  40   <http://www.ietf.org/ietf/1id-abstracts.txt>. The list of
  41   Internet-Draft Shadow Directories can be accessed at
  42   <http://www.ietf.org/shadow.html>.
  43
  44   Copyright 2001, The Internet Society.  All Rights Reserved.
  45
  46   Please see the Copyright section near the end of this document for
  47   more information.
  48
  49
  50 Abstract
  51
  52   This document provides a collection of user schema elements for use
  53   with LDAP collected from numerous sources including RFC 1274, X.501,
  54   and X.520.
  55
  56
  57
  58 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 1]
  59 \f
  60 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
  61
  62
  63 Conventions
  64
  65   Schema definitions are provided using LDAPv3 description formats
  66   [RFC2252].  Definitions provided here are formatted (line wrapped) for
  67   readability.
  68
  69   The key words "SHALL", "SHALL NOT", "MUST", "MUST NOT", "SHOULD",
  70   "SHOULD NOT", "MAY" and "MAY NOT" used in this document are to be
  71   interpreted as described in [RFC2119].
  72
  73
  74 Table of Contents (to be expanded by editor)
  75
  76   Status of this Memo                                  1
  77   Abstract
  78   Conventions                                          2
  79   Table of Contents
  80   1.   Background and Intended Use                     3
  81   2.   Matching Rules
  82   2.1.   booleanMatch                                  4
  83   2.2.   caseExactMatch
  84   2.3.   caseExactOrderingMatch
  85   2.4.   caseExactSubstringsMatch
  86   2.5.   caseIgnoreListSubstringsMatch
  87   2.6.   directoryStringFirstComponentMatch            5
  88   2.7.   integerOrderingMatch
  89   2.7.   keywordMatch
  90   2.9.   numericStringOrderingMatch                    6
  91   2.10.  octetStringOrderingMatch
  92   2.11.  storedPrefixMatch
  93   2.12.  wordMatch                                             7
  94   3.   Attribute Types
  95   3.1.   associatedDomain
  96   3.2.   associatedName
  97   3.3.   buildingName
  98   3.3.   co                                            8
  99   3.4.   destinationIndicator
 100   3.5.   documentAuthor
 101   3.6.   documentIdentifier                            9
 102   3.7.   documentLocation
 103   3.8.   documentPublisher
 104   3.9.   documentTitle
 105   3.10.  documentVersion
 106   3.11.  drink                                        10
 107   3.12.  houseIdentifier
 108   3.13.  homePhone
 109   3.14.  homePostalAddress
 110   3.15.  host                                         11
 111
 112
 113
 114 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 2]
 115 \f
 116 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 117
 118
 119   3.16.  info
 120   3.17.  mail
 121   3.18.  manager                                      12
 122   3.19.  mobile
 123   3.20.  organizationalStatus
 124   3.21.  otherMailbox
 125   3.22.  pager                                        13
 126   3.23.  personalTitle
 127   3.24.  roomNumber
 128   3.25.  secretary
 129   3.26.  uid                                          14
 130   3.27.  uniqueIdentifier
 131   3.28.  userClass
 132   4.   Object Classes                                 15
 133   4.1.   account
 134   4.2.   document
 135   4.3.   documentSeries
 136   4.4.   domainRelatedObject                          16
 137   4.5.   friendlyCountry
 138   4.6.   rFC822LocalPart
 139   4.7.   room                                         17
 140   4.8.   simpleSecurityObject
 141   5.   Security Considerations
 142   6.   Acknowledgements
 143   7.   Author's Address
 144   References                                          18
 145   Full Copyright                                      19
 146
 147
 148 1. Background and Intended Use
 149
 150   This document provides descriptions [RFC2252] of user schema for use
 151   with LDAP [LDAPTS] collected from numerous sources.
 152
 153   This document includes a summary of select schema introduced for the
 154   COSINE and Internet X.500 pilot projects [RFC1274].  This document
 155   obsoletes RFC 1274.
 156
 157   This document contains a summary of X.500 user schema [X.520] not
 158   included in LDAPv3 [RFC2252][RFC2256].  Some of these items were
 159   described in the inetOrgPerson [RFC2798] schema.  This document
 160   supercedes these descriptions, replacing sections 9.1.3 and 9.3.3 of
 161   RFC 2798.
 162
 163
 164 2. Matching Rules
 165
 166   This section introduces LDAP matching rules based upon descriptions of
 167
 168
 169
 170 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 3]
 171 \f
 172 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 173
 174
 175   their X.500 counterparts.
 176
 177
 178 2.1. booleanMatch
 179
 180   BooleanMatch compares for equality a asserted Boolean value with an
 181   attribute value of BOOLEAN syntax.  The rule returns TRUE if and only
 182   if the values are the same, i.e. both are TRUE or both are FALSE.
 183   (Source: X.520)
 184
 185       ( 2.5.13.13 NAME 'booleanMatch'
 186         SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 )
 187
 188
 189 2.2. caseExactMatch
 190
 191   CaseExactMatch compares for equality the asserted value with an
 192   attribute value of DirectoryString syntax.  The rule is identical to
 193   the caseIgnoreMatch [RFC2252] rule except that case is not ignored.
 194   (Source: X.520)
 195
 196       ( 2.5.13.5 NAME 'caseExactMatch'
 197         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )
 198
 199
 200 2.3. caseExactOrderingMatch
 201
 202   CaseExactOrderingMatch compares the collation order of the asserted
 203   string with an attribute value of DirectoryString syntax.  The rule is
 204   identical to the caseIgnoreOrderingMatch [RFC2252] rule except that
 205   letters are not folded.  (Source: X.520)
 206
 207       ( 2.5.13.6 NAME 'caseExactOrderingMatch'
 208         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )
 209
 210
 211 2.3. caseExactSubstringsMatch
 212
 213   CaseExactSubstringsMatch determines whether the asserted value are
 214   substrings of an attribute value of DirectoryString syntax.  The rule
 215   is identical to the caseIgnoreSubstringsMatch [RFC2252] rule except
 216   that case is not ignored.  (Source: X.520)
 217
 218       ( 2.5.13.7 NAME 'caseExactSubstringsMatch'
 219         SYNTAX 1.3.6.1.4.1.1466.115.121.1.58 )
 220
 221
 222 2.4. caseIgnoreListSubstringsMatch
 223
 224
 225
 226 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 4]
 227 \f
 228 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 229
 230
 231   CaseIgnoreListSubstringMatch compares the asserted substring with an
 232   attribute value which is a sequence of DirectoryStrings, but where the
 233   case (upper or lower) is not significant for comparison purposes.  The
 234   asserted value matches a stored value if and only if the asserted
 235   value matches the string formed by concatenating the strings of the
 236   stored value. This matching is done according to the
 237   caseIgnoreSubstringsMatch [RFC2252] rule; however, none of the
 238   initial, any, or final values of the asserted value are considered to
 239   match a substring of the concatenated string which spans more than one
 240   of the strings of the stored value.  (Source:  X.520)
 241
 242       ( 2.5.13.12 NAME 'caseIgnoreListSubstringsMatch'
 243         SYNTAX 1.3.6.1.4.1.1466.115.121.1.58 )
 244
 245
 246 2.5. directoryStringFirstComponentMatch
 247
 248   DirectoryStringFirstComponentMatch compares for equality the asserted
 249   DirectoryString value with an attribute value of type SEQUENCE whose
 250   first component is mandatory and of type DirectoryString.  The rule
 251   returns TRUE if and only if the attribute value has a first component
 252   whose value matches the asserted DirectoryString using the rules of
 253   caseIgnoreMatch [RFC2252].  A value of the assertion syntax is derived
 254   from a value of the attribute syntax by using the value of the first
 255   component of the SEQUENCE.  (Source: X.520)
 256
 257       ( 2.5.13.31 NAME 'directoryStringFirstComponentMatch'
 258         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )
 259
 260
 261 2.6. integerOrderingMatch
 262
 263   The integerOrderingMatch rule compares the ordering of the asserted
 264   integer with an attribute value of Integer syntax.  The rule returns
 265   True if the attribute value is less than the asserted value. (Source:
 266   X.520)
 267
 268       ( 2.5.13.15 NAME 'integerOrderingMatch'
 269         SYNTAX 1.3.6.1.4.1.1466.115.121.1.27 )
 270
 271
 272 2.7. keywordMatch
 273
 274   The keywordMatch rule compares the asserted string with keywords in an
 275   attribute value of DirectoryString syntax.  The rule returns TRUE if
 276   and only if the asserted value matches any keyword in the attribute
 277   value.  The identification of keywords in an attribute value and of
 278   the exactness of match are both implementation specific.  (Source:
 279
 280
 281
 282 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 5]
 283 \f
 284 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 285
 286
 287   X.520)
 288
 289       ( 2.5.13.32 NAME 'keywordMatch'
 290         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )
 291
 292
 293 2.8. numericStringOrderingMatch
 294
 295   NumericStringOrderingMatch compares the collation order of the
 296   asserted string with an attribute value of NumericString syntax.  The
 297   rule is identical to the caseIgnoreOrderingMatch [RFC2252] rule except
 298   that all space characters are skipped during comparison (case is
 299   irrelevant as characters are numeric).  (Source: X.520)
 300
 301       ( 2.5.13.9 NAME 'NumericStringOrderingMatch'
 302         SYNTAX 1.3.6.1.4.1.1466.115.121.1.36 )
 303
 304
 305 2.9. octetStringOrderingMatch
 306
 307   OctetStringOrderingMatch compares the collation order of the asserted
 308   octet string with an attribute value of OCTET STRING syntax.  The rule
 309   compares octet strings from first octet to last octet, and from the
 310   most significant bit to the least significant bit within the octet.
 311   The first occurrence of a different bit determines the ordering of the
 312   strings. A zero bit precedes a one bit. If the strings are identical
 313   but contain different numbers of octets, the shorter string precedes
 314   the longer string.  (Source: X.520)
 315
 316       ( 2.5.13.18 NAME 'octetStringOrderingMatch'
 317         SYNTAX 1.3.6.1.4.1.1466.115.121.1.40 )
 318
 319
 320 2.10. storedPrefixMatch
 321
 322   StoredPrefixMatch determines whether an attribute value, whose syntax
 323   is DirectoryString, is a prefix (i.e. initial substring) of the
 324   asserted value, without regard to the case (upper or lower) of the
 325   strings.  The rule returns TRUE if and only if the attribute value is
 326   an initial substring of the asserted value with corresponding
 327   characters identical except possibly with regard to case.  (Source:
 328   X.520)
 329
 330       ( 2.5.13.41 NAME 'storedPrefixMatch'
 331         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )
 332
 333   Note: This rule can be used, for example, to compare values in the
 334         Directory which are telephone area codes with a purported value
 335
 336
 337
 338 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 6]
 339 \f
 340 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 341
 342
 343         which is a telephone number.
 344
 345
 346 2.11. wordMatch
 347
 348   The wordMatch rule compares the asserted string with words in an
 349   attribute value of DirectoryString syntax.  The rule returns TRUE if
 350   and only if the asserted word matches any word in the attribute value.
 351   Individual word matching is as for the caseIgnoreMatch [RFC2252]
 352   matching rule. The precise definition of a "word" is implementation
 353   specific.  (Source: X.520)
 354
 355       ( 2.5.13.32 NAME 'wordMatch'
 356         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )
 357
 358
 359 3. Attribute Types
 360
 361   This section details attribute types for use in LDAP based upon their
 362   X.500 descriptions.
 363
 364
 365 3.1. associatedDomain
 366
 367   The associatedDomain attribute type specifies a DNS domain [RFC1034]
 368   which is associated with an object. For example, the entry in the DIT
 369   with a distinguished name "DC=example,DC=com" might have an associated
 370   domain of "example.com".  (Source: RFC 1274)
 371
 372       ( 0.9.2342.19200300.100.1.37 NAME 'associatedDomain'
 373         EQUALITY caseIgnoreIA5Match
 374         SUBSTR caseIgnoreIA5SubstringsMatch
 375         SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )
 376
 377
 378 3.2. associatedName
 379
 380   The associatedName attribute type specifies an entry in the
 381   organizational DIT associated with a DNS domain [RFC1034].  (Source:
 382   RFC 1274)
 383
 384       ( 0.9.2342.19200300.100.1.38 NAME 'associatedName'
 385         EQUALITY distinguishedNameMatch
 386         SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
 387
 388
 389 3.3.  buildingName
 390
 391
 392
 393
 394 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 7]
 395 \f
 396 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 397
 398
 399   The buildingName attribute type specifies the name of the building
 400   where an organization or organizational unit is based.  (Source: RFC
 401   1274)
 402
 403       ( 0.9.2342.19200300.100.1.48 NAME 'buildingName'
 404         EQUALITY caseIgnoreMatch
 405         SUBSTR caseIgnoreSubstringsMatch
 406         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 407
 408
 409 3.3. co
 410
 411   The co (Friendly Country Name) attribute type specifies names of
 412   countries in human readable format.  The standard attribute country
 413   name must be one of the two-letter codes defined in [ISO 3166].
 414   (Source: RFC 1274)
 415
 416       ( 0.9.2342.19200300.100.1.43
 417         NAME ( 'co' 'friendlyCountryName' )
 418         EQUALITY caseIgnoreMatch
 419         SUBSTR caseIgnoreSubstringsMatch
 420         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )
 421
 422
 423 3.4. destinationIndicator
 424
 425   The destinationIndicator attribute type specifies (according to CCITT
 426   Recommendation F.1 and CCITT Recommendation F.31) the country and city
 427   associated with the object (the addressee) needed to provide the
 428   Public Telegram Service.  An attribute value for Destination Indicator
 429   is a printable string containing only alphabetical characters.
 430   (Source: X.520)
 431
 432       ( 2.5.4.27 NAME 'destinationIndicator'
 433         EQUALITY caseIgnoreMatch
 434         SUBSTR caseIgnoreSubstringsMatch
 435         SYNTAX 1.3.6.1.4.1.1466.115.121.1.44{128} )
 436
 437
 438 3.5. documentAuthor
 439
 440   The documentAuthor attribute type specifies the distinguished name of
 441   the author of a document.  (Source: RFC 1274)
 442
 443       ( 0.9.2342.19200300.100.1.14 NAME 'documentAuthor'
 444         EQUALITY distinguishedNameMatch
 445         SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
 446
 447
 448
 449
 450 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 8]
 451 \f
 452 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 453
 454
 455 3.6. documentIdentifier
 456
 457   The documentIdentifier attribute type specifies a unique identifier
 458   for a document.  (Source: RFC 1274)
 459
 460       ( 0.9.2342.19200300.100.1.11 NAME 'documentIdentifier'
 461         EQUALITY caseIgnoreMatch
 462         SUBSTR caseIgnoreSubstringsMatch
 463         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 464
 465
 466 3.7. documentLocation
 467
 468   The documentLocation attribute type specifies the location of the
 469   document original.  (Source: RFC 1274)
 470
 471       ( 0.9.2342.19200300.100.1.15 NAME 'documentLocation'
 472         EQUALITY caseIgnoreMatch
 473         SUBSTR caseIgnoreSubstringsMatch
 474         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 475
 476
 477 3.8. documentPublisher
 478
 479   The documentPublisher attribute is the person and/or organization that
 480   published a document.  (Source: RFC 1274)
 481
 482       ( 0.9.2342.19200300.100.1.56 NAME 'documentPublisher'
 483         EQUALITY caseIgnoreMatch
 484         SUBSTR caseIgnoreSubstringsMatch
 485         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )
 486
 487
 488 3.9. documentTitle
 489
 490   The documentTitle attribute type specifies the title of a document.
 491   (Source: RFC 1274)
 492
 493       ( 0.9.2342.19200300.100.1.12 NAME 'documentTitle'
 494         EQUALITY caseIgnoreMatch
 495         SUBSTR caseIgnoreSubstringsMatch
 496         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 497
 498
 499 3.10. documentVersion
 500
 501   The documentVersion attribute type specifies the version number of a
 502   document. (Source: RFC 1274)
 503
 504
 505
 506 Zeilenga           draft-zeilenga-ldap-user-schema-03           [Page 9]
 507 \f
 508 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 509
 510
 511       ( 0.9.2342.19200300.100.1.13 NAME 'documentVersion'
 512         EQUALITY caseIgnoreMatch
 513         SUBSTR caseIgnoreSubstringsMatch
 514         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 515
 516
 517 3.11. drink
 518
 519   The drink (Favourite Drink) attribute type specifies the favorite
 520   drink of an object (or person).  (Source: RFC 1274)
 521
 522       ( 0.9.2342.19200300.100.1.5 NAME ( 'drink' 'favouriteDrink' )
 523         EQUALITY caseIgnoreMatch
 524         SUBSTR caseIgnoreSubstringsMatch
 525         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 526
 527
 528 3.12. houseIdentifier
 529
 530   The houseIdentifier attribute type specifies a linguistic construct
 531   used to identify a particular building, for example a house number or
 532   house name relative to a street, avenue, town or city, etc.  An
 533   attribute value for houseIdentifier is a string, e.g. "14".  (Source:
 534   X.520)
 535
 536       ( 2.5.4.51 NAME 'houseIdentifier'
 537         EQUALITY caseIgnoreMatch
 538         SUBSTR caseIgnoreSubstringsMatch
 539         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{32768} )
 540
 541
 542 3.13. homePhone
 543
 544   The homePhone (Home Telephone Number) attribute type specifies a home
 545   telephone number (e.g., "+44 71 123 4567") associated with a person.
 546   (Source: RFC 1274)
 547
 548       ( 0.9.2342.19200300.100.1.20
 549         NAME ( 'homePhone' 'homeTelephoneNumber' )
 550         EQUALITY telephoneNumberMatch
 551         SUBSTR telephoneNumberSubstringsMatch
 552         SYNTAX 1.3.6.1.4.1.1466.115.121.1.50 )
 553
 554
 555 3.14. homePostalAddress
 556
 557   The homePostalAddress attribute type specifies a home postal address
 558   for an object.  This should be limited to up to 6 lines of 30
 559
 560
 561
 562 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 10]
 563 \f
 564 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 565
 566
 567   characters each.  (Source: RFC 1274)
 568
 569       ( 0.9.2342.19200300.100.1.39
 570         NAME 'homePostalAddress'
 571         EQUALITY caseIgnoreListMatch
 572         SUBSTR caseIgnoreListSubstringsMatch
 573         SYNTAX 1.3.6.1.4.1.1466.115.121.1.41 )
 574
 575
 576 3.15. host
 577
 578   The host attribute type specifies a host computer.  (Source: RFC 1274)
 579
 580       ( 0.9.2342.19200300.100.1.9
 581         NAME 'host'
 582         EQUALITY caseIgnoreMatch
 583         SUBSTR caseIgnoreSubstringsMatch
 584         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 585
 586
 587 3.16. info
 588
 589   The info (Information) attribute type specifies any general
 590   information pertinent to an object.  It is RECOMMENDED that specific
 591   usage of this attribute type is avoided, and that specific
 592   requirements are met by other (possibly additional) attribute types.
 593   It is noted the description attribute [RFC2256] for specifying
 594   descriptive information pertinent to an object.  (Source:  RFC 1274)
 595
 596       ( 0.9.2342.19200300.100.1.4
 597         NAME 'info'
 598         EQUALITY caseIgnoreMatch
 599         SUBSTR caseIgnoreSubstringsMatch
 600         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{2048} )
 601
 602
 603 3.17. mail
 604
 605   The mail (rfc822mailbox) attribute type holds an the electronic mail
 606   address in RFC822 form (e.g.: user@example.com).  Note that this
 607   attribute SHOULD NOT be used to hold non-Internet addresses.  (Source:
 608   RFC 1274)
 609
 610
 611       ( 0.9.2342.19200300.100.1.3
 612         NAME ( 'mail' 'rfc822Mailbox' )
 613         EQUALITY caseIgnoreIA5Match
 614         SUBSTR caseIgnoreIA5SubstringsMatch
 615
 616
 617
 618 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 11]
 619 \f
 620 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 621
 622
 623         SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} )
 624
 625
 626 3.18. manager
 627
 628   The Manager attribute type specifies the manager of an object
 629   represented by an entry.  (Source: RFC 1274)
 630
 631       ( 0.9.2342.19200300.100.1.10
 632         NAME 'manager'
 633         EQUALITY distinguishedNameMatch
 634         SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
 635
 636
 637 3.19. mobile
 638
 639   The mobile (Mobile Telephone Number) attribute type specifies a mobile
 640   telephone number (e.g., "+44 71 123 4567") associated with a person.
 641   (Source: RFC 1274)
 642
 643       ( 0.9.2342.19200300.100.1.41
 644         NAME ( 'mobile' 'mobileTelephoneNumber' )
 645         EQUALITY telephoneNumberMatch
 646         SUBSTR telephoneNumberSubstringsMatch
 647         SYNTAX 1.3.6.1.4.1.1466.115.121.1.50 )
 648
 649
 650 3.20. organizationalStatus
 651
 652   The organizationalStatus attribute type specifies a category by which
 653   a person is often referred to in an organization.  Examples of usage
 654   in academia might include undergraduate student, researcher, lecturer,
 655   etc.
 656
 657   A Directory administrator should probably consider carefully the
 658   distinctions between this and the title and userClass attributes.
 659   (Source: RFC 1274)
 660
 661       ( 0.9.2342.19200300.100.1.45
 662         NAME 'organizationalStatus'
 663         EQUALITY caseIgnoreMatch
 664         SUBSTR caseIgnoreSubstringsMatch
 665         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 666
 667
 668 3.21. otherMailbox
 669
 670   The otherMailbox attribute type specifies values for electronic
 671
 672
 673
 674 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 12]
 675 \f
 676 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 677
 678
 679   mailbox types other than X.400 and RFC822.  (Source: RFC 1274)
 680
 681       ( 0.9.2342.19200300.100.1.22
 682         NAME 'otherMailbox'
 683         SYNTAX 1.3.6.1.4.1.1466.115.121.1.39 )
 684
 685
 686 3.22. pager
 687
 688   The pager (Pager Telephone Number) attribute type specifies a pager
 689   telephone number (e.g., "+44 71 123 4567") for an object.  (Source:
 690   RFC 1274)
 691
 692       ( 0.9.2342.19200300.100.1.42
 693         NAME ( 'pager' 'pagerTelephoneNumber' )
 694         EQUALITY telephoneNumberMatch
 695         SUBSTR telephoneNumberSubstringsMatch
 696         SYNTAX 1.3.6.1.4.1.1466.115.121.1.50 )
 697
 698
 699 3.23. personalTitle
 700
 701   The personalTitle attribute type specifies a personal title for a
 702   person.  Examples of personal titles are "Frau", "Dr", "Herr", and
 703   "Prof".  (Source: RFC 1274)
 704
 705       ( 0.9.2342.19200300.100.1.40
 706         NAME 'personalTitle'
 707         EQUALITY caseIgnoreMatch
 708         SUBSTR caseIgnoreSubstringsMatch
 709         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 710
 711
 712 3.24. roomNumber
 713
 714   The roomNumber attribute type specifies the room number of an object.
 715   Note that the cn (commonName) attribute should be used for naming room
 716   objects.  (Source: RFC 1274)
 717
 718       ( 0.9.2342.19200300.100.1.6
 719         NAME 'roomNumber'
 720         EQUALITY caseIgnoreMatch
 721         SUBSTR caseIgnoreSubstringsMatch
 722         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 723
 724
 725 3.25. secretary
 726
 727
 728
 729
 730 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 13]
 731 \f
 732 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 733
 734
 735   The secretary attribute type specifies the secretary of a person.  The
 736   attribute value for Secretary is a distinguished name.  (Source: RFC
 737   1274)
 738
 739       ( 0.9.2342.19200300.100.1.21
 740         NAME 'secretary'
 741         EQUALITY distinguishedNameMatch
 742         SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )
 743
 744
 745 3.26. uid
 746
 747   The uid (userid) attribute type specifies a computer system login
 748   name.  (Source: RFC 1274)
 749
 750       ( 0.9.2342.19200300.100.1.1
 751         NAME ( 'uid' 'userid' )
 752         EQUALITY caseIgnoreMatch
 753         SUBSTR caseIgnoreSubstringsMatch
 754         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 755
 756
 757 3.27. uniqueIdentifier
 758
 759   The Unique Identifier attribute type specifies a "unique identifier"
 760   for an object represented in the Directory.  The domain within which
 761   the identifier is unique, and the exact semantics of the identifier,
 762   are for local definition.  For a person, this might be an institution-
 763   wide payroll number.  For an organizational unit, it might be a
 764   department code.  An attribute value for uniqueIdentifier is a
 765   directoryString.  (Source: RFC 1274)
 766
 767       ( 2.5.4.45 NAME 'uniqueIdentifier'
 768         EQUALITY caseIgnoreMatch
 769         SUBSTR caseIgnoreSubstringsMatch
 770         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 771
 772   Note: X.520 describes an attribute also called 'uniqueIdentifier'
 773         (2.5.4.45) which is called 'x500UniqueIdentifier' in LDAP
 774         [RFC2256].  The attribute detailed here ought not be confused
 775         with x500UniqueIdentifier.
 776
 777
 778 3.28. userClass
 779
 780   The userClass attribute type specifies a category of computer user.
 781   The semantics placed on this attribute are for local interpretation.
 782   Examples of current usage od this attribute in academia are
 783
 784
 785
 786 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 14]
 787 \f
 788 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 789
 790
 791   undergraduate student, researcher, lecturer, etc.  Note that the
 792   organizationalStatus attribute may now often be preferred as it makes
 793   no distinction between computer users and others.  (Source: RFC 1274)
 794
 795       ( 0.9.2342.19200300.100.1.8 NAME 'userClass'
 796         EQUALITY caseIgnoreMatch
 797         SUBSTR caseIgnoreSubstringsMatch
 798         SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{256} )
 799
 800
 801 4. Object Classes
 802
 803   This section details attribute types for use in LDAP based upon their
 804   X.500 descriptions.
 805
 806 4.1. account
 807
 808   The account object class is used to define entries representing
 809   computer accounts.  The uid (userid) attribute should be used for
 810   naming entries of this object class.  (Source: RFC 1274)
 811
 812       ( 0.9.2342.19200300.100.4.5
 813         NAME 'account'
 814         SUP top STRUCTURAL
 815         MUST uid
 816         MAY ( description $ seeAlso $ l $ o $ ou $ host ) )
 817
 818
 819 4.2. document
 820
 821   The document object class is used to define entries which represent
 822   documents.  (Source: RFC 1274)
 823
 824       ( 0.9.2342.19200300.100.4.6
 825         NAME 'document'
 826         SUP top STRUCTURAL
 827         MUST documentIdentifier
 828         MAY ( cn $ description $ seeAlso $ l $ o $ ou $
 829               documentTitle $ documentVersion $ documentAuthor $
 830               documentLocation $ documentPublisher ) )
 831
 832
 833 4.3. documentSeries
 834
 835   The documentSeries object class is used to define an entry which
 836   represents a series of documents (e.g., The Request For Comments
 837   memos).  (Source: RFC 1274)
 838
 839
 840
 841
 842 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 15]
 843 \f
 844 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 845
 846
 847       ( 0.9.2342.19200300.100.4.9
 848         NAME 'documentSeries'
 849         SUP top STRUCTURAL
 850         MUST cn
 851         MAY ( description $ l $ o $ ou $ seeAlso $
 852               telephonenumber ) )
 853
 854
 855 4.4.  domainRelatedObject
 856
 857   The domainRelatedObject object class is used to define entries which
 858   represent DNS domains which are "equivalent" to an X.500 domain: e.g.,
 859   an organization or organizational unit.  (Source: RFC 1274)
 860
 861       ( 0.9.2342.19200300.100.4.17
 862         NAME 'domainRelatedObject'
 863         SUP top AUXILIARY
 864         MUST associatedDomain )
 865
 866
 867 4.5.  friendlyCountry
 868
 869   The friendlyCountry object class is used to define country entries in
 870   the DIT.  The object class is used to allow friendlier naming of
 871   countries than that allowed by the object class country.  The naming
 872   attribute of object class country, c (countryName), has to be a 2
 873   letter string defined in [ISO3166].  (Source: RFC 1274)
 874
 875       ( 0.9.2342.19200300.100.4.18
 876         NAME 'friendlyCountry'
 877         SUP country STRUCTURAL
 878         MUST co )
 879
 880
 881 4.6.  rFC822LocalPart
 882
 883   The rFC822LocalPart object class is used to define entries which
 884   represent the local part of RFC822 mail addresses.  This treats this
 885   part of an RFC822 address as a domain [RFC2247].  (Source: RFC 1274)
 886
 887       ( 0.9.2342.19200300.100.4.14
 888         NAME 'rFC822localPart'
 889         SUP domain STRUCTURAL
 890         MAY ( cn $ description $ destinationIndicator $
 891               facsimileTelephoneNumber $ internationaliSDNNumber $
 892               physicalDeliveryOfficeName $ postalAddress $
 893               postalCode $ postOfficeBox $ preferredDeliveryMethod $
 894               registeredAddress $ seeAlso $ sn $ street $
 895
 896
 897
 898 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 16]
 899 \f
 900 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 901
 902
 903               telephoneNumber $ teletexTerminalIdentifier $
 904               telexNumber $ x121Address ) )
 905
 906
 907 4.7.  room
 908
 909   The room object class is used to define entries representing rooms.
 910   The cn (commonName) attribute should be used for naming entries of
 911   this object class.  (Source: RFC 1274)
 912
 913       ( 0.9.2342.19200300.100.4.7 NAME 'room'
 914         SUP top STRUCTURAL
 915         MUST cn
 916         MAY ( roomNumber $ description $
 917               seeAlso $ telephoneNumber ) )
 918
 919
 920 4.8.  simpleSecurityObject
 921
 922   The simpleSecurityObject object class is used to allow an entry to
 923   have a userPassword attribute when an entry's principal object classes
 924   do not allow userPassword as an attribute type.  (Source: RFC 1274)
 925
 926       ( 0.9.2342.19200300.100.4.19 NAME 'simpleSecurityObject'
 927         SUP top AUXILIARY
 928         MUST userPassword )
 929
 930   Note: Security considerations related to the use of simple
 931         authentication mechanisms in LDAP are discussed in RFC 2829
 932         [RFC2829].
 933
 934
 935 5. Security Considerations
 936
 937   General LDAP security considerations [LDAPTS] is applicable to the use
 938   of this schema.  Additional considerations are noted above where
 939   appropriate.
 940
 941
 942 6. Acknowledgements
 943
 944   This document borrows from a number of IETF documents including RFC
 945   1274 by Paul Barker and Steve Kille.  This document also borrows from
 946   a number of ITU documents including X.520.
 947
 948
 949 7. Author's Address
 950
 951
 952
 953
 954 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 17]
 955 \f
 956 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
 957
 958
 959   Kurt D. Zeilenga
 960   OpenLDAP Foundation
 961   <Kurt@OpenLDAP.org>
 962
 963
 964 References
 965
 966   [ISO3166] International Standards Organization, "Codes for the
 967             representation of names of countries", ISO 3166.
 968
 969   [RFC822]  D. Crocker, "Standard for the format of ARPA Internet text
 970             messages", August 1982.
 971
 972   [RFC1034] P.V. Mockapetris, "Domain names - concepts and facilities",
 973             November 1987.
 974
 975   [RFC1274] P. Barker, S. Kille, "The COSINE and Internet X.500 Schema",
 976             November 1991.
 977
 978   [RFC2219] S. Bradner, "Key words for use in RFCs to Indicate
 979             Requirement Levels", RFC 2119 (also BCP 14), March 1997.
 980
 981   [RFC2247] S. Kille, M. Wahl, A. Grimstad, R. Huber, S. Sataluri,
 982             "Using Domains in LDAP/X.500 Distinguished Names", January
 983             1998.
 984
 985   [RFC2252] M. Wahl, A. Coulbeck, T. Howes, S. Kille, "Lightweight
 986             Directory Access Protocol (v3):  Attribute Syntax
 987             Definitions", RFC 2252, December 1997.
 988
 989   [RFC2256] M. Wahl, "A Summary of the X.500(96) User Schema for use
 990             with LDAPv3", RFC 2256, December 1997.
 991
 992   [RFC2798] M. Smith, "The LDAP inetOrgPerson Object Class", RFC 2798,
 993             April 2000.
 994
 995   [RFC2829] M. Wahl, H. Alvestrand, J. Hodges, R. Morgan,
 996             "Authentication Methods for LDAP", RFC 2829, May 2000.
 997
 998   [LDAPTS]  J. Hodges, R. Morgan, "Lightweight Directory Access Protocol
 999             (v3): Technical Specification", draft-ietf-ldapbis-
1000             ldapv3-ts-00.txt.
1001
1002   [X.520]   "The Directory: Selected Attribute Types", ITU
1003             Recommendation X.520, 1997.
1004
1005
1006
1007
1008
1009
1010 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 18]
1011 \f
1012 INTERNET-DRAFT     LDAPv3: A Collection of User Schema   20 October 2001
1013
1014
1015 Full Copyright
1016
1017   Copyright 2001, The Internet Society.  All Rights Reserved.
1018
1019   This document and translations of it may be copied and furnished to
1020   others, and derivative works that comment on or otherwise explain it
1021   or assist in its implementation may be prepared, copied, published and
1022   distributed, in whole or in part, without restriction of any kind,
1023   provided that the above copyright notice and this paragraph are
1024   included on all such copies and derivative works.  However, this
1025   document itself may not be modified in any way, such as by removing
1026   the copyright notice or references to the Internet Society or other
1027   Internet organizations, except as needed for the  purpose of
1028   developing Internet standards in which case the procedures for
1029   copyrights defined in the Internet Standards process must be followed,
1030   or as required to translate it into languages other than English.
1031
1032   The limited permissions granted above are perpetual and will not be
1033   revoked by the Internet Society or its successors or assigns.
1034
1035   This document and the information contained herein is provided on an
1036   "AS IS" basis and THE AUTHORS, THE INTERNET SOCIETY, AND THE INTERNET
1037   ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED,
1038   INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
1039   INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
1040   WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066 Zeilenga           draft-zeilenga-ldap-user-schema-03          [Page 19]
1067 \f