Skip to content

Commit a49e8f8

Browse files
committed
sbx: update policy log examples, add browser-open
The sandbox policy log output includes newer RULE and REASON columns and additional PROXY values. Update the monitoring example and related kit debugging guidance to describe the current output format.
1 parent 9815a5e commit a49e8f8

2 files changed

Lines changed: 19 additions & 12 deletions

File tree

content/manuals/ai/sandboxes/customize/kits.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -577,8 +577,9 @@ When a kit doesn't behave as expected, start with the network policy log
577577
and direct inspection inside the sandbox:
578578

579579
- `sbx policy log` shows every outbound request the sandbox proxy saw,
580-
the rule it matched, and how it was forwarded (`forward-bypass`,
581-
`forward`, `block`). Use it to diagnose install-time download failures,
580+
the rule it matched, extra context when available, and its `PROXY`
581+
value, such as `forward`, `forward-bypass`, `transparent`, or
582+
`browser-open`. Use it to diagnose install-time download failures,
582583
blocked domains, and unexpected TLS interception. If downloads fail or
583584
arrive corrupted after you add `serviceDomains`, check whether the
584585
service mapping is too broad. Map only the hosts that need credential

content/manuals/ai/sandboxes/security/policy.md

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -166,22 +166,28 @@ Use `sbx policy log` to see which hosts your sandboxes have contacted:
166166
```console
167167
$ sbx policy log
168168
Blocked requests:
169-
SANDBOX TYPE HOST PROXY RULE LAST SEEN COUNT
170-
my-sandbox network blocked.example.com transparent policykit 10:15:25 29-Jan 1
169+
SANDBOX TYPE HOST PROXY RULE REASON LAST SEEN COUNT
170+
my-sandbox network blocked.example.com transparent domain-blocked default-deny 10:15:25 29-Jan 1
171171

172172
Allowed requests:
173-
SANDBOX TYPE HOST PROXY RULE LAST SEEN COUNT
174-
my-sandbox network api.anthropic.com forward policykit 10:15:23 29-Jan 42
175-
my-sandbox network registry.npmjs.org transparent policykit 10:15:20 29-Jan 18
173+
SANDBOX TYPE HOST PROXY RULE REASON LAST SEEN COUNT
174+
my-sandbox network api.anthropic.com forward domain-allowed 10:15:23 29-Jan 42
175+
my-sandbox network registry.npmjs.org forward-bypass domain-allowed 10:15:20 29-Jan 18
176+
my-sandbox network app.example.com browser-open 10:15:10 29-Jan 1
176177
```
177178

178179
The **PROXY** column shows how the request left the sandbox:
179180

180-
| Value | Description |
181-
| ------------- | -------------------------------------------------------------------------------------------------------------- |
182-
| `forward` | Routed through the forward proxy. Supports [credential injection](credentials.md). |
183-
| `transparent` | Intercepted by the transparent proxy. Policy is enforced but credential injection is not available. |
184-
| `network` | Non-HTTP traffic (raw TCP, UDP, ICMP). TCP can be allowed with a policy rule; UDP and ICMP are always blocked. |
181+
| Value | Description |
182+
| ---------------- | -------------------------------------------------------------------------------------------------------------- |
183+
| `forward` | Routed through the forward proxy. Supports [credential injection](credentials.md). |
184+
| `forward-bypass` | Routed through the forward proxy without credential injection. |
185+
| `transparent` | Intercepted by the transparent proxy. Policy is enforced but credential injection is not available. |
186+
| `network` | Non-HTTP traffic (raw TCP, UDP, ICMP). TCP can be allowed with a policy rule; UDP and ICMP are always blocked. |
187+
| `browser-open` | A sandbox process requested opening a URL in the host browser. Policy is enforced before opening the URL. |
188+
189+
The **RULE** column identifies the policy rule that matched the request. The
190+
**REASON** column includes extra context when the daemon records one.
185191

186192
Filter by sandbox name by passing it as an argument:
187193

0 commit comments

Comments
 (0)