---
title: "Apakah itu senarai IP dibenarkan bagi kunci API? CIDR"
description: "Senarai IP dibenarkan hanya menerima permintaan daripada alamat atau julat CIDR tersenarai. Cara ia melindungi kunci API LLM, cara CIDR berfungsi dan perangkapnya."
url: https://broadrouter.com/ms/glossary/ip-allow-list/
lang: ms
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/glossary/ip-allow-list/) (dikemas kini 2026-11-14).

# Senarai IP dibenarkan (IP allow list)

Dikemas kini 2026-11-14

Senarai IP dibenarkan ialah kawalan keselamatan yang hanya menerima permintaan daripada alamat IP atau julat CIDR yang disenaraikan dan menolak yang lain. Pada API, ia mengehadkan kerosakan akibat kunci yang bocor, kerana kunci itu tidak berfungsi dari rangkaian yang tiada dalam senarai.

Juga dikenali sebagai: IP allow list, IP allowlist, IP whitelist, senarai putih IP, allowed IPs, sekatan IP, allowed\_ips

Secara lalai, kunci API berfungsi dari mana-mana sahaja. Senarai dibenarkan mengikatnya pada tempat anda benar-benar menjalankan kod.

## Cara ia berfungsi

Bahagian edge API menyemak IP sumber setiap permintaan berbanding satu senarai. Jika alamat itu ada dalam senarai, atau dalam julat yang disenaraikan, permintaan diteruskan ke semakan kunci biasa. Jika tidak, ia ditolak.

Julat ditulis dalam tatatanda CIDR: alamat, garis condong, dan panjang awalan. RFC 4632 menerangkan bahawa panjang awalan ialah bilangan bit pendahulu yang tetap. Untuk IPv4:

| Entri | Meliputi |
| --- | --- |
| `203.0.113.7` | satu alamat |
| `198.51.100.0/24` | 256 alamat, `198.51.100.0` hingga `198.51.100.255` |
| `10.0.0.0/16` | 65,536 alamat |

IPv6 menggunakan idea yang sama dengan alamat 128-bit, seperti `2001:db8::/48`.

Alamat yang penting ialah IP **egress** anda: alamat awam tempat trafik pelayan anda keluar. Di belakang NAT, pengimbang beban atau proksi korporat, alamat itu selalunya bukan alamat yang ditunjukkan oleh mesin untuk dirinya sendiri.

## Mengapa ia penting

[Kunci API](https://broadrouter.com/ms/glossary/api-key/) ialah bearer token: sesiapa yang memegangnya boleh menggunakannya. Kunci bocor melalui commit, log, tangkapan skrin dan komputer riba. Dengan senarai dibenarkan, kunci yang dicuri gagal dari rangkaian penyerang, dan kebocoran bertukar daripada insiden perbelanjaan kepada perkara yang tidak memberi kesan. GitHub, sebagai contoh, menggunakan senarai dibenarkannya pada panggilan API dan personal access token serta log masuk web.

Kosnya ialah sedikit kerja operasi. Setiap pelayan, rantau atau CI runner baharu perlu ditambah IP egressnya, dan IP dinamik memerlukan laluan egress yang tetap.

## Di BroadNet Inference

Di halaman akaun, tambah satu alamat IPv4 atau IPv6 atau julat CIDR bagi setiap baris, sehingga 32 entri. Senarai kosong bermakna tiada sekatan. Kunci baharu mewarisi senarai akaun. `allowed_ips` bagi setiap kunci menggantikannya 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"]}'
```

Permintaan dari alamat lain mendapat 403. Selepas perubahan atau pembatalan kunci, permintaan baharu berhenti dalam masa lima saat. Langkah penuh ada dalam [kunci API dan senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/), dan jadual ralat ada dalam [ralat dan cubaan semula](https://broadrouter.com/ms/guides/errors-and-retries/). Untuk gambaran perlindungan data yang lebih luas, lihat [senarai semak ZDR](https://broadrouter.com/ms/blog/zero-data-retention-llm-api-checklist/).

## Kesilapan biasa

-   Menyenaraikan alamat peribadi pelayan, seperti `10.x.x.x`, dan bukan IP egress awamnya.
-   Menggunakan julat yang sangat luas semata-mata untuk menghilangkan ralat. `/8` meliputi lebih 16 juta alamat.

## Soalan lazim

### Adakah senarai IP dibenarkan cukup untuk melindungi kunci API?

Tidak. Ia hanya satu lapisan. Tetap simpan kunci di pelayan, jauh daripada kod dan log, beri setiap aplikasi kuncinya sendiri, dan batalkan kunci dengan segera apabila ia bocor.

### Pelayan saya berjalan pada infrastruktur serverless atau autoscaling. Bolehkah saya guna senarai dibenarkan?

Hanya jika trafik keluar meninggalkan rangkaian dari alamat yang diketahui. Halakan melalui NAT gateway atau proksi egress dengan IP tetap, kemudian senaraikan alamat tersebut.

### Apakah ralat yang saya dapat daripada IP yang tiada dalam senarai?

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

## Lihat juga

-   [Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/) (istilah)
-   [Zero data retention (ZDR, tiada pengekalan data)](https://broadrouter.com/ms/glossary/zero-data-retention/) (istilah)
-   [Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/) (istilah)
-   [Kunci API kepada pelayan anda dengan senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/) (panduan)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/) (panduan)
-   [API LLM dengan pengekalan data sifar: senarai semak 10 soalan](https://broadrouter.com/ms/blog/zero-data-retention-llm-api-checklist/) (artikel)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-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, mengurus alamat IP yang dibenarkan 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)
-   [Rujukan API BroadNet Inference, IP allow-lists (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
