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 'windows_first' bias by providing detailed ASP.NET Core and ASP.NET Web Forms (Windows-centric) code samples before other platforms, and by referencing Windows-specific request properties (e.g., HttpRequest.ClientCertificate) without equivalent Linux or cross-platform details. There is also a 'missing_linux_example' bias: the documentation does not show how to access the client certificate directly in a Linux-native environment (e.g., using NGINX/Apache on Linux), nor does it mention Linux command-line tools (such as OpenSSL) or Linux-specific configuration patterns for mutual TLS. All code samples assume the Azure App Service's forwarding of the certificate via the X-ARR-ClientCert header, which is platform-agnostic, but the narrative and ordering favor Windows/.NET scenarios.
Recommendations:
- Add explicit examples or notes for configuring and validating client certificates in Linux-native environments, such as using NGINX or Apache as a reverse proxy in front of App Service (Linux), including relevant configuration snippets.
- Include Linux command-line examples (e.g., using OpenSSL) for generating, inspecting, and testing client certificates, alongside or before any Windows-centric tools.
- Reorder or balance the code sample sections so that Linux-friendly stacks (Node.js, Python, Java) are presented before or alongside Windows/.NET examples, or clarify that the order is not indicative of platform preference.
- Where Windows-specific properties or patterns are mentioned (e.g., HttpRequest.ClientCertificate), provide equivalent guidance for Linux or cross-platform frameworks, or clarify their applicability.
- Add a section or note about how mutual TLS works in App Service (Linux) and any differences in behavior or configuration compared to App Service (Windows), if applicable.
Create pull request