Skip to main content
Beberapa penyedia membatasi akses API hanya untuk daftar alamat IP sumber yang telah disetujui. Jika pembatasan tersebut diaktifkan, penyedia Anda harus dikonfigurasi agar menerima lalu lintas dari alamat IP egress Living Security; jika tidak, integrasi akan ditolak pada lapisan jaringan. Halaman ini mencantumkan alamat-alamat tersebut.

Terdapat dua set

Living Security menjangkau penyedia Anda melalui dua jaringan yang berbeda, dan keduanya melayani bagian integrasi yang berbeda. Sebagian besar integrasi hanya memerlukan set sinkronisasi. Sekelompok integrasi tertentu memerlukan kedua set secara permanen — lihat Integrasi yang memerlukan kedua set.

Lalu lintas sinkronisasi integrasi

Keempat alamat ini sama untuk setiap wilayah Living Security. Pelanggan yang di-host di Uni Eropa menggunakan keempat alamat yang sama dengan pelanggan yang di-host di Amerika Serikat. Untuk penyedia yang menerima daftar yang dipisahkan koma:

Lalu lintas platform

Berbeda dengan alamat sinkronisasi, alamat ini bersifat khusus wilayah. Gunakan hanya pasangan untuk wilayah yang meng-host organisasi Anda. Jika Anda tidak yakin wilayah mana itu, tanyakan kepada Customer Success Manager Anda sebelum mengonfigurasi apa pun — mendaftarkan alamat wilayah yang salah ke allowlist menyebabkan integrasi gagal dengan cara yang tampak tidak berkaitan dengan allowlist. Untuk penyedia yang menerima daftar yang dipisahkan koma:

Tindakan Buku Pedoman keluar

Secara default, tindakan Buku Pedoman yang menulis kembali ke sistem yang terhubung melewati jalur yang sama dengan sinkronisasi data Anda, sehingga keluar dari alamat sinkronisasi. Tidak diperlukan tindakan tambahan. Administrator dapat mengalihkan koneksi tertentu ke egress langsung, yang memindahkan Tindakan koneksi tersebut ke alamat platform untuk wilayah Anda. Pengaturan ini ada untuk situasi seperti ini — instans penyedia yang membatasi akses API berdasarkan IP sumber dan memerlukan set kecil yang stabil dan dimiliki Living Security untuk didaftarkan ke allowlist. Beberapa penyedia selalu menggunakan egress langsung karena sama sekali tidak dapat diproksikan. Jika Anda hanya mendaftarkan alamat sinkronisasi ke allowlist dan kemudian seseorang mengalihkan koneksi ke egress langsung, Tindakan koneksi tersebut mulai gagal sementara sinkronisasinya tetap berjalan.

Integrasi yang memerlukan kedua set

Untuk sebagian besar integrasi, layanan integrasi Living Security memperoleh dan memperbarui token akses sendiri, dan semua lalu lintas mencapai penyedia Anda hanya dari alamat sinkronisasi. Untuk integrasi di bawah ini, layanan tersebut tidak dapat memperbarui token, sehingga platform Living Security menerbitkannya secara langsung — sekali saat Anda menghubungkan, lalu terus-menerus selama koneksi aktif. Permintaan token tersebut keluar dari alamat platform. Sinkronisasi data terjadwal tetap keluar dari alamat sinkronisasi.
Kedua set tetap terdaftar di allowlist selama koneksi berlangsung. Alamat platform bukan persyaratan untuk penyiapan saja. Pembaruan token berjalan dalam siklus singkat selama integrasi aktif, sehingga menghapusnya setelah penyiapan berhasil akan merusak integrasi saat token berikutnya kedaluwarsa.
Jika endpoint token penyedia Anda dan API datanya berada pada host yang sama — yang umum terjadi — host tersebut harus menerima kedua jaringan.

Tambahkan setiap alamat dalam set yang Anda perlukan

Lalu lintas dapat keluar dari alamat mana pun dalam suatu set, dan alamat yang digunakan untuk permintaan tertentu tidak tetap. Mendaftarkan hanya sebagian alamat ke allowlist menyebabkan kegagalan yang terjadi sesekali dan sulit didiagnosis: sebagian permintaan berhasil, sebagian lain gagal, dan polanya tampak tidak berkaitan dengan konfigurasi. Hal ini berlaku sama untuk pasangan alamat platform seperti halnya untuk keempat alamat sinkronisasi. Setiap wilayah menjalankan dua alamat, dan permintaan dapat masuk melalui salah satunya.
Alamat-alamat ini stabil, tetapi tidak permanen. Kami berupaya menjaganya tetap tidak berubah, dan hanya mengubahnya dalam kasus yang jarang dan keadaan luar biasa — seperti perubahan pada penyedia infrastruktur kami.Karena perubahan dimungkinkan, simpan halaman ini sebagai penanda. Jika integrasi yang sebelumnya berfungsi mulai gagal, kembalilah ke sini dan pastikan allowlist Anda sesuai dengan alamat di atas sebelum membuka tiket dukungan.

Integrasi mana yang memerlukan ini

Allowlist IP adalah pengaturan di penyedia Anda, bukan di Living Security. Pengaturan ini hanya berlaku jika organisasi Anda telah mengaktifkan pembatasan tersebut. Jika Anda belum mengaktifkan pembatasan IP di penyedia, tidak ada tindakan yang diperlukan. Penyedia berikut umumnya memerlukannya: Penyedia lain mungkin menawarkan pengaturan serupa. Periksa halaman penyedia di Katalog dan dokumentasi resmi penyedia tersebut.

Gejala allowlist yang hilang atau kedaluwarsa

Kedua set gagal dengan cara yang berlawanan. Cocokkan gejala dengan set yang sesuai sebelum mengubah apa pun.

Koneksi berhasil, tetapi data tidak pernah masuk

Ini adalah ciri dari alamat sinkronisasi yang hilang. Kredensial divalidasi pada saat koneksi melalui jalur yang sering kali tidak dikenai pembatasan yang sama, sehingga dialog koneksi di Living Security melaporkan keberhasilan. Kegagalan baru muncul kemudian, ketika sinkronisasi terjadwal berjalan dan diblokir. Perhatikan hal berikut:
  • Koneksi ditampilkan sebagai terhubung, tetapi stream melaporkan tidak ada rekaman.
  • Proses sinkronisasi gagal dengan 401 Unauthorized atau 403 Forbidden.
  • Integrasi yang berfungsi selama berbulan-bulan mulai gagal tanpa ada perubahan di pihak Anda.

Koneksi sama sekali tidak dapat dibuat

Ini adalah ciri dari alamat platform yang hilang, dan hanya berlaku untuk integrasi yang tercantum di Integrasi yang memerlukan kedua set. Perhatikan hal berikut:
  • Penyiapan gagal saat memperoleh token akses. Tidak ada koneksi yang dibuat.
  • Kesalahan melaporkan bahwa host tidak dapat dijangkau, tanpa adanya respons HTTP.
  • Log masuk atau log Conditional Access milik penyedia menunjukkan permintaan yang diblokir dari alamat yang belum Anda daftarkan ke allowlist.
Koneksi yang sama sekali tidak dapat dijangkau bukan masalah kredensial. Tidak ada autentikasi yang terjadi, sehingga merotasi secret atau membuat ulang kredensial klien tidak akan membantu. Alamat sumber yang belum didaftarkan ke allowlist adalah penyebab paling umum, meskipun nama host yang salah, port yang salah, atau gangguan di sisi penyedia tampak sama dari sisi kami.
Perubahan allowlist Anda di kemudian hari yang menghapus alamat platform akan terlihat berbeda lagi: integrasi yang sehat selama berminggu-minggu berhenti dalam hitungan menit, karena pembaruan token berikutnya diblokir.

Ini tidak mencakup pengiriman Simulasi Phishing

Alamat pada halaman ini berlaku untuk lalu lintas integrasi — panggilan API yang dilakukan Living Security ke sistem terhubung Anda untuk mengimpor data dan menjalankan Tindakan Buku Pedoman. Allowlist untuk pengiriman email Simulasi Phishing adalah konfigurasi terpisah dengan alamat, domain pengirim, dan paket allowlist yang dapat diunduh tersendiri. Selesaikan di Pengaturan → Simulasi Phishing → Allowlisting. Lihat Pengaturan Simulasi Phishing untuk proses tersebut. Mendaftarkan alamat pada halaman ini ke allowlist tidak akan membuat email phishing simulasi dapat terkirim, dan menyelesaikan allowlist simulasi tidak akan membuat API penyedia yang dibatasi dapat dijangkau. Jika Anda menggunakan keduanya, konfigurasikan keduanya.

Mendapatkan bantuan

Jika integrasi terus gagal setelah Anda mendaftarkan alamat untuk wilayah Anda ke allowlist, hubungi Customer Success Manager Anda atau support@livingsecurity.com. Sertakan nama penyedia, stream yang gagal atau langkah penyiapan yang gagal, dan stempel waktu agar kami dapat mencocokkannya dengan log egress kami.