Search or ask Docker

sbx policy

View Markdown
DescriptionManage sandbox policies
Usagesbx 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

CommandDescription
sbx policy allowAdd an allow rule for sandboxes
sbx policy approvalReview and respond to pending approvals
sbx policy checkCheck whether policy allows an access request
sbx policy denyAdd a deny rule for sandboxes
sbx policy initInitialize the global network policy
sbx policy inspectShow policy or rule details
sbx policy logShow sandbox policy logs
sbx policy lsList sandbox policies
sbx policy refreshForce an immediate policy refresh
sbx policy resetReset policies to defaults
sbx policy rmRemove a policy rule

Global options

OptionDefaultDescription
--cloudDispatch 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, --debugEnable debug logging
--no-inputNever prompt; commands that need an answer fail with the command to run instead