BroadRouter
शुरू करें

IP allow list (IP अनुमति सूची)

अपडेट किया गया

IP allow list एक सुरक्षा नियंत्रण है जो सिर्फ़ सूची में दिए IP पतों या CIDR रेंज से आए अनुरोध स्वीकार करता है और बाक़ी सबको ठुकरा देता है। किसी API पर यह लीक हुई key से होने वाला नुक़सान सीमित करता है, क्योंकि सूची से बाहर के नेटवर्क से key काम नहीं करती।

अन्य नाम: IP अनुमति सूची, IP व्हाइटलिस्ट, अनुमत IP, ip whitelist kya hai, ip allow list kya hai, IP allow list, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed_ips

डिफ़ॉल्ट रूप से 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, सूची में डालना।
  • एरर ग़ायब करने के लिए बहुत चौड़ी रेंज इस्तेमाल करना। एक /8 16 मिलियन (1.6 करोड़) से ज़्यादा पते कवर करता है।

अक्सर पूछे जाने वाले सवाल

क्या API key बचाने के लिए IP allow list काफ़ी है?

नहीं। यह एक परत है। फिर भी key सर्वर पर रखें, कोड और लॉग से बाहर, हर ऐप को अपनी key दें, और लीक होने पर key तुरंत रद्द करें।

मेरे सर्वर serverless या autoscaling इन्फ़्रास्ट्रक्चर पर चलते हैं। क्या मैं allow list इस्तेमाल कर सकता हूँ?

सिर्फ़ तभी, जब बाहर जाने वाला ट्रैफ़िक जाने-पहचाने पतों से निकले। उसे तय IP वाले NAT gateway या egress proxy से भेजें, फिर उन्हीं IP को सूची में डालें।

सूची से बाहर के IP से मुझे कौन-सा एरर मिलेगा?

BroadNet Inference पर 403। दूसरे API भी आम तौर पर 403 ही लौटाते हैं।

Markdown में पढ़ेंChatGPT से पूछेंClaude से पूछेंPerplexity से पूछें