7283
PROPOSED STANDARD

Handling Unknown DHCPv6 Messages (Obsoleted)

Authors: Y. Cui, Q. Sun, T. Lemon
Date: July 2014
Area: int
Working Group: dhc
Stream: IETF
Obsoleted by: RFC 8415
Updates: RFC 3315

Abstract

DHCPv6 is not specific about handling messages with unknown types. This memo describes the problems associated with receiving DHCPv6 messages with unknown types, and defines how a DHCPv6 server, client, or relay agent should behave when receiving unknown DHCPv6 messages. This document also provides advice for authors of future documents that define new messages to be sent from DHCP servers to DHCP relay agents. This document updates RFC 3315.

RFC 7283: Handling Unknown DHCPv6 Messages [RFC Home] [TEXT|PDF|HTML] [Tracker] [IPR] [Info page]

Obsoleted by: 8415 PROPOSED STANDARD
Internet Engineering Task Force (IETF)                            Y. Cui
Request for Comments: 7283                                        Q. Sun
Updates: <a href="./rfc3315">3315</a>                                        Tsinghua University
Category: Standards Track                                       T. Lemon
ISSN: 2070-1721                                            Nominum, Inc.
                                                               July 2014


                    <span class="h1">Handling Unknown DHCPv6 Messages</span>

Abstract

   DHCPv6 is not specific about handling messages with unknown types.
   This memo describes the problems associated with receiving DHCPv6
   messages with unknown types, and defines how a DHCPv6 server, client,
   or relay agent should behave when receiving unknown DHCPv6 messages.
   This document also provides advice for authors of future documents
   that define new messages to be sent from DHCP servers to DHCP relay
   agents.  This document updates <a href="./rfc3315">RFC 3315</a>.

Status of This Memo

   This is an Internet Standards Track document.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   Internet Engineering Steering Group (IESG).  Further information on
   Internet Standards is available in <a href="./rfc5741#section-2">Section 2 of RFC 5741</a>.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   <a href="https://www.rfc-editor.org/info/rfc7283">http://www.rfc-editor.org/info/rfc7283</a>.


















<span class="grey">Cui, et al.                  Standards Track                    [Page 1]</span>

<span id="page-2" ></span>
<span class="grey"><a href="./rfc7283">RFC 7283</a>            Handling Unknown DHCPv6 Messages           July 2014</span>


Copyright Notice

   Copyright (c) 2014 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (<a href="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</a>) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

   This document may contain material from IETF Documents or IETF
   Contributions published or made publicly available before November
   10, 2008.  The person(s) controlling the copyright in some of this
   material may not have granted the IETF Trust the right to allow
   modifications of such material outside the IETF Standards Process.
   Without obtaining an adequate license from the person(s) controlling
   the copyright in such materials, this document may not be modified
   outside the IETF Standards Process, and derivative works of it may
   not be created outside the IETF Standards Process, except to format
   it for publication as an RFC or to translate it into languages other
   than English.

Table of Contents

   <a href="#section-1">1</a>.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   <a href="#page-3">3</a>
   <a href="#section-2">2</a>.  Requirements Language . . . . . . . . . . . . . . . . . . . .   <a href="#page-3">3</a>
   <a href="#section-3">3</a>.  Problem Statement . . . . . . . . . . . . . . . . . . . . . .   <a href="#page-3">3</a>
   <a href="#section-4">4</a>.  Relay Agent Behavior Update . . . . . . . . . . . . . . . . .   <a href="#page-3">3</a>
     4.1.  A Valid Message for Constructing a New Relay-forward
           Message . . . . . . . . . . . . . . . . . . . . . . . . .   <a href="#page-4">4</a>
     <a href="#section-4.2">4.2</a>.  Relaying a Message toward the Server  . . . . . . . . . .   <a href="#page-5">5</a>
     <a href="#section-4.3">4.3</a>.  Relaying a Message toward the Client  . . . . . . . . . .   <a href="#page-5">5</a>
   <a href="#section-5">5</a>.  Client and Server Behavior Update . . . . . . . . . . . . . .   <a href="#page-5">5</a>
   <a href="#section-6">6</a>.  Security Considerations . . . . . . . . . . . . . . . . . . .   <a href="#page-5">5</a>
   <a href="#section-7">7</a>.  Contributors  . . . . . . . . . . . . . . . . . . . . . . . .   <a href="#page-6">6</a>
   <a href="#section-8">8</a>.  Normative References  . . . . . . . . . . . . . . . . . . . .   <a href="#page-6">6</a>










<span class="grey">Cui, et al.                  Standards Track                    [Page 2]</span>

<span id="page-3" ></span>
<span class="grey"><a href="./rfc7283">RFC 7283</a>            Handling Unknown DHCPv6 Messages           July 2014</span>


<span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>.  Introduction</span>

   DHCPv6 [<a href="./rfc3315" title=""Dynamic Host Configuration Protocol for IPv6 (DHCPv6)"">RFC3315</a>] provides a framework for conveying IPv6
   configuration information to hosts on a TCP/IP network.  But
   [<a href="./rfc3315" title=""Dynamic Host Configuration Protocol for IPv6 (DHCPv6)"">RFC3315</a>] is not specific about how to deal with messages with
   unrecognized types.  This document describes the problems associated
   with receiving DHCPv6 messages with unknown types, and defines the
   behavior of a DHCPv6 server, client, or relay agent when handling
   unknown DHCPv6 messages.

<span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>.  Requirements Language</span>

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in [<a href="./rfc2119" title=""Key words for use in RFCs to Indicate Requirement Levels"">RFC2119</a>].

<span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>.  Problem Statement</span>

   When a relay agent receives a message, it sends the message toward
   either the server or the client.  The relay agent decides on the
   direction to forward based on the message type.  Since <a href="./rfc3315">RFC 3315</a> was
   published, new message types have been defined.  Additional message
   types may be defined in the future.  <a href="./rfc3315">RFC 3315</a> does not specify what
   to do when a DHCP agent does not recognize the type of message it has
   received.  This may lead to relay agents inappropriately dropping
   these messages and to other DHCP agents inappropriately processing
   these messages.

   In addition, there is no specific requirement for dealing with
   unknown messages by the client or server in <a href="./rfc3315">RFC 3315</a>.

   Note that it is expected that most future DHCPv6 messages will not be
   used to communicate directly with relay agents (though they may need
   to be relayed by relay agents).

<span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>.  Relay Agent Behavior Update</span>

   Relay agents relay messages toward servers and clients according to
   the message type.  The Relay-reply message is sent toward the client.
   The Relay-forward message and other types of messages are sent toward
   the server.

   We say "toward the client" and "toward the server" because relay
   agents may be chained together, so a relay message may be sent
   through multiple relay agents along the path to its destination.
   Relay-reply messages specify a destination address; the relay agent
   extracts the encapsulated message and sends it to the specified
   destination address.  Any message other than a Relay-reply does not



<span class="grey">Cui, et al.                  Standards Track                    [Page 3]</span>

<span id="page-4" ></span>
<span class="grey"><a href="./rfc7283">RFC 7283</a>            Handling Unknown DHCPv6 Messages           July 2014</span>


   have such a specified destination, so it follows the default
   forwarding path configured on the relay agent, which is always toward
   the server.

   The sole purpose of requiring relay agents to relay unknown messages
   is to ensure that when legitimate new messages are defined in the
   protocol, relay agents (even if they were manufactured prior to the
   definition of these new messages) will, by default, succeed in
   relaying such messages.

<span class="h3"><a class="selflink" id="section-4.1" href="#section-4.1">4.1</a>.  A Valid Message for Constructing a New Relay-forward Message</span>

   <a href="./rfc3315#section-20.1">Section 20.1 of [RFC3315]</a> states that:

      When a relay agent receives a valid message to be relayed, it
      constructs a new Relay-forward message.

   It does not define which types of messages are valid for constructing
   Relay-forward messages.  In this document, we specify the definition
   as follows.

      The message is valid for constructing a new Relay-forward message:

      (a)  if the message is a Relay-forward message, or

      (b)  if the relay agent recognizes the message type and is not the
           intended target, or

      (c)  if the relay agent does not recognize the message type.

   New DHCP message types may be defined in the future that are sent,
   unsolicited, to relay agents.  Relay agents that do not implement
   these messages will not recognize the messages as being intended for
   them.  Therefore, a relay agent that implements this specification
   will forward such messages to the DHCP servers to which it is
   configured to relay client messages.

   At this time, no such message types have been specified.  If such a
   message is specified in the future, it is possible that this would
   result in needless load on DHCP servers.  If such a message type is
   defined in a future specification, authors may need to consider a
   strategy for identifying non-conforming relays and not sending such
   messages to those relay agents.

   However, since DHCP servers do not respond to unknown messages, this
   is unlikely to create significant load and is therefore likely to be
   unnecessary.




<span class="grey">Cui, et al.                  Standards Track                    [Page 4]</span>

<span id="page-5" ></span>
<span class="grey"><a href="./rfc7283">RFC 7283</a>            Handling Unknown DHCPv6 Messages           July 2014</span>


<span class="h3"><a class="selflink" id="section-4.2" href="#section-4.2">4.2</a>.  Relaying a Message toward the Server</span>

   If the relay agent receives a Relay-forward message, <a href="./rfc3315#section-20.1.2">Section 20.1.2
   of [RFC3315]</a> defines the required behavior.  If the relay agent
   receives messages other than Relay-forward and Relay-reply and the
   relay agent does not recognize its message type, it MUST forward them
   as described in <a href="./rfc3315#section-20.1.1">Section 20.1.1 of [RFC3315]</a>.

<span class="h3"><a class="selflink" id="section-4.3" href="#section-4.3">4.3</a>.  Relaying a Message toward the Client</span>

   If the relay agent receives a Relay-reply message, it MUST process
   the message as defined in <a href="./rfc3315#section-20.2">Section 20.2 of [RFC3315]</a>, regardless of
   the type of message encapsulated in the Relay Message option.

<span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>.  Client and Server Behavior Update</span>

   A client or server MUST silently discard any received DHCPv6 message
   with an unknown message type.

<span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>.  Security Considerations</span>

   This document creates no new security issues that are not already
   present in <a href="./rfc3315">RFC 3315</a>.  By explicitly documenting the correct handling
   of unknown messages, this document, if implemented, reduces any
   security exposure that might result from incorrect handling of
   unknown messages.  The following issues are already present with
   <a href="./rfc3315#section-23">Section 23 of [RFC3315]</a>, but we discuss them in detail here as
   guidance for implementors.

   As the relay agent will forward all unknown types of DHCPv6 messages,
   a malicious attacker can interfere with the relaying function by
   constructing fake DHCPv6 messages with an arbitrary type code.  The
   same problem may occur in current DHCPv4 and DHCPv6 practice, where
   the attacker constructs the fake DHCP message with a known type code.

   Clients and servers that implement this specification will discard
   unknown DHCPv6 messages.  Since <a href="./rfc3315">RFC 3315</a> did not specify relay agent,
   client, or server behavior in the presence of unknown messages, it is
   possible that some servers or clients that have not been updated to
   conform to this specification will become vulnerable to attacks
   through the relay agent as a result of this change.

   For this reason, we recommend that relay agents, clients, and servers
   be updated to follow this new specification.  However, in most
   deployment scenarios, it will be much easier to attack clients
   directly than through a relay agent.  Furthermore, attacks using
   unknown message types are already possible on the local wire.




<span class="grey">Cui, et al.                  Standards Track                    [Page 5]</span>

<span id="page-6" ></span>
<span class="grey"><a href="./rfc7283">RFC 7283</a>            Handling Unknown DHCPv6 Messages           July 2014</span>


   So, in most cases, if clients are not upgraded, there should be
   minimal additional risk.  At sites where only servers and relay
   agents can be upgraded, the incremental benefit of doing so most
   likely exceeds any risk of vulnerable clients.

   Nothing in this update should be construed to mean that relay agents
   may not be administratively configurable to drop messages based on
   the message type, for security reasons (e.g., in a firewall).

<span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>.  Contributors</span>

   Many thanks to Bernie Volz, Tomek Mrugalski, Sheng Jiang, Cong Liu,
   and Yuchi Chen for their contributions to the document.

<span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>.  Normative References</span>

   [<a id="ref-RFC2119">RFC2119</a>]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a>, March 1997.

   [<a id="ref-RFC3315">RFC3315</a>]  Droms, R., Bound, J., Volz, B., Lemon, T., Perkins, C.,
              and M. Carney, "Dynamic Host Configuration Protocol for
              IPv6 (DHCPv6)", <a href="./rfc3315">RFC 3315</a>, July 2003.





























<span class="grey">Cui, et al.                  Standards Track                    [Page 6]</span>

<span id="page-7" ></span>
<span class="grey"><a href="./rfc7283">RFC 7283</a>            Handling Unknown DHCPv6 Messages           July 2014</span>


Authors' Addresses

   Yong Cui
   Tsinghua University
   Beijing  100084
   P.R. China

   Phone: +86-10-6260-3059
   EMail: [email protected]


   Qi Sun
   Tsinghua University
   Beijing  100084
   P.R. China

   Phone: +86-10-6278-5822
   EMail: [email protected]


   Ted Lemon
   Nominum, Inc.
   2000 Seaport Blvd
   Redwood City, CA  94063
   USA

   Phone: +1-650-381-6000
   EMail: [email protected]























Cui, et al.                  Standards Track                    [Page 7]

Additional Resources