Skip to content

Clarify ProcessContainer networking documentation - #1077

Closed
Branden Bonaby (bbonaby) wants to merge 2 commits into
user/bbonaby/update-mxc-based-on-os-network-changesfrom
user/bbonaby/process-container-network-docs
Closed

Clarify ProcessContainer networking documentation#1077
Branden Bonaby (bbonaby) wants to merge 2 commits into
user/bbonaby/update-mxc-based-on-os-network-changesfrom
user/bbonaby/process-container-network-docs

Conversation

@bbonaby

@bbonaby Branden Bonaby (bbonaby) commented Sep 1, 2026

Copy link
Copy Markdown
Collaborator

📖 Description

Clarifies ProcessContainer networking behavior for schema 0.8.

Describes native enforcement, compatibility fallback, supported policy combinations, proxy requirements, and rejection behavior without exposing low-level OS contract details.

🔗 References

🔍 Validation

Documentation-only change.

✅ Checklist

📋 Issue Type

  • Bug fix
  • Feature
  • Task

GitHub Actions runs the PR validation build automatically. The ADO pipeline
(MXC-PR-Build) is the Azure version of the PR pipeline, kept in parity with the GitHub
Actions build; it runs on merge to main, and Microsoft reviewers with write access can trigger it
on a PR with /azp run. See docs/pull-requests.md.

If the dependency-feed-check check fails on a new dependency, the crate must be added to
the feed before the PR can pass. See docs/pull-requests.md
for the steps.

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

@microsoft-github-policy-service microsoft-github-policy-service Bot added the Copilot-Instructions PR modifies Copilot instruction files (.github/copilot-instructions.md or .github/instructions/) label Sep 1, 2026
Copilot AI balanced review requested due to automatic review settings September 1, 2026 18:40

Copilot AI left a comment

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.

Copilot review overview

Review tier: Balanced
Findings: 2 Low severity

New issues introduced by this change (2)
Severity Finding
Low severity docs/​process-container/​examples/​0.8.0-schema.md — This removes the inbound firewall authorization from the packaged AppContainer example, so the…
Low severity docs/​process-container/​networking.md — The table now presents identity/isolation as the complete additional enforcement and drops the…
What changed in this PR

Clarifies schema 0.8 ProcessContainer networking following #1076.

Changes:

  • Documents native ingress enforcement and compatibility fallbacks.
  • Updates proxy, WFP, and host-loopback behavior.
  • Simplifies implementation terminology and examples.
File Description
.github/​copilot-instructions.md Updates ProcessContainer architecture guidance.
docs/​process-container/​examples/​0.8.0-schema.md Revises proxy manifest example.
docs/​process-container/​networking.md Documents enforcement and fallback behavior.
docs/​process-container/​os-version-support.md Updates runtime capability support matrix.
docs/​sandbox-policy/​0.8.0/​networking/​networking.md Clarifies shared ProcessContainer semantics.
docs/​sandbox-policy/​0.8.0/​networking/​schema-updates.md Clarifies 0.7-to-0.8 field mapping.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 65 to +68
xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap10="http://schemas.microsoft.com/appx/manifest/uap/windows10/10"
xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
IgnorableNamespaces="uap uap10 desktop2 rescap">
IgnorableNamespaces="uap uap10">
Comment thread docs/process-container/networking.md
Copilot AI review requested due to automatic review settings September 1, 2026 18:45
Negotiate ingress support, map capabilities and policy, integrate Learning Mode, and cover selection and fallback behavior with tests.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot AI left a comment

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.

Copilot review overview

Review tier: Balanced
Findings: 1 Low severity

Pre-existing issues (1)
Severity Finding
Low severity docs/​process-container/​examples/​0.8.0-schema.md — This removes the inbound firewall authorization from the packaged AppContainer example, so the… View comment
Issues resolved since last review (1)
Severity Finding
Low severity docs/​process-container/​networking.md — The table now presents identity/isolation as the complete additional enforcement and drops the… View resolved comment

Document native enforcement, compatibility fallback, proxy requirements, and the temporary Windows Firewall requirement without exposing low-level OS contracts.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@bbonaby
Branden Bonaby (bbonaby) force-pushed the user/bbonaby/update-mxc-based-on-os-network-changes branch from 433cda9 to 51f928e Compare September 1, 2026 18:51
@bbonaby
Branden Bonaby (bbonaby) force-pushed the user/bbonaby/process-container-network-docs branch from d02f06b to c561432 Compare September 1, 2026 18:51
@bbonaby

Copy link
Copy Markdown
Collaborator Author

Superseded by #1081 after splitting the runtime implementation into #1080. The remaining proxy-firewall review finding is addressed in the replacement draft.

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

Labels

Copilot-Instructions PR modifies Copilot instruction files (.github/copilot-instructions.md or .github/instructions/)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants