Ugrás a tartalomra
Blog

Utazási API hitelesítés és biztonság: hol szivárognak az adatok

Tekravel Szerkesztőség
Mesterséges intelligencia segítségével írva

Az egyik partnerirodájuk fejlesztője egy kedd délután teszteli az integrációját. Észreveszi, hogy a foglalási lista endpointja a query stringben egy agencyId paramétert vár, és kíváncsiságból 114-ről 115-re írja át. A válasz valaki más foglalásait hozza vissza: utasneveket, PNR-eket és azt a nettó tarifát, amelyet az az iroda a saját árrése előtt fizetett. Senki nem támadott meg semmit. Az API egyszerűen elhitte, amit a kliens mondott neki. Ez az egy délután összefoglalja, miről szól valójában az utazási API hitelesítése és biztonsága, és megmutatja, miért érdemel a téma több figyelmet, mint amennyit a bejelentkezési képernyő általában kap.

A multi-tenant utazási API-k néhány kiszámítható módon szivárognak. Érdemes egyenként végigvenni őket, mert mindegyikre van tervezési válasz, amely indulás előtt sokkal kevesebbe kerül, mint utána.

A tenant nem paraméter

A bevezető hibája nem egy hiányzó ellenőrzés. Hanem egy olyan tervezés, amely megkérdezi a hívótól, kicsoda, majd elhiszi a választ. Egy egytenantos rendszerben ez csak rendetlenség. Egy olyan platformon, ahol tucatnyi iroda, alügynök és white-label oldal osztozik egy adatbázison, a teljes biztonsági modell így minden olyan integrátor becsületességén múlik, aki valaha kulcsot kap.

A szabály, amely a hibák egész osztályát megszünteti: a tenant a hitelesítő adatból jön, soha nem a kérésből. Amikor egy kulcsot vagy tokent ellenőriz, a szerver megállapítja, melyik tenanthez tartozik, azon belül melyik irodához, és milyen szerepkörei vannak a hívónak. Ettől kezdve minden lekérdezés ebben a scope-ban fut. A kérés törzse továbbra is tartalmazhat irodaazonosítót jogos okból — például egy konszolidátor az egyik alügynöke nevében hoz létre foglalást —, de a szerver ezt az azonosítót a hitelesítő adat által már rögzített scope-hoz méri. Soha nem bővíti a scope-ot csak azért, mert egy mező ezt kérte.

A gyakorlatban három dolog él a szerver oldalán:

  • Scoping az adatrétegben, nem minden handlerben. Egy szűrő, amely automatikusan rákerül minden, a tenant tulajdonában lévő táblákra irányuló lekérdezésre, azt jelenti, hogy a where feltételt elfelejtő fejlesztő üres eredményt kap, nem valaki más adatait. A handlerenkénti ellenőrzés elbukik, amikor valaki először ad hozzá sietve egy endpointot.
  • Objektumszintű ellenőrzés az útvonal minden azonosítójára. A GET /bookings/98231 hívásnak meg kell erősítenie, hogy a 98231-es foglalás a hívó scope-jába tartozik. A sorszámozott azonosítók miatt ez az utazási API-k leggyakoribb rése, mert a foglalási számok és a PNR-hivatkozások könnyen kitalálhatók.
  • Ugyanaz a válasz a „nem a tiéd” és a „nem létezik” esetére. Más tenant foglalására adjon 404-et. A 403 megerősíti, hogy a rekord létezik, és már ez önmagában olyan információ, amit egy versenytárs szívesen megszerezne.

A kiskapuk ugyanilyen fegyelmet kívánnak. A legtöbb platformnak szüksége van egy tenantokon átnyúló operátori nézetre — ügyfélszolgálat, pénzügy, a platform tulajdonosa. Ez legyen külön szerepkör, amelyet kódból adnak meg és használatkor naplóznak, ne egy lekérdezési kapcsoló, amelyet bármely hitelesített hívó beállíthat. Arról, hogyan viselkedjen egy kliensintegráció e határok körül, a kérések oldaláról a repülőjegy-foglalási API integrációról szóló cikk ír.

A beszállítói hitelesítő adatok soha nem jutnak el a böngészőig

Egy utazási platform kétféle titkot őriz. Az egyik az önöké: a partnereknek kiadott kulcsok. A másik a beszállítókkal való kapcsolatukhoz tartozik — GDS irodai hozzáférések, NDC aggregátor tokenek, bedbank API-kulcsok, gyakran olyan szerződéshez kötve, amely a cégük nevét és IATA-számát tartalmazza. A beszállító szemében minden ezekkel indított kérés az önök kérése.

Ezeknek a hitelesítő adatoknak pontosan egy biztonságos helyük van: egy szerverfolyamat, amely a hívó nevében beszél a beszállítóval. Nincs helyük egy single-page alkalmazás JavaScript bundle-jében, egy mobilalkalmazás binárisában, a böngészőnek „csak a keresőoldalhoz” kiszolgált konfigurációs fájlban, sem abban a hibaüzenetben, amely a beszállítói hívás sikertelenségekor visszamegy. Mindegyik volt már valahol a szivárgás forrása. A hálózati fület bárki megnyithatja, egy alkalmazás binárisát pedig bárki kicsomagolhatja, aki akarja.

A következmények rosszabbak egy számlánál. Egy kiszivárgott beszállítói kulcs lehetővé teszi, hogy egy idegen keressen, sőt néha foglaljon az önök fiókján — elégetve azt a look-to-book arányt, amellyel a beszállító önöket méri, rosszabb esetben pedig az önök hitelkeretére állítva ki jegyeket. A beszállító ezt a forgalmat nem fogja megkülönböztetni az önökétől. A szokásos vége egy felfüggesztett fiók, amíg bebizonyítják, hogy nem önök voltak, ami egy főként egy légitársaságot vagy egy bedbankot értékesítő iroda számára addig zárva tartott boltot jelent.

Ebből két kisebb szabály következik. A kliens soha nem választja meg, melyik beszállítói fiókon megy át egy kérés; a szerver választja ki a tenant konfigurációjából. A beszállítói hibaüzeneteket pedig le kell fordítani, mielőtt elhagyják az API-t, mert a nyers beszállítói hibák néha egy az egyben visszaküldik a kérés fejléceit.

Mennyibe kerül valójában egy kiszivárgott nettó tarifa

A fejlesztők hajlamosak aszerint rangsorolni a szivárgásokat, mennyire személyesek az adatok. Az utazási disztribúcióban a kereskedelmileg veszélyes mező gyakran az ár. A nettó tarifa vagy nettó ár az a szám, amelyet a beszállító azzal a feltétellel adott önöknek, hogy a nyilvánosság nem láthatja, és az eladási ártól való különbség az önök és alügynökeik árrése. Az alábbi táblázat durva rangsor. Lehet, hogy a saját üzletükben másképp súlyozzák a sorokat, és ezt a vitát érdemes a csapattal egy incidens előtt lefolytatni, nem közben.

Mi szivárog kiKi találja meg általábanMibe kerül önöknek
Nettó tarifa egy B2C keresési válaszban (a JSON-ban elrejtve, nem a képernyőn)Scrapelő versenytársak, kíváncsi ügyfelekRate parity panaszok a beszállítótól, és ügyfelek, akik azt kérdezik, miért fizették a meghirdetett árat
Egy másik alügynök árrése vagy nettó áraJegyzeteiket összevető alügynökökAz árazás az egész hálózatban újranyílik; a jobb feltételeket kapott ügynök lesz a téma
Beszállítói hitelesítő adatok egy kliens bundle-benBárki, aki megnéziForgalom és foglalások az önök fiókján, lehetséges felfüggesztés a vizsgálat idejére
Végigszámolható foglalási vagy PNR-azonosítókScraperek, alkalmanként újságírókUtasadatok kitettsége, amelynek szabályozói súlya jóval túlmutat a kereskedelmi veszteségen
Más irodák hitelkeretei és egyenlegeiPartnerek, versenytársakA hálózat leggyengébb fiókjai elcsábítási célponttá válnak

Az első sort szokták a csapatok elnézni, mert a képernyő helyesnek tűnik. Az oldal az eladási árat mutatja; az őt kiszolgáló válasz viszont külön mezőkben hordozza a nettót és az árrést, mert a frontendnek „talán szüksége lesz rájuk”. A válaszokat a szerveren, közönségenként formálják meg. Egy B2C hívó eladási árat kap, és semmit, amiből bárki kivonást végezhetne. Az alügynököknek szánt nettó tarifákról szóló cikk elmagyarázza, miért éppen ez a különbség az, amit egy konszolidátor árul.

Hitelesítő adatok rotálása leállás nélkül

Minden hitelesítő adatot ki kell majd cserélni. Egy fejlesztő távozik egy partnerirodától, egy kulcs felbukkan egy nyilvános repositoryban, egy beszállító a saját ütemezése szerint rotál. Ha a rotáció azt jelenti, hogy „átírod, és minden elromlik, amíg a partner újra nem telepít”, akkor senki sem rotál, és a kulcsok évekig élnek.

Az első naptól tervezzenek átfedésre. Minden partnernek egyszerre két aktív kulcsa lehet: létrehozza az újat, élesíti, figyeli, ahogy a forgalom átköltözik, és csak ezután vonja vissza a régit. Ahhoz, hogy ez működjön, a platformnak néhány kevéssé látványos elemre van szüksége:

  1. Látható kulcsazonosító — a titok mellett tárolt előtag vagy azonosító —, hogy a naplók és a hibajegyek megmondhassák, melyik kulcs indította a hívást, anélkül hogy bárki látná magát a titkot.
  2. Hashként tárolt titkok, amelyek létrehozáskor egyszer jelennek meg, aztán soha többé. Ha az ügyfélszolgálat el tudja olvasni egy partner kulcsát, akkor bárki, aki feltöri az ügyfélszolgálati eszközöket, szintén.
  3. Utolsó használati időbélyeg kulcsonként, hogy a partner lássa: a régi elcsendesedett, mielőtt visszavonja.
  4. Azonnal hatályos visszavonás, a hitelesítés előtt álló bármely cache-ben is.

A beszállítói hitelesítő adatoknak ugyanilyen átfedés kell, fordított irányban. Tárolják őket secrets store-ban vagy titkosított konfigurációban, amelyet a futó szolgáltatás újraolvas, ne a buildbe sütve, hogy a csere konfigurációmódosítás legyen, ne telepítés. A hosszú életű kulcsok fölötti rövid életű access tokenek is segítenek: ha egy token kiszivárog, lejár, mielőtt a legtöbben észrevennék, hogy eltűnt.

A rotációnál térül meg a naplózás is. Annak rögzítése, hogy melyik kulcs és melyik tenant indította az egyes hívásokat — a titok és az utas fizetési adatainak rögzítése nélkül —, teszi lehetővé, hogy a „mi voltunk?” kérdésre egy óra alatt válaszoljanak, ne egy hét alatt.

Mielőtt kulcsot adnak egy partnernek

Rövid lista, mert a hosszú változat a cikk többi része:

  • Megváltoztathatja-e bármi a kérésben a kulcs tenantját? Nem kellene.
  • Minden azonosítót fogadó endpoint ellenőrzi-e a tulajdonjogot, és 404-et ad-e, ha az ellenőrzés elbukik?
  • Elérhető-e böngészőből bármilyen beszállítói hitelesítő adat vagy abból származtatott mező?
  • Tartalmaz-e bármely B2C válasz nettó árat vagy árrést bárhol, a rejtett mezőket is beleértve?
  • Tud-e a partner rotálni anélkül, hogy felhívná önöket, és tudnak-e önök visszavonni anélkül, hogy őt hívnák?

Hogyan kezeljük az API-nkhoz való hozzáférést

A blog mögötti platform repülőjegy- és szálláshely-API-kat kínál. Minden tenant már most saját adminfelülettel, saját foglalásokkal és szerepköralapú munkatársi jogosultságokkal működik rajta, a beszállítói tartalom pedig beszállítói csoportokon keresztül jut el egy tenanthez, nem egyedi megállapodásokkal. Az API-hozzáférés beszélgetéssel indul, nem önkiszolgáló kulccsal, részben a fenti okok miatt: inkább tudni szeretnénk, ki integrál és melyik piacra, mielőtt egyáltalán létezne hitelesítő adat. Az utazási API-k oldala leírja, mi érhető el, és hogyan indul ez a beszélgetés.

Tekravel Szerkesztőség

Utazástechnológiai rovat

A Tekravel utazástechnológiai rovata a szakmának ír: irodatulajdonosoknak, konszolidátoroknak és az őket integráló fejlesztőknek. Minden cikket a leírt platformon ellenőrzünk a megjelenés előtt.