Vai al contenuto
Blog

Autenticazione e sicurezza di una API di viaggi: le falle

Redazione Tekravel
Scritto con l'aiuto dell'IA

Uno sviluppatore di una delle vostre agenzie partner sta provando la sua integrazione un martedì pomeriggio. Nota che l'endpoint dell'elenco prenotazioni accetta un agencyId nella query string e, per curiosità, lo cambia da 114 a 115. La risposta arriva con le prenotazioni di qualcun altro: nomi dei passeggeri, PNR e la tariffa netta che quell'agenzia ha pagato prima del proprio ricarico. Nessuno ha attaccato niente. L'API si è limitata a credere a ciò che il client le diceva. Quel pomeriggio racchiude quasi tutto ciò di cui parla davvero l'autenticazione e sicurezza di una API di viaggi, ed è il motivo per cui il tema merita più attenzione di quella che di solito riceve la schermata di login.

Le API di viaggio multi-tenant perdono dati in pochi modi, e quasi sempre prevedibili. Conviene nominarli uno alla volta, perché ognuno ha una risposta di progetto che costa molto meno prima del lancio che dopo.

Il tenant non è un parametro

L'errore della scena iniziale non è un controllo mancante. È un'architettura che chiede al chiamante chi sia e poi si fida della risposta. In un sistema con un solo cliente è soltanto disordine. In una piattaforma dove decine di agenzie, subagenti e siti white-label condividono un unico database, è l'intero modello di sicurezza appoggiato sull'onestà di ogni integratore che avrà mai in mano una chiave.

La regola che elimina l'intera categoria di bug: il tenant viene dalla credenziale, mai dalla richiesta. Quando una chiave o un token viene verificato, il server stabilisce a quale tenant appartiene, a quale ufficio dentro quel tenant e quali ruoli ha il chiamante. Da quel momento ogni query gira dentro quel perimetro. Il corpo di una richiesta può ancora contenere un id agenzia per motivi legittimi — un consolidatore che crea una prenotazione per conto di uno dei suoi subagenti, per esempio — ma il server confronta quell'id con il perimetro già stabilito dalla credenziale. Non lo allarga mai perché un campo glielo ha chiesto.

In pratica, tre cose vivono lato server:

  • Il filtro sul tenant nello strato dati, non in ogni handler. Un filtro applicato automaticamente a ogni query sulle tabelle che appartengono a un tenant fa sì che lo sviluppatore che dimentica la clausola where ottenga un risultato vuoto, non i dati di qualcun altro. I controlli handler per handler saltano la prima volta che qualcuno aggiunge un endpoint di fretta.
  • Controlli a livello di oggetto su ogni id nel percorso. GET /bookings/98231 deve confermare che la prenotazione 98231 rientra nel perimetro del chiamante. Gli id sequenziali rendono questa la falla più comune nelle API di viaggio, perché numeri di prenotazione e codici PNR si indovinano facilmente.
  • La stessa risposta per "non è tuo" e "non esiste". Restituite 404 per la prenotazione di un altro tenant. Un 403 conferma che il record esiste, e già questa è un'informazione che un concorrente vorrebbe avere.

Le vie di fuga meritano la stessa disciplina. Quasi ogni piattaforma ha bisogno di una vista operativa che legga attraverso i tenant — supporto, amministrazione, il proprietario della piattaforma. Fatene un ruolo separato, assegnato nel codice e registrato a ogni uso, non un flag di query che qualunque chiamante autenticato può impostare. Per come un'integrazione client dovrebbe comportarsi attorno a questi confini, l'articolo sull'integrazione di una API di prenotazione voli copre il lato delle richieste.

Le credenziali dei fornitori non arrivano mai a un browser

Una piattaforma di viaggi custodisce due tipi di segreto. Il primo è vostro: le chiavi che rilasciate ai partner. Il secondo appartiene al rapporto con i fornitori — credenziali d'ufficio GDS, token degli aggregatori NDC, chiavi API dei bedbank, spesso legate a un contratto che riporta il nome della vostra società e il vostro numero IATA. Ogni richiesta fatta con quelle credenziali, per il fornitore, è una richiesta vostra.

Quelle credenziali hanno una sola casa sicura: un processo server che parla con il fornitore per conto del chiamante. Non vanno nel bundle JavaScript di una single-page app, nel binario di un'app mobile, in un file di configurazione servito al browser "solo per la pagina di ricerca", né in un messaggio d'errore restituito quando la chiamata al fornitore fallisce. Ognuno di questi posti è già stato, da qualche parte, la falla. Chiunque può aprire la scheda di rete del browser, e un binario si spacchetta da chi ne ha voglia.

Le conseguenze sono peggiori di una fattura. Una chiave fornitore trapelata permette a uno sconosciuto di cercare, e talvolta prenotare, sul vostro account — consumando il rapporto look-to-book su cui il fornitore vi misura e, nel caso peggiore, emettendo sul vostro credito. Il fornitore non distinguerà quel traffico dal vostro. L'esito abituale è un account sospeso mentre dimostrate che non eravate voi, il che per un'agenzia che vende soprattutto un vettore o un bedbank significa negozio chiuso per tutta la durata.

Ne seguono due regole più piccole. Il client non sceglie mai attraverso quale account fornitore passa una richiesta: lo sceglie il server dalla configurazione del tenant. E i messaggi d'errore dei fornitori vanno tradotti prima che escano dalla vostra API, perché a volte gli errori grezzi rimandano indietro le intestazioni della richiesta così come sono.

Quanto costa davvero una tariffa netta trapelata

Gli sviluppatori tendono a ordinare le fughe di dati in base a quanto sono personali. Nella distribuzione turistica il campo commercialmente pericoloso è spesso il prezzo. Una tariffa netta è la cifra che il fornitore ha accettato di concedervi a condizione che non venga mostrata al pubblico, e la differenza tra quella e il prezzo di vendita è il vostro margine e quello dei vostri subagenti. La tabella qui sotto è una classifica approssimativa. Potreste pesare le righe in modo diverso per la vostra attività, ed è un disaccordo che conviene avere con il team prima di un incidente, non durante.

Cosa trapelaChi di solito lo trovaQuanto vi costa
Tariffa netta dentro una risposta di ricerca B2C (nascosta nel JSON, non a schermo)Concorrenti che fanno scraping, clienti curiosiReclami di parità tariffaria dal fornitore, e clienti che chiedono perché hanno pagato il prezzo pubblicato
Ricarico o prezzo netto di un altro subagenteSubagenti che si confrontano tra loroPrezzi rimessi in discussione in tutta la rete; l'agente con l'accordo migliore diventa la notizia
Credenziali fornitore in un bundle clientChiunque guardiTraffico e prenotazioni sul vostro account, possibile sospensione durante l'indagine
Id di prenotazione o PNR enumerabiliScraper, a volte giornalistiEsposizione dei dati dei passeggeri, con un peso normativo ben oltre la perdita commerciale
Fidi e saldi di altre agenziePartner, concorrentiGli account più fragili della rete diventano un bersaglio da sottrarre

La prima riga è quella che i team non vedono, perché lo schermo sembra corretto. La pagina mostra il prezzo di vendita; la risposta che l'ha alimentata porta netto e ricarico come campi separati perché il frontend "potrebbe averne bisogno". Modellate le risposte per pubblico, lato server. Un chiamante B2C riceve un prezzo di vendita e niente che permetta a qualcuno di fare una sottrazione. L'articolo su come distribuire tariffe nette ai subagenti spiega perché quella differenza è esattamente ciò che un consolidatore vende.

Ruotare le credenziali senza fermo

Ogni credenziale prima o poi andrà sostituita. Uno sviluppatore lascia un'agenzia partner, una chiave compare in un repository pubblico, un fornitore ruota secondo il suo calendario. Se ruotare significa "cambiala e tutto si rompe finché il partner non rilascia di nuovo", nessuno ruota, e le chiavi vivono per anni.

Progettate per la sovrapposizione fin dal primo giorno. Ogni partner può avere due chiavi attive contemporaneamente: crea la nuova, la mette in produzione, guarda il traffico spostarsi e solo allora revoca la vecchia. Perché funzioni, la piattaforma ha bisogno di qualche pezzo poco glamour:

  1. Un identificativo visibile della chiave — un prefisso o un id salvato accanto al segreto — così log e ticket di supporto possono dire quale chiave ha fatto una chiamata senza che nessuno veda il segreto.
  2. Segreti salvati come hash, mostrati una sola volta alla creazione e mai più. Se il vostro supporto può leggere la chiave di un partner, può farlo anche chiunque comprometta gli strumenti del supporto.
  3. Un timestamp di ultimo utilizzo per chiave, così il partner vede che la vecchia è ormai silenziosa prima di revocarla.
  4. Una revoca che ha effetto immediato, anche in qualsiasi cache posta davanti all'autenticazione.

Le credenziali dei fornitori richiedono la stessa sovrapposizione nella direzione opposta. Tenetele in un secrets store o in una configurazione cifrata che il servizio in esecuzione rilegge, non incorporate in una build, così il cambio diventa una modifica di configurazione e non un rilascio. Anche token di accesso a vita breve sopra chiavi a vita lunga aiutano: se un token trapela, scade prima che la maggior parte delle persone si accorga che manca.

La rotazione è anche il punto in cui i log si ripagano. Registrare quale chiave e quale tenant hanno fatto ogni chiamata — senza registrare il segreto né i dati di pagamento del passeggero — è ciò che vi permette di rispondere a "siamo stati noi?" in un'ora invece che in una settimana.

Prima di consegnare una chiave a un partner

Un elenco breve, perché la versione lunga è il resto di questo articolo:

  • Qualcosa nella richiesta può cambiare il tenant della chiave? Non dovrebbe.
  • Ogni endpoint che accetta un id verifica la proprietà, e risponde 404 quando la verifica fallisce?
  • Qualche credenziale fornitore, o un campo derivato da essa, è raggiungibile da un browser?
  • Una risposta B2C contiene da qualche parte un prezzo netto o un ricarico, campi nascosti compresi?
  • Il partner può ruotare senza chiamarvi, e voi potete revocare senza chiamare lui?

Come gestiamo l'accesso alla nostra API

La piattaforma dietro questo blog espone API per voli e hotel. Ogni tenant lavora già con il proprio pannello di amministrazione, le proprie prenotazioni e permessi del personale basati sui ruoli, e i contenuti dei fornitori arrivano a un tenant attraverso gruppi di fornitori, non con accordi uno a uno. L'accesso all'API comincia con una conversazione e non con una chiave self-service, in parte per i motivi visti sopra: preferiamo sapere chi sta integrando, e per quale mercato, prima che esista una credenziale. La pagina delle API di viaggio descrive cosa è disponibile e come inizia quella conversazione.

Redazione Tekravel

Desk tecnologie per il turismo

Il desk tecnologie per il turismo di Tekravel scrive per gli operatori: titolari di agenzie, consolidatori e gli sviluppatori che li integrano. Ogni articolo viene verificato sulla piattaforma che descrive prima della pubblicazione.