Travel API аутентификациясы мен қауіпсіздігі: ағып кету

Серіктес агенттіктеріңіздің біріндегі әзірлеуші сейсенбі күні түстен кейін интеграциясын тексеріп отыр. Ол брондаулар тізімінің endpoint-і сұраныс жолында agencyId қабылдайтынын байқап, қызығушылықпен оны 114-тен 115-ке ауыстырады. Жауапта басқа біреудің брондаулары келеді: жолаушылардың аты-жөні, PNR кодтары және сол агенттік өз үстемесін қоспай тұрып төлеген нетто-тариф. Ешкім ешнәрсеге шабуыл жасаған жоқ. API клиенттің айтқанына жай ғана сенді. Осы бір түстен кейінгі уақыт travel API аутентификациясы мен қауіпсіздігі шын мәнінде не туралы екенінің басым бөлігін көрсетеді, сондықтан бұл тақырып әдетте кіру экранына бөлінетін көңілден көбірек назар қажет етеді.
Көп тенантты туристік API-лар бірнеше болжамды жолмен ағып кетеді. Оларды бір-бірлеп атаған жөн, өйткені әрқайсысының архитектуралық шешімі бар, ал ол шешім іске қосылғанға дейін кейінгіден әлдеқайда арзанға түседі.
Тенант — параметр емес
Алғашқы көріністегі қате — жетіспейтін тексеру емес. Бұл шақырушыдан оның кім екенін сұрап, сосын жауабына сенетін архитектура. Бір клиенті бар жүйеде бұл тек ретсіздік. Ондаған агенттік, субагенттер және white-label сайттар бір дерекқорды бөлісетін платформада бұл — кілт ұстайтын әр интегратордың адалдығына сүйенген бүкіл қауіпсіздік моделі.
Қателердің бүкіл класын жоятын ереже: тенант сұраныстан емес, тіркелгі деректерінен анықталады. Кілт немесе токен тексерілгенде сервер оның қай тенантқа, сол тенант ішіндегі қай кеңсеге тиесілі екенін және шақырушының қандай рөлдері бар екенін анықтайды. Сол сәттен бастап әр сұраныс осы шекара ішінде орындалады. Сұраныс денесінде заңды себептермен агенттік идентификаторы әлі де болуы мүмкін — мысалы, консолидатор өз субагенттерінің бірінің атынан брондау жасайды, — бірақ сервер бұл идентификаторды тіркелгі деректері белгілеп қойған шекарамен салыстырады. Қандай да бір өріс сұрағаны үшін шекараны ешқашан кеңейтпейді.
Іс жүзінде сервер жағында үш нәрсе тұрады:
- Тенант бойынша шектеу әр өңдегіште емес, деректер деңгейінде. Тенантқа тиесілі кестелерге жасалған әр сұранысқа автоматты түрде қолданылатын сүзгі
whereшартын ұмытқан әзірлеуші біреудің деректерін емес, бос нәтиже алатынын қамтамасыз етеді. Әр өңдегіштегі жеке тексерулер біреу асығыс жаңа endpoint қосқан алғашқы сәтте-ақ сыр береді. - Жолдағы әр идентификаторға объект деңгейіндегі тексеру.
GET /bookings/9823198231 брондауының шақырушы шекарасына жататынын растауы керек. Реттік идентификаторлар бұны туристік API-лардағы ең жиі кездесетін саңылауға айналдырады, өйткені брондау нөмірлері мен PNR кодтарын болжау оңай. - «Сіздікі емес» пен «жоқ» үшін бірдей жауап. Басқа тенанттың брондауына 404 қайтарыңыз. 403 коды жазбаның бар екенін растайды, ал мұның өзі бәсекелес білгісі келетін ақпарат.
Айналма жолдар да сондай тәртіпті талап етеді. Көптеген платформаларға барлық тенанттарды оқитын операциялық көрініс керек — қолдау қызметі, қаржы бөлімі, платформа иесі үшін. Оны кодта берілетін және әр қолданылғанда журналға жазылатын бөлек рөл етіңіз, кез келген аутентификацияланған шақырушы қоса алатын сұраныс жалауы емес. Клиенттік интеграция осы шекаралар маңында қалай әрекет етуі керегін авиабилет брондау API интеграциясы туралы мақала сұраныс жағынан түсіндіреді.
Жеткізуші тіркелгі деректері ешқашан браузерге жетпейді
Туристік платформа құпияның екі түрін сақтайды. Біріншісі — сіздікі: серіктестерге беретін кілттеріңіз. Екіншісі жеткізушілермен қарым-қатынасыңызға тиесілі — GDS кеңсесінің тіркелгі деректері, NDC агрегаторларының токендері, бедбанктердің API кілттері, көбіне компанияңыздың атауы мен IATA нөміріңіз жазылған келісімшартқа байланған. Олармен жасалған әр сұраныс жеткізуші үшін — сізден келген сұраныс.
Бұл тіркелгі деректерінің бір ғана қауіпсіз орны бар: шақырушы атынан жеткізушімен сөйлесетін серверлік процесс. Олардың бір беттік қосымшаның JavaScript бандлында, мобильді қосымшаның бинарлық файлында, браузерге «тек іздеу беті үшін» берілетін конфигурация файлында немесе жеткізушіге шақыру сәтсіз болғанда қайтарылатын қате хабарламасында орны жоқ. Осы жерлердің әрқайсысы бір жерде ағып кету көзі болған. Браузердегі желі қойындысын кез келген адам аша алады, ал бинарлық файлды қалаған кісі ашып көре алады.
Салдары шоттан да ауыр. Ағып кеткен жеткізуші кілті бөгде адамға сіздің аккаунтыңызда іздеуге, кейде брондауға мүмкіндік береді — жеткізуші сізді бағалайтын look-to-book қатынасын бүлдіріп, нашар жағдайда сіздің кредитіңізге билет шығарады. Жеткізуші бұл трафикті сіздікінен ажырата алмайды. Әдеттегі нәтиже — бұл сіз емес екеніңізді дәлелдегенше бұғатталған аккаунт, ал негізінен бір әуекомпанияны немесе бір бедбанкті сататын агенттік үшін бұл бүкіл осы уақытқа жабық дүкен деген сөз.
Бұдан екі кішірек ереже шығады. Сұраныстың қай жеткізуші аккаунты арқылы өтетінін клиент ешқашан таңдамайды; оны сервер тенант конфигурациясынан таңдайды. Ал жеткізушілердің қате мәтіндері API-ыңыздан шықпас бұрын өңделеді, өйткені жеткізушінің шикі қателері кейде сұраныс тақырыптарын сол күйінде қайтарады.
Нетто-тарифтің ағып кетуі шын мәнінде қаншаға түседі
Әзірлеушілер деректердің ағып кетуін олардың қаншалықты жеке екеніне қарай бағалауға бейім. Туристік дистрибуцияда коммерциялық тұрғыдан қауіпті өріс көбіне баға болады. Нетто-тариф — жеткізуші көпшілікке көрсетілмеу шартымен сізге беруге келіскен сома, ал оның сату бағасымен айырмасы — сіздің және субагенттеріңіздің маржасы. Төмендегі кесте — шамамен алынған рейтинг. Өз бизнесіңіз үшін жолдарды басқаша бағалауыңыз мүмкін, бұл дауды командаңызбен инцидент кезінде емес, оған дейін шешкен жөн.
| Не ағып кетеді | Әдетте кім табады | Сізге қаншаға түседі |
|---|---|---|
| B2C іздеу жауабындағы нетто-тариф (экранда емес, JSON ішінде жасырылған) | Скрапинг жасайтын бәсекелестер, әуесқой клиенттер | Жеткізушіден баға паритеті туралы шағымдар және жарияланған бағаны неге төлегенін сұрайтын клиенттер |
| Басқа субагенттің үстемесі немесе нетто-бағасы | Шарттарын салыстыратын субагенттер | Бүкіл желіде баға қайта талқыланады; жақсырақ келісім алған агент басты тақырыпқа айналады |
| Клиенттік бандлдағы жеткізуші тіркелгі деректері | Қараған кез келген адам | Аккаунтыңыздағы трафик пен брондаулар, тексеріс кезінде бұғаттау қаупі |
| Санап шығуға болатын брондау немесе PNR идентификаторлары | Скраперлер, кейде журналистер | Жолаушы деректерінің әшкереленуі, оның реттеуші салмағы коммерциялық шығыннан әлдеқайда ауыр |
| Басқа агенттіктердің кредит лимиттері мен балансы | Серіктестер, бәсекелестер | Желіңіздегі ең әлсіз аккаунттар азғырып әкету нысанасына айналады |
Командалар көбіне бірінші жолды байқамай қалады, өйткені экран дұрыс көрінеді. Бет сату бағасын көрсетеді; оны толтырған жауап нетто мен үстемені бөлек өрістер ретінде тасиды, себебі frontend-ке олар «керек болуы мүмкін». Жауаптарды аудиторияға қарай сервер жағында пішіндеңіз. B2C шақырушы сату бағасын алады және біреуге бірінен бірін алып тастауға мүмкіндік беретін ештеңе алмайды. Субагенттерге нетто-тариф тарату туралы мақала дәл осы айырманың консолидатор сататын нәрсе екенін түсіндіреді.
Тіркелгі деректерін тоқтаусыз ауыстыру
Кез келген тіркелгі деректерін бір күні ауыстыру керек болады. Әзірлеуші серіктес агенттіктен кетеді, кілт ашық репозиторийде пайда болады, жеткізуші өз кестесі бойынша ауыстырады. Егер ауыстыру «өзгерттік — серіктес қайта орналастырғанша бәрі бұзылады» дегенді білдірсе, ешкім ауыстырмайды, ал кілттер жылдар бойы өмір сүреді.
Алғашқы күннен бастап қабаттасуды жобалаңыз. Әр серіктесте бір уақытта екі белсенді кілт болуы мүмкін: ол жаңасын жасайды, орналастырады, трафиктің ауысқанын бақылайды, тек содан кейін ескісін жояды. Бұл жұмыс істеуі үшін платформаға бірнеше көзге түспейтін бөлік керек:
- Кілттің көрінетін идентификаторы — құпияның жанында сақталатын префикс немесе id, — сонда журналдар мен қолдау өтінімдері құпияның өзін ешкім көрмей-ақ қай кілт шақыру жасағанын айта алады.
- Құпиялар хеш ретінде сақталады, жасалған кезде бір рет көрсетіледі және қайтып көрсетілмейді. Егер қолдау командаңыз серіктестің кілтін оқи алса, қолдау құралдарын бұзған кез келген адам да оқи алады.
- Әр кілт үшін соңғы қолданылу уақыты, сонда серіктес ескі кілтті жоймас бұрын оның тынғанын көреді.
- Бірден күшіне енетін кері шақыру, соның ішінде аутентификация алдындағы кез келген кэште де.
Жеткізуші тіркелгі деректеріне де керісінше бағытта дәл сондай қабаттасу керек. Оларды build ішіне тігіп тастамай, жұмыс істеп тұрған сервис қайта оқитын құпиялар қоймасында немесе шифрланған конфигурацияда сақтаңыз — сонда ауыстыру орналастыру емес, конфигурация өзгерісі болады. Ұзақ өмір сүретін кілттердің үстіндегі қысқа мерзімді қатынау токендері де көмектеседі: токен ағып кетсе, көпшілік оның жоғалғанын байқағанша мерзімі бітеді.
Ауыстыру — журналға жазу өзін ақтайтын жер де. Әр шақыруды қай кілт пен қай тенант жасағанын жазу — құпияны да, жолаушының төлем деректерін де жазбай — «бұл біз бе едік?» деген сұраққа бір аптада емес, бір сағатта жауап беруге мүмкіндік береді.
Серіктеске кілт бермес бұрын
Қысқа тізім, өйткені ұзын нұсқасы — осы мақаланың қалған бөлігі:
- Сұраныстағы бірдеңе кілттің тенантын өзгерте ала ма? Өзгертпеуі керек.
- Идентификатор қабылдайтын әр endpoint иелікті тексеріп, тексеру сәтсіз болса 404 қайтара ма?
- Қандай да бір жеткізуші тіркелгі деректері немесе солардан алынған өріс браузерден қолжетімді ме?
- B2C жауабында бір жерде, жасырын өрістерді қоса алғанда, нетто-баға немесе үстеме бар ма?
- Серіктес сізге қоңырау шалмай кілтті ауыстыра ала ма, ал сіз оған қоңырау шалмай жоя аласыз ба?
Біздің API-ға қол жеткізу қалай ұйымдастырылған
Бұл блогтың артындағы платформа авиабилеттер мен қонақүйлерге арналған API ұсынады. Ондағы әр тенант өз әкімшілік панелімен, өз брондауларымен және рөлге негізделген қызметкер рұқсаттарымен жұмыс істейді, ал жеткізуші контенті тенантқа бірге-бір келісімдер арқылы емес, жеткізуші топтары арқылы жетеді. API-ға қол жеткізу өзіне-өзі қызмет көрсететін кілттен емес, әңгімеден басталады, ішінара жоғарыдағы себептерге байланысты: тіркелгі деректері пайда болмай тұрып, кім және қай нарық үшін интеграция жасап жатқанын білгенді жөн көреміз. Travel API беті не қолжетімді екенін және бұл әңгіменің қалай басталатынын сипаттайды.