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_tools
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation demonstrates some Windows bias, particularly in the SSH public key authentication section, where the only example of a private key path uses a Windows-style path (D:\privatekey_openssh), and the guidance for converting PPK files references only the PuTTY tool, which is primarily a Windows utility. There are no Linux or macOS path examples, nor are Linux-native tools (like ssh-keygen or puttygen on Linux) mentioned. No Linux file path examples are provided, and the documentation does not clarify cross-platform considerations for file paths or key formats.
Recommendations:
- Provide examples using Linux/macOS-style file paths (e.g., /home/user/.ssh/id_rsa) alongside Windows paths in the SSH public key authentication section.
- Mention Linux-native tools for key conversion (e.g., ssh-keygen, puttygen on Linux) in addition to PuTTY, and provide relevant instructions or links.
- Explicitly state that both Windows and Linux file path formats are supported, and clarify any platform-specific considerations.
- Ensure that all code and configuration examples are platform-neutral or provide parallel examples for both Windows and Linux environments.
- Add a note or section addressing cross-platform compatibility, especially for self-hosted integration runtime scenarios.
Create pull request
Flagged Code Snippets
{
"name": "SftpLinkedService",
"properties": {
"type": "Sftp",
"typeProperties": {
"host": "<sftp server>",
"port": 22,
"skipHostKeyValidation": true,
"authenticationType": "SshPublicKey",
"userName": "xxx",
"privateKeyPath": "D:\\privatekey_openssh",
"passPhrase": {
"type": "SecureString",
"value": "<pass phrase>"
}
},
"connectVia": {
"referenceName": "<name of integration runtime>",
"type": "IntegrationRuntimeReference"
}
}
}