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

# Adaptive Security 集成设置

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

## 此集成提供的数据

Adaptive Security 可以提供员工队伍、培训以及多渠道模拟的成效数据。已审核的示例包括：

* `phishing.simulation.clicked` — 点击了模拟邮件但未进行报告
* `phishing.simulation.credential.submitted` — 在模拟登录页面上输入了凭据
* `phishing.simulation.attachment.opened` — 打开了模拟邮件中的附件
* `phishing.simulation.reported` — 报告了模拟邮件
* `smishing.simulation.replied` — 回复了模拟短信
* `vishing.simulation.succeeded` — 听从了模拟语音来电者的要求
* `training.assigned` — 被分配了安全培训
* `training.completed` — 完成了安全培训
* `training.past.due` — 错过了培训截止日期

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

<Note>
  **Adaptive 通过三种渠道进行模拟，Living Security 对每种渠道分别评分。**
  邮件成效按网络钓鱼评分，短信成效按短信钓鱼评分，语音通话成效按语音钓鱼评分。点击模拟邮件的人与回复模拟短信的人不会被视为相同的行为，因为两者所做的判断不同。
</Note>

## Living Security 所需的信息

| 凭据 | 说明 |
| - | - |
| **API 令牌** | Adaptive Security API 令牌。Living Security 在每次请求中都会将其作为 bearer 令牌发送。 |

**所需角色：** 在您的 Adaptive Security 账户中具有 **Settings → API** 访问权限的管理员。Adaptive 通过基于角色的权限来控制 API 访问，因此该令牌必须属于能够读取用户、网络钓鱼和培训数据的角色。

**访问权限：** 只读。Living Security 仅从 Adaptive Security 读取数据，绝不会在您的账户中创建、更改或删除任何内容。

### Living Security 获取的数据

| 数据 | 详情 |
| - | - |
| **人** | 您的 Adaptive 用户目录：姓名、电子邮件、部门、职位、经理姓名和电子邮件、所在地、事业部、雇佣状态和入职日期。 |
| **邮件模拟** | 每人每次模拟：邮件被送达、打开、点击、回复、附件被打开、二维码被扫描、凭据被输入或被报告的时间。 |
| **短信模拟** | 每人每次模拟：已送达、已打开、已点击、已回复、已输入凭据或已报告。 |
| **语音模拟** | 每人每次模拟：诱饵已送达、所拨打的号码、该人员是否听从了来电者的要求，以及是否进行了报告。 |
| **培训** | 每人每个活动：注册时间、截止时间、开始时间、完成时间，以及是否已确认活动政策。 |

<Note>
  **不会存储电话号码。** Adaptive 会在其用户记录中返回办公电话和手机号码。由于 Living Security 的任何功能都不会使用这些号码，因此在存储任何数据之前会将两者丢弃。
</Note>

<Note>
  **Adaptive 自身的风险评分会被记录，但绝不会用于评分。** Adaptive 会为每个人计算一个 `current_risk_score`。Living Security 会保留该数据，以便您并排比较两个系统，但人员风险指数始终基于观察到的行为，并使用 Living Security 自己发布的模型计算，绝不会采用其他供应商的综合评分。
</Note>

### 前提条件

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

***

## 第 A 部分 — 在 Adaptive Security 中操作

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

<Steps>
  <Step title="打开 API 设置">
    1. 以管理员身份登录 [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com)。
    2. 转到 **Settings → API**。
  </Step>

  <Step title="生成 API 令牌">
    1. 生成新的 API 令牌。
    2. 为其指定一个日后便于识别的名称，例如 `Living Security`。
    3. 确认该令牌的角色可以读取用户、网络钓鱼活动和培训活动。
    4. 复制该令牌。

    <Warning>
      请在离开页面之前复制令牌。如果您的 Adaptive 账户为令牌设置了有效期，请记下到期日期：令牌到期后，Living Security 将无法获取数据，必须使用新令牌更新连接。
    </Warning>
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | 字段 | 值 |
    | - | - |
    | **API 令牌** | 您在第 A 部分中生成的令牌 |
  </ConnectInPlatform>
</Steps>

至此，您已连接到 Adaptive Security。

***

## 数据获取频率

| 数据 | 计划 |
| - | - |
| 人 | 每 6 小时 |
| 模拟成效（邮件、短信、语音） | 每 6 小时 |
| 培训结果 | 每 6 小时 |

Adaptive 的报告 API 不提供“自上次以来的变更”筛选条件，因此 Living Security 会在每个模拟和培训活动仍在产生成效期间持续读取，并在其关闭两周后停止读取。这样，迟到的点击和迟到的报告仍可被捕获，同时已结束的活动也不会被无限期地重复读取。

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

***

## 故障排除

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 令牌有误、已过期或已被撤销。Adaptive 在此错误下返回空的响应正文，因此没有更多详细信息可供查看。请在 **Settings → API** 中生成新令牌，并使用该令牌重新连接。令牌复制不完整也会导致同样的错误，并且这是最常见的原因。
  </Accordion>

  <Accordion title="403 Forbidden">
    令牌已通过身份验证，但其角色无法读取所请求的数据。重新粘贴同一令牌没有帮助。请在 Adaptive 中确认该令牌的角色对用户、网络钓鱼和培训具有读取权限，或使用具备这些权限的角色签发令牌。
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive 对该连接进行了速率限制。Living Security 会停止本次运行，并在下一次计划运行时从同一位置继续，因此不会丢失任何数据，只是计数增长所需的时间会更长。如果此情况持续数天，请联系 Adaptive Security 支持团队，询问适用于您账户的速率限制。
  </Accordion>

  <Accordion title="显示了人员，但没有模拟成效">
    请检查您预期的活动是否已实际运行。Adaptive 仅会报告已发送模拟的注册信息，因此处于 **Draft** 或 **Scheduled** 状态的活动在发出之前不会提供任何数据。Living Security 有意不读取这些活动，以便将其请求额度用于已产生实际成效的活动。
  </Accordion>

  <Accordion title="缺少语音或短信模拟">
    Living Security 根据每个成效所关联的场景来判定其渠道。如果某个场景在其模拟运行后于 Adaptive 中被删除，则由于无法再读取渠道信息，其成效将记录到邮件渠道下。在 Adaptive 中保留已停用的场景而不是删除它们，可以避免此问题。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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