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

# Abnormal Security 集成设置

> 连接 Abnormal 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 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="Abnormal Security" />

## 此集成提供的数据

Abnormal Security 可提供经过标准化处理的电子邮件威胁、投递、拦截和员工报告活动数据。已审核的示例包括：

* `phishing.real.blocked` — 在投递前被拦截的真实网络钓鱼邮件
* `phishing.real.delivered` — 已投递到收件箱的真实网络钓鱼邮件
* `phishing.real.reported` — 报告真实的网络钓鱼邮件

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

## Living Security 所需信息

| 凭据 | 说明 |
| - | - |
| **API 密钥** | 从 Abnormal Portal 生成的 REST API 持有者令牌 |
| **区域 API 主机** | 您的 Abnormal Security 环境的主机名 |

**权限范围：** 自定义访问权限，对 `Abuse Campaigns (AI Security Mailbox)` 和 `Threats` 具有**读取**权限

**所需角色：** Abnormal Security 中的 **Security Admin** 或 **Super Admin**

### 先决条件

* 您必须在 Abnormal Security 中拥有 **Security Admin** 或 **Super Admin** 权限，才能创建和管理 API 令牌。

***

## A 部分 — 在 Abnormal Security 中

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

<Steps>
  <Step title="进入 API 令牌管理">
    1. 登录您的 Abnormal Security 门户。
    2. 在左侧导航栏中，点击**设置**，然后选择**集成**。

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/settings-integrations.webp?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=7f5d7a616acdcf72a9048f16c6706b5e" alt="Abnormal Security 设置菜单，显示集成选项" width="1999" height="1680" data-path="integrations/images/abnormal-security/settings-integrations.webp" />

    3. 在集成页面中向下滚动至底部的 **API Token Management** 部分。
    4. 点击 **+ Create New Token**。

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/api-token-management.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=13cfdfb7ced9b3f3fca67c781ee7e844" alt="API Token Management 部分及 Create New Token 按钮" width="1239" height="1151" data-path="integrations/images/abnormal-security/api-token-management.avif" />
  </Step>

  <Step title="选择集成类型">
    选择 **REST API** 作为集成类型，然后点击**下一页**。
  </Step>

  <Step title="选择令牌范围">
    选择令牌范围，然后点击**下一页**：

    * **Customer (All Current and Future Tenants)** — 如果您的 Abnormal 账户管理多个租户，请选择此项。该令牌将自动涵盖所有当前和未来的租户。
    * **Tenant (Single Tenant)** — 使用此项可将令牌限定于某一个特定租户。

    对于只有一个 Abnormal 租户的大多数组织，两个选项均可使用。如有疑问，请选择 **Customer**。
  </Step>

  <Step title="授予所需访问权限">
    选择 **Custom Access**，并为两个端点组启用 **Read**：

    | 端点组 | 所需访问级别 |
    | - | - |
    | **Abuse Campaigns (AI Security Mailbox)** | Read |
    | **Threats** | Read |

    然后点击**下一页**。

    <Note>
      **Read** 访问权限返回非敏感的威胁和活动数据。**Read Sensitive** 还会额外暴露个人身份信息（PII）、附件和员工数据。**Write** 用于提交修复行动。除非您的使用场景明确需要更多权限，否则请仅授予 **Read** 权限。
    </Note>
  </Step>

  <Step title="配置令牌详细信息和 IP 安全列表">
    填写以下字段：

    * **Token Name** — 具有描述性的名称（例如 `Living Security Platform`）
    * **说明** — 可选的上下文信息（例如 `Read access for Living Security HRM platform`）
    * **Token Expiry** — 选择 **90**、**180** 或 **365 天**，以符合您的轮换策略。请设置日历提醒，在令牌到期前进行轮换。
    * **IP Safelist** — 输入 Living Security 的出口 IP 范围，每条输入一项。每输入一项后点击**添加**。

    <EgressIpSafelist system="Abnormal Security" />

    <Warning>
      **IP 安全列表是必填项。** Abnormal Security 会拒绝来自不在安全列表中的地址的所有 API 请求。连接对话框会显示成功，但在正确的 IP 被加入安全列表之前，数据同步将失败并返回 `401 Unauthorized`。
    </Warning>

    然后点击**下一页**。
  </Step>

  <Step title="审核并创建令牌">
    审核令牌配置摘要，然后点击 **Create Token**。

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/review-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=6935f488f5778fcea3f6907629aa1316" alt="令牌配置审核界面" style={{maxWidth: "550px"}} width="1910" height="726" data-path="integrations/images/abnormal-security/review-token.avif" />
  </Step>

  <Step title="复制并保存令牌">
    **请立即复制令牌**，并将其存放在安全的位置（例如密码保管库或机密管理器），然后点击**完成**。

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/copy-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=fa752c333af664ad5b3ed037dbb67143" alt="令牌复制对话框，显示已生成的令牌" style={{maxWidth: "550px"}} width="1999" height="329" data-path="integrations/images/abnormal-security/copy-token.avif" />

    <Warning>
      Abnormal Portal **仅显示一次**令牌值。如果您在未复制的情况下离开此页面，则必须创建新令牌并撤销旧令牌。
    </Warning>
  </Step>

  <Step title="确定您的区域 API 主机">
    确定适用于您的 Abnormal Security 环境的 API 主机：

    | 环境 | 区域 API 主机 |
    | - | - |
    | 默认（美国商业版） | `api.abnormalplatform.com` |
    | EU | `eu.rest.abnormalsecurity.com` |
    | FedRAMP | `rest.abnormalsecurity.us` |

    请仅输入**主机名**，不要带 `https://` 前缀，也不要带末尾斜杠。

    如果您不确定贵组织使用的是哪个环境，请查看您的 Abnormal 门户 URL，或联系您的 Abnormal Security 客户团队。
  </Step>
</Steps>

***

## B 部分 — 在 Living Security Platform 中

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

<Steps>
  <ConnectInPlatform tile="Abnormal Security">
    | 字段 | 值 |
    | - | - |
    | **API 密钥** | 在 A 部分第 7 步中复制的令牌 |
    | **区域 API 主机** | A 部分第 8 步中的主机（美国默认值：`api.abnormalplatform.com`） |

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

您现已连接到 Abnormal Security。

***

## 故障排除

<AccordionGroup>
  <Accordion title="403 Forbidden — You do not have permission to perform this action">
    令牌缺少一项或两项所需的访问授权（**Abuse Campaigns** 或 **Threats**）。令牌创建后，无法更改集成类型、范围和访问级别——您必须使用正确的设置创建新令牌，并撤销旧令牌。
  </Accordion>

  <Accordion title="401 Unauthorized">
    可能是令牌无效或已过期，也可能是请求的 IP 不在安全列表中。请检查：

    1. 令牌未被撤销或过期
    2. 全部四个 [Living Security 出口 IP 地址](/zh-Hans/integrations/managing/egress-ip-addresses)均已加入安全列表

    如果同步此前正常，但现在失败并返回 `401`，则可能是出口 IP 地址已发生变化——请查看[配置集成出口 IP 地址](/zh-Hans/integrations/managing/egress-ip-addresses)，并核实安全列表是否与之一致。
  </Accordion>

  <Accordion title="旧版令牌到期（2027 年 4 月 30 日）">
    如果贵组织拥有在推出自助式令牌管理功能之前创建的 API 令牌，这些令牌在仪表板中会显示为 **Legacy**。旧版令牌可继续使用，但无法轮换，只能更新其 IP 安全列表。所有旧版令牌将于 **2027 年 4 月 30 日**自动到期。请在该日期之前使用新令牌替换旧版令牌。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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