About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
β οΈ
windows_first
β οΈ
missing_linux_example
Summary:
The documentation demonstrates a moderate Windows bias. While the configuration steps are generally platform-agnostic (using Azure Portal, CLI, Bicep, ARM), the only detailed application code samples for direct certificate access and validation in .NET are for ASP.NET Core and ASP.NET Web Formsβboth Windows-centric frameworks. There are no Linux-native web server (e.g., Nginx, Apache) configuration examples, nor are there any command-line examples for Linux (such as using OpenSSL or curl for testing mutual TLS). The documentation assumes the use of the X-ARR-ClientCert header, which is specific to Azure App Service's reverse proxy, but does not discuss how to set up or validate client certificates in a Linux-native environment outside of .NET or Node/Java/Python frameworks.
Recommendations:
- Add examples for configuring mutual TLS on Linux-native web servers such as Nginx and Apache, including relevant configuration snippets.
- Include Linux command-line examples for testing mutual TLS endpoints (e.g., using curl with client certificates).
- Provide parity in code samples for popular Linux-first frameworks (e.g., FastAPI for Python, Ktor for Kotlin, Go net/http).
- Clarify that the X-ARR-ClientCert header is Azure-specific and provide guidance for scenarios where apps are hosted on Linux containers or outside Azure App Service.
- Ensure that any references to Windows-specific frameworks or tools are balanced with Linux equivalents, or at least mention alternatives.
Create pull request