Skip to content

Commit cdbd11a

Browse files
rikatzmikemorris
andauthored
Reword on TLSRoute termination
Co-authored-by: Mike Morris <[email protected]>
1 parent 098a298 commit cdbd11a

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

site-src/concepts/api-overview.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -117,11 +117,15 @@ modifying them in-flight.
117117

118118
TLSRoute is for multiplexing TLS connections, discriminated via SNI. It's intended
119119
for where you want to use the SNI as the main routing method, and are not interested
120-
in properties of the higher-level protocols like HTTP. The byte stream of the
121-
connection is proxied without any inspection to the backend when using a `Passthrough`
122-
TLS listener, or being __TLS Terminated__ by the proxy when using a `Terminate`
123-
TLS listener. In the later case, the proxy may re-encrypt the traffic to the backend
124-
in cases like a `BackendTLSPolicy` is applied.
120+
in properties of the higher-level protocols like HTTP. When using a `Passthrough`
121+
TLS listener, the encrypted byte stream of the connection is proxied directly to
122+
the backend destination (which is then responsible for decrypting the stream)
123+
without any introspection beyond the TLS metadata. When using a `Terminate`
124+
TLS listener, encryption is removed at the gateway to "unwrap" the connection,
125+
allowing traffic inspection and routing based on attributes of the inner request
126+
payload. In this latter case, the gateway may be configured to re-encrypt
127+
the traffic before sending it on to the backend, such as when a
128+
`BackendTLSPolicy` has been applied to the destination.
125129

126130
#### TCPRoute and UDPRoute
127131

0 commit comments

Comments
 (0)