| Description | Manage sandbox policies |
|---|---|
| Usage | sbx policy COMMAND |
Description
Manage persistent access policies for sandboxes.
Policies contain rules that control what sandboxes can access. Local rules can apply globally across all sandboxes or be scoped to one sandbox. Use subcommands to allow, deny, list, or remove rules.
Network rules match the hostname a connection names, such as its TLS SNI or HTTP Host. A denied host that shares an address with an allowed host can still be reached in three cases. First, on connections the proxy does not decrypt, the HTTP Host or :authority inside the encrypted stream is not checked. Second, on cleartext HTTP sent through a CONNECT tunnel or without HTTP_PROXY, only the first request on each connection has its Host checked. Third, a connection that names no host is allowed when any hostname the sandbox resolved to that address is allowed, even if another of those hostnames is denied.
Commands
| Command | Description |
|---|---|
sbx policy allow | Add an allow rule for sandboxes |
sbx policy approval | Review and respond to pending approvals |
sbx policy check | Check whether policy allows an access request |
sbx policy deny | Add a deny rule for sandboxes |
sbx policy init | Initialize the global network policy |
sbx policy inspect | Show policy or rule details |
sbx policy log | Show sandbox policy logs |
sbx policy ls | List sandbox policies |
sbx policy refresh | Force an immediate policy refresh |
sbx policy reset | Reset policies to defaults |
sbx policy rm | Remove a policy rule |
Global options
| Option | Default | Description |
|---|---|---|
--cloud | Dispatch to Docker Cloud Sandboxes API instead of local sandboxd (supported by a growing set of verbs — run 'sbx --cloud --help' for the current list) | |
-D, --debug | Enable debug logging | |
--no-input | Never prompt; commands that need an answer fail with the command to run instead |