This is a purely informative rendering of an RFC that includes verified errata. This rendering may not be used as a reference.

The following 'Verified' errata have been incorporated in this document: EID 4995
Internet Engineering Task Force (IETF)                          D. Miles
Request for Comments: 6704                                        Google
Updates: 3203                                                     W. Dec
Category: Standards Track                                  Cisco Systems
ISSN: 2070-1721                                               J. Bristow
                                                     Swisscom Schweiz AG
                                                             R. Maglione
                                                          Telecom Italia
                                                             August 2012


                    Forcerenew Nonce Authentication

Abstract

   Dynamic Host Configuration Protocol (DHCP) FORCERENEW allows for the
   reconfiguration of a single host by forcing the DHCP client into a
   Renew state on a trigger from the DHCP server.  In the Forcerenew
   Nonce Authentication protocol, the server sends a nonce to the client
   in the initial DHCP ACK that is used for subsequent validation of a
   FORCERENEW message.  This document updates RFC 3203.

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 Section 2 of RFC 5741.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   http://www.rfc-editor.org/info/rfc6704.

Copyright Notice

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

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) 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.

Table of Contents

   1. Introduction ....................................................2
   2. Requirements Language ...........................................3
   3. Message Authentication ..........................................3
      3.1. Forcerenew Nonce Authentication ............................3
           3.1.1. Forcerenew Nonce Protocol Capability Option .........4
           3.1.2. Forcerenew Nonce Authentication Protocol ............6
           3.1.3. Server Considerations for Forcerenew Nonce
                  Authentication ......................................8
           3.1.4. Client Considerations for Forcerenew Nonce
                  Authentication ......................................9
   4. IANA Considerations ............................................10
   5. Security Considerations ........................................10
      5.1. Protocol Vulnerabilities ..................................11
   6. Acknowledgements ...............................................11
   7. Normative References ...........................................11

1.  Introduction

   The DHCP reconfigure extension defined in [RFC3203] is a useful
   mechanism allowing dynamic reconfiguration of a single host triggered
   by the DHCP server.  Its application is currently limited by a
   requirement that a Forcerenew message is always authenticated using
   procedures as described in [RFC3118].  Authentication for DHCP
   [RFC3118] is mandatory for FORCERENEW; however, as it is currently
   defined, [RFC3118] requires distribution of constant token or shared-
   secret out-of-band to DHCP clients.

   The motivation for making authentication mandatory in DHCP FORCERENEW
   was to prevent an off-network attacker from taking advantage of DHCP
   FORCERENEW to accurately predict the timing of a DHCP renewal.
   Without DHCP FORCERENEW, DHCP renewal timing is under the control of

   the client, and an off-network attacker has no way of predicting when
   it will happen, since it doesn't have access to the exchange between
   the DHCP client and DHCP server.

   However, the requirement to use the DHCP authentication described in
   [RFC3118] is more stringent than is required for this use case and
   has limited adoption of DHCP FORCERENEW.  [RFC3315] defines an
   authentication protocol using a nonce to prevent off-network
   attackers from successfully causing clients to renew.  Since the off-
   network attacker doesn't have access to the nonce, it can't trick the
   client into renewing at a time of its choosing.

   This document defines extensions to Authentication for DHCPv4
   Messages [RFC3118] to create a new authentication protocol for DHCPv4
   FORCERENEW [RFC3203] messages; this method does not require out-of-
   band key distribution to DHCP clients.  The Forcerenew Nonce is
   exchanged between server and client on initial DHCP ACK and is used
   for verification of any subsequent FORCERENEW message.  This document
   updates [RFC3203].

2.  Requirements Language

   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 [RFC2119].

3.  Message Authentication

   The Forcerenew message MUST be authenticated using either [RFC3118]
   or the proposed Forcerenew Nonce Authentication protocol.

3.1.  Forcerenew Nonce Authentication

   The Forcerenew Nonce Authentication protocol provides protection
   against misconfiguration of a client caused by a Forcerenew message
   sent by a malicious DHCP server.  In this protocol, a DHCP server
   sends a Forcerenew Nonce to the client in the initial exchange of
   DHCP messages.  The client records the Forcerenew Nonce for use in
   authenticating subsequent Forcerenew messages from that server.  The
   server then includes a Hashed Message Authentication Code (HMAC)
   computed from the Forcerenew nonce in subsequent Forcerenew messages.

   Both the Forcerenew Nonce sent from the server to the client and the
   HMAC in subsequent Forcerenew messages are carried as the
   Authentication information in a DHCP Authentication option.  The
   format of the Authentication information is defined in the following
   section.

   The Forcerenew Nonce Authentication protocol is used (initiated by
   the server) only if the client and server are not using the
   authentication mechanism specified in [RFC3118] and the client and
   server have negotiated to use the Forcerenew Nonce Authentication
   protocol.

3.1.1.  Forcerenew Nonce Protocol Capability Option

   A DHCP client indicates DHCP Forcerenew Nonce Protocol capability by
   including a FORCERENEW_NONCE_CAPABLE (145) option in DHCP Discover
   and Request messages sent to the server.

   A DHCP server that does not support Forcerenew Nonce Authentication
   protocol authentication SHOULD ignore the FORCERENEW_NONCE_CAPABLE
   (145) option.  A DHCP server indicates DHCP Forcerenew Nonce Protocol
   preference by including a FORCERENEW_NONCE_CAPABLE (145) option in
   any DHCP Offer messages sent to the client.

   A DHCP client MUST NOT send DHCP messages with authentication options
   where the protocol value is Forcerenew Nonce Authentication.

   The FORCERENEW_NONCE_CAPABLE option contains code 145, length n, and
   a sequence of algorithms the client supports:

             Code   Len   Algorithms
            +-----+-----+----+----+----+
            | 145 |  n  | A1 | A2 | A3 | ....
            +-----+-----+----+----+----+

                 Figure 1: FORCERENEW_NONCE_CAPABLE Option

   In this document, Section 3.1.2 defines the Forcerenew Nonce
   Authentication protocol for algorithm equal to 1 and type equal to 2;
   future documents will specify the other values for algorithm !=1 and
   type !=2, allowing a different algorithm to be used with shorter/
   longer values.

   The client would indicate that it supports the functionality by
   inserting the FORCERENEW_NONCE_CAPABLE option in the DHCP Discover
   and Request messages.  If the server supports Forcerenew nonce
   authentication and requires Forcerenew nonce authentication, it will
   insert the FORCERENEW_NONCE_CAPABLE option in the DHCPOFFER.

                     Server          Client          Server
                 (not selected)                    (selected)

                       v               v               v
                       |               |               |
                       |     Begins initialization     |
                       |               |               |
                       | _____________/|\____________  |
                       |/DHCPDISCOVER  | DHCPDISCOVER \|
                       | w/FORCERENEW- | w/FORCERENEW- |
                       | NONCE-CAPABLE | NONCE-CAPABLE |
                       |               |               |
                   Determines          |          Determines
                  configuration        |         configuration
                       |               |               |
                       |\              |              /|
                       | \__________   |    _________/ |
                       |  DHCPOFFER \  |   /DHCPOFFER  |
                       |w/FORCERENEW \ |  /w/FORCERENEW|
                       |NONCE-CAPABLE \| /NONCE-CAPABLE|
                       |               |               |
                       |       Collects replies        |
                       |               |               |
                       |     Selects configuration     |
                       |               |               |
                       | _____________/|\____________  |
                       |/ DHCPREQUEST  |  DHCPREQUEST\ |
                       | w/Forcerenew- | w/Forcerenew- |
                       | Nonce-Capable | Nonce-Capable |
                       |               |               |
                       |               |     Commits configuration
                       |               |               |
                       |               |Creates 128-bit Forcerenew Nonce
                       |               |               |
                       |               | _____________/|
                       |               |/ DHCPACK      |
                       |               | w/Auth-Proto= |
                       |               | Forcerenew-   |
                       |               |        Nonce  |
                       |               |               |
                       |Client stores Forcerenew Nonce |
                       |               |               |
                       |    Initialization complete    |
                       |               |               |
                       .               .               .
                       .               .               .
                       |               |               |
                       |          Forcerenew           |

                       |               | _____________/|
                       |               |/ DHCPFORCE    |
                       |               | w/Auth-Proto= |
                       |               | Forcerenew-   |
                       |               |   Digest(HMAC)|
                       |               |               |
                       | Client checks HMAC digest     |
                       | using stored Forcerenew Nonce |
                       |               |               |
                       |               |\____________  |
                       |               |  DHCPREQUEST\ |
                       |               | w/FORCERENEW- |
                       |               | NONCE-CAPABLE |
                       |               |               |
                       |               |     Commits configuration
                       |               |               |
                       |               |Creates 128-bit Forcerenew Nonce
                       |               |               |
                       |               | _____________/|
                       |               |/ DHCPACK      |
                       |               | w/Auth-Proto= |
                       |               |   Forcerenew- |
                       |               |         Nonce |
                       |               |               |
                       |               |               |
                       |               |               |
                       .               .               .
                       .               .               .
                       |               |               |
                       |      Graceful shutdown        |
                       |               |               |
                       |               |\ ____________ |
                       |               | DHCPRELEASE  \|
                       |               |               |
                       |               |        Discards lease
                       |               |               |
                       v               v               v

   Figure 2: Timeline Diagram of Messages Exchanged between DHCP Client
      and Servers Using the Forcerenew Nonce Authentication Protocol

3.1.2.  Forcerenew Nonce Authentication Protocol

   The Forcerenew Nonce Authentication protocol makes use of both the
   DHCP authentication option defined in [RFC3118] reusing the option
   format and of the Reconfigure Key Authentication Protocol defined in
   [RFC3315].

   The following diagram defines the format of the DHCP authentication
   option:

       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |     Code      |    Length     |  Protocol     |   Algorithm   |
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |     RDM       | Replay Detection (64 bits)                    |
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |  Replay cont.                                                 |
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |  Replay cont. |                                               |
      +-+-+-+-+-+-+-+-+                                               |
      |                                                               |
      |           Authentication Information                          |
      |                                                               |
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

            Figure 3: Format of the DHCP Authentication Option

   The following fields are set in an DHCP authentication option for the
   Forcerenew Nonce Authentication protocol.

      Code: 90 (Authentication) per [RFC3118]

      Length: contains the length of the protocol

      Protocol: 3 (Reconfigure Key) per [RFC3118]

      Algorithm: 1 (HMAC-MD5) per [RFC3118] and [RFC3315]

      Replay Detection: per the Replay Detection Method (RDM)

      Replay Detection Method (RDM): 0

      Authentication Information: specified below

   The format of the Authentication Information for the Forcerenew Nonce
   Authentication Protocol is as follows:

       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |     Type      |                 Value (128 bits)              |
      +-+-+-+-+-+-+-+-+                                               |
      .                                                               .
      .                                                               .
      .                                               +-+-+-+-+-+-+-+-+
      |                                               |
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

            Figure 4: Format of the Authentication Information

      Type: The type of data in Value field carried in this option:

         1 Forcerenew nonce Value (used in ACK message)

         2 HMAC-MD5 digest of the message (Forcerenew message)

      Value: The message authentication code generated by applying MD5
      to the DHCP message

3.1.3.  Server Considerations for Forcerenew Nonce Authentication

   The use of Forcerenew Nonce Authentication protocol is dependent on
   the client indicating its capability through the
   FORCERENEW_NONCE_CAPABLE (145) DHCP option in any DHCP Discover or
   Request messages.  The DHCP Discovery or Request message from the
   client MUST contain the FORCERENEW_NONCE_CAPABLE (145) option if the
   Forcerenew Nonce Protocol is to be used by the server.  The absence
   of the FORCERENEW_NONCE_CAPABLE (145) option indicates to the server
   that the Forcerenew Nonce Authentication protocol is not supported;
   thus, the server MUST NOT include a Forcerenew Nonce Protocol
   Authentication option in the DHCP ACK.

   The server indicates its support of the Forcerenew Nonce
   Authentication protocol by including the DHCP
   FORCERENEW_NONCE_CAPABLE (145) option in the DHCPOFFER.  The server
   SHOULD NOT include this option unless the client has indicated its
   capability in a DHCP Discovery message.  The presence of the
   FORCERENEW_NONCE_CAPABLE (145) option in the DHCP offer may be used
   by clients to prefer DHCP servers that are Forcerenew Nonce
   Authentication protocol capable over those servers that do not
   support such capability.

   If a capable server receives a DISCOVER or REQUEST (any type) that
   indicates the client is capable, and the server has no previous nonce
   recorded, it MUST generate a nonce and include it in the ACK.

   The server selects a Forcerenew Nonce for a client only during
   Request/ACK message exchange.  The server records the Forcerenew
   nonce and transmits that nonce to the client in an Authentication
   option in the DHCP ACK message.

   The server SHOULD NOT include the nonce in an ACK when responding to
   a renew unless a new nonce was generated.  This minimizes the number
   of times the nonce is sent over the wire.

   If the server to which the DHCP Request message was sent at time T1
   has not responded, the client enters the REBINDING state and attempts
   to contact any server.  The new Server receiving the DHCP message
   MUST generate a new nonce.

   The Forcerenew nonce is 128 bits long, and it MUST be a
   cryptographically strong random or pseudo-random number that cannot
   easily be predicted.  The nonce is embedded as a 128-bit value of the
   Authentication information where type is set to 1 (Forcerenew nonce
   Value).

   To provide authentication for a Forcerenew message, the server
   selects a replay detection value according to the RDM selected by the
   server and computes an HMAC-MD5 of the Forcerenew message, based on
   the procedure specified in Section 21.5 of [RFC3315], using the
   Forcerenew Nonce for the client.  The server computes the HMAC-MD5
   over the entire DHCP Forcerenew message, including the Authentication
   option; the HMAC-MD5 field in the Authentication option is set to
   zero for the HMAC-MD5 computation

3.1.4.  Client Considerations for Forcerenew Nonce Authentication

   A client that supports this mechanism MUST indicate Forcerenew nonce
   Capability by including the FORCERENEW_NONCE_CAPABLE (145) DHCP
   option defined in Section 3.1.1 in all DHCP Discover and Request
   messages.  DHCP servers that support Forcerenew nonce Protocol
   authentication MUST include the FORCERENEW_NONCE_CAPABLE (145) DHCP
   option in all DHCP Offers, allowing the client to use this capability
   in selecting DHCP servers should multiple Offers arrive.

   The client MUST validate the DHCP ACK message contains a Forcerenew
   Nonce in a DHCP authentication option.  If the server has indicated
   capability for Forcerenew Nonce Authentication protocol in the DHCP
   OFFER and the subsequent ACK received by the client while in the
   selecting state omits a valid DHCP authentication option for the

   Forcerenew Nonce Authentication protocol, the client MUST discard the
   message and return to the INIT state.

   The client MUST record the Forcerenew Nonce from any valid ACK it
   receives, if the ACK contains one.

   To authenticate a Forcerenew message, the client computes an HMAC-
   MD5, based on the procedure specified in Section 21.5 of [RFC3315],
   over the DHCP Forcerenew message (after setting the HMAC-MD5 field in
   the Authentication option to zero), using the Forcerenew Nonce
   received from the server.  If this computed HMAC-MD5 matches the
   value in the Authentication option, the client accepts the FORCERENEW
   message.

4.  IANA Considerations

      IANA has assigned the following new DHCPv4 option code from the 
   registry "BOOTP Vendor Extensions and DHCP Options" maintained at
   http://www.iana.org/assignments/bootp-dhcp-parameters:

   Tag: 145

   Name: FORCERENEW_NONCE_CAPABLE

   Data length: n

   Description: Forcerenew Nonce Capable

   Reference: this document
EID 4995 (Verified) is as follows:

Section: 4

Original Text:

   IANA has assigned the following new DHCPv4 option code from the
   registry "BOOTP Vendor Extensions and DHCP Options" maintained at
   http://www.iana.org/assignments/bootp-dhcp-parameters:

   Tag: 145

   Name: FORCERENEW_NONCE_CAPABLE

   Data length: 1

   Description: Forcerenew Nonce Capable

   Reference: this document

Corrected Text:

   IANA has assigned the following new DHCPv4 option code from the
   registry "BOOTP Vendor Extensions and DHCP Options" maintained at
   http://www.iana.org/assignments/bootp-dhcp-parameters:

   Tag: 145

   Name: FORCERENEW_NONCE_CAPABLE

   Data length: n

   Description: Forcerenew Nonce Capable

   Reference: this document
Notes:
RFC 6704 Section 3.1.1 states that the FORCERENEW_NONCE_CAPABLE option is variable length and contains a list of algorithm types:

The FORCERENEW_NONCE_CAPABLE option contains code 145, length n, and
a sequence of algorithms the client supports:

Code Len Algorithms
+-----+-----+----+----+----+
| 145 | n | A1 | A2 | A3 | ....
+-----+-----+----+----+----+

Figure 1: FORCERENEW_NONCE_CAPABLE Option


Verifier's note(Suresh Krishnan - INT AD): This erratum is correct and it requires a change in the IANA registry. I authorize IANA to make this change.
5. Security Considerations As in some network environments FORCERENEW can be used to snoop and spoof traffic, the FORCERENEW message MUST be authenticated using the procedures as described in [RFC3118] or the mechanism described in this document. The mechanism in [RFC3315] for DHCPv6, which this document mirrors for DHCPv4, uses a nonce to prevent an off-link attacker from successfully triggering a renewal on a client by sending DHCPFORCERENEW; since the attacker is off-link, it doesn't have the nonce, and can't force a renewal. An on-link attacker can always simply watch the DHCP renewal message go out and respond to it, so this mechanism is useless for preventing on-link attacks; hence, the security of the nonce in the case of on- link attacks isn't relevant. Therefore, HMAC-MD5 is, by definition, adequate for the purpose, and there is no need for an extensible HMAC mechanism. FORCERENEW messages failing the authentication should be silently discarded by the client. 5.1. Protocol Vulnerabilities The mechanism described in this document is vulnerable to a denial- of-service (DoS) attack through flooding a client with bogus FORCERENEW messages. The calculations involved in authenticating the bogus FORECERENEW messages may overwhelm the device on which the client is running. The mechanism described provides protection against the use of a FORCERENEW message by a malicious DHCP server to mount a DoS or man- in-the-middle attack on a client. This protocol can be compromised by an attacker that can intercept the initial message in which the DHCP server sends the nonce to the client. 6. Acknowledgements This contribution is based on work by Vitali Vinokour. Major sections of this document use modified text from [RFC3315]. The authors wish to thank Ted Lemon, Matthew Ryan, and Bernie Volz for their support. 7. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC3118] Droms, R. and W. Arbaugh, "Authentication for DHCP Messages", RFC 3118, June 2001. [RFC3203] T'Joens, Y., Hublet, C., and P. De Schrijver, "DHCP reconfigure extension", RFC 3203, December 2001. [RFC3315] Droms, R., Bound, J., Volz, B., Lemon, T., Perkins, C., and M. Carney, "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)", RFC 3315, July 2003. Authors' Addresses David Miles Google EMail: davidmiles@google.com Wojciech Dec Cisco Systems Haarlerbergpark Haarlerbergweg 13-19 Amsterdam, NOORD-HOLLAND 1101 CH Netherlands EMail: wdec@cisco.com James Bristow Swisscom Schweiz AG Zentweg 9 Bern, 3050, Switzerland EMail: James.Bristow@swisscom.com Roberta Maglione Telecom Italia Via Reiss Romoli 274 Torino 10148 Italy EMail: roberta.maglione@telecomitalia.it