> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# KnowBe4 集成设置

> 将 KnowBe4 连接到 Living Security Platform，以导入用户、培训注册信息和钓鱼安全测试结果。

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>相关资源</h2>
    <ul>
      <li>
        <a href="/zh-Hans/signals/data-sources">了解集成数据如何转化为人员风险管理信号</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">探索 Living Security 集成</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">打开 Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">申请 Living Security 演示</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>请将 Living Security 同步使用的全部四个出站 IP 地址添加</strong>到{' '}
    {system} 的允许列表中。如果 {system} 要求使用 CIDR 表示法，请在每个地址后添加 <code>/32</code>，将其作为单个主机输入：
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    流量可能从这四个地址中的任意一个发出，因此仅将其中部分地址加入允许列表会导致同步间歇性失败。这四个地址在 Living Security 的所有区域中均相同。有关完整列表、变更策略和故障排除，请参阅{' '}
    <a href="/zh-Hans/integrations/managing/egress-ip-addresses">
      配置集成出站 IP 地址
    </a>。
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="在 Living Security Platform 中输入凭据">
    <p>
      由拥有 Living Security 访问权限的人员完成——即项目负责人；如果已受邀，也可由系统管理员完成（委派设置）。
    </p>
    <ol>
      <li>
        转到<strong>设置 → 集成 → 目录</strong>，找到{' '}
        <strong>{tile}</strong> 磁贴，然后单击<strong>连接</strong>。
      </li>
      <li>
        填写下方的字段，然后单击<strong>连接</strong>。
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>本指南适用于您的 {system} 管理员。</strong>本指南介绍如何在 {system} 中创建 API
      凭据，这需要 {system} 的管理员权限，而非 Living Security Platform 的管理员权限。
    </p>
    <p>
      如果您是 Living Security 的<strong>项目负责人</strong>，但并不管理 {system}，
      请将本页面转发给负责管理 {system} 的人员。由其完成 A 部分，然后将凭据交还给您
      （如果您已邀请其加入平台，则可由其直接输入凭据）。
      {recommendDelegated && <>
          {' '}由于设置过程会产生敏感的密钥材料，我们建议采用{' '}
          <strong>委派设置</strong>方式，这样密钥不会再发送给您。
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

## 此集成提供的内容

KnowBe4 可提供员工队伍、培训和钓鱼模拟方面的成效数据。已审核的示例包括：

* `training.completed` — 完成安全培训
* `training.past.due` — 存在逾期培训
* `phishing.simulation.clicked` — 点击了模拟邮件但未进行报告

这些示例展示了 Living Security 可以使用的各类标准化活动。请参阅[集成数据如何转化为信号](/zh-Hans/signals/data-sources)。

## Living Security 所需的信息

| 凭据 | 说明 |
| - | - |
| **API 密钥** | 在 **Account Settings → API** 下生成的 Reporting API 不记名令牌。在每次请求中通过 `Authorization: Bearer` 标头发送。 |
| **Reporting API 服务器区域** | 您的 KnowBe4 账户所在的区域，从列表中选择（美国、欧洲、加拿大、英国、德国）。 |

**权限范围：** 无需配置——KnowBe4 Reporting API 令牌在设计上为只读，不限定权限范围。该令牌授予对用户、培训注册信息和钓鱼安全测试结果的读取权限，而这正是同步所需读取的内容。

**所需角色：** KnowBe4 中的 **Account Admin**（只有账户管理员才能访问 **Account Settings → API**）

### 前提条件

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

***

## 第 A 部分 — 在 KnowBe4 中

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

<Steps>
  <Step title="启用 Reporting API 并生成令牌">
    1. 登录您的 KnowBe4 控制台。
    2. 单击右上角的账户名称，然后选择 **Account Settings**。
    3. 在左侧导航栏中，选择 **API**。
    4. 如果尚未启用 **Reporting API**，请先启用，然后生成新的 API 令牌。

    如果控制台提示填写用途，请为令牌提供具有描述性的用途说明（例如 `Living Security Platform`）。

    <Warning>
      KnowBe4 **仅在生成时显示一次** API 令牌值。请立即复制并存放在安全的位置（例如密码保管库或机密管理器）。如果未复制就离开此页面，则必须重新生成令牌。
    </Warning>

    <Note>
      Reporting API 为只读。它提供用户、培训注册信息和钓鱼安全测试结果——即 Living Security 用于评分和报告而摄取的数据。无需写入权限。
    </Note>
  </Step>

  <Step title="将 Living Security 出站 IP 添加到 Allowed IP Addresses 列表">
    KnowBe4 允许您将 Reporting API 的访问限制在一组特定的源 IP 地址范围内。此设置与令牌位于同一位置：

    1. 在您的 KnowBe4 控制台中，前往 **Account Settings → API → Allowed IP Addresses**。
    2. 将每个 [Living Security 出站 IP 地址](/zh-Hans/integrations/managing/egress-ip-addresses)添加到允许列表中。在所有区域，这四个地址均相同。

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **如果已配置 Allowed IP Addresses 列表，则会在网络层强制执行。** 连接对话框在身份验证阶段会显示成功，但数据同步将会失败（在网络层被拦截，通常表现为 `403`），直到 Living Security 出站 IP 被添加到允许列表中。如果您向此列表中添加了任何地址，则还必须添加 Living Security 的地址范围，否则即使您的令牌有效，我们的请求也会被拒绝。
    </Warning>

    <Note>
      Living Security 的出站 IP 地址可能会在基础设施更新时发生变化，但我们会尽量减少此类变更。如果数据同步在之前正常的情况下开始失败，请查看[配置集成出站 IP 地址](/zh-Hans/integrations/managing/egress-ip-addresses)，并确认 Allowed IP Addresses 列表与之一致。
    </Note>
  </Step>

  <Step title="确定您的 KnowBe4 服务器区域">
    KnowBe4 通过特定区域的主机提供 Reporting API。您只需在连接对话框中选择区域，而无需输入主机名：

    | 区域 | Reporting API 主机 |
    | - | - |
    | 美国 | `us.api.knowbe4.com` |
    | 欧洲 | `eu.api.knowbe4.com` |
    | 加拿大 | `ca.api.knowbe4.com` |
    | 英国 | `uk.api.knowbe4.com` |
    | 德国 | `de.api.knowbe4.com` |

    如果您不确定账户使用的是哪个区域，请查看 KnowBe4 控制台 URL 的域名，或联系您的 KnowBe4 管理员。

    <Note>
      Living Security 仅能访问这五个区域。如果您的 KnowBe4 账户位于其他服务器上（例如美国政府实例），请在开始连接之前联系 Living Security 支持团队。
    </Note>
  </Step>
</Steps>

***

## 第 B 部分 — 在 Living Security Platform 中

*由项目负责人完成此步骤；如果采用委托设置，则由系统管理员完成。*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | 字段 | 值 |
    | - | - |
    | **API 密钥** | 第 A 部分步骤 1 中的 Reporting API 令牌 |
    | **Reporting API 服务器区域** | 第 A 部分步骤 3 中的区域（例如美国） |
  </ConnectInPlatform>
</Steps>

您现已连接到 KnowBe4。

***

## 故障排除

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 令牌无效或已过期。请确认令牌正确，且未在 **Account Settings → API** 中被重新生成。
  </Accordion>

  <Accordion title="403 Forbidden">
    可能是令牌缺少 Reporting API 访问权限，也可能是请求的 IP 不在 Allowed IP Addresses 列表中。请确认已启用 Reporting API，并且全部四个 [Living Security 出站 IP 地址](/zh-Hans/integrations/managing/egress-ip-addresses)均已在允许列表中。
  </Accordion>

  <Accordion title="结果为空（200 OK 但无数据）">
    Reporting API 可能尚无可返回的数据，或者令牌所属账户无法查看 Living Security 所摄取的用户和活动。请确认该令牌由 Account Admin 生成。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.