rfc7839

Internet Engineering Task Force (IETF) S. Bhandari Request for Comments: 7839 S. Gundavelli Category: Standards Track M. Grayson ISSN: 2070-1721 B. Volz Cisco Systems J. Korhonen Broadcom Limited June 2016 Access-Network-Identifier Option in DHCP Abstract This document specifies the format and mechanism that is to be used for encoding Access-Network Identifiers in DHCPv4 and DHCPv6 messages by defining new Access-Network-Identifier options and sub-options. Status of This Memo This is an Internet Standards Track document. This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841. 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/rfc7839. Copyright Notice Copyright (c) 2016 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Motivation . . . . . . . . . . . . . . . . . . . . . . . . . 3 3. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. DHCPv4 Access-Network-Identifier Option . . . . . . . . . . . 5 4.1. DHCPv4 Access-Network-Identifier Sub-options . . . . . . 5 4.2. DHCPv4 Access-Technology-Type Sub-option . . . . . . . . 6 4.3. DHCPv4 Network-Identifier Sub-options . . . . . . . . . . 7 4.3.1. DHCPv4 Network-Name Sub-option . . . . . . . . . . . 7 4.3.2. DHCPv4 Access-Point-Name Sub-option . . . . . . . . . 8 4.3.3. DHCPv4 Access-Point-BSSID Sub-option . . . . . . . . 9 4.4. DHCPv4 Operator-Identifier Sub-options . . . . . . . . . 9 4.4.1. DHCPv4 Operator-Identifier Sub-option . . . . . . . . 9 4.4.2. DHCPv4 Operator-Realm Sub-option . . . . . . . . . . 10 5. DHCPv6 Access-Network-Identifier Options . . . . . . . . . . 10 5.1. DHCPv6 Access-Technology-Type Option . . . . . . . . . . 11 5.2. DHCPv6 Network-Identifier Options . . . . . . . . . . . . 11 5.2.1. DHCPv6 Network-Name Option . . . . . . . . . . . . . 12 5.2.2. DHCPv6 Access-Point-Name Option . . . . . . . . . . . 12 5.2.3. DHCPv6 Access-Point-BSSID Option . . . . . . . . . . 13 5.3. DHCPv6 Operator-Identifier Options . . . . . . . . . . . 13 5.3.1. DHCPv6 Operator-Identifier Option . . . . . . . . . . 13 5.3.2. DHCPv6 Operator-Realm Option . . . . . . . . . . . . 14 6. Relay Agent Behavior . . . . . . . . . . . . . . . . . . . . 14 7. Server Behavior . . . . . . . . . . . . . . . . . . . . . . . 15 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 16 9. Security Considerations . . . . . . . . . . . . . . . . . . . 17 10. References . . . . . . . . . . . . . . . . . . . . . . . . . 18 10.1. Normative References . . . . . . . . . . . . . . . . . . 18 10.2. Informative References . . . . . . . . . . . . . . . . . 18 Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 19 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 20 1. Introduction Access-network identification of a network device has a range of applications. For example, the Local Mobility Anchor (LMA) in a Proxy Mobile IPv6 (PMIPv6) domain is able to provide service treatment for the mobile node's traffic based on the access network to which the mobile node is attached. This document specifies the Dynamic Host Configuration Protocol for IPv4 (DHCPv4) [RFC2131] and the Dynamic Host Configuration Protocol for IPv6 (DHCPv6) [RFC3315] options for access-network identification that is added by the relay agent in the DHCPv4 or DHCPv6 messages sent towards the server. The scope of applicability for this option is between a DHCP relay agent and a mobile access gateway where the same operator typically operates both these functions A DHCP relay agent that is aware of the access network and access operator adds this information in the DHCP messages. This information can be used to provide differentiated services and policing of traffic based on the access network to which a client is attached. Examples of how this information can be used in mobile networks can be found in [RFC6757]. 2. Motivation PMIPv6 [RFC5213] can be used for supporting network-based mobility management in various types of network deployments. The network architectures, such as service provider Wi-Fi access aggregation or WLAN integrated mobile packet core, are examples where PMIPv6 is a component of the overall architecture. Some of these architectures require the ability of the LMA [RFC5213] to provide differentiated services and policing of traffic to the mobile nodes based on the access network to which they are attached. Policy systems in mobility architectures, such as Policy and Charging Control (PCC) [TS23203] and Access Network Discovery and Selection Function (ANDSF) [TS23402] in the 3GPP system, allow configuration of policy rules with conditions based on the access-network information. For example, the service treatment for the mobile node's traffic may be different when they are attached to an access network owned by the home operator than when owned by a roaming partner. In the case of access networks based on IEEE 802.11, the service treatment can also be different based on the configured Service Set Identifiers (SSIDs). Other examples of services include the operator's ability to apply tariff based on the location. The PMIPv6 extension as specified in [RFC6757] defines PMIPv6 options to carry Access-Network Identifiers in PMIPv6 signaling from the Mobile Access Gateway (MAG) to the LMA. The MAG can learn this information from the DHCP options as inserted by the DHCP relay agent in the access network. If the MAG relays the DHCP messages to the LMA as specified in [RFC5844], this information can be inserted by the MAG towards the LMA in the forwarded DHCP messages. Figure 1 illustrates an example of PMIPv6 deployment. In this example, the access network is based on IEEE 802.11 technology, the DHCP relay agent function is located on the Access Point (AP), and the DHCP server function is located on the MAG. The MAG delivers the information elements related to the access network to the LMA over PMIPv6 signaling messages. The MAG obtains these information elements from the DHCP relay agent as per this specification. The information elements related to the access network include the SSID of the used IEEE 802.11 network, the geo-location of the access network to which the mobile node is attached, and the identity of the operator running the IEEE 802.11 access-network infrastructure. SSID: IETF-1 Operator-Identifier: provider1.example +--+ |AP|-----------. {Access-Specific Policies) +--+ | (DHCP Server) _-----_ | (DHCP Relay) +-----+ _( )_ +-----+ | MAG |-=========( PMIPv6 )======-| LMA |- +-----+ (_ Tunnel_) +-----+ +--+ | '-----' |AP|-----------' +--+ (DHCP Relay) SSID: IETF-2 Operator-Identifier: provider2.example Access Networks Attached to MAG 3. Terminology The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]. All the DHCP-related terms used in this document are to be interpreted as defined in DHCPv4 [RFC2131] and DHCPv6 [RFC3315] specifications. "DHCP message" refers to both DHCPv4 and DHCPv6 messages throughout this document. All the mobility-related terms used in this document are to be interpreted as defined in the PMIPv6 specifications [RFC5213] and [RFC5844]. Additionally, this document uses the following abbreviations: Service Set Identifier (SSID) The Service Set Identifier (SSID) identifies the name of the IEEE 802.11 network. The SSID differentiates from one network to the other. Operator-Identifier The Operator-Identifier is the Structure of Management Information (SMI) Network Management Private Enterprise Code of the IANA- maintained "Private Enterprise Numbers" registry [SMI]. It identifies the operator running the access network where the client is attached. 4. DHCPv4 Access-Network-Identifier Option The Access-Network Identifier (ANI) carries information related to the identity of the access network to which the client is attached. This information includes access-technology type, network identifier, and access network operator identifiers. Relay agents that include ANI information include one or more sub- options (see Section 4.1) in the Relay Agent Information option [RFC3046]. 4.1. DHCPv4 Access-Network-Identifier Sub-options The Access-Network-Identifier information will be defined in multiple sub-options allocated from the "DHCP Relay Agent Sub-Option Codes" registry. ANI Sub-options: The ANI sub-options consist of a sequence of Sub- Option Code, Length, and Value tuples for each sub-option, encoded in the following manner: Subopt Len Sub-option Data +------+------+------+------+------+------+--...-+------+ | code | N | s1 | s2 | s3 | s4 | | sN | +------+------+------+------+------+------+--...-+------+ Subopt code The 1-octet code for the sub-options defined in the following sections. Len An unsigned 8-bit integer giving the length of the Sub-option Data field in this sub-option in octets. Sub-option Data (s1 to sN) The data area for the sub-option. The initial assignment of the DHCP Access-Network-Identifier sub- options is as follows: +=================+=======================================+ | SUB-OPTION CODE | SUB-OPTION DESCRIPTION | +=================+=======================================+ | 13 | Access-Technology-Type Sub-option | +=========================================================+ | 14 | Access-Network-Name Sub-option | +=========================================================+ | 15 | Access-Point-Name Sub-option | +=========================================================+ | 16 | Access-Point-BSSID Sub-option | +=========================================================+ | 17 | Operator-Identifier Sub-option | +=========================================================+ | 18 | Operator-Realm Sub-option | +=========================================================+ 4.2. DHCPv4 Access-Technology-Type Sub-option This sub-option is used for exchanging the type of the access technology of the network to which the client is attached. Its format is as follows: 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Subopt Code | Length | Reserved | ATT | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Subopt Code 13 Length 2 Reserved An 8-bit field that is unused for now. The value MUST be initialized to 0 by the sender and MUST be ignored by the receiver. Access-Technology-Type (ATT) An 8-bit field that specifies the access technology through which the client is connected to the access link from the IANA name space "Access Technology Type Option type values" registry defined in [RFC5213]. 4.3. DHCPv4 Network-Identifier Sub-options These sub-options are used for carrying the name of the access network (e.g., an SSID in the case of an IEEE 802.11 access network or a Public Land-based Mobile Network (PLMN) Identifier [TS23003] in the case of a 3GPP access network) and the Access-Point Name to which the client is attached. The format of these sub-options is defined in the following sections. The Network-Identifier sub-options are only for the currently known access-technology types. 4.3.1. DHCPv4 Network-Name Sub-option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Subopt Code | Length | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | . . . Network-Name (e.g., SSID or PLMNID) . . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Subopt Code 14 Length The length of the Network-Name field. Network-Name The name of the access network to which the mobile node is attached. The encoding MUST be UTF-8 as described in [RFC3629]. The type of the Network-Name is dependent on the access technology to which the mobile node is attached. For networks based on IEEE 802.11, the Network-Name will be the SSID of the network. For 3GPP access-based networks, it is the PLMN Identifier of the access network, and for 3GPP2 access, the Network-Name is the ANI [ANI]. When encoding the PLMN Identifier, both the Mobile Network Code (MNC) [TS23003] and Mobile Country Code (MCC) [TS23003] MUST be three digits. If the MNC in use only has two digits, then it MUST be preceded with a '0'. 4.3.2. DHCPv4 Access-Point-Name Sub-option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Subopt Code | Length | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | . . . Access-Point-Name . . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Subopt Code 15 Length The length of the Access-Point-Name field. Access-Point-Name The name of the access point (physical device name) to which the mobile node is attached. This is the identifier that uniquely identifies the access point. While the Network-Name (e.g., SSID) identifies the operator's access network, the Access-Point-Name identifies a specific network device in the network to which the mobile node is attached. In some deployments, the Access-Point- Name can be set to the string representation of the Media Access Control (MAC) address of the device as specified in [RFC6991] (see mac-address typedef) or some unique identifier that can be used by the policy systems in the operator network to unambiguously identify the device. The encoding MUST be UTF-8 as described in [RFC3629]. 4.3.3. DHCPv4 Access-Point-BSSID Sub-option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Subopt Code | Length | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | Access-Point-BSSID | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Subopt Code 16 Length 6 Access-Point-BSSID The 48-bit Basic SSSID (BSSID) of the access point to which the mobile node is attached. 4.4. DHCPv4 Operator-Identifier Sub-options The Operator-Identifier sub-options can be used for carrying the Operator-Identifiers of the access network to which the client is attached. The format of these sub-options is defined below. 4.4.1. DHCPv4 Operator-Identifier Sub-option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Subopt Code | Length | . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ . Operator-Identifier | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Subopt Code 17 Length 4 Operator-Identifier The Operator-Identifier is a 32-bit Private Enterprise Number (PEN) [SMI] encoded in a network byte order. Please refer

EID 7016 (Verified) is as follows:

Section: 4.4.1

Original Text:

   Length
      4

   Operator-Identifier
      The Operator-Identifier is a variable-length Private Enterprise
      Number (PEN) ...

Corrected Text:

   Length
      4

   Operator-Identifier
      The Operator-Identifier is a 32-bit Private Enterprise
      Number (PEN) ...

Notes:
Either the length is 4, and the contents are 32-bits. Or the length is >1, and the length is variable.

My guess is that the intention is to have a fixed length. The variable-length encoding from RFC 6757 is likely not needed here.

*** verifier note ***
See Bernie Volz's reply in https://mailarchive.ietf.org/arch/msg/dhcwg/Y4yaYwaqxS0B2nWw5f4xER2fSMk/

to Section 3.1.3 of [RFC6757] for additional details. 4.4.2. DHCPv4 Operator-Realm Sub-option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Subopt Code | Length | | |-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | . . . Operator-Realm . . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Subopt Code 18 Length The length of the Operator-Realm field. Operator-Realm Realm of the operator (e.g., EXAMPLE.COM). Please refer to Section 3.1.3 of [RFC6757] for additional details. 5. DHCPv6 Access-Network-Identifier Options The Access-Network-Identifier options defined here may be added by the DHCPv6 relay agent in Relay-forward messages. +=================+=======================================+ | OPTION CODE | OPTION DESCRIPTION | +=================+=======================================+ | 105 | OPTION_ANI_ATT | +=========================================================+ | 106 | OPTION_ANI_NETWORK_NAME | +=========================================================+ | 107 | OPTION_ANI_AP_NAME | +=========================================================+ | 108 | OPTION_ANI_AP_BSSID | +=========================================================+ | 109 | OPTION_ANI_OPERATOR_ID | +=========================================================+ | 110 | OPTION_ANI_OPERATOR_REALM | +=========================================================+ 5.1. DHCPv6 Access-Technology-Type Option This option is used for exchanging the type of access technology the client uses to attach to the network. Its format is as follows: 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | OPTION_ANI_ATT | Option-Len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Reserved | ATT | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Option-Code OPTION_ANI_ATT (105) Option-Len 2 Reserved An 8-bit field that is unused for now. The value MUST be initialized to 0 by the sender and MUST be ignored by the receiver. Access-Technology-Type (ATT): The contents of this field are the same as the ATT field described in Section 4.2. 5.2. DHCPv6 Network-Identifier Options These options can be used for carrying the name of the access network (e.g., an SSID in the case of an IEEE 802.11 access network or a PLMN Identifier [TS23003] in the case of a 3GPP access network) and an Access-Point Name to which the client is attached. The format of these options is defined below. 5.2.1. DHCPv6 Network-Name Option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | OPTION_ANI_NETWORK_NAME | Option-Len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ . . . Network-Name (e.g., SSID or PLMNID) . . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Option-Code OPTION_ANI_NETWORK_NAME (106) Option-Len The length of the Network-Name field. Network-Name The contents of this field are the same as the Network-Name field described in Section 4.3.1. 5.2.2. DHCPv6 Access-Point-Name Option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | OPTION_ANI_AP_NAME | Option-Len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ . . . Access-Point-Name . . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Option-Code OPTION_ANI_AP_NAME (107) Option-Len The length of the Access-Point-Name field. Access-Point-Name The contents of this field are the same as the Access-Point-Name field described in Section 4.3.2. 5.2.3. DHCPv6 Access-Point-BSSID Option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | OPTION_ANI_AP_BSSID | Option-Len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Access-Point-BSSID | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Option-Code OPTION_ANI_AP_BSSID (108) Option-Len 6 Access-Point-BSSID The contents of this field are the same as the Access-Point-BSSID field described in Section 4.3.3. 5.3. DHCPv6 Operator-Identifier Options The Operator-Identifier options can be used for carrying the Operator-Identifier of the access network to which the client is attached. The format of these options is defined below. 5.3.1. DHCPv6 Operator-Identifier Option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | OPTION_ANI_OPERATOR_ID | Option-Len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Operator-Identifier | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Option-Code OPTION_ANI_OPERATOR_ID (109) Option-Len 4 Operator-Identifier The contents of this field are the same as the DHCPv4 Operator- Identifier Sub-option field described in Section 4.4.1. 5.3.2. DHCPv6 Operator-Realm Option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | OPTION_ANI_OPERATOR_REALM | Option-Len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ . . . Operator-Realm . . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Option-Code OPTION_ANI_OPERATOR_REALM (110) Option-Len The length of the Operator-Realm field. Operator-Realm The contents of this field are the same as the Operator-Realm field described in Section 4.4.2. 6. Relay Agent Behavior DHCPv4 relay agents MAY include sub-options as defined in Section 4.2 through 4.4 of [RFC3046] in the Relay Agent Information option for providing information about the access network over which DHCP messages from the client are received. The DHCPv4 relay agent MUST include the DHCPv4 Access-Technology-Type Sub-option (Section 4.2) when including any of these sub-options in the DHCP message: DHCPv4 Network-Name Sub-option (Section 4.3.1), DHCPv4 Access-Point-Name Sub-option (Section 4.3.2), and DHCPv4 Access-Point-BSSID Sub-option (Section 4.3.3). DHCPv6 Relay Agents MAY include options (defined in Section 5) in the Relay-forward message when forwarding any DHCPv6 message type from clients to the servers to provide information about the access network over which DHCPv6 messages from the client are received. The DHCPv6 relay agent MUST include the DHCPv6 Access-Technology-Type Option (Section 5.1) when including any of these options in the DHCP message: DHCPv6 Network-Name Option (Section 5.2.1), DHCPv6 Access- Point-Name Option (Section 5.2.2), and DHCPv6 Access-Point-BSSID Option (Section 5.2.3). 7. Server Behavior The DHCPv4 base specification [RFC2131] requires that the DHCPv4 server ignore the DHCPv4 Access-Network-Identifier Option if it does not understand the option. If the DHCPv4 server does not understand the received sub-option defined in Sections 4.1 through 4.4 of [RFC3046], the DHCPv4 Relay- Agent-Information Option, it MUST ignore those sub-options only. If the DHCPv4 server is able to process the DHCPv4 Access-Network- Identifier sub-options defined in Sections 4.1 through 4.4 of [RFC3046], the DHCPv4 Relay-Agent-Information Option, it MAY use this information obtained from the sub-option for address pool selection or for policy decisions as per its configured policy. This information obtained from the sub-option SHOULD NOT be stored unless it is absolutely needed. However, if it is stored, the information MUST be deleted as quickly as possible to eliminate any possibility of the information getting exposed to an intruder. The DHCPv4 server MUST ignore the received DHCPv4 Access-Network- Identifier Option and process the rest of the message as per the base DHCPv4 specifications if the received DHCPv4 message does not include the DHCPv4 Access-Technology-Type Sub-option (Section 4.2) but does include any one of these other options: DHCPv4 Network Name Sub- option (Section 4.3.1), DHCPv4 Access-Point-Name Sub-option (Section 4.3.2), or DHCPv4 Access-Point-BSSID Sub-option (Section 4.3.3). DHCPv6 base specification [RFC3315] requires that the DHCPv6 server ignore the DHCPv6 Access-Network-Identifier Option if it does not understand the option. If the DHCPv6 server receives the options defined in Section 5 and is configured to use the options defined in Section 5, it SHOULD look for the DHCPv6 Access-Network-Identifier options in the Relay-forward message of the DHCPv6 relay agent(s) based on its configured policy. The server MAY use received ANI options for its address pool selection policy decisions as per its configured policy. This information obtained from the options SHOULD NOT be stored unless it is absolutely needed. However, if it is stored, the information MUST be deleted as quickly as possible to eliminate any possibility of the information getting exposed to an intruder. The DHCPv6 server MUST ignore the received DHCPv6 Access-Network- Identifier Option and process the rest of the message as per the base DHCPv6 specifications if the received DHCPv6 message does not include the DHCPv6 Access-Technology-Type Option (Section 5.1) but it does includes any one of these other options: DHCPv6 Network-Name Option (Section 5.2.1), DHCPv6 Access-Point-Name Option (Section 5.2.2), or DHCPv6 Access-Point-BSSID Option (Section 5.2.3). 8. IANA Considerations IANA has assigned sub-option codes for the following DHCPv4 sub- options from the "DHCP Relay Agent Sub-Option Codes" registry, <http://www.iana.org/assignments/bootp-dhcp-parameters>: +=================+=======================================+ | SUB-OPTION CODE | SUB-OPTION DESCRIPTION | +=================+=======================================+ | 13 | Access-Technology-Type Sub-option | +=========================================================+ | 14 | Access-Network-Name Sub-option | +=========================================================+ | 15 | Access-Point-Name Sub-option | +=========================================================+ | 16 | Access-Point-BSSID Sub-option | +=========================================================+ | 17 | Operator-Identifier Sub-option | +=========================================================+ | 18 | Operator-Realm Sub-option | +=========================================================+ IANA has assigned option codes for the following DHCPv6 options from the "Option Codes" registry for DHCPv6, <http://www.iana.org/assignments/dhcpv6-parameters>, as specified in [RFC3315]: +=================+=======================================+ | OPTION CODE | OPTION DESCRIPTION | +=================+=======================================+ | 105 | OPTION_ANI_ATT | +=========================================================+ | 106 | OPTION_ANI_NETWORK_NAME | +=========================================================+ | 107 | OPTION_ANI_AP_NAME | +=========================================================+ | 108 | OPTION_ANI_AP_BSSID | +=========================================================+ | 109 | OPTION_ANI_OPERATOR_ID | +=========================================================+ | 110 | OPTION_ANI_OPERATOR_REALM | +=========================================================+ 9. Security Considerations Since there is no privacy protection for DHCP messages, an eavesdropper who can monitor the link between the DHCP server and relay agent can discover access-network information. [RFC3118] and [RFC3315] describe many of the threats in using DHCP. [RFC3118] and [RFC3315] each provide a solution; the Authentication Option for DHCPv4 and DHCPv6 (respectively). However, neither of these options are in active use and therefore are not a viable mitigation option. DHCP itself is inherently insecure and thus link- layer confidentiality and integrity protection SHOULD be employed to reduce the risk of disclosure and tampering. It is possible for a rogue DHCP relay agent to insert or overwrite with incorrect Access-Network-Identifier options for malicious purposes. A DHCP client can also pose as a rogue DHCP relay agent by sending incorrect Access-Network-Identifier options. While the introduction of fraudulent DHCP relay agent information options can be prevented by a perimeter defense that blocks these options unless the DHCP relay agent is trusted, a deeper defense using the authentication sub-option for the DHCPv4 Relay-Agent-Information Option [RFC4030] SHOULD be deployed as well. Administrators SHOULD configure DHCP servers that use this option to communicate with their relay agents using IPsec, as described in Section 21.1 of [RFC3315]. The information elements that this document is exposing are the client's access-network information. These pertain to the access network to which the client is attached, such as Access-Technology Type (e.g., WLAN, Ethernet, etc.), Access-Point Identity (Name, BSSID), and Operator-Identifier and Operator-Realm. In deployments where this information cannot be secured using IPsec [RFC4301] or other security protocols, administrators SHOULD disable the capability specified in this document on the DHCP entities. 10. References 10.1. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, <http://www.rfc-editor.org/info/rfc2119>. [RFC2131] Droms, R., "Dynamic Host Configuration Protocol", RFC 2131, DOI 10.17487/RFC2131, March 1997, <http://www.rfc-editor.org/info/rfc2131>. [RFC3046] Patrick, M., "DHCP Relay Agent Information Option", RFC 3046, DOI 10.17487/RFC3046, January 2001, <http://www.rfc-editor.org/info/rfc3046>. [RFC3315] Droms, R., Ed., Bound, J., Volz, B., Lemon, T., Perkins, C., and M. Carney, "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)", RFC 3315, DOI 10.17487/RFC3315, July 2003, <http://www.rfc-editor.org/info/rfc3315>. 10.2. Informative References [ANI] "Interoperability Specification (IOS) for High Rate Packet Data (HRPD) Radio Access Network Interfaces with Session Control in the Access Network", 3GPP2 A.S0008-C v4.0, April 2011. [RFC3118] Droms, R., Ed. and W. Arbaugh, Ed., "Authentication for DHCP Messages", RFC 3118, DOI 10.17487/RFC3118, June 2001, <http://www.rfc-editor.org/info/rfc3118>. [RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO 10646", STD 63, RFC 3629, DOI 10.17487/RFC3629, November 2003, <http://www.rfc-editor.org/info/rfc3629>. [RFC4030] Stapp, M. and T. Lemon, "The Authentication Suboption for the Dynamic Host Configuration Protocol (DHCP) Relay Agent Option", RFC 4030, DOI 10.17487/RFC4030, March 2005, <http://www.rfc-editor.org/info/rfc4030>. [RFC4301] Kent, S. and K. Seo, "Security Architecture for the Internet Protocol", RFC 4301, DOI 10.17487/RFC4301, December 2005, <http://www.rfc-editor.org/info/rfc4301>. [RFC5213] Gundavelli, S., Ed., Leung, K., Devarapalli, V., Chowdhury, K., and B. Patil, "Proxy Mobile IPv6", RFC 5213, DOI 10.17487/RFC5213, August 2008, <http://www.rfc-editor.org/info/rfc5213>. [RFC5844] Wakikawa, R. and S. Gundavelli, "IPv4 Support for Proxy Mobile IPv6", RFC 5844, DOI 10.17487/RFC5844, May 2010, <http://www.rfc-editor.org/info/rfc5844>. [RFC6757] Gundavelli, S., Ed., Korhonen, J., Ed., Grayson, M., Leung, K., and R. Pazhyannur, "Access Network Identifier (ANI) Option for Proxy Mobile IPv6", RFC 6757, DOI 10.17487/RFC6757, October 2012, <http://www.rfc-editor.org/info/rfc6757>. [RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC 6991, DOI 10.17487/RFC6991, July 2013, <http://www.rfc-editor.org/info/rfc6991>. [SMI] IANA, "PRIVATE ENTERPRISE NUMBERS, SMI Network Management Private Enterprise Codes", March 2016, <https://www.iana.org/assignments/enterprise-numbers>. [TS23003] 3GPP, "Numbering, addressing and identification", 3GPP TS 23.003 13.4.0, December 2015. [TS23203] 3GPP, "Policy and charging control architecture", 3GPP TS 23.203 13.6.0, December 2015. [TS23402] 3GPP, "Architecture enhancements for non-3GPP accesses", 3GPP TS 23.402 13.4.0, December 2015. Acknowledgements The authors would like to thank Kim Kinnear, Ted Lemon, Gaurav Halwasia, Hidetoshi Yokota, Sheng Jiang, and Francis Dupont for their valuable input. Also, thank you to Tomek Mrugalski for a thorough review of the document. Authors' Addresses Shwetha Bhandari Cisco Systems Cessna Business Park, Sarjapura Marathalli Outer Ring Road Bangalore, KARNATAKA 560 087 India Phone: +91 80 4426 0474 Email: shwethab@cisco.com Sri Gundavelli Cisco Systems 170 West Tasman Drive San Jose, CA 95134 United States Email: sgundave@cisco.com Mark Grayson Cisco Systems 11 New Square Park Bedfont Lakes, FELTHAM TW14 8HA England Email: mgrayson@cisco.com Bernie Volz Cisco Systems 1414 Massachusetts Ave Boxborough, MA 01719 United States Email: volz@cisco.com Jouni Korhonen Broadcom Limited 3151 Zanker Rd San Jose, CA 95134 United States Email: jouni.nospam@gmail.com