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

Разработчик одного из ваших агентств-партнёров во вторник после обеда тестирует интеграцию. Он замечает, что эндпоинт списка бронирований принимает 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-вызов получает цену продажи и ничего, что позволило бы кому-то вычесть одно из другого. Статья о том, как давать нетто-тарифы субагентам, объясняет, почему именно эта разница и есть то, что продаёт консолидатор.
Ротация учётных данных без простоя
Любые учётные данные однажды придётся заменить. Разработчик уходит из агентства-партнёра, ключ всплывает в публичном репозитории, поставщик меняет свои по собственному графику. Если ротация означает «поменяли — и всё сломано, пока партнёр не выкатит новую версию», никто ротацию не делает, и ключи живут годами.
Закладывайте перекрытие с первого дня. Каждый партнёр может держать два активных ключа одновременно: создаёт новый, выкатывает его, наблюдает, как трафик переходит, и только после этого отзывает старый. Чтобы это работало, платформе нужно несколько незаметных деталей:
- Видимый идентификатор ключа — префикс или номер, хранящийся рядом с секретом, — чтобы логи и тикеты поддержки могли указать, какой ключ сделал вызов, и при этом никто не видел сам секрет.
- Секреты хранятся в виде хеша, показываются один раз при создании и больше никогда. Если ваша поддержка может прочитать ключ партнёра, то сможет и любой, кто взломает ваши инструменты поддержки.
- Отметка времени последнего использования для каждого ключа, чтобы партнёр видел, что старый ключ затих, прежде чем его отзывать.
- Отзыв, который действует немедленно, в том числе в любом кэше перед слоем аутентификации.
Учётным данным поставщиков нужно такое же перекрытие в обратную сторону. Храните их в хранилище секретов или зашифрованной конфигурации, которую работающий сервис перечитывает, а не зашивайте в сборку, — тогда переключение станет изменением конфигурации, а не деплоем. Помогают и короткоживущие токены доступа поверх долгоживущих ключей: если токен утёк, он истечёт раньше, чем большинство заметит его пропажу.
Ротация — это ещё и место, где логирование окупается. Запись о том, какой ключ и какой арендатор сделали каждый вызов, — без записи самого секрета и платёжных данных пассажира — позволяет ответить на вопрос «это были мы?» за час, а не за неделю.
Прежде чем выдать партнёру ключ
Короткий список, потому что длинная версия — это вся остальная статья:
- Может ли что-либо в запросе изменить арендатора, к которому привязан ключ? Не должно.
- Проверяет ли каждый эндпоинт, принимающий идентификатор, принадлежность, и отвечает ли 404, если проверка не прошла?
- Доступны ли из браузера какие-либо учётные данные поставщика или производные от них поля?
- Содержит ли B2C-ответ где-либо нетто-цену или наценку, включая скрытые поля?
- Может ли партнёр сменить ключ, не звоня вам, и можете ли вы отозвать его, не звоня партнёру?
Как устроен доступ к нашему API
Платформа, на которой работает этот блог, предоставляет API для авиабилетов и отелей. Каждый арендатор на ней уже работает со своей панелью администратора, своими бронированиями и ролевыми правами сотрудников, а контент поставщиков доходит до арендатора через группы поставщиков, а не через отдельные договорённости. Доступ к API начинается с разговора, а не с ключа в режиме самообслуживания — отчасти по описанным выше причинам: мы предпочитаем знать, кто интегрируется и для какого рынка, до того как появятся какие-либо учётные данные. На странице travel API описано, что доступно и с чего начинается этот разговор.