---
title: "Keamanan API key LLM: env var, rotasi, IP allow-list"
description: "Jauhkan kunci API LLM dari kode dan log, beri tiap workload kuncinya sendiri, rotasi terjadwal, kunci ke IP server, dan cabut kunci yang bocor dalam hitungan detik."
url: https://broadrouter.com/id/blog/llm-api-key-security/
lang: id
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/blog/llm-api-key-security/) (diperbarui 2026-11-15).

# Keamanan kunci API LLM: penyimpanan, rotasi, dan IP allow-list

Oleh tim BroadNet Inference · 6 menit baca · Dipublikasikan 2026-11-14 · Diperbarui 2026-11-15

Simpan kunci API LLM di secret manager, jangan pernah di kode atau browser. Beri tiap aplikasi atau agen kuncinya sendiri, rotasi secara terjadwal, dan kunci ke server Anda dengan IP allow-list. Menurut BroadNet Inference, allow-list-nya menampung 32 entri, pencabutan menghentikan permintaan baru dalam lima detik, dan kunci berlaku satu tahun.

## Poin penting

-   Jangan pernah memasang kunci di browser atau aplikasi mobile; panggil LLM dari server Anda.
-   Satu kunci per workload: hingga 10 kunci aktif per akun BroadNet memudahkan Anda mengisolasi kebocoran.
-   IP allow-list membuat kunci yang dicuri tidak bisa dipakai di tempat lain. BroadNet menerima hingga 32 entri IPv4, IPv6, atau CIDR.
-   Pencabutan dan perubahan allow-list berlaku dalam lima detik di BroadNet Inference.
-   Kunci kedaluwarsa satu tahun setelah dibuat, jadi rotasi harus menjadi rutinitas, bukan keadaan darurat.

**Di halaman ini**

1.  Di mana sebaiknya kunci API LLM disimpan?
2.  Bolehkah kunci API dipasang di browser atau aplikasi mobile?
3.  Mengapa tiap workload perlu kunci sendiri?
4.  Bagaimana IP allow-list melindungi kunci?
5.  Mengapa kunci inferensi harus dipisahkan dari kredensial admin?
6.  Seberapa sering kunci API perlu dirotasi?
7.  Apa yang harus dilakukan saat kunci bocor?
8.  Bagaimana kunci bisa bocor lewat log?
9.  Bagaimana membatasi kerusakan dari kebocoran yang belum Anda temukan?
10.  Kontrol kunci apa saja yang disediakan BroadNet Inference?

Untuk mengamankan kunci API LLM, simpan di secret manager dan panggil model hanya dari server Anda, jangan pernah dari browser atau aplikasi. Beri tiap workload kuncinya sendiri, rotasi kunci secara terjadwal, kunci ke IP server Anda dengan allow-list, dan cabut kunci yang bocor lebih dulu, baru selidiki kemudian.

Artikel ini membahas kebiasaan yang menjaga kunci tetap aman, beserta kontrol spesifik yang disediakan BroadNet Inference. Untuk langkah klik demi klik di portal, lihat [panduan kunci API dan IP allow-list](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/); untuk anggaran dan perlindungan dari loop yang lepas kendali, lihat [kontrol pengeluaran API LLM](https://broadrouter.com/id/blog/llm-api-spend-control/).

## Di mana sebaiknya kunci API LLM disimpan?

Simpan kunci di secret manager atau fitur secret terenkripsi platform Anda, jangan pernah di kode. [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) membahas pilihannya secara mendalam. Perhatikan peringatannya: environment variable “are generally accessible to all processes and may be included in logs or system dumps” (Terjemahan BroadRouter: “umumnya dapat diakses oleh semua proses dan bisa ikut tercatat di log atau dump sistem”), sehingga OWASP lebih menyukai file secret yang di-mount atau mengambil secret dari secret store bila Anda punya pilihan. Environment variable yang diisi dari secret manager saat start-up adalah jalan tengah yang umum.

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],  # fails loudly if missing
)
```

Gunakan `os.environ[...]`, bukan `os.getenv(...)` dengan nilai cadangan yang di-hard-code; nilai cadangan seperti itulah yang membuat kunci berakhir di Git. Untuk pengembangan lokal, file `.env` tidak masalah asalkan sudah ada di `.gitignore` sejak commit pertama. Aktifkan secret scanning dan push protection di host Git Anda. Di GitHub, [push protection](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection) memblokir push yang berisi format secret yang dikenal sebelum sampai ke repositori; push protection untuk pengguna aktif secara default, tetapi push protection tingkat repositori nonaktif secara default dan harus diaktifkan oleh administrator repositori atau pemilik organisasi.

## Bolehkah kunci API dipasang di browser atau aplikasi mobile?

Tidak. Apa pun yang dikirim ke klien bisa diekstrak. Kode front-end dan bundle aplikasi bersifat publik, seberapa pun di-minify atau di-obfuscate. Panggil LLM dari server Anda, autentikasi pengguna Anda di sana, dan terapkan batas per pengguna Anda sendiri sebelum meneruskan permintaan.

Hal yang sama berlaku untuk alat desktop yang Anda berikan kepada orang lain. Jika rekan tim butuh akses ke agen coding, beri mereka kunci sendiri di akun mereka sendiri alih-alih berbagi satu kunci.

## Mengapa tiap workload perlu kunci sendiri?

Di BroadNet Inference, satu akun bisa memiliki **hingga sepuluh kunci aktif**. Manfaatkan:

| Label kunci | Dipakai oleh |
| --- | --- |
| `prod-api` | Backend produksi |
| `prod-worker` | Job batch |
| `staging` | Lingkungan staging |
| `agent-ci` | Agen coding di CI |
| `dev-laptop-<name>` | Pengembangan lokal |

Saat satu kunci bocor, Anda hanya mencabut kunci itu, dan yang lain tetap berjalan. Label juga membuat pemakaian mudah dibaca: Anda bisa melihat workload mana yang menghabiskan berapa. Namai kunci sesuai pemakainya, bukan sesuai siapa yang membuatnya.

## Bagaimana IP allow-list melindungi kunci?

[IP allow-list](https://broadrouter.com/id/glossary/ip-allow-list/) berarti kunci yang dicuri gagal di mana pun selain di infrastruktur Anda sendiri. Di BroadNet Inference:

-   Allow-list akun menampung **hingga 32 entri**, satu alamat IPv4 atau IPv6 atau rentang CIDR per baris.
-   Daftar kosong berarti tanpa pembatasan.
-   Kunci baru mewarisi daftar akun, kecuali Anda membuat kunci dengan `allowed_ips` sendiri, yang menggantikan daftar warisan untuk kunci tersebut.
-   Permintaan dari alamat di luar daftar ditolak dengan 403 (“refused by model, route or IP policy”; Terjemahan BroadRouter: “ditolak oleh kebijakan model, rute, atau IP”).

Buat kunci dengan daftarnya sendiri melalui API portal:

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"prod-worker","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

Respons berisi kunci mentah satu kali saja. Segera simpan di secret manager Anda; kunci itu tidak bisa dibaca ulang. Langkah lengkapnya ada di [panduan IP allow-list](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/).

Allow-list cocok untuk server dengan IP egress yang tetap: VPS, NAT gateway, IP kantor yang tetap. Untuk laptop yang berpindah-pindah jaringan, gunakan kunci terpisah tanpa daftar dan jaga agar saldo yang terekspos lewat kunci itu tetap kecil.

## Mengapa kunci inferensi harus dipisahkan dari kredensial admin?

BroadNet memakai dua jenis kredensial:

| Kredensial | Bisa melakukan | Simpan di |
| --- | --- | --- |
| Kunci inferensi | Permintaan model ke `/v1/*` | Di mana pun aplikasi berjalan |
| Kredensial portal | Membuat dan mencabut kunci, mengubah IP yang diizinkan, melakukan pembelian | Hanya di tooling otomasi atau admin Anda |

Dokumentasinya meminta Anda memperlakukan setiap kredensial portal sebagai otoritas penuh atas akun. Jangan pernah men-deploy kredensial portal di samping aplikasi Anda. Jika server aplikasi Anda dibobol, penyerang seharusnya hanya mendapat satu kunci inferensi, bukan kendali atas akun.

## Seberapa sering kunci API perlu dirotasi?

OWASP menyarankan rotasi rutin “so that any stolen credentials will only work for a short time.” (Terjemahan BroadRouter: “agar kredensial yang dicuri hanya berfungsi untuk waktu yang singkat.”) Kunci BroadNet berlaku **satu tahun** sejak dibuat, jadi setiap kunci memang harus diganti suatu saat. Jadikan rotasi sebagai rutinitas:

1.  Buat kunci baru dengan pola label dan allow-list yang sama.
2.  Deploy berdampingan dengan kunci lama, atau ganti secret-nya lalu restart.
3.  Pantau trafik berpindah ke kunci baru.
4.  Cabut kunci lama dengan `DELETE /portal/keys/{alias}`.

Karena satu akun bisa memiliki hingga sepuluh kunci aktif, Anda bisa menjalankan kunci lama dan baru bersamaan selama beberapa menit tanpa downtime. Rotasi lebih cepat untuk kunci yang pernah diakses anggota tim yang keluar.

## Apa yang harus dilakukan saat kunci bocor?

Saat kunci bocor, cabut dulu, baru selidiki. Di BroadNet Inference, permintaan baru berhenti **dalam lima detik** setelah pencabutan atau perubahan allow-list; dokumentasinya menjelaskan bahwa keputusan otorisasi bisa tetap berada di cache yang direplikasi selama interval terbatas itu.

Setelah mencabut:

-   periksa pemakaian kunci di halaman akun atau `GET /portal/usage`;
-   cari tahu bagaimana kunci itu bocor (riwayat commit, log CI, tangkapan layar yang dibagikan);
-   rotasi secret lain yang disimpan di tempat yang sama.

Kunci yang dicabut atau diblokir mengembalikan 401 atau 403; lihat [panduan error](https://broadrouter.com/id/guides/errors-and-retries/) agar monitoring Anda tidak menganggapnya sebagai error sementara.

## Bagaimana kunci bisa bocor lewat log?

Log adalah sumber kebocoran yang mudah terlewat. Samarkan header `Authorization` di logging debug HTTP, error reporter, dan access log proxy. Saat menghubungi dukungan, kirim `X-Request-ID`, timestamp, rute, status, dan **alias** kunci, jangan pernah kuncinya sendiri. Dokumentasi BroadNet menyebutkan portal hanya menyimpan hash setiap kunci, jadi portal juga tidak bisa menampilkan kunci yang hilang.

## Bagaimana membatasi kerusakan dari kebocoran yang belum Anda temukan?

Meski sudah menerapkan semua kebiasaan di atas, anggap saja suatu hari kunci bisa bocor. Perkecil radius dampaknya:

-   Jaga saldo bayar sesuai pemakaian di level yang masih rela Anda kehilangan, dan top up sesuai kebutuhan.
-   Gunakan paket harga tetap untuk agen yang berat: sesi paket punya harga tetap, jadi kunci paket yang dicuri tidak bisa menumpuk tagihan per token. Lihat [apa arti unlimited sebenarnya](https://broadrouter.com/id/blog/what-unlimited-llm-api-really-means/).
-   Pasang peringatan untuk pengeluaran atau laju permintaan yang tidak biasa per kunci; [kalkulator biaya API LLM](https://broadrouter.com/tools/llm-api-cost-calculator/) memberi angka bulanan normal sebagai acuan peringatan. Artikel kami tentang [kontrol pengeluaran API LLM](https://broadrouter.com/id/blog/llm-api-spend-control/) membahas anggaran dan peringatan.

## Kontrol kunci apa saja yang disediakan BroadNet Inference?

| Kontrol | BroadNet Inference |
| --- | --- |
| Kunci ditampilkan sekali, disimpan sebagai hash | Ya |
| Kunci aktif per akun | Hingga 10 |
| Masa berlaku kunci | Satu tahun |
| IP allow-list | Hingga 32 entri IPv4, IPv6, atau CIDR |
| Allow-list per kunci | Ya, `allowed_ips` saat pembuatan |
| Pencabutan berlaku | Dalam lima detik |
| Kredensial admin terpisah | Kredensial portal |

Kunci melindungi akun Anda; [zero data retention](https://broadrouter.com/id/privacy/) melindungi apa yang Anda kirim melaluinya. Baca keduanya sebelum rilis.

Alat gratis untuk topik ini (bahasa Inggris)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Alat gratis (bahasa Inggris)](https://broadrouter.com/tools/)

## Istilah dalam artikel ini

[Kunci API (API key)](https://broadrouter.com/id/glossary/api-key/)

Kunci API adalah string rahasia yang mengidentifikasi dan mengotorisasi client yang memanggil API. API LLM biasanya mengharapkannya di header Authorization: Bearer, dan siapa pun yang memegang kunci itu bisa membuat permintaan yang ditagihkan ke akun pemiliknya.

[Agen coding AI (AI coding agent)](https://broadrouter.com/id/glossary/coding-agent/)

Agen coding AI adalah alat perangkat lunak di mana model bahasa bekerja pada codebase dalam sebuah loop: membaca file, mengeditnya, menjalankan perintah seperti tes, membaca output, dan memutuskan langkah berikutnya sampai tugas selesai atau batas tercapai.

[Zero data retention (ZDR)](https://broadrouter.com/id/glossary/zero-data-retention/)

Zero data retention (ZDR) adalah kebijakan penanganan data di mana penyedia AI memproses prompt dan output hanya untuk melayani permintaan dan tidak menyimpan konten itu sesudahnya, baik di log, cache, maupun data pelatihan. Catatan tanpa konten seperti jumlah token dan durasi biasanya tetap disimpan.

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

[Kredit prabayar (prepaid credit)](https://broadrouter.com/id/glossary/prepaid-credit/)

Kredit prabayar adalah uang yang diisi ke akun API sebelum dipakai. Setiap request memotong biayanya dari saldo, dan saat saldo habis, request berbayar per pemakaian berhenti sampai Anda melakukan top up. Dengan begitu, pengeluaran dibatasi sebesar uang yang sudah Anda setor.

[Paket LLM harga tetap (flat-rate)](https://broadrouter.com/id/glossary/flat-rate-llm-plan/)

Paket LLM harga tetap menagih harga tetap untuk satu periode, misalnya sebulan, untuk akses ke API model bahasa, alih-alih menagih per token. Paket seperti ini biasanya membatasi hal lain, seperti konkurensi, kecepatan, model, atau jendela pemakaian, jadi batasnya sama pentingnya dengan harganya.

[Timestamp (speech-to-text)](https://broadrouter.com/id/glossary/timestamps-asr/)

Timestamp dalam speech-to-text adalah waktu mulai dan selesai, dalam detik, yang dilekatkan pada bagian-bagian transkrip. Timestamp segmen mencakup satu frasa atau kalimat; timestamp kata mencakup setiap kata. Timestamp dibutuhkan untuk subtitle, pencarian di dalam rekaman, dan menyelaraskan teks dengan pembicara.

[Token](https://broadrouter.com/id/glossary/token/)

Token adalah satuan teks yang dibaca dan ditulis model bahasa: sebuah kata, bagian kata, tanda baca, atau urutan byte yang dihasilkan tokenizer model. API LLM menghitung, membatasi, dan biasanya menagih pemakaian dalam token.

## Pertanyaan umum

### Di mana sebaiknya saya menyimpan kunci API LLM?

Di secret manager atau fitur secret terenkripsi platform Anda, lalu disuntikkan ke proses sebagai environment variable seperti BROADNET\_API\_KEY. Bukan di kode sumber, bukan di file .env yang ikut di-commit, dan jangan pernah di kode front-end.

### Seberapa cepat saya bisa mencabut kunci BroadNet Inference?

Dokumentasi BroadNet menyebutkan permintaan baru berhenti dalam lima detik setelah pencabutan atau perubahan allow-list, karena keputusan otorisasi bisa tetap tersimpan di cache yang direplikasi selama interval terbatas itu.

### Berapa lama kunci BroadNet Inference berlaku?

Kunci bayar sesuai pemakaian berlaku satu tahun sejak dibuat. Satu akun bisa memiliki hingga sepuluh kunci aktif, jadi Anda bisa membuat penggantinya sebelum kunci lama kedaluwarsa.

### Bisakah BroadNet menampilkan kunci saya lagi jika hilang?

Tidak. Dokumentasi BroadNet menyebutkan kunci mentah hanya dikembalikan sekali dan portal hanya menyimpan hash-nya. Buat kunci baru dan cabut kunci lama.

### Apa yang harus saya lakukan jika kunci API kompatibel OpenAI saya bocor?

Cabut dulu, baru selidiki. Periksa pemakaian kunci untuk trafik yang tidak dikenal, cari dari mana bocornya (riwayat commit, log CI, tangkapan layar), rotasi secret lain yang disimpan di tempat yang sama, dan terbitkan kunci pengganti dengan IP allow-list.

## Baca juga

-   [Kontrol biaya API LLM: anggaran, batas kunci, dan proteksi loop](https://broadrouter.com/id/blog/llm-api-spend-control/)
-   [Mengirim data sensitif ke API LLM: redaksi, minimalkan, kurangi log](https://broadrouter.com/id/blog/llm-api-sensitive-data/)
-   [Cara mengatasi error 429 API LLM: backoff, jitter, dan limiter](https://broadrouter.com/id/blog/handle-llm-api-429-rate-limits/)
-   [GDPR dan API LLM: 15 pertanyaan untuk penyedia Anda](https://broadrouter.com/id/blog/gdpr-llm-api-checklist/)
-   [Hardware GPU dan pendekatan serving BroadNet, menurut BroadNet](https://broadrouter.com/id/blog/broadnet-gpu-fleet-and-serving/)
-   [Cache respons API LLM untuk memangkas biaya: exact cache di Python](https://broadrouter.com/id/blog/cache-llm-responses-cut-cost/)
-   [Panduan: Batasi kunci API ke server Anda dengan IP allow-list](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/)
-   [Panduan: Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)
-   [Panduan: Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/)

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

[Mulai](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-blog-llm-api-key-security&utm_content=page-cta) ·

**Sumber**

-   [Referensi API BroadNet Inference, batas: masa berlaku kunci, kunci aktif (diakses 2026-11-14) (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-blog-llm-api-key-security&utm_content=sources#limits)
-   [Referensi API BroadNet Inference, IP allow-list dan kunci portal (diakses 2026-11-14) (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-blog-llm-api-key-security&utm_content=sources#ip-allow-lists)
-   [OWASP Secrets Management Cheat Sheet (diakses 2026-11-14)](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [GitHub Docs, secret scanning (diakses 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning)
-   [GitHub Docs, tentang push protection (diakses 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection)
