Skip to content

Commit 4924fc6

Browse files
dvdksnclaude
andcommitted
docs: warn against overriding TLS trust env vars
Per review feedback, overriding SSL_CERT_FILE (or similar) to point only at an internal CA replaces the system bundle and breaks the trust the credential proxy relies on for the forward egress path. Install the CA into the system trust store instead. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 8f3b32c commit 4924fc6

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

content/manuals/ai/sandboxes/troubleshooting.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,14 @@ $ sbx exec <sandbox-name> -- sudo install -m 0644 /tmp/internal-ca.crt /usr/loca
142142
$ sbx exec <sandbox-name> -- sudo update-ca-certificates
143143
```
144144

145+
> [!IMPORTANT]
146+
> Install the CA into the system trust store with `update-ca-certificates`, as
147+
> shown above. Don't override the sandbox's TLS trust variables (such as
148+
> `SSL_CERT_FILE`) to point at only your internal CA. Doing so replaces the
149+
> system bundle
150+
> and breaks the trust the credential proxy depends on, so requests on the
151+
> `forward` egress path fail.
152+
145153
If API calls still fail after installing the CA, run `sbx policy log` and check
146154
whether the request used `forward`, `forward-bypass`, or `transparent` in the
147155
**PROXY** column. That can help identify whether the request is eligible for

0 commit comments

Comments
 (0)