BroadRouter
Mulai

IP allow list (daftar IP yang diizinkan)

Diperbarui

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 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:

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, dan tabel error ada di error dan retry. Untuk gambaran perlindungan data yang lebih luas, lihat checklist ZDR.

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.

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity