draft-ietf-dhc-dhcpv6-active-leasequery-04.txt   rfc7653.txt 
DHC Working Group D. Raghuvanshi Internet Engineering Task Force (IETF) D. Raghuvanshi
Internet-Draft K. Kinnear Request for Comments: 7653 K. Kinnear
Updates: 5460 (if approved) D. Kukrety Updates: 5460 D. Kukrety
Intended status: Standards Track Cisco Systems, Inc. Category: Standards Track Cisco Systems, Inc.
Expires: February 1, 2016 July 31, 2015 ISSN: 2070-1721 October 2015
DHCPv6 Active Leasequery DHCPv6 Active Leasequery
draft-ietf-dhc-dhcpv6-active-leasequery-04
Abstract Abstract
The Dynamic Host Configuration Protocol for IPv6 (DHCPv6) has been The Dynamic Host Configuration Protocol for IPv6 (DHCPv6) has been
extended with a Leasequery capability that allows a requestor to extended with a Leasequery capability that allows a requestor to
request information about DHCPv6 bindings. That mechanism is limited request information about DHCPv6 bindings. That mechanism is limited
to queries for DHCPv6 binding data updates prior to the time the to queries for DHCPv6 binding data updates prior to the time the
DHCPv6 server receives the Leasequery request. Continuous update of DHCPv6 server receives the Leasequery request. Continuous update of
an external requestor with Leasequery data is sometimes desired. an external requestor with Leasequery data is sometimes desired.
This document expands on the DHCPv6 Leasequery protocol, and allows This document expands on the DHCPv6 Leasequery protocol and allows
for active transfer of real-time DHCPv6 binding information data via for active transfer of real-time DHCPv6 binding information data via
TCP. This document also updates DHCPv6 Bulk Leasequery (RFC5460) by TCP. This document also updates DHCPv6 Bulk Leasequery (RFC 5460) by
adding new options. adding new options.
Status of This Memo Status of This Memo
This Internet-Draft is submitted in full conformance with the This is an Internet Standards Track document.
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months This document is a product of the Internet Engineering Task Force
and may be updated, replaced, or obsoleted by other documents at any (IETF). It represents the consensus of the IETF community. It has
time. It is inappropriate to use Internet-Drafts as reference received public review and has been approved for publication by the
material or to cite them other than as "work in progress." Internet Engineering Steering Group (IESG). Further information on
Internet Standards is available in Section 2 of RFC 5741.
This Internet-Draft will expire on February 1, 2016. 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/rfc7653.
Copyright Notice Copyright Notice
Copyright (c) 2015 IETF Trust and the persons identified as the Copyright (c) 2015 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 1. Introduction ....................................................4
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Terminology .....................................................4
3. Protocol Overview . . . . . . . . . . . . . . . . . . . . . . 5 3. Protocol Overview ...............................................6
4. Interaction Between Active Leasequery and Bulk Leasequery . . 7 4. Interaction between Active Leasequery and Bulk Leasequery .......8
5. Extension to DHCPv6 Bulk Leasequery . . . . . . . . . . . . . 8 5. Extension to DHCPv6 Bulk Leasequery .............................8
6. Message and Option Definitions . . . . . . . . . . . . . . . 8 6. Message and Option Definitions ..................................9
6.1. Message Framing for TCP . . . . . . . . . . . . . . . . . 8 6.1. Message Framing for TCP ....................................9
6.2. Messages . . . . . . . . . . . . . . . . . . . . . . . . 8 6.2. Messages ...................................................9
6.2.1. ACTIVELEASEQUERY . . . . . . . . . . . . . . . . . . 8 6.2.1. ACTIVELEASEQUERY ....................................9
6.2.2. STARTTLS . . . . . . . . . . . . . . . . . . . . . . 9 6.2.2. STARTTLS ...........................................10
6.2.3. Response Messages . . . . . . . . . . . . . . . . . . 9 6.2.3. Response Messages ..................................10
6.3. Options . . . . . . . . . . . . . . . . . . . . . . . . . 10 6.3. Options ...................................................10
6.3.1. OPTION_LQ_BASE_TIME . . . . . . . . . . . . . . . . . 10 6.3.1. OPTION_LQ_BASE_TIME ................................10
6.3.2. OPTION_LQ_START_TIME . . . . . . . . . . . . . . . . 10 6.3.2. OPTION_LQ_START_TIME ...............................11
6.3.3. OPTION_LQ_END_TIME . . . . . . . . . . . . . . . . . 11 6.3.3. OPTION_LQ_END_TIME .................................12
6.4. Connection and Transmission Parameters . . . . . . . . . 12 6.4. Connection and Transmission Parameters ....................12
7. Information Communicated by Active Leasequery . . . . . . . . 12 7. Information Communicated by Active Leasequery ..................13
8. Requestor Behavior . . . . . . . . . . . . . . . . . . . . . 13 8. Requestor Behavior .............................................14
8.1. General Processing . . . . . . . . . . . . . . . . . . . 13 8.1. General Processing ........................................14
8.2. Initiating a Connection . . . . . . . . . . . . . . . . . 14 8.2. Initiating a Connection ...................................14
8.3. Forming an Active Leasequery . . . . . . . . . . . . . . 15 8.3. Forming an Active Leasequery ..............................15
8.4. Processing Active Replies . . . . . . . . . . . . . . . . 16 8.4. Processing Active Replies .................................16
8.4.1. Processing Replies from a Request Containing a 8.4.1. Processing Replies from a Request Containing an
OPTION_LQ_START_TIME . . . . . . . . . . . . . . . . 17 OPTION_LQ_START_TIME ...............................18
8.5. Processing Time Values in Leasequery messages . . . . . . 20 8.5. Processing Time Values in Leasequery Messages .............20
8.6. Examples . . . . . . . . . . . . . . . . . . . . . . . . 20 8.6. Examples ..................................................21
8.6.1. Query Failure . . . . . . . . . . . . . . . . . . . . 20 8.6.1. Query Failure ......................................21
8.6.2. Data Missing on Server . . . . . . . . . . . . . . . 21 8.6.2. Data Missing on Server .............................21
8.6.3. Successful Query . . . . . . . . . . . . . . . . . . 21 8.6.3. Successful Query ...................................21
8.7. Closing Connections . . . . . . . . . . . . . . . . . . . 22 8.7. Closing Connections .......................................22
9. Server Behavior . . . . . . . . . . . . . . . . . . . . . . . 22 9. Server Behavior ................................................22
9.1. Accepting Connections . . . . . . . . . . . . . . . . . . 22 9.1. Accepting Connections .....................................22
9.2. Rejecting Connections . . . . . . . . . . . . . . . . . . 24 9.2. Rejecting Connections .....................................24
9.3. Replying to an Active Leasequery . . . . . . . . . . . . 24 9.3. Replying to an Active Leasequery ..........................24
9.4. Multiple or Parallel Queries . . . . . . . . . . . . . . 26 9.4. Multiple or Parallel Queries ..............................26
9.5. Closing Connections . . . . . . . . . . . . . . . . . . . 26 9.5. Closing Connections .......................................26
10. Security Considerations . . . . . . . . . . . . . . . . . . . 27 10. Security Considerations .......................................27
11. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 27 11. IANA Considerations ...........................................28
12. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 28 12. References ....................................................28
13. Modification History . . . . . . . . . . . . . . . . . . . . 28 12.1. Normative References .....................................28
14. References . . . . . . . . . . . . . . . . . . . . . . . . . 28 12.2. Informative References ...................................29
14.1. Normative References . . . . . . . . . . . . . . . . . . 28 Acknowledgments ...................................................30
14.2. Informative References . . . . . . . . . . . . . . . . . 29 Authors' Addresses ................................................30
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 29
1. Introduction 1. Introduction
The DHCPv6 [RFC3315] protocol specifies a mechanism for the The DHCPv6 protocol [RFC3315] specifies a mechanism for the
assignment of IPv6 address and configuration information to IPv6 assignment of IPv6 address and configuration information to IPv6
nodes. IPv6 Prefix Delegation for DHCPv6 (PD) [RFC3633] specifies a nodes. IPv6 Prefix Delegation for DHCPv6 [RFC3633] specifies a
mechanism for DHCPv6 delegation of IPv6 prefixes and related data. mechanism for DHCPv6 delegation of IPv6 prefixes and related data.
DHCPv6 servers maintain authoritative information including binding DHCPv6 servers maintain authoritative information including binding
information for delegated IPv6 prefixes. information for delegated IPv6 prefixes.
Requirements exist for external entities to keep up to date on the Requirements exist for external entities to keep up to date on the
correspondence between DHCPv6 clients and their bindings. These correspondence between DHCPv6 clients and their bindings. These
entities need to keep up with the current binding activity of the entities need to keep up with the current binding activity of the
DHCPv6 server. Keeping up with these binding activity is termed DHCPv6 server. Keeping up with this binding activity is termed
"active" leasequery. "active" leasequery.
The DHCPv6 Bulk Leasequery [RFC5460] capability can be used to The DHCPv6 Bulk Leasequery [RFC5460] capability can be used to
recover useful information from a DHCPv6 server when some external recover useful information from a DHCPv6 server when some external
entity starts up. This entity could be one which is directly entity starts up. This entity could be one that is directly involved
involved in the DHCPv6 client - server transactions (e.g., a relay in the DHCPv6 client-server transactions (e.g., a relay agent), or it
agent), or it could be an external process which needs information could be an external process that needs information present in the
present in the DHCPv6 server's lease state database. DHCPv6 server's lease state database.
The Active Leasequery capability documented here is designed to allow The Active Leasequery capability documented here is designed to allow
an entity not directly involved in DHCPv6 client - server an entity not directly involved in DHCPv6 client-server transactions
transactions to nevertheless keep current with the state of the to nevertheless keep current with the state of the DHCPv6 lease state
DHCPv6 lease state information in real-time. information in real time.
This document updates DHCPv6 Bulk Leasequery [RFC5460] by adding new This document updates DHCPv6 Bulk Leasequery [RFC5460] by adding new
options, as described in Section 6.2.1. For DHCPv6 servers, options, as described in Section 6.2.1. For DHCPv6 servers
supporting Bulk Leasequery and not Active Leasequery, Section 9.2 supporting Bulk Leasequery and not Active Leasequery, Section 9.2
specifies the mechanism to reject incoming Active Leasequery specifies the mechanism to reject incoming Active Leasequery
requests. requests.
2. Terminology 2. Terminology
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119]. document are to be interpreted as described in RFC 2119 [RFC2119].
DHCPv6 terminology is defined in [RFC3315]. Terminology specific to DHCPv6 terminology is defined in [RFC3315]. Terminology specific to
DHCPv6 Active Leasequery can be found below: DHCPv6 Active Leasequery can be found below:
o "Absolute Time" o absolute time
A 32-bit unsigned quantity containing the number of seconds since A 32-bit unsigned quantity containing the number of seconds since
midnight (UTC), January 1, 2000, modulo 2^32. midnight (UTC), January 1, 2000, modulo 2^32.
o "Active Leasequery" o Active Leasequery
Keeping up to date in real-time (or near real-time) with DHCPv6 Keeping up to date in real time (or near real time) with DHCPv6
binding activity. binding activity.
o "Bulk Leasequery" o Bulk Leasequery
Requesting and receiving the information about all or some of the Requesting and receiving information about all or some of the
existing DHCPv6 binding information in an efficient manner, as existing DHCPv6 binding information in an efficient manner, as
defined by [RFC5460]. defined by [RFC5460].
o "blocked TCP connection" o blocked TCP connection
A TCP connection is considered blocked if the underlying TCP A TCP connection is considered blocked if the underlying TCP
transport will not accept new messages to be sent without blocking transport will not accept new messages to be sent without blocking
the thread that is attempting to send the message. the thread that is attempting to send the message.
o "binding change/update" o binding change/update
Any change in the DHCPv6 binding state. This also includes Any change in the DHCPv6 binding state. This also includes
expiration or deletion of the binding. expiration or deletion of the binding.
o "catch-up information" o catch-up information
If a DHCPv6 Active Leasequery requestor sends OPTION_LQ_START_TIME If a DHCPv6 Active Leasequery requestor sends an
option in an ACTIVELEASEQUERY message, the DHCPv6 server will OPTION_LQ_START_TIME option in an ACTIVELEASEQUERY message, the
attempt to send the requestor the information that changed since DHCPv6 server will attempt to send the requestor the information
the time specified in the OPTION_LQ_START_TIME option. The that changed since the time specified in the OPTION_LQ_START_TIME
binding information sent to satisfy this request is the catch-up option. The binding information sent to satisfy this request is
information. the catch-up information.
o "catch-up phase" o catch-up phase
The period while catch-up information is being sent is the catch- The period while catch-up information is being sent is the catch-
up phase. up phase.
o "clock skew" o clock skew
The difference between the absolute time on a DHCPv6 server and The difference between the absolute time on a DHCPv6 server and
the absolute time on the system where a requestor of an Active or the absolute time on the system where a requestor of an Active or
Bulk Leasequery is executing is termed the "clock skew" for that Bulk Leasequery is executing is termed the "clock skew" for that
Active or Bulk Leasequery connection. It is not absolutely Active or Bulk Leasequery connection. It is not absolutely
constant but is likely to vary only slowly. While it is easy to constant but is likely to vary only slowly. While it is easy to
think that this can be calculated precisely after one message is think that this can be calculated precisely after one message is
received by a requestor from a DHCPv6 server, a more accurate received by a requestor from a DHCPv6 server, a more accurate
value is derived from continuously examining the instantaneous value is derived from continuously examining the instantaneous
value developed from each message received from a DHCPv6 server value developed from each message received from a DHCPv6 server
and using it to make small adjustments to the existing value held and using it to make small adjustments to the existing value held
in the requestor. in the requestor.
o "DHCPv6 binding state" o DHCPv6 binding state
Data stored on the DHCPv6 server related to binding. Data stored on the DHCPv6 server related to binding.
o "requestor" o requestor
The node that sends LEASEQUERY messages to one or more servers to The node that sends LEASEQUERY messages to one or more servers to
retrieve information on the bindings for a client. retrieve information on the bindings for a client.
o "Transaction ID" o transaction-id
An opaque value used to match responses with queries initiated by An opaque value used to match responses with queries initiated by
an Active Leasequery requestor. an Active Leasequery requestor.
3. Protocol Overview 3. Protocol Overview
The Active Leasequery mechanism is modeled on the existing DHCPv6 The Active Leasequery mechanism is modeled on the existing DHCPv6
Bulk Leasequery [RFC5460]; most differences arise from the long term Bulk Leasequery [RFC5460]; most differences arise from the long-term
nature of the TCP [RFC7414] connection required for Active nature of the TCP [RFC7414] connection required for Active
Leasequery. A DHCPv6 server which supports Active Leasequery MUST Leasequery. A DHCPv6 server that supports Active Leasequery MUST
support Bulk Leasequery [RFC5460] as well. support Bulk Leasequery [RFC5460] as well.
An Active Leasequery requestor opens a TCP connection to a DHCPv6 An Active Leasequery requestor opens a TCP connection to a DHCPv6
Server, using the DHCPv6 port 547. Note that this implies that the server, using the DHCPv6 port 547. Note that this implies that the
Leasequery requestor has server IP address(es) available via Leasequery requestor has server IP address(es) available via
configuration or some other means, and that it has unicast IP configuration or some other means, and that it has unicast IP
reachability to the DHCPv6 server. No relaying for Active Leasequery reachability to the DHCPv6 server. No relaying for Active Leasequery
is specified. is specified.
After establishing a connection, the requestor sends an After establishing a connection, the requestor sends an
ACTIVELEASEQUERY message over the connection. In response, the ACTIVELEASEQUERY message over the connection. In response, the
server sends updates to the requestor using LEASEQUERY-REPLY and server sends updates to the requestor using LEASEQUERY-REPLY and
LEASEQUERY-DATA messages. This response procedure is similar to the LEASEQUERY-DATA messages. This response procedure is similar to the
procedure specified in [RFC5460], except that in the case of Active procedure specified in [RFC5460], except that in the case of Active
Leasequery the server sends updates whenever some activity occurs to Leasequery, the server sends updates whenever some activity occurs to
change the binding state - thus the need for long lived connection. change the binding state -- thus the need for a long-lived
Additionally, the Active Leasequery server SHOULD provide a mechanism connection. Additionally, the Active Leasequery server SHOULD
to control which data is allowed to be included in the provide a mechanism to control which data is allowed to be included
OPTION_CLIENT_DATA messages sent to the requestor. See Section 9.3. in the OPTION_CLIENT_DATA messages sent to the requestor. See
Section 9.3.
Active Leasequery has features which allow this external entity to Active Leasequery has features that allow this external entity to
lose its connection and then reconnect and receive the latest lose its connection and then reconnect and receive the latest
information concerning any IPv6 bindings changed while it was not information concerning any IPv6 bindings changed while it was not
connected. connected.
These features are designed to allow the Active Leasequery requestor These features are designed to allow the Active Leasequery requestor
to efficiently become current with respect to the lease state to efficiently become current with respect to the lease state
database after it has been restarted or the machine on which it is database after it has been restarted or the machine on which it is
running has been reinitialized. It is easy to define a protocol running has been reinitialized. It is easy to define a protocol that
which works when the requestor is always connected to the DHCPv6 works when the requestor is always connected to the DHCPv6 server.
server. Since that isn't sufficiently robust, much of the mechanism Since that isn't sufficiently robust, much of the mechanism in this
in this document is designed to deal efficiently with situations that document is designed to deal efficiently with situations that occur
occur when the Active Leasequery requestor becomes disconnected from when the Active Leasequery requestor becomes disconnected from the
the DHCPv6 server from which it is receiving updates and then DHCPv6 server from which it is receiving updates and then reconnects
reconnects to that server. to that server.
Central to this approach, if the Active Leasequery requestor loses Central to this approach, if the Active Leasequery requestor loses
service, it is allowed to specify the time of its most recent update service, it is allowed to specify the time of its most recent update
in a subsequent Active Leasequery request and the DHCPv6 server will in a subsequent Active Leasequery request, and the DHCPv6 server will
determine whether or not data was missed while the Active Leasequery determine whether or not data was missed while the Active Leasequery
requestor was not connected. requestor was not connected.
The DHCPv6 server processing the Active Leasequery request MAY limit The DHCPv6 server processing the Active Leasequery request MAY limit
the amount of data saved, and methods exist for the DHCPv6 server to the amount of data saved, and methods exist for the DHCPv6 server to
inform the Active Leasequery requestor that data was missed - not all inform the Active Leasequery requestor that data was missed (i.e.,
could be saved. In this situation, the Active Leasequery requestor not all data could be saved). In this situation, the Active
should issue a Bulk Leasequery [RFC5460] to recover information not Leasequery requestor should issue a Bulk Leasequery [RFC5460] to
available through an Active Leasequery. recover information not available through an Active Leasequery.
DHCPv6 servers are not required to keep any data corresponding to DHCPv6 servers are not required to keep any data corresponding to
data missed on an Active Leasequery connection, but will typically data missed on an Active Leasequery connection but will typically
choose to keep data corresponding to some recent activity available choose to keep data corresponding to some recent activity available
for subsequent queries by a DHCPv6 Active Leasequery requestor whose for subsequent queries by a DHCPv6 Active Leasequery requestor whose
connection was temporarily interrupted. In other words, DHCPv6 connection was temporarily interrupted. In other words, DHCPv6
servers supporting catch-up are required to have some mechanism to servers supporting catch-up are required to have some mechanism to
keep/save historic information of bindings. keep/save historic information of bindings.
An Active Leasequery requestor would typically use Bulk Leasequery to An Active Leasequery requestor would typically use Bulk Leasequery to
initialize its database with all current data when that database initialize its database with all current data when that database
contains no binding information. In addition, it would use Bulk contains no binding information. In addition, it would use Bulk
Leasequery to recover missed information in the event that its Leasequery to recover missed information in the event that its
skipping to change at page 7, line 36 skipping to change at page 8, line 11
Active Leasequery request should be identical to the way that the Active Leasequery request should be identical to the way that the
requestor interprets the responses to a Bulk Leasequery request. requestor interprets the responses to a Bulk Leasequery request.
Thus, the handling of OPTION_CLIENT_DATA and additional options Thus, the handling of OPTION_CLIENT_DATA and additional options
discussed in the Bulk Leasequery specification [RFC5460] are to be discussed in the Bulk Leasequery specification [RFC5460] are to be
followed when implementing Active Leasequery, with the exception that followed when implementing Active Leasequery, with the exception that
a server responding to an Active Leasequery request SHOULD be able to a server responding to an Active Leasequery request SHOULD be able to
be configured to prevent specific data items from being included in be configured to prevent specific data items from being included in
the OPTION_CLIENT_DATA option even if they were requested by the OPTION_CLIENT_DATA option even if they were requested by
inclusion in the OPTION_ORO option. inclusion in the OPTION_ORO option.
4. Interaction Between Active Leasequery and Bulk Leasequery 4. Interaction between Active Leasequery and Bulk Leasequery
Active Leasequery is an extension of the Bulk Leasequery protocol Active Leasequery is an extension of the Bulk Leasequery protocol
[RFC5460]. The format of messages returned to an Active Leasequery [RFC5460]. The format of messages returned to an Active Leasequery
requestor are identical to that defined for the Bulk Leasequery requestor is identical to that defined for the Bulk Leasequery
protocol [RFC5460]. protocol [RFC5460].
Applications which employ Active Leasequery to keep a database up to Applications that employ Active Leasequery to keep a database up to
date with respect to the DHCPv6 server's lease state database should date with respect to the DHCPv6 server's lease state database should
use an initial Bulk Leasequery to bring their database into use an initial Bulk Leasequery to bring their database into
equivalence with that of the DHCPv6 server, and then use Active equivalence with that of the DHCPv6 server and then use Active
Leasequery to keep that database current with respect to the DHCPv6 Leasequery to keep that database current with respect to the DHCPv6
server's lease state database. server's lease state database.
There are several differences between the Active and Bulk Leasequery There are several differences between the Active and Bulk Leasequery
protocols. Active Leasequery defines a new message protocols. Active Leasequery defines a new message
(ACTIVELEASEQUERY) to send Active Leasequery request to DHCPv6 (ACTIVELEASEQUERY) to send Active Leasequery requests to the DHCPv6
server. An Active Leasequery connection sends all available updates server. An Active Leasequery connection sends all available updates
to the requestor, based on OPTION_LQ_QUERY option (see to the requestor, based on the OPTION_LQ_QUERY option (see
Section 6.2.1). Section 6.2.1).
An Active Leasequery connection does not ever "complete", though the An Active Leasequery connection does not ever "complete", though the
DHCPv6 server can close the connection for a variety of reasons DHCPv6 server can close the connection for a variety of reasons
associated with some sort of exception condition. associated with some sort of exception condition.
5. Extension to DHCPv6 Bulk Leasequery 5. Extension to DHCPv6 Bulk Leasequery
This document extends to the capabilities of DHCPv6 Bulk Leasequery This document extends the capabilities of the DHCPv6 Bulk Leasequery
protocol [RFC5460] by defining new options (OPTION_LQ_BASE_TIME, protocol [RFC5460] by defining new options (OPTION_LQ_BASE_TIME,
OPTION_LQ_START_TIME and OPTION_LQ_END_TIME). DHCPv6 server sends OPTION_LQ_START_TIME, and OPTION_LQ_END_TIME). The DHCPv6 server
OPTION_LQ_BASE_TIME option in Bulk Leasequery response if requestor sends the OPTION_LQ_BASE_TIME option in a Bulk Leasequery response if
ask for the same in Bulk Leasequery request. OPTION_LQ_START_TIME the requestor asked for the same in the Bulk Leasequery request.
and OPTION_LQ_END_TIME can be used in Bulk Leasequery request made to OPTION_LQ_START_TIME and OPTION_LQ_END_TIME can be used in a Bulk
DHCPv6 server. More details about these options are specified in Leasequery request made to the DHCPv6 server. More details about
Section 6.3. these options are specified in Section 6.3.
6. Message and Option Definitions 6. Message and Option Definitions
6.1. Message Framing for TCP 6.1. Message Framing for TCP
The use of TCP for the Active Leasequery protocol permits one or more The use of TCP for the Active Leasequery protocol permits one or more
DHCPv6 messages to be sent in response to single Active Leasequery DHCPv6 messages to be sent in response to a single Active Leasequery
request. The receiver needs to be able to determine how large each request. The receiver needs to be able to determine how large each
message is. The same message framing technique used for DHCPv6 Bulk message is. The same message framing technique used for DHCPv6 Bulk
Leasequery [RFC5460] is used for Active Leasequery as well. Leasequery [RFC5460] is used for Active Leasequery as well.
The intent in using the same format is that code which currently The intent in using the same format is that code that currently knows
knows how to deal with a message returned from DHCPv6 Bulk Leasequery how to deal with a message returned from DHCPv6 Bulk Leasequery
[RFC5460] will be able to deal with the message held inside of the [RFC5460] will be able to deal with the message held inside of the
TCP framing. TCP framing.
When using TLS to secure a connection [RFC5246], the message framing When using Transport Layer Security (TLS), once TLS negotiation
for TLS uses the same format as that used for TCP. One DHCP message completes, the connection will be encrypted and is now protected from
is carried in one TLS record. eavesdropping, and normal Active Leasequery messages are sent and
received using the TLS application data protocol services (see
Section 10 of [RFC5246]).
6.2. Messages 6.2. Messages
6.2.1. ACTIVELEASEQUERY 6.2.1. ACTIVELEASEQUERY
The new message type (ACTIVELEASEQUERY) is designed for keeping the The new message type (ACTIVELEASEQUERY) is designed for keeping the
requestor up to date in real-time (or near real-time) with DHCPv6 requestor up to date in real time (or near real time) with DHCPv6
bindings. It asks the server to return DHCPv6 bindings activity that bindings. It asks the server to return DHCPv6 binding activity that
occurs subsequent to the receipt of the Active Leasequery request. occurs subsequent to the receipt of the Active Leasequery request.
An ACTIVELEASEQUERY request MUST contain a transaction-id, and that An ACTIVELEASEQUERY request MUST contain a transaction-id, and that
transaction-id MUST be locally unique on the TCP connection on which transaction-id MUST be locally unique on the TCP connection on which
it is sent to the DHCPv6 server. it is sent to the DHCPv6 server.
When sending an Active Leasequery request, the requestor MAY include When sending an ACTIVELEASEQUERY request, the requestor MAY include
the OPTION_LQ_START_TIME option in the ACTIVELEASEQUERY request. In the OPTION_LQ_START_TIME option in the ACTIVELEASEQUERY request. In
this case, DHCPv6 server returns all the bindings changed on or after this case, the DHCPv6 server returns all the bindings changed on or
the OPTION_LQ_START_TIME. after the OPTION_LQ_START_TIME.
If the requestor is interested in receiving all binding updates from If the requestor is interested in receiving all binding updates from
the DHCPv6 server, it MUST NOT include the OPTION_LQ_QUERY option in the DHCPv6 server, it MUST NOT include the OPTION_LQ_QUERY option in
the ACTIVELEASEQUERY message. But if the requestor is only the ACTIVELEASEQUERY message. But if the requestor is only
interested in specific binding updates, it MAY include an interested in specific binding updates, it MAY include an
OPTION_LQ_QUERY option along with a query-types defined in [RFC5007] OPTION_LQ_QUERY option along with a query-types defined in [RFC5007]
and [RFC5460]. and [RFC5460].
Other DHCPv6 options used in the LEASEQUERY message (as specified in Other DHCPv6 options used in the LEASEQUERY message (as specified in
[RFC5460]) can also be used in the ACTIVELEASEQUERY request. [RFC5460]) can also be used in the ACTIVELEASEQUERY message.
6.2.2. STARTTLS 6.2.2. STARTTLS
The new message type (STARTTLS) is designed for establishment of a The new message type (STARTTLS) is designed for establishment of a
TLS connection between a requestor and a DHCPv6 server. The STARTTLS TLS connection between a requestor and a DHCPv6 server. The STARTTLS
message SHOULD be sent without any options. Any options received in message SHOULD be sent without any options. Any options received in
a STARTTLS message SHOULD be ignored./ a STARTTLS message SHOULD be ignored.
More details about this message are specified in Section 8.2. More details about this message are specified in Section 8.2.
6.2.3. Response Messages 6.2.3. Response Messages
The LEASEQUERY-REPLY message is defined in [RFC5007]. The The LEASEQUERY-REPLY message is defined in [RFC5007]. The
LEASEQUERY-DATA and LEASEQUERY-DONE messages are defined in LEASEQUERY-DATA and LEASEQUERY-DONE messages are defined in
[RFC5460]. [RFC5460].
In an Active Leasequery exchange, a single LEASEQUERY-REPLY message In an Active Leasequery exchange, a single LEASEQUERY-REPLY message
is used to indicate the success or failure of a query, and to carry is used to indicate the success or failure of a query and to carry
data that do not change in the context of a single query and answer, data that do not change in the context of a single query and answer,
such as the Server-ID and Client-ID options. If a query is such as the Server-ID and Client-ID options. If a query is
successful, the DHCPv6 server MUST respond to it with exactly one successful, the DHCPv6 server MUST respond to it with exactly one
LEASEQUERY-REPLY message. If the server is returning binding data, LEASEQUERY-REPLY message. If the server is returning binding data,
the LEASEQUERY-REPLY also contains the first client's binding data in the LEASEQUERY-REPLY also contains the first client's binding data in
an OPTION_CLIENT_DATA option. Additional binding data is returned an OPTION_CLIENT_DATA option. Additional binding data is returned
using LEASEQUERY-DATA message as explained in DHCPv6 Bulk Leasequery using a LEASEQUERY-DATA message as explained in DHCPv6 Bulk
[RFC5460]. In case of failure query, single LEASEQUERY-REPLY message Leasequery [RFC5460]. In case of a query failure, a single
is returned without any binding data. LEASEQUERY-REPLY message is returned without any binding data.
6.3. Options 6.3. Options
New options (OPTION_LQ_BASE_TIME, OPTION_LQ_START_TIME and New options (OPTION_LQ_BASE_TIME, OPTION_LQ_START_TIME, and
OPTION_LQ_END_TIME) are defined as an extension to DHCPv6 Bulk OPTION_LQ_END_TIME) are defined as an extension to DHCPv6 Bulk
Leasequery [RFC5460]. The reply messages for Active Leasequery uses Leasequery [RFC5460]. The reply messages for Active Leasequery use
these options along with the options defined in [RFC3315], [RFC5007] these options along with the options defined in [RFC3315], [RFC5007],
and [RFC5460]. and [RFC5460].
6.3.1. OPTION_LQ_BASE_TIME 6.3.1. OPTION_LQ_BASE_TIME
The OPTION_LQ_BASE_TIME option is the current time the message was The OPTION_LQ_BASE_TIME option is the current time the message was
created to be sent by the DHCPv6 server to the requestor of the created to be sent by the DHCPv6 server to the requestor of the
Active or Bulk Leasequery if requestor ask for the same in Active or Active or Bulk Leasequery if the requestor asked for the same in an
Bulk Leasequery request. This MUST be an absolute time (i.e., Active or Bulk Leasequery request. This MUST be an absolute time
seconds since midnight January 1, 2000 UTC). All of the other time (i.e., seconds since midnight January 1, 2000 UTC). All of the other
based options in the reply message are relative to this time, time-based options in the reply message are relative to this time,
including OPTION_CLT_TIME [RFC5007]. This time is in the context of including OPTION_CLT_TIME [RFC5007]. This time is in the context of
the DHCPv6 server who placed this option in a message. the DHCPv6 server that placed this option in a message.
This is an unsigned integer in network byte order. This is an unsigned integer in network byte order.
The code for this option is TBD-1. The code for this option is 100.
0 1 2 3 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 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_LQ_BASE_TIME | option-len | | OPTION_LQ_BASE_TIME | option-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| base-time | | base-time |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
option-code OPTION_LQ_BASE_TIME (TBD-1). option-code OPTION_LQ_BASE_TIME (100)
option-len 4. option-len 4
base-time DHCPv6 Server Base Time. base-time DHCPv6 Server Base Time
6.3.2. OPTION_LQ_START_TIME 6.3.2. OPTION_LQ_START_TIME
The OPTION_LQ_START_TIME option specifies a query start time to the The OPTION_LQ_START_TIME option specifies a query start time to the
DHCPv6 server. If specified, only bindings that have changed on or DHCPv6 server. If specified, only bindings that have changed on or
after the OPTION_LQ_START_TIME should be included in the response to after the OPTION_LQ_START_TIME should be included in the response to
the query. This option MAY be used in Active or Bulk Leasequery the query. This option MAY be used in Active or Bulk Leasequery
requests made to a DHCPv6 server. requests made to a DHCPv6 server.
The requestor MUST determine the OPTION_LQ_START_TIME using lease The requestor MUST determine the OPTION_LQ_START_TIME using lease
information it has received from the DHCPv6 server. This MUST be an information it has received from the DHCPv6 server. This MUST be an
absolute time in the DHCPv6 server's context (see Section 8.5). absolute time in the DHCPv6 server's context (see Section 8.5).
Typically (though this is not a requirement) the OPTION_LQ_START_TIME Typically (though this is not a requirement), the
option will contain the value most recently received in a OPTION_LQ_START_TIME option will contain the value most recently
OPTION_LQ_BASE_TIME option by the requestor, as this will indicate received in an OPTION_LQ_BASE_TIME option by the requestor, as this
the last successful communication with the DHCPv6 server. will indicate the last successful communication with the DHCPv6
server.
This is an unsigned integer in network byte order. This is an unsigned integer in network byte order.
The code for this option is TBD-2. The code for this option is 101.
0 1 2 3 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 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_LQ_START_TIME | option-len | | OPTION_LQ_START_TIME | option-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| query-start-time | | query-start-time |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
option-code OPTION_LQ_START_TIME (TBD-2). option-code OPTION_LQ_START_TIME (101)
option-len 4. option-len 4
query-start-time DHCPv6 Server Query Start Time. query-start-time DHCPv6 Server Query Start Time
6.3.3. OPTION_LQ_END_TIME 6.3.3. OPTION_LQ_END_TIME
The OPTION_LQ_END_TIME option specifies a query end time to the The OPTION_LQ_END_TIME option specifies a query end time to the
DHCPv6 server. If specified, only bindings that have changed on or DHCPv6 server. If specified, only bindings that have changed on or
before the OPTION_LQ_END_TIME should be included in the response to before the OPTION_LQ_END_TIME should be included in the response to
the query. This option MAY be used in a Bulk Leasequery request. the query. This option MAY be used in a Bulk Leasequery request, but
But it MUST NOT be used in an Active Leasequery request. it MUST NOT be used in an Active Leasequery request.
The requestor MUST determine the OPTION_LQ_END_TIME based on lease The requestor MUST determine the OPTION_LQ_END_TIME based on lease
information it has received from the DHCPv6 server. This MUST be an information it has received from the DHCPv6 server. This MUST be an
absolute time in the context of the DHCPv6 server. absolute time in the context of the DHCPv6 server.
In the absence of information to the contrary, the requestor SHOULD In the absence of information to the contrary, the requestor SHOULD
assume that the time context of the DHCPv6 server is identical to the assume that the time context of the DHCPv6 server is identical to the
time context of the requestor (see Section 8.5). time context of the requestor (see Section 8.5).
This is an unsigned integer in network byte order. This is an unsigned integer in network byte order.
The code for this option is TBD-3. The code for this option is 102.
0 1 2 3 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 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_LQ_END_TIME | option-len | | OPTION_LQ_END_TIME | option-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| query-end-time | | query-end-time |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
option-code OPTION_LQ_END_TIME (TBD-3). option-code OPTION_LQ_END_TIME (102)
option-len 4. option-len 4
query-end-time DHCPv6 Server Query End Time. query-end-time DHCPv6 Server Query End Time
6.4. Connection and Transmission Parameters 6.4. Connection and Transmission Parameters
Active Leasequery uses the same port configuration as DHCPv6 Bulk Active Leasequery uses the same port configuration as DHCPv6 Bulk
Leasequery [RFC5460]. It also uses the other transmission parameters Leasequery [RFC5460]. It also uses the other transmission parameters
(BULK_LQ_DATA_TIMEOUT and BULK_LQ_MAX_CONNS) as defined in [RFC5460]. (BULK_LQ_DATA_TIMEOUT and BULK_LQ_MAX_CONNS) as defined in [RFC5460].
This section presents a table of values used to control Active This section presents a table of values used to control Active
Leasequery behavior, including recommended defaults. Implementations Leasequery behavior, including recommended defaults. Implementations
MAY make these values configurable. However, configuring too-small MAY make these values configurable. However, configuring too-small
timeout values may lead to harmful behavior both to this application timeout values may lead to harmful behavior both to this application
as well as to other traffic in the network. As a result, timeout and to other traffic in the network. As a result, timeout values
values smaller than the default values SHOULD NOT be used. smaller than the default values SHOULD NOT be used.
+------------------------+----------+-------------------------------+ +------------------------+----------+-------------------------------+
| Parameter | Default | Description | | Parameter | Default | Description |
+------------------------+----------+-------------------------------+ +------------------------+----------+-------------------------------+
| ACTIVE_LQ_RCV_TIMEOUT | 120 secs | Active Leasequery receive | | ACTIVE_LQ_RCV_TIMEOUT | 120 secs | Active Leasequery receive |
| | | timeout | | | | timeout |
| ACTIVE_LQ_SEND_TIMEOUT | 120 secs | Active Leasequery send | | ACTIVE_LQ_SEND_TIMEOUT | 120 secs | Active Leasequery send |
| | | timeout | | | | timeout |
| ACTIVE_LQ_IDLE_TIMEOUT | 60 secs | Active Leasequery idle | | ACTIVE_LQ_IDLE_TIMEOUT | 60 secs | Active Leasequery idle |
| | | timeout | | | | timeout |
+------------------------+----------+-------------------------------+ +------------------------+----------+-------------------------------+
7. Information Communicated by Active Leasequery 7. Information Communicated by Active Leasequery
While the information communicated by a DHCPv6 Bulk Leasequery While the information communicated by a DHCPv6 Bulk Leasequery
[RFC5460] is taken directly from the DHCPv6 server's lease state [RFC5460] is taken directly from the DHCPv6 server's lease state
database, the information communicated by an Active Leasequery is database, the information communicated by an Active Leasequery is
real-time information. As such, it is the information which is real-time information. As such, it is the information that is
currently associated with a particular binding in the DHCPv6 server's currently associated with a particular binding in the DHCPv6 server's
lease state database. lease state database.
This is of significance, because if the Active Leasequery requestor This is of significance, because if the Active Leasequery requestor
runs slowly or the requestor disconnects from the DHCPv6 server and runs slowly or the requestor disconnects from the DHCPv6 server and
then reconnects with an OPTION_LQ_START_TIME option (signaling a then reconnects with an OPTION_LQ_START_TIME option (signaling a
catch-up operation), the information communicated to the Active catch-up operation), the information communicated to the Active
Leasequery requestor is only the most current information from the Leasequery requestor is only the most current information from the
DHCPv6 server's lease state database. DHCPv6 server's lease state database.
The requestor of an Active Leasequery MUST NOT assume that every The requestor of an Active Leasequery MUST NOT assume that every
lease state change is communicated across an Active Leasequery lease state change is communicated across an Active Leasequery
connection. Even if the Active Leasequery requestor remains connection. Even if the Active Leasequery requestor remains
connected, the DHCPv6 server is only required to transmit information connected, the DHCPv6 server is only required to transmit information
about a binding that is current when the message is created and about a binding that is current when the message is created and
handed off to the TCP stack to send to the requestor. handed off to the TCP stack to send to the requestor.
If the TCP connection blocks and the DHCPv6 server is waiting to send If the TCP connection blocks and the DHCPv6 server is waiting to send
information down the connection, when the connection becomes information down the connection, when the connection becomes
available to be written the DHCPv6 server MAY create the message to available to be written, the DHCPv6 server MAY create the message to
send at this time. The current state of the binding will be sent, send at this time. The current state of the binding will be sent,
and any transition in state or other information that occurred while and any transition in state or other information that occurred while
the TCP connection was blocked will be lost. the TCP connection was blocked will be lost.
Thus, the Active Leasequery protocol does not allow the requestor to Thus, the Active Leasequery protocol does not allow the requestor to
build a complete history of every activity on every lease. An build a complete history of every activity on every lease. An
effective history of the important state changes for a lease can be effective history of the important state changes for a lease can be
created if the parameters of the DHCPv6 server are tuned to take into created if the parameters of the DHCPv6 server are tuned to take into
account the requirements of an Active Leasequery requestor. For account the requirements of an Active Leasequery requestor. For
instance, the period after the expiration or release of a binding instance, the period after the expiration or release of a binding
could be configured long enough (say several minutes, well more than could be configured long enough (say several minutes, well more than
the receive timeout), so that an Active Leasequery requestor would be the receive timeout), so that an Active Leasequery requestor would be
less likely to miss any changes in the binding. less likely to miss any changes in the binding.
8. Requestor Behavior 8. Requestor Behavior
8.1. General Processing 8.1. General Processing
A requestor attempts to establish a TCP connection to a DHCPv6 Server A requestor attempts to establish a TCP connection to a DHCPv6 server
in order to initiate an Active Leasequery exchange. If the attempt in order to initiate an Active Leasequery exchange. If the attempt
fails, the Requestor MAY retry. fails, the requestor MAY retry. Retries should not be more frequent
than one every ACTIVE_LQ_IDLE_TIMEOUT. See Section 6.4.
If an Active Leasequery is terminated prematurely by a LEASEQUERY- If an Active Leasequery is terminated prematurely by a LEASEQUERY-
DONE with a DHCPv6 status code (carried in an OPTION_STATUS_CODE DONE with a DHCPv6 status code (carried in an OPTION_STATUS_CODE
option) of QueryTerminated or by the failure of the connection over option) of QueryTerminated or by the failure of the connection over
which it was being submitted, the requestor MAY retry the request which it was being submitted, the requestor MAY retry the request
after the creation of a new connection. after the creation of a new connection. Retries should not be more
frequent than one every ACTIVE_LQ_IDLE_TIMEOUT. See Section 6.4.
Messages from the DHCPv6 server come as multiple responses to a Messages from the DHCPv6 server come as multiple responses to a
single ACTIVELEASEQUERY message. Thus, each ACTIVELEASEQUERY request single ACTIVELEASEQUERY message. Thus, each ACTIVELEASEQUERY request
MUST have an xid (transaction-id) unique on the connection on which MUST have a transaction-id unique on the connection on which it is
it is sent, and all of the messages which come as a response to it sent, and all of the messages that come as a response to it contain
contain the same xid as the request. It is the xid which allows the the same transaction-id as the request.
data-streams of two or more different ACTIVELEASEQUERY requests to be
de-multiplexed by the requestor.
8.2. Initiating a Connection 8.2. Initiating a Connection
A Requestor SHOULD be able to operate in either insecure or secure A requestor SHOULD be able to operate in either insecure or secure
mode. This MAY be a feature that is administratively controlled. mode. This MAY be a feature that is administratively controlled.
When operating in insecure mode, the requestor SHOULD proceed to send When operating in insecure mode, the requestor SHOULD proceed to send
an ACTIVELEASEQUERY message after the establishment of a TCP an ACTIVELEASEQUERY message after the establishment of a TCP
connection. connection.
When operating in secure mode, the requestor MUST attempt to When operating in secure mode, the requestor MUST attempt to
negotiate a TLS [RFC5246] connection over the TCP connection. If negotiate a TLS [RFC5246] connection over the TCP connection. If
this negotiation fails, the requestor MUST close the TCP connection. this negotiation fails, the requestor MUST close the TCP connection.
The recommendations in [RFC7525] SHOULD be followed when negotiating The recommendations in [RFC7525] SHOULD be followed when negotiating
skipping to change at page 14, line 34 skipping to change at page 15, line 8
the TCP connection. This message indicates to the DHCPv6 server that the TCP connection. This message indicates to the DHCPv6 server that
a TLS connection over this TCP connection is desired. There are four a TLS connection over this TCP connection is desired. There are four
possibilities after the requestor sends the STARTTLS message to the possibilities after the requestor sends the STARTTLS message to the
DHCPv6 server: DHCPv6 server:
1. No response from the DHCPv6 server. 1. No response from the DHCPv6 server.
2. The DHCPv6 server closes the TCP connection after it receives the 2. The DHCPv6 server closes the TCP connection after it receives the
STARTTLS message. STARTTLS message.
3. DHCPv6 server responds with REPLY [RFC3315] message with DHCPv6 3. The DHCPv6 server responds with a REPLY [RFC3315] message with a
status code of TLSConnectionRefused. DHCPv6 status code of TLSConnectionRefused.
4. DHCPv6 server responds with REPLY [RFC3315] message without 4. The DHCPv6 server responds with a REPLY [RFC3315] message without
DHCPv6 status code, indicating success. a DHCPv6 status code, indicating success.
In any of the first three possibilities, the DHCPv6 server can be In any of the first three possibilities, the DHCPv6 server can be
assumed to not support TLS. In this case, the requestor MUST close assumed to not support TLS. In this case, the requestor MUST close
the TCP connection. the TCP connection.
In the final possibility, where the DHCPv6 server has responded with In the final possibility, where the DHCPv6 server has responded with
a REPLY message without DHCPv6 status code in response to the a REPLY message without a DHCPv6 status code in response to the
requestor's STARTTLS message, the requestor SHOULD initiate the requestor's STARTTLS message, the requestor SHOULD initiate the
exchange of the messages involved in a TLS handshake [RFC5246]. exchange of the messages involved in a TLS handshake [RFC5246].
During the TLS handshake, the requestor MUST validate the DHCPv6 During the TLS handshake, the requestor MUST validate the DHCPv6
server's digital certificate. server's digital certificate.
If the handshake exchange yields a functioning TLS connection, then If the handshake exchange yields a functioning TLS connection, then
the requestor SHOULD transmit an ACTIVELEASEQUERY request over that the requestor SHOULD transmit an ACTIVELEASEQUERY request over that
TLS connection and use that TLS connection for all further TLS connection and use that TLS connection for all further
interactions in which it engages with the DHCPv6 server over this TCP interactions in which it engages with the DHCPv6 server over this TCP
connection. connection.
If the handshake exchange does not yield a functioning TLS If the handshake exchange does not yield a functioning TLS
connection, then the requestor MUST close the TCP connection. connection, then the requestor MUST close the TCP connection.
8.3. Forming an Active Leasequery 8.3. Forming an Active Leasequery
The Active Leasequery is designed to create a long lived connection Active Leasequery is designed to create a long-lived connection
between the requestor and the DHCPv6 server processing the active between the requestor and the DHCPv6 server processing the active
query. The DHCPv6 server SHOULD send binding information back across query. The DHCPv6 server SHOULD send binding information back across
this connection with minimal delay after it learns of the binding this connection with minimal delay after it learns of the binding
information. It learns about bindings either because it makes the information. It learns about bindings either because it makes the
bindings itself or because it has received information about a bindings itself or because it has received information about a
binding from another server. binding from another server.
An important capability of the Active Leasequery is the ability of An important capability of Active Leasequery is the ability of the
the requestor to specify that some recent data be sent immediately to requestor to specify that some recent data be sent immediately to the
the requestor in parallel with the transmission of the ongoing requestor in parallel with the transmission of the ongoing binding
binding information in more or less real time. This capability is information in more or less real time. This capability is used in
used in order to allow an Active Leasequery requestor to recover order to allow an Active Leasequery requestor to recover missed
missed information in the event that it temporarily loses information in the event that it temporarily loses connectivity with
connectivity with the DHCPv6 server processing a previous Active the DHCPv6 server processing a previous Active Leasequery.
Leasequery.
Note that until all of the recent data (catch-up data) has been
received, the requestor MUST NOT keep track of the base-time
(OPTION_LQ_BASE_TIME) received in Leasequery reply messages to use
later in a subsequent Active Leasequery request.
This capability is enabled by the transmission of an This capability is enabled by the transmission of an
OPTION_LQ_BASE_TIME option with each Leasequery reply sent as the OPTION_LQ_BASE_TIME option with each Leasequery reply sent as the
result of a previous Active Leasequery. The requestor SHOULD keep result of a previous Active Leasequery. The requestor SHOULD keep
track of the highest base-time received from a particular DHCPv6 track of the highest base-time received from a particular DHCPv6
server over an Active Leasequery connection, and in the event that server over an Active Leasequery connection, and in the event that
the requestor finds it necessary (for whatever reason) to reestablish the requestor finds it necessary (for whatever reason) to reestablish
an Active Leasequery connection to that DHCPv6 server, the requestor an Active Leasequery connection to that DHCPv6 server, the requestor
SHOULD place this highest base-time value into an SHOULD place this highest base-time value into an
OPTION_LQ_START_TIME option in the new Active Leasequery request. OPTION_LQ_START_TIME option in the new Active Leasequery request.
Note that until all of the recent data (catch-up data) has been
received, the requestor MUST NOT keep track of the base-time
(OPTION_LQ_BASE_TIME) received in Leasequery reply messages to use
later in a subsequent Active Leasequery request.
If the requestor doesn't wish to request an update of information If the requestor doesn't wish to request an update of information
missed when it was not connected to the DHCPv6 server, then it SHOULD missed when it was not connected to the DHCPv6 server, then it SHOULD
NOT include the OPTION_LQ_START_TIME option in the Active Leasequery NOT include the OPTION_LQ_START_TIME option in the Active Leasequery
request. request.
If the TCP connection becomes blocked or stops being writable while If the TCP connection becomes blocked or stops being writable while
the requestor is sending its query, the requestor SHOULD terminate the requestor is sending its query, the requestor SHOULD terminate
the connection after BULK_LQ_DATA_TIMEOUT. We make this the connection after BULK_LQ_DATA_TIMEOUT. We make this
recommendation to allow requestors to control the period of time they recommendation to allow requestors to control the period of time they
are willing to wait before abandoning a connection, independent of are willing to wait before abandoning a connection, independent of
notifications from the TCP implementations they may be using. notifications from the TCP implementations they may be using.
8.4. Processing Active Replies 8.4. Processing Active Replies
The Requestor attempts to read a DHCPv6 LEASEQUERY-REPLY message from The requestor attempts to read a DHCPv6 LEASEQUERY-REPLY message from
the TCP connection. If the stream of replies becomes blocked, the the TCP connection. If the stream of replies becomes blocked, the
Requestor SHOULD terminate the connection after requestor SHOULD terminate the connection after ACTIVE_LQ_RCV_TIMEOUT
ACTIVE_LQ_RCV_TIMEOUT, and MAY begin retry processing if configured and MAY begin retry processing if configured to do so.
to do so.
The requestor examines the LEASEQUERY-REPLY message, and determines The requestor examines the LEASEQUERY-REPLY message and determines
how to proceed. Message validation rules are specified in DHCPv6 how to proceed. Message validation rules are specified in DHCPv6
Leasequery [RFC5007] and DHCPv6 Bulk Leasequery [RFC5460]. If the Leasequery [RFC5007] and DHCPv6 Bulk Leasequery [RFC5460]. If the
reply contains an DHCPv6 status code (carried in an reply contains a DHCPv6 status code (carried in an OPTION_STATUS_CODE
OPTION_STATUS_CODE option), the requestor should follow the option), the requestor should follow the recommendations in
recommendations in [RFC5007]. [RFC5007].
Note that an Active Leasequery request specifically requests the Note that the connection resulting from accepting an Active
DHCPv6 server to create a long-lived connection which may not have Leasequery request may be long-lived and may not have data
data transferring continuously during its lifetime. Therefore the transferring continuously during its lifetime. Therefore, the DHCPv6
DHCPv6 server SHOULD send a LEASEQUERY-DATA message without binding server SHOULD send a LEASEQUERY-DATA message without binding data
data (OPTION_CLIENT_DATA) every ACTIVE_LQ_IDLE_TIMEOUT seconds (OPTION_CLIENT_DATA) every ACTIVE_LQ_IDLE_TIMEOUT seconds (default
(default 60) in order for the requestor to know that the connection 60) in order for the requestor to know that the connection remains
remains alive. This approach is followed only when connection is alive. This approach is followed only when connection is idle (i.e.,
idle (i.e., server has no binding data to send). During normal server has no binding data to send). During a normal exchange of
binding data exchange, receiving of LEASEQUERY-DATA message by binding data, receiving a LEASEQUERY-DATA message signifies that
requestor itself signifies that connection is active. Note that the connection is active. Note that the default for
default for ACTIVE_LQ_RCV_TIMEOUT is 120 seconds, twice the value of ACTIVE_LQ_RCV_TIMEOUT is 120 seconds, twice the value of the
the ACTIVE_LQ_IDLE_TIMEOUT's default of 60 seconds which drives the ACTIVE_LQ_IDLE_TIMEOUT's default of 60 seconds, which drives the
DHCPv6 server to send messages. Thus ACTIVE_LQ_RCV_TIMEOUT controls DHCPv6 server to send messages. Thus, ACTIVE_LQ_RCV_TIMEOUT controls
how sensitive the requestor is to be to delays by the DHCPv6 server how sensitive the requestor is to delays by the DHCPv6 server in
in sending updates or LEASEQUERY-DATA messages. sending updates or LEASEQUERY-DATA messages.
A single Active Leasequery can and usually will result in a large A single Active Leasequery can and usually will result in a large
number of replies. The Requestor MUST be prepared to receive more number of replies. The requestor MUST be prepared to receive more
than one reply with transaction-ids matching a single than one reply with transaction-ids matching a single
ACTIVELEASEQUERY message from a single DHCPv6 server. ACTIVELEASEQUERY message from a single DHCPv6 server.
An Active Leasequery has two regimes -- during the catch-up phase, if An Active Leasequery has two regimes: during the catch-up phase (if
any, and after any catch-up phase. If the Active Leasequery was any) and after any catch-up phase. If the Active Leasequery was
requested with an OPTION_LQ_START_TIME option, the Active Leasequery requested with an OPTION_LQ_START_TIME option, the Active Leasequery
starts out in the catch-up phase. See Section 8.4.1 for information starts out in the catch-up phase. See Section 8.4.1 for information
on processing during the catch-up phase, as well as how to determine on processing during the catch-up phase, as well as how to determine
when the catch-up phase is complete. when the catch-up phase is complete.
The updates sent by the DHCPv6 server during the catch-up phase are The updates sent by the DHCPv6 server during the catch-up phase are
not in the order that the lease state data was updated. Therefore, not in the order that the lease state data was updated. Therefore,
the OPTION_LQ_BASE_TIME option from messages during this phase MUST the OPTION_LQ_BASE_TIME option from messages during this phase MUST
NOT be saved and used to compute the subsequent ACTIVELEASEQUERY NOT be saved and used to compute the subsequent ACTIVELEASEQUERY
message's OPTION_LQ_START_TIME option. message's OPTION_LQ_START_TIME option.
skipping to change at page 17, line 23 skipping to change at page 17, line 41
After the catch-up phase, or during the entire series of messages After the catch-up phase, or during the entire series of messages
received as the response to an Active Leasequery request with no received as the response to an Active Leasequery request with no
OPTION_LQ_START_TIME (and therefore no catch-up phase), the OPTION_LQ_START_TIME (and therefore no catch-up phase), the
OPTION_LQ_BASE_TIME option of the most recent message SHOULD be saved OPTION_LQ_BASE_TIME option of the most recent message SHOULD be saved
as a record of the most recent time that data was received. This as a record of the most recent time that data was received. This
base-time (in the context of the DHCPv6 server) can be used in a base-time (in the context of the DHCPv6 server) can be used in a
subsequent Active Leasequery message's OPTION_LQ_START_TIME after a subsequent Active Leasequery message's OPTION_LQ_START_TIME after a
loss of the Active Leasequery connection. loss of the Active Leasequery connection.
The LEASEQUERY-DONE message MAY unilaterally terminate a successful The LEASEQUERY-DONE message MAY unilaterally terminate a successful
Active Leasequery request which is currently in progress in the event Active Leasequery request that is currently in progress in the event
that the DHCPv6 server determines that it cannot continue processing that the DHCPv6 server determines that it cannot continue processing
an ACTIVELEASEQUERY request. For example, when a server is requested an Active Leasequery request. For example, when a server is
to shut down it SHOULD send a LEASEQUERY-DONE message with a DHCPv6 requested to shut down, it SHOULD send a LEASEQUERY-DONE message with
status code of QueryTerminated and include OPTION_LQ_BASE_TIME option a DHCPv6 status code of QueryTerminated and include the
in the message. This SHOULD be the last message on that connection, OPTION_LQ_BASE_TIME option in the message. This MUST be the last
and once the message has been transmitted, the server SHOULD close message on that connection, and once the message has been
the connection. transmitted, the server MUST close the connection.
After receiving LEASEQUERY-DONE with a QueryTerminated status from a After receiving LEASEQUERY-DONE with a QueryTerminated status from a
server, the Requestor MAY close the TCP connection to that server. server, the requestor MAY close the TCP connection to that server.
8.4.1. Processing Replies from a Request Containing a 8.4.1. Processing Replies from a Request Containing an
OPTION_LQ_START_TIME OPTION_LQ_START_TIME
If the Active Leasequery was requested with an OPTION_LQ_START_TIME If the Active Leasequery was requested with an OPTION_LQ_START_TIME
option, the DHCPv6 server will attempt to send information about all option, the DHCPv6 server will attempt to send information about all
bindings that changed since the time specified in the bindings that changed since the time specified in the
OPTION_LQ_START_TIME. This is the catch-up phase of the Active OPTION_LQ_START_TIME. This is the catch-up phase of the Active
Leasequery processing. The DHCPv6 server MAY also begin immediate Leasequery processing. The DHCPv6 server MAY also send information
updates over the same connection of real-time binding information about real-time binding updates over the same connection. Thus, the
changes. Thus, the catch-up phase can run in parallel with the catch-up phase can run in parallel with the normal updates generated
normal updates generated by the Active Leasequery request. by the Active Leasequery request.
A DHCPv6 server MAY keep only a limited amount of time ordered A DHCPv6 server MAY keep only a limited amount of time-ordered
information available to respond to an Active Leasequery request information available to respond to an Active Leasequery request
containing an OPTION_LQ_START_TIME option. Thus, it is possible that containing an OPTION_LQ_START_TIME option. Thus, it is possible that
the time specified in the OPTION_LQ_START_TIME option represents a the time specified in the OPTION_LQ_START_TIME option represents a
time not covered by the time ordered information kept by the DHCPv6 time not covered by the time-ordered information kept by the DHCPv6
server. In such case, when there is not enough data saved in the server. In such case, when there is not enough data saved in the
DHCPv6 server to satisfy the request specified by the DHCPv6 server to satisfy the request specified by the
OPTION_LQ_START_TIME option, the DHCPv6 server will reply immediately OPTION_LQ_START_TIME option, the DHCPv6 server will reply immediately
with a LEASEQUERY-REPLY message with a DHCPv6 status code of with a LEASEQUERY-REPLY message with a DHCPv6 status code of
DataMissing with a base-time option equal to the server's current DataMissing with a base-time option equal to the server's current
time. This will signal the end of the catch-up phase, and the only time. This will signal the end of the catch-up phase, and the only
updates that will subsequently be received on this connection are the updates that will subsequently be received on this connection are the
real-time updates from the Active Leasequery request. real-time updates from the Active Leasequery request.
If there is enough data saved to satisfy the request, then If there is enough data saved to satisfy the request, then
LEASEQUERY-REPLY (with OPTION_STATUS_CODE of Success or reply without LEASEQUERY-REPLY (with OPTION_STATUS_CODE of Success or reply without
OPTION_STATUS_CODE option) and LEASEQUERY-DATA messages will begin the OPTION_STATUS_CODE option) and LEASEQUERY-DATA messages will
arrive from the DHCPv6 server. Some of these messages will be begin to arrive from the DHCPv6 server. Some of these messages will
related to the OPTION_LQ_START_TIME request and be part of the catch- be related to the OPTION_LQ_START_TIME request and be part of the
up phase. Some of these messages will be real-time updates of catch-up phase. Some of these messages will be real-time updates of
binding changes taking place in the DHCPv6 server. In general, there binding changes taking place in the DHCPv6 server. In general, there
is no way to determine the source of each message. is no way to determine the source of each message.
The updates sent by the DHCPv6 server during the catch-up phase are The updates sent by the DHCPv6 server during the catch-up phase are
not in the order that the binding data was updated. Therefore, until not in the order that the binding data was updated. Therefore, until
the catch-up phase is complete, the latest base-time value received the catch-up phase is complete, the latest base-time value received
from a DHCPv6 server processing an Active Leasequery request cannot from a DHCPv6 server processing an Active Leasequery request cannot
be reset from the incoming messages (and used in a subsequent Active be reset from the incoming messages (and used in a subsequent Active
Leasequery's query-start-time option), because to do so would Leasequery's query-start-time option), because to do so would
compromise the ability to recover lost information if the Active compromise the ability to recover lost information if the Active
Leasequery were to terminate prior to the completion of the catch-up Leasequery were to terminate prior to the completion of the catch-up
phase. phase.
The requestor will know that the catch-up phase is complete when the The requestor will know that the catch-up phase is complete when the
DHCPv6 server will transmit a LEASEQUERY-DATA message with the DHCPv6 DHCPv6 server transmits a LEASEQUERY-DATA message with the DHCPv6
status code of CatchUpComplete (or LEASEQUERY-REPLY message with a status code of CatchUpComplete (or a LEASEQUERY-REPLY message with a
DHCPv6 status code of DataMissing, as discussed above). Once this DHCPv6 status code of DataMissing, as discussed above). Once this
message is transmitted, all additional LEASEQUERY-DATA messages will message is transmitted, all additional LEASEQUERY-DATA messages will
relate to real-time ("new") binding changes in the DHCPv6 server. relate to real-time ("new") binding changes in the DHCPv6 server.
As discussed in Section 8.4, the requestor SHOULD keep track of the As discussed in Section 8.4, the requestor SHOULD keep track of the
latest base-time option value received over a particular connection, latest base-time option value received over a particular connection,
to be used in a subsequent Active Leasequery request -- but only if to be used in a subsequent Active Leasequery request, but only if the
the catch-up phase is complete. Prior to the completion of the catch-up phase is complete. Prior to the completion of the catch-up
catch-up phase, if the connection should go away or if the requestor phase, if the connection should go away or if the requestor receives
receives a LEASEQUERY-DONE message, then when it reconnects it MUST a LEASEQUERY-DONE message, then when it reconnects, it MUST use the
use the base-time value from the previous connection and not any base-time value from the previous connection and not any base-time
base-time value received from the recently closed connection. value received from the recently closed connection.
In the event that there was enough data available to the DHCPv6 In the event that there was enough data available to the DHCPv6
server to begin to satisfy the request implied by the server to begin to satisfy the request implied by the
OPTION_LQ_START_TIME option, but during the processing of that data OPTION_LQ_START_TIME option but during the processing of that data,
the server found that it was unable to continue (perhaps there was the server found that it was unable to continue (during transmission,
barely enough, the connection is very slow, and the aging algorithm the aging algorithm causes [some of] the saved data to become
causes the saved data to become unavailable) the DHCPv6 server will unavailable), the DHCPv6 server will terminate the catch-up phase of
terminate the catch-up phase of processing immediately by sending a processing immediately by sending a LEASEQUERY-DATA message with a
LEASEQUERY-DATA message with a DHCPv6 status code of DataMissing and DHCPv6 status code of DataMissing and with a base-time option of the
with a base-time option of the current time. current time.
The requestor MUST NOT assume that every individual state change of The requestor MUST NOT assume that every individual state change of
every binding during the period from the time specified in the every binding during the period from the time specified in the
OPTION_LQ_START_TIME and the present is replicated in an Active OPTION_LQ_START_TIME and the present is replicated in an Active
Leasequery reply message. The requestor MAY assume that at least one Leasequery reply message. The requestor MAY assume that at least one
Active Leasequery reply message will exist for every binding which Active Leasequery reply message will exist for every binding that had
had one or more changes of state during the period specified by the one or more changes of state during the period specified by the
OPTION_LQ_START_TIME and the current time. The last message for each OPTION_LQ_START_TIME and the current time. The last message for each
binding will contain the state at the current time, and there can be binding will contain the state at the current time, and there can be
one or more messages concerning a single binding during the catch-up one or more messages concerning a single binding during the catch-up
phase of processing. phase of processing.
Bindings can change multiple times while the requestor was not Bindings can change multiple times while the requestor is not
connected (that is, during the time from the OPTION_LQ_START_TIME and connected (that is, during the time from the OPTION_LQ_START_TIME to
the present). The requestor will only receive information about the the present). The requestor will only receive information about the
current state of the binding, not information about each state change current state of the binding, not information about each state change
that occurred during the period from the OPTION_LQ_START_TIME to the that occurred during the period from the OPTION_LQ_START_TIME to the
present. present.
If the LEASEQUERY-REPLY or LEASEQUERY-DATA message containing a If the LEASEQUERY-REPLY or LEASEQUERY-DATA message containing a
DHCPv6 status code of DataMissing is received and the requestor is DHCPv6 status code of DataMissing is received and the requestor is
interested in keeping its database up to date with respect to the interested in keeping its database up to date with respect to the
current state of bindings in the DHCPv6 server, then the requestor current state of bindings in the DHCPv6 server, then the requestor
SHOULD issue a Bulk Leasequery request to recover the information SHOULD issue a Bulk Leasequery request to recover the information
missing from its database. This Bulk Leasequery request SHOULD missing from its database. This Bulk Leasequery request SHOULD
include a OPTION_LQ_START_TIME option with the same value as the include an OPTION_LQ_START_TIME option with the same value as the
OPTION_LQ_START_TIME option previously included in the OPTION_LQ_START_TIME option previously included in the Active
ACTIVELEASEQUERY responses from the DHCPv6 server, and an Leasequery responses from the DHCPv6 server and an OPTION_LQ_END_TIME
OPTION_LQ_END_TIME option equal to the OPTION_LQ_BASE_TIME option option equal to the OPTION_LQ_BASE_TIME option returned by the DHCPv6
returned by the DHCPv6 server in the LEASEQUERY-REPLY or LEASEQUERY- server in the LEASEQUERY-REPLY or LEASEQUERY-DATA message with the
DATA message with the DHCPv6 status code of DataMissing. DHCPv6 status code of DataMissing.
Typically, the requestor would have one connection open to a DHCPv6 Typically, the requestor would have one connection open to a DHCPv6
server for an Active Leasequery request and possibly one additional server for an Active Leasequery request and possibly one additional
connection open for a Bulk Leasequery request to the same DHCPv6 connection open for a Bulk Leasequery request to the same DHCPv6
server to fill in the data that might have been missed prior to the server to fill in the data that might have been missed prior to the
initiation of the Active Leasequery. The Bulk Leasequery connection initiation of the Active Leasequery. The Bulk Leasequery connection
would typically run to completion and be closed, leaving one Active would typically run to completion and be closed, leaving one Active
Leasequery connection open to a single DHCPv6 server. Leasequery connection open to a single DHCPv6 server.
8.5. Processing Time Values in Leasequery messages 8.5. Processing Time Values in Leasequery Messages
Active or Bulk Leasequery requests can be made to a DHCPv6 server Active or Bulk Leasequery requests can be made to a DHCPv6 server
whose absolute time may not be synchronized with the local time of whose absolute time may not be synchronized with the local time of
the requestor. Thus, there are at least two time contexts in even the requestor. Thus, there are at least two time contexts in even
the simplest Active or Bulk Leasequery response. the simplest Active or Bulk Leasequery response.
If the requestor of an Active or Bulk Leasequery is saving the data If the requestor of an Active or Bulk Leasequery is saving the data
returned in some form, it has a requirement to store a variety of returned in some form, it has a requirement to store a variety of
time values, and some of these will be time in the context of the time values; some of these will be time in the context of the
requestor and some will be time in the context of the DHCPv6 server. requestor, and some will be time in the context of the DHCPv6 server.
When receiving an Active or Bulk Leasequery reply message from the When receiving an Active or Bulk Leasequery reply message from the
DHCPv6 server, the message will contain an OPTION_LQ_BASE_TIME DHCPv6 server, the message will contain an OPTION_LQ_BASE_TIME
option. The time contained in this OPTION_LQ_BASE_TIME option is in option. The time contained in this OPTION_LQ_BASE_TIME option is in
the context of the DHCPv6 server. As such, it is an ideal time to the context of the DHCPv6 server. As such, it is an ideal time to
save and use as input to an Active or Bulk Leasequery message in the save and use as input to an Active or Bulk Leasequery message in the
OPTION_LQ_START_TIME or OPTION_LQ_END_TIME option, should the OPTION_LQ_START_TIME or OPTION_LQ_END_TIME options should the
requestor need to ever issue an Active or Bulk Leasequery message requestor need to ever issue an Active or Bulk Leasequery message
using these option as part of a later query, since these option using these options as part of a later query, since these options
requires a time in the context of the DHCPv6 server. require a time in the context of the DHCPv6 server.
In addition to saving the OPTION_LQ_BASE_TIME for possible future use In addition to saving the OPTION_LQ_BASE_TIME for possible future use
in OPTION_LQ_START_TIME or OPTION_LQ_END_TIME option, the in the OPTION_LQ_START_TIME or OPTION_LQ_END_TIME options, the
OPTION_LQ_BASE_TIME is used as part of the conversion of the other OPTION_LQ_BASE_TIME option is used as part of the conversion of the
times in the Leasequery message to values which are meaningful in the other times in the Leasequery message to values that are meaningful
context of the requestor. in the context of the requestor.
In systems whose clocks are synchronized, perhaps using NTP, the In systems whose clocks are synchronized, perhaps using the Network
clock skew will usually be zero, which is not only acceptable, but Time Protocol (NTP), the clock skew will usually be zero, which is
desired. not only acceptable, but desired.
8.6. Examples 8.6. Examples
These examples illustrate what a series of queries and responses These examples illustrate what a series of queries and responses
might look like. These are only examples -- there are no requirement might look like. These are only examples -- there is no requirement
that these sequence must be followed. that these sequences must be followed.
8.6.1. Query Failure 8.6.1. Query Failure
This example illustrates the message flows in case DHCPv6 server This example illustrates the message flows in case the DHCPv6 server
identifies that it cannot accept and/or process Active Leasequery identifies that it cannot accept and/or process an Active Leasequery
request from the requestor. This could be because of various reasons request from the requestor. This could be because of various reasons
(i.e., UnknownQueryType, MalformedQuery, NotConfigured, NotAllowed, (i.e., UnknownQueryType, MalformedQuery, NotConfigured, NotAllowed,
NotSupported). and NotSupported).
Client Server Client Server
------ ------ ------ ------
ACTIVELEASEQUERY xid 1 -----> ACTIVELEASEQUERY xid 1 ----->
<----- LEASEQUERY-REPLY xid 1 (w/error) <----- LEASEQUERY-REPLY xid 1 (w/error)
8.6.2. Data Missing on Server 8.6.2. Data Missing on Server
This example illustrates the message flows in case DHCPv6 server This example illustrates the message flows in case the DHCPv6 server
identifies that it does not have enough data saved to satisfy the identifies that it does not have enough data saved to satisfy the
request specified by the OPTION_LQ_START_TIME option. request specified by the OPTION_LQ_START_TIME option.
In this case the DHCPv6 server will reply immediately with a In this case, the DHCPv6 server will reply immediately with a
LEASEQUERY-REPLY message with a DHCPv6 status code of DataMissing LEASEQUERY-REPLY message with a DHCPv6 status code of DataMissing
with a base-time option equal to the server's current time. This with a base-time option equal to the server's current time. This
will signal the end of the catch-up phase, and the only updates that will signal the end of the catch-up phase, and the only updates that
will subsequently be received on this connection are the real-time will subsequently be received on this connection are the real-time
updates from the Active Leasequery request. updates from the Active Leasequery request.
Client Server Client Server
------ ------ ------ ------
ACTIVELEASEQUERY xid 2 -----> ACTIVELEASEQUERY xid 2 ----->
<----- LEASEQUERY-REPLY xid 2 (w/error) <----- LEASEQUERY-REPLY xid 2 (w/error)
<----- LEASEQUERY-DATA xid 2 <----- LEASEQUERY-DATA xid 2
<----- LEASEQUERY-DATA xid 2 <----- LEASEQUERY-DATA xid 2
<----- LEASEQUERY-DATA xid 2 <----- LEASEQUERY-DATA xid 2
8.6.3. Successful Query 8.6.3. Successful Query
This example illustrates the message flows in case of successful This example illustrates the message flows in case of successful
query processing by DHCPv6 server. query processing by the DHCPv6 server.
In this case the DHCPv6 server will reply immediately with a In this case, the DHCPv6 server will reply immediately with a
LEASEQUERY-REPLY message (with OPTION_STATUS_CODE of Success or reply LEASEQUERY-REPLY message (with OPTION_STATUS_CODE of Success or reply
without OPTION_STATUS_CODE option), followed by binding data in without OPTION_STATUS_CODE option), followed by binding data in
LEASEQUERY-DATA messages. In case, DHCPv6 server wants to abort in- LEASEQUERY-DATA messages. In case the DHCPv6 server wants to abort
process request and terminate the connection due to some reason, it an in-process request and terminate the connection due to some
sends LEASEQUERY-DONE with error code present in OPTION_STATUS_CODE reason, it sends LEASEQUERY-DONE with an error code present in the
option. OPTION_STATUS_CODE option.
Client Server Client Server
------ ------ ------ ------
ACTIVELEASEQUERY xid 3 -----> ACTIVELEASEQUERY xid 3 ----->
<----- LEASEQUERY-REPLY xid 3 <----- LEASEQUERY-REPLY xid 3
<----- LEASEQUERY-DATA xid 3 <----- LEASEQUERY-DATA xid 3
<----- LEASEQUERY-DATA xid 3 <----- LEASEQUERY-DATA xid 3
<----- LEASEQUERY-DATA xid 3 <----- LEASEQUERY-DATA xid 3
<----- LEASEQUERY-DATA xid 3 <----- LEASEQUERY-DATA xid 3
<----- LEASEQUERY-DONE xid 3 (w/error) <----- LEASEQUERY-DONE xid 3 (w/error)
8.7. Closing Connections 8.7. Closing Connections
The Requestor or DHCPv6 Leasequery server MAY close its end of the The requestor or DHCPv6 Leasequery server MAY close its end of the
TCP connection at any time. The Requestor MAY choose to retain the TCP connection at any time. The requestor MAY choose to retain the
connection if it intends to issue additional queries. Note that this connection if it intends to issue additional queries. Note that this
requestor behavior does not guarantee that the connection will be requestor behavior does not guarantee that the connection will be
available for additional queries: the server might decide to close available for additional queries: the server might decide to close
the connection based on its own configuration. the connection based on its own configuration.
9. Server Behavior 9. Server Behavior
A DHCPv6 server which supports Active Leasequery MUST support DHCPv6 A DHCPv6 server that supports Active Leasequery MUST support DHCPv6
Bulk Leasequery [RFC5460] and as extended herein. Bulk Leasequery [RFC5460] along with the updates mentioned in this
document.
9.1. Accepting Connections 9.1. Accepting Connections
DHCPv6 servers that implement DHCPv6 Active Leasequery listen for DHCPv6 servers that implement DHCPv6 Active Leasequery listen for
incoming TCP connections. The approach used in accepting the incoming TCP connections. The approach used in accepting the
requestor's connection is same as specified in DHCPv6 Bulk Leasequery requestor's connection is the same as specified in DHCPv6 Bulk
[RFC5460], with the exception that support for Active Leasequery MUST Leasequery [RFC5460], with the exception that support for Active
NOT be enabled by default, and MUST require an explicit configuration Leasequery MUST NOT be enabled by default and MUST require an
step to be performed before it will operate. explicit configuration step to be performed before it will operate.
DHCPv6 servers SHOULD be able to operate in either insecure or secure DHCPv6 servers SHOULD be able to operate in either insecure or secure
mode. This MAY be a mode that is administratively controlled, where mode. This MAY be a mode that is administratively controlled, where
the server will require a TLS connection to operate or will only the server will require a TLS connection to operate or will only
operate without a TLS connection. In either case, operation in operate without a TLS connection. In either case, operation in
insecure mode MUST NOT be the default, even if operation in secure insecure mode MUST NOT be the default, even if operation in secure
mode is not supported. Operation in insecure mode MUST always mode is not supported. Operation in insecure mode MUST always
require an explicit configuration step, separate from the require an explicit configuration step, separate from the
configuration step required to enable support for Active Leasequery. configuration step required to enable support for Active Leasequery.
When operating in insecure mode, the DHCPv6 server simply waits for When operating in insecure mode, the DHCPv6 server simply waits for
the requestor to send the Active Leasequery request after the the requestor to send the Active Leasequery request after the
establishment of TCP connection. If it receives a STARTTLS message, establishment of a TCP connection. If it receives a STARTTLS
it MUST respond with REPLY [RFC3315] message with DHCPv6 status code message, it MUST respond with a REPLY [RFC3315] message with a DHCPv6
of TLSConnectionRefused. status code of TLSConnectionRefused.
When operating in secure mode, DHCPv6 servers MUST support TLS When operating in secure mode, DHCPv6 servers MUST support TLS
[RFC5246] to protect the integrity and privacy of the data [RFC5246] to protect the integrity and privacy of the data
transmitted over the TCP connection. When operating in secure mode, transmitted over the TCP connection. When operating in secure mode,
DHCPv6 servers MUST be configurable with regard to which requestors DHCPv6 servers MUST be configurable with regard to which requestors
they will communicate. The certificate presented by a requestor when they will communicate. The certificate presented by a requestor when
initiating the TLS connection is used to distinguish between initiating the TLS connection is used to distinguish between
acceptable and unacceptable requestors. acceptable and unacceptable requestors.
When operating in secure mode, DHCPv6 server MUST begin to negotiate When operating in secure mode, the DHCPv6 server MUST begin to
a TLS connection with a requestor who asks for one, and MUST close he negotiate a TLS connection with a requestor who asks for one and MUST
TCP connections which are not secured with TLS or for which the close the TCP connections that are not secured with TLS or for which
requestor's certificate is deemed unacceptable. The recommendations the requestor's certificate is deemed unacceptable. The
in [RFC7525] SHOULD be followed when negotiating a TLS connection. recommendations in [RFC7525] SHOULD be followed when negotiating a
TLS connection.
A requestor will request a TLS connection by sending a STARTTLS as A requestor will request a TLS connection by sending a STARTTLS as
the first message over a newly created TCP connection. If the DHCPv6 the first message over a newly created TCP connection. If the DHCPv6
server supports TLS connections and has not been configured to not server supports TLS connections and has not been configured to not
allow them on this link, the DHCPv6 server MUST respond to this allow them on this link, the DHCPv6 server MUST respond to this
STARTTLS message by sending a REPLY [RFC3315] message without DHCPv6 STARTTLS message by sending a REPLY [RFC3315] message without a
status code back to the requestor. This indicates to the requestor DHCPv6 status code back to the requestor. This indicates to the
that the DHCPv6 server will support the negotiation of a TLS requestor that the DHCPv6 server will support the negotiation of a
connection over this existing TCP connection. TLS connection over this existing TCP connection.
If for some reason the DHCPv6 server cannot or has been configured to If for some reason the DHCPv6 server cannot support a TLS connection
not support a TLS connection, then it SHOULD send a REPLY message or has been configured to not support a TLS connection, then it
with DHCPv6 status code of TLSConnectionRefused back to the SHOULD send a REPLY message with a DHCPv6 status code of
requestor. TLSConnectionRefused back to the requestor.
In the event that the DHCPv6 server sends a REPLY message without In the event that the DHCPv6 server sends a REPLY message without a
DHCPv6 status code option included (which indicates success), the DHCPv6 status code option included (which indicates success), the
requestor is supposed to initiate a TLS handshake [RFC5246] (see requestor is supposed to initiate a TLS handshake [RFC5246] (see
Section 8.2). During the TLS handshake, the DHCPv6 server MUST Section 8.2). During the TLS handshake, the DHCPv6 server MUST
validate the requestor's digital certificate. In addition, the validate the requestor's digital certificate. In addition, the
digital certificate presented by the requestor is used to decide if digital certificate presented by the requestor is used to decide if
this requestor is allowed to perform an Active Leasequery. If this this requestor is allowed to perform an Active Leasequery. If this
requestor's certificate is deemed unacceptable, the server MUST abort requestor's certificate is deemed unacceptable, the server MUST abort
the creation of the TLS connection. the creation of the TLS connection.
All TLS connections established between the a requestor and a DHCPv6 All TLS connections established between a requestor and a DHCPv6
server for the purposes of supporting Active Leasequery MUST be server for the purposes of supporting Active Leasequery MUST be
mutually authenticated. mutually authenticated.
If the TLS handshake is not successful in creating a TLS connection, If the TLS handshake is not successful in creating a TLS connection,
the server MUST close the TCP connection. the server MUST close the TCP connection.
9.2. Rejecting Connections 9.2. Rejecting Connections
Servers that do not implement DHCPv6 Active and Bulk Leasequery Servers that do not implement DHCPv6 Active and Bulk Leasequery
SHOULD NOT listen for incoming TCP connections for these requests. SHOULD NOT listen for incoming TCP connections for these requests.
If the DHCPv6 server supporting Bulk Leasequery and not Active If the DHCPv6 server supporting Bulk Leasequery and not Active
Leasequery receives an Active Leasequery request, it SHOULD send a Leasequery receives an Active Leasequery request, it SHOULD send a
LEASEQUERY-REPLY with DHCPv6 status code as NotSupported. It SHOULD LEASEQUERY-REPLY with a DHCPv6 status code of NotSupported. It
close the TCP connection after this error is signaled. SHOULD close the TCP connection after this error is signaled.
9.3. Replying to an Active Leasequery 9.3. Replying to an Active Leasequery
The DHCPv6 Leasequery [RFC5007] specification describes the initial The DHCPv6 Leasequery [RFC5007] specification describes the initial
construction of LEASEQUERY-REPLY messages. Use of the LEASEQUERY- construction of LEASEQUERY-REPLY messages. Use of the LEASEQUERY-
REPLY and LEASEQUERY-DATA messages to carry multiple bindings is REPLY and LEASEQUERY-DATA messages to carry multiple bindings is
described in DHCPv6 Bulk Leasequery [RFC5460]. Message transmission described in DHCPv6 Bulk Leasequery [RFC5460]. Message transmission
and framing for TCP is described in Section 6.1. and framing for TCP is described in Section 6.1.
If the connection becomes blocked while the server is attempting to If the connection becomes blocked while the server is attempting to
send reply messages, the server SHOULD terminate the TCP connection send reply messages, the server SHOULD terminate the TCP connection
after ACTIVE_LQ_SEND_TIMEOUT. This timeout governs for how long the after ACTIVE_LQ_SEND_TIMEOUT. This timeout governs for how long the
DHCPv6 server is prepared to wait for the requestor to read and DHCPv6 server is prepared to wait for the requestor to read and
process enough information to unblock the TCP connection. The process enough information to unblock the TCP connection. The
default is two minutes, which means that if more than two minutes default is two minutes, which means that if more than two minutes
goes by without the requestor reading enough information to unblock goes by without the requestor reading enough information to unblock
the TCP connection, the DHCPv6 server SHOULD close the TCP the TCP connection, the DHCPv6 server SHOULD close the TCP
connection. connection.
If the DHCPv6 server encounters an error during initial processing of If the DHCPv6 server encounters an error during the initial
the ACTIVELEASEQUERY message, it SHOULD send a LEASEQUERY-REPLY processing of the ACTIVELEASEQUERY message, it SHOULD send a
message containing an error code of some kind in a DHCPv6 status code LEASEQUERY-REPLY message containing an error code of some kind in a
option. It SHOULD close the connection after this error is signaled. DHCPv6 status code option. It SHOULD close the connection after this
error is signaled.
If the DHCPv6 server encounters an error during later processing of If the DHCPv6 server encounters an error during later processing of
the ACTIVELEASEQUERY message, it SHOULD send a LEASEQUERY-DONE the ACTIVELEASEQUERY message, it SHOULD send a LEASEQUERY-DONE
containing an error code of some kind in a DHCPv6 status code option. containing an error code of some kind in a DHCPv6 status code option.
It SHOULD close the connection after this error is signaled. It SHOULD close the connection after this error is signaled.
If the server finds any bindings satisfying a query, it SHOULD send If the server finds any bindings satisfying a query, it SHOULD send
each binding's data in a reply message. The first reply message is a each binding's data in a reply message. The first reply message is a
LEASEQUERY-REPLY. The binding data is carried in an LEASEQUERY-REPLY. The binding data is carried in an
OPTION_CLIENT_DATA option, as specified in [RFC5007]. The server OPTION_CLIENT_DATA option, as specified in [RFC5007]. The server
SHOULD send subsequent bindings in LEASEQUERY-DATA messages, which SHOULD send subsequent bindings in LEASEQUERY-DATA messages, which
can avoid redundant data (such as the requestor's Client-ID). can avoid redundant data (such as the requestor's Client-ID).
Every reply to an Active Leasequery request MUST contain the Every reply to an Active Leasequery request MUST contain the
information specified in replies to a DHCPv6 Bulk Leasequery request information specified in replies to a DHCPv6 Bulk Leasequery request
[RFC5460], with the exception that a server implementing Active [RFC5460], with the exception that a server implementing Active
Leasequery SHOULD be able to be configured to prevent specific data Leasequery SHOULD be able to be configured to prevent specific data
items from being sent to the requestor even if these data items were items from being sent to the requestor even if these data items were
requested in the OPITON_ORO option. requested in the OPTION_ORO option.
Some servers can be configured to respond to a DHCPv6 Leasequery Some servers can be configured to respond to a DHCPv6 Leasequery
[RFC5007] and DHCPv6 Bulk Leasequery [RFC5460] for an IPv6 binding [RFC5007] and DHCPv6 Bulk Leasequery [RFC5460] for an IPv6 binding
which is reserved in such a way that it appears that the IPv6 binding that is reserved in such a way that it appears that the IPv6 binding
is leased to the DHCP client for which it is reserved. These servers is leased to the DHCP client for which it is reserved. These servers
SHOULD also respond to an Active Leasequery request with the same SHOULD also respond to an Active Leasequery request with the same
information as they would to a Bulk Leasequery request when they information as they would to a Bulk Leasequery request when they
first determine that the IPv6 binding is reserved to a DHCP client. first determine that the IPv6 binding is reserved to a DHCP client.
If an Active Leasequery or Bulk Leasequery request contains If an Active Leasequery or Bulk Leasequery request contains the
OPTION_LQ_BASE_TIME option code present in OPTION_ORO, the DHCPv6 OPTION_LQ_BASE_TIME option code present in OPTION_ORO, the DHCPv6
server MUST include OPTION_LQ_BASE_TIME option in every reply for server MUST include the OPTION_LQ_BASE_TIME option in every reply for
this request. The value for base-time option is current absolute this request. The value for the base-time option is the current
time in the DHCPv6 server's context. absolute time in the DHCPv6 server's context.
If an Active Leasequery request contains an OPTION_LQ_START_TIME If an Active Leasequery request contains an OPTION_LQ_START_TIME
option, it indicates that the requestor would like the DHCPv6 server option, it indicates that the requestor would like the DHCPv6 server
to send it not only messages that correspond to DHCPv6 binding to send it not only messages that correspond to DHCPv6 binding
activity that occurs subsequent to the receipt of the Active activity that occurs subsequent to the receipt of the Active
Leasequery request, but also messages that correspond to DHCPv6 Leasequery request, but also messages that correspond to DHCPv6
binding activity that occurred prior to the Active Leasequery binding activity that occurred prior to the Active Leasequery
request. request.
If OPTION_LQ_END_TIME option appears in an Active Leasequery request, If the OPTION_LQ_END_TIME option appears in an Active Leasequery
the DHCPv6 server SHOULD send a LEASEQUERY-REPLY message with a request, the DHCPv6 server SHOULD send a LEASEQUERY-REPLY message
DHCPv6 status code of MalformedQuery and terminate the connection. with a DHCPv6 status code of MalformedQuery and terminate the
connection.
In order to implement a meaningful response to this query, the DHCPv6 In order to implement a meaningful response to this query, the DHCPv6
server MAY keep track of the binding activity and associate changes server MAY keep track of the binding activity and associate changes
with particular base-time values from the messages. Then, when with particular base-time values from the messages. Then, when
requested to do so by an Active Leasequery request containing a requested to do so by an Active Leasequery request containing a
OPTION_LQ_START_TIME option, the DHCPv6 server can respond with OPTION_LQ_START_TIME option, the DHCPv6 server can respond with
replies for all binding activity occurring on that replies for all binding activity occurring on that
OPTION_LQ_START_TIME or later times. OPTION_LQ_START_TIME or later times.
These replies based on the OPTION_LQ_START_TIME MAY be interleaved These replies based on the OPTION_LQ_START_TIME MAY be interleaved
skipping to change at page 26, line 6 skipping to change at page 26, line 14
Once the transmission of the DHCPv6 Leasequery messages associated Once the transmission of the DHCPv6 Leasequery messages associated
with the OPTION_LQ_START_TIME option are complete, a LEASEQUERY-DATA with the OPTION_LQ_START_TIME option are complete, a LEASEQUERY-DATA
message MUST be sent with a DHCPv6 status code value of message MUST be sent with a DHCPv6 status code value of
CatchUpComplete. CatchUpComplete.
The DHCPv6 server SHOULD, but is not required to, keep track of a The DHCPv6 server SHOULD, but is not required to, keep track of a
limited amount of previous binding activity. The DHCPv6 server MAY limited amount of previous binding activity. The DHCPv6 server MAY
choose to only do this in the event that it has received at least one choose to only do this in the event that it has received at least one
Active Leasequery request in the past, as to do so will almost Active Leasequery request in the past, as to do so will almost
certainly entail some utilization of resources which would be wasted certainly entail some utilization of resources that would be wasted
if there are no Active Leasequery requestors for this DHCPv6 server. if there are no Active Leasequery requestors for this DHCPv6 server.
The DHCPv6 server SHOULD make the amount of previous binding activity The DHCPv6 server SHOULD make the amount of previous binding activity
it retains configurable. There is no requirement on the DHCPv6 it retains configurable. There is no requirement on the DHCPv6
server to retain this information over a server restart (or even to server to retain this information over a server restart (or even to
retain such information at all). retain such information at all).
Unless there is an error or some requirement to cease processing a Unless there is an error or some requirement to cease processing a
Active Leasequery request yielding a LEASEQUERY-DONE message, such as Active Leasequery request yielding a LEASEQUERY-DONE message, such as
a server shutdown, there will be no LEASEQUERY-DONE message at the a server shutdown, there will be no LEASEQUERY-DONE message at the
conclusion of the Active Leasequery processing because that conclusion of the Active Leasequery processing because that
skipping to change at page 26, line 49 skipping to change at page 27, line 8
The server MUST close its end of the TCP connection if it encounters The server MUST close its end of the TCP connection if it encounters
an error sending data on the connection. The server MUST close its an error sending data on the connection. The server MUST close its
end of the TCP connection if it finds that it has to abort an in- end of the TCP connection if it finds that it has to abort an in-
process request. A server aborting an in-process request SHOULD process request. A server aborting an in-process request SHOULD
attempt to signal that to its requestors by using the QueryTerminated attempt to signal that to its requestors by using the QueryTerminated
status code in the DHCPv6 status code option in a LEASEQUERY-DONE status code in the DHCPv6 status code option in a LEASEQUERY-DONE
message. If the server detects that the requestor end has been message. If the server detects that the requestor end has been
closed, the server MUST close its end of the connection. closed, the server MUST close its end of the connection.
The server SHOULD limit the number of connections it maintains, and The server SHOULD limit the number of connections it maintains and
SHOULD close idle connections to enforce the limit. SHOULD close idle connections to enforce the limit.
10. Security Considerations 10. Security Considerations
The "Security Considerations" section of [RFC3315] details the The Security Considerations section of [RFC3315] details the general
general threats to DHCPv6. The DHCPv6 Leasequery specification threats to DHCPv6. The DHCPv6 Leasequery specification [RFC5007]
[RFC5007] describes recommendations for the Leasequery protocol, describes recommendations for the Leasequery protocol, especially
especially with regard to relayed Leasequery messages, mitigation of with regard to relayed Leasequery messages, mitigation of packet-
packet-flooding denial-of-service (DoS) attacks, restriction to flooding denial-of-service (DoS) attacks, restriction to trusted
trusted requestors, and use of IPsec [RFC4301]. requestors, and use of IPsec [RFC4301].
The use of TCP introduces some additional concerns. Attacks that The use of TCP introduces some additional concerns. Attacks that
attempt to exhaust the DHCPv6 server's available TCP connection attempt to exhaust the DHCPv6 server's available TCP connection
resources can compromise the ability of legitimate requestors to resources can compromise the ability of legitimate requestors to
receive service. Malicious requestors who succeed in establishing receive service. Malicious requestors who succeed in establishing
connections, but who then send invalid queries, partial queries, or connections but who then send invalid queries, partial queries, or no
no queries at all also can exhaust a server's pool of available queries at all can also exhaust a server's pool of available
connections. connections.
When operating in secure mode, TLS [RFC5246] is used to secure the When operating in secure mode, TLS [RFC5246] is used to secure the
connection. The recommendations in [RFC7525] SHOULD be followed when connection. The recommendations in [RFC7525] SHOULD be followed when
negotiating a TLS connection. negotiating a TLS connection.
Servers SHOULD offer configuration parameters to limit the sources of Servers SHOULD offer configuration parameters to limit the sources of
incoming connections through validation and use of the digital incoming connections through validation and use of the digital
certificates presented to create a TLS connection. They SHOULD also certificates presented to create a TLS connection. They SHOULD also
limit the number of accepted connections, and limit the period of limit the number of accepted connections and limit the period of time
time during which an idle connection will be left open. during which an idle connection will be left open.
The data acquired by using an Active Leasequery is subject to the The data acquired by using an Active Leasequery is subject to the
same potential abuse as the data held by the DHCPv6 server from which same potential abuse as the data held by the DHCPv6 server from which
it was acquired, and SHOULD be secured by mechanisms as strong as it was acquired and SHOULD be secured by mechanisms as strong as
those used for the data held by that DHCPv6 server. The data those used for the data held by that DHCPv6 server. The data
acquired by using an Active Leasequery SHOULD be deleted as soon as acquired by using an Active Leasequery SHOULD be deleted as soon as
possible after the use for which it was acquired has passed. possible after the use for which it was acquired has passed.
Authentication for DHCP Messages [RFC3315] MUST NOT be used to Authentication for DHCP messages [RFC3315] MUST NOT be used to
attempt to secure transmission of the messages described in this attempt to secure transmission of the messages described in this
document. document.
11. IANA Considerations 11. IANA Considerations
IANA is requested to assign new DHCPv6 Option Codes in the registry IANA has assigned new DHCPv6 option codes in the "Option Codes"
maintained in http://www.iana.org/assignments/dhcpv6-parameters: registry maintained at <http://www.iana.org/assignments/
dhcpv6-parameters>:
OPTION_LQ_BASE_TIME TBD-1
OPTION_LQ_START_TIME TBD-2
OPTION_LQ_END_TIME TBD-3
IANA is requested to assign new values in the registry of DHCPv6
Status Codes maintained in http://www.iana.org/assignments/
dhcpv6-parameters:
DataMissing OPTION_LQ_BASE_TIME (100)
CatchUpComplete OPTION_LQ_START_TIME (101)
NotSupported OPTION_LQ_END_TIME (102)
TLSConnectionRefused IANA has assigned new values in the DHCPv6 "Status Codes" registry
maintained at <http://www.iana.org/assignments/dhcpv6-parameters>:
IANA is requested to assign values for the following new DHCPv6 DataMissing (12)
Message types in the registry maintained in
http://www.iana.org/assignments/dhcpv6-parameters:
ACTIVELEASEQUERY CatchUpComplete (13)
STARTTLS NotSupported (14)
12. Acknowledgments TLSConnectionRefused (15)
Some of the concept and content, present in this document, are based IANA has assigned values for the following new DHCPv6 message types
on DHCPv4 Active Leasequery which was originally proposed by Kim in the "Message Types" registry maintained at
Kinnear, Bernie Volz, Mark Stapp and Neil Russell. <http://www.iana.org/assignments/dhcpv6-parameters>:
Useful review comments were provided by Scott Bradner, Francis ACTIVELEASEQUERY (22)
Dupont, and Stephen Farrell. The privacy protections were
substantially upgraded due to these comments and discussions.
13. Modification History STARTTLS (23)
14. References 12. References
14.1. Normative References 12.1. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997, DOI 10.17487/RFC2119, March 1997,
<http://www.rfc-editor.org/info/rfc2119>. <http://www.rfc-editor.org/info/rfc2119>.
[RFC3315] Droms, R., Ed., Bound, J., Volz, B., Lemon, T., Perkins, [RFC3315] Droms, R., Ed., Bound, J., Volz, B., Lemon, T., Perkins,
C., and M. Carney, "Dynamic Host Configuration Protocol C., and M. Carney, "Dynamic Host Configuration Protocol
for IPv6 (DHCPv6)", RFC 3315, DOI 10.17487/RFC3315, July for IPv6 (DHCPv6)", RFC 3315, DOI 10.17487/RFC3315, July
2003, <http://www.rfc-editor.org/info/rfc3315>. 2003, <http://www.rfc-editor.org/info/rfc3315>.
skipping to change at page 29, line 34 skipping to change at page 29, line 29
[RFC5460] Stapp, M., "DHCPv6 Bulk Leasequery", RFC 5460, [RFC5460] Stapp, M., "DHCPv6 Bulk Leasequery", RFC 5460,
DOI 10.17487/RFC5460, February 2009, DOI 10.17487/RFC5460, February 2009,
<http://www.rfc-editor.org/info/rfc5460>. <http://www.rfc-editor.org/info/rfc5460>.
[RFC7525] Sheffer, Y., Holz, R., and P. Saint-Andre, [RFC7525] Sheffer, Y., Holz, R., and P. Saint-Andre,
"Recommendations for Secure Use of Transport Layer "Recommendations for Secure Use of Transport Layer
Security (TLS) and Datagram Transport Layer Security Security (TLS) and Datagram Transport Layer Security
(DTLS)", BCP 195, RFC 7525, DOI 10.17487/RFC7525, May (DTLS)", BCP 195, RFC 7525, DOI 10.17487/RFC7525, May
2015, <http://www.rfc-editor.org/info/rfc7525>. 2015, <http://www.rfc-editor.org/info/rfc7525>.
14.2. Informative References 12.2. Informative References
[RFC4301] Kent, S. and K. Seo, "Security Architecture for the [RFC4301] Kent, S. and K. Seo, "Security Architecture for the
Internet Protocol", RFC 4301, DOI 10.17487/RFC4301, Internet Protocol", RFC 4301, DOI 10.17487/RFC4301,
December 2005, <http://www.rfc-editor.org/info/rfc4301>. December 2005, <http://www.rfc-editor.org/info/rfc4301>.
[RFC7414] Duke, M., Braden, R., Eddy, W., Blanton, E., and A. [RFC7414] Duke, M., Braden, R., Eddy, W., Blanton, E., and A.
Zimmermann, "A Roadmap for Transmission Control Protocol Zimmermann, "A Roadmap for Transmission Control Protocol
(TCP) Specification Documents", RFC 7414, (TCP) Specification Documents", RFC 7414,
DOI 10.17487/RFC7414, February 2015, DOI 10.17487/RFC7414, February 2015,
<http://www.rfc-editor.org/info/rfc7414>. <http://www.rfc-editor.org/info/rfc7414>.
Acknowledgments
Some of the concepts and content present in this document are based
on DHCPv4 Active Leasequery, which was originally proposed by Kim
Kinnear, Bernie Volz, Mark Stapp, and Neil Russell.
Useful review comments were provided by Scott Bradner, Francis
Dupont, and Stephen Farrell. The privacy protections were
substantially upgraded due to these comments and discussions.
Authors' Addresses Authors' Addresses
Dushyant Raghuvanshi Dushyant Raghuvanshi
Cisco Systems, Inc. Cisco Systems, Inc.
Cessna Business Park, Cessna Business Park
Varthur Hobli, Outer Ring Road, Varthur Hobli, Outer Ring Road
Bangalore, Karnataka 560037 Bangalore, Karnataka 560037
India India
Phone: +91 80 4426-7372 Phone: +91 80 4426-7372
Email: draghuva@cisco.com Email: draghuva@cisco.com
Kim Kinnear Kim Kinnear
Cisco Systems, Inc. Cisco Systems, Inc.
1414 Massachusetts Ave. 1414 Massachusetts Avenue
Boxborough, Massachusetts 01719 Boxborough, Massachusetts 01719
USA United States
Phone: +1 978 936-0000 Phone: +1 978 936-0000
Email: kkinnear@cisco.com Email: kkinnear@cisco.com
Deepak Kukrety Deepak Kukrety
Cisco Systems, Inc. Cisco Systems, Inc.
Cessna Business Park, Cessna Business Park
Varthur Hobli, Outer Ring Road, Varthur Hobli, Outer Ring Road
Bangalore, Karnataka 560037 Bangalore, Karnataka 560037
India India
Phone: +91 80 4426-7346 Phone: +91 80 4426-7346
Email: dkukrety@cisco.com Email: dkukrety@cisco.com
 End of changes. 160 change blocks. 
393 lines changed or deleted 393 lines changed or added

This html diff was produced by rfcdiff 1.42. The latest version is available from http://tools.ietf.org/tools/rfcdiff/