ڈیفالٹ طور پر API کلید کہیں سے بھی کام کرتی ہے۔ allow list اسے انہی جگہوں سے باندھ دیتی ہے جہاں آپ واقعی کوڈ چلاتے ہیں۔
یہ کیسے کام کرتی ہے
API کا edge ہر درخواست کے source IP کو ایک فہرست سے ملاتا ہے۔ اگر پتہ فہرست میں ہو، یا کسی درج رینج کے اندر ہو، تو درخواست عام کلید کی جانچ تک آگے بڑھتی ہے۔ ورنہ اسے رد کر دیا جاتا ہے۔
رینجز CIDR notation میں لکھی جاتی ہیں: ایک پتہ، ایک سلیش، اور ایک prefix length۔ RFC 4632 وضاحت کرتا ہے کہ prefix length یہ ہے کہ شروع کے کتنے bits مقرر ہیں۔ 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 کلیدیں bearer tokens ہیں: جس کے پاس ہو، وہی استعمال کر سکتا ہے۔ کلیدیں commits، لاگز، اسکرین شاٹس اور لیپ ٹاپس سے لیک ہوتی ہیں۔ allow list کے ساتھ، چوری شدہ کلید حملہ آور کے نیٹ ورک سے ناکام ہو جاتی ہے، جس سے لیک خرچ کا واقعہ بننے کے بجائے بے اثر رہ جاتا ہے۔ مثال کے طور پر، GitHub اپنی allow list ویب سائن اِن کے ساتھ ساتھ API کالز اور personal access tokens پر بھی لاگو کرتا ہے۔
اس کی قیمت کچھ آپریشنز کا کام ہے۔ ہر نئے سرور، ریجن یا CI runner کا egress IP شامل کرنا پڑتا ہے، اور dynamic IPs کے لیے مقررہ egress راستہ چاہیے۔
BroadNet Inference پر
اکاؤنٹ پیج میں ہر لائن پر ایک IPv4 یا IPv6 پتہ یا CIDR رینج شامل کریں، زیادہ سے زیادہ 32 اندراجات۔ خالی فہرست کا مطلب کوئی پابندی نہیں۔ نئی کلیدیں اکاؤنٹ کی فہرست وراثت میں لیتی ہیں۔ ہر کلید کا اپنا allowed_ips اس کلید کے لیے اس کی جگہ لے لیتا ہے:
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 ملتا ہے۔ کسی تبدیلی یا کلید کی منسوخی کے بعد، نئی درخواستیں پانچ سیکنڈ کے اندر رک جاتی ہیں۔ مکمل مراحل API کلیدیں اور IP allow lists میں ہیں، اور ایرر کا جدول ایررز اور دوبارہ کوشش میں۔ ڈیٹا کے تحفظ کی وسیع تصویر کے لیے ZDR چیک لسٹ دیکھیں۔
عام غلطیاں
- پبلک egress IP کے بجائے سرور کا پرائیویٹ پتہ، جیسے
10.x.x.x، فہرست میں ڈالنا۔ - ایررز غائب کرنے کے لیے بہت چوڑی رینج استعمال کرنا۔ ایک
/8ایک کروڑ 60 لاکھ (16 million) سے زیادہ پتوں کا احاطہ کرتا ہے۔