Connector Hdfs - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

windows_first

windows_tools

powershell_heavy

missing_linux_example

Summary

The documentation exhibits a clear Windows bias. Windows authentication is emphasized as a primary method, with detailed instructions and examples for configuring Kerberos and integration runtime on Windows. Windows-specific tools (such as Ksetup and netdom) and UI navigation are described in detail, while Linux equivalents (such as kinit, realm join, or krb5.conf editing on Linux) are either omitted or only briefly mentioned. There are no step-by-step Linux-based integration runtime setup or authentication examples, and all command-line configuration examples for the integration runtime use Windows CMD or PowerShell syntax.

Recommendations

Provide equivalent Linux-based instructions for setting up the self-hosted integration runtime in a Kerberos realm, including commands for joining a Linux machine to a Kerberos realm and configuring krb5.conf.
Include Linux command-line examples (e.g., kinit, klist, editing /etc/krb5.conf) alongside Windows (Ksetup/netdom) commands.
Clarify that the integration runtime can run on Linux, if supported, and provide explicit Linux setup steps.
Add UI screenshots or instructions for Linux environments where applicable.
Ensure authentication examples include both Windows and Linux user scenarios, and explain any differences in required configuration files or environment variables.
Where Windows tools are mentioned (Ksetup, netdom), mention and demonstrate the Linux equivalents or alternatives.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

Flagged Code Snippets

   C:> Ksetup /addkdc REALM.COM <your_kdc_server_address>
   C:> ksetup /addhosttorealmmap HDFS-service-FQDN REALM.COM

{
    "name": "HDFSLinkedService",
    "properties": {
        "type": "Hdfs",
        "typeProperties": {
            "url" : "http://<machine>:50070/webhdfs/v1/",
            "authenticationType": "Windows",
            "userName": "<username>@<domain>.com (for Kerberos auth)",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

    C:> Ksetup /addkdc REALM.COM <your_kdc_server_address>
    C:> ksetup /addhosttorealmmap HDFS-service-FQDN REALM.COM

    C:> netdom trust REALM.COM /Domain: AD.COM /add /realm /password:[password]

    C:> ksetup /SetEncTypeAttr REALM.COM DES-CBC-CRC DES-CBC-MD5 RC4-HMAC-MD5 AES128-CTS-HMAC-SHA1-96 AES256-CTS-HMAC-SHA1-96