Internet-Draft DHCP AI Gateway URI November 2026
Piriyath Expires 16 May 2027 [Page]
Workgroup:
Dynamic Host Configuration
Internet-Draft:
draft-spiriyath-dhc-ai-gateway-uri-00
Published:
Intended Status:
Standards Track
Expires:
Author:
S. Piriyath
Nile Global, Inc.

DHCP and DHCPv6 Options for an AI Gateway URI

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.

▲

Table of Contents

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:

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.

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

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.

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.

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.

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.

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:

Table 1
Tag Name Data Length Meaning Reference
TBD1 OPTION_AI_GATEWAY_URI N HTTPS URI of an AI gateway descriptor This document

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:

Table 2
Value Description Client ORO Singleton Reference
TBD2 OPTION_AI_GATEWAY_URI Yes No This document

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

Table 3
JSON Key Optional/Required Description Type Reference
purpose optional Role of this proxy. The value "ai-gateway" identifies an AI forward proxy. String This document

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:

Table 4
Value Description Reference
ai-gateway Forward proxy used only for AI provider destinations selected by proxy-match. This document

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, , <https://www.rfc-editor.org/info/rfc2119>.
[RFC2132]
Alexander, S. and R. Droms, "DHCP Options and BOOTP Vendor Extensions", RFC 2132, DOI 10.17487/RFC2132, , <https://www.rfc-editor.org/info/rfc2132>.
[RFC3396]
Lemon, T. and S. Cheshire, "Encoding Long Options in the Dynamic Host Configuration Protocol (DHCPv4)", RFC 3396, DOI 10.17487/RFC3396, , <https://www.rfc-editor.org/info/rfc3396>.
[RFC3629]
Yergeau, F., "UTF-8, a transformation format of ISO 10646", STD 63, RFC 3629, DOI 10.17487/RFC3629, , <https://www.rfc-editor.org/info/rfc3629>.
[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, , <https://www.rfc-editor.org/info/rfc8126>.
[RFC8174]
Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, , <https://www.rfc-editor.org/info/rfc8174>.
[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, , <https://www.rfc-editor.org/info/rfc9915>.
[RFC8801]
Pfister, P., Vyncke, É., Pauly, T., Schinazi, D., and W. Shao, "Discovering Provisioning Domain Names and Data", RFC 8801, DOI 10.17487/RFC8801, , <https://www.rfc-editor.org/info/rfc8801>.
[RFC9110]
Fielding, R., Ed., Nottingham, M., Ed., and J. Reschke, Ed., "HTTP Semantics", STD 97, RFC 9110, DOI 10.17487/RFC9110, , <https://www.rfc-editor.org/info/rfc9110>.
[RFC9525]
Saint-Andre, P. and R. Salz, "Service Identity in TLS", RFC 9525, DOI 10.17487/RFC9525, , <https://www.rfc-editor.org/info/rfc9525>.
[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 , , <https://datatracker.ietf.org/doc/html/draft-ietf-intarea-proxy-config-14>.

11. Informative References

[RFC3040]
Cooper, I., Melve, I., and G. Tomlinson, "Internet Web Replication and Caching Taxonomy", RFC 3040, DOI 10.17487/RFC3040, , <https://www.rfc-editor.org/info/rfc3040>.
[RFC3118]
Droms, R., Ed. and W. Arbaugh, Ed., "Authentication for DHCP Messages", RFC 3118, DOI 10.17487/RFC3118, , <https://www.rfc-editor.org/info/rfc3118>.
[RFC3942]
Volz, B., "Reclassifying Dynamic Host Configuration Protocol version 4 (DHCPv4) Options", RFC 3942, DOI 10.17487/RFC3942, , <https://www.rfc-editor.org/info/rfc3942>.
[RFC8766]
Cheshire, S., "Discovery Proxy for Multicast DNS-Based Service Discovery", RFC 8766, DOI 10.17487/RFC8766, , <https://www.rfc-editor.org/info/rfc8766>.
[RFC8910]
Kumari, W. and E. Kline, "Captive-Portal Identification in DHCP and Router Advertisements (RAs)", RFC 8910, DOI 10.17487/RFC8910, , <https://www.rfc-editor.org/info/rfc8910>.
[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 , , <https://datatracker.ietf.org/doc/html/draft-su-ai-gateway-discovery-01>.
[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 , , <https://datatracker.ietf.org/doc/html/draft-yang-dhc-dhcp-extension-00>.

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.