Ignore machine-check MSRs
[freebsd-src/fkvm-freebsd.git] / contrib / bind9 / doc / draft / draft-ietf-dnsext-dhcid-rr-12.txt
blob07749d954947faa5f7d2caa09e1617732d95ab9c
5 DNSEXT                                                          M. Stapp
6 Internet-Draft                                       Cisco Systems, Inc.
7 Expires: September 1, 2006                                      T. Lemon
8                                                            Nominum, Inc.
9                                                            A. Gustafsson
10                                           Araneus Information Systems Oy
11                                                        February 28, 2006
14            A DNS RR for Encoding DHCP Information (DHCID RR)
15                   <draft-ietf-dnsext-dhcid-rr-12.txt>
17 Status of this Memo
19    By submitting this Internet-Draft, each author represents that any
20    applicable patent or other IPR claims of which he or she is aware
21    have been or will be disclosed, and any of which he or she becomes
22    aware will be disclosed, in accordance with Section 6 of BCP 79.
24    Internet-Drafts are working documents of the Internet Engineering
25    Task Force (IETF), its areas, and its working groups.  Note that
26    other groups may also distribute working documents as Internet-
27    Drafts.
29    Internet-Drafts are draft documents valid for a maximum of six months
30    and may be updated, replaced, or obsoleted by other documents at any
31    time.  It is inappropriate to use Internet-Drafts as reference
32    material or to cite them other than as "work in progress."
34    The list of current Internet-Drafts can be accessed at
35    http://www.ietf.org/ietf/1id-abstracts.txt.
37    The list of Internet-Draft Shadow Directories can be accessed at
38    http://www.ietf.org/shadow.html.
40    This Internet-Draft will expire on September 1, 2006.
42 Copyright Notice
44    Copyright (C) The Internet Society (2006).
46 Abstract
48    It is possible for DHCP clients to attempt to update the same DNS
49    FQDN or attempt to update a DNS FQDN that has been added to the DNS
50    for another purpose as they obtain DHCP leases.  Whether the DHCP
51    server or the clients themselves perform the DNS updates, conflicts
52    can arise.  To resolve such conflicts, "Resolution of DNS Name
56 Stapp, et al.           Expires September 1, 2006               [Page 1]
58 Internet-Draft                The DHCID RR                 February 2006
61    Conflicts" [1] proposes storing client identifiers in the DNS to
62    unambiguously associate domain names with the DHCP clients to which
63    they refer.  This memo defines a distinct RR type for this purpose
64    for use by DHCP clients and servers, the "DHCID" RR.
67 Table of Contents
69    1.  Terminology  . . . . . . . . . . . . . . . . . . . . . . . . .  3
70    2.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
71    3.  The DHCID RR . . . . . . . . . . . . . . . . . . . . . . . . .  3
72      3.1.  DHCID RDATA format . . . . . . . . . . . . . . . . . . . .  3
73      3.2.  DHCID Presentation Format  . . . . . . . . . . . . . . . .  4
74      3.3.  The DHCID RR Identifier Type Codes . . . . . . . . . . . .  4
75      3.4.  The DHCID RR Digest Type Code  . . . . . . . . . . . . . .  4
76      3.5.  Computation of the RDATA . . . . . . . . . . . . . . . . .  5
77        3.5.1.  Using the Client's DUID  . . . . . . . . . . . . . . .  5
78        3.5.2.  Using the Client Identifier Option . . . . . . . . . .  5
79        3.5.3.  Using the Client's htype and chaddr  . . . . . . . . .  6
80      3.6.  Examples . . . . . . . . . . . . . . . . . . . . . . . . .  6
81        3.6.1.  Example 1  . . . . . . . . . . . . . . . . . . . . . .  6
82        3.6.2.  Example 2  . . . . . . . . . . . . . . . . . . . . . .  6
83        3.6.3.  Example 3  . . . . . . . . . . . . . . . . . . . . . .  7
84    4.  Use of the DHCID RR  . . . . . . . . . . . . . . . . . . . . .  7
85    5.  Updater Behavior . . . . . . . . . . . . . . . . . . . . . . .  8
86    6.  Security Considerations  . . . . . . . . . . . . . . . . . . .  8
87    7.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . .  8
88    8.  Acknowledgements . . . . . . . . . . . . . . . . . . . . . . .  9
89    9.  References . . . . . . . . . . . . . . . . . . . . . . . . . .  9
90      9.1.  Normative References . . . . . . . . . . . . . . . . . . .  9
91      9.2.  Informative References . . . . . . . . . . . . . . . . . . 10
92    Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 11
93    Intellectual Property and Copyright Statements . . . . . . . . . . 12
112 Stapp, et al.           Expires September 1, 2006               [Page 2]
114 Internet-Draft                The DHCID RR                 February 2006
117 1.  Terminology
119    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
120    "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
121    document are to be interpreted as described in RFC 2119 [2].
124 2.  Introduction
126    A set of procedures to allow DHCP [6] [10] clients and servers to
127    automatically update the DNS (RFC 1034 [3], RFC 1035 [4]) is proposed
128    in "Resolution of DNS Name Conflicts" [1].
130    Conflicts can arise if multiple DHCP clients wish to use the same DNS
131    name or a DHCP client attempts to use a name added for another
132    purpose.  To resolve such conflicts, "Resolution of DNS Name
133    Conflicts" [1] proposes storing client identifiers in the DNS to
134    unambiguously associate domain names with the DHCP clients using
135    them.  In the interest of clarity, it is preferable for this DHCP
136    information to use a distinct RR type.  This memo defines a distinct
137    RR for this purpose for use by DHCP clients or servers, the "DHCID"
138    RR.
140    In order to obscure potentially sensitive client identifying
141    information, the data stored is the result of a one-way SHA-256 hash
142    computation.  The hash includes information from the DHCP client's
143    message as well as the domain name itself, so that the data stored in
144    the DHCID RR will be dependent on both the client identification used
145    in the DHCP protocol interaction and the domain name.  This means
146    that the DHCID RDATA will vary if a single client is associated over
147    time with more than one name.  This makes it difficult to 'track' a
148    client as it is associated with various domain names.
151 3.  The DHCID RR
153    The DHCID RR is defined with mnemonic DHCID and type code [TBD].  The
154    DHCID RR is only defined in the IN class.  DHCID RRs cause no
155    additional section processing.  The DHCID RR is not a singleton type.
157 3.1.  DHCID RDATA format
159    The RDATA section of a DHCID RR in transmission contains RDLENGTH
160    octets of binary data.  The format of this data and its
161    interpretation by DHCP servers and clients are described below.
163    DNS software should consider the RDATA section to be opaque.  DHCP
164    clients or servers use the DHCID RR to associate a DHCP client's
168 Stapp, et al.           Expires September 1, 2006               [Page 3]
170 Internet-Draft                The DHCID RR                 February 2006
173    identity with a DNS name, so that multiple DHCP clients and servers
174    may deterministically perform dynamic DNS updates to the same zone.
175    From the updater's perspective, the DHCID resource record RDATA
176    consists of a 2-octet identifier type, in network byte order,
177    followed by a 1-octet digest type, followed by one or more octets
178    representing the actual identifier:
180            < 2 octets >    Identifier type code
181            < 1 octet >     Digest type code
182            < n octets >    Digest (length depends on digest type)
184 3.2.  DHCID Presentation Format
186    In DNS master files, the RDATA is represented as a single block in
187    base 64 encoding identical to that used for representing binary data
188    in RFC 3548 [7].  The data may be divided up into any number of white
189    space separated substrings, down to single base 64 digits, which are
190    concatenated to form the complete RDATA.  These substrings can span
191    lines using the standard parentheses.
193 3.3.  The DHCID RR Identifier Type Codes
195    The DHCID RR Identifier Type Code specifies what data from the DHCP
196    client's request was used as input into the hash function.  The
197    identifier type codes are defined in a registry maintained by IANA,
198    as specified in Section 7.  The initial list of assigned values for
199    the identifier type code is:
201    0x0000 = htype, chaddr from a DHCPv4 client's DHCPREQUEST [6].
202    0x0001 = The data octets (i.e., the Type and Client-Identifier
203       fields) from a DHCPv4 client's Client Identifier option [9].
204    0x0002 = The client's DUID (i.e., the data octets of a DHCPv6
205       client's Client Identifier option [10] or the DUID field from a
206       DHCPv4 client's Client Identifier option [12]).
208    0x0003 - 0xfffe = Available to be assigned by IANA.
210    0xffff = RESERVED
212 3.4.  The DHCID RR Digest Type Code
214    The DHCID RR Digest Type Code is an identifier for the digest
215    algorithm used.  The digest is calculated over an identifier and the
216    canonical FQDN as described in the next section.
218    The digest type codes are defined in a registry maintained by IANA,
219    as specified in Section 7.  The initial list of assigned values for
220    the digest type codes is: value 0 is reserved and value 1 is SHA-256.
224 Stapp, et al.           Expires September 1, 2006               [Page 4]
226 Internet-Draft                The DHCID RR                 February 2006
229    Reserving other types requires IETF standards action.  Defining new
230    values will also require IETF standards action to document how DNS
231    updaters are to deal with multiple digest types.
233 3.5.  Computation of the RDATA
235    The DHCID RDATA is formed by concatenating the 2-octet identifier
236    type code with variable-length data.
238    The RDATA for all type codes other than 0xffff, which is reserved for
239    future expansion, is formed by concatenating the 2-octet identifier
240    type code, the 1-octet digest type code, and the digest value (32
241    octets for SHA-256).
243        < identifier-type > < digest-type > < digest >
245    The input to the digest hash function is defined to be:
247        digest = SHA-256(< identifier > < FQDN >)
249    The FQDN is represented in the buffer in unambiguous canonical form
250    as described in RFC 4034 [8], section 6.1.  The identifier type code
251    and the identifier are related as specified in Section 3.3: the
252    identifier type code describes the source of the identifier.
254    A DHCPv4 updater uses the 0x0002 type code if a Client Identifier
255    option is present in the DHCPv4 messages and it is encoded as
256    specified in [12].  Otherwise, the updater uses 0x0001 if a Client
257    Identifier option is present and 0x0000 if not.
259    A DHCPv6 updater always uses the 0x0002 type code.
261 3.5.1.  Using the Client's DUID
263    When the updater is using the Client's DUID (either from a DHCPv6
264    Client Identifier option or from a portion of the DHCPv4 Client
265    Identifier option encoded as specified in [12]), the first two octets
266    of the DHCID RR MUST be 0x0002, in network byte order.  The third
267    octet is the digest type code (1 for SHA-256).  The rest of the DHCID
268    RR MUST contain the results of computing the SHA-256 hash across the
269    octets of the DUID followed by the FQDN.
271 3.5.2.  Using the Client Identifier Option
273    When the updater is using the DHCPv4 Client Identifier option sent by
274    the client in its DHCPREQUEST message, the first two octets of the
275    DHCID RR MUST be 0x0001, in network byte order.  The third octet is
276    the digest type code (1 for SHA-256).  The rest of the DHCID RR MUST
280 Stapp, et al.           Expires September 1, 2006               [Page 5]
282 Internet-Draft                The DHCID RR                 February 2006
285    contain the results of computing the SHA-256 hash across the data
286    octets (i.e., the Type and Client-Identifier fields) of the option,
287    followed by the FQDN.
289 3.5.3.  Using the Client's htype and chaddr
291    When the updater is using the client's link-layer address as the
292    identifier, the first two octets of the DHCID RDATA MUST be zero.
293    The third octet is the digest type code (1 for SHA-256).  To generate
294    the rest of the resource record, the updater computes a one-way hash
295    using the SHA-256 algorithm across a buffer containing the client's
296    network hardware type, link-layer address, and the FQDN data.
297    Specifically, the first octet of the buffer contains the network
298    hardware type as it appeared in the DHCP 'htype' field of the
299    client's DHCPREQUEST message.  All of the significant octets of the
300    'chaddr' field in the client's DHCPREQUEST message follow, in the
301    same order in which the octets appear in the DHCPREQUEST message.
302    The number of significant octets in the 'chaddr' field is specified
303    in the 'hlen' field of the DHCPREQUEST message.  The FQDN data, as
304    specified above, follows.
306 3.6.  Examples
308 3.6.1.  Example 1
310    A DHCP server allocating the IPv4 address 10.0.0.1 to a client with
311    Ethernet MAC address 01:02:03:04:05:06 using domain name
312    "client.example.com" uses the client's link-layer address to identify
313    the client.  The DHCID RDATA is composed by setting the two type
314    octets to zero, the 1-octet digest type to 1 for SHA-256, and
315    performing an SHA-256 hash computation across a buffer containing the
316    Ethernet MAC type octet, 0x01, the six octets of MAC address, and the
317    domain name (represented as specified in Section 3.5).
319      client.example.com.   A       10.0.0.1
320      client.example.com.   DHCID   ( AAABxLmlskllE0MVjd57zHcWmEH3pCQ6V
321                                      ytcKD//7es/deY= )
323    If the DHCID RR type is not supported, the RDATA would be encoded
324    [13] as:
326      \# 35 ( 000001c4b9a5b249651343158dde7bcc77169841f7a4243a572b5c283
327              fffedeb3f75e6 )
329 3.6.2.  Example 2
331    A DHCP server allocates the IPv4 address 10.0.12.99 to a client which
332    included the DHCP client-identifier option data 01:07:08:09:0a:0b:0c
336 Stapp, et al.           Expires September 1, 2006               [Page 6]
338 Internet-Draft                The DHCID RR                 February 2006
341    in its DHCP request.  The server updates the name "chi.example.com"
342    on the client's behalf, and uses the DHCP client identifier option
343    data as input in forming a DHCID RR.  The DHCID RDATA is formed by
344    setting the two type octets to the value 0x0001, the 1-octet digest
345    type to 1 for SHA-256, and performing a SHA-256 hash computation
346    across a buffer containing the seven octets from the client-id option
347    and the FQDN (represented as specified in Section 3.5).
349      chi.example.com.      A       10.0.12.99
350      chi.example.com.      DHCID   ( AAEBOSD+XR3Os/0LozeXVqcNc7FwCfQdW
351                                      L3b/NaiUDlW2No= )
353    If the DHCID RR type is not supported, the RDATA would be encoded
354    [13] as:
356      \# 35 ( 0001013920fe5d1dceb3fd0ba3379756a70d73b17009f41d58bddbfcd
357              6a2503956d8da )
359 3.6.3.  Example 3
361    A DHCP server allocates the IPv6 address 2000::1234:5678 to a client
362    which included the DHCPv6 client-identifier option data 00:01:00:06:
363    41:2d:f1:66:01:02:03:04:05:06 in its DHCPv6 request.  The server
364    updates the name "chi6.example.com" on the client's behalf, and uses
365    the DHCP client identifier option data as input in forming a DHCID
366    RR.  The DHCID RDATA is formed by setting the two type octets to the
367    value 0x0002, the 1-octet digest type to 1 for SHA-256, and
368    performing a SHA-256 hash computation across a buffer containing the
369    14 octets from the client-id option and the FQDN (represented as
370    specified in Section 3.5).
372      chi6.example.com.     AAAA    2000::1234:5678
373      chi6.example.com.     DHCID   ( AAIBY2/AuCccgoJbsaxcQc9TUapptP69l
374                                      OjxfNuVAA2kjEA= )
376    If the DHCID RR type is not supported, the RDATA would be encoded
377    [13] as:
379      \# 35 ( 000201636fc0b8271c82825bb1ac5c41cf5351aa69b4febd94e8f17cd
380              b95000da48c40 )
383 4.  Use of the DHCID RR
385    This RR MUST NOT be used for any purpose other than that detailed in
386    "Resolution of DNS Name Conflicts" [1].  Although this RR contains
387    data that is opaque to DNS servers, the data must be consistent
388    across all entities that update and interpret this record.
392 Stapp, et al.           Expires September 1, 2006               [Page 7]
394 Internet-Draft                The DHCID RR                 February 2006
397    Therefore, new data formats may only be defined through actions of
398    the DHC Working Group, as a result of revising [1].
401 5.  Updater Behavior
403    The data in the DHCID RR allows updaters to determine whether more
404    than one DHCP client desires to use a particular FQDN.  This allows
405    site administrators to establish policy about DNS updates.  The DHCID
406    RR does not establish any policy itself.
408    Updaters use data from a DHCP client's request and the domain name
409    that the client desires to use to compute a client identity hash, and
410    then compare that hash to the data in any DHCID RRs on the name that
411    they wish to associate with the client's IP address.  If an updater
412    discovers DHCID RRs whose RDATA does not match the client identity
413    that they have computed, the updater SHOULD conclude that a different
414    client is currently associated with the name in question.  The
415    updater SHOULD then proceed according to the site's administrative
416    policy.  That policy might dictate that a different name be selected,
417    or it might permit the updater to continue.
420 6.  Security Considerations
422    The DHCID record as such does not introduce any new security problems
423    into the DNS.  In order to obscure the client's identity information,
424    a one-way hash is used.  And, in order to make it difficult to
425    'track' a client by examining the names associated with a particular
426    hash value, the FQDN is included in the hash computation.  Thus, the
427    RDATA is dependent on both the DHCP client identification data and on
428    each FQDN associated with the client.
430    However, it should be noted that an attacker that has some knowledge,
431    such as of MAC addresses commonly used in DHCP client identification
432    data, may be able to discover the client's DHCP identify by using a
433    brute-force attack.  Even without any additional knowledge, the
434    number of unknown bits used in computing the hash is typically only
435    48 to 80.
437    Administrators should be wary of permitting unsecured DNS updates to
438    zones, whether or not they are exposed to the global Internet.  Both
439    DHCP clients and servers SHOULD use some form of update
440    authentication (e.g., TSIG [11]) when performing DNS updates.
443 7.  IANA Considerations
448 Stapp, et al.           Expires September 1, 2006               [Page 8]
450 Internet-Draft                The DHCID RR                 February 2006
453    IANA is requested to allocate a DNS RR type number for the DHCID
454    record type.
456    This specification defines a new number-space for the 2-octet
457    identifier type codes associated with the DHCID RR.  IANA is
458    requested to establish a registry of the values for this number-
459    space.  Three initial values are assigned in Section 3.3, and the
460    value 0xFFFF is reserved for future use.  New DHCID RR identifier
461    type codes are assigned through Standards Action, as defined in RFC
462    2434 [5].
464    This specification defines a new number-space for the 1-octet digest
465    type codes associated with the DHCID RR.  IANA is requested to
466    establish a registry of the values for this number-space.  Two
467    initial values are assigned in Section 3.4.  New DHCID RR digest type
468    codes are assigned through Standards Action, as defined in RFC 2434
469    [5].
472 8.  Acknowledgements
474    Many thanks to Harald Alvestrand, Ralph Droms, Olafur Gudmundsson,
475    Sam Hartman, Josh Littlefield, Pekka Savola, and especially Bernie
476    Volz for their review and suggestions.
479 9.  References
481 9.1.  Normative References
483    [1]  Stapp, M. and B. Volz, "Resolution of DNS Name Conflicts Among
484         DHCP Clients (draft-ietf-dhc-dns-resolution-*)", February 2006.
486    [2]  Bradner, S., "Key words for use in RFCs to Indicate Requirement
487         Levels", BCP 14, RFC 2119, March 1997.
489    [3]  Mockapetris, P., "Domain names - concepts and facilities",
490         STD 13, RFC 1034, November 1987.
492    [4]  Mockapetris, P., "Domain names - implementation and
493         specification", STD 13, RFC 1035, November 1987.
495    [5]  Narten, T. and H. Alvestrand, "Guidelines for Writing an IANA
496         Considerations Section in RFCs", BCP 26, RFC 2434, October 1998.
504 Stapp, et al.           Expires September 1, 2006               [Page 9]
506 Internet-Draft                The DHCID RR                 February 2006
509 9.2.  Informative References
511    [6]   Droms, R., "Dynamic Host Configuration Protocol", RFC 2131,
512          March 1997.
514    [7]   Josefsson, S., "The Base16, Base32, and Base64 Data Encodings",
515          RFC 3548, July 2003.
517    [8]   Arends, R., Austein, R., Larson, M., Massey, D., and S. Rose,
518          "Resource Records for the DNS Security Extensions", RFC 4034,
519          March 2005.
521    [9]   Alexander, S. and R. Droms, "DHCP Options and BOOTP Vendor
522          Extensions", RFC 2132, March 1997.
524    [10]  Droms, R., Bound, J., Volz, B., Lemon, T., Perkins, C., and M.
525          Carney, "Dynamic Host Configuration Protocol for IPv6
526          (DHCPv6)", RFC 3315, July 2003.
528    [11]  Vixie, P., Gudmundsson, O., Eastlake, D., and B. Wellington,
529          "Secret Key Transaction Authentication for DNS (TSIG)",
530          RFC 2845, May 2000.
532    [12]  Lemon, T. and B. Sommerfeld, "Node-specific Client Identifiers
533          for Dynamic Host Configuration Protocol Version Four (DHCPv4)",
534          RFC 4361, February 2006.
536    [13]  Gustafsson, A., "Handling of Unknown DNS Resource Record (RR)
537          Types", RFC 3597, September 2003.
560 Stapp, et al.           Expires September 1, 2006              [Page 10]
562 Internet-Draft                The DHCID RR                 February 2006
565 Authors' Addresses
567    Mark Stapp
568    Cisco Systems, Inc.
569    1414 Massachusetts Ave.
570    Boxborough, MA  01719
571    USA
573    Phone: 978.936.1535
574    Email: mjs@cisco.com
577    Ted Lemon
578    Nominum, Inc.
579    950 Charter St.
580    Redwood City, CA  94063
581    USA
583    Email: mellon@nominum.com
586    Andreas Gustafsson
587    Araneus Information Systems Oy
588    Ulappakatu 1
589    02320 Espoo
590    Finland
592    Email: gson@araneus.fi
616 Stapp, et al.           Expires September 1, 2006              [Page 11]
618 Internet-Draft                The DHCID RR                 February 2006
621 Intellectual Property Statement
623    The IETF takes no position regarding the validity or scope of any
624    Intellectual Property Rights or other rights that might be claimed to
625    pertain to the implementation or use of the technology described in
626    this document or the extent to which any license under such rights
627    might or might not be available; nor does it represent that it has
628    made any independent effort to identify any such rights.  Information
629    on the procedures with respect to rights in RFC documents can be
630    found in BCP 78 and BCP 79.
632    Copies of IPR disclosures made to the IETF Secretariat and any
633    assurances of licenses to be made available, or the result of an
634    attempt made to obtain a general license or permission for the use of
635    such proprietary rights by implementers or users of this
636    specification can be obtained from the IETF on-line IPR repository at
637    http://www.ietf.org/ipr.
639    The IETF invites any interested party to bring to its attention any
640    copyrights, patents or patent applications, or other proprietary
641    rights that may cover technology that may be required to implement
642    this standard.  Please address the information to the IETF at
643    ietf-ipr@ietf.org.
646 Disclaimer of Validity
648    This document and the information contained herein are provided on an
649    "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
650    OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
651    ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
652    INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
653    INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
654    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
657 Copyright Statement
659    Copyright (C) The Internet Society (2006).  This document is subject
660    to the rights, licenses and restrictions contained in BCP 78, and
661    except as set forth therein, the authors retain all their rights.
664 Acknowledgment
666    Funding for the RFC Editor function is currently provided by the
667    Internet Society.
672 Stapp, et al.           Expires September 1, 2006              [Page 12]