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

# 白名单设置快速入门

> 入职引导所需的网络和邮件白名单设置：应用程序 URL、美国和欧盟 API、身份验证、内容 CDN、客户上传以及邮件投递。

请在入职引导之前将本页面发送给贵组织的 IT 团队。本页面汇总了 Web 目标地址、邮件发件方、源 IP，以及可选的上传和集成要求。部分安全产品将白名单设置称为 **whitelisting** 或 **safelisting**。

## 从简要清单开始

**Web 访问：HTTPS / TCP 443。** 在许多环境中，下列两个 Living Security 通配符，加上外部内容和登录资源主机，即可满足员工访问需求。

| 允许列表条目 | 用途 |
| - | - |
| `*.livingsecurity.ai` | 应用程序、美国和欧盟 API、登录、共享资源以及入门引导 |
| `*.livingsecurity.com` | 文档和内容，包括 `platform-cdn.livingsecurity.com`、`assets.livingsecurity.com` 以及在使用旧版视频链接时所需的 `videos.livingsecurity.com` |
| `assets.livingsecurity-content-cdn.ai` | 客户上传的图片、文档以及培训/SCORM 内容 |
| `uploads-us.assets.livingsecurity-content-cdn.ai`；`uploads-eu.assets.livingsecurity-content-cdn.ai` | 内容和品牌文件上传，包括 SCORM 包；请同时允许这两个主机，因为现有资源可能保留其原始存储区域 |
| `videos.livingsecurity-content-cdn.ai` | 客户上传的视频和目录视频、缩略图及字幕 |
| `cdn.contentful.com` | Contentful 内容分发 |
| `images.ctfassets.net` | Contentful 图片 |
| `assets.ctfassets.net`；`downloads.ctfassets.net` | Contentful 文件和下载 |

客户内容主机、上传主机和 Contentful 主机**不在** Living Security 通配符范围内。客户内容主机和上传主机使用 `livingsecurity-content-cdn.ai`，该域名与 `livingsecurity.ai` 是相互独立的。

此外，请仅针对**嵌入式登录资源**允许 `static.descope.com` 和 `descopecdn.com`；登录请求使用 `auth.livingsecurity.ai`。

如果您仅使用 `*.livingsecurity.ai`，请添加 `platform-cdn.livingsecurity.com` 以及下列其他 `.com` 内容主机。

> [!NOTE]
>
> 详细的主机名表格适用于无法使用通配符的 IT 团队；这些表格并不要求重复设置规则。请检查贵网关的通配符是否可匹配嵌套名称，例如 `api.eu-west-1.livingsecurity.ai`。通配符可能不包含根域名本身。请对 Web 目标地址使用主机名，因为其 IP 可能会发生变化。

**同时请完成下列邮件规则。** 内容作者还需要[上传目标地址](#上传目标地址)。带有源 IP 限制的集成需要[已连接系统的规则](#已连接系统中的-ip-规则)。标准条目已列于本页面；所链接的指南提供设置说明。

## 邮件投递

### 身份验证邮件

| 发件人地址 | 发送 IP |
| - | - |
| `app@livingsecurity.ai` | `159.183.37.179/32`, `159.183.38.165/32` |

请在贵组织的邮件防护服务中，将这些条目应用于**登录邮件**。请验证邮件能否在链接过期之前送达。通知邮件使用相同的 IP；网络钓鱼模拟使用下文单独列出的范围。请参阅[企业身份](https://docs.livingsecurity.com/zh-Hans/features/settings/sso.md)。

### 平台事务性邮件

上文列出的**同样两个发送 IP** 也会在**美国和欧盟两个区域**发送平台通知。请允许以下发件人地址和经过身份验证的退信路径域名：

| 配置 | 发件人地址 | Return-Path / 邮件身份验证 |
| - | - | - |
| Living Security 平台邮件 | `app@livingsecurity.ai`；`noreply@livingsecurity.ai` | `em9309.livingsecurity.ai` |
| 自定义发送域名 | **设置 → 通讯 → 发送域名**中显示的已激活地址 | 使用该域名所显示的 DNS 记录；平台托管的投递使用上述相同的源 IP |
| 您自己的 SMTP 传输 | 在**设置 → 通讯 → SMTP 传输**中保存的**发件人邮箱** | 您自己的中继的发送 IP 和邮件身份验证 |

这些邮件涵盖欢迎邮件、培训分配、提醒及其他通知。请保持启用 SPF、DKIM 和 DMARC 验证。模拟 SMTP 使用下文所列的专用范围。

**如果您自己的 SMTP 中继按源 IP 限制连接**，请在配置中继之前，向支持团队获取适用于您所在区域的 Living Security SMTP 连接源 IP。这些 IP 用于标识**连接到您的中继**的来源，与您的中继自身的发送 IP 无关。请勿使用上文的平台托管邮件 IP 或下文的集成 API IP 来替代。

### 钓鱼模拟

对于**平台托管的 SMTP**，请使用贵组织所在区域：

| 区域 | 发送 CIDR | 完整地址范围 | 邮件身份验证域 |
| - | - | - | - |
| 美国（`us-east-1`） | `3.41.193.72/29` | `3.41.193.72` – `3.41.193.79` | `us.mail.trident-sim.com` |
| 欧盟（`eu-west-1`） | `3.40.138.240/29` | `3.40.138.240` – `3.40.138.247` | `eu.mail.trident-sim.com` |

请允许贵组织所在区域的**完整 IP 范围**。对于需要邮件身份验证域名的网关规则，请使用该域名。可见的发件人地址因模拟而异；请针对您所选的模拟使用最新的白名单包。

启动之前，请从**设置 → 网络钓鱼模拟 → 白名单设置 → 导出白名单包**获取针对贵组织的包，或在您获得访问权限之前向您的客户成功经理索取。该包包含已启用的发送域名、落地页/URL 主机，以及独立的**回复地址域名**。如果您的网关需要完整地址，请查看所选模拟的实际发件人地址。当您的模拟设置发生变化时，请下载更新后的包。

**直接投递 (DMI)** 使用您已连接的 Microsoft 365 或 Google Workspace 集成；SMTP 源范围不适用于该投递路径。Google Workspace 会在不发送邮件的情况下将消息置于每个收件箱中。Microsoft 365 会从您的模拟邮箱发送真实邮件，因此您的 Microsoft 365 过滤器仍会对其生效。URL 访问、提供商授权和收件箱测试仍然重要。请按照[模拟设置](https://docs.livingsecurity.com/zh-Hans/features/settings/phishing-simulation.md#允许列表与允许列表导出)中针对各提供商的步骤操作，包括适用时 Microsoft Defender 的模拟控制。

## 应用程序和 API 访问

| 用途 | 需要允许的主机名 | 需要访问的人员 |
| - | - | - |
| 仪表板 | `app.livingsecurity.ai` | 管理员和经理 |
| Engage | `engage.livingsecurity.ai` | 参加培训或打开分配任务和记分卡的员工 |
| 美国 API | `api.us-east-1.livingsecurity.ai` | 使用美国区域的浏览器和 API 客户端 |
| 欧盟 API | `api.eu-west-1.livingsecurity.ai` | 使用欧盟区域的浏览器和 API 客户端 |
| 登录 | `auth.livingsecurity.ai` | 登录的管理员和员工 |
| 文档 | `docs.livingsecurity.com` | 阅读帮助的管理员和用户 |

对于欧盟组织，浏览器登录和应用程序访问需要允许**两个 API 主机名**。对于直接 API 集成，请使用分配给贵组织的区域 URL。请参阅 [API 快速入门](https://docs.livingsecurity.com/zh-Hans/developers/v1/quickstart.md)。

如果贵组织使用自定义应用程序或登录主机名，请包含设置期间提供的确切主机名。

### 登录要求

| 用途 | 主机名 | 需要的时机 |
| - | - | - |
| 嵌入式登录资源 | `static.descope.com`；`descopecdn.com` | 用于显示嵌入式登录表单的脚本、样式及其他资源；这些是资源主机，而非登录 API 端点 |
| 登录字体和脚本 | `fonts.googleapis.com`；`fonts.gstatic.com`；`cdn.jsdelivr.net` | 当您的嵌入式登录表单请求时 |
| 您的身份提供商 | 贵组织的 SSO 和 MFA 主机名 | SSO 重定向和身份验证质询 |

登录请求使用上文列出的 **`auth.livingsecurity.ai`**。嵌入式表单还会从此表中的主机加载资源。如果表单显示不正常，请让您的 IT 团队检查这些资源请求是否被阻止。

## 内容、CDN 和客户上传

请为预览内容的管理员和使用内容的员工允许这些主机。邮件图片防护可能也需要访问图片主机。

| 用途 | 主机名 | 范围 |
| - | - | - |
| **客户上传的资源** | `assets.livingsecurity-content-cdn.ai` | 组织图片、文档、邮件资源以及上传的培训/SCORM 内容 |
| 客户上传的视频和目录视频 | `videos.livingsecurity-content-cdn.ai` | 流媒体视频、缩略图和字幕 |
| 应用程序图片和资源 | `cdn.livingsecurity.ai` | 应用程序中显示的图片和其他资源 |
| Living Security 内容分发 | `platform-cdn.livingsecurity.com` | 平台内容；由 `*.livingsecurity.com` 涵盖 |
| Contentful 内容分发 | `cdn.contentful.com` | Contentful 托管的内容 |
| Contentful 图片 | `images.ctfassets.net` | 目录插图和培训图片 |
| Contentful 文件 | `assets.ctfassets.net`；`downloads.ctfassets.net` | 目录文件和大型可下载资源 |
| 培训媒体 | `assets.livingsecurity.com` | 通过 Living Security 内容主机名提供的培训媒体；由 `*.livingsecurity.com` 涵盖 |
| 旧版视频播放 | `videos.livingsecurity.com` | 当现有培训内容使用此主机名时；由 `*.livingsecurity.com` 涵盖 |

客户资源和视频主机位于 **`livingsecurity-content-cdn.ai`**，该域名与 `livingsecurity.ai` 不同。仅允许 `*.livingsecurity.ai` **不能**涵盖它们。如果您的网关不支持通配符，请输入上述明确的主机。此外，在您的安全产品中，通配符也可能不包含根域名或嵌套子域名。

如果您添加了外部托管的内容，还请允许该内容所使用的目标地址。在将内容分配给员工之前，请先审查这些地址。

### 上传目标地址

**上传内容或品牌文件的管理员。** 这些目标地址用于接收新上传的文件；查看现有内容的员工需要上文的 CDN 主机。

| 上传类型 | 需通过 HTTPS / TCP 443 允许的目标地址 |
| - | - |
| 文件和 SCORM 包 — 美国 | `uploads-us.assets.livingsecurity-content-cdn.ai` |
| 文件和 SCORM 包 — 欧盟 | `uploads-eu.assets.livingsecurity-content-cdn.ai` |
| 可恢复视频上传 — 美国 | `api.us-east-1.livingsecurity.ai` |
| 可恢复视频上传 — 欧盟 | `api.eu-west-1.livingsecurity.ai` |

对于图片、文档、自定义字体、报告者图标和 SCORM 包，请同时允许两个资源上传主机。现有的图片和文档可以保留其原有的存储区域。请使用适用于贵组织所在区域的视频 API。

文件上传请放行 `PUT` 和 `OPTIONS`，可恢复视频上传请放行 `POST`、`PATCH`、`HEAD`、`DELETE` 和 `OPTIONS`。请保留应用程序提供的 URL 查询字符串和上传标头。

SCORM 包最大可达 **`500 MiB`**（`524288000` 字节）。请允许在一次上传请求中传输完整的包；网关上较低的请求正文限制可能会阻止上传。

上传目标地址已于 2026 年 11 月 4 日在美国和欧盟生产环境中验证。

## 其他功能和集成

* **SSO/MFA 和集成授权：** 请允许您的身份提供商，以及您所连接的每个系统的登录/授权页面。
* **入职引导导览：** `onboard.livingsecurity.ai`，由 `.ai` 通配符涵盖；请在 TCP 443 上允许 HTTPS 和安全 WebSocket。
* **Livvy 和实时更新：** 请在 TCP 443 上允许流式 HTTPS 响应和安全 WebSocket。
* **外部内容、自定义域名和您的 LMS：** 请包含贵组织所使用的确切主机。请从学员网络测试托管的 SCORM。

## 已连接系统中的 IP 规则

如果您连接的系统按源 IP 限制 API 访问，请将这些地址添加到**该系统的 API 白名单**中。它们是 Living Security 请求数据时该系统所看到的源地址。它们不是员工设备的出站目标地址。

请允许全部四个**同步**地址（美国和欧盟相同）：

| IP 地址 | CIDR |
| - | - |
| `52.34.139.153` | `52.34.139.153/32` |
| `54.69.127.183` | `54.69.127.183/32` |
| `44.247.133.183` | `44.247.133.183/32` |
| `52.26.211.56` | `52.26.211.56/32` |

当您使用以下任一集成时，还请允许适用于您所在区域的**平台**地址对：

* [Auth0](https://docs.livingsecurity.com/zh-Hans/integrations/auth0.md)
* Check Point Harmony Email
* [Cofense Triage](https://docs.livingsecurity.com/zh-Hans/integrations/cofense-triage.md)
* Code42
* Cornerstone
* [CrowdStrike Falcon](https://docs.livingsecurity.com/zh-Hans/integrations/crowdstrike.md)
* Keepnet Labs
* [Microsoft Entra ID](https://docs.livingsecurity.com/zh-Hans/integrations/microsoft-entra-id.md) — 包括 Microsoft Graph
* [OneLogin](https://docs.livingsecurity.com/zh-Hans/integrations/onelogin.md)
* [SailPoint IdentityNow](https://docs.livingsecurity.com/integrations/sailpoint-identitynow.md)
* Sophos Central
* Zscaler Client Connector

平台地址对同样适用于配置为**直接出口**的连接，以及需要直接执行行动的提供商。请保持两组地址均处于允许状态，以便持续进行身份验证、同步和行动：

| 区域 | IP 地址 | CIDR |
| - | - | - |
| **美国** | `98.91.60.249`, `13.216.91.102` | `98.91.60.249/32`, `13.216.91.102/32` |
| **欧盟** | `34.246.236.210`, `52.31.102.238` | `34.246.236.210/32`, `52.31.102.238/32` |

设置完成后，请保持所有必需的地址处于允许状态，以确保身份验证和数据同步持续正常工作。这些条目仅用于集成 API 访问。[集成出口指南](https://docs.livingsecurity.com/zh-Hans/integrations/managing/egress-ip-addresses.md#需要两组地址的集成)列出了各提供商的具体要求。

## 启动前验证

请通过员工所使用的同一企业网络、代理、VPN、终端防护和邮箱控制进行测试：

* 登录仪表板和 Engage；完成 SSO/MFA，或收到可用的邮件登录链接。
* 打开一个仪表板页面并向 Livvy 提问。
* 打开目录图片，播放带字幕的视频，并打开一份可下载的文档。
* 上传一个客户资源，然后以学员身份预览；如果使用上传的 SCORM 包，请启动该包。
* 投递一封欢迎邮件或培训分配邮件；检查其发件人、身份验证、链接和图片。
* 在所选的投递路径上运行一次模拟；验证邮件是否到达收件箱、是否可访问落地页，以及基于回复的场景是否能收到回复。
* 连接每个已启用的集成，并验证实际的数据同步，而不仅仅是授权成功。

如果某项检查失败，请记录被阻止的主机名、时间、区域、受影响的功能，以及网关错误或邮件跟踪信息，然后联系支持团队。在共享诊断信息之前，请移除凭据、会话令牌和签名 URL 的查询字符串。当配置发生变化时，请重新核对本指南以及您导出的模拟包。


## Related topics

- [配置快速入门](https://docs.livingsecurity.com/zh-Hans/guides/configuration-quick-start.md)
- [管理员入门引导](https://docs.livingsecurity.com/zh-Hans/getting-started/onboarding.md)
- [旧版公共 API](https://docs.livingsecurity.com/zh-Hans/developers/public-api/overview.md)


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