---
title: "Apa itu IP allow list untuk kunci API? Contoh CIDR | BroadRouter"
description: "IP allow list hanya menerima request dari alamat atau rentang CIDR yang terdaftar. Cara melindungi kunci API LLM, cara kerja CIDR, dan jebakan IP egress cloud."
url: https://broadrouter.com/id/glossary/ip-allow-list/
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/glossary/ip-allow-list/) (diperbarui 2026-11-14).

# IP allow list (daftar IP yang diizinkan)

Diperbarui 2026-11-14

IP allow list adalah kontrol keamanan yang hanya menerima request dari alamat IP atau rentang CIDR yang terdaftar dan menolak semua yang lain. Pada API, kontrol ini membatasi kerusakan akibat kunci yang bocor, karena kunci tidak berfungsi dari jaringan yang tidak ada di daftar.

Disebut juga: IP allow list, IP whitelist, whitelist IP, daftar IP yang diizinkan, pembatasan IP, IP allowlist, allowed IPs, IP restriction, allowed\_ips

Secara default, kunci API berfungsi dari mana saja. Allow list mengikatnya ke tempat Anda benar-benar menjalankan kode.

## Cara kerjanya

Edge API memeriksa IP sumber setiap request terhadap sebuah daftar. Jika alamatnya ada di daftar, atau berada di dalam rentang yang terdaftar, request lanjut ke pemeriksaan kunci biasa. Jika tidak, request ditolak.

Rentang ditulis dalam notasi CIDR: alamat, garis miring, dan panjang prefix. RFC 4632 menjelaskan bahwa panjang prefix adalah jumlah bit awal yang tetap. Untuk IPv4:

| Entri | Mencakup |
| --- | --- |
| `203.0.113.7` | satu alamat |
| `198.51.100.0/24` | 256 alamat, `198.51.100.0` sampai `198.51.100.255` |
| `10.0.0.0/16` | 65.536 alamat |

IPv6 memakai ide yang sama dengan alamat 128-bit, misalnya `2001:db8::/48`.

Alamat yang penting adalah IP **egress** Anda: alamat publik tempat lalu lintas server Anda keluar. Di belakang NAT, load balancer, atau proxy perusahaan, alamat itu sering bukan alamat yang ditampilkan mesin untuk dirinya sendiri.

## Kenapa ini penting

[Kunci API](https://broadrouter.com/id/glossary/api-key/) adalah bearer token: siapa pun yang memegangnya bisa memakainya. Kunci bocor lewat commit, log, screenshot, dan laptop. Dengan allow list, kunci curian gagal dipakai dari jaringan penyerang, sehingga kebocoran berubah dari insiden pengeluaran menjadi bukan masalah. GitHub, misalnya, menerapkan allow list-nya pada panggilan API dan personal access token, selain pada login web.

Harganya adalah sedikit pekerjaan operasional. Setiap server, region, atau CI runner baru perlu ditambahkan IP egress-nya, dan IP dinamis butuh jalur egress yang tetap.

## Di BroadNet Inference

Di halaman akun, tambahkan satu alamat IPv4 atau IPv6 atau rentang CIDR per baris, hingga 32 entri. Daftar kosong berarti tanpa pembatasan. Kunci baru mewarisi daftar akun. `allowed_ips` per kunci menggantikan daftar itu untuk kunci tersebut:

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

Request dari alamat lain mendapat 403. Setelah perubahan atau pencabutan kunci, request baru berhenti dalam lima detik. Langkah lengkapnya ada di [kunci API dan IP allow list](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/), dan tabel error ada di [error dan retry](https://broadrouter.com/id/guides/errors-and-retries/). Untuk gambaran perlindungan data yang lebih luas, lihat [checklist ZDR](https://broadrouter.com/id/blog/zero-data-retention-llm-api-checklist/).

## Kesalahan umum

-   Mendaftarkan alamat privat server, seperti `10.x.x.x`, alih-alih IP egress publiknya.
-   Memakai rentang yang sangat lebar agar error hilang. Sebuah `/8` mencakup lebih dari 16 juta alamat.

## Pertanyaan umum

### Apakah IP allow list cukup untuk melindungi kunci API?

Tidak. Itu hanya satu lapisan. Tetap simpan kunci di server, jauhkan dari kode dan log, beri setiap aplikasi kuncinya sendiri, dan cabut kunci segera saat bocor.

### Server saya berjalan di infrastruktur serverless atau autoscaling. Bisakah saya memakai allow list?

Hanya jika lalu lintas keluar berangkat dari alamat yang diketahui. Arahkan lewat NAT gateway atau egress proxy dengan IP tetap, lalu daftarkan alamat-alamat itu.

### Error apa yang saya dapat dari IP yang tidak ada di daftar?

Di BroadNet Inference, 403. API lain biasanya juga mengembalikan 403.

## Lihat juga

-   [Kunci API (API key)](https://broadrouter.com/id/glossary/api-key/) (istilah)
-   [Zero data retention (ZDR)](https://broadrouter.com/id/glossary/zero-data-retention/) (istilah)
-   [Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/) (istilah)
-   [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)
-   [API LLM zero data retention: checklist 10 pertanyaan](https://broadrouter.com/id/blog/zero-data-retention-llm-api-checklist/) (artikel)

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-glossary-ip-allow-list&utm_content=page-cta) ·

**Sumber**

-   [RFC 4632: Classless Inter-domain Routing (CIDR)](https://www.rfc-editor.org/rfc/rfc4632)
-   [GitHub Docs, mengelola alamat IP yang diizinkan untuk organisasi](https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)
-   [Referensi API BroadNet Inference, IP allow list (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
