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

> Hubungkan NINJIO ke Living Security Platform untuk mengimpor hasil pelatihan kesadaran keamanan dan hasil Simulasi Phishing bagi Tenaga Kerja Anda.

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

## Kontribusi integrasi ini

NINJIO dapat menyumbangkan Hasil Tenaga Kerja, Pelatihan, dan Simulasi Phishing. Contoh yang telah ditinjau meliputi:

* `training.assigned` — memiliki pelatihan keamanan yang ditugaskan
* `training.completed` — menyelesaikan pelatihan keamanan
* `training.passed` — lulus penilaian pelatihan keamanan
* `phishing.simulation.clicked` — mengeklik simulasi tanpa melaporkannya
* `phishing.simulation.reported` — melaporkan simulasi phishing

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** | Kunci API NINJIO dengan akses baca ke access point karyawan, pelatihan, dan phishing. Living Security mengirimkannya pada setiap permintaan. |

**Cakupan (scope):** NINJIO menetapkan cakupan setiap Kunci API per *access point*, dengan izin baca dan tulis yang terpisah. Living Security memerlukan izin **baca** pada tiga access point: karyawan, pelatihan, dan phishing. Akses tulis tidak diperlukan dan sebaiknya tidak diberikan.

**Peran yang diperlukan:** **Administrator** pada akun NINJIO Anda. Hanya administrator yang dapat mengakses area Integrasi tempat kunci dibuat.

<Warning>
  **NINJIO hanya menampilkan kunci baru satu kali, pada saat kunci dibuat.** Salin kunci tersebut langsung ke Living Security Platform, atau ke brankas kata sandi, sebelum Anda berpindah halaman. Kunci yang tidak Anda salin tidak dapat diambil kembali — Anda harus membuat kunci pengganti.
</Warning>

### Data yang diambil Living Security

| Data | Detail |
| - | - |
| **Pembelajar** | Direktori karyawan NINJIO Anda: nama, email, departemen, jabatan, atasan, negara, cabang, dan status aktif. |
| **Pelatihan** | Siapa yang ditugaskan untuk setiap pelatihan dan siapa yang telah menyelesaikannya — beserta tanggal penyelesaian, skor ujian, dan skor keterlibatan. |
| **Phishing** | Siapa yang berinteraksi dengan email phishing simulasi dan siapa yang melaporkannya, beserta waktu kejadiannya. |

<Note>
  **Nomor telepon Pembelajar tidak disimpan.** NINJIO menyertakan nomor telepon pada data karyawan. Living Security membuangnya sebelum menyimpan data apa pun, karena tidak ada fitur Living Security yang menggunakannya.
</Note>

### Prasyarat

* Akun NINJIO dengan akses API.
* Akses administrator ke [admin.goninjio.com](https://admin.goninjio.com/).
* Alamat email Pembelajar di NINJIO yang sesuai dengan alamat yang digunakan oleh sistem Anda yang lain yang terhubung. Email digunakan oleh Living Security untuk mencocokkan Pembelajar NINJIO dengan seseorang.

***

## Bagian A — Di NINJIO

*Administrator NINJIO Anda menyelesaikan langkah-langkah ini.*

<Steps>
  <Step title="Buka area Integrasi">
    1. Masuk ke [admin.goninjio.com](https://admin.goninjio.com/) sebagai administrator.
    2. Pilih **Integration** di bagian kanan atas layar.
  </Step>

  <Step title="Buat Kunci API">
    1. Pilih **New API Key**.
    2. Beri kunci nama yang mudah Anda kenali nanti — misalnya `Living Security`.
    3. Berikan akses **baca** ke access point **employee**, **training**, dan **phishing**.
    4. Biarkan akses tulis tidak dipilih. Living Security hanya membaca data dari NINJIO.
    5. Pilih **Generate Key**.

    <Warning>
      Salin kunci sekarang. NINJIO hanya menampilkannya satu kali dan tidak dapat menampilkannya lagi.
    </Warning>
  </Step>
</Steps>

***

## Bagian B — Di Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Bidang | Nilai |
    | - | - |
    | **Kunci API** | Kunci yang Anda buat di Bagian A |
  </ConnectInPlatform>
</Steps>

Anda kini telah terhubung ke NINJIO.

***

## Seberapa sering data diambil

| Data | Jadwal |
| - | - |
| Pembelajar | Harian |
| Hasil Pelatihan | Setiap 6 jam |
| Hasil Simulasi Phishing | Setiap 6 jam |

Pada koneksi pertama, Living Security mengambil data penyelesaian pelatihan selama 12 bulan terakhir, lalu melanjutkan secara inkremental. Setiap Simulasi Phishing dibaca satu kali dan diperiksa ulang selama dua minggu setelah berakhir, sehingga klik dan laporan yang terlambat tetap tercatat.

<Note>
  Koneksi pertama pada akun NINJIO yang besar dapat memerlukan beberapa kali proses terjadwal hingga semua data selesai dibaca. Setiap proses membaca sebanyak yang dapat dilakukan dan proses berikutnya melanjutkan dari titik terakhir, sehingga jumlah data bertambah selama satu atau dua hari pertama dan tidak muncul sekaligus.
</Note>

***

## Pemecahan masalah

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Kunci API salah atau tidak lengkap. Penyebab yang paling umum adalah kunci yang hanya tersalin sebagian — NINJIO hanya menampilkannya satu kali, sehingga hasil tempel yang terpotong mudah terjadi dan tidak mungkin dikenali setelahnya. Buat kunci baru di NINJIO dan hubungkan kembali dengan kunci tersebut.
  </Accordion>

  <Accordion title="403 Forbidden">
    Ini **bukan** masalah kredensial. Kunci berhasil diautentikasi, tetapi salah satu access point yang diperlukan tidak diberi izin baca.

    Menempelkan ulang kunci yang sama tidak akan membantu. Di NINJIO, buat kunci dengan akses **baca** ke ketiga access point — employee, training, dan phishing — lalu hubungkan kembali dengan kunci tersebut.
  </Accordion>

  <Accordion title="Berhasil terhubung tetapi tidak ada data Pelatihan">
    Periksa di NINJIO bahwa setidaknya satu kampanye pelatihan berstatus **aktif** dan memiliki simulasi yang terlampir. Kampanye tanpa simulasi tetap tidak aktif dan tidak menghasilkan apa pun, sehingga tidak ada hasil yang dapat diambil.

    Jika kampanye sudah aktif, pastikan Pembelajar di dalamnya memiliki alamat email pada data NINJIO mereka. Pembelajar tanpa alamat email tidak dapat dicocokkan dengan seseorang dan akan dilewati.
  </Accordion>

  <Accordion title="Pelatihan tampil sebagai ditugaskan tetapi tidak pernah selesai">
    Itulah tampilan yang diharapkan untuk pelatihan yang belum diselesaikan oleh Pembelajar. Living Security mencatat penugasan saat simulasi NINJIO dimulai, dan mencatat penyelesaian secara terpisah ketika NINJIO melaporkan tanggal penyelesaian.
  </Accordion>

  <Accordion title="Beberapa Pembelajar tidak ada">
    Living Security mencocokkan Pembelajar NINJIO dengan seseorang berdasarkan **alamat email**. Pembelajar yang email NINJIO-nya berbeda dari alamat yang tersimpan di direktori Anda — misalnya alamat pribadi, domain lama, atau salah ketik — tidak akan cocok.

    Perbaiki alamat tersebut di NINJIO dan data akan cocok pada pengambilan terjadwal berikutnya.
  </Accordion>

  <Accordion title="Hasil Simulasi Phishing tidak ada untuk simulasi yang lebih lama">
    Living Security memeriksa ulang Simulasi Phishing selama dua minggu setelah berakhir, lalu berhenti. Hasil yang dicatat NINJIO setelah jangka waktu tersebut tidak diambil. Hubungi dukungan jika Anda memerlukan simulasi yang lebih lama dibaca ulang.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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