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

# Thiết lập tích hợp OneLogin

> Kết nối OneLogin với Living Security để thu thập dữ liệu về vòng đời người dùng, xác thực, MFA và hoạt động quản trị.

export const EgressIpAllowlistBothSets = ({system}) => <Warning>
    <strong>{system} cần hai nhóm địa chỉ, không phải một.</strong> Living Security tạo mã thông báo truy cập của tích hợp này trên hạ tầng của chính mình và làm mới liên tục, do đó lưu lượng thiết lập và lưu lượng đồng bộ xuất phát từ các mạng khác nhau. Hãy đưa cả hai nhóm vào danh sách cho phép trong {system} và duy trì cả hai — đây không phải là yêu cầu chỉ áp dụng khi thiết lập.
    <br />
    <br />
    <strong>Lưu lượng đồng bộ của Tích hợp</strong> — giống nhau ở mọi khu vực:
    <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>Lưu lượng của nền tảng</strong> — chỉ sử dụng dòng tương ứng với khu vực lưu trữ tổ chức của bạn:
    <br />
    Hoa Kỳ: <code>98.91.60.249/32</code>, <code>13.216.91.102/32</code>
    <br />
    Liên minh châu Âu: <code>34.246.236.210/32</code>, <code>52.31.102.238/32</code>
    <br />
    <br />
    Nếu chỉ đưa nhóm đồng bộ vào danh sách cho phép, quá trình thiết lập sẽ không bao giờ hoàn tất. Nếu chỉ đưa nhóm nền tảng vào danh sách cho phép, quá trình thiết lập thành công nhưng mọi lần đồng bộ đều thất bại. Xem{' '}
    <a href="/vi/integrations/managing/egress-ip-addresses">
      Cấu hình địa chỉ IP egress của Tích hợp
    </a>{' '}
    để biết dấu hiệu nhận biết của cả hai trường hợp lỗi và chính sách thay đổi.
  </Warning>;

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Tài nguyên liên quan</h2>
    <ul>
      <li>
        <a href="/vi/signals/data-sources">Tìm hiểu cách dữ liệu tích hợp trở thành các tín hiệu Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Khám phá các Tích hợp của Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Mở Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Yêu cầu bản demo của Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Nhập thông tin xác thực vào Living Security Platform">
    <p>
      Bước này do người có quyền truy cập Living Security thực hiện — chủ sở hữu chương trình, hoặc quản trị viên hệ thống nếu người đó đã được mời (thiết lập được ủy quyền).
    </p>
    <ol>
      <li>
        Truy cập <strong>Cài đặt → Tích hợp → Danh mục</strong>, tìm thẻ{' '}
        <strong>{tile}</strong>, rồi nhấp vào <strong>Kết nối</strong>.
      </li>
      <li>
        Điền các trường bên dưới, sau đó nhấp vào <strong>Kết nối</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Hướng dẫn này dành cho quản trị viên {system} của Quý vị.</strong> Hướng dẫn đề cập đến việc tạo thông tin xác thực API trong {system}, thao tác này yêu cầu quyền quản trị đối với {system} — chứ không phải đối với
      Living Security Platform.
    </p>
    <p>
      Nếu Quý vị là <strong>chủ sở hữu chương trình</strong> của Living Security và không quản trị {system},
      vui lòng gửi trang này cho người đảm nhiệm vai trò đó. Người này sẽ hoàn thành Phần A và chuyển lại thông tin xác thực cho Quý vị
      (hoặc nhập trực tiếp nếu Quý vị đã mời họ vào nền tảng).
      {recommendDelegated && <>
          {' '}Do quá trình thiết lập tạo ra tài liệu khóa nhạy cảm, chúng tôi khuyến nghị sử dụng hướng{' '}
          <strong>thiết lập ủy quyền</strong> để khóa bí mật không bao giờ được gửi lại cho Quý vị.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="OneLogin" recommendDelegated={true} />

## Tích hợp này đóng góp dữ liệu gì

OneLogin có thể cung cấp dữ liệu đã được chuẩn hóa về vòng đời người dùng, xác thực, MFA và hoạt động quản trị. Các ví dụ đã được xem xét bao gồm:

* `mfa.success` — hoàn tất các thử thách MFA
* `mfa.failed` — không vượt qua các thử thách MFA
* `account.locked` — tài khoản bị khóa

Xem [cách dữ liệu tích hợp trở thành Tín hiệu](/vi/signals/data-sources).

## Living Security cần những gì

| Thông tin xác thực | Mô tả |
| - | - |
| **ID khách hàng** | ID khách hàng của một cặp thông tin xác thực API OneLogin có quyền đọc người dùng và sự kiện. |
| **Client secret** | Client secret của cặp thông tin xác thực đó. |
| **Tenant subdomain** | Giá trị đứng trước `.onelogin.com` trong URL tenant OneLogin của quý vị. |

## Thiết lập

<Steps>
  <Step title="Tạo thông tin xác thực API trong OneLogin">
    Với vai trò chủ sở hữu tài khoản hoặc quản trị viên, hãy mở **Developers → API Credentials**, tạo một thông tin xác thực riêng và chọn phạm vi (scope) có thể đọc người dùng và sự kiện. Lưu trữ ID khách hàng và secret một cách an toàn.
  </Step>

  <ConnectInPlatform tile="OneLogin">
    Nhập tenant subdomain, ID khách hàng và client secret, sau đó kết nối.
  </ConnectInPlatform>
</Steps>

Living Security đổi cặp thông tin xác thực lấy một access token và làm mới token
trước khi hết hạn, do đó quý vị không cần tạo hoặc xoay vòng token. Hãy xoay vòng
chính cặp thông tin xác thực theo lịch thông thường của quý vị và kết nối lại ô tích hợp sau đó.

## Xác minh và khắc phục sự cố

Hãy xác minh rằng kết nối có thể đọc được ít nhất một người dùng. Các sự kiện kiểm toán có thể trống khi tenant không có hoạt động gần đây.

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    ID khách hàng hoặc client secret không đúng, hoặc cặp thông tin xác thực đã bị xóa trong OneLogin. Hãy xác nhận cặp thông tin xác thực vẫn còn tồn tại trong **Developers → API Credentials**, sau đó kết nối lại bằng các giá trị hiện tại.
  </Accordion>

  <Accordion title="403 Forbidden">
    Hãy tạo lại thông tin xác thực API với quyền đọc các API tài nguyên của OneLogin, người dùng và sự kiện.
  </Accordion>

  <Accordion title="Không thể truy cập tenant">
    Chỉ nhập tenant subdomain, không nhập URL đầy đủ và không nhập tên hiển thị quản trị.

    Nếu subdomain đúng mà vẫn không thể truy cập tenant, hãy kiểm tra xem OneLogin có hạn chế quyền truy cập API theo địa chỉ IP nguồn trong tài khoản của quý vị hay không. Tích hợp này yêu cầu đưa **hai** nhóm địa chỉ vào danh sách cho phép, vì Living Security tự tạo access token và làm mới liên tục — do đó các yêu cầu token và các lần đồng bộ theo lịch xuất phát từ các mạng khác nhau.

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

Để biết chi tiết từ phía nhà cung cấp, hãy xem [hướng dẫn về thông tin xác thực API của OneLogin](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.