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

# OneLogin 集成设置

> 将 OneLogin 连接到 Living Security，以获取用户生命周期、身份验证、MFA 和管理活动数据。

export const EgressIpAllowlistBothSets = ({system}) => <Warning>
    <strong>{system} 需要两组地址，而不是一组。</strong>Living Security 在自有基础设施上生成此集成的访问令牌并持续刷新，因此设置流量和同步流量来自不同的网络。请在 {system} 中将两组地址都加入允许列表，并始终保留这两组地址——这并非仅在设置阶段才需要满足的要求。
    <br />
    <br />
    <strong>集成同步流量</strong>——在所有区域中均相同：
    <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 />
    <strong>平台流量</strong>——仅使用与贵组织所在区域对应的那一行：
    <br />
    美国：<code>98.91.60.249/32</code>, <code>13.216.91.102/32</code>
    <br />
    欧盟：<code>34.246.236.210/32</code>, <code>52.31.102.238/32</code>
    <br />
    <br />
    如果仅将同步地址组加入允许列表，设置将无法完成。如果仅将平台地址组加入允许列表，设置可以成功，但所有同步都会失败。有关这两种故障的表现和变更策略，请参阅{' '}
    <a href="/zh-Hans/integrations/managing/egress-ip-addresses">
      配置集成出站 IP 地址
    </a>。
  </Warning>;

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="OneLogin" recommendDelegated={true} />

## 此集成提供的数据

OneLogin 可以提供经过规范化处理的用户生命周期、身份验证、MFA 和管理活动数据。已审核的示例包括：

* `mfa.success` — 完成 MFA 质询
* `mfa.failed` — MFA 质询失败
* `account.locked` — 账户被锁定

请参阅[集成数据如何转化为信号](/zh-Hans/signals/data-sources)。

## Living Security 所需信息

| 凭据 | 说明 |
| - | - |
| **客户端 ID** | 具有读取用户和事件权限的 OneLogin API 凭据对中的客户端 ID。 |
| **Client secret** | 该凭据对中的客户端密钥。 |
| **Tenant subdomain** | OneLogin 租户 URL 中 `.onelogin.com` 之前的值。 |

## 设置

<Steps>
  <Step title="在 OneLogin 中创建 API 凭据">
    请以账户所有者或管理员身份，打开 **Developers → API Credentials**，创建一个专用凭据，并选择可读取用户和事件的范围。请妥善保管客户端 ID 和密钥。
  </Step>

  <ConnectInPlatform tile="OneLogin">
    输入租户子域名、客户端 ID 和客户端密钥，然后进行连接。
  </ConnectInPlatform>
</Steps>

Living Security 会使用该凭据对换取访问令牌，并在令牌到期前自动续期，因此您无需生成或轮换令牌。请按照您的常规周期轮换凭据对本身，并在轮换后重新连接该磁贴。

## 验证与故障排查

请验证该连接能够读取至少一名用户。如果租户近期没有活动，审核事件可能为空。

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    客户端 ID 或客户端密钥有误，或者该凭据对已在 OneLogin 中被删除。请在 **Developers → API Credentials** 下确认该凭据对仍然存在，然后使用当前值重新连接。
  </Accordion>

  <Accordion title="403 Forbidden">
    请重新创建 API 凭据，并授予其读取 OneLogin 资源 API、用户和事件的权限。
  </Accordion>

  <Accordion title="无法访问租户">
    请仅输入租户子域名，不要输入完整 URL，也不要输入管理显示名称。

    如果子域名正确但仍无法访问租户，请检查您的账户中 OneLogin 是否按来源 IP 地址限制 API 访问。此集成需要将**两组**地址加入允许列表，因为 Living Security 会自行生成访问令牌并持续续期，所以令牌请求和定时同步来自不同的网络。

    <EgressIpAllowlistBothSets system="OneLogin" />
  </Accordion>
</AccordionGroup>

有关供应商端的详细信息，请参阅 [OneLogin 的 API 凭据指南](https://developers.onelogin.com/api-docs/2/getting-started/working-with-api-credentials)。

<PublicIntegrationNextSteps />


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