Ruka hadi maudhui
Blogu

Usalama wa API ya usafiri: data za tenant zinavuja wapi

Wahariri wa Tekravel
Imeandikwa kwa msaada wa AI

Msanidi programu katika wakala mmoja mshirika wako anajaribu muunganisho wake Jumanne alasiri. Anaona kwamba endpoint ya orodha ya nafasi zilizohifadhiwa inapokea agencyId kwenye query string, na kwa udadisi anaibadilisha kutoka 114 hadi 115. Jibu linarudi na nafasi za mtu mwingine: majina ya abiria, PNR, na nauli ya net ambayo wakala huyo alilipa kabla ya kuongeza faida yake. Hakuna aliyeshambulia chochote. API ilisadiki tu alichosema mteja. Alasiri hiyo moja ndiyo karibu hadithi nzima ya uthibitishaji na usalama wa API ya usafiri, na ndiyo sababu mada hii inastahili uangalifu zaidi kuliko skrini ya kuingia hupewa kwa kawaida.

API za usafiri za multi-tenant huvuja kwa njia chache zinazotabirika. Inafaa kuzitaja moja baada ya nyingine, kwa sababu kila moja ina jibu la usanifu linalogharimu kidogo zaidi kabla ya uzinduzi kuliko baada yake.

Tenant si kigezo

Kosa la utangulizi si ukaguzi uliosahaulika. Ni usanifu unaomuuliza mpigaji yeye ni nani kisha unaamini jibu. Kwenye mfumo wa mteja mmoja hilo ni uzembe tu. Kwenye jukwaa ambapo makumi ya mawakala, mawakala wadogo na tovuti za white-label hushiriki hifadhidata moja, mfumo mzima wa usalama unategemea uaminifu wa kila mwunganishaji atakayewahi kushika ufunguo.

Kanuni inayoondoa aina nzima ya hitilafu hii: tenant hutoka kwenye kitambulisho, kamwe si kwenye ombi. Ufunguo au tokeni inapothibitishwa, seva huamua ni tenant gani inamilikiwa nayo, ofisi ipi ndani ya tenant hiyo, na majukumu gani mpigaji anayo. Kuanzia hapo kila swali (query) hufanya kazi ndani ya wigo huo. Mwili wa ombi bado unaweza kubeba kitambulisho cha wakala kwa sababu halali, kwa mfano consolidator anayeunda nafasi kwa niaba ya mmoja wa mawakala wake wadogo, lakini seva hukagua kitambulisho hicho dhidi ya wigo ambao kitambulisho cha uthibitisho tayari kimeuweka. Haipanui wigo kwa sababu tu uga fulani umeomba.

Kwa vitendo, mambo matatu yanakaa upande wa seva:

  • Scoping kwenye tabaka la data, si kwenye kila handler. Kichujio kinachotumika kiotomatiki kwenye kila query ya majedwali yanayomilikiwa na tenant humaanisha msanidi anayesahau kifungu cha where anapata matokeo tupu, si data za mtu mwingine. Ukaguzi wa handler kwa handler huvunjika mara ya kwanza mtu anapoongeza endpoint kwa haraka.
  • Ukaguzi wa ngazi ya kitu kwa kila ID kwenye njia. GET /bookings/98231 lazima ithibitishe kwamba nafasi 98231 iko ndani ya wigo wa mpigaji. ID zinazofuatana hufanya hili kuwa tundu la kawaida zaidi kwenye API za usafiri, kwa sababu namba za nafasi na marejeo ya PNR ni rahisi kubahatisha.
  • Jibu lilelile kwa "si yako" na "haipo". Rudisha 404 kwa nafasi ya tenant mwingine. Msimbo wa 403 unathibitisha kwamba rekodi ipo, na hilo pekee ni taarifa ambayo mshindani angependa kuipata.

Milango ya dharura nayo inahitaji nidhamu ileile. Majukwaa mengi yanahitaji mwonekano wa mwendeshaji unaosoma kote kwenye tenant: msaada kwa wateja, fedha, mmiliki wa jukwaa. Ifanye iwe jukumu tofauti, linalotolewa kwenye msimbo na kurekodiwa kila linapotumika, si bendera ya query ambayo mpigaji yeyote aliyethibitishwa anaweza kuiweka. Kuhusu jinsi muunganisho wa upande wa mteja unavyopaswa kuenenda kuzunguka mipaka hii, makala kuhusu kuunganisha API ya kuhifadhi tiketi za ndege inaeleza upande wa ombi.

Vitambulisho vya wasambazaji havifiki kamwe kwenye kivinjari

Jukwaa la usafiri linashikilia aina mbili za siri. Ya kwanza ni yako: funguo unazowapa washirika. Ya pili inatokana na uhusiano wako na wasambazaji: vitambulisho vya ofisi ya GDS, tokeni za wakusanyaji wa NDC, funguo za API za bedbank, mara nyingi zimefungwa na mkataba unaotaja kampuni yako na namba yako ya IATA. Kila ombi linalofanywa kwa vitambulisho hivyo, kwa mtazamo wa msambazaji, ni ombi kutoka kwako.

Vitambulisho hivyo vina mahali pamoja tu salama: mchakato wa seva unaozungumza na msambazaji kwa niaba ya mpigaji. Havipaswi kuwa ndani ya bundle ya JavaScript ya programu ya ukurasa mmoja, ndani ya faili ya binary ya programu ya simu, ndani ya faili ya usanidi inayotumwa kwa kivinjari "kwa ajili ya ukurasa wa utafutaji tu", wala ndani ya ujumbe wa hitilafu unaorudishwa simu ya msambazaji inaposhindwa. Kila mojawapo ya maeneo hayo limekuwa chanzo cha uvujaji mahali fulani. Mtu yeyote anaweza kufungua kichupo cha network, na binary ya programu inaweza kufunguliwa na yeyote anayetaka.

Madhara ni mabaya kuliko ankara. Ufunguo wa msambazaji uliovuja unamruhusu mgeni kutafuta, na wakati mwingine kuhifadhi nafasi, kupitia akaunti yako: uwiano wa look-to-book anaokupimia msambazaji unateketea, na katika hali mbaya tiketi hutolewa kwa mkopo wako. Msambazaji hatatofautisha trafiki hiyo na yako. Matokeo ya kawaida ni akaunti kusimamishwa wakati unathibitisha kwamba haikuwa wewe, na kwa wakala anayeuza hasa shirika moja la ndege au bedbank moja, hiyo ni kufunga duka kwa muda wote huo.

Kanuni mbili ndogo zinafuata. Mteja hachagui kamwe ombi lipitie akaunti gani ya msambazaji; seva huchagua kutoka kwenye usanidi wa tenant. Na miili ya hitilafu za wasambazaji hubadilishwa kabla ya kutoka kwenye API yako, kwa sababu hitilafu ghafi za wasambazaji wakati mwingine hurudisha vichwa vya ombi kama vilivyo.

Nauli ya net iliyovuja inagharimu kiasi gani hasa

Wasanidi huwa na mazoea ya kupanga uvujaji wa data kulingana na jinsi data ilivyo ya kibinafsi. Katika usambazaji wa usafiri, uga hatari zaidi kibiashara mara nyingi ni bei. Nauli ya net ni kiasi ambacho msambazaji wako alikubali kukupa kwa sharti kwamba kisionyeshwe kwa umma, na pengo kati yake na bei ya kuuza ni faida yako na faida ya mawakala wako wadogo. Jedwali lililo hapa chini ni mpangilio wa makadirio. Unaweza kupima safu kwa uzito tofauti kwa biashara yako, na tofauti hiyo ya maoni inafaa kujadiliwa na timu kabla ya tukio, si wakati wake.

KinachovujaNani huligundua kwa kawaidaKinakugharimu nini
Nauli ya net ndani ya jibu la utafutaji la B2C (imefichwa kwenye JSON, haionekani kwenye skrini)Washindani wanaofyonza data, wateja wadadisiMalalamiko ya msambazaji kuhusu usawa wa bei, na wateja wanaouliza kwa nini walilipa bei iliyochapishwa
Faida au bei ya net ya wakala mdogo mwingineMawakala wadogo wanaolinganisha maelezoBei zinafunguliwa upya katika mtandao mzima; wakala aliyepata makubaliano bora anakuwa gumzo
Vitambulisho vya msambazaji ndani ya bundle ya mtejaYeyote anayeangaliaTrafiki na nafasi kwenye akaunti yako, uwezekano wa kusimamishwa wakati wa uchunguzi
ID za nafasi au PNR zinazoweza kuorodheshwaWafyonza data, mara kwa mara waandishi wa habariKufichuliwa kwa data za abiria, ambacho kina uzito wa kisheria unaozidi sana hasara ya kibiashara
Viwango vya mkopo na salio za mawakala wengineWashirika, washindaniAkaunti dhaifu zaidi za mtandao wako zinakuwa lengo la kuvutwa

Safu ya kwanza ndiyo timu huikosa, kwa sababu skrini inaonekana sahihi. Ukurasa unaonyesha bei ya kuuza; jibu lililoulisha lina net na faida kama nyuga tofauti kwa sababu frontend "huenda ikahitaji". Umbiza majibu kulingana na hadhira, kwenye seva. Mpigaji wa B2C anapata bei ya kuuza na hakuna chochote kinachomruhusu mtu kutoa. Makala kuhusu kusambaza nauli za net kwa mawakala wadogo inaeleza kwa nini pengo hilo ndilo kitu ambacho consolidator huuza.

Kubadilisha vitambulisho bila kusimama kwa huduma

Kila kitambulisho kitahitaji kubadilishwa siku moja. Msanidi anaondoka kwenye wakala mshirika, ufunguo unaonekana kwenye hazina ya umma, msambazaji anabadilisha funguo zake kwa ratiba yake mwenyewe. Ikiwa kubadilisha kunamaanisha "badilisha na kila kitu kivunjike hadi mshirika afanye redeploy", hakuna atakayebadilisha, na funguo zitaishi miaka mingi.

Sanifu kwa kuingiliana tangu siku ya kwanza. Kila mshirika anaweza kushikilia funguo mbili amilifu kwa wakati mmoja: anaunda mpya, anaifanyia deploy, anatazama trafiki ikihama, na ndipo tu anafuta ya zamani. Ili hilo lifanye kazi, jukwaa linahitaji vipande vichache visivyo na mvuto:

  1. Kitambulisho cha ufunguo kinachoonekana, kiambishi awali au ID iliyohifadhiwa kando ya siri, ili kumbukumbu na tiketi za msaada ziweze kusema ufunguo gani ulipiga simu bila mtu yeyote kuona siri yenyewe.
  2. Siri zilizohifadhiwa kama hash, zinaonyeshwa mara moja wakati wa kuunda na kamwe tena. Ikiwa timu yako ya msaada inaweza kusoma ufunguo wa mshirika, yeyote atakayevamia zana zako za msaada naye anaweza.
  3. Muhuri wa wakati wa matumizi ya mwisho kwa kila ufunguo, ili mshirika aone kwamba wa zamani umenyamaza kabla ya kuufuta.
  4. Ufutaji unaoanza kutumika mara moja, ikiwemo kwenye cache yoyote iliyo mbele ya uthibitishaji.

Vitambulisho vya wasambazaji vinahitaji kuingiliana kwa mwelekeo kinyume. Viweke kwenye hifadhi ya siri au usanidi uliosimbwa ambao huduma inayoendeshwa huusoma upya, si vilivyochomekwa ndani ya build, ili kubadilisha kuwe mabadiliko ya usanidi na si deployment. Tokeni fupi za ufikiaji juu ya funguo za muda mrefu pia husaidia: tokeni ikivuja, hukwisha muda kabla watu wengi hawajagundua kwamba imepotea.

Kubadilisha funguo pia ndipo kurekodi kumbukumbu kunapojilipa. Kurekodi ufunguo gani na tenant gani walipiga kila simu, bila kurekodi siri au data za malipo za abiria, kunakuwezesha kujibu "je, ni sisi?" ndani ya saa moja badala ya wiki.

Kabla ya kumkabidhi mshirika ufunguo

Orodha fupi, kwa sababu toleo refu ni sehemu iliyobaki ya makala hii:

  • Je, kuna kitu chochote kwenye ombi kinachoweza kubadilisha tenant ya ufunguo? Haipaswi kuwepo.
  • Je, kila endpoint inayopokea ID hukagua umiliki na kujibu 404 ukaguzi unaposhindwa?
  • Je, kuna kitambulisho chochote cha msambazaji, au uga uliotokana nacho, kinachoweza kufikiwa kutoka kwenye kivinjari?
  • Je, jibu la B2C lina bei ya net au faida mahali popote, ikiwemo nyuga zilizofichwa?
  • Je, mshirika anaweza kubadilisha bila kukupigia simu, na wewe unaweza kufuta bila kumpigia simu?

Jinsi ufikiaji wa API yetu unavyoshughulikiwa

Jukwaa lililo nyuma ya blogu hii linatoa API za ndege na hoteli. Kila tenant juu yake tayari anafanya kazi na paneli yake ya msimamizi, nafasi zake mwenyewe na ruhusa za wafanyakazi zinazotegemea majukumu, na maudhui ya wasambazaji hufika kwa tenant kupitia vikundi vya wasambazaji badala ya makubaliano ya mmoja kwa mmoja. Ufikiaji wa API huanza kwa mazungumzo, si ufunguo wa kujihudumia, kwa sehemu kwa sababu zilizotajwa hapo juu: tunapendelea kujua nani anaunganisha, na kwa soko gani, kabla kitambulisho hakijaundwa. Ukurasa wa API za usafiri unaeleza kinachopatikana na jinsi mazungumzo hayo yanavyoanza.

Wahariri wa Tekravel

Dawati la teknolojia ya safari

Dawati la teknolojia ya safari la Tekravel huandika kwa ajili ya wadau wa sekta: wamiliki wa mawakala, wakusanyaji tiketi, na waendelezaji wanaowaunganisha. Kila makala hukaguliwa dhidi ya jukwaa linaloelezwa kabla ya kuchapishwa.