Skip to content

ai-gov: approval-required network access - #26059

Draft
craig-osterhout wants to merge 2 commits into
docker:mainfrom
craig-osterhout:docs-sbx-ask-policy
Draft

ai-gov: approval-required network access#26059
craig-osterhout wants to merge 2 commits into
docker:mainfrom
craig-osterhout:docs-sbx-ask-policy

Conversation

@craig-osterhout

@craig-osterhout craig-osterhout commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Description

Document approval-required network access. An organization network policy can
require a developer to confirm each destination before a sandbox reaches it.

Split from #26051. The HTTP method and path rules are in #26060, which is
branched off this PR and merges after it.

Page What changed
network.md What approval is, what satisfies it, how overlapping policies behave, and the sbx policy approval workflow
organization.md The Require approval before access setting, and that resetting local policy clears recorded approvals
concepts.md Approval as a policy-level setting and a third evaluation outcome
local.md Troubleshooting entry for a request blocked pending approval
monitoring.md Filter for rules recorded from an approval

Related issues or tickets

ENGDOCS-3373

Reviews

  • Technical review
  • Editorial review
  • Product review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
@netlify

netlify Bot commented Sep 10, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 3ca91a1
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6aa2f3671adbcc00084e7c23
😎 Deploy Preview https://deploy-preview-26059--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

### A request is blocked with "Approval required"

The destination is allowed by an organization policy that requires approval.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is only half the story. Orgs can require approval, but also when operating ungoverned, network requests that do not match any rules and are implicitly denied will also ask for approval.

List the destinations waiting for a response:

```console
$ sbx policy approval ls

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The user will also be able to use the sbx companion app (the UI stuff that appears in the system tray) to list and approve requests.

@chrispatrick

Copy link
Copy Markdown
Contributor

This is currently behind a FF, so we will need to coordinate publication of the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants