Skip to main content

​
此集成提供的内容

KnowBe4 可提供员工队伍、培训和钓鱼模拟方面的成效数据。已审核的示例包括：
  • training.completed — 完成安全培训
  • training.past.due — 存在逾期培训
  • phishing.simulation.clicked — 点击了模拟邮件但未进行报告
这些示例展示了 Living Security 可以使用的各类标准化活动。请参阅集成数据如何转化为信号。

​
Living Security 所需的信息

权限范围： 无需配置——KnowBe4 Reporting API 令牌在设计上为只读，不限定权限范围。该令牌授予对用户、培训注册信息和钓鱼安全测试结果的读取权限，而这正是同步所需读取的内容。 所需角色： KnowBe4 中的 Account Admin（只有账户管理员才能访问 Account Settings → API）

​
前提条件

  • 您必须使用 Account Admin 角色登录 KnowBe4 控制台。只有账户管理员才能访问 Account Settings → API 以启用 Reporting API 并生成令牌。

​
第 A 部分 — 在 KnowBe4 中

由您的 KnowBe4 管理员完成以下步骤。
1

启用 Reporting API 并生成令牌

  1. 登录您的 KnowBe4 控制台。
  2. 单击右上角的账户名称，然后选择 Account Settings。
  3. 在左侧导航栏中，选择 API。
  4. 如果尚未启用 Reporting API，请先启用，然后生成新的 API 令牌。
如果控制台提示填写用途，请为令牌提供具有描述性的用途说明（例如 Living Security Platform）。
KnowBe4 仅在生成时显示一次 API 令牌值。请立即复制并存放在安全的位置（例如密码保管库或机密管理器）。如果未复制就离开此页面，则必须重新生成令牌。
Reporting API 为只读。它提供用户、培训注册信息和钓鱼安全测试结果——即 Living Security 用于评分和报告而摄取的数据。无需写入权限。
2

将 Living Security 出站 IP 添加到 Allowed IP Addresses 列表

KnowBe4 允许您将 Reporting API 的访问限制在一组特定的源 IP 地址范围内。此设置与令牌位于同一位置：
  1. 在您的 KnowBe4 控制台中，前往 Account Settings → API → Allowed IP Addresses。
  2. 将每个 Living Security 出站 IP 地址添加到允许列表中。在所有区域，这四个地址均相同。
如果已配置 Allowed IP Addresses 列表，则会在网络层强制执行。 连接对话框在身份验证阶段会显示成功，但数据同步将会失败（在网络层被拦截，通常表现为 403），直到 Living Security 出站 IP 被添加到允许列表中。如果您向此列表中添加了任何地址，则还必须添加 Living Security 的地址范围，否则即使您的令牌有效，我们的请求也会被拒绝。
Living Security 的出站 IP 地址可能会在基础设施更新时发生变化，但我们会尽量减少此类变更。如果数据同步在之前正常的情况下开始失败，请查看配置集成出站 IP 地址，并确认 Allowed IP Addresses 列表与之一致。
3

确定您的 KnowBe4 服务器区域

KnowBe4 通过特定区域的主机提供 Reporting API。您只需在连接对话框中选择区域，而无需输入主机名：如果您不确定账户使用的是哪个区域，请查看 KnowBe4 控制台 URL 的域名，或联系您的 KnowBe4 管理员。
Living Security 仅能访问这五个区域。如果您的 KnowBe4 账户位于其他服务器上（例如美国政府实例），请在开始连接之前联系 Living Security 支持团队。

​
第 B 部分 — 在 Living Security Platform 中

由项目负责人完成此步骤；如果采用委托设置，则由系统管理员完成。
您现已连接到 KnowBe4。

​
故障排除

API 令牌无效或已过期。请确认令牌正确，且未在 Account Settings → API 中被重新生成。
可能是令牌缺少 Reporting API 访问权限，也可能是请求的 IP 不在 Allowed IP Addresses 列表中。请确认已启用 Reporting API，并且全部四个 Living Security 出站 IP 地址均已在允许列表中。
Reporting API 可能尚无可返回的数据，或者令牌所属账户无法查看 Living Security 所摄取的用户和活动。请确认该令牌由 Account Admin 生成。