> ## 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-Hant/integrations/managing/egress-ip-addresses">
      設定整合輸出 IP 位址
    </a>。
  </Warning>;

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>相關資源</h2>
    <ul>
      <li>
        <a href="/zh-Hant/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-Hant/signals/data-sources)。

## Living Security 所需資訊

| 認證資訊 | 說明 |
| - | - |
| **用戶端 ID** | 具備讀取使用者與事件權限的 OneLogin API 憑證組之用戶端 ID。 |
| **用戶端密碼** | 該憑證組的用戶端密碼。 |
| **租用戶子網域** | 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.