Skip to content

Commit a54b58f

Browse files
authored
Correct our support for UDP and HTTP/3 (#1728)
1 parent 0ebcb84 commit a54b58f

File tree

1 file changed

+11
-7
lines changed

1 file changed

+11
-7
lines changed

content/docs/internals/connection.mdx

+11-7
Original file line numberDiff line numberDiff line change
@@ -10,21 +10,25 @@ import LongLivedConnections from '@site/content/docs/admonitions/_long-lived-con
1010

1111
# Connection Lifecycle
1212

13-
Pomerium enables proxying of HTTP and TCP connections, uniformly applying [access policies](/docs/capabilities/authorization) across these connections.
13+
Pomerium enables proxying of HTTP, TCP, and UDP traffic, uniformly applying [access policies](/docs/capabilities/authorization) across the routed traffic.
1414

1515
The primary focus of this document is the management of transport layer connections in Pomerium, particularly HTTP requests.
1616

17-
## HTTP and TCP connection lifecyle
17+
## HTTP connection lifecyle
1818

19-
### 1. **Downstream connection and TLS termination**
19+
TCP and UDP traffic is tunneled over HTTP, so let's focus on the HTTP connection lifecycle.
2020

21-
A client, usually a web browser, initiates a connection to Pomerium.
21+
### 1. **Downstream connection and TLS termination**
2222

23-
- This connection can be HTTP/1.1 or HTTP/2.
23+
- A client, usually a web browser, [Pomerium CLI](/docs/clients/pomerium-cli), or [Pomerium Desktop App](/docs/clients/pomerium-desktop), initiates a connection to Pomerium. This connection can be HTTP/1.1, HTTP/2, or HTTP/3.
2424

2525
:::tip **Note**
2626

27-
Pomerium currently does not support QUIC or HTTP/3 transports. Most modern browsers default to HTTP/2 connections for significant performance benefits. In rare circumstances, you may need to force HTTP/1.1 using the [`codec_type`](/docs/reference/codec-type) parameter.
27+
HTTP/2 and HTTP/1.1 are allowed by default, with most modern browsers defaulting to HTTP/2.
28+
29+
HTTP/3 can be enabled by setting the [`codec_type`](/docs/reference/codec-type) parameter. This is recommended when proxying UDP traffic.
30+
31+
In rare circumstances, you may need to force HTTP/1.1 using the [`codec_type`](/docs/reference/codec-type) parameter.
2832

2933
:::
3034

@@ -34,7 +38,7 @@ Pomerium currently does not support QUIC or HTTP/3 transports. Most modern brows
3438

3539
### 2. **Request initiation**
3640

37-
After the transport layer connection is established, the downstream client sends an HTTP request. The proxy parses this request, matches it against the configuration, and determines the upstream service to which the request should be forwarded.
41+
After TLS handshakes are complete, the downstream client sends an HTTP request. The proxy parses this request, matches it against the configured routes, and determines the upstream service to which the request should be forwarded.
3842

3943
### 3. **Request authorization**
4044

0 commit comments

Comments
 (0)