This section specifies two new RADIUS attributes for RADIUS clients and servers to exchange DHCP-encoded data. This data is then used to feed the DHCP procedure between a DHCP client and a DHCP server.
Both the DHCPv4-Options and DHCPv6-Options Attributes use the "Long Extended Type" format (
Section 2.2 of
RFC 6929). The description of the fields is provided in Sections [
3.1] and [
3.2].
These attributes use the "Long Extended Type" format in order to permit the transport of attributes encapsulating more than 253 octets of data. DHCP options that can be included in the RADIUS DHCP*-Options Attributes are limited by the maximum packet size of 4096 bytes (
Section 3 of
RFC 2865). In order to accommodate deployments with large DHCP options, RADIUS implementations are
RECOMMENDED to support a packet size up to 65535 bytes. Such a recommendation can be met if RADIUS implementations support a mechanism that relaxes the limit of 4096 bytes (e.g., the mechanisms described in [
RFC 7499] or [
RFC 7930]).
The Value fields of the DHCP*-Options Attributes are encoded in the clear and not encrypted like, for example, the Tunnel-Password Attribute [
RFC 2868].
RADIUS implementations may support a configuration parameter to control the DHCP options that can be included in a RADIUS DHCP*-Options Attribute. Likewise, DHCP server implementations may support a configuration parameter to control the permitted DHCP options in a RADIUS DHCP*-Options Attribute. Absent explicit configuration, RADIUS implementations and DHCP server implementations
SHOULD ignore non-permitted DHCP options received in a RADIUS DHCP*-Options Attribute.
RADIUS-supplied data is specific configuration data that is returned as a function of authentication and authorization checks. As such, absent any explicit configuration on the DHCP server, RADIUS-supplied data by means of the DHCP*-Options Attributes take precedence over any local configuration.
These attributes are defined with globally unique names. The naming of the attributes follows the guidelines in
Section 2.7.1 of
RFC 6929. Invalid attributes are handled as per
Section 2.8 of
RFC 6929.
This attribute is of type "string" as defined in
Section 3.5 of
RFC 8044.
The DHCPv6-Options Attribute
MAY appear in a RADIUS Access-Accept packet. It
MAY also appear in a RADIUS Access-Request packet as a hint to the RADIUS server to indicate a preference. However, the server is not required to honor such a preference.
The DHCPv6-Options Attribute
MAY appear in a RADIUS CoA-Request packet.
The DHCPv6-Options Attribute
MAY appear in a RADIUS Accounting-Request packet.
The DHCPv6-Options Attribute
MUST NOT appear in any other RADIUS packet.
The DHCPv6-Options Attribute is structured as follows:
-
Type
-
245
-
Length
-
This field indicates the total length, in octets, of all fields of this attribute, including the Type, Length, Extended-Type, and Value fields.
-
Extended-Type
-
3 (see Section 8.1)
-
Value
-
This field contains a list of DHCPv6 options (Section 21 of RFC 8415). Multiple instances of the same DHCPv6 option MAY be included. If an option appears multiple times, each instance is considered separate, and the data areas of the options MUST NOT be concatenated or otherwise combined. Consistent with Section 17 of RFC 7227, this document does not impose any option order when multiple options are present.
The permitted DHCPv6 options are listed in the "DHCPv6 Options Permitted in the RADIUS DHCPv6-Options Attribute" registry (Section 8.4.1).
The DHCPv6-Options Attribute is associated with the following identifier: 245.3.
This attribute is of type "string" as defined in
Section 3.5 of
RFC 8044.
The DHCPv4-Options Attribute
MAY appear in a RADIUS Access-Accept packet. It
MAY also appear in a RADIUS Access-Request packet as a hint to the RADIUS server to indicate a preference. However, the server is not required to honor such a preference.
The DHCPv4-Options Attribute
MAY appear in a RADIUS CoA-Request packet.
The DHCPv4-Options Attribute
MAY appear in a RADIUS Accounting-Request packet.
The DHCPv4-Options Attribute
MUST NOT appear in any other RADIUS packet.
The DHCPv4-Options Attribute is structured as follows:
-
Type
-
245
-
Length
-
This field indicates the total length, in octets, of all fields of this attribute, including the Type, Length, Extended-Type, and Value fields.
-
Extended-Type
-
4 (see Section 8.1)
-
Value
-
This field contains a list of DHCPv4 options. Multiple instances of the same DHCPv4 option MAY be included, especially for concatenation-requiring options that exceed the maximum DHCPv4 option size of 255 octets. The mechanism specified in [RFC 3396] MUST be used for splitting and concatenating the instances of a concatenation-requiring option.
The permitted DHCPv4 options are listed in the "DHCP Options Permitted in the RADIUS DHCPv4-Options Attribute" registry (Section 8.4.2).
The DHCPv4-Options Attribute is associated with the following identifier: 245.4.