Skip to content

Clarify named pipe impersonation permissions - #13318

Open
jeffhandley wants to merge 1 commit into
mainfrom
jeffhandley/runasclient-api-docs-caution
Open

jeffhandley wants to merge 1 commit into
mainfrom
jeffhandley/runasclient-api-docs-caution

Conversation

@jeffhandley

@jeffhandley jeffhandley commented Nov 14, 2026 •

Copy link
Copy Markdown
Member

Summary

On Linux and macOS, RunAsClient changes the effective user ID without changing the server's group identity, so impersonation alone is not an authorization boundary.

Clarify the platform-specific behavior and process-wide user ID change, recommend explicit authorization checks, and caution readers of the client-supplied file path example.


Internal previews

File Preview link
xml/System.CommandLine.DragonFruit/CommandLine.xml Learn preview
xml/System.CommandLine.Hosting/HostingExtensions.xml Learn preview
xml/System.IO.Pipes/NamedPipeServerStream.xml Learn preview

Build report

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@jeffhandley
jeffhandley requested a review from a team as a code owner November 14, 2026 12:03
Copilot AI balanced review requested due to automatic review settings November 14, 2026 12:03

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.

🟢 Approval recommended

No active review issues are recorded for the named-pipe impersonation documentation update.

No open issues 🎉

What changed in this PR

Clarifies named-pipe impersonation in the .NET API reference, explaining why impersonation alone is not an authorization boundary on Linux and macOS.

Changes:

  • Documents Windows thread-scoped impersonation and Linux/macOS process-wide effective user ID changes, with server group identities unchanged.
  • Removes broad file-access guarantees and recommends explicit authorization checks for client-supplied paths.
File Description
xml/​System.IO.Pipes/​NamedPipeServerStream.xml Updates impersonation remarks and example guidance with platform-specific behavior and authorization cautions.

Review effort: Balanced

@jeffhandley
jeffhandley requested a review from jozkee November 14, 2026 12:09
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