أمان واجهات API للسفر: من أين تتسرّب بيانات الوكالات

مطوّر لدى إحدى الوكالات الشريكة يختبر الربط مع منصتك بعد ظهر يوم ثلاثاء. يلاحظ أن طلب قائمة الحجوزات يحمل المعامل agencyId في عنوان الطلب، فيغيّره بدافع الفضول من 114 إلى 115. تعود الاستجابة بحجوزات وكالة أخرى: أسماء المسافرين، وأرقام PNR، والسعر الصافي الذي دفعته تلك الوكالة قبل إضافة هامش الربح. لم يهاجم أحد شيئاً. كل ما حدث أن واجهة API صدّقت ما قاله لها الطرف الآخر. هذه الظهيرة وحدها تختصر معظم ما تعنيه المصادقة والأمان في واجهات API للسفر، وهي السبب في أن الموضوع يستحق عناية أكبر بكثير مما تحظى به عادة شاشة تسجيل الدخول.
واجهات API متعددة المستأجرين في قطاع السفر تتسرّب منها البيانات بطرق محدودة ومتوقعة. ومن المفيد تسمية كل طريقة على حدة، لأن لكل منها حلاً في التصميم تكلفته قبل الإطلاق أقل بكثير من تكلفته بعده.
هوية المستأجر ليست معاملاً في الطلب
الخطأ في المثال أعلاه ليس فحصاً منسياً. إنه تصميم يسأل الطرف المتصل عن هويته ثم يثق بالإجابة. في نظام يخدم عميلاً واحداً، هذا مجرد ترتيب غير أنيق. أما في منصة تتشارك فيها عشرات الوكالات والوكلاء الفرعيين ومواقع وايت ليبل قاعدة بيانات واحدة، فهذا يعني أن نموذج الأمان كله قائم على أمانة كل مطوّر سيحمل مفتاحاً في يوم من الأيام.
القاعدة التي تُغلق هذا الصنف من الأخطاء بالكامل: المستأجر يُستخرج من بيانات الاعتماد، لا من الطلب. عند التحقق من المفتاح أو الرمز (token)، يحدّد الخادم المستأجر الذي ينتمي إليه، والمكتب داخل ذلك المستأجر، والأدوار التي يملكها المتصل. ومن تلك اللحظة يجري كل استعلام داخل هذا النطاق. قد يحمل جسم الطلب معرّف وكالة لسبب مشروع، كأن ينشئ وكيل معتمد لدى IATA حجزاً نيابة عن أحد وكلائه الفرعيين، لكن الخادم يطابق هذا المعرّف مع النطاق الذي حدّدته بيانات الاعتماد مسبقاً، ولا يوسّع النطاق أبداً لأن حقلاً في الطلب طلب ذلك.
عملياً، هناك ثلاثة أمور مكانها الخادم:
- تقييد النطاق في طبقة البيانات، لا في كل معالج على حدة. عندما يُطبَّق مرشح تلقائي على كل استعلام في الجداول المملوكة للمستأجرين، فإن المطوّر الذي ينسى شرط
whereيحصل على نتيجة فارغة، لا على بيانات غيره. أما الفحوص الموزعة على المعالجات فتفشل في أول مرة يضيف فيها أحدهم نقطة نهاية على عجل. - فحص الملكية لكل معرّف في المسار. الطلب
GET /bookings/98231يجب أن يتأكد من أن الحجز 98231 يقع ضمن نطاق المتصل. المعرّفات المتسلسلة تجعل هذه الثغرة الأكثر شيوعاً في واجهات API للسفر، لأن أرقام الحجوزات ومراجع PNR سهلة التخمين. - إجابة واحدة لـ«ليس لك» و«غير موجود». أعد الرمز 404 عند طلب حجز يخص مستأجراً آخر. الرمز 403 يؤكد أن السجل موجود، وهذه وحدها معلومة يرغب فيها أي منافس.
المنافذ الاستثنائية تستحق الانضباط نفسه. معظم المنصات تحتاج إلى عرض تشغيلي يقرأ عبر المستأجرين: فريق الدعم، والمالية، ومالك المنصة. اجعل ذلك دوراً مستقلاً يُمنح في الكود ويُسجَّل عند استخدامه، لا خياراً في الاستعلام يستطيع أي متصل موثّق تفعيله. ولمعرفة كيف ينبغي أن يتصرف تكامل العميل حول هذه الحدود، يغطي مقال ربط API حجز الطيران جانب الطلبات بالتفصيل.
بيانات اعتماد الموردين لا تصل إلى المتصفح أبداً
منصة السفر تحتفظ بنوعين من الأسرار. الأول ملكك: المفاتيح التي تصدرها لشركائك. والثاني جزء من علاقتك بالموردين: بيانات اعتماد مكاتب نظام التوزيع العالمي (GDS)، ورموز مجمّعي قدرات التوزيع الجديدة (NDC)، ومفاتيح API لبنوك الأسرّة، وكثير منها مرتبط بعقد يحمل اسم شركتك ورقم IATA الخاص بك. كل طلب يُرسل بها هو، من وجهة نظر المورد، طلب صادر منك أنت.
لهذه البيانات مكان آمن واحد فقط: عملية على الخادم تتواصل مع المورد نيابة عن المتصل. مكانها ليس حزمة JavaScript في تطبيق الصفحة الواحدة، ولا ملف تطبيق الجوال، ولا ملف إعدادات يُرسل إلى المتصفح «لصفحة البحث فقط»، ولا رسالة خطأ تُعاد عند فشل الاتصال بالمورد. كل واحد من هذه الأماكن كان مصدر تسريب في مكان ما. أي شخص يستطيع فتح تبويب الشبكة في المتصفح، وأي ملف تطبيق يمكن تفكيكه لمن يريد.
العواقب أسوأ من فاتورة. مفتاح المورد المسرَّب يسمح لغريب بالبحث، وأحياناً بالحجز، على حسابك، فيستهلك نسبة البحث إلى الحجز التي يقيسك المورد عليها، وفي أسوأ الحالات يُصدر تذاكر على رصيدك الائتماني. المورد لن يفرّق بين تلك الحركة وحركتك. والنتيجة المعتادة تعليق الحساب ريثما تثبت أن الأمر لم يكن منك، وهذا بالنسبة إلى وكالة تبيع في الغالب ناقلاً واحداً أو بنك أسرّة واحداً يعني إغلاق المحل طوال فترة التحقيق.
تتبع ذلك قاعدتان أصغر. العميل لا يختار أبداً حساب المورد الذي يمر عبره الطلب، فالخادم يحدده من إعدادات المستأجر. ورسائل الخطأ الواردة من الموردين تُعاد صياغتها قبل أن تغادر واجهتك، لأن بعضها يعيد ترويسات الطلب كما هي.
كم يكلّفك تسريب السعر الصافي فعلاً
يميل المطورون إلى ترتيب تسريبات البيانات بحسب مدى خصوصيتها. لكن في توزيع السفر، الحقل الأخطر تجارياً هو السعر في أغلب الأحيان. السعر الصافي (Net Rate) هو الرقم الذي وافق المورد على منحك إياه بشرط ألا يُعرض على الجمهور، والفرق بينه وبين سعر البيع هو هامش ربحك وهامش ربح وكلائك الفرعيين. الجدول أدناه ترتيب تقريبي، وقد تزن الصفوف بشكل مختلف بحسب عملك، وهذا الخلاف يستحق أن تناقشه مع فريقك قبل الحادثة لا أثناءها.
| ما يتسرّب | من يكتشفه عادة | ما يكلّفك |
|---|---|---|
| السعر الصافي داخل استجابة بحث B2C (مخفي في JSON لا على الشاشة) | منافسون يجمعون البيانات آلياً، وعملاء فضوليون | شكاوى من المورد بشأن تكافؤ الأسعار، وعملاء يسألون لماذا دفعوا السعر المنشور |
| هامش ربح وكيل فرعي آخر أو سعره الصافي | الوكلاء الفرعيون حين يتبادلون المعلومات | إعادة فتح التسعير مع الشبكة كلها، ويصبح الوكيل صاحب الصفقة الأفضل حديث الجميع |
| بيانات اعتماد المورد داخل حزمة العميل | أي شخص يبحث | حركة وحجوزات على حسابك، واحتمال تعليقه أثناء التحقيق |
| معرّفات حجوزات أو PNR قابلة للتخمين | أدوات جمع البيانات، وأحياناً الصحفيون | كشف بيانات المسافرين، وهو ما يحمل وزناً تنظيمياً يتجاوز الخسارة التجارية بكثير |
| حدود الائتمان وأرصدة الوكالات الأخرى | الشركاء والمنافسون | أضعف الحسابات في شبكتك تصبح هدفاً سهلاً للاستقطاب |
الصف الأول هو الذي تغفل عنه الفرق، لأن الشاشة تبدو سليمة. الصفحة تعرض سعر البيع، أما الاستجابة التي غذّتها فتحمل السعر الصافي وهامش الربح في حقلين منفصلين لأن الواجهة الأمامية «قد تحتاجهما». شكّل الاستجابة بحسب الجمهور على الخادم. المتصل في B2C يحصل على سعر البيع ولا شيء يسمح لأحد بإجراء عملية طرح. ويشرح مقال توزيع الأسعار الصافية على الوكلاء الفرعيين لماذا يكون هذا الفرق تحديداً هو ما يبيعه الوكيل المعتمد.
تدوير بيانات الاعتماد دون توقف الخدمة
كل بيانات اعتماد ستحتاج إلى استبدال يوماً ما. مطوّر يغادر وكالة شريكة، مفتاح يظهر في مستودع عام، مورد يدوّر مفاتيحه وفق جدوله الخاص. إذا كان التدوير يعني «غيّره وسيتعطل كل شيء حتى يعيد الشريك النشر»، فلن يدوّر أحد، وستعيش المفاتيح سنوات.
صمّم للتداخل منذ اليوم الأول. يستطيع كل شريك امتلاك مفتاحين نشطين في آن واحد: ينشئ الجديد، وينشره، ويراقب انتقال حركته إليه، ثم يلغي القديم. ولكي ينجح ذلك تحتاج المنصة إلى بضعة عناصر غير لافتة:
- معرّف ظاهر للمفتاح، بادئة أو رقم يُخزَّن بجانب السر، حتى تذكر السجلات وتذاكر الدعم أي مفتاح أجرى الطلب دون أن يرى أحد السر نفسه.
- أسرار مخزّنة على شكل قيم مُجزّأة (hash)، تُعرض مرة واحدة عند الإنشاء ولا تُعرض بعدها أبداً. إذا كان فريق الدعم لديك يستطيع قراءة مفتاح الشريك، فكذلك أي شخص يخترق أدوات الدعم.
- طابع زمني لآخر استخدام لكل مفتاح، ليرى الشريك أن المفتاح القديم توقف عن العمل قبل إلغائه.
- إلغاء يسري فوراً، بما في ذلك أي ذاكرة مؤقتة تقع أمام طبقة المصادقة.
بيانات اعتماد الموردين تحتاج إلى التداخل نفسه في الاتجاه المعاكس. احفظها في مخزن أسرار أو إعدادات مشفّرة تعيد الخدمة قراءتها أثناء التشغيل، لا داخل حزمة البناء، ليصبح التبديل تغييراً في الإعدادات لا عملية نشر. والرموز قصيرة العمر فوق المفاتيح طويلة العمر تساعد أيضاً: إذا تسرّب رمز، تنتهي صلاحيته قبل أن ينتبه معظم الناس لاختفائه.
التدوير هو أيضاً المكان الذي يثبت فيه التسجيل قيمته. تسجيل أي مفتاح وأي مستأجر أجرى كل طلب، دون تسجيل السر أو بيانات الدفع الخاصة بالمسافر، هو ما يتيح لك الإجابة عن سؤال «هل كان ذلك منا؟» خلال ساعة بدلاً من أسبوع.
قبل أن تسلّم الشريك مفتاحاً
قائمة قصيرة، لأن النسخة الطويلة هي بقية هذا المقال:
- هل يمكن لأي شيء في الطلب أن يغيّر المستأجر المرتبط بالمفتاح؟ يجب ألا يحدث ذلك.
- هل تتحقق كل نقطة نهاية تستقبل معرّفاً من الملكية، وتعيد 404 عند فشل التحقق؟
- هل يمكن الوصول من المتصفح إلى أي بيانات اعتماد للمورد، أو أي حقل مشتق منها؟
- هل تحتوي أي استجابة B2C على سعر صافٍ أو هامش ربح، بما في ذلك الحقول المخفية؟
- هل يستطيع الشريك التدوير دون الاتصال بك، وتستطيع أنت الإلغاء دون الاتصال به؟
كيف نتعامل مع الوصول إلى واجهات API لدينا
المنصة التي تقف خلف هذه المدونة توفّر واجهات API للطيران والفنادق. كل مستأجر عليها يعمل أصلاً بلوحة إدارة خاصة به، وحجوزاته الخاصة، وصلاحيات موظفين قائمة على الأدوار، ويصل محتوى الموردين إلى المستأجر عبر مجموعات الموردين لا عبر صفقات فردية. والوصول إلى الواجهة يبدأ بمحادثة لا بمفتاح ذاتي الخدمة، ويعود ذلك جزئياً إلى الأسباب المذكورة أعلاه: نفضّل أن نعرف من يقوم بالربط، ولأي سوق، قبل أن توجد أي بيانات اعتماد. وتشرح صفحة واجهات API للسفر ما هو متاح وكيف تبدأ تلك المحادثة.