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

# Menyiapkan Integrasi

> Siapkan kredensial penyedia, hubungkan sistem yang didukung, aktifkan aliran datanya, dan verifikasi sinkronisasi pertama yang berhasil.

Panduan ini membahas alur penyiapan umum untuk integrasi yang tercantum di bawah **Pengaturan → Integrasi → Katalog**. Kolom, izin, dan langkah autentikasi khusus penyedia terdapat pada panduan penyiapan yang ditautkan di kartu Katalog penyedia tersebut.

## Prasyarat

| Peran | Tanggung Jawab |
| - | - |
| [**Program Owner**](/id/reference/glossary#pemilik-program) | Memilih sumber, menghubungkannya di Living Security, mengaktifkan aliran data, dan memverifikasi hasilnya |
| [**System Administrator**](/id/reference/glossary#administrator-sistem) | Membuat atau menyetujui kredensial dan cakupan (scope) di sistem sumber |

Peran-peran ini dapat dipegang oleh orang yang sama. Orang yang memasukkan kredensial di Living Security harus memiliki peran administrator yang mengizinkan pengelolaan integrasi; jangan mengundang administrator sistem sumber ke Living Security hanya dengan anggapan bahwa tersedia peran penyiapan dengan cakupan terbatas.

Sebelum memulai:

* Pilih organisasi dan lingkungan Living Security tempat koneksi tersebut seharusnya berada.
* Buka panduan Katalog penyedia dan kumpulkan cakupan (scope) yang diperlukan, URL pengalihan, serta persyaratan daftar izin (allowlist).
* Gunakan proses berbagi rahasia yang disetujui organisasi Anda jika pembuat dan pemasuk kredensial adalah orang yang berbeda.
* Jangan pernah mengirim kata sandi, rahasia klien, kunci privat, atau nilai kunci akses melalui email atau tiket dukungan.

## 1. Menyiapkan Kredensial Penyedia

Buka **Pengaturan → Integrasi → Katalog**, temukan penyedia, dan baca panduan penyiapannya sebelum membuat kredensial.

Autentikasi penyedia dapat menggunakan persetujuan OAuth, token API, ID klien dan rahasia, akun layanan, atau metode lain yang didukung penyedia. Buat hanya kredensial dan cakupan yang disebutkan dalam panduan penyedia tersebut.

<Warning>
  Jangan menyalin izin dari penyedia lain atau memberikan akses tulis yang luas
  “untuk berjaga-jaga.” Izin yang kurang biasanya menghasilkan 401 atau 403 yang
  jelas dan dapat diperbaiki; izin yang berlebihan menimbulkan risiko yang
  sebenarnya dapat dihindari.
</Warning>

## 2. Menghubungkan Penyedia

<Steps>
  <Step title="Buka Katalog">
    Buka **Pengaturan → Integrasi → Katalog** dan pilih penyedia.
  </Step>

  <Step title="Mulai koneksi">
    Pilih **Hubungkan**. Selesaikan alur OAuth atau masukkan kolom yang diminta
    pada dialog koneksi. Panduan penyedia menjelaskan asal setiap nilai.
  </Step>

  <Step title="Selesaikan autentikasi">
    Setujui layar persetujuan penyedia jika ada. Setelah autentikasi berhasil, Living Security membuka atau mencantumkan koneksi baru di bawah **Terhubung**.
  </Step>
</Steps>

Jika penyedia menolak autentikasi, berhentilah dan perbaiki kredensial, tenant, wilayah, URL pengalihan, atau izin sistem sumber sebelum melanjutkan.

## 3. Mengaktifkan Aliran Data

Buka koneksi di bawah **Pengaturan → Integrasi → Terhubung**. Living Security menemukan templat sinkronisasi yang tersedia untuk penyedia tersebut dan mencantumkannya sebagai aliran data.

1. Tinjau nama dan tujuan setiap aliran data.
2. Aktifkan hanya aliran data yang dibutuhkan program Anda.
3. Biarkan aliran data yang tidak terkait tetap dijeda.
4. Gunakan **Sinkronkan Sekarang** jika tersedia untuk meminta proses pertama dijalankan.

Tidak semua penyedia menawarkan aliran data atau kontrol jadwal yang sama. Ikuti kontrol yang ditampilkan pada koneksi, dan jangan mengharapkan adanya frekuensi, cakupan, pemetaan kolom, draf, atau wizard aktivasi yang seragam.

## 4. Memverifikasi Proses Pertama

Autentikasi koneksi saja tidak membuktikan bahwa data mengalir.

<Steps>
  <Step title="Periksa kondisi koneksi">
    Pastikan koneksi dalam kondisi sehat dan tidak meminta otorisasi ulang.
  </Step>

  <Step title="Periksa status aliran data">
    Pastikan aliran data yang diperlukan diaktifkan, bukan dijeda.
  </Step>

  <Step title="Periksa proses terbaru">
    Buka aliran data, tautan sinkronisasi koneksi, atau **Pengaturan** → **Integrasi** → **Sinkronisasi**. Tunggu hingga hasil akhir berhasil, lalu tinjau kesalahan penyedia dan jumlah rekaman jika tersedia.
  </Step>

  <Step title="Konfirmasi data hilir">
    Buka bagian Living Security yang relevan. Data identitas seharusnya menghasilkan orang dan identitas yang diharapkan di Tenaga Kerja; data sumber keamanan seharusnya muncul pada fitur yang didokumentasikan oleh penyedia tersebut.
  </Step>
</Steps>

Untuk orientasi, tugas **Verify Identity Data Flowing** dan **Verify Integration Data Flowing** pada Journey Map diselesaikan berdasarkan data yang telah diserap. Jangan menggantikan hasil verifikasi tersebut dengan koneksi yang sekadar tersimpan.

## Halaman detail sinkronisasi

Dari **Pengaturan** → **Integrasi** → **Sinkronisasi**, buka sinkronisasi mana pun untuk melihat konfigurasi dan riwayat prosesnya di satu tempat.

Halaman detail menampilkan:

| Bagian | Isi |
| - | - |
| **Header** | Nama sinkronisasi, lencana status, dan penyedia integrasi |
| **Statistik** | Model, sinkronisasi terakhir, proses yang selesai, dan total rekaman |
| **Riwayat proses** | Proses terbaru beserta status, waktu, dan jumlah rekaman |
| **Tindakan** | **Segarkan**, **Jeda** / **Lanjutkan**, dan **Sinkronkan Sekarang** |

Gunakan **Sinkronkan Sekarang** untuk memicu proses segera ketika sinkronisasi aktif. Sinkronisasi yang dijeda harus dilanjutkan terlebih dahulu sebelum proses terjadwal atau manual yang baru dimulai.

Anda juga dapat membuka sinkronisasi dari halaman detail koneksinya ketika integrasi mencantumkan aliran data yang aktif.

## Operasi Koneksi

Halaman detail koneksi menyediakan operasi yang didukung oleh integrasi tersebut:

| Operasi | Efek |
| - | - |
| **Sinkronkan Sekarang** | Meminta proses segera untuk aliran data yang dipilih |
| **Pause stream** | Menghentikan proses baru untuk aliran data tersebut dengan tetap mempertahankan koneksi |
| **Jeda koneksi** | Menghentikan aktivitas koneksi yang didukung tanpa menghapus konfigurasi |
| **Lanjutkan** | Memulai kembali aliran data atau koneksi yang dijeda |
| **Reauthorize** | Mengulangi autentikasi setelah kredensial atau persetujuan berubah |
| **Hapus** | Menghapus konfigurasi koneksi setelah konfirmasi |

Menghapus koneksi tidak sama dengan menghapus data yang telah diserap darinya. Tinjau panduan penyedia atau hubungi Dukungan jika perilaku retensi data memengaruhi keputusan Anda.

## Sumber Push Kustom

Gunakan **Custom Push Source** ketika suatu sistem mengirim data ke Living Security, bukan diambil melalui konektor Katalog.

1. Buat sumber dari bagian bawah **Katalog**.
2. Buka halaman detailnya di area push kustom.
3. Pilih aliran data tujuan.
4. Gunakan **Upload CSV** untuk batch manual atau **Push via API** untuk pengirim otomatis.
5. Pratinjau file atau payload dan tinjau riwayat proses sumber setelah pengiriman.

Untuk kontrak lengkap mengenai endpoint, autentikasi, payload, percobaan ulang, dan verifikasi, lihat [Custom Push Source API](/id/integrations/custom-push-source). Jangan menyimpulkan detail tersebut dari panduan integrasi Unify yang lebih lama.

Pengunggah pada detail sumber menerima file CSV sumber hingga 100 MB. Sebelum pengunggahan, Dasbor membaginya di sisi klien menjadi permintaan yang masing-masing tidak lebih dari 10 MB dan 10.000 baris. Pengunggah khusus sumber ini terpisah dari halaman umum **Integrasi → Unggah** untuk templat identitas dan aktivitas.

## Pemecahan Masalah

| Gejala | Periksa |
| - | - |
| `401 Unauthorized` | Nilai kredensial, masa berlaku, pencabutan, tenant penyedia, dan status otorisasi ulang |
| `403 Forbidden` | Peran penyedia yang diperlukan, cakupan, persetujuan admin, dan kebijakan akses sistem sumber |
| Koneksi langsung gagal | URL pengalihan, wilayah, URL sumber, serta persyaratan daftar izin jaringan atau IP |
| Koneksi sehat tetapi tidak ada proses yang berjalan | Aliran data yang diperlukan diaktifkan dan penyedia menyediakan aliran data tersebut |
| Proses berhasil tetapi tidak mengembalikan rekaman | Akun sumber dapat melihat populasi yang diharapkan dan filter di sisi penyedia sudah benar |
| Data muncul pada orang yang salah | Atribut identitas dan alias konsisten di seluruh sumber yang terhubung |
| Data berhenti diperbarui | Aliran data atau koneksi dijeda, kredensial kedaluwarsa, atau proses terbaru gagal |

Saat menghubungi [Dukungan Living Security](mailto:support@livingsecurity.com), sertakan organisasi, penyedia, nama koneksi, aliran data, waktu proses terbaru, dan kesalahan yang terlihat. Jangan menyertakan rahasia.

## Terkait

<CardGroup cols={2}>
  <Card title="Ikhtisar Integrasi" icon="grid-2" href="/id/integrations/overview">
    Referensi untuk Terhubung, Katalog, Sinkronisasi, Tindakan, dan Unggah.
  </Card>

  <Card title="Pemetaan Data" icon="arrows-left-right" href="/id/integrations/managing/data-mapping">
    Pahami atribut dan pemetaan yang didukung jika tersedia.
  </Card>

  <Card title="Siklus Hidup Integrasi" icon="route" href="/id/integrations/managing/lifecycle">
    Kelola integrasi yang sudah ada hingga otorisasi ulang atau penghapusan.
  </Card>

  <Card title="Orientasi Administrator" icon="circle-check" href="/id/getting-started/onboarding">
    Selesaikan tugas verifikasi data identitas dan data keamanan.
  </Card>
</CardGroup>


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