Skip to content

Document NTLM legacy authentication guidance - #136154

Open
svick wants to merge 1 commit into
dotnet:mainfrom
svick:document-ntlm-legacy-auth
Open

svick wants to merge 1 commit into
dotnet:mainfrom
svick:document-ntlm-legacy-auth

Conversation

@svick

@svick svick commented Oct 20, 2026 •

Copy link
Copy Markdown
Member
  • Document that NTLM is a legacy authentication protocol intended only for compatibility with existing systems.
  • Clarify that Negotiate prefers Kerberos but can fall back to NTLM, and describe how applications can prevent NTLM selection.

Note

This pull request description was generated with GitHub Copilot.

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

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 4 pipeline(s).
12 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

@dotnet-policy-service

Copy link
Copy Markdown
Contributor

Tagging subscribers to this area: @dotnet/ncl, @bartonjs, @vcsjones
See info in area-owners.md if you want to be subscribed.

@svick
svick marked this pull request as ready for review October 20, 2026 14:20
@svick
svick requested a balanced review from Copilot October 20, 2026 14:20

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.

🟡 Changes recommended

The server guidance incorrectly implies that selecting Kerberos alone prevents NTLM on Unix with default credentials.

1 open issue
What changed in this PR

Adds XML documentation to System.Net.Security describing NTLM’s legacy role without changing runtime behavior.

Changes:

  • Recommends NTLM only for compatibility with existing systems.
  • Explains Negotiate fallback and provides guidance for avoiding NTLM.

Builds and tests were not run; verification used source inspection.

File Description
src/​libraries/​System.Net.Security/​src/​System/​Net/​Security/​NegotiateAuthenticationServerOptions.cs Adds server authentication package guidance.
src/​libraries/​System.Net.Security/​src/​System/​Net/​Security/​NegotiateAuthenticationClientOptions.cs Adds client authentication package guidance.
src/​libraries/​System.Net.Security/​src/​System/​Net/​Security/​NegotiateAuthentication.cs Documents NTLM’s legacy status and alternatives.

Review effort: Balanced

Comment on lines +33 to +34
/// can fall back to NTLM. To prevent NTLM, request Kerberos explicitly when supported
/// or use another modern authentication protocol.
@rzikm

rzikm commented Oct 20, 2026

Copy link
Copy Markdown
Member

This will not update the existing documentation online AFAIK, this will need porting to dotnet/dotnet-api-docs repo.

This branch has not been deployed

No deployments
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.

3 participants