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
/8mencakup lebih dari 16 juta alamat.