> ## 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.

# NINJIO 集成设置

> 将 NINJIO 连接到 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 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="NINJIO" />

## 此集成提供的内容

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

* `training.assigned` — 已被分配安全培训
* `training.completed` — 完成安全培训
* `training.passed` — 通过安全培训测评
* `phishing.simulation.clicked` — 点击了模拟邮件但未进行报告
* `phishing.simulation.reported` — 报告钓鱼模拟

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

## Living Security 所需的信息

| 凭据 | 说明 |
| - | - |
| **API 密钥** | 对员工、培训和网络钓鱼访问点具有读取权限的 NINJIO API 密钥。Living Security 会在每次请求中发送该密钥。 |

**权限范围:** NINJIO 按*访问点*为每个 API 密钥设置权限范围,读取和写入权限相互独立。Living Security 需要以下三个访问点的**读取**权限:员工、培训和网络钓鱼。不需要写入权限,也不应授予写入权限。

**所需角色:** NINJIO 账户的**管理员**。只有管理员才能进入创建密钥的“集成”区域。

<Warning>
  **NINJIO 仅在创建新密钥时显示一次该密钥。** 在离开页面之前,请立即将其复制到 Living Security Platform 或密码保管库中。未复制的密钥无法找回,您必须重新生成一个新密钥。
</Warning>

### Living Security 获取的内容

| 数据 | 详情 |
| - | - |
| **学员** | 您的 NINJIO 员工目录:姓名、电子邮件、部门、职位、经理、国家/地区、分支机构和有源状态。 |
| **培训** | 每项培训分配给了谁、谁已完成,以及完成日期、考试分数和参与度分数。 |
| **网络钓鱼** | 谁与模拟钓鱼邮件进行了交互、谁报告了该邮件,以及发生的时间。 |

<Note>
  **不会存储学员的电话号码。** NINJIO 会在其员工记录中返回电话号码。由于 Living Security 的任何功能都不使用该信息,因此会在存储任何数据之前将其丢弃。
</Note>

### 前提条件

* 具有 API 访问权限的 NINJIO 账户。
* [admin.goninjio.com](https://admin.goninjio.com/) 的管理员访问权限。
* NINJIO 中的学员电子邮件地址需与您其他已连接系统所使用的地址一致。Living Security 通过电子邮件将 NINJIO 学员与具体人员进行匹配。

***

## 第 A 部分 — 在 NINJIO 中操作

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

<Steps>
  <Step title="打开“集成”区域">
    1. 以管理员身份登录 [admin.goninjio.com](https://admin.goninjio.com/)。
    2. 选择屏幕右上角的 **Integration**。
  </Step>

  <Step title="创建 API 密钥">
    1. 选择 **New API Key**。
    2. 为密钥指定一个日后便于识别的名称,例如 `Living Security`。
    3. 授予对**员工**、**培训**和**网络钓鱼**访问点的**读取**权限。
    4. 不要选择写入权限。Living Security 仅从 NINJIO 读取数据。
    5. 选择 **Generate Key**。

    <Warning>
      请立即复制该密钥。NINJIO 仅显示一次,之后无法再次显示。
    </Warning>
  </Step>
</Steps>

***

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

*由项目负责人完成此步骤;如果使用委派设置,则由系统管理员完成。*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | 字段 | 值 |
    | - | - |
    | **API 密钥** | 您在第 A 部分中生成的密钥 |
  </ConnectInPlatform>
</Steps>

至此,您已连接到 NINJIO。

***

## 数据获取频率

| 数据 | 计划 |
| - | - |
| 学员 | 每天 |
| 培训结果 | 每 6 小时 |
| 网络钓鱼结果 | 每 6 小时 |

首次连接时,Living Security 会获取过去 12 个月的培训完成记录,之后持续进行增量同步。每个钓鱼模拟只读取一次,并在其结束后的两周内重新检查,以便仍能捕获延迟的点击和延迟的报告。

<Note>
  对于规模较大的 NINJIO 账户,首次连接可能需要多次计划运行才能读取完所有数据。每次运行会尽可能多地读取数据,下一次运行则从上次停止的位置继续,因此数量会在第一两天内逐步增长,而不是一次性全部显示。
</Note>

***

## 故障排除

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 密钥有误或不完整。最常见的原因是密钥只复制了一部分:NINJIO 仅显示一次密钥,因此很容易粘贴出被截断的内容,而且事后无法发现。请在 NINJIO 中生成新密钥,并使用新密钥重新连接。
  </Accordion>

  <Accordion title="403 Forbidden">
    这**不是**凭据问题。密钥已通过身份验证,但其所需的某个访问点未被授予读取权限。

    重新粘贴同一个密钥无济于事。请在 NINJIO 中创建一个对员工、培训和网络钓鱼这三个访问点均具有**读取**权限的密钥,并使用该密钥重新连接。
  </Accordion>

  <Accordion title="连接成功但没有培训数据">
    请在 NINJIO 中检查是否至少有一个培训活动处于**有源**状态,并且已关联模拟。未关联模拟的活动会保持未激活状态,不会产生任何内容,因此没有可获取的结果。

    如果活动处于有源状态,请确认其中的学员在 NINJIO 记录中有电子邮件地址。没有电子邮件地址的学员无法与具体人员匹配,将被跳过。
  </Accordion>

  <Accordion title="培训显示为已分配但从未完成">
    对于学员尚未完成的培训,这是预期的显示方式。Living Security 会在 NINJIO 模拟开始时记录分配,并在 NINJIO 报告完成日期时单独记录完成情况。
  </Accordion>

  <Accordion title="部分学员缺失">
    Living Security 通过**电子邮件地址**将 NINJIO 学员与具体人员进行匹配。如果学员在 NINJIO 中的电子邮件与您的目录中保存的地址不同(例如个人邮箱、旧域名或拼写错误),则无法匹配。

    请在 NINJIO 中更正该地址,下一次计划获取时即可完成匹配。
  </Accordion>

  <Accordion title="较早的钓鱼模拟缺少结果">
    Living Security 会在钓鱼模拟结束后的两周内重新检查,之后即停止。NINJIO 在该时间窗口之后记录的结果不会被获取。如需重新读取较早的模拟,请联系支持团队。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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