Skip to main content
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-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.
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.

2. Menghubungkan Penyedia

1

Buka Katalog

Buka Pengaturan → Integrasi → Katalog dan pilih penyedia.
2

Mulai koneksi

Pilih Hubungkan. Selesaikan alur OAuth atau masukkan kolom yang diminta pada dialog koneksi. Panduan penyedia menjelaskan asal setiap nilai.
3

Selesaikan autentikasi

Setujui layar persetujuan penyedia jika ada. Setelah autentikasi berhasil, Living Security membuka atau mencantumkan koneksi baru di bawah Terhubung.
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.
1

Periksa kondisi koneksi

Pastikan koneksi dalam kondisi sehat dan tidak meminta otorisasi ulang.
2

Periksa status aliran data

Pastikan aliran data yang diperlukan diaktifkan, bukan dijeda.
3

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

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

Saat menghubungi Dukungan Living Security, sertakan organisasi, penyedia, nama koneksi, aliran data, waktu proses terbaru, dan kesalahan yang terlihat. Jangan menyertakan rahasia.

Terkait

Ikhtisar Integrasi

Referensi untuk Terhubung, Katalog, Sinkronisasi, Tindakan, dan Unggah.

Pemetaan Data

Pahami atribut dan pemetaan yang didukung jika tersedia.

Siklus Hidup Integrasi

Kelola integrasi yang sudah ada hingga otorisasi ulang atau penghapusan.

Orientasi Administrator

Selesaikan tugas verifikasi data identitas dan data keamanan.