Gumagana ang API key kahit saan bilang default. Itinatali ito ng allow list sa mga lugar kung saan mo talaga pinapatakbo ang code.
Paano ito gumagana
Sinusuri ng edge ng API ang source IP ng bawat request laban sa isang listahan. Kung nasa listahan ang address, o nasa loob ng isang nakalistang range, tutuloy ang request sa normal na pag-check ng key. Kung hindi, tatanggihan ito.
Isinusulat ang mga range sa CIDR notation: isang address, slash, at prefix length. Ipinapaliwanag ng RFC 4632 na ang prefix length ay kung ilang nangungunang bit ang fixed. Para sa IPv4:
| Entry | Sakop |
|---|---|
203.0.113.7 |
isang address |
198.51.100.0/24 |
256 na address, 198.51.100.0 hanggang 198.51.100.255 |
10.0.0.0/16 |
65,536 na address |
Ganito rin ang ideya sa IPv6, gamit ang 128-bit na address, gaya ng 2001:db8::/48.
Ang mahalagang address ay ang egress IP mo: ang public address na nilalabasan ng traffic ng server mo. Kapag nasa likod ng NAT, load balancer o corporate proxy, kadalasan ay hindi ito ang address na ipinapakita ng makina para sa sarili nito.
Bakit ito mahalaga
Bearer token ang mga API key: kung sino ang may hawak, siya ang makakagamit. Nale-leak ang mga key sa commits, logs, screenshot at laptop. Kapag may allow list, pumapalya ang nanakaw na key mula sa network ng attacker, kaya mula sa insidente ng gastos ay nagiging wala na lang ang leak. Halimbawa, ina-apply ng GitHub ang allow list nito sa mga API call at personal access token, pati sa mga web sign-in.
Ang kapalit ay dagdag na trabaho sa operations. Kailangang idagdag ang egress IP ng bawat bagong server, region o CI runner, at kailangan ng fixed na egress path ang mga dynamic IP.
Sa BroadNet Inference
Sa account page, magdagdag ng isang IPv4 o IPv6 address o CIDR range kada linya, hanggang 32 entry. Kapag walang laman ang listahan, walang restriction. Minamana ng mga bagong key ang listahan ng account. Pinapalitan ito ng per-key na allowed_ips para sa key na iyon:
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"]}'
Makakatanggap ng 403 ang mga request mula sa ibang address. Pagkatapos ng pagbabago o pag-revoke ng key, humihinto ang mga bagong request sa loob ng limang segundo. Nasa API keys at IP allow lists ang buong hakbang, at nasa errors at retries ang error table. Para sa mas malawak na larawan ng data protection, tingnan ang ZDR checklist.
Mga karaniwang pagkakamali
- Paglista sa private address ng server, gaya ng
10.x.x.x, sa halip na sa public egress IP nito. - Paggamit ng napakalawak na range para lang mawala ang mga error. Mahigit 16 milyong address ang sakop ng
/8.