Salt la conținut
Blog

Autentificare și securitate în API-urile de turism: unde se scurg datele

Redacția Tekravel
Scris cu ajutorul IA

Un dezvoltator de la una dintre agențiile voastre partenere își testează integrarea într-o marți după-amiază. Observă că endpoint-ul cu lista de rezervări primește un agencyId în query string și, din curiozitate, îl schimbă din 114 în 115. Răspunsul vine cu rezervările altcuiva: nume de pasageri, PNR-uri și tariful net pe care acea agenție l-a plătit înainte de adaos. Nimeni n-a atacat nimic. API-ul a crezut pur și simplu ce i-a spus clientul. Acea singură după-amiază rezumă aproape tot ce înseamnă autentificarea și securitatea unui API de turism și explică de ce subiectul merită mai multă atenție decât primește de obicei ecranul de login.

API-urile de turism multi-tenant se scurg pe câteva căi previzibile. Merită luate pe rând, pentru că fiecare are un răspuns de design care costă mult mai puțin înainte de lansare decât după.

Tenantul nu este un parametru

Greșeala din exemplu nu e o verificare lipsă. E un design care îl întreabă pe apelant cine este și apoi crede răspunsul. Într-un sistem cu un singur tenant asta e doar neglijent. Pe o platformă unde zeci de agenții, subagenți și site-uri white-label împart aceeași bază de date, întregul model de securitate ajunge să depindă de onestitatea fiecărui integrator care va deține vreodată o cheie.

Regula care elimină toată clasa de bug-uri: tenantul vine din credențial, niciodată din cerere. Când o cheie sau un token e verificat, serverul stabilește cărui tenant îi aparține, ce birou din acel tenant și ce roluri are apelantul. De acolo încolo fiecare interogare rulează în acel scope. Corpul cererii poate conține în continuare un id de agenție din motive legitime — de exemplu un consolidator care creează o rezervare în numele unuia dintre subagenții săi — dar serverul verifică id-ul față de scope-ul deja stabilit de credențial. Nu lărgește niciodată scope-ul doar pentru că un câmp i-a cerut-o.

În practică, trei lucruri stau pe server:

  • Scoping la nivelul datelor, nu în fiecare handler. Un filtru aplicat automat fiecărei interogări pe tabelele deținute de tenant înseamnă că un dezvoltator care uită clauza where primește un rezultat gol, nu datele altcuiva. Verificările făcute handler cu handler cedează prima dată când cineva adaugă în grabă un endpoint.
  • Verificări la nivel de obiect pentru fiecare id din cale. GET /bookings/98231 trebuie să confirme că rezervarea 98231 aparține scope-ului apelantului. Id-urile secvențiale fac din asta cea mai frecventă gaură în API-urile de turism, pentru că numerele de rezervare și referințele PNR se ghicesc ușor.
  • Același răspuns pentru „nu e al tău” și „nu există”. Returnați 404 pentru rezervarea altui tenant. Un 403 confirmă că înregistrarea e reală, iar asta singur e o informație pe care un concurent ar vrea s-o aibă.

Ușile de serviciu cer aceeași disciplină. Cele mai multe platforme au nevoie de o vedere de operator care citește peste tenanți — suport, financiar, proprietarul platformei. Faceți din ea un rol separat, acordat din cod și jurnalizat la folosire, nu un flag de interogare pe care îl poate seta orice apelant autentificat. Despre cum ar trebui să se comporte o integrare client în jurul acestor limite, articolul despre integrarea unui API de rezervări de zboruri acoperă partea de cerere.

Credențialele furnizorilor nu ajung niciodată în browser

O platformă de turism păstrează două feluri de secrete. Primul e al vostru: cheile pe care le emiteți partenerilor. Al doilea ține de relația cu furnizorii — credențiale de birou GDS, token-uri de agregator NDC, chei API de bedbank, adesea legate de un contract care numește compania voastră și numărul IATA. Pentru furnizor, fiecare cerere făcută cu ele e o cerere de la voi.

Aceste credențiale au un singur loc sigur: un proces pe server care vorbește cu furnizorul în numele apelantului. Nu au ce căuta în bundle-ul JavaScript al unei aplicații single-page, în binarul unei aplicații mobile, într-un fișier de configurare servit browserului „doar pentru pagina de căutare” sau într-un mesaj de eroare întors când apelul la furnizor eșuează. Fiecare dintre acestea a fost, undeva, sursa unei scurgeri. Oricine poate deschide tab-ul de rețea, iar un binar de aplicație poate fi despachetat de oricine vrea.

Consecințele sunt mai grave decât o factură. O cheie de furnizor scursă îi permite unui străin să caute, uneori chiar să rezerve, pe contul vostru — consumând raportul look-to-book după care vă măsoară furnizorul și, în cazul rău, emițând pe creditul vostru. Furnizorul nu va deosebi acel trafic de al vostru. Rezultatul obișnuit e un cont suspendat cât timp dovediți că nu ați fost voi, ceea ce pentru o agenție care vinde mai ales un singur transportator sau un singur bedbank înseamnă prăvălie închisă pe toată durata.

De aici decurg două reguli mai mici. Clientul nu alege niciodată prin ce cont de furnizor trece o cerere; serverul îl alege din configurația tenantului. Iar corpurile de eroare ale furnizorilor sunt traduse înainte să iasă din API-ul vostru, pentru că erorile brute ale furnizorilor reflectă uneori înapoi chiar headerele cererii.

Cât costă de fapt un tarif net scurs

Dezvoltatorii tind să ierarhizeze scurgerile după cât de personale sunt datele. În distribuția turistică, câmpul periculos comercial este adesea prețul. Un tarif net sau o rată netă este cifra pe care furnizorul a acceptat să v-o dea cu condiția să nu fie arătată publicului, iar diferența dintre ea și prețul de vânzare este marja voastră și a subagenților. Tabelul de mai jos e o ierarhie aproximativă. Poate cântăriți rândurile altfel pentru afacerea voastră, iar acea dezbatere merită purtată cu echipa înaintea unui incident, nu în timpul lui.

Ce se scurgeCine o găsește de obiceiCe vă costă
Tariful net într-un răspuns de căutare B2C (ascuns în JSON, nu pe ecran)Concurenți care fac scraping, clienți curioșiPlângeri de rate parity de la furnizor și clienți care întreabă de ce au plătit prețul publicat
Adaosul sau prețul net al altui subagentSubagenți care își compară notițelePrețurile se redeschid în toată rețeaua; agentul cu oferta mai bună devine subiectul discuției
Credențiale de furnizor într-un bundle de clientOricine se uităTrafic și rezervări pe contul vostru, posibilă suspendare pe durata investigației
Id-uri de rezervare sau PNR enumerabileScrapere, ocazional jurnaliștiExpunerea datelor pasagerilor, cu greutate de reglementare mult peste pierderea comercială
Limitele de credit și soldurile altor agențiiParteneri, concurențiCele mai slabe conturi din rețea devin țintă pentru racolare

Primul rând e cel pe care echipele îl ratează, pentru că ecranul arată corect. Pagina afișează prețul de vânzare; răspunsul care a alimentat-o poartă netul și adaosul în câmpuri separate, pentru că frontend-ul „s-ar putea să aibă nevoie de ele”. Modelați răspunsurile pe server, pentru fiecare audiență. Un apelant B2C primește un preț de vânzare și nimic din care cineva să poată face o scădere. Articolul despre distribuirea tarifelor nete către subagenți explică de ce tocmai această diferență este ceea ce vinde un consolidator.

Rotația credențialelor fără downtime

Orice credențial va trebui înlocuit. Un dezvoltator pleacă de la o agenție parteneră, o cheie apare într-un repository public, un furnizor rotește după propriul calendar. Dacă rotația înseamnă „schimbi și totul se strică până redeployează partenerul”, nimeni nu rotește, iar cheile trăiesc ani de zile.

Proiectați pentru suprapunere din prima zi. Fiecare partener poate avea două chei active în același timp: o creează pe cea nouă, o pune în producție, își vede traficul mutându-se și abia apoi o revocă pe cea veche. Ca să funcționeze, platforma are nevoie de câteva piese fără strălucire:

  1. Un identificator vizibil al cheii — un prefix sau un id păstrat lângă secret — ca jurnalele și tichetele de suport să poată spune ce cheie a făcut un apel fără ca cineva să vadă secretul.
  2. Secrete stocate ca hash-uri, afișate o singură dată la creare și apoi niciodată. Dacă echipa de suport poate citi cheia unui partener, o poate citi oricine compromite uneltele de suport.
  3. Un timestamp de ultimă utilizare pentru fiecare cheie, ca partenerul să vadă că cea veche a amuțit înainte s-o revoce.
  4. Revocare cu efect imediat, inclusiv în orice cache aflat în fața autentificării.

Credențialele furnizorilor au nevoie de aceeași suprapunere, în sens invers. Țineți-le într-un secrets store sau într-o configurație criptată pe care serviciul aflat în rulare o recitește, nu coapte într-un build, astfel încât schimbarea să fie o modificare de configurație, nu un deployment. Token-urile de acces cu viață scurtă peste cheile de lungă durată ajută și ele: dacă un token se scurge, expiră înainte ca cei mai mulți să observe că a dispărut.

Tot la rotație se plătește și jurnalizarea. Să înregistrați ce cheie și ce tenant au făcut fiecare apel — fără să înregistrați secretul sau datele de plată ale pasagerului — e ceea ce vă permite să răspundeți la „am fost noi?” într-o oră, nu într-o săptămână.

Înainte să-i dați unui partener o cheie

O listă scurtă, pentru că versiunea lungă este restul acestui articol:

  • Poate ceva din cerere să schimbe tenantul cheii? N-ar trebui.
  • Fiecare endpoint care primește un id verifică proprietatea și răspunde cu 404 când verificarea eșuează?
  • Este vreun credențial de furnizor, sau vreun câmp derivat din el, accesibil din browser?
  • Conține vreun răspuns B2C un preț net sau un adaos, inclusiv în câmpuri ascunse?
  • Poate partenerul să rotească fără să vă sune, și puteți revoca fără să-l sunați?

Cum gestionăm accesul la API-ul nostru

Platforma din spatele acestui blog expune API-uri pentru zboruri și hoteluri. Fiecare tenant de pe ea rulează deja cu propriul panou de administrare, propriile rezervări și permisiuni de personal pe roluri, iar conținutul furnizorilor ajunge la un tenant prin grupuri de furnizori, nu prin înțelegeri unu-la-unu. Accesul la API începe ca o conversație, nu ca o cheie self-serve, în parte din motivele de mai sus: preferăm să știm cine integrează și pentru ce piață înainte să existe un credențial. Pagina API-uri de turism descrie ce este disponibil și cum începe acea conversație.

Redacția Tekravel

Departamentul de tehnologii de turism

Departamentul de tehnologii de turism al Tekravel scrie pentru industrie: proprietari de agenții, consolidatori și dezvoltatorii care îi integrează. Fiecare articol este verificat pe platforma pe care o descrie înainte de publicare.