如何通过Rest API实现Power BI与BlackDuck的连接及认证？

下面是几种在Power Query中对接BlackDuck API的实用认证方案，都是实际场景里常用的：

1. API Token 认证（生产环境首选） #

这是BlackDuck官方推荐的认证方式，安全性高且易维护：

• 先在BlackDuck后台生成Token：登录后进入个人设置 → 找到「API Tokens」选项 → 创建新Token，务必保存好生成的字符串（仅显示一次）
• 在Power Query里构建请求时，把Token放到请求头中，示例代码：

  let
      url = "https://你的BlackDuck实例地址/api/projects",
      headers = [
          #"Authorization" = "token 你的API_TOKEN",
          #"Accept" = "application/json"
      ],
      response = Web.Contents(url, [Headers=headers])
  in
      response
  

• 注意：如果实例启用了SSL，若Power Query报证书错误，可在Web.Contents的参数里添加[ManualStatusHandling={401, 403}]来调试认证问题

2. 用户名密码基础认证（仅临时测试用） #

这种方式简单但安全性差，只适合短期测试场景：

• 将用户名和密码用Base64编码后放入请求头，示例代码：

  let
      username = "你的用户名",
      password = "你的密码",
      authString = "Basic " & Binary.ToText(Text.ToBinary(username & ":" & password), BinaryEncoding.Base64),
      headers = [
          #"Authorization" = authString,
          #"Accept" = "application/json"
      ],
      response = Web.Contents("https://你的BlackDuck实例地址/api/projects", [Headers=headers])
  in
      response
  

• 提醒：生产环境绝对禁用，密码泄露风险极大，且BlackDuck后续可能限制该认证方式

3. OAuth2 认证（企业级场景） #

如果你的BlackDuck配置了OAuth2集成（比如和企业SAML系统联动），可采用授权码流程：

• 流程为：先获取授权码，再交换访问令牌，最后用令牌调用API
• 在Power Query里需要手动构建请求，或自定义Power BI OAuth连接器，步骤相对繁琐，适合有严格身份管理要求的企业
• 最终请求头格式：#"Authorization" = "Bearer 你的访问令牌"

Power Query 配套实用技巧 #

• 将认证信息做成Power BI参数（比如创建BlackDuckAPIKey参数），代码中直接引用，避免硬编码，后期修改更便捷
• 处理分页：BlackDuck API结果大多分页，需用Power Query循环获取全部数据——先查看响应中的totalCount和limit，再拼接?offset=xxx请求下一页
• 调试技巧：利用Web.Contents的ResponseHeaders选项查看返回头，快速定位问题（比如401代表令牌无效，403代表权限不足）

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