Skip to content

Commit e95dcaf

Browse files
dvdksnclaude
andcommitted
docs: clarify egress paths for internal CA troubleshooting
forward-bypass and transparent both forward packets to the upstream proxy, so the sandbox sees the organization's certificate and the internal CA install applies. forward terminates TLS at the credential proxy and already trusts its own cert. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 4924fc6 commit e95dcaf

1 file changed

Lines changed: 11 additions & 3 deletions

File tree

content/manuals/ai/sandboxes/troubleshooting.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -151,9 +151,17 @@ $ sbx exec <sandbox-name> -- sudo update-ca-certificates
151151
> `forward` egress path fail.
152152
153153
If API calls still fail after installing the CA, run `sbx policy log` and check
154-
whether the request used `forward`, `forward-bypass`, or `transparent` in the
155-
**PROXY** column. That can help identify whether the request is eligible for
156-
credential injection or is reaching an upstream proxy directly.
154+
the egress path in the **PROXY** column:
155+
156+
- `forward`: the credential proxy terminates TLS and presents its own
157+
certificate, which the sandbox already trusts. Requests on this path don't
158+
need the internal CA, and overriding the sandbox's trust variables breaks
159+
them, as described above.
160+
- `forward-bypass` and `transparent`: the proxy forwards packets to the
161+
upstream proxy without terminating TLS, so the sandbox sees your
162+
organization's certificate directly. These paths are where installing the
163+
internal CA applies. The only difference between them is whether the client
164+
knows it's talking to a proxy.
157165

158166
## Docker build export fails with an ownership error
159167

0 commit comments

Comments
 (0)