Skip to main content
部分提供商会将 API 访问限制为一份经批准的源 IP 地址列表。启用该限制后,您必须将提供商配置为接受来自 Living Security 出站 IP 地址的流量,否则集成将在网络层被拒绝。 本页列出了这些地址。

共有两组地址

Living Security 通过两个不同的网络访问您的提供商,它们分别用于集成的不同环节。 大多数集成只需要同步地址组。有一类特定的集成则需要同时使用两组地址,且需长期保持——请参阅需要两组地址的集成。

集成同步流量

以下四个地址对所有 Living Security 区域均相同。托管在欧盟的客户与托管在美国的客户使用相同的这四个地址。 对于接受以逗号分隔的列表的提供商:

平台流量

与同步地址不同,这些地址因区域而异。请仅使用托管您组织的区域所对应的那一对地址。如果您不确定是哪个区域,请在进行任何配置之前咨询您的客户成功经理——若将错误区域的地址加入允许列表,集成会出现故障,而故障表现看起来与允许列表毫无关联。 对于接受以逗号分隔的列表的提供商:

出站行动手册行动

默认情况下,向已连接系统回写数据的行动手册行动与您的数据同步走相同的路径,因此它们从同步地址发出。无需任何额外操作。 管理员可以将单个连接切换为直接出站,这会将该连接的行动改由您所在区域的平台地址发出。该设置正是为以下情形而设:提供商实例按源 IP 限制 API 访问,需要一组数量少、稳定且归 Living Security 所有的地址来加入允许列表。少数提供商由于完全无法代理,始终使用直接出站。 如果您只将同步地址加入允许列表,而之后有人将某个连接切换为直接出站,那么该连接的行动将开始失败,而其同步仍然正常。

需要两组地址的集成

对于大多数集成,Living Security 的集成服务会自行获取并续期访问令牌,所有流量仅从同步地址到达您的提供商。 对于下列集成,该服务无法续期令牌,因此由 Living Security 平台直接生成令牌——在您建立连接时生成一次,此后只要连接处于活动状态就会持续生成。这些令牌请求从平台地址发出。定时数据同步仍从同步地址发出。
在连接的整个生命周期内,两组地址都必须保留在允许列表中。 平台地址并非仅在设置阶段才需要。只要集成处于活动状态,令牌续期就会按较短的周期运行,因此在设置成功后移除这些地址,会导致集成在下次令牌过期时中断。
如果提供商的令牌端点与其数据 API 是同一主机(这种情况很常见),则该主机必须同时接受来自两个网络的流量。

添加所需地址组中的全部地址

流量可能从同一组中的任意地址发出,且特定请求使用哪个地址并不固定。只将其中一部分地址加入允许列表会导致难以诊断的间歇性故障:部分请求成功,另一些失败,且其规律看起来与配置无关。 这一点同样适用于平台地址对,与四个同步地址无异。每个区域运行两个地址,请求可能落在其中任意一个上。
这些地址是稳定的,但并非永久不变。 我们会努力保持它们不变,仅在极少数的特殊情况下(例如底层基础设施提供商发生变更)才会更改。由于存在变更的可能,请将本页加入书签。如果之前正常运行的集成开始失败,请先回到此处,确认您的允许列表与上述地址一致,然后再提交支持工单。

哪些集成需要此配置

IP 允许列表是您的提供商中的一项设置,而不是 Living Security 中的设置。仅当您的组织已启用该限制时才适用。如果您没有在提供商中启用 IP 限制,则无需任何操作。 以下提供商通常需要此配置: 其他提供商可能提供类似的设置。请查看目录中该提供商的页面以及提供商自己的文档。

允许列表缺失或过时的症状

两组地址的故障表现恰好相反。在做出任何更改之前,请先将症状与对应的地址组匹配。

连接成功,但始终没有数据到达

这是缺少同步地址的典型特征。 凭据是在建立连接时通过一条路径进行验证的,该路径往往不受同样的限制,因此 Living Security 中的连接对话框会报告成功。故障会在稍后出现,即定时同步运行并被拦截时。 请留意以下情况:
  • 连接显示为已连接,但数据流报告没有记录。
  • 同步运行失败,并显示 401 Unauthorized 或 403 Forbidden。
  • 已正常运行数月的集成在您这一侧没有任何变更的情况下开始失败。

根本无法创建连接

这是缺少平台地址的典型特征,并且仅适用于需要两组地址的集成中列出的集成。 请留意以下情况:
  • 设置在获取访问令牌时失败,未创建任何连接。
  • 错误提示无法访问某个主机,且没有任何 HTTP 响应。
  • 提供商自身的登录日志或条件访问日志显示,有来自某个未加入允许列表的地址的请求被拦截。
完全无法访问的连接不是凭据问题。由于并未进行任何身份验证,轮换密钥或重新生成客户端凭据都无济于事。最常见的原因是源地址未加入允许列表,不过主机名错误、端口错误或提供商端的故障,从我们这一侧来看表现也是一样的。
此后若您对允许列表的更改移除了平台地址,则表现又有所不同:一个已正常运行数周的集成会在数分钟内停止工作,因为下一次令牌续期被拦截。

本页不涉及钓鱼模拟投递

本页的地址适用于集成流量——即 Living Security 调用您已连接系统的 API 以导入数据和执行行动手册行动。 钓鱼模拟邮件投递的允许列表是单独的配置,有其自己的地址、发件人域名和可下载的允许列表包。请在设置 → 网络钓鱼模拟 → Allowlisting 中完成。有关该流程,请参阅网络钓鱼模拟设置。 将本页的地址加入允许列表,并不能使模拟钓鱼邮件得以投递;完成模拟允许列表配置,也不能使受限制的提供商 API 变得可访问。如果两者都使用,请同时配置。

获取帮助

如果在您为所在区域的地址配置允许列表后,集成仍然失败,请联系您的客户成功经理或发送邮件至 support@livingsecurity.com。请提供提供商名称、失败的数据流或设置失败的步骤,以及时间戳,以便我们与出站日志进行关联分析。