Skip to main content

​
Kontribusi integrasi ini

KnowBe4 dapat menyumbangkan data Tenaga Kerja, Pelatihan, dan Hasil simulasi phishing. Contoh yang telah ditinjau meliputi:
  • training.completed — menyelesaikan pelatihan keamanan
  • training.past.due — memiliki pelatihan yang terlambat
  • phishing.simulation.clicked — mengeklik simulasi tanpa melaporkannya
Contoh-contoh ini menunjukkan jenis aktivitas ternormalisasi yang dapat digunakan oleh Living Security. Lihat bagaimana data integrasi menjadi sinyal.

​
Yang dibutuhkan Living Security

Cakupan (scope): Tidak ada yang perlu dikonfigurasi — token Reporting API KnowBe4 bersifat hanya-baca secara desain dan tidak memiliki cakupan. Token ini memberikan akses baca ke pengguna, pendaftaran pelatihan, dan hasil uji keamanan phishing, yang persis merupakan data yang dibaca oleh sinkronisasi. Peran yang diperlukan: Account Admin di KnowBe4 (hanya administrator akun yang dapat mengakses Account Settings → API)

​
Prasyarat

  • Anda harus masuk ke konsol KnowBe4 Anda dengan peran Account Admin. Hanya administrator akun yang dapat mengakses Account Settings → API untuk mengaktifkan Reporting API dan membuat token.

​
Bagian A — Di KnowBe4

Administrator KnowBe4 Anda menyelesaikan langkah-langkah ini.
1

Aktifkan Reporting API dan buat token

  1. Masuk ke konsol KnowBe4 Anda.
  2. Klik nama akun Anda di pojok kanan atas, lalu pilih Account Settings.
  3. Pada navigasi kiri, pilih API.
  4. Aktifkan Reporting API jika belum aktif, lalu buat token API baru.
Berikan tujuan yang deskriptif pada token (misalnya, Living Security Platform) jika konsol Anda memintanya.
KnowBe4 menampilkan nilai token API hanya satu kali saat token dibuat. Salin segera dan simpan di lokasi yang aman (misalnya, brankas kata sandi atau pengelola rahasia). Jika Anda berpindah halaman tanpa menyalinnya, Anda harus membuat token baru.
Reporting API bersifat hanya-baca. API ini menyediakan pengguna, pendaftaran pelatihan, dan hasil uji keamanan phishing — data yang diserap Living Security untuk penilaian dan pelaporan. Akses tulis tidak diperlukan.
2

Tambahkan IP egress Living Security ke daftar Allowed IP Addresses

KnowBe4 memungkinkan Anda membatasi akses Reporting API ke sekumpulan alamat IP sumber tertentu. Pengaturan ini berada di tempat yang sama dengan token:
  1. Di konsol KnowBe4 Anda, buka Account Settings → API → Allowed IP Addresses.
  2. Tambahkan setiap alamat IP egress Living Security ke daftar yang diizinkan. Keempat alamat yang sama berlaku di setiap wilayah.
Jika daftar Allowed IP Addresses dikonfigurasi, daftar tersebut diberlakukan pada lapisan jaringan. Dialog koneksi akan berhasil pada saat autentikasi, tetapi sinkronisasi data akan gagal (diblokir pada lapisan jaringan, biasanya muncul sebagai 403) hingga IP egress Living Security ditambahkan ke daftar yang diizinkan. Jika Anda menambahkan alamat apa pun ke daftar ini, Anda juga harus menambahkan rentang IP Living Security, atau permintaan kami akan ditolak meskipun token Anda valid.
Alamat IP egress Living Security dapat berubah saat infrastruktur diperbarui, meskipun kami menjaga agar perubahan tersebut jarang terjadi. Jika sinkronisasi data mulai gagal setelah sebelumnya berfungsi, periksa Mengonfigurasi Alamat IP Egress Integrasi dan pastikan daftar Allowed IP Addresses sesuai.
3

Tentukan wilayah server KnowBe4 Anda

KnowBe4 menyediakan Reporting API dari host khusus wilayah. Anda memilih wilayah di dialog koneksi, bukan mengetik nama host:Jika Anda tidak yakin wilayah mana yang digunakan akun Anda, periksa domain URL konsol KnowBe4 Anda atau hubungi administrator KnowBe4 Anda.
Kelima wilayah ini adalah yang dapat dijangkau oleh Living Security. Jika akun KnowBe4 Anda berada di server lain (misalnya instans US Government), hubungi dukungan Living Security sebelum memulai koneksi.

​
Bagian B — Di Living Security Platform

Pemilik program menyelesaikan langkah ini, atau admin sistem jika menggunakan penyiapan yang didelegasikan.
Anda kini telah terhubung ke KnowBe4.

​
Pemecahan masalah

Token API tidak valid atau telah kedaluwarsa. Pastikan token sudah benar dan belum dibuat ulang di Account Settings → API.
Token tidak memiliki akses Reporting API, atau IP permintaan tidak ada dalam daftar Allowed IP Addresses. Pastikan Reporting API diaktifkan dan keempat alamat IP egress Living Security berada dalam daftar yang diizinkan.
Reporting API mungkin belum memiliki data untuk dikembalikan, atau akun pemilik token tidak memiliki visibilitas ke pengguna dan kampanye yang diserap Living Security. Pastikan token dibuat oleh Account Admin.