Перейти к содержимому
Блог

Безопасность travel API: где утекают данные агентств

Редакция Tekravel
Написано с помощью ИИ

Разработчик одного из ваших агентств-партнёров во вторник после обеда тестирует интеграцию. Он замечает, что эндпоинт списка бронирований принимает agencyId в строке запроса, и из любопытства меняет 114 на 115. В ответе приходят чужие бронирования: имена пассажиров, PNR и нетто-тариф, который это агентство заплатило до своей наценки. Никто ничего не взламывал. API просто поверил тому, что сказал ему клиент. Этот один вечер — суть того, что на самом деле означают аутентификация и безопасность travel API, и именно поэтому тема заслуживает куда больше внимания, чем обычно достаётся экрану входа.

Мультиарендные (multi-tenant) туристические API протекают немногими и вполне предсказуемыми способами. Их стоит разобрать по одному, потому что у каждого есть решение на уровне архитектуры, и до запуска оно обходится гораздо дешевле, чем после.

Арендатор — это не параметр запроса

Ошибка из вступления — не забытая проверка. Это архитектура, которая спрашивает у вызывающей стороны, кто она, и затем доверяет ответу. В системе с одним клиентом это всего лишь неаккуратность. На платформе, где десятки агентств, субагентов и white-label сайтов делят одну базу данных, это значит, что вся модель безопасности держится на честности каждого интегратора, который когда-либо получит ключ.

Правило, которое убирает весь этот класс ошибок: арендатор определяется по учётным данным, а не по запросу. Когда ключ или токен проверен, сервер выясняет, какому арендатору он принадлежит, какому офису внутри этого арендатора и какие роли есть у вызывающего. С этого момента каждый запрос к данным выполняется в этих границах. Тело запроса может по-прежнему нести идентификатор агентства по законной причине — например, консолидатор создаёт бронирование от имени одного из своих субагентов, — но сервер сверяет этот идентификатор с границами, которые уже установили учётные данные. Он никогда не расширяет их только потому, что об этом попросило поле в запросе.

На практике три вещи живут на стороне сервера:

  • Ограничение области на уровне данных, а не в каждом обработчике. Фильтр, автоматически применяемый к каждому запросу к таблицам арендаторов, означает, что разработчик, забывший условие where, получит пустой результат, а не чужие данные. Проверки в каждом обработчике по отдельности ломаются в первый же раз, когда кто-то в спешке добавляет новый эндпоинт.
  • Проверка на уровне объекта для каждого идентификатора в пути. GET /bookings/98231 обязан подтвердить, что бронирование 98231 входит в область вызывающего. Последовательные идентификаторы делают это самой частой дырой в туристических API, потому что номера бронирований и ссылки PNR легко угадать.
  • Одинаковый ответ на «не ваше» и «не существует». Возвращайте 404 на бронирование другого арендатора. Код 403 подтверждает, что запись реальна, а это уже информация, которую конкурент был бы рад получить.

Служебные лазейки требуют той же дисциплины. Большинству платформ нужен операторский доступ, читающий данные всех арендаторов: поддержка, бухгалтерия, владелец платформы. Сделайте это отдельной ролью, которая выдаётся в коде и журналируется при каждом использовании, а не флагом в запросе, который может выставить любой аутентифицированный вызов. Как должна вести себя клиентская интеграция у этих границ, со стороны запросов разобрано в статье об интеграции API авиабилетов.

Учётные данные поставщиков никогда не попадают в браузер

Туристическая платформа хранит секреты двух видов. Первые — ваши: ключи, которые вы выдаёте партнёрам. Вторые относятся к отношениям с поставщиками — учётные данные офиса в GDS, токены NDC-агрегаторов, API-ключи бедбанков, часто привязанные к договору, где указаны ваша компания и ваш номер IATA. Каждый запрос с ними, с точки зрения поставщика, — запрос от вас.

У этих данных есть ровно одно безопасное место: серверный процесс, который общается с поставщиком от имени вызывающего. Им не место в JavaScript-бандле одностраничного приложения, в бинарнике мобильного приложения, в конфигурационном файле, отдаваемом браузеру «только для страницы поиска», или в сообщении об ошибке, когда вызов поставщика не удался. Каждое из этих мест где-то уже становилось источником утечки. Вкладку «Сеть» может открыть кто угодно, а бинарник приложения может распаковать любой, у кого есть желание.

Последствия хуже, чем счёт. Утёкший ключ поставщика позволяет постороннему искать, а иногда и бронировать через ваш аккаунт — расходуя соотношение look-to-book, по которому поставщик вас оценивает, а в плохом сценарии выписывая билеты в счёт вашего кредита. Поставщик не станет отличать этот трафик от вашего. Обычный исход — заблокированный аккаунт, пока вы доказываете, что это были не вы; для агентства, которое продаёт в основном одного перевозчика или один бедбанк, это означает закрытую лавку на всё время разбирательства.

Отсюда два правила поменьше. Клиент никогда не выбирает, через какой аккаунт поставщика пойдёт запрос; сервер определяет это по конфигурации арендатора. А тексты ошибок поставщиков переформулируются, прежде чем покинуть ваш API, потому что сырые ошибки иногда возвращают заголовки запроса как есть.

Сколько на самом деле стоит утечка нетто-тарифа

Разработчики обычно ранжируют утечки по тому, насколько персональны данные. В туристической дистрибуции коммерчески самое опасное поле — часто цена. Нетто-тариф — это сумма, которую поставщик согласился вам дать при условии, что публике её не покажут, а разница между ней и ценой продажи — ваша маржа и маржа ваших субагентов. Таблица ниже — грубое ранжирование. Возможно, для вашего бизнеса вы расставите строки иначе, и этот спор стоит провести с командой до инцидента, а не во время него.

Что утекаетКто обычно находитЧего это стоит
Нетто-тариф в ответе B2C-поиска (спрятан в JSON, не на экране)Конкуренты со скрейперами, любопытные клиентыПретензии поставщика по паритету цен и клиенты, спрашивающие, почему они заплатили опубликованную цену
Наценка или нетто-цена другого субагентаСубагенты, сравнивающие условияПересмотр цен по всей сети; агент, получивший лучшие условия, становится главной темой
Учётные данные поставщика в клиентском бандлеЛюбой, кто посмотритТрафик и бронирования на ваш аккаунт, возможная блокировка на время проверки
Перебираемые идентификаторы бронирований или PNRСкрейперы, иногда журналистыРаскрытие данных пассажиров, регуляторный вес которого намного превышает коммерческий ущерб
Кредитные лимиты и балансы других агентствПартнёры, конкурентыСамые слабые аккаунты вашей сети становятся целью для переманивания

Первую строку команды упускают чаще всего, потому что экран выглядит правильно. Страница показывает цену продажи, а ответ, который её наполнил, несёт нетто и наценку отдельными полями, потому что фронтенду они «могут понадобиться». Формируйте ответы под аудиторию на сервере. B2C-вызов получает цену продажи и ничего, что позволило бы кому-то вычесть одно из другого. Статья о том, как давать нетто-тарифы субагентам, объясняет, почему именно эта разница и есть то, что продаёт консолидатор.

Ротация учётных данных без простоя

Любые учётные данные однажды придётся заменить. Разработчик уходит из агентства-партнёра, ключ всплывает в публичном репозитории, поставщик меняет свои по собственному графику. Если ротация означает «поменяли — и всё сломано, пока партнёр не выкатит новую версию», никто ротацию не делает, и ключи живут годами.

Закладывайте перекрытие с первого дня. Каждый партнёр может держать два активных ключа одновременно: создаёт новый, выкатывает его, наблюдает, как трафик переходит, и только после этого отзывает старый. Чтобы это работало, платформе нужно несколько незаметных деталей:

  1. Видимый идентификатор ключа — префикс или номер, хранящийся рядом с секретом, — чтобы логи и тикеты поддержки могли указать, какой ключ сделал вызов, и при этом никто не видел сам секрет.
  2. Секреты хранятся в виде хеша, показываются один раз при создании и больше никогда. Если ваша поддержка может прочитать ключ партнёра, то сможет и любой, кто взломает ваши инструменты поддержки.
  3. Отметка времени последнего использования для каждого ключа, чтобы партнёр видел, что старый ключ затих, прежде чем его отзывать.
  4. Отзыв, который действует немедленно, в том числе в любом кэше перед слоем аутентификации.

Учётным данным поставщиков нужно такое же перекрытие в обратную сторону. Храните их в хранилище секретов или зашифрованной конфигурации, которую работающий сервис перечитывает, а не зашивайте в сборку, — тогда переключение станет изменением конфигурации, а не деплоем. Помогают и короткоживущие токены доступа поверх долгоживущих ключей: если токен утёк, он истечёт раньше, чем большинство заметит его пропажу.

Ротация — это ещё и место, где логирование окупается. Запись о том, какой ключ и какой арендатор сделали каждый вызов, — без записи самого секрета и платёжных данных пассажира — позволяет ответить на вопрос «это были мы?» за час, а не за неделю.

Прежде чем выдать партнёру ключ

Короткий список, потому что длинная версия — это вся остальная статья:

  • Может ли что-либо в запросе изменить арендатора, к которому привязан ключ? Не должно.
  • Проверяет ли каждый эндпоинт, принимающий идентификатор, принадлежность, и отвечает ли 404, если проверка не прошла?
  • Доступны ли из браузера какие-либо учётные данные поставщика или производные от них поля?
  • Содержит ли B2C-ответ где-либо нетто-цену или наценку, включая скрытые поля?
  • Может ли партнёр сменить ключ, не звоня вам, и можете ли вы отозвать его, не звоня партнёру?

Как устроен доступ к нашему API

Платформа, на которой работает этот блог, предоставляет API для авиабилетов и отелей. Каждый арендатор на ней уже работает со своей панелью администратора, своими бронированиями и ролевыми правами сотрудников, а контент поставщиков доходит до арендатора через группы поставщиков, а не через отдельные договорённости. Доступ к API начинается с разговора, а не с ключа в режиме самообслуживания — отчасти по описанным выше причинам: мы предпочитаем знать, кто интегрируется и для какого рынка, до того как появятся какие-либо учётные данные. На странице travel API описано, что доступно и с чего начинается этот разговор.

Редакция Tekravel

Отдел travel-технологий

Отдел travel-технологий Tekravel пишет для профессионалов рынка: владельцев агентств, консолидаторов и разработчиков, которые их интегрируют. Каждая статья проверяется на той самой платформе, которую описывает, до публикации.