[Docs] [txt|pdf] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: (draft-volz-dhc-dhcpv6-srsn-option) 00 01 02

dhc Group                                                        B. Volz
Internet-Draft                                                  R. Droms
Intended status: Informational                       Cisco Systems, Inc.
Expires: August 8, 2009                                 February 4, 2009


               DHCPv6 Server Reply Sequence Number Option
                draft-ietf-dhc-dhcpv6-srsn-option-02.txt

Status of this Memo

   This Internet-Draft is submitted to IETF in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt.

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html.

   This Internet-Draft will expire on August 8, 2009.

Copyright Notice

   Copyright (c) 2009 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.

Abstract

   This memo defines the Server Reply Sequence Number option for the
   Dynamic Host Configuration Protocol for IPv6 (DHCPv6).  This option



Volz & Droms             Expires August 8, 2009                 [Page 1]


Internet-Draft          DHCPv6 Server RSN Option           February 2009


   is sent from a DHCPv6 server to a DHCPv6 relay agent to allow a relay
   agent to detect proper sequencing of Relay-Reply messages that could
   be delivered out of order.


Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . 3
   2.  Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . 3
   3.  The Server Reply Sequence Number Option . . . . . . . . . . . . 3
   4.  DHCPv6 Relay Agent Behavior . . . . . . . . . . . . . . . . . . 4
   5.  DHCPv6 Server Behavior  . . . . . . . . . . . . . . . . . . . . 5
   6.  IANA considerations . . . . . . . . . . . . . . . . . . . . . . 5
   7.  Security considerations . . . . . . . . . . . . . . . . . . . . 6
   8.  Modification History  . . . . . . . . . . . . . . . . . . . . . 6
   9.  References  . . . . . . . . . . . . . . . . . . . . . . . . . . 6
     9.1.  Normative References  . . . . . . . . . . . . . . . . . . . 6
     9.2.  Informative References  . . . . . . . . . . . . . . . . . . 6
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . . . 7
































Volz & Droms             Expires August 8, 2009                 [Page 2]


Internet-Draft          DHCPv6 Server RSN Option           February 2009


1.  Introduction

   When a DHCPv6 server sends a Reply, there is no guarantee as to the
   order of delivery of those datagrams sent by a server.  A DHCPv6
   client is protected against delivery of old Reply messages because of
   the transaction-id in the message.  However, a relay agent receiving
   Relay-Reply messages and maintaining client state information (e.g.,
   [I-D.ietf-dhc-dhcpv6-agentopt-delegate] has no such technique.  Thus
   a delayed earlier Relay-Reply may arrive after other Relay-Reply
   messages.  As an example, suppose a client sends a Request, the Reply
   (encapsulated in a Relay-Reply) is delayed between server and relay
   agent.  The client retransmits the Request, the retransmitted Reply
   is processed through the relay agent and then by the client.  The
   client next transacts a Release/Reply sequence, which causes the
   relay agent to remove the client's state information when relaying
   the Relay-Reply.  However, now the delayed first Request's Reply
   arrives at the relay agent; if the relay agent were to update the
   client's state based on this out of order message (e.g.,
   [I-D.ietf-dhc-dhcpv6-agentopt-delegate]), it would add client state
   that is no longer valid.  The Server Reply Sequence Number (SRSN)
   option can be used to prevent this as the relay agent can detect and
   discard out of order message.

   To allow a relay agent to detect and discard out of order messages,
   the relay agent requests the server to include a SRSN option in
   Relay-Reply messages.  The SRSN option contains a monotonically
   increasing sequence number that the relay agent can use to re-
   sequence (or discard) out of order Relay-Reply messages from the
   server.


2.  Terminology

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

   Additional terms used in the description of DHCPv6 and DHCPv6 prefix
   delegation are defined in [RFC3315] and [RFC3633].


3.  The Server Reply Sequence Number Option

   The SRSN option is used by a server to indicate the order in which
   the server has generated replies and therefore allows a relay agent
   receiving Relay-Reply messages to determine the order in which those
   Relay-Reply messages were originally sent.  The Relay-Reply messages
   are sent via UDP and, therefore, may be delivered out of order.



Volz & Droms             Expires August 8, 2009                 [Page 3]


Internet-Draft          DHCPv6 Server RSN Option           February 2009


   The server's sequence number in the SRSN is a monotonically
   increasing series.  This property is maintained by the server even if
   the server loses internal state; e.g., if the server is restarted.
   The value of the sequence number in the SRSN option is not related to
   the contents of any options in the Relay-Reply message; the existence
   of this sequence number does not indicate that any data at the server
   has necessarily changed.

   The DHCPv6 Server Reply Sequence Number Option has the following
   format:


     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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |         option-code           |            length             |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |                                                               |
    +                  server-reply-sequence-number                 +
    |                                                               |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+


   option-code          OPTION_SRSN (TBD).

   length               8.

   server-reply-sequence-number
                        The 64-bit monotonically increasing server reply
                        sequence number.


4.  DHCPv6 Relay Agent Behavior

   If a relay agent requires the server to provide the SRSN option, it
   MUST include an Option Request option, requesting the SRSN option, as
   described in section 22.7 of [RFC3315].

   A relay agent MUST save the received server-reply-sequence-number
   (and the server's Server Identifier Option, OPTION_SERVERID) with any
   client state information extracted from a Relay-Reply if it needs to
   assure it does not use out of date information.

   A relay agent that uses the SRSN option needs do the following when
   maintaining client state information:






Volz & Droms             Expires August 8, 2009                 [Page 4]


Internet-Draft          DHCPv6 Server RSN Option           February 2009


   1.  Only update existing client state information if the received
       server-reply-sequence-number (if from the same server) is greater
       than the stored server-reply-sequence-number for the information;
       the received server-reply-sequence-number and Server Identifier
       must be stored with the client state information.

   2.  Delay removing expired client state information from its storage
       for at least the maximum lifetime of a datagram.  This assures
       that any undelivered Relay-Reply datagrams will have expired and
       been dropped from the network; and thus the server-reply-
       sequence-number checking will prevent outdated information from
       being used.  A value of 2 minutes is the recommended value for
       the maximum datagram lifetime, based on the maximum segment
       lifetime used by the Transmission Control Protocol (TCP)
       [RFC0793].

   A change in the server-reply-sequence-number MUST NOT be used to
   assume a client's state has changed, as a server may be
   retransmitting the same information but with a different server-
   reply-sequence-number.


5.  DHCPv6 Server Behavior

   If a relay agent has requested the SRSN option in an ORO, the server
   SHOULD return the option with a monotonically increasing sequence
   number.  And, the server MUST also include a Server Identifier Option
   (OPTION_SERVER_ID) in the Relay-Reply if it includes the SRSN option.

   The server MUST monotonically increase the sequence number for any
   Relay-Reply messages it transmits which include a SRSN option.  A
   server MAY increase the sequence number for each message it
   transmits, even those that do not include a SRSN option.

   One technique for a server to provide the monotonically increasing
   sequence number is by splitting the 64-bit number into two 32-bit
   values (minding network/host byte ordering) - a major (most
   significant bits) and minor sequence number.  When the server starts,
   the major sequence number is set to the current time (in seconds
   since Jan 1, 1970).  The minor sequence number is set to 0 and only
   it is incremented while the server is running (except if it rolls
   over, in which case the major sequence number MUST be updated); there
   is no need to commit the sequence number to stable storage.


6.  IANA considerations

   IANA is requested to assign an option code from the "DHCPv6 and



Volz & Droms             Expires August 8, 2009                 [Page 5]


Internet-Draft          DHCPv6 Server RSN Option           February 2009


   DHCPv6 options" registry,
   http://www.iana.org/assignments/dhcpv6-parameters, to OPTION_SRSN.


7.  Security considerations

   Security issues related to DHCP are described in [RFC3315] and
   [RFC3633].

   The DHCPv6 Server Reply Sequence Number option may be used to mount a
   denial of service attack by causing a relay agent to incorrectly
   record a very high server-reply-sequence-number and thus preventing
   legitimate Relay-Reply messages from a server from being processed.
   Communication between a server and a relay agent, and communication
   between relay agents, can be secured through the use of IPSec, as
   described in section 21.1 of [RFC3315].


8.  Modification History

   Changes in rev -02: None except boiler plate, version number, and
   date.

   Changes in rev -01 (to fix idnits):
   o  Revised terminology section to match recommended RFC 2119 syntax.
   o  Used new I-D boilerplate.
   o  Added this section.


9.  References

9.1.  Normative References

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119, March 1997.

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

   [RFC3633]  Troan, O. and R. Droms, "IPv6 Prefix Options for Dynamic
              Host Configuration Protocol (DHCP) version 6", RFC 3633,
              December 2003.

9.2.  Informative References

   [RFC0793]  Postel, J., "Transmission Control Protocol", STD 7,
              RFC 793, September 1981.



Volz & Droms             Expires August 8, 2009                 [Page 6]


Internet-Draft          DHCPv6 Server RSN Option           February 2009


   [I-D.ietf-dhc-dhcpv6-agentopt-delegate]
              Droms, R., "DHCPv6 Relay Agent Assignment Notification
              (RAAN) Option", draft-ietf-dhc-dhcpv6-agentopt-delegate-02
              (work in progress), November 2006.


Authors' Addresses

   Bernie Volz
   Cisco Systems, Inc.
   1414 Massachusetts Avenue
   Boxborough, MA  01719
   USA

   Phone: +1 978.936.0382
   Email: volz@cisco.com


   Ralph Droms
   Cisco Systems, Inc.
   1414 Massachusetts Avenue
   Boxborough, MA  01719
   USA

   Phone: +1 978.936.1674
   Email: rdroms@cisco.com

























Volz & Droms             Expires August 8, 2009                 [Page 7]


Html markup produced by rfcmarkup 1.129c, available from https://tools.ietf.org/tools/rfcmarkup/