> ## 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 Abnormal Security

> Hubungkan Abnormal Security untuk mengimpor data ancaman email dan kampanye 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="Abnormal Security" />

## Kontribusi integrasi ini

Abnormal Security dapat menyumbangkan aktivitas ancaman email, pengiriman, pemblokiran, dan pelaporan karyawan yang telah dinormalisasi. Contoh yang telah ditinjau meliputi:

* `phishing.real.blocked` — phishing nyata yang diblokir sebelum dikirim
* `phishing.real.delivered` — phishing nyata yang terkirim ke kotak masuk
* `phishing.real.reported` — melaporkan email phishing nyata

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

## Yang dibutuhkan Living Security

| Kredensial | Deskripsi |
| - | - |
| **Kunci API** | Token bearer REST API yang dibuat dari Abnormal Portal |
| **Host API regional** | Nama host untuk lingkungan Abnormal Security Anda |

**Cakupan (scope):** Custom Access dengan **Baca** pada `Abuse Campaigns (AI Security Mailbox)` dan `Threats`

**Peran yang diperlukan:** **Security Admin** atau **Super Admin** di Abnormal Security

### Prasyarat

* Anda harus memiliki akses **Security Admin** atau **Super Admin** di Abnormal Security untuk membuat dan mengelola token API.

***

## Bagian A — Di Abnormal Security

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

<Steps>
  <Step title="Buka API Token Management">
    1. Masuk ke portal Abnormal Security Anda.
    2. Pada navigasi sebelah kiri, klik **Pengaturan**, lalu pilih **Integrasi**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/settings-integrations.webp?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=7f5d7a616acdcf72a9048f16c6706b5e" alt="Menu Pengaturan Abnormal Security yang menampilkan opsi Integrasi" width="1999" height="1680" data-path="integrations/images/abnormal-security/settings-integrations.webp" />

    3. Gulir ke bawah hingga bagian **API Token Management** di bagian bawah halaman Integrasi.
    4. Klik **+ Create New Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/api-token-management.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=13cfdfb7ced9b3f3fca67c781ee7e844" alt="Bagian API Token Management dengan tombol Create New Token" width="1239" height="1151" data-path="integrations/images/abnormal-security/api-token-management.avif" />
  </Step>

  <Step title="Pilih jenis integrasi">
    Pilih **REST API** sebagai jenis integrasi, lalu klik **Selanjutnya**.
  </Step>

  <Step title="Pilih cakupan token">
    Pilih cakupan token, lalu klik **Selanjutnya**:

    * **Pelanggan (Semua Tenant Saat Ini dan Mendatang)** — Gunakan opsi ini jika akun Abnormal Anda mengelola beberapa tenant. Token ini secara otomatis mencakup semua tenant saat ini dan mendatang.
    * **Tenant (Satu Tenant)** — Gunakan opsi ini untuk membatasi token pada satu tenant tertentu.

    Bagi sebagian besar organisasi dengan satu tenant Abnormal, kedua opsi dapat digunakan. Jika ragu, pilih **Pelanggan**.
  </Step>

  <Step title="Berikan akses yang diperlukan">
    Pilih **Custom Access** dan aktifkan **Baca** untuk kedua grup endpoint:

    | Grup endpoint | Tingkat akses yang diperlukan |
    | - | - |
    | **Abuse Campaigns (AI Security Mailbox)** | Baca |
    | **Threats** | Baca |

    Lalu klik **Selanjutnya**.

    <Note>
      Akses **Baca** mengembalikan data ancaman dan kampanye yang tidak sensitif. **Read Sensitive** juga mengekspos PII, lampiran, dan data karyawan. **Tulis** mengirimkan Tindakan remediasi. Berikan hanya akses **Baca** kecuali kasus penggunaan Anda secara khusus membutuhkan lebih.
    </Note>
  </Step>

  <Step title="Konfigurasikan detail token dan daftar aman IP">
    Isi kolom berikut:

    * **Token Name** — Nama deskriptif (misalnya, `Living Security Platform`)
    * **Deskripsi** — Konteks opsional (misalnya, `Read access for Living Security HRM platform`)
    * **Token Expiry** — Pilih **90**, **180**, atau **365 hari** sesuai dengan kebijakan rotasi Anda. Atur pengingat kalender untuk merotasi token sebelum kedaluwarsa.
    * **IP Safelist** — Masukkan rentang IP egress Living Security, satu per entri. Klik **Tambahkan** setelah setiap entri.

    <EgressIpSafelist system="Abnormal Security" />

    <Warning>
      **Daftar aman IP (IP safelist) bersifat wajib.** Abnormal Security menolak semua permintaan API dari alamat yang tidak ada dalam daftar aman. Dialog koneksi akan berhasil, tetapi sinkronisasi data akan gagal dengan `401 Unauthorized` hingga IP yang benar dimasukkan ke dalam daftar aman.
    </Warning>

    Lalu klik **Selanjutnya**.
  </Step>

  <Step title="Tinjau dan buat token">
    Tinjau ringkasan konfigurasi token Anda, lalu klik **Create Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/review-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=6935f488f5778fcea3f6907629aa1316" alt="Layar tinjauan konfigurasi token" style={{maxWidth: "550px"}} width="1910" height="726" data-path="integrations/images/abnormal-security/review-token.avif" />
  </Step>

  <Step title="Salin dan simpan token Anda">
    **Segera salin token** dan simpan di lokasi yang aman (misalnya, brankas kata sandi atau pengelola rahasia), lalu klik **Selesai**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/copy-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=fa752c333af664ad5b3ed037dbb67143" alt="Dialog penyalinan token yang menampilkan token yang dihasilkan" style={{maxWidth: "550px"}} width="1999" height="329" data-path="integrations/images/abnormal-security/copy-token.avif" />

    <Warning>
      Abnormal Portal menampilkan nilai token **hanya satu kali**. Jika Anda berpindah halaman tanpa menyalinnya, Anda harus membuat token baru dan mencabut token lama.
    </Warning>
  </Step>

  <Step title="Identifikasi host API regional Anda">
    Tentukan host API yang tepat untuk lingkungan Abnormal Security Anda:

    | Lingkungan | Host API regional |
    | - | - |
    | Default (US commercial) | `api.abnormalplatform.com` |
    | EU | `eu.rest.abnormalsecurity.com` |
    | FedRAMP | `rest.abnormalsecurity.us` |

    Masukkan **host saja** — tanpa awalan `https://` dan tanpa garis miring di akhir.

    Jika Anda tidak yakin lingkungan mana yang digunakan organisasi Anda, periksa URL portal Abnormal Anda atau hubungi tim akun Abnormal Security Anda.
  </Step>
</Steps>

***

## Bagian B — Di Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="Abnormal Security">
    | Kolom | Nilai |
    | - | - |
    | **Kunci API** | Token yang disalin pada Bagian A, Langkah 7 |
    | **Host API regional** | Host dari Bagian A, Langkah 8 (default US: `api.abnormalplatform.com`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/abnormal-security/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=46afa66685c5f59483324c863fd4fa86" alt="Dialog koneksi Living Security untuk Abnormal Security" style={{maxWidth: "450px"}} width="576" height="638" data-path="integrations/images/abnormal-security/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

Sekarang Anda telah terhubung ke Abnormal Security.

***

## Pemecahan masalah

<AccordionGroup>
  <Accordion title="403 Forbidden — You do not have permission to perform this action">
    Token tidak memiliki salah satu atau kedua hak akses yang diperlukan (**Abuse Campaigns** atau **Threats**). Jenis integrasi, cakupan, dan tingkat akses tidak dapat diubah setelah token dibuat — Anda harus membuat token baru dengan pengaturan yang benar dan mencabut token lama.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Token tidak valid/kedaluwarsa, atau IP permintaan tidak ada dalam daftar aman. Periksa:

    1. Token belum dicabut atau kedaluwarsa
    2. Keempat [alamat IP egress Living Security](/id/integrations/managing/egress-ip-addresses) ada dalam daftar aman

    Jika sinkronisasi sebelumnya berhasil tetapi kini gagal dengan `401`, alamat IP egress mungkin telah berubah — periksa [Mengonfigurasi Alamat IP Egress Integrasi](/id/integrations/managing/egress-ip-addresses) dan pastikan daftar aman sesuai.
  </Accordion>

  <Accordion title="Kedaluwarsa token lama (30 April 2027)">
    Jika organisasi Anda memiliki token API yang dibuat sebelum pengalaman Token Management swalayan diperkenalkan, token tersebut muncul sebagai **Legacy** di dasbor. Token lama tetap berfungsi tetapi tidak dapat dirotasi — hanya daftar aman IP-nya yang dapat diperbarui. Semua token lama akan kedaluwarsa secara otomatis pada **30 April 2027**. Rencanakan penggantian token lama dengan token baru sebelum tanggal tersebut.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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