Add Orleans Transport Layer Security (TLS) documentation

[Copilot]

• Create new documentation article for Orleans TLS configuration
• Add article to table of contents (toc.yml)
• Create code snippets folder structure
• Create C# sample code for silo TLS configuration
• Create C# sample code for client TLS configuration
• Test and validate all code snippets compile
• Add ai-usage frontmatter to indicate AI-assisted content
• Review and finalize documentation
• Address code review feedback: Remove explicit protocol version setting to align with best practice of using OS defaults
• Address PR comments:
  • Removed all Visual Basic examples
  • Updated code to use context.HostingEnvironment.IsDevelopment() instead of manual environment variable check
  • Added mTLS acronym to article title and description
  • Updated title to include "Orleans" product name
• Add solution file and README to ensure samples build properly

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[New article]: Orleans TLS documentation</issue_title>
<issue_description>### Proposed topic or title

Configuring Transport Layer Security (TLS) in Microsoft Orleans

Location in table of contents.

dotnet/orleans/host/

Reason for the article

Developers need to learn how to configure mutual TLS to secure deployments. There is an existing sample here, but full docs are needed.

Article abstract

Learn how to configure mTLS in Orleans to secure network communication between hosts.

Relevant searches

No response</issue_description>

<agent_instructions>Look at samples (https://github.com/dotnet/samples/tree/main/orleans/TransportLayerSecurity), Orleans code (https://github.com/dotnet/orleans), and API docs to see what needs to be considered. Read online docs for best practices such as https://learn.microsoft.com/en-us/dotnet/framework/network-programming/tls</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes [New article]: Orleans TLS documentation #49511

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

---

Internal previews

📄 File	🔗 Preview link
docs/orleans/host/transport-layer-security.md	Orleans Transport Layer Security (TLS)
docs/orleans/toc.yml	docs/orleans/toc

[ReubenBond]

@copilot please address the comments I left and address the failed GitHub Actions checks.

[Copilot]

@copilot please address the comments I left and address the failed GitHub Actions checks.

Addressed all feedback in commit 3b308aa:

• Removed all VB examples
• Updated to use context.HostingEnvironment.IsDevelopment()
• Added mTLS acronym to title and description
• Updated title to "Orleans Transport Layer Security (TLS)"

All code examples compile successfully.

[ReubenBond]

@copilot make sure the samples build

[Copilot]

@copilot make sure the samples build

Verified samples build successfully. Added solution file in commit 1c0c8a9 and README in commit 07d6f8c for easier building. Both projects compile without errors or warnings.

[Copilot]

Pull request overview

Adds new Orleans documentation and accompanying snippet projects to show how to configure Transport Layer Security (TLS), including mutual TLS (mTLS) scenarios, for silo-to-silo and client-to-silo communication.

Changes:

• Adds a new Orleans hosting article covering TLS configuration patterns, best practices, and references.
• Updates the Orleans TOC to include the new TLS article.
• Introduces buildable C# snippet projects for silo and client TLS configuration examples.

Reviewed changes

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

Show a summary per file

File	Description
docs/orleans/toc.yml	Adds the new TLS article entry under Orleans host documentation.
docs/orleans/host/transport-layer-security.md	New how-to article describing TLS/mTLS configuration for Orleans silos and clients.
docs/orleans/host/snippets/transport-layer-security/csharp/SiloExample/SiloExample.csproj	Adds a silo snippet project to compile TLS configuration examples.
docs/orleans/host/snippets/transport-layer-security/csharp/SiloExample/Program.cs	Adds silo TLS example code blocks referenced by the article.
docs/orleans/host/snippets/transport-layer-security/csharp/ClientExample/ClientExample.csproj	Adds a client snippet project to compile TLS configuration examples.
docs/orleans/host/snippets/transport-layer-security/csharp/ClientExample/Program.cs	Adds client TLS example code blocks referenced by the article.
docs/orleans/host/snippets/transport-layer-security/.gitignore	Ignores build outputs for the new snippet projects.

---

You can also share your feedback on Copilot code review. Take the survey.