Bezpečnosť cestovného API: kde unikajú dáta tenantov

Vývojár v jednej z vašich partnerských agentúr testuje v utorok popoludní svoju integráciu. Všimne si, že endpoint so zoznamom rezervácií berie v query stringu agencyId, a zo zvedavosti ho prepíše zo 114 na 115. Odpoveď príde s cudzími rezerváciami: mená cestujúcich, PNR a netto tarifa, ktorú agentúra zaplatila pred pripočítaním marže. Nikto nič nenapadol. API jednoducho uverilo tomu, čo mu klient povedal. Toto jedno popoludnie je takmer celý príbeh autentifikácie a bezpečnosti cestovného API a dôvod, prečo si téma zaslúži viac pozornosti, než sa jej zvyčajne dostane na prihlasovacej obrazovke.
Multi-tenant cestovné API unikajú malým počtom predvídateľných spôsobov. Oplatí sa pomenovať ich jeden po druhom, lebo každý má návrhovú odpoveď, ktorá pred spustením stojí oveľa menej než po ňom.
Tenant nie je parameter
Chyba z úvodu nie je chýbajúca kontrola. Je to návrh, ktorý sa volajúceho opýta, kto je, a potom odpovedi uverí. V systéme s jedným klientom je to len neporiadok. Na platforme, kde desiatky agentúr, subagentov a white-label stránok zdieľajú jednu databázu, stojí celý bezpečnostný model na poctivosti každého integrátora, ktorý niekedy dostane kľúč.
Pravidlo, ktoré odstráni celú triedu chýb: tenant pochádza z poverenia, nikdy nie z požiadavky. Keď sa kľúč alebo token overí, server zistí, ku ktorému tenantovi patrí, ku ktorej pobočke v rámci tenanta a aké roly volajúci má. Odtiaľ každý dotaz beží v tomto rozsahu. Telo požiadavky môže z legitímnych dôvodov stále niesť ID agentúry, napríklad keď konsolidátor vytvára rezerváciu v mene svojho subagenta, ale server toto ID porovná s rozsahom, ktorý poverenie už určilo. Rozsah nikdy nerozšíri len preto, že to nejaké pole žiada.
V praxi na strane servera žijú tri veci:
- Scoping na dátovej vrstve, nie v každom handleri. Filter aplikovaný automaticky na každý dotaz nad tabuľkami vlastnenými tenantom znamená, že vývojár, ktorý zabudne na
where, dostane prázdny výsledok, nie cudzie dáta. Kontroly po handleroch zlyhajú pri prvom endpointe pridanom v zhone. - Kontrola na úrovni objektu pri každom ID v ceste.
GET /bookings/98231musí potvrdiť, že rezervácia 98231 patrí do rozsahu volajúceho. Pri sekvenčných ID je to najčastejšia diera v cestovných API, pretože čísla rezervácií a PNR sa dajú ľahko uhádnuť. - Rovnaká odpoveď na „nie je vaše" aj „neexistuje". Pri rezervácii iného tenanta vráťte 404. Kód 403 potvrdzuje, že záznam existuje, a už to je informácia, ktorú by konkurent rád mal.
Núdzové východy si žiadajú rovnakú disciplínu. Väčšina platforiem potrebuje operátorský pohľad čítajúci naprieč tenantmi: podpora, financie, vlastník platformy. Urobte z neho samostatnú rolu, pridelenú v kóde a zaznamenávanú pri každom použití, nie príznak v dotaze, ktorý môže nastaviť ľubovoľný prihlásený volajúci. O tom, ako sa má klientska integrácia správať okolo týchto hraníc, sa dočítate v texte o integrácii API na rezerváciu leteniek, ktorý pokrýva stranu požiadavky.
Poverenia dodávateľov sa nikdy nedostanú do prehliadača
Cestovná platforma drží dva druhy tajomstiev. Prvé sú vaše: kľúče, ktoré vydávate partnerom. Druhé patria vášmu vzťahu s dodávateľmi: GDS poverenia kancelárie, tokeny NDC agregátorov, API kľúče bedbánk, často viazané na zmluvu, ktorá uvádza vašu firmu a vaše číslo IATA. Každá požiadavka s nimi je z pohľadu dodávateľa požiadavkou od vás.
Tieto poverenia majú jediné bezpečné miesto: serverový proces, ktorý hovorí s dodávateľom v mene volajúceho. Nepatria do JavaScriptového bundlu single-page aplikácie, do binárky mobilnej aplikácie, do konfiguračného súboru poslaného prehliadaču „len pre stránku vyhľadávania", ani do chybovej správy vrátenej pri zlyhaní volania dodávateľa. Každé z týchto miest bolo niekde zdrojom úniku. Kartu Network otvorí hocikto a binárku aplikácie rozbalí každý, kto chce.
Dôsledky sú horšie než účet. Uniknutý kľúč dodávateľa umožní cudzincovi vyhľadávať, niekedy aj rezervovať na váš účet: míňa sa look-to-book pomer, podľa ktorého vás dodávateľ meria, a v zlom prípade sa vystavuje na váš kredit. Dodávateľ túto prevádzku od vašej nerozlíši. Obvyklý výsledok je pozastavený účet, kým dokazujete, že ste to neboli vy, čo pre agentúru predávajúcu hlavne jedného dopravcu alebo jednu bedbanku znamená zatvorený obchod po celý ten čas.
Z toho plynú dve menšie pravidlá. Klient si nikdy nevyberá, cez ktorý účet dodávateľa požiadavka pôjde; server ho vyberie z konfigurácie tenanta. A telá chýb dodávateľov sa prekladajú, kým opustia vaše API, pretože surové chyby dodávateľov niekedy vracajú hlavičky požiadavky doslovne.
Koľko skutočne stojí uniknutá netto tarifa
Vývojári radia úniky dát podľa toho, aké osobné údaje sú. V cestovnej distribúcii je komerčne najnebezpečnejším poľom často cena. Netto tarifa alebo netto sadzba je suma, ktorú vám dodávateľ prisľúbil pod podmienkou, že sa neukáže verejnosti, a rozdiel oproti predajnej cene je vaša marža a marža vašich subagentov. Tabuľka nižšie je hrubé poradie. Riadky môžete pre svoj biznis vážiť inak a o tom nesúhlase sa oplatí hovoriť s tímom pred incidentom, nie počas neho.
| Čo uniká | Kto to zvyčajne nájde | Čo vás to stojí |
|---|---|---|
| Netto tarifa v odpovedi B2C vyhľadávania (skrytá v JSON, nie na obrazovke) | Konkurenti, ktorí scrapujú, zvedaví zákazníci | Sťažnosti dodávateľa na paritu cien a zákazníci, ktorí sa pýtajú, prečo zaplatili zverejnenú cenu |
| Marža alebo netto cena iného subagenta | Subagenti porovnávajúci podmienky | Ceny sa otvárajú v celej sieti; agent s lepšou dohodou sa stane témou rozhovorov |
| Poverenia dodávateľa v klientskom bundli | Ktokoľvek, kto sa pozrie | Prevádzka a rezervácie na vašom účte, možné pozastavenie počas vyšetrovania |
| ID rezervácií alebo PNR, ktoré sa dajú vymenovať | Scrapery, občas novinári | Odhalenie údajov o cestujúcich, čo má regulačnú váhu ďaleko presahujúcu komerčnú stratu |
| Kreditné limity a zostatky iných agentúr | Partneri, konkurenti | Najslabšie účty vašej siete sa stanú cieľom pre preberanie |
Prvý riadok tímy prehliadnu, lebo obrazovka vyzerá správne. Stránka ukazuje predajnú cenu; odpoveď, ktorá ju napájala, nesie netto aj maržu v samostatných poliach, lebo ich frontend „môže potrebovať". Tvarujte odpovede podľa publika, na serveri. B2C volajúci dostane predajnú cenu a nič, čo by umožnilo odpočítanie. Text o tom, ako distribuovať netto tarify subagentom, vysvetľuje, prečo je práve tento rozdiel tým, čo konsolidátor predáva.
Rotácia poverení bez výpadku
Každé poverenie bude treba raz vymeniť. Vývojár odíde z partnerskej agentúry, kľúč sa objaví vo verejnom repozitári, dodávateľ rotuje svoje podľa vlastného kalendára. Ak rotácia znamená „vymeň a všetko sa rozbije, kým partner nenasadí novú verziu", nikto nerotuje a kľúče žijú roky.
Navrhnite prekrytie od prvého dňa. Každý partner môže mať naraz dva aktívne kľúče: vytvorí nový, nasadí ho, sleduje, ako sa na neho presúva prevádzka, a až potom zruší starý. Aby to fungovalo, platforma potrebuje pár nenápadných súčastí:
- Viditeľný identifikátor kľúča, prefix alebo ID uložené vedľa tajomstva, aby logy a tikety podpory vedeli povedať, ktorý kľúč volanie urobil, bez toho, aby niekto videl samotné tajomstvo.
- Tajomstvá uložené ako hashe, zobrazené raz pri vytvorení a nikdy viac. Ak vaša podpora vie prečítať partnerov kľúč, vie to aj každý, kto napadne vaše nástroje podpory.
- Časová pečiatka posledného použitia pri každom kľúči, aby partner videl, že starý stíchol, skôr než ho zruší.
- Zrušenie s okamžitou platnosťou, vrátane každej cache pred autentifikáciou.
Poverenia dodávateľov potrebujú rovnaké prekrytie opačným smerom. Držte ich v úložisku tajomstiev alebo šifrovanej konfigurácii, ktorú bežiaca služba znova číta, nie zapečené v builde, aby prepnutie bola zmena konfigurácie, nie nasadenie. Pomáhajú aj krátkodobé prístupové tokeny nad dlhodobými kľúčmi: ak token unikne, vyprší skôr, než si väčšina ľudí všimne, že zmizol.
Rotácia je aj miesto, kde sa logovanie vypláca. Zaznamenávanie, ktorý kľúč a ktorý tenant urobil každé volanie, bez zaznamenávania tajomstva alebo platobných údajov cestujúceho, umožňuje odpovedať na otázku „boli sme to my?" za hodinu namiesto týždňa.
Skôr než partnerovi odovzdáte kľúč
Krátky zoznam, lebo dlhá verzia je zvyšok tohto textu:
- Dokáže niečo v požiadavke zmeniť tenanta kľúča? Nemalo by.
- Kontroluje každý endpoint, ktorý berie ID, vlastníctvo, a odpovedá 404, keď kontrola zlyhá?
- Je akékoľvek poverenie dodávateľa, alebo pole z neho odvodené, dosiahnuteľné z prehliadača?
- Obsahuje B2C odpoveď niekde netto cenu alebo maržu, vrátane skrytých polí?
- Môže partner rotovať bez volania vám a môžete vy zrušiť bez volania jemu?
Ako riešime prístup k nášmu API
Platforma za týmto blogom ponúka API na lety a hotely. Každý tenant na nej už funguje s vlastným administračným panelom, vlastnými rezerváciami a oprávneniami zamestnancov založenými na rolách a obsah dodávateľov sa k tenantovi dostáva cez skupiny dodávateľov, nie dohodami jeden na jedného. Prístup k API sa začína rozhovorom, nie samoobslužným kľúčom, čiastočne z vyššie uvedených dôvodov: radšej vieme, kto integruje a pre aký trh, skôr než poverenie vôbec vznikne. Stránka o cestovných API popisuje, čo je dostupné a ako sa tento rozhovor začína.