Skip to content

sbx: document sign-in enforcement for sandboxes#25263

Open
dvdksn wants to merge 4 commits into
docker:mainfrom
dvdksn:worktree-sbx-signin-enforcement
Open

sbx: document sign-in enforcement for sandboxes#25263
dvdksn wants to merge 4 commits into
docker:mainfrom
dvdksn:worktree-sbx-signin-enforcement

Conversation

@dvdksn
Copy link
Copy Markdown
Contributor

@dvdksn dvdksn commented Jun 4, 2026

Summary

Adds an admin-facing guide for Docker Sandboxes organization sign-in enforcement: admins deploy an enforcement configuration via endpoint management (macOS configuration profile, Windows registry, Linux root-owned JSON file) specifying allowed Docker Hub org slugs, and sbx login verifies membership and revokes credentials on failure.

New page content/manuals/ai/sandboxes/governance/sign-in-enforcement.md covers how it works (login-time-only, fail-closed, auto-login behavior), the configuration schema, per-platform deployment, and error messages. Also cross-links from the governance overview and generalizes the security page's organization-control section so it makes a single point about admin-level controls rather than enumerating each feature.

Learnings

  • The sbx sign-in enforcement config is entirely endpoint/file-based (com.docker.sbx managed prefs, HKLM\SOFTWARE\Policies\Docker\SBX, /etc/docker-sbx/config.json) with no Admin Console UI — distinct from sandbox org policy (network/filesystem), which is Admin Console + API driven. Worth keeping these two admin mechanisms separate in the docs.

Generated by Claude Code

Add an admin-facing guide for organization sign-in enforcement (G-6),
deployed via endpoint management (macOS configuration profile, Windows
registry, Linux config file). Cross-link from the governance overview and
generalize the security page's organization-control section.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented Jun 4, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 769e4cf
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a2189257a21a400074df4a5
😎 Deploy Preview https://deploy-preview-25263--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.

Use the source-path form (_index.md) so Hugo resolves the internal link;
the published-URL form left the /manuals prefix unstripped and failed the
htmltest link check.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown

@docker-agent docker-agent left a comment

Choose a reason for hiding this comment

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

Assessment: 🟡 NEEDS ATTENTION

Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md
@dvdksn dvdksn requested a review from smnovick June 4, 2026 08:58
@dvdksn dvdksn marked this pull request as ready for review June 4, 2026 08:58
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
- Remove bold "Term." lead-ins from the consequences list (STYLE.md
  reserves bold for UI elements)
- Reorder the page before the API reference (weight 22, grouped with
  organization policy)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md Outdated
Copy link
Copy Markdown

@smnovick smnovick left a comment

Choose a reason for hiding this comment

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

left comments

- Frame the feature as part of the AI Governance offering (not a separate
  paid subscription)
- Drop "Hub" from organization/API references to avoid confusion
- Remove the manual-logout fallback sentence
- Remove the login-time-only / fail-closed / consequences section
- Trim the MDM example list to Jamf and Intune (drop unused vocab terms)
- Remove the Windows registry-path intro and the Linux weaker-enforcement note

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dvdksn dvdksn requested a review from a team June 5, 2026 06:02
Copy link
Copy Markdown

@docker-agent docker-agent left a comment

Choose a reason for hiding this comment

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

Assessment: 🟡 NEEDS ATTENTION

Comment thread content/manuals/ai/sandboxes/governance/sign-in-enforcement.md
{{< tab name="Windows" >}}

Deploy it through Group Policy, Intune, or any endpoint management tool that can
write registry values.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[MEDIUM] Windows tab omits the registry key path from deployment prose

The macOS and Linux tabs both state the configuration path upfront in prose before showing the config. The Windows tab says "Deploy it through Group Policy, Intune, or any endpoint management tool that can write registry values" but never names the registry key path (HKLM:\SOFTWARE\Policies\Docker\SBX) in the introductory text or the table — it only appears later in the "test locally" PowerShell snippet.

An IT admin configuring enforcement via Group Policy or Intune would need the registry path to set up the GPO template or Intune registry policy. Since the PowerShell block is framed as a local test rather than the primary deployment instruction, the path is easy to miss.

Consider adding a sentence like: "Write the values to HKLM:\SOFTWARE\Policies\Docker\SBX." before or within the table.

Copy link
Copy Markdown
Member

@usha-mandya usha-mandya left a comment

Choose a reason for hiding this comment

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

LGTM

@dvdksn dvdksn added this to the sbx/v0.32.0 milestone Jun 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants