如何在Azure Data Factory中连接ADO REST API及解决401授权错误

链接服务配置检查 #

• 确认认证类型选择OAuth 2.0（Azure Active Directory服务主体）：这是ADO REST API最常用的兼容认证方式，避免使用其他不匹配的认证类型。
• 验证服务主体权限：
  • 给服务主体分配ADO环境的应用权限（如Dataverse.Read.All），并确保租户管理员已完成权限同意操作；若使用委派权限，需确认关联的用户账号有权访问目标ADO环境。
  • 检查服务主体是否被添加到ADO环境的安全组中，确保其具备基础环境访问权限。
• 核对认证参数：租户ID、服务主体ID、客户端密码（或证书）必须准确无误，无拼写错误或格式问题；若使用证书，需确认证书未过期且完整上传。
• 基础URL正确性：确保链接服务的基础URL为ADO环境的REST端点，格式为https://<your-org-name>.crm.dynamics.com/api/data/v9.2/，替换<your-org-name>为实际环境名称。

数据集配置验证 #

• 关联正确的链接服务：数据集选择的链接服务必须是上述已配置的实例，避免选错链接服务导致认证链路断裂。
• 相对URL设置：相对URL需指向合法的ADO REST资源，例如实体路径accounts或特定API端点，不能为空或填写错误路径。
• 请求头配置：添加Accept: application/json请求头，确保ADO返回ADF可解析的JSON格式数据。
• 预览数据的认证选项：确认预览数据时使用链接服务的认证信息，不要手动输入无效的认证参数。

额外排查要点 #

• 先测试链接服务连通性：在链接服务页面点击“测试连接”，确认连接成功后再预览数据集，排除链接服务本身的配置问题。
• 检查凭证有效性：客户端密码或证书是否过期，若过期需更新服务主体的凭证信息并同步到ADF链接服务中。
• 托管身份场景排查：若使用ADF托管身份认证，需确保托管身份已被授予ADO环境的对应权限，且链接服务中正确选择“托管身份”认证类型。

内容的提问来源于stack exchange，提问作者user21510438