Black Duck 云应用

您可以在 Google Compute Engine (GCE)、Amazon Web Services (AWS) 或 Azure 上使用 Black Duck。如需了解安装说明，请参阅 Black Duck 的云平台文档。

1. 在 Google 管理控制台中，依次点击“菜单”图标 应用 Web 应用和移动应用。

   前往“Web 应用和移动应用”

   您必须以超级用户身份登录，才能执行此任务。

2. 依次点击添加应用 搜索应用。

3. 在输入应用名称 部分，输入 Blackduck 。

4. 在搜索结果中，将光标指向 Blackduck ，然后点击选择 。

5. 在 Google 身份提供方详细信息窗口中，下载身份提供方元数据。

6. 点击继续。

7. 在服务提供商详细信息 页面上，对于 ACS 网址 和实体 ID ，将 {your-domain} 替换为安装 Black Duck 的网域。

8. 点击继续。

9. 在属性映射 窗口中，点击选择字段 ，然后将以下 Google 目录属性映射到各自对应的 Black Duck 属性。FirstName、LastName、Email 和 Name 是必需属性。

   Google 目录属性	Black Duck 属性
   Basic Information（基本信息）> First Name（名字）	FirstName（名字）
   Basic Information（基本信息）> Last name（姓氏）	LastName（姓氏）
   Basic Information（基本信息）> Primary Email（主电子邮件）	Email
   Basic Information（基本信息）> Primary Email（主电子邮件）	Name

10. （可选）如需添加其他映射，请点击添加映射 ，然后选择您需要映射的字段。
11. （可选）如需输入与此应用相关的群组名称，请执行以下操作：
    1. 对于群组成员资格（可选），点击搜索群组，输入群组名称的一个或多个字母，然后选择群组名称。
    2. 根据需要添加其他群组（最多 75 个群组）。
    3. 对于应用属性，输入相应服务提供商的群组属性名称。

    无论您输入多少个群组名称，SAML 回复都仅包含用户所属（直接或间接）的群组。如需了解详情，请参阅群组成员资格映射简介。

12. 点击完成 。

1. 在无痕模式下打开一个浏览器窗口，前往 Black Duck 登录页面，然后使用您的 Black Duck 管理员账号登录。

2. 点击 Administration（管理），然后选择 SAML Integration（SAML 集成）。

3. 勾选 Enable SAML （启用 SAML）复选框。

4. 在 Service Providers Entity URL（服务提供商实体网址）部分，输入登录 Hub 的网址。

5. 在 Identity Provider Metadata（身份提供方元数据）部分，粘贴您在第 1 步中下载的身份提供方元数据。

6. 点击 Save（保存）。

7. 使用 Secure Shell (SSH) 连接到 Hub 服务器。

8. 在 docker-compose 目录中，将以下行添加到 hub-proxy.env 文件末尾：HUB_SAML_EXTERNAL_URL={url-to-the-hub}。

9. 将 {url-to-the-hub} 替换为安装了 Black Duck 的实例的网址。

10. 重新启动 Hub 实例。

1. 在 Google 管理控制台中，依次点击“菜单”图标 应用 Web 应用和移动应用。

   前往“Web 应用和移动应用”

   您必须以超级用户身份登录，才能执行此任务。

2. 点击 Blackduck 。

3. 点击用户访问权限 。

4. 如要为组织中所有人启用或停用某项服务，请点击对所有人启用 或对所有人停用，然后点击保存。

5. （可选）如要为某个组织部门启用或停用服务，请执行以下操作：
   1. 在左侧，选择所需组织部门。
   2. 如要更改服务状态，请选择启用 或停用 。
   3. 根据需要执行相应操作：
      • 如果“服务状态”被设为已继承 ，而您想保留更新后的设置（即使在上级组织的设置发生变化时也保留该设置），请点击覆盖 。
      • 如果服务状态被设为已覆盖，您可以点击继承恢复为与上级组织相同的设置，也可以点击保存保留新设置（即使上级组织的设置发生变化也应用新设置）。

        详细了解组织结构。

6. （可选）如要为一个或多个组织部门内的一组用户启用某项服务，请选择一个访问权限群组。如需了解详情，请参阅 通过访问权限群组自定义服务访问权限。

7. 确保您的 Black Duck 用户账号的邮件域名与您组织受管理的 Google 账号的主域名一致。

Black Duck 仅在您通过 Google 登录时支持单点登录。如果您直接登录 Black Duck，则无法使用单点登录。

验证由身份提供方发起的单点登录

1. 在 Google 管理控制台中，依次点击“菜单”图标 应用 Web 应用和移动应用。

   前往“Web 应用和移动应用”

   您必须以超级用户身份登录，才能执行此任务。

2. 点击 Blackduck 。

3. 在 Blackduck 部分，点击测试 SAML 登录 。系统应该会在另一标签页中打开该应用。如果未打开，请根据错误消息进行问题排查，然后重试。 如需详细了解问题排查，请参阅 SAML 应用错误消息。