Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits a clear Windows bias in its hybrid/on-premises sections. It exclusively references Windows-specific technologies such as PowerShell cmdlets (Set-AzDataFactoryV2LinkedService, New-AzDataFactoryV2LinkedServiceEncryptedCredential), Windows DPAPI for credential encryption, and Windows Firewall for local firewall configuration. There are no Linux or cross-platform equivalents mentioned, nor are there examples for Linux-based deployments of the self-hosted integration runtime. The port requirements and credential management instructions are tailored to Windows environments, with no guidance for Linux users.
Recommendations
- Provide Linux-specific instructions for installing and configuring the self-hosted integration runtime, including credential encryption and storage.
- Include examples using Linux command-line tools (e.g., bash scripts, OpenSSL, systemd services) for credential management and runtime configuration.
- Document how credential encryption is handled on Linux (e.g., using libsecret, GnuPG, or other secure storage mechanisms) instead of or in addition to Windows DPAPI.
- Mention Linux firewall configuration (e.g., iptables, firewalld, ufw) alongside Windows Firewall, and provide port opening instructions for both platforms.
- Offer parity in PowerShell and bash/CLI examples for all credential and runtime management tasks.
- Clarify any platform-specific limitations or differences in security features between Windows and Linux deployments.
Create Pull Request