Перейти до вмісту
Блог

Автентифікація та безпека travel API: де витоки

Редакція Tekravel
Написано за допомогою ШІ

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

Мультитенантні туристичні API протікають у невелику кількість передбачуваних способів. Їх варто назвати по одному, бо кожен має архітектурну відповідь, яка до запуску коштує значно менше, ніж після.

Тенант — не параметр

Помилка з першої сцени — не відсутня перевірка. Це архітектура, яка питає того, хто викликає, хто він, а потім довіряє відповіді. У системі з одним клієнтом це просто неохайність. На платформі, де десятки агенцій, субагентів і white-label сайтів ділять одну базу даних, це вся модель безпеки, що тримається на чесності кожного інтегратора, який колись отримає ключ.

Правило, яке прибирає цілий клас помилок: тенант визначається обліковими даними, а не запитом. Коли ключ або токен перевірено, сервер визначає, якому тенанту він належить, якому офісу всередині тенанта і які ролі має той, хто викликає. Відтоді кожен запит до бази виконується в цих межах. Тіло запиту все ще може містити id агенції з законних причин — наприклад, консолідатор створює бронювання від імені одного зі своїх субагентів, — але сервер звіряє цей id із межами, які облікові дані вже встановили. Він ніколи не розширює межі тому, що про це попросило якесь поле.

На практиці на боці сервера живуть три речі:

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

Обхідні шляхи потребують тієї самої дисципліни. Майже кожній платформі потрібен операційний режим, що читає дані всіх тенантів, — для підтримки, фінансів, власника платформи. Зробіть це окремою роллю, що надається в коді й логується під час використання, а не прапорцем у запиті, який може поставити будь-хто з автентифікованих. Про те, як клієнтська інтеграція має поводитися біля цих меж, розповідає матеріал про інтеграцію API бронювання авіаквитків — він охоплює бік запитів.

Облікові дані постачальників ніколи не потрапляють у браузер

Туристична платформа зберігає два види секретів. Перший — ваш: ключі, які ви видаєте партнерам. Другий належить до ваших відносин із постачальниками — облікові дані офісу в GDS, токени NDC-агрегаторів, API-ключі бедбанків, часто прив'язані до договору з назвою вашої компанії та вашим номером IATA. Кожен запит, зроблений із ними, для постачальника є запитом від вас.

Ці облікові дані мають рівно одне безпечне місце: серверний процес, що звертається до постачальника від імені того, хто викликає. Їм не місце в JavaScript-бандлі односторінкового застосунку, у бінарнику мобільного застосунку, у конфігураційному файлі, що віддається браузеру «лише для сторінки пошуку», чи в повідомленні про помилку, яке повертається, коли виклик постачальника не вдався. Кожне з цих місць уже десь ставало витоком. Будь-хто може відкрити вкладку мережі в браузері, а бінарник застосунку розпакує кожен, кому це цікаво.

Наслідки гірші за рахунок. Ключ постачальника, що витік, дає сторонньому шукати, а іноді й бронювати, на вашому акаунті — спалюючи співвідношення look-to-book, за яким постачальник вас оцінює, а в гіршому разі виписуючи квитки на ваш кредит. Постачальник не відрізнить цей трафік від вашого. Звичайний результат — заблокований акаунт, поки ви доводите, що це були не ви, а для агенції, яка продає переважно одного перевізника чи один бедбанк, це означає зачинений магазин на весь цей час.

Звідси два менші правила. Клієнт ніколи не обирає, через який акаунт постачальника йде запит; його обирає сервер із конфігурації тенанта. А тексти помилок постачальників перекладаються, перш ніж залишити ваш API, бо сирі помилки постачальника іноді повертають заголовки запиту як є.

Скільки насправді коштує витік нетто-тарифу

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

Що витікаєХто зазвичай знаходитьЧого це вам коштує
Нетто-тариф у відповіді B2C-пошуку (захований у JSON, не на екрані)Конкуренти зі скрапінгом, допитливі клієнтиСкарги постачальника на паритет цін і клієнти, які питають, чому заплатили опубліковану ціну
Націнка або нетто-ціна іншого субагентаСубагенти, що порівнюють умовиЦіни по всій мережі знову на переговорах; агент із кращою угодою стає головною темою
Облікові дані постачальника в клієнтському бандліБудь-хто, хто подивитьсяТрафік і бронювання на вашому акаунті, можливе блокування на час розслідування
Id бронювань або PNR, які можна перебратиСкрапери, іноді журналістиРозкриття даних пасажирів із регуляторною вагою, значно більшою за комерційну втрату
Кредитні ліміти й баланси інших агенційПартнери, конкурентиНайслабші акаунти вашої мережі стають мішенню для переманювання

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

Ротація облікових даних без простою

Кожні облікові дані доведеться колись замінити. Розробник іде з партнерської агенції, ключ з'являється в публічному репозиторії, постачальник проводить ротацію за власним графіком. Якщо ротація означає «змінили — і все зламалося, доки партнер не перевикладе код», ніхто не ротує, і ключі живуть роками.

Закладайте перекриття з першого дня. Кожен партнер може мати два активні ключі одночасно: створює новий, розгортає його, спостерігає, як трафік переходить, і лише тоді відкликає старий. Щоб це працювало, платформі потрібні кілька непоказних деталей:

  1. Видимий ідентифікатор ключа — префікс або id, що зберігається поруч із секретом, — щоб логи й заявки в підтримку могли сказати, який ключ зробив виклик, не показуючи самого секрету.
  2. Секрети зберігаються як хеш, показуються один раз під час створення і більше ніколи. Якщо ваша підтримка може прочитати ключ партнера, це може зробити й будь-хто, хто зламає інструменти підтримки.
  3. Час останнього використання для кожного ключа, щоб партнер бачив, що старий ключ затих, перш ніж його відкликати.
  4. Відкликання, що діє негайно, зокрема в будь-якому кеші перед автентифікацією.

Облікові дані постачальників потребують такого самого перекриття у зворотному напрямку. Зберігайте їх у сховищі секретів або в зашифрованій конфігурації, яку працюючий сервіс перечитує, а не вшитими в збірку, — тоді заміна стає зміною конфігурації, а не розгортанням. Допомагають і короткоживучі токени доступу поверх довгоживучих ключів: якщо токен витече, він сплине раніше, ніж більшість людей помітить, що його немає.

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

Перш ніж дати партнеру ключ

Короткий список, бо довга версія — це решта цього тексту:

  • Чи може щось у запиті змінити тенант ключа? Не повинно.
  • Чи кожен ендпоінт, що приймає id, перевіряє належність і відповідає 404, коли перевірка не пройшла?
  • Чи досяжні з браузера будь-які облікові дані постачальника або поле, отримане з них?
  • Чи містить відповідь B2C десь нетто-ціну або націнку, включно з прихованими полями?
  • Чи може партнер провести ротацію, не дзвонячи вам, а ви — відкликати ключ, не дзвонячи йому?

Як влаштовано доступ до нашого API

Платформа, на якій працює цей блог, надає API для авіаквитків і готелів. Кожен тенант уже працює з власною адмін-панеллю, власними бронюваннями та рольовими правами персоналу, а контент постачальників доходить до тенанта через групи постачальників, а не через угоди один на один. Доступ до API починається з розмови, а не з ключа в самообслуговуванні, зокрема з причин, описаних вище: ми воліємо знати, хто інтегрується і для якого ринку, ще до того, як з'являться облікові дані. Сторінка travel API описує, що доступно і як починається ця розмова.

Редакція Tekravel

Відділ travel-технологій

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