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

# Penyiapan integrasi OneLogin

> Hubungkan OneLogin ke Living Security untuk siklus hidup pengguna, autentikasi, MFA, dan aktivitas administratif.

export const EgressIpAllowlistBothSets = ({system}) => <Warning>
    <strong>{system} memerlukan dua set alamat, bukan satu.</strong> Living Security membuat token akses integrasi ini pada infrastrukturnya sendiri dan memperbaruinya secara terus-menerus, sehingga lalu lintas penyiapan dan lalu lintas sinkronisasi keluar dari jaringan yang berbeda. Masukkan kedua set ke daftar izin di {system}, dan
    pertahankan keduanya — ini bukan persyaratan yang hanya berlaku saat penyiapan.
    <br />
    <br />
    <strong>Lalu lintas sinkronisasi Integrasi</strong> — sama di setiap wilayah:
    <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>Lalu lintas platform</strong> — gunakan hanya baris untuk wilayah yang menjadi host organisasi Anda:
    <br />
    Amerika Serikat: <code>98.91.60.249/32</code>, <code>13.216.91.102/32</code>
    <br />
    Uni Eropa: <code>34.246.236.210/32</code>, <code>52.31.102.238/32</code>
    <br />
    <br />
    Jika hanya set sinkronisasi yang dimasukkan ke daftar izin, penyiapan tidak akan pernah selesai. Jika hanya set platform yang dimasukkan ke daftar izin, penyiapan berhasil tetapi setiap sinkronisasi gagal. Lihat{' '}
    <a href="/id/integrations/managing/egress-ip-addresses">
      Mengonfigurasi Alamat IP Egress Integrasi
    </a>{' '}
    untuk kedua ciri kegagalan tersebut dan kebijakan perubahan.
  </Warning>;

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Sumber daya terkait</h2>
    <ul>
      <li>
        <a href="/id/signals/data-sources">Pelajari bagaimana data integrasi menjadi sinyal Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Jelajahi integrasi Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Buka Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Minta demo Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Masukkan kredensial di Living Security Platform">
    <p>
      Dilakukan oleh pihak yang memiliki akses ke Living Security — pemilik program, atau admin
      sistem jika yang bersangkutan telah diundang (penyiapan terdelegasi).
    </p>
    <ol>
      <li>
        Buka <strong>Pengaturan → Integrasi → Katalog</strong>, temukan kartu{' '}
        <strong>{tile}</strong>, lalu klik <strong>Hubungkan</strong>.
      </li>
      <li>
        Isi kolom di bawah ini, lalu klik <strong>Hubungkan</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Panduan ini ditujukan bagi administrator {system} Anda.</strong> Panduan ini membahas pembuatan kredensial API
      di dalam {system}, yang memerlukan akses admin ke {system}, bukan ke
      Living Security Platform.
    </p>
    <p>
      Jika Anda adalah <strong>pemilik program</strong> Living Security dan tidak mengelola {system},
      kirimkan halaman ini kepada pihak yang mengelolanya. Mereka menyelesaikan Bagian A dan menyerahkan kembali kredensial tersebut kepada Anda
      (atau memasukkannya secara langsung jika Anda telah mengundang mereka ke dalam platform).
      {recommendDelegated && <>
          {' '}Karena proses penyiapan menghasilkan materi kunci yang sensitif, kami merekomendasikan jalur{' '}
          <strong>penyiapan terdelegasi</strong> agar secret tidak pernah dikirimkan kembali kepada Anda.
        </>}
    </p>
  </Note>;

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

## Kontribusi integrasi ini

OneLogin dapat menyumbangkan data aktivitas siklus hidup pengguna, autentikasi, MFA, dan administratif yang telah dinormalisasi. Contoh yang telah ditinjau meliputi:

* `mfa.success` — menyelesaikan tantangan MFA
* `mfa.failed` — gagal dalam tantangan MFA
* `account.locked` — akun terkunci

Lihat [bagaimana data integrasi menjadi Sinyal](/id/signals/data-sources).

## Yang dibutuhkan Living Security

| Kredensial | Deskripsi |
| - | - |
| **ID Klien** | ID klien dari pasangan kredensial API OneLogin yang memiliki izin untuk membaca pengguna dan peristiwa. |
| **Client secret** | Client secret dari pasangan kredensial tersebut. |
| **Subdomain tenant** | Nilai sebelum `.onelogin.com` pada URL tenant OneLogin Anda. |

## Penyiapan

<Steps>
  <Step title="Buat kredensial API di OneLogin">
    Sebagai pemilik akun atau administrator, buka **Developers → API Credentials**, buat kredensial khusus, lalu pilih cakupan (scope) yang dapat membaca pengguna dan peristiwa. Simpan ID klien dan secret dengan aman.
  </Step>

  <ConnectInPlatform tile="OneLogin">
    Masukkan subdomain tenant, ID klien, dan client secret, lalu hubungkan.
  </ConnectInPlatform>
</Steps>

Living Security menukarkan pasangan kredensial dengan token akses dan memperbaruinya
sebelum kedaluwarsa, sehingga Anda tidak perlu membuat atau merotasi token. Rotasikan
pasangan kredensial itu sendiri sesuai jadwal rutin Anda, lalu hubungkan kembali tile tersebut setelahnya.

## Verifikasi dan pemecahan masalah

Pastikan koneksi dapat membaca setidaknya satu pengguna. Peristiwa audit mungkin kosong jika tenant tidak memiliki aktivitas terbaru.

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    ID klien atau client secret salah, atau pasangan kredensial telah dihapus di OneLogin. Pastikan pasangan tersebut masih ada di **Developers → API Credentials**, lalu hubungkan kembali dengan nilai terbaru.
  </Accordion>

  <Accordion title="403 Forbidden">
    Buat ulang kredensial API dengan izin untuk membaca API sumber daya OneLogin, pengguna, dan peristiwa.
  </Accordion>

  <Accordion title="Tenant tidak dapat dijangkau">
    Masukkan hanya subdomain tenant, bukan URL lengkap dan bukan nama tampilan administratif.

    Jika subdomain sudah benar dan tenant tetap tidak dapat dijangkau, periksa apakah OneLogin membatasi akses API berdasarkan alamat IP sumber di akun Anda. Integrasi ini mengharuskan **dua** set alamat dimasukkan ke daftar yang diizinkan, karena Living Security membuat sendiri token akses dan memperbaruinya secara berkelanjutan — sehingga permintaan token dan sinkronisasi terjadwal berasal dari jaringan yang berbeda.

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

Untuk detail dari sisi vendor, lihat [panduan kredensial API 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.