Seguridad de una API de viajes: por dónde se filtran

Un desarrollador de una de tus agencias asociadas está probando su integración un martes por la tarde. Se da cuenta de que el endpoint del listado de reservas recibe un agencyId en la query string y, por curiosidad, lo cambia de 114 a 115. La respuesta llega con las reservas de otra agencia: nombres de pasajeros, PNR y la tarifa neta que esa agencia pagó antes de su margen. Nadie atacó nada. La API simplemente creyó lo que el cliente le dijo. Esa tarde resume buena parte de lo que significan de verdad la autenticación y la seguridad de una API de viajes, y por eso el tema merece mucho más cuidado del que suele recibir la pantalla de login.
Las API de viajes multi-tenant filtran datos de unas pocas maneras predecibles. Vale la pena nombrarlas una por una, porque cada una tiene una respuesta de diseño que cuesta mucho menos antes del lanzamiento que después.
El tenant no es un parámetro
El error de la introducción no es un control olvidado. Es un diseño que le pregunta al que llama quién es y luego confía en la respuesta. En un sistema de un solo cliente eso es apenas desprolijo. En una plataforma donde decenas de agencias, subagentes y sitios de marca blanca comparten una base de datos, significa que todo el modelo de seguridad descansa en la honestidad de cada integrador que alguna vez tenga una clave.
La regla que elimina toda esta familia de errores: el tenant sale de la credencial, nunca de la petición. Cuando se verifica una clave o un token, el servidor determina a qué tenant pertenece, a qué oficina dentro de ese tenant y qué roles tiene quien llama. Desde ese momento, toda consulta se ejecuta dentro de ese ámbito. El cuerpo de la petición puede seguir llevando un identificador de agencia por motivos legítimos —un consolidador que crea una reserva en nombre de uno de sus subagentes, por ejemplo—, pero el servidor contrasta ese identificador con el ámbito que la credencial ya estableció. Nunca amplía ese ámbito porque un campo se lo pida.
En la práctica, tres cosas viven del lado del servidor:
- El aislamiento en la capa de datos, no en cada handler. Un filtro aplicado automáticamente a toda consulta sobre tablas de los tenants hace que un desarrollador que olvida la cláusula
whereobtenga un resultado vacío, no los datos de otro. Los controles handler por handler fallan la primera vez que alguien añade un endpoint con prisa. - Controles a nivel de objeto para cada identificador de la ruta.
GET /bookings/98231debe confirmar que la reserva 98231 pertenece al ámbito de quien llama. Los identificadores secuenciales convierten esto en el agujero más común de las API de viajes, porque los números de reserva y los localizadores PNR son fáciles de adivinar. - La misma respuesta para «no es tuyo» y «no existe». Devuelve 404 ante la reserva de otro tenant. Un 403 confirma que el registro es real, y eso ya es información que a un competidor le encantaría tener.
Las puertas traseras merecen la misma disciplina. Casi todas las plataformas necesitan una vista de operador que lea entre tenants: soporte, finanzas, el dueño de la plataforma. Conviértela en un rol separado, concedido en código y registrado cada vez que se usa, no en un parámetro de consulta que cualquier llamada autenticada pueda activar. Sobre cómo debe comportarse una integración cliente frente a estos límites, el artículo de integración de una API de reserva de vuelos cubre el lado de las peticiones.
Las credenciales de proveedores nunca llegan al navegador
Una plataforma de viajes guarda dos tipos de secretos. Los primeros son tuyos: las claves que entregas a tus socios. Los segundos pertenecen a tu relación con los proveedores —credenciales de oficina en el GDS, tokens de agregadores NDC, claves API de bancos de camas—, a menudo atados a un contrato que nombra a tu empresa y tu número IATA. Cada petición hecha con ellas es, para el proveedor, una petición tuya.
Esas credenciales tienen un único lugar seguro: un proceso de servidor que habla con el proveedor en nombre de quien llama. No pertenecen al bundle de JavaScript de una aplicación de una sola página, ni al binario de una app móvil, ni a un archivo de configuración servido al navegador «solo para la página de búsqueda», ni a un mensaje de error devuelto cuando falla la llamada al proveedor. Cada uno de esos lugares ya fue la fuga en alguna parte. Cualquiera puede abrir la pestaña de red, y un binario de app lo desempaqueta quien quiera tomarse la molestia.
Las consecuencias son peores que una factura. Una clave de proveedor filtrada permite a un desconocido buscar, y a veces reservar, contra tu cuenta: consume el ratio look-to-book con el que el proveedor te mide y, en el peor caso, emite contra tu crédito. El proveedor no distinguirá ese tráfico del tuyo. El desenlace habitual es una cuenta suspendida mientras demuestras que no fuiste tú, lo que para una agencia que vende sobre todo una aerolínea o un solo banco de camas equivale a cerrar la tienda mientras dure la investigación.
De ahí salen dos reglas más pequeñas. El cliente nunca elige por qué cuenta de proveedor pasa una petición; el servidor la toma de la configuración del tenant. Y los mensajes de error de los proveedores se reescriben antes de salir de tu API, porque algunos errores en bruto devuelven las cabeceras de la petición tal cual.
Lo que cuesta de verdad filtrar una tarifa neta
Los desarrolladores suelen ordenar las fugas de datos según lo personales que sean. En la distribución turística, el campo comercialmente más peligroso suele ser el precio. Una tarifa neta es la cifra que tu proveedor aceptó darte con la condición de que no se muestre al público, y la diferencia con el precio de venta es tu margen y el de tus subagentes. La tabla de abajo es un orden aproximado. Quizá tú pondères las filas de otro modo según tu negocio, y esa discusión conviene tenerla con tu equipo antes de un incidente, no durante.
| Qué se filtra | Quién suele encontrarlo | Lo que te cuesta |
|---|---|---|
| Tarifa neta dentro de una respuesta de búsqueda B2C (oculta en el JSON, no en pantalla) | Competidores que hacen scraping, clientes curiosos | Quejas del proveedor por paridad de tarifas y clientes que preguntan por qué pagaron el precio publicado |
| Margen o precio neto de otro subagente | Subagentes que comparan condiciones | Precios renegociados en toda la red; el agente que tenía el mejor acuerdo se convierte en el tema |
| Credenciales de proveedor en un bundle cliente | Cualquiera que mire | Tráfico y reservas en tu cuenta, posible suspensión mientras se investiga |
| Identificadores de reserva o PNR enumerables | Scrapers, de vez en cuando periodistas | Exposición de datos de pasajeros, con un peso regulatorio muy superior a la pérdida comercial |
| Límites de crédito y saldos de otras agencias | Socios, competidores | Las cuentas más débiles de tu red se vuelven objetivo para que te las quiten |
La primera fila es la que se les escapa a los equipos, porque la pantalla se ve correcta. La página muestra el precio de venta; la respuesta que la alimenta lleva el neto y el margen como campos separados porque el frontend «quizá los necesite». Da forma a las respuestas por audiencia en el servidor. Quien llama desde B2C recibe un precio de venta y nada que le permita a nadie restar. El artículo sobre cómo distribuir tarifas netas a subagentes explica por qué esa diferencia es justamente lo que vende un consolidador.
Rotar credenciales sin caídas
Toda credencial habrá que reemplazarla algún día. Un desarrollador deja una agencia asociada, una clave aparece en un repositorio público, un proveedor rota las suyas según su propio calendario. Si rotar significa «se cambia y todo se rompe hasta que el socio vuelva a desplegar», nadie rota, y las claves viven años.
Diseña para el solapamiento desde el primer día. Cada socio puede tener dos claves activas a la vez: crea la nueva, la despliega, ve cómo su tráfico pasa a ella y solo entonces revoca la antigua. Para que funcione, la plataforma necesita algunas piezas poco vistosas:
- Un identificador de clave visible —un prefijo o número guardado junto al secreto— para que los logs y los tickets de soporte digan qué clave hizo una llamada sin que nadie vea el secreto en sí.
- Secretos guardados como hash, mostrados una sola vez al crearlos y nunca más. Si tu equipo de soporte puede leer la clave de un socio, también puede quien comprometa tus herramientas de soporte.
- Una marca de último uso por clave, para que el socio vea que la antigua ya no tiene tráfico antes de revocarla.
- Una revocación que surte efecto al instante, incluida cualquier caché situada delante de la autenticación.
Las credenciales de proveedores necesitan el mismo solapamiento en sentido contrario. Guárdalas en un almacén de secretos o en una configuración cifrada que el servicio en ejecución vuelva a leer, no metidas dentro de un build, para que el cambio sea un ajuste de configuración y no un despliegue. Los tokens de acceso de vida corta sobre claves de vida larga también ayudan: si un token se filtra, caduca antes de que casi nadie note su ausencia.
La rotación es además donde el registro de actividad se paga solo. Anotar qué clave y qué tenant hicieron cada llamada —sin anotar el secreto ni los datos de pago del pasajero— es lo que te permite responder «¿fuimos nosotros?» en una hora y no en una semana.
Antes de entregar una clave a un socio
Una lista corta, porque la versión larga es el resto de este artículo:
- ¿Puede algo de la petición cambiar el tenant de la clave? No debería.
- ¿Cada endpoint que recibe un identificador comprueba la propiedad y responde 404 cuando la comprobación falla?
- ¿Hay alguna credencial de proveedor, o algún campo derivado de ella, accesible desde un navegador?
- ¿Alguna respuesta B2C contiene un precio neto o un margen en alguna parte, campos ocultos incluidos?
- ¿Puede el socio rotar sin llamarte, y puedes tú revocar sin llamarlo?
Cómo funciona el acceso a nuestra API
La plataforma detrás de este blog ofrece API de vuelos y hoteles. Cada tenant en ella ya funciona con su propio panel de administración, sus propias reservas y permisos de personal basados en roles, y el contenido de proveedores llega a un tenant a través de grupos de proveedores, no de acuerdos uno a uno. El acceso a la API empieza con una conversación y no con una clave de autoservicio, en parte por las razones de arriba: preferimos saber quién integra, y para qué mercado, antes de que exista una credencial. La página de API de viajes describe lo que hay disponible y cómo empieza esa conversación.