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

> Hubungkan KnowBe4 ke Living Security Platform untuk mengimpor pengguna, pendaftaran pelatihan, dan hasil uji keamanan phishing.

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 EgressIpSafelist = ({system}) => <Note>
    <strong>Tambahkan keempat alamat IP egress sinkronisasi Living Security</strong> ke daftar izin di{' '}
    {system}. Masukkan setiap alamat sebagai satu host dengan <code>/32</code> jika {system} mengharapkan notasi CIDR:
    <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 />
    Lalu lintas dapat keluar dari salah satu dari keempat alamat tersebut, sehingga jika hanya sebagian yang dimasukkan ke daftar izin, sinkronisasi akan gagal secara berkala. Keempat alamat ini sama di setiap wilayah Living Security. Lihat{' '}
    <a href="/id/integrations/managing/egress-ip-addresses">
      Mengonfigurasi Alamat IP Egress Integrasi
    </a>{' '}
    untuk daftar lengkap, kebijakan perubahan, dan pemecahan masalah.
  </Note>;

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="KnowBe4" />

## 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](/id/signals/data-sources).

## Yang dibutuhkan Living Security

| Kredensial | Deskripsi |
| - | - |
| **Kunci API** | Token bearer Reporting API yang dibuat di bawah **Account Settings → API**. Dikirim pada setiap permintaan dalam header `Authorization: Bearer`. |
| **Reporting API server region** | Wilayah tempat akun KnowBe4 Anda disediakan, dipilih dari daftar (US, EU, Canada, UK, Germany). |

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

<Steps>
  <Step title="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.

    <Warning>
      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.
    </Warning>

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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](/id/integrations/managing/egress-ip-addresses) ke daftar yang diizinkan. Keempat alamat yang sama berlaku di setiap wilayah.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **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.
    </Warning>

    <Note>
      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](/id/integrations/managing/egress-ip-addresses) dan pastikan daftar Allowed IP Addresses sesuai.
    </Note>
  </Step>

  <Step title="Tentukan wilayah server KnowBe4 Anda">
    KnowBe4 menyediakan Reporting API dari host khusus wilayah. Anda memilih wilayah di dialog koneksi, bukan mengetik nama host:

    | Wilayah | Host Reporting API |
    | - | - |
    | Amerika Serikat | `us.api.knowbe4.com` |
    | Eropa | `eu.api.knowbe4.com` |
    | Kanada | `ca.api.knowbe4.com` |
    | Inggris Raya | `uk.api.knowbe4.com` |
    | Jerman | `de.api.knowbe4.com` |

    Jika Anda tidak yakin wilayah mana yang digunakan akun Anda, periksa domain URL konsol KnowBe4 Anda atau hubungi administrator KnowBe4 Anda.

    <Note>
      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.
    </Note>
  </Step>
</Steps>

***

## Bagian B — Di Living Security Platform

*Pemilik program menyelesaikan langkah ini, atau admin sistem jika menggunakan penyiapan yang didelegasikan.*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Kolom | Nilai |
    | - | - |
    | **Kunci API** | Token Reporting API dari Bagian A, Langkah 1 |
    | **Reporting API server region** | Wilayah dari Bagian A, Langkah 3 (misalnya, United States) |
  </ConnectInPlatform>
</Steps>

Anda kini telah terhubung ke KnowBe4.

***

## Pemecahan masalah

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Token API tidak valid atau telah kedaluwarsa. Pastikan token sudah benar dan belum dibuat ulang di **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    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](/id/integrations/managing/egress-ip-addresses) berada dalam daftar yang diizinkan.
  </Accordion>

  <Accordion title="Hasil kosong (200 OK tetapi tanpa data)">
    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.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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