Hopp til innholdet
Blogg

Autentisering og sikkerhet i reise-API-er: der data lekker

Tekravel Redaksjon
Skrevet med hjelp av AI

En utvikler hos et av partnerbyråene deres tester integrasjonen sin en tirsdag ettermiddag. Utvikleren legger merke til at endepunktet for bestillingslisten tar en agencyId i query-strengen, og bytter den av nysgjerrighet fra 114 til 115. Svaret kommer tilbake med noen andres bestillinger: passasjernavn, PNR-er og nettoprisen byrået betalte før sitt påslag. Ingen angrep noe. API-et trodde bare på det klienten fortalte det. Den ene ettermiddagen rommer det meste av hva autentisering og sikkerhet i et reise-API egentlig handler om, og den viser hvorfor temaet fortjener mer omtanke enn innloggingsskjermen vanligvis får.

Multi-tenant reise-API-er lekker på et lite antall forutsigbare måter. De er verdt å ta én om gangen, fordi hver av dem har et designsvar som koster langt mindre før lansering enn etter.

Tenanten er ikke en parameter

Feilen i eksemplet er ikke en manglende sjekk. Det er et design som spør kalleren hvem den er, og deretter stoler på svaret. I et system med én tenant er det bare rotete. På en plattform der dusinvis av byråer, underagenter og white-label-nettsteder deler én database, hviler da hele sikkerhetsmodellen på ærligheten til hver eneste integrator som noen gang får en nøkkel.

Regelen som fjerner hele den klassen av feil: tenanten kommer fra credentialet, aldri fra forespørselen. Når en nøkkel eller et token verifiseres, avgjør serveren hvilken tenant den tilhører, hvilket kontor i tenanten og hvilke roller kalleren har. Deretter kjører hver spørring innenfor det scopet. En forespørsel kan fortsatt bære en byrå-id av legitime grunner — for eksempel en konsolidator som oppretter en bestilling på vegne av en av underagentene sine — men serveren sjekker id-en mot scopet credentialet allerede har fastsatt. Den utvider aldri scopet fordi et felt ba om det.

I praksis bor tre ting på serversiden:

  • Scoping i datalaget, ikke i hver handler. Et filter som automatisk legges på hver spørring mot tenant-eide tabeller, betyr at en utvikler som glemmer where-klausulen, får et tomt resultat og ikke noen andres data. Sjekker handler for handler svikter første gang noen legger til et endepunkt i en fart.
  • Sjekker på objektnivå for hver id i stien. GET /bookings/98231 må bekrefte at bestilling 98231 hører til kallerens scope. Fortløpende id-er gjør dette til det vanligste hullet i reise-API-er, fordi bestillingsnumre og PNR-referanser er lette å gjette.
  • Samme svar på «ikke din» og «finnes ikke». Returner 404 for en annen tenants bestilling. En 403 bekrefter at posten finnes, og bare det er informasjon en konkurrent gjerne vil ha.

Bakdører krever samme disiplin. De fleste plattformer trenger en operatørvisning som leser på tvers av tenants — support, økonomi, plattformens eier. Gjør den til en egen rolle, tildelt i kode og logget ved bruk, ikke et spørringsflagg som enhver autentisert kaller kan sette. Hvordan en klientintegrasjon bør oppføre seg rundt disse grensene, dekker artikkelen om API-integrasjon for flybestilling fra forespørselssiden.

Leverandørenes credentials når aldri en nettleser

En reiseplattform har to slags hemmeligheter. Den første er deres egen: nøklene dere utsteder til partnere. Den andre hører til forholdet deres til leverandørene — kontorinnlogginger til GDS, tokens fra NDC-aggregatorer, API-nøkler til bedbanker, ofte knyttet til en kontrakt som nevner selskapet deres og IATA-nummeret deres. For leverandøren er hver forespørsel med dem en forespørsel fra dere.

Disse credentialene har nøyaktig ett trygt hjem: en serverprosess som snakker med leverandøren på vegne av kalleren. De hører ikke hjemme i en single-page-apps JavaScript-bundle, i en mobilapps binærfil, i en konfigurasjonsfil sendt til nettleseren «bare for søkesiden» eller i en feilmelding som returneres når leverandørkallet feiler. Hver av dem har vært lekkasjen et sted. Hvem som helst kan åpne nettverksfanen, og en appbinærfil kan pakkes ut av alle som vil.

Konsekvensene er verre enn en regning. En lekket leverandørnøkkel lar en fremmed søke, og noen ganger bestille, på kontoen deres — den brenner look-to-book-forholdet leverandøren måler dere på og, i verste fall, utsteder mot kreditten deres. Leverandøren skiller ikke den trafikken fra deres egen. Det vanlige utfallet er en suspendert konto mens dere beviser at det ikke var dere, noe som for et byrå som hovedsakelig selger ett flyselskap eller én bedbank betyr stengt butikk i mellomtiden.

To mindre regler følger. Klienten velger aldri hvilken leverandørkonto en forespørsel går gjennom; serveren velger den fra tenantens konfigurasjon. Og leverandørenes feilmeldinger oversettes før de forlater API-et deres, fordi rå leverandørfeil av og til gjentar forespørselens headere rett tilbake.

Hva en lekket nettopris faktisk koster

Utviklere har en tendens til å rangere lekkasjer etter hvor personlige dataene er. I reisedistribusjon er det kommersielt farlige feltet ofte prisen. En nettopris eller nettorate er tallet leverandøren gikk med på å gi dere på betingelse av at det ikke vises for offentligheten, og forskjellen til salgsprisen er marginen deres og underagentenes. Tabellen under er en grov rangering. Dere vekter kanskje radene annerledes for deres virksomhet, og den uenigheten er verdt å ta med teamet før en hendelse heller enn under den.

Hva som lekkerHvem som vanligvis finner detHva det koster dere
Nettopris i et B2C-søkesvar (skjult i JSON, ikke på skjermen)Konkurrenter som scraper, nysgjerrige kunderKlager på rate parity fra leverandøren og kunder som spør hvorfor de betalte publisert pris
En annen underagents påslag eller nettoprisUnderagenter som sammenligner notaterPrisingen åpnes på nytt i hele nettverket; agenten med den bedre avtalen blir saken
Leverandør-credentials i en klientbundleAlle som ser etterTrafikk og bestillinger på kontoen deres, mulig suspensjon mens det granskes
Bestillings- eller PNR-id-er som kan telles oppScrapere, av og til journalisterEksponering av passasjerdata, med regulatorisk tyngde langt ut over det kommersielle tapet
Andre byråers kredittgrenser og saldoerPartnere, konkurrenterNettverkets svakeste kontoer blir mål for å bli lokket bort

Den første raden er den team overser, fordi skjermen ser riktig ut. Siden viser salgsprisen; svaret som matet den, bærer netto og påslag som separate felt fordi frontenden «kanskje trenger dem». Form svarene per målgruppe på serveren. En B2C-kaller får en salgspris og ingenting som lar noen trekke fra. Artikkelen om å fordele nettopriser til underagenter forklarer hvorfor nettopp den forskjellen er det en konsolidator selger.

Rotering av credentials uten nedetid

Hvert credential må byttes en gang. En utvikler slutter hos et partnerbyrå, en nøkkel dukker opp i et offentlig repository, en leverandør roterer etter sin egen plan. Hvis rotering betyr «bytt den, og alt er ødelagt til partneren deployer på nytt», roterer ingen, og nøkler lever i årevis.

Design for overlapp fra første dag. Hver partner kan ha to aktive nøkler samtidig: de lager den nye, setter den i drift, ser trafikken flytte over og trekker først da tilbake den gamle. For at det skal fungere, trenger plattformen noen uglamorøse deler:

  1. En synlig nøkkelidentifikator — et prefiks eller en id lagret ved siden av hemmeligheten — slik at logger og supportsaker kan si hvilken nøkkel som gjorde et kall uten at noen ser selve hemmeligheten.
  2. Hemmeligheter lagret som hasher, vist én gang ved opprettelse og aldri igjen. Hvis supportteamet deres kan lese en partners nøkkel, kan også alle som kompromitterer supportverktøyene.
  3. Et tidsstempel for siste bruk per nøkkel, slik at partneren ser at den gamle har blitt stille før den trekkes tilbake.
  4. Tilbaketrekking som gjelder umiddelbart, også i en eventuell cache foran autentiseringen.

Leverandørenes credentials trenger samme overlapp i motsatt retning. Oppbevar dem i en secrets store eller kryptert konfigurasjon som den kjørende tjenesten leser på nytt, ikke bakt inn i et bygg, slik at byttet er en konfigurasjonsendring og ikke en deploy. Kortlivede access tokens oppå langlivede nøkler hjelper også: lekker et token, utløper det før de fleste ville merket at det var borte.

Det er også ved rotering at loggingen betaler seg. Å registrere hvilken nøkkel og hvilken tenant som gjorde hvert kall — uten å registrere hemmeligheten eller passasjerens betalingsdata — er det som lar dere svare på «var det oss?» på en time i stedet for en uke.

Før dere gir en partner en nøkkel

En kort liste, for den lange versjonen er resten av artikkelen:

  • Kan noe i forespørselen endre nøkkelens tenant? Det bør det ikke.
  • Sjekker hvert endepunkt som tar en id, eierskap og svarer 404 når sjekken feiler?
  • Kan noe leverandør-credential, eller et felt avledet av et, nås fra en nettleser?
  • Inneholder et B2C-svar en nettopris eller et påslag noe sted, skjulte felt inkludert?
  • Kan partneren rotere uten å ringe dere, og kan dere trekke tilbake uten å ringe dem?

Slik håndteres tilgangen til API-et vårt

Plattformen bak denne bloggen tilbyr API-er for fly og hotell. Hver tenant på den kjører allerede med sitt eget adminpanel, sine egne bestillinger og rollebaserte tillatelser for ansatte, og leverandørinnhold når en tenant gjennom leverandørgrupper i stedet for én-til-én-avtaler. Tilgang til API-et begynner som en samtale heller enn en selvbetjent nøkkel, delvis av grunnene over: vi vil heller vite hvem som integrerer, og for hvilket marked, før et credential finnes. Siden reise-API-er beskriver hva som er tilgjengelig og hvordan den samtalen begynner.

Tekravel Redaksjon

Desk for reiseteknologi

Tekravels desk for reiseteknologi skriver for bransjen: byråeiere, konsolidatorer og utviklerne som integrerer dem. Hver artikkel kontrolleres mot plattformen den beskriver før den publiseres.