Skip to content

Implement WSLC container group policies#40466

Draft
benhillis wants to merge 1 commit intomasterfrom
user/benhill/wslc-policies
Draft

Implement WSLC container group policies#40466
benhillis wants to merge 1 commit intomasterfrom
user/benhill/wslc-policies

Conversation

@benhillis
Copy link
Copy Markdown
Member

@benhillis benhillis commented May 8, 2026

Implement WSLC container group policies

Adds enforcement for two group policies whose ADMX templates landed in #40422:

  • AllowWSLContainer (DWORD): master switch for wslc.exe and the WSLCSessionManager COM API. Enforced inside WSLCSessionManagerFactory so CoCreateInstance returns WSL_E_CONTAINER_DISABLED directly when the policy is off; every caller (wslc.exe, WslcSDK, plugins) fails fast through one code path rather than getting a manager whose every method errors out individually.

  • WSLContainerCLIRegistryAllowlist: ADMX <list valuePrefix=\"AllowedRegistry\"> policy stored as a sub-key whose REG_SZ value data is each allowed registry hostname. Enforced in PullImage and PushImage via a shared helper. BuildImage is currently rejected outright when an allowlist is configured. This will be addressed in a follow-up change.

Adds two new HRESULTs:

  • WSL_E_CONTAINER_DISABLED (0x33)
  • WSL_E_REGISTRY_BLOCKED_BY_POLICY (0x34)

Adds PolicyTests covering disabled-state, CLI surfacing, allowlist denial, build rejection, and pure-function unit tests for the allowlist evaluator.

Copilot AI review requested due to automatic review settings May 8, 2026 16:23
@benhillis benhillis requested a review from craigloewen-msft May 8, 2026 16:27
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Implements enforcement for new WSLC-related group policies across the WSLC COM service boundary and CLI, including new HRESULTs and localized user-facing error messages, plus policy-focused tests.

Changes:

  • Enforce AllowWSLContainer at WSLCSessionManager COM activation time so clients fail fast with WSL_E_CONTAINER_DISABLED.
  • Implement WSLContainerCLIRegistryAllowlist evaluation and enforce it for image pull/push; block image builds when an allowlist is configured.
  • Add new HRESULTs and localized messages, plus new policy tests (including pure-function allowlist evaluator tests).

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
test/windows/PolicyTests.cpp Adds WSLC policy tests for container disable + registry allowlist behavior, including CLI coverage and evaluator unit tests.
src/windows/wslcsession/WSLCSession.cpp Enforces registry allowlist for Pull/Push and blocks BuildImage when allowlist is active.
src/windows/service/inc/wslservice.idl Defines WSL_E_CONTAINER_DISABLED and WSL_E_REGISTRY_BLOCKED_BY_POLICY.
src/windows/service/exe/WSLCSessionManagerFactory.cpp Gates COM factory creation on AllowWSLContainer policy.
src/windows/inc/wslpolicies.h Adds allowlist subkey constants and helper functions to read/evaluate the registry allowlist.
src/windows/common/wslutil.cpp Registers new HRESULTs in common error mapping and adds a localized string for WSL_E_CONTAINER_DISABLED.
localization/strings/en-US/Resources.resw Adds localized strings for the new policy-related user-facing error messages.

Comment thread test/windows/PolicyTests.cpp Outdated
Comment thread src/windows/inc/wslpolicies.h Outdated
Comment thread test/windows/PolicyTests.cpp
Comment thread src/windows/inc/wslpolicies.h Outdated
Comment thread src/windows/inc/wslpolicies.h Outdated
@benhillis benhillis force-pushed the user/benhill/wslc-policies branch from 08e7ed9 to cf811de Compare May 8, 2026 16:40
@benhillis benhillis requested a review from Copilot May 8, 2026 16:42
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Comment thread src/windows/service/exe/WSLCSessionManagerFactory.cpp Outdated
Comment thread src/windows/inc/wslpolicies.h
@benhillis benhillis force-pushed the user/benhill/wslc-policies branch from cf811de to 5891de1 Compare May 8, 2026 17:31
Copilot AI review requested due to automatic review settings May 8, 2026 21:09
@benhillis benhillis force-pushed the user/benhill/wslc-policies branch from 5891de1 to 753c107 Compare May 8, 2026 21:09
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

Comment thread src/windows/inc/wslpolicies.h
Comment thread test/windows/PolicyTests.cpp
Comment thread src/windows/wslcsession/WSLCSession.cpp
Comment thread src/windows/wslcsession/WSLCSession.cpp
Adds enforcement for two group policies whose ADMX templates landed in
PR #40422:

- AllowWSLContainer (DWORD): master switch for wslc.exe and the
  WSLCSessionManager COM API. Enforced inside WSLCSessionManagerFactory
  so CoCreateInstance returns WSL_E_CONTAINER_DISABLED directly when the
  policy is off; every caller (wslc.exe, WslcSDK, plugins) fails fast
  through one code path rather than getting a manager whose every method
  errors out individually.

- WSLContainerRegistryAllowlist: ADMX `<list valuePrefix=\"AllowedRegistry\">`
  policy stored as a sub-key whose REG_SZ value data is each allowed
  registry hostname. Enforced in PullImage and PushImage via a shared
  helper. BuildImage is rejected outright when an allowlist is
  configured, since the in-VM docker daemon fetches FROM base images
  through its own pull mechanism and cannot be reliably gated
  per-registry. The policy is fail-open: an absent or empty sub-key is
  treated as no restriction, and registry I/O errors fall through to
  allow rather than break all container operations on a transient
  hiccup.

Adds two new HRESULTs:
- WSL_E_CONTAINER_DISABLED (0x33)
- WSL_E_REGISTRY_BLOCKED_BY_POLICY (0x34)

Adds PolicyTests covering disabled-state, CLI surfacing, allowlist
denial, build rejection, and pure-function unit tests for the allowlist
evaluator.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@benhillis benhillis force-pushed the user/benhill/wslc-policies branch from 753c107 to 8a6fcae Compare May 8, 2026 22:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants