home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_n_r / draft-provan-dhcp-options-dir-serv-02.txt < prev    next >
Text File  |  1997-10-23  |  7KB  |  178 lines
  1.  
  2.                                                               don provan
  3. INTERNET DRAFT                                              Novell, Inc.
  4.                                                          25 October 1997
  5.                                                    Expires 25 April 1998
  6.  
  7.                 DHCP Options for Novell Directory Services
  8.                   draft-provan-dhcp-options-dir-serv-02.txt
  9.  
  10. Status of this Memo
  11.  
  12.     This document is an Internet-Draft.  Internet Drafts are working
  13.     documents of the Internet Engineering Task Force (IETF), its Areas,
  14.     and its Working Groups.  Note that other groups may also distribute
  15.     working documents as Internet-Drafts.
  16.   
  17.     Internet-Drafts are draft documents valid for a maximum of six
  18.     months, and may be updated, replaced, or obsoleted by other documents
  19.     at any time.  It is not appropriate to use Internet Drafts as
  20.     reference material, or to cite them other than as a ``working draft''
  21.     or ``work in progress.''
  22.   
  23.     To learn the current status of any Internet-Draft, please check the
  24.     ``1id-abstracts.txt'' listing contained in the internet-drafts Shadow
  25.     Directories on ds.internic.net (US East Coast), nic.nordu.net
  26.     (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific
  27.     Rim).
  28.   
  29. Abstract
  30.  
  31.     This document defines three new DHCP options for delivering
  32.     configuration information to clients of the Novell Directory
  33.     Services. The first option carries a list of NDS servers. The second
  34.     option carries the name of the client's NDS tree. The third carries
  35.     the initial NDS context. These three options provide an NDS client
  36.     with enough information to connect to an NDS tree without manual
  37.     configuration of the client.
  38.   
  39. 1. Introduction
  40.  
  41.     Novell Directory Services is a distributed, replicated, hierarchical
  42.     database of objects representing network resources such as nodes,
  43.     services, users, and applications. An NDS client must be able to
  44.     locate an NDS server in order to authenticate itself to the network
  45.     and gain access to the database. In addition, the node's user is
  46.     better served if the NDS client's attention is focused on the area of
  47.     the NDS database likely to be of the most interest to the user.
  48.     This specification describes DHCP options [1] that carry NDS
  49.     information to TCP/IP clients of NDS. The first option, the NDS
  50.     Servers Option, carries a list of NDS servers. The other two options,
  51.     the NDS Tree Name Option and the NDS Context Option, provide the
  52.     client with a default context within the NDS database.
  53.  
  54.     The NDS Tree Name Option and the NDS Context Option carry 16-bit
  55.     Unicode text encoded into an octet stream using UTF-8 [4]. A complete
  56.     DHCP implementation can represent of the entire Unicode character set
  57.  
  58. Provan                 Expires 25 April 1998                    [Page 1]
  59.  
  60. INTERNET-DRAFT         DHCP Options for NDS              25 October 1997
  61.  
  62.     supported by NDS. At the same time, 7-bit ASCII text is unchanged by
  63.     the UTF-8 transformation. In environments where the NDS tree name and
  64.     context are restricted to the range of 7-bit ASCII characters, ASCII-
  65.     only DHCP clients and servers can support these options by using the
  66.     ASCII text as the UTF-8 encoded data.
  67.   
  68.     The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  69.     "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this
  70.     document are to be interpreted as described in RFC 2119. [2]
  71.   
  72. 2. NDS Servers Option
  73.  
  74.     This option specifies one or more NDS servers for the client to
  75.     contact for access to the NDS database. Servers SHOULD be listed in
  76.     order of preference.
  77.   
  78.     The code for this option is 85. The minimum length of this option is
  79.     4 octets, and the length MUST be a multiple of 4.
  80.   
  81.       Code   Len        Address 1               Address 2
  82.      +-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+--
  83.      | 85  |  n  |  a1 |  a2 | a3  |  a4 |  a1 |  a2 |  a3 |  a4 |  ...
  84.      +-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+--
  85.  
  86.  
  87. 3. NDS Tree Name Option
  88.  
  89.     This option specifies the name of the NDS tree the client will be
  90.     contacting. NDS tree names are 16-bit Unicode strings. For
  91.     transmission in the NDS Tree Name Option, an NDS tree name is
  92.     transformed into octets using UTF-8. The string should NOT be zero
  93.     terminated.
  94.   
  95.     The code for this option is 86. The maximum possible length for this
  96.     option is 255 bytes.
  97.   
  98.        Code Len  NDS Tree Name
  99.       +----+----+----+----+----+----+--
  100.       | 86 | n  | c1 | c2 | c3 | c4 |  ...
  101.       +----+----+----+----+----+----+--
  102.  
  103. 4. NDS Context Option
  104.  
  105.     This option specifies the initial NDS context the client should use.
  106.     NDS contexts are 16-bit Unicode strings. For transmission in the NDS
  107.     Context Option, an NDS context is transformed into octets using UTF-
  108.     8. The string should NOT be zero terminated.
  109.   
  110.     A single DHCP option can only contain 255 octets. Since an NDS
  111.     context name can be longer than that, this option can appear more
  112.     than once in the DHCP packet. The contents of all NDS Context options
  113.     in the packet should be concatenated as suggested in the DHCP
  114.     specification [3, page 24] to get the complete NDS context. A single
  115.     encoded character could be split between two NDS Context Options.
  116.  
  117. Provan                 Expires 25 April 1998                    [Page 2]
  118.  
  119. INTERNET-DRAFT         DHCP Options for NDS              25 October 1997
  120.  
  121.     The code for this option is 87. The maximum length for each instance
  122.     of this option is 255, but, as just described, the option may appear
  123.     more than once if the desired NDS context takes up more than 255
  124.     octets. Implementations are discouraged from enforcing any specific
  125.     maximum to the final concatenated NDS context.
  126.   
  127.        Code Len  Initial NDS Context
  128.       +----+----+----+----+----+----+--
  129.       | 87 | n  | c1 | c2 | c3 | c4 |  ...
  130.       +----+----+----+----+----+----+--
  131.  
  132.  
  133. 5. References
  134.  
  135.    [1] Alexander, S., and R. Droms, "DHCP Options and BOOTP Vendor
  136.        Extensions", RFC-2132, March 1997.
  137.  
  138.    [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement      
  139.        Levels", RFC-2119, March 1997.
  140.  
  141.    [3] Droms, R., "Dynamic Host Configuration Protocol", RFC-2131,
  142.        March 1997.
  143.  
  144.    [4] Yergeau, F., "UTF-8, a transformation format of Unicode and
  145.        ISO 10646", RFC-2044, October 1996
  146.  
  147. 6. Security Considerations
  148.  
  149.     DHCP currently provides no authentication or security mechanisms.
  150.     Potential exposures to attack are discussed in section 7 of the DHCP
  151.     protocol specification [3]. In particular, these DHCP options allow
  152.     an unauthorized DHCP server to misdirect an NDS client to a
  153.     nonexistent NDS server or even a spoof NDS server. These threats are
  154.     similar to what NDS faces during normal operations in its native IPX
  155.     environment.
  156.   
  157. 7. Author's Address
  158.  
  159.    Don Provan
  160.    Novell, Inc.
  161.    2180 Fortune Drive
  162.    San Jose, California, 95131
  163.  
  164.    Phone: +1 408 577 8440
  165.  
  166.    EMail: donp@Novell.Com
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176. Provan                 Expires 25 April 1998                    [Page 3]
  177.  
  178.