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

> Hubungkan CultureAI ke Living Security Platform untuk mengimpor data perilaku keamanan dan pelaporan.

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

## Kontribusi integrasi ini

CultureAI dapat menyumbangkan aktivitas phishing, pelatihan, pelaporan karyawan, dan perlindungan data. Contoh yang telah ditinjau meliputi:

* `phishing.real.clicked` — mengeklik tautan dalam email phishing yang sebenarnya
* `data.transfer.blocked` — transfer data diblokir
* `phishing.safe.reported` — melaporkan email yang kemudian dinilai aman

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 yang dibuat dari konsol admin CultureAI Anda. Living Security mengirimkan kunci ini pada setiap permintaan untuk melakukan autentikasi ke API CultureAI. Ini adalah satu-satunya kredensial yang diperlukan. |

**Cakupan (scope):** Kunci API CultureAI tidak dibatasi oleh cakupan — kunci yang valid memberikan akses API. Living Security hanya membaca data pelaporan; jika konsol CultureAI Anda menyediakan pilihan cakupan atau izin saat membuat kunci, berikan akses pelaporan hanya-baca.

**Peran yang diperlukan:** **Admin** atau **Pemilik** di CultureAI (untuk mengelola akses API)

### Prasyarat

* Anda harus masuk ke konsol admin CultureAI dengan peran yang dapat mengelola akses API — biasanya peran **Admin** atau **Pemilik**. Jika Anda tidak melihat area pengaturan API atau pengembang, hubungi perwakilan akun CultureAI Anda agar akses API diaktifkan untuk organisasi Anda.

***

## Bagian A — Di CultureAI

*Administrator CultureAI Anda menyelesaikan langkah-langkah ini.*

<Steps>
  <Step title="Buat kunci API">
    1. Masuk ke konsol admin CultureAI Anda.
    2. Buka pengaturan organisasi atau akun Anda dan temukan area **API** (atau **API keys** / **Developer**).
    3. Buat kunci API baru dan beri nama yang deskriptif (mis., `Living Security Platform`).

    <Note>
      Living Security menggunakan kunci ini untuk akses hanya-baca ke data pelaporan yang diserap dari CultureAI. Akses tulis tidak diperlukan. Jika CultureAI meminta Anda memilih cakupan atau izin, berikan hanya akses baca ke data pelaporan.
    </Note>

    <Warning>
      CultureAI mungkin menampilkan nilai kunci API **hanya satu kali** saat kunci dibuat. Salin segera dan simpan di lokasi yang aman (mis., brankas kata sandi atau pengelola rahasia). Jika Anda meninggalkan halaman tanpa menyalinnya, Anda perlu membuat kunci baru.
    </Warning>

    <Note>
      Jika Anda tidak dapat menemukan tempat untuk membuat kunci API, atau tidak yakin izin mana yang harus diberikan, hubungi perwakilan akun CultureAI Anda. Living Security tidak dapat membuat kredensial CultureAI atas nama Anda.
    </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="CultureAI">
    | Bidang | Nilai |
    | - | - |
    | **Kunci API** | Kunci API dari Bagian A |
  </ConnectInPlatform>
</Steps>

Anda kini telah terhubung ke CultureAI.

***

## Pemecahan masalah

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Kunci API tidak valid atau telah dicabut. Pastikan kunci tersebut benar dan belum dibuat ulang di CultureAI.
  </Accordion>

  <Accordion title="403 Forbidden">
    Kunci API tidak memiliki akses baca ke data pelaporan. Di CultureAI, pastikan kunci telah diberi akses baca, atau buat kunci baru dengan izin yang benar.
  </Accordion>

  <Accordion title="Hasil kosong (200 OK tetapi tidak ada data)">
    Kunci API mungkin tidak memiliki akses ke data pelaporan yang diserap oleh Living Security. Konfirmasikan kepada perwakilan akun CultureAI Anda bahwa kunci tersebut memiliki akses baca ke data pelaporan.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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