Workiva支持中心

借助 BlackLine® OAuth2 连接器，您可以 按顺序使用 命令与 BlackLine 进行交互，例如：

• 从 BlackLine 查看和下载报告
• 在 BlackLine 中导入和管理数据，包括：
  • 账户
  • 余额
  • 货币汇率
  • 子账
  • 实体
  • 任务
  • 用户

注: 此连接器由 Workiva 构建，并连接到第三方系统。虽然我们的支持团队可以帮助您在工作区内配置此连接器，但我们无法对源自 Workiva 平台之外的任何问题进行故障排除或提供其他帮助。

先决条件

要设置连接器，您需要：

• 要连接的 BlackLine 实例的主机名，例如 sbus2.api.blackline.com
• 为 BlackLine 服务帐户设置的集成用户的用户名和 API 密钥

  注意： 集成用户需要 API 授权角色和集成权限，以及连接器将执行的任务所需的角色和范围。要在 BlackLine 中创建 API 密钥，请在集成用户详细信息 的“用户信息”下 ，单击 “生成 API 密钥 ”

  。
• 仅支持 Blackline API 版本 2.0
• 集成用户的客户端凭据和 OAuth 范围，由您的 BlackLine 集成团队提供

  。注： 如果您需要客户端 ID、客户端密钥或范围，请联系您的 BlackLine 代表。

设置 BlackLine OAuth2 连接器

注： 要使连接器可在您组织的链中使用， 组织安全管理员首先需要在配置中启用它。

1. 从 链构建器中，单击 连接比较箭头，然后单击右上角的 创建 。
2. 在 连接器连接下，选择 BlackLine OAuth2和默认的 CloudRunner。
   
3. 输入唯一的名称和描述，以帮助识别连接。
4. 在 属性下，输入连接的详细信息：
   
   

   摘要信息	详细信息
   用户名	请输入 BlackLine 集成用户的用户名。
   密码	输入为 BlackLine 集成用户生成的 API 密钥。 注意：要在 BlackLine 中创建或刷新 API 密钥，请在集成用户详细信息的 用户信息 [] 下，单击 生成 以API 密钥 。这 不是用于登录 BlackLine 在线平台 的密码 。
   客户ID	输入您的 BlackLine 集成团队提供的客户 ID。
   客户机密	输入您的 BlackLine 集成团队提供的客户端密钥。
   作用域	输入由您的 BlackLine 集成团队提供的集成用户的 OAuth 范围。连接器将使用这些相同的示波器。
   实例主机名	输入要连接的 BlackLine 实例的主机名， 不带 https ://。例如，对于默认开发环境， sbus2.api.blackline.com。

   注意：所有敏感凭证均会自动加密，并以高级加密标准 (AES ) -256 加密方式存储

   。
5. 选择要使用连接的环境，然后单击 保存。
6. 要测试连接， 创建并运行链 使用 BlackLine OAuth2 连接器的 List Reports 命令，并验证它是否返回有效输出。

疑难解答

如果与 BlackLine 的连接失败：

• 验证您的 BlackLine 集成团队提供的客户端凭据和 OAuth 范围。如果您需要 OAuth 范围、客户端 ID 或密钥，请联系您的 BlackLine 代表。
• 请确保集成用户的用户名和 API 密钥正确。

  注意： 集成用户的 API 密钥可能会过期。要在 BlackLine 中刷新 API 密钥，请在集成用户详细信息 的“ 用户信息 ”下 ，点击 “生成 API 密钥 ”

  。
• 确认集成用户拥有 API 授权以及执行与连接命令相关的任务所需的适当角色和权限范围。
• 请确认已为连接器输入正确的 BlackLine 实例主机名。