Dynamic Host Configuration S. Piriyath Internet-Draft Nile Global, Inc. Intended status: Standards Track 12 November 2026 Expires: 16 May 2027 DHCP and DHCPv6 Options for an AI Gateway URI draft-spiriyath-dhc-ai-gateway-uri-00 Abstract This document specifies a DHCPv4 option and a DHCPv6 option that carry the HTTPS URI of an AI gateway descriptor. The descriptor is a Provisioning Domain Additional Information document. It identifies a forward proxy and the destinations for which that proxy is to be used. The DHCP options do not carry proxy credentials, model identifiers, or a Proxy Auto-Configuration script. Discussion Venues This note is to be removed before publishing as an RFC. This is an individual submission. It has not been adopted by the Dynamic Host Configuration (DHC) Working Group. Discussion of this document is directed to the author. Status of This Memo This Internet-Draft is submitted in full conformance with the 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 https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on 16 May 2027. Copyright Notice Copyright (c) 2026 IETF Trust and the persons identified as the document authors. All rights reserved. Piriyath Expires 16 May 2027 [Page 1] Internet-Draft DHCP AI Gateway URI November 2026 This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://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 Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Requirements Language . . . . . . . . . . . . . . . . . . . . 3 3. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Option Format . . . . . . . . . . . . . . . . . . . . . . . . 4 4.1. DHCPv4 Option . . . . . . . . . . . . . . . . . . . . . . 4 4.2. DHCPv6 Option . . . . . . . . . . . . . . . . . . . . . . 5 4.3. URI Constraints . . . . . . . . . . . . . . . . . . . . . 5 5. Server Behavior . . . . . . . . . . . . . . . . . . . . . . . 6 6. Client Behavior . . . . . . . . . . . . . . . . . . . . . . . 6 7. Gateway Descriptor . . . . . . . . . . . . . . . . . . . . . 7 8. Security Considerations . . . . . . . . . . . . . . . . . . . 9 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 9 9.1. DHCPv4 Option . . . . . . . . . . . . . . . . . . . . . . 9 9.2. DHCPv6 Option . . . . . . . . . . . . . . . . . . . . . . 10 9.3. PvD Proxy Key . . . . . . . . . . . . . . . . . . . . . . 10 10. Normative References . . . . . . . . . . . . . . . . . . . . 11 11. Informative References . . . . . . . . . . . . . . . . . . . 12 Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 13 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 13 1. Introduction Clients on an enterprise network increasingly reach model providers through an organizational AI gateway operated as a forward proxy. The gateway is not the general HTTP proxy for the network. It is used only for a set of AI provider destinations. Those destinations, and the gateway's address, change more often than endpoint configuration can be updated by hand. Existing mechanisms do not provide this advertisement: Piriyath Expires 16 May 2027 [Page 2] Internet-Draft DHCP AI Gateway URI November 2026 * The Web Proxy Auto-Discovery Protocol (WPAD) [RFC3040] distributes the URL of a JavaScript Proxy Auto-Configuration (PAC) file. Common DHCPv4 implementations carry that URL in option code 252, a site-specific code in the range 224-254 [RFC3942] that is not a standards-track option. There is no corresponding DHCPv6 option. WPAD names a general web proxy, and support outside Windows HTTP stacks is inconsistent. * [I-D.ietf-intarea-proxy-config] defines Provisioning Domain (PvD) keys that describe proxy URI templates and the destinations those proxies serve. A network can advertise a PvD identifier in a Router Advertisement [RFC8801]; the client then fetches the document over HTTPS. The document does not define a DHCP option. It also requires that a client not automatically send traffic to a network-advertised proxy unless local policy allows that proxy. * [I-D.su-ai-gateway-discovery] defines DNS-Based Service Discovery for an AI gateway that is an HTTP API router on the local link. That advertisement carries a host, a port, and a mount path. It profiles link-local multicast DNS, although DNS-SD can also be served by unicast DNS or a discovery proxy [RFC8766]. It does not name a forward proxy. * [I-D.yang-dhc-dhcp-extension] defines a DHCP option for a campus device that hosts a model used by network operations. The option carries model size and price. It is not a client forward-proxy advertisement. This document follows the pattern of [RFC8910]. DHCP carries a URI. The client retrieves the operational data over HTTPS. The operational data is the PvD Additional Information document of [I-D.ietf-intarea-proxy-config], with one additional proxy key, "purpose", whose value "ai-gateway" distinguishes this proxy from a general web proxy. 2. Requirements Language The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here. Piriyath Expires 16 May 2027 [Page 3] Internet-Draft DHCP AI Gateway URI November 2026 3. Terminology AI gateway: A forward proxy that a client uses for traffic to AI provider destinations named by the gateway descriptor. This document does not use the term for an API router discovered by [I-D.su-ai-gateway-discovery]. Gateway descriptor: A PvD Additional Information document [RFC8801] retrieved from the URI carried by the option defined in this document. Client: A DHCP or DHCPv6 client that requests the option, or the application that consumes the resulting descriptor. This document does not require every host DHCP stack to interpret the option. Applications MAY retrieve the option value through the host configuration API. 4. Option Format Both options carry the same URI. The URI is encoded as UTF-8 [RFC3629] with no terminating NUL. 4.1. DHCPv4 Option The DHCPv4 option code is OPTION_AI_GATEWAY_URI (TBD1). Its format is: 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Code | Len | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | URI (UTF-8, no NUL) | | ... | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 1 Code OPTION_AI_GATEWAY_URI (TBD1), one octet. Len Length of the URI in octets, one octet. URI The gateway descriptor URI. If the URI exceeds the length that fits in one option, the option is concatenated as specified in [RFC3396]. Piriyath Expires 16 May 2027 [Page 4] Internet-Draft DHCP AI Gateway URI November 2026 4.2. DHCPv6 Option The DHCPv6 option code is OPTION_AI_GATEWAY_URI (TBD2). Its format is: 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_AI_GATEWAY_URI (TBD2) | option-len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | URI (UTF-8, no NUL) | | ... | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 2 option-code OPTION_AI_GATEWAY_URI (TBD2), 16 bits. option-len Length of the URI in octets, 16 bits. URI The gateway descriptor URI. 4.3. URI Constraints The URI MUST use the "https" scheme. A client MUST discard a value that is empty, that is not a valid URI, or whose scheme is not "https". The URI MUST NOT contain userinfo (a username or password). A client MUST discard a URI that contains userinfo. A typical value is: https://ai-gw.example.com/.well-known/pvd Figure 3 The path "/.well-known/pvd" is the well-known PvD URI defined in [RFC8801] and the location from which [I-D.ietf-intarea-proxy-config] retrieves proxy PvD information. A deployment MAY use another HTTPS path on the gateway host; the host matching rule in Section 6 still applies. This document does not register a new well-known URI. Each DHCPv4 option occurrence carries one URI. If the URI exceeds the length that fits in one occurrence, the server splits it as specified in [RFC3396]. A DHCPv4 client concatenates those occurrences into a single URI [RFC3396] and MUST NOT treat them as a list of URIs. DHCPv4 therefore carries at most one URI. Piriyath Expires 16 May 2027 [Page 5] Internet-Draft DHCP AI Gateway URI November 2026 A DHCPv6 server MAY send more than one instance of OPTION_AI_GATEWAY_URI. The order of instances is the server's preference order, highest preference first. A DHCPv6 client tries the URIs in that order and stops at the first descriptor it accepts. 5. Server Behavior A DHCPv4 server includes OPTION_AI_GATEWAY_URI only in a response to a client whose Parameter Request List [RFC2132] contains TBD1, and only when the server is configured with at least one URI for that client or link. Otherwise the server MUST NOT include the option. The server includes a single URI. If that URI does not fit in one occurrence, the server splits it as specified in [RFC3396]. A DHCPv6 server includes OPTION_AI_GATEWAY_URI only in a response to a client whose Option Request option [RFC9915] contains TBD2, and only when the server is configured with at least one URI. Otherwise the server MUST NOT include the option. The option MAY appear in Advertise and Reply messages, including a Reply to Information- request. If the server is configured with more than one URI, it MAY include one instance per URI, in preference order as specified in Section 4.3. The option value is configuration. This document does not define a new DHCP message type. Servers SHOULD allow the URI list to vary by link or by client class, so that a gateway appropriate to one segment is not advertised on another. 6. Client Behavior A client that wants the advertisement includes TBD1 in its DHCPv4 Parameter Request List, or TBD2 in its DHCPv6 Option Request option. A client that did not request the option MUST ignore it if a server sends it. On receiving one or more accepted URIs, the client fetches the descriptor with HTTP GET over TLS. The request SHOULD include: Accept: application/pvd+json Figure 4 The client MUST authenticate the TLS server and MUST verify that the certificate matches the hostname of the URI [RFC9110] [RFC9525]. A client MUST NOT follow a redirect to a URI whose scheme is not "https" or whose host is not acceptable under local policy. Piriyath Expires 16 May 2027 [Page 6] Internet-Draft DHCP AI Gateway URI November 2026 The client MUST discard a descriptor unless the host of the option URI, the descriptor "identifier" (without the trailing dot), and the hostname of each "ai-gateway" proxy entry are identical. For "https- connect" and "http-connect", that hostname is the host in the "host:port" value, not including the port. For a URI template, it is the host of the URI. This is the hostname, PvD identifier, and certificate match required by [I-D.ietf-intarea-proxy-config]. The client uses a proxy from the descriptor only when all of the following are true: 1. The proxy dictionary contains "purpose" with the value "ai- gateway". 2. A "proxy-match" rule [I-D.ietf-intarea-proxy-config] selects that proxy for the destination. 3. Local policy or an explicit user action allows the use of that proxy hostname. Receipt of the DHCP option is not by itself permission to send traffic or credentials to the proxy. This is the same constraint [I-D.ietf-intarea-proxy-config] places on proxies learned from a network PvD. The client MUST NOT install the advertised proxy as the system HTTP or HTTPS proxy. Destinations that no "proxy-match" rule maps to an "ai-gateway" proxy are contacted directly, or through whatever proxy local policy already configured. If every URI fails validation or retrieval, the client continues without an AI gateway. Failure to discover a gateway is not treated as a requirement to block the connection. The client SHOULD refresh the descriptor when the DHCP lease is renewed and when the descriptor "expires" time [RFC8801] is reached. It MUST apply the randomized backoff required by [RFC8801] when refreshing because of expiry. 7. Gateway Descriptor The descriptor is a PvD Additional Information object [RFC8801] containing the "proxies" and "proxy-match" keys defined by [I-D.ietf-intarea-proxy-config]. This document defines one additional key, "purpose", used inside a proxy dictionary. The key's value is a string. The value "ai- gateway" means the proxy is an AI forward proxy as defined in Section 3. Other values are reserved for future registration. Piriyath Expires 16 May 2027 [Page 7] Internet-Draft DHCP AI Gateway URI November 2026 An example descriptor is: { "identifier": "ai-gw.example.com.", "expires": "2027-05-15T00:00:00Z", "prefixes": [], "proxies": [ { "protocol": "https-connect", "proxy": "ai-gw.example.com:443", "identifier": "ai-gw", "purpose": "ai-gateway", "mandatory": [ "purpose" ] } ], "proxy-match": [ { "domains": [ "api.openai.com", "*.anthropic.com" ], "proxies": [ "ai-gw" ] }, { "proxies": [] } ] } Figure 5 In this example the client uses ai-gw.example.com, port 443, with HTTP CONNECT over TLS, and only for the named domains. The final rule selects no proxy, so every other destination is contacted directly. A descriptor MUST list "purpose" in the "mandatory" array [I-D.ietf-intarea-proxy-config] of every proxy dictionary that carries it. A client that implements [I-D.ietf-intarea-proxy-config] but not this document then ignores the dictionary instead of using the AI gateway as an ordinary proxy. The descriptor MUST NOT contain client credentials, API keys, or model pricing. Model catalogs are retrieved, if at all, from the gateway after the client has been authorized to use it. Piriyath Expires 16 May 2027 [Page 8] Internet-Draft DHCP AI Gateway URI November 2026 8. Security Considerations DHCP and DHCPv6 are unauthenticated unless a deployment adds its own protection. An attacker who can answer DHCP on the link can supply a URI. This option therefore does not authorize use of the named host. Authorization is the combination of a validated HTTPS certificate and local policy that allows that hostname, as required in Section 6. Operators SHOULD prevent rogue DHCP servers on access networks. That is a property of the access network. This document does not require DHCP authentication [RFC3118], which is not widely deployed. The option carries a name, not a raw address, so that the TLS certificate can be checked against a stable name. A client MUST NOT accept an "https" URI whose authority is an IP address unless local policy explicitly allows that address and the certificate matches it. A malicious descriptor can list destinations that the client did not intend to proxy. Clients MUST only narrow or select among destinations that local policy already permits to be sent to that proxy. A descriptor MUST NOT cause the client to proxy traffic that local policy sends direct or to a different proxy. This is the narrowing rule in [I-D.ietf-intarea-proxy-config]. Because the gateway sees the destinations it proxies, local policy should allow an AI gateway only for the provider names the organization intends to inspect. Advertising the gateway through DHCP does not expand that set. The option is requested explicitly. Servers do not attach it to every lease. This limits exposure to clients that implement the option, and it avoids changing the behavior of hosts that only implement WPAD. 9. IANA Considerations 9.1. DHCPv4 Option IANA is requested to assign a new option code from the "BOOTP Vendor Extensions and DHCP Options" registry (https://www.iana.org/assignments/bootp-dhcp-parameters) as follows: Piriyath Expires 16 May 2027 [Page 9] Internet-Draft DHCP AI Gateway URI November 2026 +======+=======================+========+===============+===========+ | Tag | Name | Data | Meaning | Reference | | | | Length | | | +======+=======================+========+===============+===========+ | TBD1 | OPTION_AI_GATEWAY_URI | N | HTTPS URI | This | | | | | of an AI | document | | | | | gateway | | | | | | descriptor | | +------+-----------------------+--------+---------------+-----------+ Table 1 9.2. DHCPv6 Option IANA is requested to assign a new option code from the "Option Codes" registry under "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)" (https://www.iana.org/assignments/dhcpv6-parameters) as follows: +=======+=======================+========+===========+===========+ | Value | Description | Client | Singleton | Reference | | | | ORO | | | +=======+=======================+========+===========+===========+ | TBD2 | OPTION_AI_GATEWAY_URI | Yes | No | This | | | | | | document | +-------+-----------------------+--------+-----------+-----------+ Table 2 The option is not a singleton: more than one instance MAY appear, in preference order. 9.3. PvD Proxy Key IANA is requested to register the following key in the "Proxy Information PvD Keys" registry established by [I-D.ietf-intarea-proxy-config]: Piriyath Expires 16 May 2027 [Page 10] Internet-Draft DHCP AI Gateway URI November 2026 +=========+===========+======================+========+===========+ | JSON | Optional/ | Description | Type | Reference | | Key | Required | | | | +=========+===========+======================+========+===========+ | purpose | optional | Role of this proxy. | String | This | | | | The value "ai- | | document | | | | gateway" identifies | | | | | | an AI forward proxy. | | | +---------+-----------+----------------------+--------+-----------+ Table 3 IANA is requested to create a registry titled "AI Gateway Proxy Purpose Values" on the "Provisioning Domains (PvDs)" registry page established by [RFC8801]. The initial contents are: +============+=========================================+===========+ | Value | Description | Reference | +============+=========================================+===========+ | ai-gateway | Forward proxy used only for AI provider | This | | | destinations selected by proxy-match. | document | +------------+-----------------------------------------+-----------+ Table 4 New values are allocated by Expert Review [RFC8126]. The expert reviews the specification for a clear meaning that does not overlap an existing value. Values containing an underscore are reserved for vendor use, consistent with [I-D.ietf-intarea-proxy-config]. 10. 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, . [RFC2132] Alexander, S. and R. Droms, "DHCP Options and BOOTP Vendor Extensions", RFC 2132, DOI 10.17487/RFC2132, March 1997, . [RFC3396] Lemon, T. and S. Cheshire, "Encoding Long Options in the Dynamic Host Configuration Protocol (DHCPv4)", RFC 3396, DOI 10.17487/RFC3396, November 2002, . Piriyath Expires 16 May 2027 [Page 11] Internet-Draft DHCP AI Gateway URI November 2026 [RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO 10646", STD 63, RFC 3629, DOI 10.17487/RFC3629, November 2003, . [RFC8126] Cotton, M., Leiba, B., and T. Narten, "Guidelines for Writing an IANA Considerations Section in RFCs", BCP 26, RFC 8126, DOI 10.17487/RFC8126, June 2017, . [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . [RFC9915] Mrugalski, T., Volz, B., Richardson, M., Jiang, S., and T. Winters, "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)", STD 102, RFC 9915, DOI 10.17487/RFC9915, January 2026, . [RFC8801] Pfister, P., Vyncke, É., Pauly, T., Schinazi, D., and W. Shao, "Discovering Provisioning Domain Names and Data", RFC 8801, DOI 10.17487/RFC8801, July 2020, . [RFC9110] Fielding, R., Ed., Nottingham, M., Ed., and J. Reschke, Ed., "HTTP Semantics", STD 97, RFC 9110, DOI 10.17487/RFC9110, June 2022, . [RFC9525] Saint-Andre, P. and R. Salz, "Service Identity in TLS", RFC 9525, DOI 10.17487/RFC9525, November 2023, . [I-D.ietf-intarea-proxy-config] Pauly, T., Damjanovic, D., and Y. Rosomakho, "Communicating Proxy Configurations in Provisioning Domains", RFC Editor queue., Work in Progress, Internet- Draft, draft-ietf-intarea-proxy-config-14, Work in Progress , 19 May 2026, . 11. Informative References [RFC3040] Cooper, I., Melve, I., and G. Tomlinson, "Internet Web Replication and Caching Taxonomy", RFC 3040, DOI 10.17487/RFC3040, January 2001, . Piriyath Expires 16 May 2027 [Page 12] Internet-Draft DHCP AI Gateway URI November 2026 [RFC3118] Droms, R., Ed. and W. Arbaugh, Ed., "Authentication for DHCP Messages", RFC 3118, DOI 10.17487/RFC3118, June 2001, . [RFC3942] Volz, B., "Reclassifying Dynamic Host Configuration Protocol version 4 (DHCPv4) Options", RFC 3942, DOI 10.17487/RFC3942, November 2004, . [RFC8766] Cheshire, S., "Discovery Proxy for Multicast DNS-Based Service Discovery", RFC 8766, DOI 10.17487/RFC8766, June 2020, . [RFC8910] Kumari, W. and E. Kline, "Captive-Portal Identification in DHCP and Router Advertisements (RAs)", RFC 8910, DOI 10.17487/RFC8910, September 2020, . [I-D.su-ai-gateway-discovery] Su, C., "DNS-Based Service Discovery for AI Gateways", Work in Progress, Internet-Draft, draft-su-ai-gateway- discovery-01, Work in Progress , 28 October 2026, . [I-D.yang-dhc-dhcp-extension] Yang, Y. and Q. Wu, "DHCP New Option Extension based on LLM Capability", Work in Progress, Internet-Draft, draft- yang-dhc-dhcp-extension-00, Work in Progress , 6 July 2026, . Acknowledgements The option shape follows the captive-portal URI option in RFC 8910. The descriptor reuses the proxy and destination keys defined by draft-ietf-intarea-proxy-config. Author's Address Shibu Piriyath Nile Global, Inc. Email: shibupiriyath@gmail.com Piriyath Expires 16 May 2027 [Page 13]