Siirry sisältöön
Blogi

Matka-API:n tunnistautuminen ja tietoturva: mistä tiedot vuotavat

Tekravelin toimitus
Kirjoitettu tekoälyn avulla

Yhden kumppanitoimistonne kehittäjä testaa integraatiotaan tiistai-iltapäivänä. Hän huomaa, että varauslistan endpoint ottaa query stringissä parametrin agencyId, ja vaihtaa sen uteliaisuuttaan arvosta 114 arvoon 115. Vastaus palauttaa jonkun toisen varaukset: matkustajien nimet, PNR:t ja nettohinnan, jonka toimisto maksoi ennen omaa katettaan. Kukaan ei hyökännyt mihinkään. API yksinkertaisesti uskoi sen, mitä asiakasohjelma sille kertoi. Tuo yksi iltapäivä tiivistää suurimman osan siitä, mistä matka-API:n tunnistautumisessa ja tietoturvassa todella on kyse, ja selittää, miksi aihe ansaitsee enemmän huolta kuin kirjautumisruutu yleensä saa.

Multi-tenant matka-API:t vuotavat muutamalla ennustettavalla tavalla. Ne kannattaa käydä läpi yksi kerrallaan, koska jokaiseen on suunnitteluratkaisu, joka maksaa ennen julkaisua paljon vähemmän kuin sen jälkeen.

Tenantti ei ole parametri

Esimerkin virhe ei ole puuttuva tarkistus. Se on suunnittelu, joka kysyy kutsujalta, kuka se on, ja sitten luottaa vastaukseen. Yhden tenantin järjestelmässä se on vain epäsiistiä. Alustalla, jossa kymmenet toimistot, alaagentit ja white-label-sivustot jakavat saman tietokannan, koko tietoturvamalli nojaa silloin jokaisen avaimen koskaan saavan integraattorin rehellisyyteen.

Sääntö, joka poistaa koko virheluokan: tenantti tulee tunnisteesta, ei koskaan pyynnöstä. Kun avain tai token tarkistetaan, palvelin selvittää, mille tenantille se kuuluu, mikä toimipiste tenantin sisällä on kyseessä ja mitkä roolit kutsujalla on. Siitä eteenpäin jokainen kysely ajetaan tämän rajauksen sisällä. Pyynnön runko voi yhä sisältää toimiston tunnisteen oikeutetusta syystä — esimerkiksi konsolidaattori luo varauksen yhden alaagenttinsa puolesta — mutta palvelin tarkistaa tunnisteen sitä rajausta vasten, jonka tunniste on jo määrittänyt. Se ei koskaan laajenna rajausta siksi, että jokin kenttä pyysi.

Käytännössä kolme asiaa kuuluu palvelimen puolelle:

  • Rajaus datakerroksessa, ei jokaisessa handlerissa. Suodatin, joka lisätään automaattisesti jokaiseen tenantin taulujen kyselyyn, tarkoittaa, että where-ehdon unohtava kehittäjä saa tyhjän tuloksen eikä jonkun toisen tietoja. Handler kerrallaan tehdyt tarkistukset pettävät ensimmäisen kerran, kun joku lisää endpointin kiireessä.
  • Oliotason tarkistus jokaiselle polun tunnisteelle. GET /bookings/98231 on varmistettava, että varaus 98231 kuuluu kutsujan rajaukseen. Juoksevat tunnisteet tekevät tästä matka-API:en yleisimmän aukon, koska varausnumerot ja PNR-viitteet on helppo arvata.
  • Sama vastaus tilanteisiin ”ei sinun” ja ”ei ole olemassa”. Palauta 404 toisen tenantin varauksesta. Vastaus 403 vahvistaa, että tietue on olemassa, ja jo se on tietoa, jonka kilpailija mielellään saisi.

Takaovet vaativat samaa kurinalaisuutta. Useimmat alustat tarvitsevat ylläpitäjän näkymän, joka lukee tenanttien yli — tuki, talous, alustan omistaja. Tee siitä erillinen rooli, joka myönnetään koodissa ja kirjataan lokiin käytettäessä, älä kyselyn lippua, jonka kuka tahansa tunnistautunut kutsuja voi asettaa. Sitä, miten asiakasintegraation pitäisi toimia näiden rajojen ympärillä, käsittelee pyyntöjen puolelta artikkeli lentovarausten API-integraatiosta.

Toimittajien tunnisteet eivät koskaan päädy selaimeen

Matka-alusta säilyttää kahdenlaisia salaisuuksia. Ensimmäiset ovat omianne: kumppaneille myöntämänne avaimet. Toiset liittyvät suhteeseenne toimittajiin — GDS-toimiston tunnukset, NDC-aggregaattorien tokenit, bedbankien API-avaimet, usein sidottuina sopimukseen, jossa mainitaan yrityksenne ja IATA-numeronne. Toimittajan silmissä jokainen niillä tehty pyyntö on teidän pyyntönne.

Näillä tunnisteilla on täsmälleen yksi turvallinen koti: palvelinprosessi, joka puhuu toimittajan kanssa kutsujan puolesta. Ne eivät kuulu single-page-sovelluksen JavaScript-bundleen, mobiilisovelluksen binääriin, selaimelle tarjoiltuun asetustiedostoon ”vain hakusivua varten” eivätkä virheilmoitukseen, joka palautetaan toimittajakutsun epäonnistuessa. Jokainen näistä on jossain ollut vuodon lähde. Kuka tahansa voi avata verkkovälilehden, ja sovelluksen binäärin voi purkaa kuka tahansa, joka haluaa.

Seuraukset ovat pahempia kuin lasku. Vuotanut toimittaja-avain antaa vieraan hakea ja joskus varata teidän tilillänne — se polttaa look-to-book-suhdetta, jolla toimittaja teitä mittaa, ja pahimmassa tapauksessa kirjoittaa lippuja teidän luotollanne. Toimittaja ei erota sitä liikennettä omastanne. Tavallinen lopputulos on jäädytetty tili siksi aikaa, kun todistatte, ettette se ollut te, mikä pääasiassa yhtä lentoyhtiötä tai yhtä bedbankia myyvälle toimistolle tarkoittaa suljettua kauppaa koko ajaksi.

Tästä seuraa kaksi pienempää sääntöä. Asiakasohjelma ei koskaan valitse, minkä toimittajatilin kautta pyyntö kulkee; palvelin valitsee sen tenantin asetuksista. Ja toimittajien virheviestit käännetään ennen kuin ne lähtevät API:stanne, koska toimittajien raa'at virheet toistavat joskus pyynnön otsakkeet sellaisenaan takaisin.

Mitä vuotanut nettohinta todella maksaa

Kehittäjät järjestävät vuodot usein sen mukaan, kuinka henkilökohtaista data on. Matkailun jakelussa kaupallisesti vaarallinen kenttä on usein hinta. Nettohinta on luku, jonka toimittaja suostui antamaan teille sillä ehdolla, ettei sitä näytetä yleisölle, ja ero myyntihintaan on teidän ja alaagenttienne kate. Alla oleva taulukko on karkea järjestys. Saatatte painottaa rivejä omassa liiketoiminnassanne toisin, ja siitä kannattaa väitellä tiimin kanssa ennen häiriötä eikä sen aikana.

Mikä vuotaaKuka sen yleensä löytääMitä se teille maksaa
Nettohinta B2C-hakuvastauksessa (piilossa JSONissa, ei ruudulla)Scrapaavat kilpailijat, uteliaat asiakkaatToimittajan rate parity -valitukset ja asiakkaat, jotka kysyvät, miksi he maksoivat julkaistun hinnan
Toisen alaagentin kate tai nettohintaMuistiinpanoja vertailevat alaagentitHinnoittelu avautuu koko verkostossa; paremman diilin saanut agentti nousee puheenaiheeksi
Toimittajan tunnisteet asiakasohjelman bundlessaKuka tahansa, joka katsooLiikennettä ja varauksia tilillenne, mahdollinen jäädytys selvityksen ajaksi
Lueteltavissa olevat varaus- tai PNR-tunnisteetScraperit, joskus toimittajatMatkustajatietojen paljastuminen, jolla on sääntelyllistä painoa kaukana kaupallisen menetyksen yli
Muiden toimistojen luottorajat ja saldotKumppanit, kilpailijatVerkostonne heikoimmista tileistä tulee houkuttelun kohteita

Ensimmäinen rivi on se, jonka tiimit ohittavat, koska ruutu näyttää oikealta. Sivu näyttää myyntihinnan; sen syöttänyt vastaus kantaa nettohinnan ja katteen erillisinä kenttinä, koska frontend ”saattaa tarvita niitä”. Muotoile vastaukset palvelimella kohdeyleisön mukaan. B2C-kutsuja saa myyntihinnan eikä mitään, mistä joku voisi laskea erotuksen. Artikkeli nettohintojen jakelusta alaagenteille selittää, miksi juuri tuo ero on se, mitä konsolidaattori myy.

Tunnisteiden kierto ilman katkoa

Jokainen tunniste on jossain vaiheessa vaihdettava. Kehittäjä lähtee kumppanitoimistosta, avain löytyy julkisesta repositorysta, toimittaja kierrättää omassa aikataulussaan. Jos kierto tarkoittaa ”vaihda se, ja kaikki on rikki, kunnes kumppani julkaisee uudelleen”, kukaan ei kierrätä ja avaimet elävät vuosia.

Suunnittele päällekkäisyys ensimmäisestä päivästä. Jokaisella kumppanilla voi olla kaksi aktiivista avainta yhtä aikaa: se luo uuden, ottaa sen käyttöön, seuraa liikenteen siirtymistä ja vasta sitten mitätöi vanhan. Jotta tämä toimii, alusta tarvitsee muutaman vaatimattoman osan:

  1. Näkyvä avaintunniste — etuliite tai tunniste, joka tallennetaan salaisuuden viereen — jotta lokit ja tukipyynnöt voivat kertoa, mikä avain kutsun teki, ilman että kukaan näkee itse salaisuutta.
  2. Salaisuudet tallennettuina tiivisteinä, näytettyinä kerran luonnin yhteydessä eikä koskaan uudelleen. Jos tukitiiminne voi lukea kumppanin avaimen, voi myös jokainen, joka murtautuu tukityökaluihinne.
  3. Viimeisimmän käytön aikaleima avainkohtaisesti, jotta kumppani näkee vanhan hiljenneen ennen sen mitätöintiä.
  4. Välittömästi voimaan tuleva mitätöinti, myös tunnistautumisen edessä olevassa välimuistissa.

Toimittajien tunnisteet tarvitsevat saman päällekkäisyyden toiseen suuntaan. Säilytä ne secrets storessa tai salatussa asetuksessa, jonka käynnissä oleva palvelu lukee uudelleen, äläkä leivo niitä buildiin, jotta vaihto on asetusmuutos eikä julkaisu. Lyhytikäiset access tokenit pitkäikäisten avainten päällä auttavat myös: jos token vuotaa, se vanhenee ennen kuin useimmat edes huomaisivat sen kadonneen.

Kierrossa myös lokitus maksaa itsensä takaisin. Kun kirjataan, mikä avain ja mikä tenantti kunkin kutsun teki — kirjaamatta salaisuutta tai matkustajan maksutietoja — voitte vastata kysymykseen ”olimmeko se me?” tunnissa viikon sijaan.

Ennen kuin annat kumppanille avaimen

Lyhyt lista, koska pitkä versio on tämän artikkelin loppuosa:

  • Voiko mikään pyynnössä muuttaa avaimen tenanttia? Ei pitäisi.
  • Tarkistaako jokainen tunnisteen ottava endpoint omistajuuden ja vastaa 404, kun tarkistus epäonnistuu?
  • Onko mikään toimittajan tunniste, tai siitä johdettu kenttä, saavutettavissa selaimesta?
  • Sisältääkö jokin B2C-vastaus nettohinnan tai katteen missään, piilokentät mukaan lukien?
  • Voiko kumppani kierrättää soittamatta teille, ja voitteko mitätöidä soittamatta heille?

Miten pääsy API:imme hoidetaan

Tämän blogin taustalla oleva alusta tarjoaa API:t lennoille ja hotelleille. Jokainen sen tenantti toimii jo omalla hallintapaneelillaan, omilla varauksillaan ja roolipohjaisilla henkilöstöoikeuksilla, ja toimittajien sisältö tulee tenantille toimittajaryhmien kautta eikä kahdenvälisillä sopimuksilla. Pääsy API:in alkaa keskustelusta eikä itsepalveluavaimesta, osin yllä mainituista syistä: haluamme mieluummin tietää, kuka integroi ja mille markkinalle, ennen kuin tunnistetta on olemassa. Sivu matka-API:t kertoo, mitä on saatavilla ja miten keskustelu alkaa.

Tekravelin toimitus

Matkailuteknologian osasto

Tekravelin matkailuteknologian osasto kirjoittaa alalle: toimistojen omistajille, konsolidaattoreille ja heitä integroiville kehittäjille. Jokainen juttu tarkistetaan kuvatulla alustalla ennen julkaisua.