Autentizace a zabezpečení cestovního API: kudy unikají data

Vývojář jedné z vašich partnerských agentur v úterý odpoledne testuje integraci. Všimne si, že endpoint se seznamem rezervací bere v query stringu agencyId, a ze zvědavosti ho změní ze 114 na 115. Odpověď přinese rezervace někoho jiného: jména cestujících, PNR a netto tarif, který ta agentura zaplatila před svou přirážkou. Nikdo na nic neútočil. API prostě uvěřilo tomu, co mu klient řekl. To jedno odpoledne vystihuje většinu toho, o čem autentizace a zabezpečení cestovního API doopravdy jsou, a ukazuje, proč si téma zaslouží víc péče, než obvykle dostává přihlašovací obrazovka.
Multi-tenant cestovní API unikají několika předvídatelnými cestami. Vyplatí se je projít jednu po druhé, protože každá má návrhové řešení, které před spuštěním stojí mnohem méně než po něm.
Tenant není parametr
Chyba z úvodu není chybějící kontrola. Je to návrh, který se volajícího zeptá, kdo je, a pak odpovědi věří. V systému s jedním tenantem je to jen nepořádek. Na platformě, kde desítky agentur, subagentů a white-label webů sdílejí jednu databázi, tím celý bezpečnostní model stojí na poctivosti každého integrátora, který kdy bude držet klíč.
Pravidlo, které odstraní celou třídu chyb: tenant se bere z credentialu, nikdy z požadavku. Při ověření klíče nebo tokenu server určí, kterému tenantovi patří, kterou pobočku v rámci tenanta představuje a jaké role volající má. Od té chvíle běží každý dotaz uvnitř tohoto scope. Tělo požadavku může id agentury dál nést z legitimních důvodů — třeba konsolidátor zakládá rezervaci jménem jednoho ze svých subagentů — ale server ho porovná se scope, který už určil credential. Nikdy scope nerozšíří jen proto, že o to požádalo nějaké pole.
V praxi patří na stranu serveru tři věci:
- Scoping na datové vrstvě, ne v každém handleru. Filtr, který se automaticky aplikuje na každý dotaz nad tabulkami tenanta, znamená, že vývojář, který zapomene klauzuli
where, dostane prázdný výsledek, ne cizí data. Kontroly handler po handleru selžou poprvé, když někdo ve spěchu přidá endpoint. - Kontroly na úrovni objektu pro každé id v cestě.
GET /bookings/98231musí ověřit, že rezervace 98231 patří do scope volajícího. Sekvenční id z toho dělají nejčastější díru v cestovních API, protože čísla rezervací a PNR se dají snadno uhodnout. - Stejná odpověď pro „není tvoje“ i „neexistuje“. Na rezervaci jiného tenanta vracejte 404. Odpověď 403 potvrzuje, že záznam existuje, a už to samo je informace, kterou by konkurent rád měl.
Zadní vrátka chtějí stejnou disciplínu. Většina platforem potřebuje operátorský pohled napříč tenanty — podpora, finance, vlastník platformy. Udělejte z něj samostatnou roli, přidělovanou v kódu a logovanou při použití, ne příznak v dotazu, který může nastavit každý ověřený volající. Jak se má klientská integrace kolem těchto hranic chovat, popisuje ze strany požadavků článek o integraci API pro rezervaci letenek.
Credentialy dodavatelů se nikdy nedostanou do prohlížeče
Cestovní platforma drží dva druhy tajemství. Prvním jsou vaše klíče, které vydáváte partnerům. Druhé patří k vašemu vztahu s dodavateli — přístupy kanceláře do GDS, tokeny NDC agregátorů, API klíče bedbank, často vázané na smlouvu, která uvádí vaši firmu a vaše číslo IATA. Pro dodavatele je každý požadavek s nimi požadavkem od vás.
Tyto credentialy mají jediný bezpečný domov: serverový proces, který s dodavatelem mluví jménem volajícího. Nepatří do JavaScriptového bundlu single-page aplikace, do binárky mobilní aplikace, do konfiguračního souboru servírovaného prohlížeči „jen pro vyhledávací stránku“ ani do chybové hlášky, když volání dodavatele selže. Každé z těchto míst už někde bylo zdrojem úniku. Záložku sítě otevře kdokoli a binárku aplikace rozbalí každý, kdo chce.
Následky jsou horší než faktura. Uniklý klíč dodavatele dovolí cizímu člověku vyhledávat a někdy i rezervovat na váš účet — pálí poměr look-to-book, podle kterého vás dodavatel měří, a v horším případě vystavuje na váš kredit. Dodavatel ten provoz od vašeho nerozliší. Obvyklým výsledkem je pozastavený účet, dokud neprokážete, že jste to nebyli vy, což pro agenturu prodávající hlavně jednoho dopravce nebo jednu bedbanku znamená po celou dobu zavřený obchod.
Z toho plynou dvě menší pravidla. Klient nikdy nevybírá, přes který účet dodavatele požadavek půjde; server ho vybere z konfigurace tenanta. A chybová těla dodavatelů se před opuštěním vašeho API překládají, protože surové chyby dodavatelů někdy vracejí zpět přímo hlavičky požadavku.
Kolik doopravdy stojí uniklý netto tarif
Vývojáři mají sklon řadit úniky podle toho, jak osobní data jsou. V cestovní distribuci je obchodně nebezpečným polem často cena. Netto tarif nebo netto sazba je číslo, které vám dodavatel dal pod podmínkou, že se neukáže veřejnosti, a rozdíl mezi ním a prodejní cenou je vaše marže i marže vašich subagentů. Tabulka níže je hrubé pořadí. Řádky můžete pro svůj byznys vážit jinak, a ten spor stojí za to vést s týmem před incidentem, ne během něj.
| Co unikne | Kdo to obvykle najde | Co vás to stojí |
|---|---|---|
| Netto tarif v B2C odpovědi vyhledávání (skrytý v JSON, ne na obrazovce) | Konkurence, která scrapuje, zvědaví zákazníci | Stížnosti dodavatele na rate parity a zákazníci, kteří se ptají, proč platili zveřejněnou cenu |
| Přirážka nebo netto cena jiného subagenta | Subagenti, kteří si porovnávají poznámky | Ceny se znovu otevírají v celé síti; agent s lepší dohodou se stane tématem |
| Credentialy dodavatele v klientském bundlu | Kdokoli, kdo se podívá | Provoz a rezervace na váš účet, možné pozastavení po dobu šetření |
| Vyčíslitelná id rezervací nebo PNR | Scrapeři, občas novináři | Odhalení dat cestujících s regulatorní vahou daleko přesahující obchodní ztrátu |
| Úvěrové limity a zůstatky jiných agentur | Partneři, konkurence | Nejslabší účty vaší sítě se stanou cílem přetahování |
První řádek týmy přehlížejí, protože obrazovka vypadá správně. Stránka ukazuje prodejní cenu; odpověď, která ji naplnila, nese netto i přirážku v samostatných polích, protože je frontend „možná bude potřebovat“. Tvarujte odpovědi na serveru podle publika. B2C volající dostane prodejní cenu a nic, z čeho by šlo odečítat. Článek o distribuci netto tarifů subagentům vysvětluje, proč je právě tento rozdíl tím, co konsolidátor prodává.
Rotace credentialů bez výpadku
Každý credential bude potřeba vyměnit. Vývojář odejde z partnerské agentury, klíč se objeví ve veřejném repozitáři, dodavatel rotuje podle vlastního kalendáře. Pokud rotace znamená „změníš to a všechno je rozbité, dokud partner znovu nenasadí“, nikdo nerotuje a klíče žijí roky.
Navrhujte pro překryv od prvního dne. Každý partner může mít zároveň dva aktivní klíče: vytvoří nový, nasadí ho, sleduje, jak se provoz přesouvá, a teprve potom starý zruší. Aby to fungovalo, potřebuje platforma pár nenápadných dílů:
- Viditelný identifikátor klíče — prefix nebo id uložené vedle tajemství — aby logy a tikety podpory mohly říct, který klíč volání provedl, aniž by kdokoli viděl samotné tajemství.
- Tajemství uložená jako hashe, zobrazená jednou při vytvoření a už nikdy. Pokud váš tým podpory umí přečíst klíč partnera, umí to i každý, kdo kompromituje nástroje podpory.
- Časové razítko posledního použití u každého klíče, aby partner viděl, že starý utichl, než ho zruší.
- Zrušení s okamžitým účinkem, včetně každé cache, která stojí před autentizací.
Credentialy dodavatelů potřebují stejný překryv opačným směrem. Držte je v secrets store nebo šifrované konfiguraci, kterou běžící služba znovu načítá, ne zapečené v buildu, aby výměna byla změnou konfigurace, a ne nasazením. Pomáhají i krátkodobé přístupové tokeny nad dlouhodobými klíči: když token unikne, vyprší dřív, než si většina lidí všimne, že chybí.
Právě u rotace se vyplatí i logování. Zaznamenávat, který klíč a který tenant provedl každé volání — bez zaznamenání tajemství či platebních údajů cestujícího — je to, co vám dovolí odpovědět na „byli jsme to my?“ za hodinu místo za týden.
Než partnerovi předáte klíč
Krátký seznam, protože dlouhá verze je zbytek tohoto článku:
- Může cokoli v požadavku změnit tenanta klíče? Nemělo by.
- Ověřuje každý endpoint, který bere id, vlastnictví a odpovídá 404, když kontrola selže?
- Je nějaký credential dodavatele, nebo pole z něj odvozené, dosažitelný z prohlížeče?
- Obsahuje nějaká B2C odpověď netto cenu nebo přirážku, včetně skrytých polí?
- Může partner rotovat, aniž by vám volal, a můžete vy rušit, aniž byste volali jemu?
Jak řešíme přístup k našemu API
Platforma za tímto blogem nabízí API pro letenky a hotely. Každý tenant na ní už běží s vlastním administračním panelem, vlastními rezervacemi a oprávněními zaměstnanců podle rolí a obsah dodavatelů se k tenantovi dostává přes skupiny dodavatelů, ne přes dohody jeden na jednoho. Přístup k API začíná rozhovorem, ne samoobslužným klíčem, zčásti z výše uvedených důvodů: raději víme, kdo integruje a pro jaký trh, ještě než credential vznikne. Stránka cestovní API popisuje, co je k dispozici a jak ten rozhovor začíná.