डिफ़ॉल्ट रूप से API key कहीं से भी काम करती है। allow list उसे उन्हीं जगहों से बाँध देती है जहाँ आप असल में कोड चलाते हैं।
यह कैसे काम करती है
API का edge हर अनुरोध के source IP को एक सूची से मिलाता है। अगर पता सूची में है, या किसी दी गई रेंज के अंदर है, तो अनुरोध सामान्य key जाँच तक आगे बढ़ता है। नहीं तो उसे ठुकरा दिया जाता है।
रेंज CIDR notation में लिखी जाती हैं: एक पता, एक स्लैश, और एक prefix length। RFC 4632 समझाता है कि prefix length यह है कि शुरुआत के कितने bit तय हैं। IPv4 के लिए:
| एंट्री | कितने पते |
|---|---|
203.0.113.7 |
एक पता |
198.51.100.0/24 |
256 पते, 198.51.100.0 से 198.51.100.255 तक |
10.0.0.0/16 |
65,536 पते |
IPv6 यही विचार 128-bit पतों के साथ इस्तेमाल करता है, जैसे 2001:db8::/48।
जो पता मायने रखता है वह आपका egress IP है: वह पब्लिक पता जिससे आपके सर्वर का ट्रैफ़िक बाहर निकलता है। NAT, load balancer या कॉर्पोरेट proxy के पीछे यह अक्सर वह पता नहीं होता जो मशीन ख़ुद अपने लिए दिखाती है।
यह क्यों मायने रखती है
API key bearer token हैं: जिसके पास है, वही इस्तेमाल कर सकता है। key कमिट, लॉग, स्क्रीनशॉट और लैपटॉप से लीक होती हैं। allow list के साथ, चोरी हुई key हमलावर के नेटवर्क से फ़ेल हो जाती है, जिससे लीक ख़र्च की घटना बनने के बजाय बेअसर रह जाता है। उदाहरण के लिए, GitHub अपनी allow list वेब साइन-इन के साथ-साथ API कॉल और personal access tokens पर भी लागू करता है।
इसकी क़ीमत कुछ ऑपरेशन्स का काम है। हर नए सर्वर, रीजन या CI runner का egress IP जोड़ना पड़ता है, और dynamic IP के लिए तय egress रास्ता चाहिए।
BroadNet Inference पर
अकाउंट पेज में हर लाइन पर एक IPv4 या IPv6 पता या CIDR रेंज जोड़ें, अधिकतम 32 एंट्री। ख़ाली सूची का मतलब कोई पाबंदी नहीं। नई key अकाउंट की सूची विरासत में लेती हैं। हर key का अपना allowed_ips उस key के लिए इसकी जगह ले लेता है:
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"]}'
दूसरे पतों से आए अनुरोधों को 403 मिलता है। किसी बदलाव या key रद्द करने के बाद, नए अनुरोध पाँच सेकंड के अंदर रुक जाते हैं। पूरे स्टेप API key और IP allow lists में हैं, और एरर की तालिका एरर और रीट्राई में। डेटा सुरक्षा की बड़ी तस्वीर के लिए ZDR चेकलिस्ट देखें।
आम ग़लतियाँ
- पब्लिक egress IP के बजाय सर्वर का प्राइवेट पता, जैसे
10.x.x.x, सूची में डालना। - एरर ग़ायब करने के लिए बहुत चौड़ी रेंज इस्तेमाल करना। एक
/816 मिलियन (1.6 करोड़) से ज़्यादा पते कवर करता है।