Skip to main content

此集成提供的数据

Abnormal Security 可提供经过标准化处理的电子邮件威胁、投递、拦截和员工报告活动数据。已审核的示例包括:
  • phishing.real.blocked — 在投递前被拦截的真实网络钓鱼邮件
  • phishing.real.delivered — 已投递到收件箱的真实网络钓鱼邮件
  • phishing.real.reported — 报告真实的网络钓鱼邮件
这些示例展示了 Living Security 可以使用的标准化活动类型。请参阅集成数据如何转化为信号。

Living 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 管理员完成以下步骤。
1

进入 API 令牌管理

  1. 登录您的 Abnormal Security 门户。
  2. 在左侧导航栏中,点击设置,然后选择集成。
Abnormal Security 设置菜单,显示集成选项
  1. 在集成页面中向下滚动至底部的 API Token Management 部分。
  2. 点击 + Create New Token。
API Token Management 部分及 Create New Token 按钮
2

选择集成类型

选择 REST API 作为集成类型,然后点击下一页。
3

选择令牌范围

选择令牌范围,然后点击下一页:
  • Customer (All Current and Future Tenants) — 如果您的 Abnormal 账户管理多个租户,请选择此项。该令牌将自动涵盖所有当前和未来的租户。
  • Tenant (Single Tenant) — 使用此项可将令牌限定于某一个特定租户。
对于只有一个 Abnormal 租户的大多数组织,两个选项均可使用。如有疑问,请选择 Customer。
4

授予所需访问权限

选择 Custom Access,并为两个端点组启用 Read:然后点击下一页。
Read 访问权限返回非敏感的威胁和活动数据。Read Sensitive 还会额外暴露个人身份信息(PII)、附件和员工数据。Write 用于提交修复行动。除非您的使用场景明确需要更多权限,否则请仅授予 Read 权限。
5

配置令牌详细信息和 IP 安全列表

填写以下字段:
  • Token Name — 具有描述性的名称(例如 Living Security Platform)
  • 说明 — 可选的上下文信息(例如 Read access for Living Security HRM platform)
  • Token Expiry — 选择 90、180 或 365 天,以符合您的轮换策略。请设置日历提醒,在令牌到期前进行轮换。
  • IP Safelist — 输入 Living Security 的出口 IP 范围,每条输入一项。每输入一项后点击添加。
IP 安全列表是必填项。 Abnormal Security 会拒绝来自不在安全列表中的地址的所有 API 请求。连接对话框会显示成功,但在正确的 IP 被加入安全列表之前,数据同步将失败并返回 401 Unauthorized。
然后点击下一页。
6

审核并创建令牌

审核令牌配置摘要,然后点击 Create Token。令牌配置审核界面
7

复制并保存令牌

请立即复制令牌,并将其存放在安全的位置(例如密码保管库或机密管理器),然后点击完成。令牌复制对话框,显示已生成的令牌
Abnormal Portal 仅显示一次令牌值。如果您在未复制的情况下离开此页面,则必须创建新令牌并撤销旧令牌。
8

确定您的区域 API 主机

确定适用于您的 Abnormal Security 环境的 API 主机:请仅输入主机名,不要带 https:// 前缀,也不要带末尾斜杠。如果您不确定贵组织使用的是哪个环境,请查看您的 Abnormal 门户 URL,或联系您的 Abnormal Security 客户团队。

B 部分 — 在 Living Security Platform 中

由项目负责人完成此步骤;如果采用委派设置,则由系统管理员完成。
您现已连接到 Abnormal Security。

故障排除

令牌缺少一项或两项所需的访问授权(Abuse Campaigns 或 Threats)。令牌创建后,无法更改集成类型、范围和访问级别——您必须使用正确的设置创建新令牌,并撤销旧令牌。
可能是令牌无效或已过期,也可能是请求的 IP 不在安全列表中。请检查:
  1. 令牌未被撤销或过期
  2. 全部四个 Living Security 出口 IP 地址均已加入安全列表
如果同步此前正常,但现在失败并返回 401,则可能是出口 IP 地址已发生变化——请查看配置集成出口 IP 地址,并核实安全列表是否与之一致。
如果贵组织拥有在推出自助式令牌管理功能之前创建的 API 令牌,这些令牌在仪表板中会显示为 Legacy。旧版令牌可继续使用,但无法轮换,只能更新其 IP 安全列表。所有旧版令牌将于 2027 年 4 月 30 日自动到期。请在该日期之前使用新令牌替换旧版令牌。