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

# Proofpoint Security Awareness 集成设置

> 连接 Proofpoint SAT，以导入钓鱼模拟和培训数据。

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="Proofpoint SAT" />

## 此集成提供的内容

Proofpoint Security Awareness 可提供培训和钓鱼模拟方面的成效数据。已审核的示例包括：

* `training.completed` — 完成安全培训
* `phishing.simulation.attachment.opened` — 打开钓鱼模拟附件
* `phishing.real.reported` — 报告真实的钓鱼邮件

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

## Living Security 所需信息

| 凭据 | 说明 |
| - | - |
| **API token** | 从 Proofpoint SAT 门户生成的访问令牌 |
| **Regional results host** | 您的 Proofpoint SAT 环境的主机名 |

**权限范围：** 可访问 Phishing (ThreatSim) 和 PhishAlarm 报告端点

**所需角色：** Proofpoint SAT 中的 **Super Admin**、**Reporting Admin** 或 **Reporting API**

### 前提条件

* 您必须在 Proofpoint SAT 中拥有 **Super Admin** 或 **Reporting Admin** 访问权限，才能生成 API 令牌。
* 该令牌必须与具有上述所需角色之一的账户相关联。

***

## 第 A 部分 — 在 Proofpoint SAT 中操作

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

<Steps>
  <Step title="前往 API 令牌设置">
    1. 登录您的 Proofpoint Security Awareness Training 门户。
    2. 点击右上角的账户名称或管理员菜单，然后选择 **Settings**。
    3. 在左侧导航栏中，找到 **Integrations** 或 **API**，然后打开 **Results API** 或 **Token Mart** 页面。

    <Note>
      具体的导航路径因门户版本而异。如果您没有看到 **Token Mart** 或 **Results API** 选项，请联系您的 Proofpoint 管理员——生成令牌可能需要启用相应的平台功能。
    </Note>
  </Step>

  <Step title="生成新的 API 令牌">
    1. 点击 **Generate Token**（或 **Create New Token**）。
    2. 输入一个具有描述性的名称（例如 `Living Security Platform`）。
    3. 选择适当的角色或访问级别：

    | 角色 | 说明 |
    | - | - |
    | **Super Admin** | 拥有完整的平台访问权限，包括所有报告端点 |
    | **Reporting Admin** | 对所有报告端点拥有读取权限 |
    | **Reporting API** | 最小权限角色，仅限于报告端点 |

    <Note>
      **最小权限建议：** 如可用，请使用 **Reporting API** 角色。这会将令牌限制为只读的报告访问权限。
    </Note>

    4. 保存令牌。
  </Step>

  <Step title="复制并保存您的令牌">
    **请立即复制令牌**并妥善保存。

    <Warning>
      令牌可能仅在创建时显示一次。如果您在未复制的情况下离开该页面，可能需要撤销并重新生成。
    </Warning>
  </Step>

  <Step title="确定您的区域结果主机">
    请选择与您的 Proofpoint SAT 环境相匹配的主机：

    | 区域 | 区域结果主机 |
    | - | - |
    | US | `results.us.securityeducation.com` |
    | EU | `results.eu.securityeducation.com` |
    | AP | `results.ap.securityeducation.com` |

    请**仅输入主机名**——不要带 `https://` 前缀，也不要带结尾斜杠。
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="Proofpoint Security Awareness Training">
    | 字段 | 值 |
    | - | - |
    | **API 密钥** | 第 A 部分第 3 步中的令牌 |
    | **区域结果主机** | 第 A 部分第 4 步中的主机（US 默认值：`results.us.securityeducation.com`） |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/proofpoint-security-awareness-training/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=2a8ddf5dd1a87b272d876b0ba4569fec" alt="Living Security 中 Proofpoint SAT 的连接对话框" style={{maxWidth: "450px"}} width="576" height="372" data-path="integrations/images/proofpoint-security-awareness-training/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

您现已连接到 Proofpoint Security Awareness Training。

***

## 故障排除

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    令牌无效或已过期。请确认：

    1. 令牌正确且未被撤销
    2. 生成令牌时选择了正确的角色访问权限
  </Accordion>

  <Accordion title="403 Forbidden">
    该令牌无权访问所需的报告端点。请确认创建令牌时使用了 **Super Admin**、**Reporting Admin** 或 **Reporting API** 角色。
  </Accordion>

  <Accordion title="区域主机错误">
    如果区域主机与您的 SAT 环境不匹配，数据同步将失败。请确认：

    * US 账户使用 `results.us.securityeducation.com`
    * EU 账户使用 `results.eu.securityeducation.com`
    * AP 账户使用 `results.ap.securityeducation.com`
  </Accordion>

  <Accordion title="无法生成令牌">
    如果您在设置中没有看到 Token Mart 或 Results API 选项，可能是您的账户尚未启用该功能。请联系您的 Proofpoint 管理员或客户成功经理。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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