Zum Inhalt springen
Blog

Sicherheit einer Reise-API: wo Mandantendaten lecken

Tekravel Redaktion
Mit Unterstützung von KI geschrieben

Ein Entwickler bei einer Ihrer Partneragenturen testet an einem Dienstagnachmittag seine Integration. Ihm fällt auf, dass der Endpoint für die Buchungsliste eine agencyId im Query-String erwartet, und aus Neugier ändert er sie von 114 auf 115. Die Antwort enthält die Buchungen eines anderen: Passagiernamen, PNRs und den Nettotarif, den diese Agentur vor ihrem Aufschlag bezahlt hat. Niemand hat irgendetwas angegriffen. Die API hat schlicht geglaubt, was der Client ihr erzählt hat. Dieser eine Nachmittag ist der Kern dessen, worum es bei Authentifizierung und Sicherheit einer Reise-API geht – und der Grund, warum das Thema deutlich mehr Sorgfalt verdient als der Login-Bildschirm, der meist die ganze Aufmerksamkeit bekommt.

Mandantenfähige Reise-APIs haben nur wenige, vorhersehbare Lecks. Es lohnt sich, sie einzeln zu benennen, denn für jedes gibt es eine Antwort im Design, die vor dem Livegang wesentlich weniger kostet als danach.

Der Mandant ist kein Parameter

Der Fehler aus der Einleitung ist keine vergessene Prüfung. Es ist ein Design, das den Aufrufer fragt, wer er ist, und der Antwort dann vertraut. In einem System mit nur einem Kunden ist das bloß unsauber. Auf einer Plattform, auf der Dutzende Agenturen, Subagenten und White-Label-Seiten eine Datenbank teilen, hängt damit das gesamte Sicherheitsmodell an der Ehrlichkeit jedes Integrators, der jemals einen Schlüssel erhält.

Die Regel, die diese ganze Fehlerklasse beseitigt: Der Mandant ergibt sich aus der Anmeldeinformation, nie aus der Anfrage. Wird ein Schlüssel oder Token geprüft, ermittelt der Server, zu welchem Mandanten er gehört, zu welchem Büro innerhalb dieses Mandanten und welche Rollen der Aufrufer hat. Ab dann läuft jede Abfrage in diesem Rahmen. Der Request-Body darf aus legitimen Gründen weiterhin eine Agentur-ID tragen – etwa wenn ein Konsolidator im Auftrag eines seiner Subagenten bucht –, aber der Server gleicht diese ID mit dem Rahmen ab, den die Anmeldeinformation bereits festgelegt hat. Er erweitert diesen Rahmen nie, nur weil ein Feld es verlangt.

In der Praxis gehören drei Dinge auf den Server:

  • Abgrenzung in der Datenschicht, nicht in jedem Handler. Ein Filter, der automatisch auf jede Abfrage mandantenbezogener Tabellen angewendet wird, sorgt dafür, dass ein Entwickler, der die where-Klausel vergisst, ein leeres Ergebnis bekommt statt fremder Daten. Prüfungen Handler für Handler versagen beim ersten Endpoint, den jemand in Eile hinzufügt.
  • Prüfungen auf Objektebene für jede ID im Pfad. GET /bookings/98231 muss bestätigen, dass Buchung 98231 zum Rahmen des Aufrufers gehört. Fortlaufende IDs machen dies zur häufigsten Lücke in Reise-APIs, weil Buchungsnummern und PNR-Referenzen leicht zu erraten sind.
  • Dieselbe Antwort für „gehört dir nicht“ und „existiert nicht“. Geben Sie für die Buchung eines anderen Mandanten 404 zurück. Ein 403 bestätigt, dass der Datensatz echt ist – und schon das ist eine Information, die ein Wettbewerber gern hätte.

Hintertüren verdienen dieselbe Disziplin. Die meisten Plattformen brauchen eine Betreiberansicht, die mandantenübergreifend liest: Support, Buchhaltung, Plattforminhaber. Machen Sie daraus eine eigene Rolle, im Code vergeben und bei jeder Nutzung protokolliert, kein Abfrage-Flag, das jeder authentifizierte Aufrufer setzen kann. Wie sich eine Client-Integration an diesen Grenzen verhalten sollte, beschreibt der Beitrag zur Flugbuchungs-API-Integration von der Anfrageseite her.

Lieferanten-Zugangsdaten erreichen nie den Browser

Eine Reiseplattform verwahrt zwei Arten von Geheimnissen. Die ersten gehören Ihnen: die Schlüssel, die Sie an Partner ausgeben. Die zweiten gehören zur Beziehung mit Ihren Lieferanten – GDS-Office-Zugangsdaten, Tokens von NDC-Aggregatoren, API-Schlüssel von Bettenbanken, oft an einen Vertrag gebunden, der Ihre Firma und Ihre IATA-Nummer nennt. Jede Anfrage damit ist aus Sicht des Lieferanten eine Anfrage von Ihnen.

Diese Zugangsdaten haben genau einen sicheren Ort: einen Serverprozess, der im Namen des Aufrufers mit dem Lieferanten spricht. Sie gehören nicht in das JavaScript-Bundle einer Single-Page-App, nicht in das Binary einer Mobile-App, nicht in eine Konfigurationsdatei, die „nur für die Suchseite“ an den Browser geht, und nicht in eine Fehlermeldung, die zurückkommt, wenn der Lieferantenaufruf scheitert. Jeder dieser Orte war irgendwo schon einmal das Leck. Den Netzwerk-Tab kann jeder öffnen, und ein App-Binary lässt sich von jedem entpacken, der es darauf anlegt.

Die Folgen sind schlimmer als eine Rechnung. Ein geleakter Lieferantenschlüssel erlaubt einem Fremden, über Ihr Konto zu suchen und manchmal zu buchen – das verbraucht die Look-to-Book-Quote, an der der Lieferant Sie misst, und im schlimmsten Fall wird auf Ihren Kredit ausgestellt. Der Lieferant wird diesen Traffic nicht von Ihrem unterscheiden. Das übliche Ergebnis ist ein gesperrtes Konto, bis Sie bewiesen haben, dass Sie es nicht waren – und für eine Agentur, die überwiegend eine Airline oder eine Bettenbank verkauft, heißt das: Laden zu, solange die Untersuchung dauert.

Daraus folgen zwei kleinere Regeln. Der Client wählt nie, über welches Lieferantenkonto eine Anfrage läuft; der Server bestimmt es aus der Konfiguration des Mandanten. Und Fehlermeldungen der Lieferanten werden umformuliert, bevor sie Ihre API verlassen, denn rohe Lieferantenfehler spiegeln manchmal die Request-Header unverändert zurück.

Was ein geleakter Nettotarif wirklich kostet

Entwickler ordnen Datenlecks gern danach, wie persönlich die Daten sind. Im touristischen Vertrieb ist das kommerziell gefährlichste Feld oft der Preis. Ein Nettotarif ist der Betrag, den Ihr Lieferant Ihnen unter der Bedingung gewährt, dass er nicht öffentlich gezeigt wird; die Differenz zum Verkaufspreis ist Ihre Marge und die Ihrer Subagenten. Die Tabelle unten ist eine grobe Rangfolge. Vielleicht gewichten Sie die Zeilen für Ihr Geschäft anders – und diese Diskussion sollten Sie mit Ihrem Team vor einem Vorfall führen, nicht währenddessen.

Was leaktWer es meist findetWas es Sie kostet
Nettotarif in einer B2C-Suchantwort (versteckt im JSON, nicht auf dem Bildschirm)Scrapende Wettbewerber, neugierige KundenBeschwerden des Lieferanten wegen Ratenparität und Kunden, die fragen, warum sie den veröffentlichten Preis gezahlt haben
Aufschlag oder Nettopreis eines anderen SubagentenSubagenten, die sich austauschenPreisverhandlungen im gesamten Netzwerk neu eröffnet; wer den besseren Deal hatte, wird zum Gesprächsthema
Lieferanten-Zugangsdaten in einem Client-BundleJeder, der nachsiehtTraffic und Buchungen auf Ihrem Konto, mögliche Sperre während der Prüfung
Aufzählbare Buchungs- oder PNR-IDsScraper, gelegentlich JournalistenOffenlegung von Passagierdaten mit regulatorischem Gewicht weit über den kommerziellen Schaden hinaus
Kreditlimits und Salden anderer AgenturenPartner, WettbewerberDie schwächsten Konten Ihres Netzwerks werden zum Ziel für Abwerbung

Die erste Zeile übersehen Teams am häufigsten, weil der Bildschirm korrekt aussieht. Die Seite zeigt den Verkaufspreis; die Antwort, die sie speist, trägt Netto und Aufschlag in getrennten Feldern, weil das Frontend sie „vielleicht braucht“. Gestalten Sie Antworten serverseitig je Zielgruppe. Ein B2C-Aufrufer erhält einen Verkaufspreis und nichts, womit jemand subtrahieren könnte. Der Artikel Nettotarife an Subagenturen verteilen erklärt, warum genau diese Differenz das ist, was ein Konsolidator verkauft.

Zugangsdaten rotieren ohne Ausfall

Jede Anmeldeinformation muss irgendwann ersetzt werden. Ein Entwickler verlässt eine Partneragentur, ein Schlüssel taucht in einem öffentlichen Repository auf, ein Lieferant rotiert nach eigenem Zeitplan. Wenn Rotation bedeutet „ändern, und alles ist kaputt, bis der Partner neu deployt“, rotiert niemand, und Schlüssel leben jahrelang.

Planen Sie von Anfang an auf Überlappung. Jeder Partner kann zwei aktive Schlüssel gleichzeitig halten: Er erzeugt den neuen, deployt ihn, beobachtet, wie sein Traffic umzieht, und widerruft erst dann den alten. Damit das funktioniert, braucht die Plattform ein paar unspektakuläre Bausteine:

  1. Eine sichtbare Schlüsselkennung – ein Präfix oder eine ID neben dem Geheimnis –, damit Logs und Support-Tickets sagen können, welcher Schlüssel einen Aufruf gemacht hat, ohne dass jemand das Geheimnis selbst sieht.
  2. Geheimnisse als Hash gespeichert, einmal bei der Erstellung angezeigt und danach nie wieder. Wenn Ihr Support den Schlüssel eines Partners lesen kann, kann es auch jeder, der Ihre Support-Werkzeuge kompromittiert.
  3. Ein Zeitstempel der letzten Nutzung je Schlüssel, damit der Partner sieht, dass der alte verstummt ist, bevor er ihn widerruft.
  4. Ein Widerruf, der sofort greift – auch in jedem Cache, der vor der Authentifizierung sitzt.

Lieferanten-Zugangsdaten brauchen dieselbe Überlappung in die andere Richtung. Halten Sie sie in einem Secret Store oder einer verschlüsselten Konfiguration, die der laufende Dienst neu einliest, statt sie in einen Build einzubacken – dann ist der Wechsel eine Konfigurationsänderung und kein Deployment. Kurzlebige Access-Tokens über langlebigen Schlüsseln helfen ebenfalls: Leakt ein Token, läuft es ab, bevor die meisten sein Fehlen bemerken würden.

Bei der Rotation zahlt sich auch das Logging aus. Festzuhalten, welcher Schlüssel und welcher Mandant jeden Aufruf gemacht hat – ohne das Geheimnis oder die Zahlungsdaten des Passagiers zu speichern –, ist das, was Ihnen erlaubt, „Waren wir das?“ in einer Stunde statt in einer Woche zu beantworten.

Bevor Sie einem Partner einen Schlüssel geben

Eine kurze Liste, denn die lange Fassung ist der Rest dieses Artikels:

  • Kann irgendetwas in der Anfrage den Mandanten des Schlüssels ändern? Das darf es nicht.
  • Prüft jeder Endpoint, der eine ID annimmt, die Zugehörigkeit – und antwortet er mit 404, wenn die Prüfung scheitert?
  • Ist irgendeine Lieferanten-Zugangsinformation, oder ein daraus abgeleitetes Feld, vom Browser aus erreichbar?
  • Enthält eine B2C-Antwort irgendwo einen Nettopreis oder Aufschlag, versteckte Felder eingeschlossen?
  • Kann der Partner rotieren, ohne Sie anzurufen, und können Sie widerrufen, ohne ihn anzurufen?

Wie der Zugang zu unserer API läuft

Die Plattform hinter diesem Blog stellt Flug- und Hotel-APIs bereit. Jeder Mandant darauf arbeitet bereits mit eigenem Admin-Panel, eigenen Buchungen und rollenbasierten Mitarbeiterrechten, und Lieferanteninhalte erreichen einen Mandanten über Lieferantengruppen statt über Einzelvereinbarungen. Der Zugang zur API beginnt mit einem Gespräch statt mit einem Self-Service-Schlüssel – teils aus den oben genannten Gründen: Wir wissen lieber, wer integriert und für welchen Markt, bevor eine Anmeldeinformation existiert. Die Seite zu den Reise-APIs beschreibt, was verfügbar ist und wie dieses Gespräch beginnt.

Tekravel Redaktion

Ressort Reisetechnologie

Das Ressort Reisetechnologie von Tekravel schreibt für die Branche: Agenturinhaber, Konsolidatoren und die Entwickler, die sie anbinden. Jeder Artikel wird vor der Veröffentlichung an der beschriebenen Plattform überprüft.