ٹریول API کی تصدیق اور سیکیورٹی: لیک کہاں ہوتے ہیں

آپ کی پارٹنر ایجنسیوں میں سے ایک کا ڈیولپر منگل کی دوپہر اپنی انٹیگریشن ٹیسٹ کر رہا ہے۔ وہ دیکھتا ہے کہ بکنگ لسٹ والا endpoint کوئری اسٹرنگ میں agencyId لیتا ہے، اور تجسس میں اسے 114 سے بدل کر 115 کر دیتا ہے۔ جواب کسی اور کی بکنگز کے ساتھ واپس آتا ہے: مسافروں کے نام، PNR اور وہ نیٹ کرایہ جو اس ایجنسی نے اپنا مارک اپ لگانے سے پہلے ادا کیا تھا۔ کسی نے کسی چیز پر حملہ نہیں کیا۔ API نے بس وہ مان لیا جو کلائنٹ نے اسے بتایا۔ وہ ایک دوپہر اس بات کا بڑا حصہ ہے جس کے بارے میں ٹریول API کی تصدیق اور سیکیورٹی دراصل ہے، اور اسی لیے یہ موضوع اس توجہ سے زیادہ کا حق دار ہے جو عام طور پر لاگ اِن اسکرین کو ملتی ہے۔
ملٹی ٹیننٹ ٹریول APIs چند گنے چنے اور قابلِ پیش گوئی طریقوں سے لیک ہوتے ہیں۔ انہیں ایک ایک کر کے نام دینا فائدہ مند ہے، کیونکہ ہر ایک کا ڈیزائن میں ایک جواب ہے جو لانچ سے پہلے کہیں کم لاگت کا ہوتا ہے۔
ٹیننٹ کوئی پیرامیٹر نہیں
شروع کے منظر میں غلطی کوئی چھوٹا ہوا چیک نہیں۔ یہ ایسا ڈیزائن ہے جو کال کرنے والے سے پوچھتا ہے کہ وہ کون ہے اور پھر جواب پر بھروسہ کر لیتا ہے۔ ایک کلائنٹ والے سسٹم میں یہ صرف بے ترتیبی ہے۔ ایسے پلیٹ فارم پر جہاں درجنوں ایجنسیاں، سب ایجنٹس اور white-label سائٹس ایک ہی ڈیٹا بیس شیئر کرتی ہیں، یہ پورا سیکیورٹی ماڈل ہے جو ہر اس انٹیگریٹر کی ایمانداری پر ٹکا ہے جس کے ہاتھ کبھی کوئی key آئے گی۔
وہ اصول جو بگ کی پوری قسم ختم کر دیتا ہے: ٹیننٹ کریڈینشل سے طے ہوتا ہے، ریکوئسٹ سے کبھی نہیں۔ جب کوئی key یا ٹوکن تصدیق ہوتا ہے تو سرور طے کرتا ہے کہ وہ کس ٹیننٹ کا ہے، اس ٹیننٹ کے اندر کس دفتر کا ہے، اور کال کرنے والے کے پاس کون سے رولز ہیں۔ اس کے بعد ہر کوئری اسی دائرے کے اندر چلتی ہے۔ ریکوئسٹ کی باڈی میں جائز وجوہات کی بنا پر اب بھی ایجنسی آئی ڈی ہو سکتی ہے — مثلاً کوئی کنسولیڈیٹر اپنے کسی سب ایجنٹ کی طرف سے بکنگ بنا رہا ہو — لیکن سرور اس آئی ڈی کو اسی دائرے سے ملا کر دیکھتا ہے جو کریڈینشل پہلے طے کر چکا ہے۔ وہ کبھی دائرہ اس لیے نہیں بڑھاتا کہ کسی فیلڈ نے کہا تھا۔
عملی طور پر تین چیزیں سرور کی طرف رہتی ہیں:
- ٹیننٹ کی حد بندی ڈیٹا لیئر میں، ہر handler میں نہیں۔ ٹیننٹ کی ملکیت والی ٹیبلز پر ہر کوئری کے ساتھ خود بخود لگنے والا فلٹر یقینی بناتا ہے کہ جو ڈیولپر
whereشرط بھول جائے اسے کسی اور کا ڈیٹا نہیں بلکہ خالی نتیجہ ملے۔ ہر handler میں الگ الگ چیک اس پہلے موقع پر ناکام ہو جاتے ہیں جب کوئی جلدی میں نیا endpoint جوڑتا ہے۔ - راستے میں موجود ہر آئی ڈی پر آبجیکٹ کی سطح کا چیک۔
GET /bookings/98231کو تصدیق کرنی چاہیے کہ بکنگ 98231 کال کرنے والے کے دائرے میں آتی ہے۔ ترتیب وار آئی ڈیز اسے ٹریول APIs کا سب سے عام سوراخ بنا دیتی ہیں، کیونکہ بکنگ نمبر اور PNR کوڈ آسانی سے اندازہ لگائے جا سکتے ہیں۔ - "آپ کا نہیں" اور "موجود نہیں" کا ایک ہی جواب۔ کسی دوسرے ٹیننٹ کی بکنگ کے لیے 404 لوٹائیں۔ 403 اس بات کی تصدیق کرتا ہے کہ ریکارڈ موجود ہے، اور صرف یہی وہ معلومات ہے جو کوئی حریف حاصل کرنا چاہے گا۔
متبادل راستوں کو بھی اسی نظم کی ضرورت ہے۔ زیادہ تر پلیٹ فارمز کو ایک آپریشنل ویو چاہیے جو تمام ٹیننٹس میں پڑھ سکے — سپورٹ، فنانس اور پلیٹ فارم کے مالک کے لیے۔ اسے الگ رول بنائیں جو کوڈ میں دیا جائے اور استعمال پر لاگ ہو، نہ کہ کوئری کا ایسا فلیگ جسے کوئی بھی تصدیق شدہ کالر آن کر سکے۔ کلائنٹ کی انٹیگریشن کو ان حدود کے آس پاس کیسا رویہ رکھنا چاہیے، یہ ہوائی ٹکٹ بکنگ API کے انضمام والا مضمون ریکوئسٹ کی طرف سے بیان کرتا ہے۔
سپلائر کریڈینشلز کبھی براؤزر تک نہیں پہنچتے
ایک ٹریول پلیٹ فارم دو طرح کے راز رکھتا ہے۔ پہلا آپ کا ہے: وہ keys جو آپ پارٹنرز کو جاری کرتے ہیں۔ دوسرا سپلائرز کے ساتھ آپ کے تعلق کا ہے — GDS آفس کریڈینشلز، NDC ایگریگیٹرز کے ٹوکن، بیڈ بینکس کی API keys، جو اکثر ایسے معاہدے سے بندھی ہوتی ہیں جس پر آپ کی کمپنی کا نام اور آپ کا IATA نمبر درج ہوتا ہے۔ ان سے کی گئی ہر ریکوئسٹ سپلائر کی نظر میں آپ کی ریکوئسٹ ہے۔
ان کریڈینشلز کا صرف ایک محفوظ ٹھکانہ ہے: سرور کا وہ پروسیس جو کالر کی طرف سے سپلائر سے بات کرتا ہے۔ ان کی جگہ سنگل پیج ایپ کے JavaScript بنڈل میں، موبائل ایپ کی بائنری میں، براؤزر کو "صرف سرچ پیج کے لیے" بھیجی گئی کنفیگریشن فائل میں، یا سپلائر کال ناکام ہونے پر واپس آنے والے ایرر میسج میں نہیں۔ ان میں سے ہر جگہ کہیں نہ کہیں لیک کا ذریعہ بن چکی ہے۔ براؤزر کا نیٹ ورک ٹیب کوئی بھی کھول سکتا ہے، اور ایپ کی بائنری کو جو چاہے کھول کر دیکھ سکتا ہے۔
نتائج کسی بل سے بدتر ہیں۔ لیک ہوئی سپلائر key کسی اجنبی کو آپ کے اکاؤنٹ پر سرچ، اور کبھی بکنگ، کرنے دیتی ہے — اس look-to-book تناسب کو جلاتے ہوئے جس پر سپلائر آپ کو پرکھتا ہے، اور بدترین صورت میں آپ کے کریڈٹ پر ٹکٹ جاری کرتے ہوئے۔ سپلائر اس ٹریفک اور آپ کی ٹریفک میں فرق نہیں کرے گا۔ عام نتیجہ ایک معطل اکاؤنٹ ہوتا ہے جب تک آپ ثابت کریں کہ یہ آپ نہیں تھے، اور جو ایجنسی زیادہ تر ایک ایئرلائن یا ایک بیڈ بینک بیچتی ہے اس کے لیے اس کا مطلب پورے عرصے کے لیے بند دکان ہے۔
اس سے دو چھوٹے اصول نکلتے ہیں۔ کلائنٹ کبھی یہ نہیں چنتا کہ ریکوئسٹ کس سپلائر اکاؤنٹ سے جائے گی؛ یہ سرور ٹیننٹ کی کنفیگریشن سے چنتا ہے۔ اور سپلائرز کے ایرر باڈیز آپ کے API سے نکلنے سے پہلے ترجمہ کیے جاتے ہیں، کیونکہ سپلائر کے خام ایررز کبھی کبھی ریکوئسٹ ہیڈرز کو جوں کا توں واپس بھیج دیتے ہیں۔
لیک ہوا نیٹ کرایہ دراصل کتنا مہنگا پڑتا ہے
ڈیولپرز ڈیٹا لیکس کو اس بنیاد پر درجہ دیتے ہیں کہ ڈیٹا کتنا ذاتی ہے۔ ٹریول ڈسٹری بیوشن میں تجارتی لحاظ سے خطرناک فیلڈ اکثر قیمت ہوتی ہے۔ نیٹ کرایہ وہ رقم ہے جو سپلائر نے آپ کو اس شرط پر دینے پر اتفاق کیا کہ اسے عوام کو نہیں دکھایا جائے گا، اور اس اور فروخت کی قیمت کا فرق آپ کا اور آپ کے سب ایجنٹس کا مارجن ہے۔ نیچے کی ٹیبل ایک موٹی درجہ بندی ہے۔ ہو سکتا ہے آپ اپنے کاروبار کے لیے قطاروں کو مختلف وزن دیں، اور یہ اختلاف اپنی ٹیم کے ساتھ کسی واقعے سے پہلے کر لینا بہتر ہے، دوران نہیں۔
| کیا لیک ہوتا ہے | عام طور پر کون ڈھونڈتا ہے | آپ کو کتنا مہنگا پڑتا ہے |
|---|---|---|
| B2C سرچ کے جواب میں نیٹ کرایہ (JSON میں چھپا ہوا، اسکرین پر نہیں) | اسکریپ کرنے والے حریف، متجسس گاہک | سپلائر کی طرف سے ریٹ پیریٹی کی شکایات، اور گاہک جو پوچھتے ہیں کہ انہوں نے شائع شدہ قیمت کیوں ادا کی |
| کسی دوسرے سب ایجنٹ کا مارک اپ یا نیٹ قیمت | آپس میں شرائط کا موازنہ کرنے والے سب ایجنٹس | پورے نیٹ ورک میں قیمتیں دوبارہ زیرِ بحث؛ بہتر ڈیل لینے والا ایجنٹ موضوعِ گفتگو بن جاتا ہے |
| کلائنٹ بنڈل میں سپلائر کریڈینشلز | کوئی بھی جو دیکھے | آپ کے اکاؤنٹ پر ٹریفک اور بکنگز، تحقیقات کے دوران ممکنہ معطلی |
| گنے جا سکنے والے بکنگ یا PNR آئی ڈیز | اسکریپرز، کبھی کبھار صحافی | مسافروں کے ڈیٹا کا افشا، جس کا ریگولیٹری وزن تجارتی نقصان سے کہیں زیادہ ہے |
| دوسری ایجنسیوں کی کریڈٹ حدیں اور بیلنس | پارٹنرز، حریف | آپ کے نیٹ ورک کے کمزور ترین اکاؤنٹس توڑ لیے جانے کا نشانہ بن جاتے ہیں |
پہلی قطار وہ ہے جو ٹیمیں نظرانداز کر دیتی ہیں، کیونکہ اسکرین درست دکھائی دیتی ہے۔ صفحہ فروخت کی قیمت دکھاتا ہے؛ جس جواب سے وہ بھرا گیا اس میں نیٹ اور مارک اپ الگ فیلڈز کے طور پر موجود ہیں کیونکہ فرنٹ اینڈ کو "شاید ان کی ضرورت پڑے"۔ جوابات کو سامعین کے مطابق سرور پر ڈھالیں۔ B2C کالر کو فروخت کی قیمت ملتی ہے اور کچھ بھی ایسا نہیں جس سے کوئی گھٹا کر حساب لگا سکے۔ سب ایجنٹس کو نیٹ کرایوں کی تقسیم والا مضمون بتاتا ہے کہ یہی فرق وہ چیز ہے جو ایک کنسولیڈیٹر بیچتا ہے۔
بغیر ڈاؤن ٹائم کے کریڈینشلز کی تبدیلی
ہر کریڈینشل کو کبھی نہ کبھی بدلنا پڑے گا۔ کوئی ڈیولپر پارٹنر ایجنسی چھوڑ دیتا ہے، کوئی key کسی پبلک ریپوزٹری میں نظر آ جاتی ہے، کوئی سپلائر اپنے شیڈول پر تبدیلی کرتا ہے۔ اگر تبدیلی کا مطلب ہے "بدل دو اور جب تک پارٹنر دوبارہ ڈیپلائے نہ کرے سب ٹوٹا رہے"، تو کوئی تبدیلی نہیں کرتا، اور keys برسوں چلتی رہتی ہیں۔
پہلے دن سے اوورلیپ کے لیے ڈیزائن کریں۔ ہر پارٹنر کے پاس بیک وقت دو فعال keys ہو سکتی ہیں: وہ نئی بناتا ہے، ڈیپلائے کرتا ہے، ٹریفک کو منتقل ہوتا دیکھتا ہے، اور صرف پھر پرانی منسوخ کرتا ہے۔ اس کے کام کرنے کے لیے پلیٹ فارم کو چند غیر نمایاں حصے چاہییں:
- key کا ظاہر شناخت کنندہ — راز کے ساتھ محفوظ کیا گیا ایک پری فکس یا آئی ڈی — تاکہ لاگز اور سپورٹ ٹکٹس بتا سکیں کہ کس key نے کال کی، بغیر اس کے کہ کوئی خود راز دیکھے۔
- راز ہیش کی شکل میں محفوظ، بناتے وقت ایک بار دکھائے جائیں اور پھر کبھی نہیں۔ اگر آپ کی سپورٹ ٹیم کسی پارٹنر کی key پڑھ سکتی ہے تو آپ کے سپورٹ ٹولز میں نقب لگانے والا بھی پڑھ سکتا ہے۔
- ہر key کے لیے آخری استعمال کا وقت، تاکہ پارٹنر منسوخ کرنے سے پہلے دیکھ لے کہ پرانی key خاموش ہو چکی ہے۔
- منسوخی جو فوراً نافذ ہو، تصدیق کے آگے رکھے کسی بھی کیش میں بھی۔
سپلائر کریڈینشلز کو الٹی سمت میں یہی اوورلیپ چاہیے۔ انہیں build میں جڑنے کے بجائے کسی سیکرٹس اسٹور یا انکرپٹڈ کنفیگریشن میں رکھیں جسے چلتی ہوئی سروس دوبارہ پڑھتی ہو، تاکہ تبدیلی ڈیپلائمنٹ نہیں بلکہ کنفیگریشن کی تبدیلی ہو۔ طویل مدتی keys کے اوپر مختصر مدت کے ایکسیس ٹوکن بھی مدد کرتے ہیں: اگر کوئی ٹوکن لیک ہو جائے تو زیادہ تر لوگوں کے غائب ہونے کا احساس کرنے سے پہلے ہی ختم ہو جاتا ہے۔
تبدیلی وہ جگہ بھی ہے جہاں لاگنگ اپنی قیمت وصول کر لیتی ہے۔ یہ ریکارڈ رکھنا کہ ہر کال کس key اور کس ٹیننٹ نے کی — راز یا مسافر کی ادائیگی کا ڈیٹا ریکارڈ کیے بغیر — وہی چیز ہے جو آپ کو "کیا یہ ہم تھے؟" کا جواب ایک ہفتے کے بجائے ایک گھنٹے میں دینے دیتی ہے۔
کسی پارٹنر کو key دینے سے پہلے
ایک مختصر فہرست، کیونکہ لمبا ورژن اس مضمون کا باقی حصہ ہے:
- کیا ریکوئسٹ میں کوئی چیز key کا ٹیننٹ بدل سکتی ہے؟ نہیں بدلنی چاہیے۔
- کیا ہر وہ endpoint جو آئی ڈی لیتا ہے ملکیت چیک کرتا ہے، اور چیک ناکام ہونے پر 404 دیتا ہے؟
- کیا کوئی سپلائر کریڈینشل، یا اس سے نکالی گئی کوئی فیلڈ، براؤزر سے قابلِ رسائی ہے؟
- کیا کسی B2C جواب میں کہیں نیٹ قیمت یا مارک اپ موجود ہے، چھپی ہوئی فیلڈز سمیت؟
- کیا پارٹنر آپ کو فون کیے بغیر key بدل سکتا ہے، اور کیا آپ اسے فون کیے بغیر منسوخ کر سکتے ہیں؟
ہمارے API تک رسائی کیسے ہوتی ہے
اس بلاگ کے پیچھے موجود پلیٹ فارم فلائٹس اور ہوٹلز کے APIs فراہم کرتا ہے۔ اس پر ہر ٹیننٹ پہلے سے اپنے ایڈمن پینل، اپنی بکنگز اور رول کی بنیاد پر عملے کی اجازتوں کے ساتھ چلتا ہے، اور سپلائر کا مواد کسی ٹیننٹ تک ایک سے ایک معاہدوں کے بجائے سپلائر گروپس کے ذریعے پہنچتا ہے۔ API تک رسائی سیلف سروس key سے نہیں بلکہ ایک گفتگو سے شروع ہوتی ہے، جزوی طور پر اوپر بیان کی گئی وجوہات کی بنا پر: ہم پسند کرتے ہیں کہ کریڈینشل بننے سے پہلے جان لیں کہ کون انٹیگریٹ کر رہا ہے، اور کس مارکیٹ کے لیے۔ ٹریول APIs کا صفحہ بتاتا ہے کہ کیا دستیاب ہے اور یہ گفتگو کیسے شروع ہوتی ہے۔