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

# Autentikasi

> Pilih Kunci API atau kredensial klien OAuth untuk integrasi Anda, dan pahami bagaimana masing-masing menggunakan akun layanan.

**Anda tidak memerlukan OAuth untuk menggunakan Public API.** Untuk integrasi privat di sisi server, mulailah dengan Kunci API yang dibatasi cakupannya dan ikuti
[panduan memulai](/id/developers/v1/quickstart). Pilih kredensial klien OAuth jika
kebijakan keamanan Anda mewajibkan token akses berumur pendek atau platform integrasi Anda sudah mendukung alur tersebut.

Kedua opsi menggunakan akun layanan. Akun layanan adalah identitas integrasi,
bukan metode autentikasi ketiga.

## Bagaimana setiap komponen saling terkait

| Item | Tujuan | Yang dikirim oleh integrasi Anda |
| - | - | - |
| **Akun layanan** | Memberi nama pada beban kerja dan menentukan batas maksimum izinnya. | ID-nya mengidentifikasi akun; ID tersebut tidak mengautentikasi permintaan. |
| **Kunci API** | Mengautentikasi secara langsung sebagai akun layanan tersebut, dengan kumpulan izin dan masa berlaku yang dipilih. | Secret kunci menggunakan autentikasi HTTP Basic atau `Authorization: Bearer <api_key_secret>`. |
| **Klien OAuth** | Mengautentikasi ke layanan token untuk memperoleh token akses dengan cakupan terbatas bagi akun layanan tersebut. | Token akses menggunakan `Authorization: Bearer <access_token>`. |

Buat satu [akun layanan](/id/developers/developer-hub/service-accounts) untuk setiap
integrasi. Pilih Kunci API atau klien OAuth untuk akun tersebut; Anda tidak
memerlukan kedua metode pada setiap permintaan API. Kedua kredensial tidak dapat melampaui
izin akun saat ini.

Panduan memulai menggunakan autentikasi Basic. Header Bearer juga didukung untuk
Kunci API; penggunaan header tersebut tidak berarti Anda memerlukan klien OAuth.

## Pilih Kunci API untuk integrasi yang sederhana

Gunakan Kunci API untuk tugas terjadwal, skrip pelaporan, pipeline data, atau layanan backend lainnya milik Anda, jika secret yang disimpan di secret manager Anda sesuai dengan
persyaratan keamanan Anda.

* Kirim permintaan terautentikasi secara langsung; tidak diperlukan pertukaran token.
* Pilih hanya izin yang dibutuhkan oleh beban kerja dan tetapkan masa berlaku.
* Rotasikan kunci menggunakan periode tumpang tindihnya, atau cabut segera jika terekspos.

Integrasi dengan Kunci API tidak memerlukan klien OAuth. Mulailah dengan
[panduan memulai](/id/developers/v1/quickstart), lalu lihat
[Kunci API](/id/developers/developer-hub/api-keys) untuk pembuatan dan rotasi.

## Pilih OAuth untuk token akses berumur pendek

Gunakan kredensial klien OAuth untuk layanan backend confidential jika organisasi Anda mewajibkan token akses yang kedaluwarsa atau alat integrasi mengharapkan
grant `client_credentials`.

1. Buat klien OAuth dengan cakupan terbatas untuk akun layanan.
2. Autentikasi klien ke endpoint token regional Anda menggunakan metode autentikasi klien yang diberikan selama penyiapan.
3. Kirim token akses yang dihasilkan bersama permintaan API Anda. Dapatkan token baru
   sebelum token saat ini kedaluwarsa.

OAuth menambahkan perolehan token dan penanganan kedaluwarsa ke integrasi Anda. Secret klien tetap memerlukan penyimpanan dan rotasi yang aman; token berumur pendek
tidak menghilangkan tanggung jawab tersebut. Kredensial klien tidak menggunakan refresh
token: autentikasi klien kembali untuk memperoleh token akses baru.

Akses OAuth harus diaktifkan untuk organisasi Anda. Jika belum diaktifkan,
gunakan Kunci API atau hubungi Dukungan Living Security mengenai kebutuhan Anda.
Lihat [Kredensial klien OAuth](/id/developers/v1/oauth) untuk pembuatan klien,
secret sekali tampil, pencabutan, dan pemulihan.

## Simpan kredensial di backend Anda

Kunci API akun layanan dan secret klien OAuth harus disimpan di penyimpanan secret
sisi server. Jangan menempatkannya di kode browser, aplikasi seluler, kontrol sumber,
atau log. Kredensial akun layanan bertindak sebagai beban kerja; kredensial tersebut tidak
memasukkan seseorang ke dalam sesi masuk dan tidak menyediakan alur persetujuan pelanggan.

Gunakan [host API regional](/id/developers/v1/regions) untuk organisasi Anda dengan
kedua metode. Mengganti metode autentikasi tidak mengubah URL sumber daya, versi API,
atau izin yang diperlukan oleh suatu operasi.


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