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

# Pengaturan integrasi Adaptive Security

> Hubungkan Adaptive Security ke Living Security Platform untuk mengimpor hasil simulasi phishing, smishing, dan vishing serta hasil pelatihan kesadaran keamanan 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="Adaptive Security" />

## Kontribusi integrasi ini

Adaptive Security dapat menyumbangkan data tenaga kerja, pelatihan, dan hasil simulasi multisaluran. Contoh yang telah ditinjau meliputi:

* `phishing.simulation.clicked` — mengeklik email simulasi tanpa melaporkannya
* `phishing.simulation.credential.submitted` — memasukkan kredensial pada halaman masuk simulasi
* `phishing.simulation.attachment.opened` — membuka lampiran pada email simulasi
* `phishing.simulation.reported` — melaporkan email simulasi
* `smishing.simulation.replied` — membalas pesan teks simulasi
* `vishing.simulation.succeeded` — menuruti penelepon suara simulasi
* `training.assigned` — ditugaskan pelatihan keamanan
* `training.completed` — menyelesaikan pelatihan keamanan
* `training.past.due` — melewatkan tenggat waktu pelatihan

Contoh-contoh ini menunjukkan jenis aktivitas ternormalisasi yang dapat digunakan oleh Living Security. Lihat
[bagaimana data integrasi menjadi sinyal](/id/signals/data-sources).

<Note>
  **Adaptive melakukan simulasi melalui tiga saluran, dan Living Security menilai masing-masing secara terpisah.**
  Hasil email dinilai sebagai phishing, hasil pesan teks sebagai smishing, dan hasil
  panggilan suara sebagai vishing. Orang yang mengeklik email simulasi dan orang yang membalas pesan
  teks simulasi tidak diukur sebagai perilaku yang sama, karena penilaian yang
  dibuat oleh masing-masing berbeda.
</Note>

## Yang dibutuhkan Living Security

| Kredensial | Deskripsi |
| - | - |
| **Token API** | Token API Adaptive Security. Living Security mengirimkannya sebagai bearer token pada setiap permintaan. |

**Peran yang diperlukan:** Administrator pada akun Adaptive Security Anda dengan akses ke
**Settings → API**. Adaptive mengatur akses API melalui izin berbasis peran, sehingga
token harus dimiliki oleh peran yang dapat membaca data pengguna, phishing, dan pelatihan.

**Akses:** Hanya-baca. Living Security hanya membaca dari Adaptive Security dan tidak pernah
membuat, mengubah, atau menghapus apa pun di akun Anda.

### Data yang diambil Living Security

| Data | Detail |
| - | - |
| **Orang** | Direktori pengguna Adaptive Anda: nama, email, departemen, jabatan, nama dan email atasan, lokasi, divisi, status kepegawaian, dan tanggal mulai. |
| **Simulasi email** | Per orang per simulasi: kapan pesan dikirim, dibuka, diklik, dibalas, lampirannya dibuka, kode QR-nya dipindai, kredensial dimasukkan, atau dilaporkan. |
| **Simulasi teks** | Per orang per simulasi: terkirim, dibuka, diklik, dibalas, kredensial dimasukkan, atau dilaporkan. |
| **Simulasi suara** | Per orang per simulasi: umpan yang dikirim, nomor yang dihubungi, apakah orang tersebut menuruti penelepon, dan apakah mereka melaporkannya. |
| **Pelatihan** | Per orang per kampanye: kapan mereka didaftarkan, kapan tenggat waktunya, kapan mereka memulai, kapan mereka menyelesaikannya, dan apakah mereka mengakui kebijakan kampanye. |

<Note>
  **Nomor telepon tidak disimpan.** Adaptive mengembalikan nomor kantor dan nomor seluler pada catatan penggunanya. Living Security membuang keduanya sebelum menyimpan data apa pun, karena tidak ada fitur Living Security yang menggunakannya.
</Note>

<Note>
  **Skor risiko milik Adaptive dicatat tetapi tidak pernah dinilai.** Adaptive menghitung
  `current_risk_score` per orang. Living Security menyimpannya agar Anda dapat membandingkan kedua
  sistem secara berdampingan, tetapi Indeks Risiko Manusia selalu dihitung dari perilaku
  yang teramati menggunakan model yang dipublikasikan oleh Living Security sendiri — tidak pernah dari skor komposit vendor lain.
</Note>

### Prasyarat

* Akun Adaptive Security dengan API yang telah diaktifkan.
* Akses administrator ke [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* Alamat email pengguna di Adaptive yang sama dengan alamat yang digunakan oleh sistem terhubung Anda yang lain. Email adalah cara Living Security mencocokkan pengguna Adaptive dengan seseorang.

***

## Bagian A — Di Adaptive Security

*Administrator Adaptive Security Anda menyelesaikan langkah-langkah ini.*

<Steps>
  <Step title="Buka pengaturan API">
    1. Masuk ke [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) sebagai administrator.
    2. Buka **Settings → API**.
  </Step>

  <Step title="Buat token API">
    1. Buat token API baru.
    2. Beri nama yang mudah Anda kenali nanti — misalnya `Living Security`.
    3. Pastikan peran token tersebut dapat membaca data pengguna, kampanye phishing, dan kampanye pelatihan.
    4. Salin token.

    <Warning>
      Salin token sebelum Anda meninggalkan halaman. Jika akun Adaptive Anda menetapkan masa berlaku pada
      token, catat tanggalnya — Living Security tidak dapat mengambil data setelah token kedaluwarsa, dan
      koneksi harus diperbarui dengan token baru.
    </Warning>
  </Step>
</Steps>

***

## Bagian B — Di Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Kolom | Nilai |
    | - | - |
    | **Token API** | Token yang Anda buat di Bagian A |
  </ConnectInPlatform>
</Steps>

Anda kini telah terhubung ke Adaptive Security.

***

## Seberapa sering data diambil

| Data | Jadwal |
| - | - |
| Orang | Setiap 6 jam |
| Hasil simulasi (email, teks, suara) | Setiap 6 jam |
| Hasil pelatihan | Setiap 6 jam |

API pelaporan Adaptive tidak menyediakan filter "apa yang berubah sejak", sehingga Living Security
membaca setiap simulasi dan kampanye pelatihan selama masih menghasilkan hasil, dan
berhenti membacanya setelah kampanye ditutup selama dua minggu. Dengan demikian, klik dan laporan yang terlambat
tetap tertangkap, dan kampanye yang telah selesai tidak dibaca ulang selamanya.

<Note>
  Koneksi pertama pada akun Adaptive yang besar dapat memerlukan beberapa kali proses terjadwal untuk menyelesaikan
  pembacaan seluruh data. Setiap proses membaca sebanyak yang dapat dilakukan dan proses berikutnya melanjutkan dari titik
  terakhir, sehingga jumlah data bertambah secara bertahap selama satu atau dua hari pertama, bukan muncul sekaligus.
</Note>

***

## Pemecahan masalah

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Token API salah, kedaluwarsa, atau telah dicabut. Adaptive mengembalikan isi respons kosong
    pada kesalahan ini, sehingga tidak ada detail lebih lanjut yang dapat dibaca. Buat token baru di
    **Settings → API** dan hubungkan kembali dengan token tersebut. Token yang tersalin sebagian menghasilkan
    kesalahan yang sama, dan merupakan penyebab yang paling umum.
  </Accordion>

  <Accordion title="403 Forbidden">
    Token berhasil diautentikasi, tetapi perannya tidak dapat membaca data yang diminta. Menempelkan ulang
    token yang sama tidak akan membantu. Di Adaptive, pastikan peran token memiliki akses baca ke data pengguna,
    phishing, dan pelatihan, atau terbitkan token dari peran yang memilikinya.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive membatasi laju koneksi. Living Security menghentikan proses tersebut dan melanjutkan dari
    titik yang sama pada proses terjadwal berikutnya, sehingga tidak ada data yang hilang — jumlah data hanya
    membutuhkan waktu lebih lama untuk bertambah. Jika hal ini berlanjut selama berhari-hari, hubungi dukungan Adaptive Security untuk menanyakan
    batas laju yang berlaku pada akun Anda.
  </Accordion>

  <Accordion title="Orang muncul, tetapi tidak ada hasil simulasi">
    Periksa apakah kampanye yang Anda harapkan benar-benar telah berjalan. Adaptive hanya melaporkan pendaftaran
    untuk simulasi yang telah dikirim, sehingga kampanye yang masih berstatus **Draft** atau **Scheduled**
    tidak menyumbangkan apa pun sampai kampanye tersebut dikirim. Living Security sengaja tidak membaca
    kampanye tersebut agar kuota permintaannya digunakan untuk kampanye yang memiliki hasil nyata.
  </Accordion>

  <Accordion title="Simulasi suara atau teks tidak ada">
    Living Security menentukan saluran dari setiap hasil berdasarkan skenario yang terkait dengannya. Jika
    skenario dihapus di Adaptive setelah simulasinya berjalan, hasilnya dicatat
    pada saluran email, karena saluran tersebut tidak lagi dapat dibaca. Menyimpan skenario yang sudah tidak digunakan
    di Adaptive dan tidak menghapusnya dapat menghindari hal ini.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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