Sayohat API autentifikatsiyasi va xavfsizligi: sizishlar

Hamkor agentliklaringizdan biridagi dasturchi seshanba kuni tushdan keyin integratsiyasini sinab ko'rmoqda. U bronlar ro'yxati endpoint-i so'rov qatorida agencyId qabul qilishini payqaydi va qiziqib uni 114 dan 115 ga o'zgartiradi. Javob boshqa birovning bronlari bilan qaytadi: yo'lovchilarning ismlari, PNR kodlari va o'sha agentlik o'z ustamasini qo'shishdan oldin to'lagan netto tarif. Hech kim hech narsaga hujum qilmadi. API shunchaki mijoz aytganiga ishondi. O'sha bir kun sayohat API autentifikatsiyasi va xavfsizligi aslida nima haqida ekanining katta qismidir, shuning uchun bu mavzu odatda kirish ekraniga beriladigan e'tibordan ko'proq e'tiborga loyiq.
Ko'p tenantli sayohat API'lari bir necha oldindan aytib bo'ladigan yo'llar bilan sizib chiqadi. Ularni birma-bir nomlash kerak, chunki har birining loyihaviy yechimi bor va bu yechim ishga tushirishdan oldin keyingisiga qaraganda ancha arzonga tushadi.
Tenant parametr emas
Boshlang'ich sahnadagi xato yetishmagan tekshiruv emas. Bu chaqiruvchidan kimligini so'raydigan va keyin javobga ishonadigan arxitektura. Bitta mijozli tizimda bu shunchaki tartibsizlik. O'nlab agentliklar, subagentlar va white-label saytlar bitta ma'lumotlar bazasini bo'lishadigan platformada esa bu — kalit oladigan har bir integratorning halolligiga suyangan butun xavfsizlik modeli.
Xatolarning butun sinfini yo'q qiladigan qoida: tenant so'rovdan emas, hisob ma'lumotlaridan aniqlanadi. Kalit yoki token tekshirilganda server uning qaysi tenantga, shu tenant ichidagi qaysi ofisga tegishli ekanini va chaqiruvchining qanday rollari borligini aniqlaydi. Shu paytdan boshlab har bir so'rov ana shu doira ichida bajariladi. So'rov tanasida qonuniy sabablar bilan baribir agentlik identifikatori bo'lishi mumkin — masalan, konsolidator o'z subagentlaridan biri nomidan bron yaratadi, — lekin server bu identifikatorni hisob ma'lumotlari allaqachon belgilagan doira bilan solishtiradi. Qandaydir maydon so'ragani uchun doirani hech qachon kengaytirmaydi.
Amalda server tomonida uchta narsa yashaydi:
- Tenant bo'yicha cheklov har bir handler'da emas, ma'lumotlar qatlamida. Tenantga tegishli jadvallarga qilingan har bir so'rovga avtomatik qo'llanadigan filtr
whereshartini unutgan dasturchi birovning ma'lumotlarini emas, bo'sh natija olishini ta'minlaydi. Har bir handler'dagi alohida tekshiruvlar kimdir shoshilib yangi endpoint qo'shgan birinchi daqiqadayoq pand beradi. - Yo'ldagi har bir identifikator uchun obyekt darajasidagi tekshiruv.
GET /bookings/9823198231 bronining chaqiruvchi doirasiga tegishli ekanini tasdiqlashi kerak. Ketma-ket identifikatorlar buni sayohat API'laridagi eng ko'p uchraydigan teshikka aylantiradi, chunki bron raqamlari va PNR kodlarini taxmin qilish oson. - "Sizniki emas" va "mavjud emas" uchun bir xil javob. Boshqa tenantning broni uchun 404 qaytaring. 403 kodi yozuv mavjudligini tasdiqlaydi, birgina shuning o'zi raqib bilishni xohlaydigan ma'lumot.
Aylanma yo'llar ham xuddi shunday intizom talab qiladi. Ko'pchilik platformalarga barcha tenantlarni o'qiydigan operatsion ko'rinish kerak — qo'llab-quvvatlash, moliya, platforma egasi uchun. Uni kodda beriladigan va har ishlatilganda jurnalga yoziladigan alohida rol qiling, istalgan autentifikatsiyadan o'tgan chaqiruvchi yoqa oladigan so'rov bayrog'i emas. Mijoz tomonidagi integratsiya shu chegaralar atrofida o'zini qanday tutishi kerakligini aviachipta bronlash API integratsiyasi haqidagi maqola so'rov tomonidan tushuntiradi.
Yetkazib beruvchi hisob ma'lumotlari hech qachon brauzerga yetib bormaydi
Sayohat platformasi ikki turdagi sirni saqlaydi. Birinchisi sizniki: hamkorlarga beradigan kalitlaringiz. Ikkinchisi yetkazib beruvchilar bilan munosabatingizga tegishli — GDS ofis hisob ma'lumotlari, NDC agregatorlarining tokenlari, bedbanklarning API kalitlari; ular ko'pincha kompaniyangiz nomi va IATA raqamingiz yozilgan shartnomaga bog'langan. Ular bilan qilingan har bir so'rov yetkazib beruvchi uchun sizdan kelgan so'rovdir.
Bu hisob ma'lumotlarining faqat bitta xavfsiz joyi bor: chaqiruvchi nomidan yetkazib beruvchi bilan gaplashadigan server jarayoni. Ularning bir sahifali ilovaning JavaScript bandlida, mobil ilovaning binar faylida, brauzerga "faqat qidiruv sahifasi uchun" beriladigan konfiguratsiya faylida yoki yetkazib beruvchiga murojaat muvaffaqiyatsiz bo'lganda qaytariladigan xato xabarida o'rni yo'q. Bu joylarning har biri qayerdadir allaqachon sizish manbai bo'lgan. Brauzerdagi tarmoq yorlig'ini har kim ocha oladi, binar faylni esa xohlagan odam ochib ko'ra oladi.
Oqibatlari hisob-fakturadan ham og'irroq. Sizib chiqqan yetkazib beruvchi kaliti begona odamga sizning hisobingizda qidirish, ba'zan esa bron qilish imkonini beradi — yetkazib beruvchi sizni o'lchaydigan look-to-book nisbatini buzadi va yomon holatda sizning kreditingizga chipta yozadi. Yetkazib beruvchi bu trafikni siznikidan ajrata olmaydi. Odatiy natija — bu siz emasligingizni isbotlaguningizcha to'xtatilgan hisob, asosan bitta aviakompaniya yoki bitta bedbankni sotadigan agentlik uchun esa bu butun shu muddat davomida yopiq do'kon degani.
Bundan ikkita kichikroq qoida kelib chiqadi. So'rov qaysi yetkazib beruvchi hisobi orqali o'tishini mijoz hech qachon tanlamaydi; uni server tenant konfiguratsiyasidan tanlaydi. Yetkazib beruvchilarning xato matnlari esa API'ingizdan chiqishidan oldin qayta ishlanadi, chunki yetkazib beruvchining xom xatolari ba'zan so'rov sarlavhalarini o'z holicha qaytaradi.
Sizib chiqqan netto tarif aslida qanchaga tushadi
Dasturchilar ma'lumotlar sizishini ma'lumot qanchalik shaxsiy ekaniga qarab tartiblashga moyil. Sayohat distribyutsiyasida tijoriy jihatdan xavfli maydon ko'pincha narx bo'ladi. Netto tarif — yetkazib beruvchi omma uchun ko'rsatilmaslik sharti bilan sizga berishga rozi bo'lgan summa, uning sotish narxidan farqi esa sizning va subagentlaringizning marjasi. Quyidagi jadval taxminiy reyting. O'z biznesingiz uchun qatorlarni boshqacha baholashingiz mumkin, va bu bahsni jamoangiz bilan hodisa paytida emas, undan oldin o'tkazgan ma'qul.
| Nima sizib chiqadi | Odatda kim topadi | Sizga qanchaga tushadi |
|---|---|---|
| B2C qidiruv javobidagi netto tarif (ekranda emas, JSON ichida yashiringan) | Skreyping qiluvchi raqiblar, qiziquvchan mijozlar | Yetkazib beruvchidan narx pariteti bo'yicha shikoyatlar va e'lon qilingan narxni nega to'laganini so'raydigan mijozlar |
| Boshqa subagentning ustamasi yoki netto narxi | Shartlarini solishtiradigan subagentlar | Butun tarmoqda narxlar qayta muhokamaga ochiladi; yaxshiroq kelishuv olgan agent asosiy mavzuga aylanadi |
| Mijoz bandlidagi yetkazib beruvchi hisob ma'lumotlari | Qaragan har kim | Hisobingizdagi trafik va bronlar, tekshiruv paytida to'xtatilish xavfi |
| Sanab chiqish mumkin bo'lgan bron yoki PNR identifikatorlari | Skreyperlar, ba'zan jurnalistlar | Yo'lovchi ma'lumotlarining oshkor bo'lishi; uning tartibga solish bo'yicha og'irligi tijoriy zarardan ancha katta |
| Boshqa agentliklarning kredit limitlari va balanslari | Hamkorlar, raqiblar | Tarmog'ingizdagi eng zaif hisoblar og'dirib olish nishoniga aylanadi |
Jamoalar ko'pincha birinchi qatorni o'tkazib yuboradi, chunki ekran to'g'ri ko'rinadi. Sahifa sotish narxini ko'rsatadi; uni to'ldirgan javob esa netto va ustamani alohida maydonlar sifatida olib yuradi, chunki frontend'ga ular "kerak bo'lib qolishi mumkin". Javoblarni auditoriyaga qarab server tomonida shakllantiring. B2C chaqiruvchi sotish narxini oladi va kimgadir ayirish amalini bajarishga imkon beradigan hech narsa olmaydi. Netto tariflarni subagentlarga tarqatish haqidagi maqola aynan shu farq konsolidator sotadigan narsa ekanini tushuntiradi.
Hisob ma'lumotlarini to'xtovsiz almashtirish
Har qanday hisob ma'lumotini qachondir almashtirish kerak bo'ladi. Dasturchi hamkor agentlikdan ketadi, kalit ochiq repozitoriyda paydo bo'ladi, yetkazib beruvchi o'z jadvali bo'yicha almashtiradi. Agar almashtirish "o'zgartirdik — hamkor qayta joylashtirguncha hammasi buziladi" degani bo'lsa, hech kim almashtirmaydi va kalitlar yillab yashaydi.
Birinchi kundan boshlab ustma-ust tushishni loyihalang. Har bir hamkorda bir vaqtning o'zida ikkita faol kalit bo'lishi mumkin: u yangisini yaratadi, joylashtiradi, trafik o'tganini kuzatadi va faqat shundan keyin eskisini bekor qiladi. Bu ishlashi uchun platformaga bir nechta ko'zga tashlanmaydigan qism kerak:
- Kalitning ko'rinadigan identifikatori — sir yonida saqlanadigan prefiks yoki id, — shunda jurnallar va qo'llab-quvvatlash murojaatlari sirning o'zini hech kimga ko'rsatmay qaysi kalit chaqiruv qilganini ayta oladi.
- Sirlar xesh sifatida saqlanadi, yaratilganda bir marta ko'rsatiladi va boshqa hech qachon ko'rsatilmaydi. Agar qo'llab-quvvatlash jamoangiz hamkorning kalitini o'qiy olsa, qo'llab-quvvatlash vositalarini buzgan har kim ham o'qiy oladi.
- Har bir kalit uchun oxirgi ishlatilgan vaqt, shunda hamkor eski kalitni bekor qilishdan oldin uning tinchiganini ko'radi.
- Darhol kuchga kiradigan bekor qilish, jumladan autentifikatsiya oldidagi har qanday keshda ham.
Yetkazib beruvchi hisob ma'lumotlariga ham teskari yo'nalishda xuddi shunday ustma-ust tushish kerak. Ularni build ichiga tikib qo'ymasdan, ishlab turgan servis qayta o'qiydigan sirlar omborida yoki shifrlangan konfiguratsiyada saqlang — shunda almashtirish joylashtirish emas, konfiguratsiya o'zgarishi bo'ladi. Uzoq muddatli kalitlar ustidagi qisqa muddatli kirish tokenlari ham yordam beradi: token sizib chiqsa, ko'pchilik uning yo'qolganini payqamasdan muddati tugaydi.
Almashtirish — jurnal yuritish o'zini oqlaydigan joy ham. Har bir chaqiruvni qaysi kalit va qaysi tenant qilganini yozib borish — sirni ham, yo'lovchining to'lov ma'lumotlarini ham yozmasdan — "bu biz edikmi?" degan savolga bir haftada emas, bir soatda javob berish imkonini beradi.
Hamkorga kalit berishdan oldin
Qisqa ro'yxat, chunki uzun versiyasi — bu maqolaning qolgan qismi:
- So'rovdagi biror narsa kalitning tenantini o'zgartira oladimi? O'zgartirmasligi kerak.
- Identifikator qabul qiladigan har bir endpoint egalikni tekshiradimi va tekshiruv muvaffaqiyatsiz bo'lsa 404 javob beradimi?
- Biror yetkazib beruvchi hisob ma'lumoti yoki undan olingan maydon brauzerdan ochiqmi?
- B2C javobida biror joyda, yashirin maydonlar bilan birga, netto narx yoki ustama bormi?
- Hamkor sizga qo'ng'iroq qilmasdan kalitni almashtira oladimi, siz esa unga qo'ng'iroq qilmasdan bekor qila olasizmi?
API'imizga kirish qanday tashkil etilgan
Ushbu blog ortidagi platforma aviachipta va mehmonxonalar uchun API'lar taqdim etadi. Undagi har bir tenant allaqachon o'z admin paneli, o'z bronlari va rollarga asoslangan xodim ruxsatlari bilan ishlaydi, yetkazib beruvchi kontenti esa tenantga birma-bir kelishuvlar orqali emas, yetkazib beruvchi guruhlari orqali yetib boradi. API'ga kirish o'z-o'ziga xizmat ko'rsatish kalitidan emas, suhbatdan boshlanadi, qisman yuqoridagi sabablarga ko'ra: hisob ma'lumoti paydo bo'lishidan oldin kim va qaysi bozor uchun integratsiya qilayotganini bilishni afzal ko'ramiz. Sayohat API'lari sahifasi nima mavjudligini va bu suhbat qanday boshlanishini tasvirlaydi.