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

# Cofense PhishMe 集成设置

> 将 Cofense PhishMe 连接到 Living Security，以获取钓鱼模拟的投递、交互和报告活动数据。

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="Cofense PhishMe" recommendDelegated={true} />

## 此集成提供的数据

Cofense PhishMe 可提供标准化的钓鱼模拟投递、交互和报告活动数据。已审核的示例包括：

* `phishing.simulation.clicked` — 点击了模拟邮件但未进行报告
* `phishing.simulation.attachment.opened` — 打开钓鱼模拟附件
* `phishing.simulation.credential.submitted` — 向钓鱼模拟提交凭据

请参阅[集成数据如何转化为信号](/zh-Hans/signals/data-sources)。

## Living Security 所需信息

| 凭据 | 说明 |
| - | - |
| **API 令牌** | 可访问场景结果的 Cofense PhishMe API 令牌。 |
| **PhishMe 主机** | 您的租户或区域主机名，不含 `https://` 和结尾斜杠。 |

如果您的 Cofense 租户支持限定范围的凭据，请使用专用的只读令牌。

## 设置

<Steps>
  <Step title="创建 Cofense API 令牌">
    在 Cofense PhishMe 中，为 Living Security 创建一个专用的 API 令牌，并授予其读取场景及其结果导出的权限。请妥善保存该令牌。
  </Step>

  <Step title="确认租户主机">
    记录您登录 PhishMe 时使用的主机名，例如 `login.phishme.com` 或分配给您所在区域的主机名。
  </Step>

  <ConnectInPlatform tile="Cofense PhishMe">
    输入主机名和 API 令牌，然后连接。
  </ConnectInPlatform>
</Steps>

## 验证与故障排除

请确认连接测试能够读取场景。如果租户中包含大量模拟，首次历史数据导入可能需要更长时间。

<AccordionGroup>
  <Accordion title="401 或 403 响应">
    请确认令牌处于有效状态，并且可以读取场景结果。如果令牌已轮换，请使用新令牌重新连接。
  </Accordion>

  <Accordion title="API 令牌繁忙">
    Cofense 在生成报告期间可能会暂时锁定令牌。请等待当前同步重试完成后，再开始新的连接测试。
  </Accordion>

  <Accordion title="未返回任何场景">
    请确认该凭据能够查看已完成的场景，并且主机名与签发该令牌的 Cofense 租户属于同一租户。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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