Sécurité d'une API voyage : par où fuient les données

Un développeur chez l'une de vos agences partenaires teste son intégration un mardi après-midi. Il remarque que l'endpoint de liste des réservations prend un agencyId dans la query string et, par curiosité, le fait passer de 114 à 115. La réponse revient avec les réservations de quelqu'un d'autre : noms des passagers, PNR, et le tarif net que cette agence a payé avant d'ajouter sa marge. Personne n'a attaqué quoi que ce soit. L'API a simplement cru ce que le client lui disait. Cet après-midi-là résume l'essentiel de ce que recouvrent l'authentification et la sécurité d'une API voyage, et c'est pourquoi le sujet mérite bien plus d'attention que l'écran de connexion n'en reçoit d'habitude.
Les API voyage multi-tenant fuient d'un petit nombre de façons prévisibles. Mieux vaut les nommer une à une, parce que chacune a une réponse de conception qui coûte bien moins cher avant la mise en production qu'après.
Le tenant n'est pas un paramètre
L'erreur de l'introduction n'est pas un contrôle oublié. C'est une conception qui demande à l'appelant qui il est, puis se fie à sa réponse. Dans un système mono-client, c'est simplement brouillon. Sur une plateforme où des dizaines d'agences, de sous-agents et de sites en marque blanche partagent une même base de données, c'est tout le modèle de sécurité qui repose sur l'honnêteté de chaque intégrateur qui détiendra un jour une clé.
La règle qui supprime toute cette famille de bugs : le tenant vient de l'identifiant, jamais de la requête. Quand une clé ou un token est vérifié, le serveur détermine à quel tenant il appartient, à quel bureau au sein de ce tenant, et quels rôles détient l'appelant. Dès lors, chaque requête s'exécute dans ce périmètre. Le corps d'une requête peut encore porter un identifiant d'agence pour une raison légitime — un consolidateur qui crée une réservation pour le compte de l'un de ses sous-agents, par exemple — mais le serveur confronte cet identifiant au périmètre que l'identifiant a déjà établi. Il n'élargit jamais ce périmètre parce qu'un champ le lui demande.
Concrètement, trois choses vivent côté serveur :
- Le cloisonnement dans la couche de données, pas dans chaque handler. Un filtre appliqué automatiquement à toute requête sur les tables appartenant aux tenants fait qu'un développeur qui oublie la clause
whereobtient un résultat vide, pas les données d'un autre. Les contrôles handler par handler cèdent la première fois que quelqu'un ajoute un endpoint dans l'urgence. - Un contrôle au niveau de l'objet pour chaque identifiant du chemin.
GET /bookings/98231doit vérifier que la réservation 98231 appartient au périmètre de l'appelant. Les identifiants séquentiels en font la faille la plus courante des API voyage, car les numéros de réservation et les références PNR se devinent facilement. - La même réponse pour « pas à vous » et « n'existe pas ». Renvoyez 404 pour la réservation d'un autre tenant. Un 403 confirme que l'enregistrement existe, et c'est déjà une information qu'un concurrent aimerait avoir.
Les portes dérobées méritent la même discipline. La plupart des plateformes ont besoin d'une vue opérateur qui lit à travers les tenants : support, comptabilité, propriétaire de la plateforme. Faites-en un rôle distinct, attribué dans le code et journalisé à chaque usage, et non un drapeau de requête que n'importe quel appelant authentifié peut activer. Pour la façon dont une intégration cliente doit se comporter autour de ces frontières, l'article sur l'intégration d'une API de réservation de vols couvre le côté requête.
Les identifiants fournisseurs n'atteignent jamais le navigateur
Une plateforme de voyage détient deux sortes de secrets. Les premiers sont les vôtres : les clés que vous délivrez à vos partenaires. Les seconds relèvent de votre relation avec les fournisseurs — identifiants d'office GDS, tokens d'agrégateur NDC, clés API de bedbanks, souvent liés à un contrat qui mentionne votre société et votre numéro IATA. Chaque requête faite avec eux est, du point de vue du fournisseur, une requête qui vient de vous.
Ces identifiants n'ont qu'un seul endroit sûr : un processus serveur qui parle au fournisseur au nom de l'appelant. Ils n'ont rien à faire dans le bundle JavaScript d'une application monopage, dans le binaire d'une application mobile, dans un fichier de configuration envoyé au navigateur « juste pour la page de recherche », ni dans un message d'erreur renvoyé quand l'appel fournisseur échoue. Chacun de ces endroits a été la source d'une fuite quelque part. N'importe qui peut ouvrir l'onglet réseau, et un binaire d'application se décompile pour qui veut s'en donner la peine.
Les conséquences dépassent la simple facture. Une clé fournisseur divulguée permet à un inconnu de rechercher, et parfois de réserver, sur votre compte — en consommant le ratio look-to-book sur lequel le fournisseur vous évalue et, dans le pire des cas, en émettant sur votre crédit. Le fournisseur ne distinguera pas ce trafic du vôtre. L'issue habituelle est un compte suspendu le temps de prouver que ce n'était pas vous, ce qui, pour une agence qui vend surtout une compagnie ou une bedbank, revient à fermer boutique pendant toute l'enquête.
Deux règles plus modestes en découlent. Le client ne choisit jamais par quel compte fournisseur passe une requête ; le serveur le déduit de la configuration du tenant. Et les corps d'erreur des fournisseurs sont reformulés avant de quitter votre API, car certaines erreurs brutes renvoient tels quels les en-têtes de la requête.
Ce que coûte vraiment un tarif net divulgué
Les développeurs classent volontiers les fuites de données selon leur caractère personnel. Dans la distribution touristique, le champ le plus dangereux commercialement est souvent le prix. Un tarif net est le montant que votre fournisseur a accepté de vous consentir à condition qu'il ne soit pas montré au public, et l'écart avec le prix de vente constitue votre marge et celle de vos sous-agents. Le tableau ci-dessous propose un classement approximatif. Vous pondérerez peut-être les lignes autrement selon votre activité, et ce désaccord vaut d'être discuté avec votre équipe avant un incident plutôt que pendant.
| Ce qui fuit | Qui le découvre en général | Ce que cela vous coûte |
|---|---|---|
| Tarif net dans une réponse de recherche B2C (caché dans le JSON, pas à l'écran) | Concurrents qui scrapent, clients curieux | Plaintes du fournisseur pour non-respect de la parité tarifaire, et clients qui demandent pourquoi ils ont payé le prix public |
| Marge ou prix net d'un autre sous-agent | Sous-agents qui comparent leurs conditions | Renégociation des prix dans tout le réseau ; l'agent qui avait obtenu le meilleur accord devient le sujet de conversation |
| Identifiants fournisseurs dans un bundle client | Quiconque regarde | Trafic et réservations sur votre compte, suspension possible pendant l'enquête |
| Identifiants de réservation ou de PNR énumérables | Scrapers, parfois des journalistes | Exposition de données passagers, dont le poids réglementaire dépasse de loin la perte commerciale |
| Limites de crédit et soldes des autres agences | Partenaires, concurrents | Les comptes les plus fragiles de votre réseau deviennent des cibles de débauchage |
C'est la première ligne que les équipes manquent, parce que l'écran a l'air correct. La page affiche le prix de vente ; la réponse qui l'alimente transporte le net et la marge dans des champs séparés parce que le frontend « pourrait en avoir besoin ». Façonnez les réponses par audience, côté serveur. Un appelant B2C reçoit un prix de vente et rien qui permette à quiconque de faire une soustraction. L'article sur la façon de distribuer des tarifs nets aux sous-agents explique pourquoi cet écart est précisément ce que vend un consolidateur.
Faire tourner les identifiants sans interruption
Tout identifiant devra un jour être remplacé. Un développeur quitte une agence partenaire, une clé apparaît dans un dépôt public, un fournisseur fait tourner les siennes selon son propre calendrier. Si la rotation signifie « on change et tout casse jusqu'à ce que le partenaire redéploie », personne ne fait de rotation, et les clés vivent des années.
Concevez pour le chevauchement dès le premier jour. Chaque partenaire peut détenir deux clés actives à la fois : il crée la nouvelle, la déploie, observe son trafic basculer, et seulement ensuite révoque l'ancienne. Pour que cela fonctionne, la plateforme a besoin de quelques pièces sans éclat :
- Un identifiant de clé visible — un préfixe ou un numéro stocké à côté du secret — pour que journaux et tickets de support indiquent quelle clé a fait un appel sans que personne ne voie le secret lui-même.
- Des secrets stockés sous forme de hash, affichés une seule fois à la création et plus jamais ensuite. Si votre support peut lire la clé d'un partenaire, quiconque compromet vos outils de support le peut aussi.
- Un horodatage de dernière utilisation par clé, pour que le partenaire constate que l'ancienne s'est tue avant de la révoquer.
- Une révocation effective immédiatement, y compris dans tout cache placé devant l'authentification.
Les identifiants fournisseurs exigent le même chevauchement dans l'autre sens. Conservez-les dans un coffre de secrets ou une configuration chiffrée que le service relit en fonctionnement, pas figés dans un build, pour que la bascule soit un changement de configuration et non un déploiement. Des tokens d'accès de courte durée par-dessus des clés de longue durée aident aussi : si un token fuit, il expire avant que la plupart des gens ne remarquent sa disparition.
La rotation est aussi l'endroit où la journalisation se rembourse. Enregistrer quelle clé et quel tenant ont fait chaque appel — sans enregistrer le secret ni les données de paiement du passager — permet de répondre à « était-ce nous ? » en une heure plutôt qu'en une semaine.
Avant de remettre une clé à un partenaire
Une liste courte, puisque la version longue est le reste de cet article :
- Un élément de la requête peut-il changer le tenant de la clé ? Il ne devrait pas.
- Chaque endpoint qui reçoit un identifiant vérifie-t-il la propriété, et répond-il 404 en cas d'échec ?
- Un identifiant fournisseur, ou un champ qui en dérive, est-il accessible depuis un navigateur ?
- Une réponse B2C contient-elle un prix net ou une marge quelque part, champs cachés compris ?
- Le partenaire peut-il faire tourner ses clés sans vous appeler, et pouvez-vous révoquer sans l'appeler ?
Comment se passe l'accès à notre API
La plateforme derrière ce blog expose des API vols et hôtels. Chaque tenant y dispose déjà de son propre panneau d'administration, de ses propres réservations et de permissions du personnel fondées sur les rôles, et le contenu fournisseur parvient à un tenant par des groupes de fournisseurs plutôt que par des accords un à un. L'accès à l'API commence par une conversation plutôt que par une clé en libre-service, en partie pour les raisons exposées plus haut : nous préférons savoir qui intègre, et pour quel marché, avant qu'un identifiant n'existe. La page des API voyage décrit ce qui est disponible et comment cette conversation s'engage.