Məzmuna keçin
Bloq

Səyahət API autentifikasiyası və təhlükəsizliyi: sızmalar

Tekravel Redaksiyası
Süni intellektin köməyi ilə yazılıb

Tərəfdaş agentliklərinizdən birində çalışan developer çərşənbə axşamı günortadan sonra inteqrasiyasını test edir. O, rezervasiya siyahısı endpoint-inin sorğu sətirində agencyId qəbul etdiyini görür və maraq xatirinə onu 114-dən 115-ə dəyişir. Cavab başqasının rezervasiyaları ilə qayıdır: sərnişin adları, PNR-lər və həmin agentliyin öz əlavəsini qoymazdan əvvəl ödədiyi net tarif. Heç kim heç nəyə hücum etməyib. API sadəcə müştərinin dediyinə inanıb. Həmin bir günortadan sonra səyahət API autentifikasiyası və təhlükəsizliyi mövzusunun əslində nədən ibarət olduğunun böyük hissəsidir və buna görə də bu mövzu adətən giriş ekranına göstərilən diqqətdən daha çoxuna layiqdir.

Çox-tenantlı səyahət API-ləri az sayda, proqnozlaşdırıla bilən yollarla sızır. Onları bir-bir adlandırmağa dəyər, çünki hər birinin dizayn cavabı var və bu cavab işə salınmadan əvvəl sonrakından xeyli ucuz başa gəlir.

Tenant parametr deyil

Giriş səhnəsindəki səhv çatışmayan bir yoxlama deyil. Bu, çağırandan kim olduğunu soruşan və sonra cavaba güvənən bir arxitekturadır. Tək müştərili sistemdə bu sadəcə səliqəsizlikdir. Onlarla agentlik, subagent və white-label saytın bir verilənlər bazasını paylaşdığı platformada isə bu, açar alacaq hər inteqratorun dürüstlüyünə söykənən bütöv təhlükəsizlik modelidir.

Bütöv bir səhv sinfini aradan qaldıran qayda: tenant sorğudan yox, giriş məlumatlarından müəyyən olunur. Açar və ya token yoxlananda server onun hansı tenanta, həmin tenant daxilində hansı ofisə aid olduğunu və çağıranın hansı rollara malik olduğunu müəyyən edir. O andan etibarən hər sorğu bu çərçivə daxilində icra olunur. Sorğunun gövdəsində qanuni səbəblərlə yenə də agentlik id-si ola bilər — məsələn, konsolidatorun subagentlərindən biri adına rezervasiya yaratması, — amma server həmin id-ni giriş məlumatlarının artıq müəyyən etdiyi çərçivə ilə tutuşdurur. Hansısa sahə istədi deyə çərçivəni heç vaxt genişləndirmir.

Praktikada server tərəfində üç şey yaşayır:

  • Tenant məhdudiyyəti hər handler-də yox, məlumat qatında. Tenanta aid cədvəllərə edilən hər sorğuya avtomatik tətbiq olunan filtr where şərtini unudan developerin başqasının məlumatlarını yox, boş nəticə almasını təmin edir. Handler-handler yoxlamalar kimsə tələsik yeni endpoint əlavə etdiyi ilk anda iflasa uğrayır.
  • Yoldakı hər id üçün obyekt səviyyəsində yoxlama. GET /bookings/98231 98231 nömrəli rezervasiyanın çağıranın çərçivəsinə aid olduğunu təsdiqləməlidir. Ardıcıl id-lər bunu səyahət API-lərində ən çox rast gəlinən boşluğa çevirir, çünki rezervasiya nömrələrini və PNR kodlarını təxmin etmək asandır.
  • "Sizin deyil" və "mövcud deyil" üçün eyni cavab. Başqa tenantın rezervasiyası üçün 404 qaytarın. 403 kodu qeydin mövcud olduğunu təsdiqləyir və təkcə bu da rəqibin bilmək istəyəcəyi məlumatdır.

Xilas yolları da eyni nizam-intizam tələb edir. Əksər platformalara bütün tenantları oxuyan əməliyyat görünüşü lazımdır — dəstək, maliyyə, platforma sahibi üçün. Bunu kodda verilən və hər istifadədə jurnala yazılan ayrıca rol edin, istənilən autentifikasiya olunmuş çağıranın qoya biləcəyi sorğu bayrağı yox. Müştəri tərəfi inteqrasiyanın bu sərhədlər ətrafında necə davranmalı olduğunu aviabilet bron API inteqrasiyası haqqında yazı sorğu tərəfindən izah edir.

Təchizatçı giriş məlumatları heç vaxt brauzerə çatmır

Səyahət platforması iki növ sirr saxlayır. Birincisi sizindir: tərəfdaşlara verdiyiniz açarlar. İkincisi təchizatçılarla münasibətinizə aiddir — GDS ofis giriş məlumatları, NDC aqreqatorlarının tokenləri, bedbankların API açarları; çox vaxt şirkətinizin adı və IATA nömrəniz yazılmış müqaviləyə bağlıdır. Onlarla edilən hər sorğu təchizatçı üçün sizdən gələn sorğudur.

Bu giriş məlumatlarının yalnız bir təhlükəsiz yeri var: çağıranın adından təchizatçı ilə danışan server prosesi. Onların yeri tək səhifəli tətbiqin JavaScript bandlında, mobil tətbiqin binar faylında, brauzerə "yalnız axtarış səhifəsi üçün" verilən konfiqurasiya faylında və ya təchizatçı çağırışı uğursuz olanda qaytarılan xəta mesajında deyil. Bu yerlərin hər biri haradasa artıq sızma mənbəyi olub. Brauzerdə şəbəkə tabını hər kəs aça bilər, binar faylı isə istəyən hər kəs aça bilər.

Nəticələr hesabdan da ağırdır. Sızmış təchizatçı açarı yad birinə sizin hesabınızda axtarış etməyə, bəzən isə rezervasiya etməyə imkan verir — təchizatçının sizi ölçdüyü look-to-book nisbətini korlayır və pis halda sizin kreditinizə bilet yazır. Təchizatçı bu trafiki sizinkindən ayırmayacaq. Adi nəticə — siz olmadığınızı sübut edənə qədər dondurulmuş hesabdır; əsasən bir aviaşirkət və ya bir bedbank satan agentlik üçün bu, bütün o müddət ərzində bağlı mağaza deməkdir.

Buradan iki kiçik qayda çıxır. Sorğunun hansı təchizatçı hesabından keçəcəyini müştəri heç vaxt seçmir; onu server tenantın konfiqurasiyasından seçir. Təchizatçıların xəta mətnləri isə API-nizdən çıxmazdan əvvəl çevrilir, çünki xam təchizatçı xətaları bəzən sorğu başlıqlarını olduğu kimi geri qaytarır.

Sızmış net tarif əslində nəyə başa gəlir

Developerlər məlumat sızmalarını məlumatın nə qədər şəxsi olmasına görə sıralamağa meyillidirlər. Səyahət distribusiyasında kommersiya baxımından təhlükəli sahə çox vaxt qiymətdir. Net tarif təchizatçının ictimaiyyətə göstərilməmək şərti ilə sizə verməyə razılaşdığı məbləğdir, onunla satış qiyməti arasındakı fərq isə sizin və subagentlərinizin marjasıdır. Aşağıdakı cədvəl təxmini reytinqdir. Öz biznesiniz üçün sətirləri fərqli qiymətləndirə bilərsiniz və bu mübahisəni komandanızla insident zamanı yox, ondan əvvəl aparmaq daha yaxşıdır.

Nə sızırAdətən kim tapırSizə nəyə başa gəlir
B2C axtarış cavabında net tarif (ekranda yox, JSON-da gizlənib)Skreypinq edən rəqiblər, maraqlı müştərilərTəchizatçıdan qiymət pariteti şikayətləri və dərc olunmuş qiyməti niyə ödədiklərini soruşan müştərilər
Başqa subagentin əlavəsi və ya net qiymətiŞərtləri müqayisə edən subagentlərBütün şəbəkədə qiymətlər yenidən müzakirəyə açılır; daha yaxşı razılaşma əldə edən agent əsas mövzuya çevrilir
Müştəri bandlında təchizatçı giriş məlumatlarıBaxan hər kəsHesabınızda trafik və rezervasiyalar, araşdırma vaxtı mümkün dondurulma
Sadalana bilən rezervasiya və ya PNR id-ləriSkreyperlər, bəzən jurnalistlərSərnişin məlumatlarının ifşası; onun tənzimləyici çəkisi kommersiya itkisindən xeyli ağırdır
Digər agentliklərin kredit limitləri və balanslarıTərəfdaşlar, rəqiblərŞəbəkənizdəki ən zəif hesablar ələ keçirmə hədəfinə çevrilir

Komandaların gözündən qaçan birinci sətirdir, çünki ekran düzgün görünür. Səhifə satış qiymətini göstərir; onu dolduran cavab isə net qiyməti və əlavəni ayrıca sahələr kimi daşıyır, çünki frontend-ə onlar "lazım ola bilər". Cavabları auditoriyaya görə server tərəfində formalaşdırın. B2C çağıran satış qiymətini alır və kiminsə çıxma əməliyyatı aparmasına imkan verən heç nə almır. Net tarifləri subagentlərə paylamaq haqqında məqalə məhz bu fərqin konsolidatorun satdığı şey olduğunu izah edir.

Giriş məlumatlarını fasiləsiz dəyişmək

Hər giriş məlumatını nə vaxtsa dəyişmək lazım gələcək. Developer tərəfdaş agentlikdən ayrılır, açar ictimai repozitoriyada üzə çıxır, təchizatçı öz cədvəli ilə dəyişir. Əgər dəyişmək "dəyiş, tərəfdaş yenidən yerləşdirənə qədər hər şey sınsın" deməkdirsə, heç kim dəyişmir və açarlar illərlə yaşayır.

İlk gündən üst-üstə düşmə üçün dizayn edin. Hər tərəfdaşın eyni anda iki aktiv açarı ola bilər: yenisini yaradır, yerləşdirir, trafikin keçdiyini izləyir və yalnız bundan sonra köhnəsini ləğv edir. Bunun işləməsi üçün platformaya bir neçə gözə çarpmayan hissə lazımdır:

  1. Görünən açar identifikatoru — sirrin yanında saxlanan prefiks və ya id — beləliklə jurnallar və dəstək müraciətləri sirri heç kimə göstərmədən hansı açarın çağırış etdiyini deyə bilir.
  2. Sirlər heş kimi saxlanır, yaradılanda bir dəfə göstərilir və bir daha göstərilmir. Dəstək komandanız tərəfdaşın açarını oxuya bilirsə, dəstək alətlərini ələ keçirən hər kəs də oxuya bilər.
  3. Hər açar üçün son istifadə vaxtı, beləliklə tərəfdaş köhnə açarı ləğv etməzdən əvvəl onun susduğunu görür.
  4. Dərhal qüvvəyə minən ləğvetmə, o cümlədən autentifikasiyanın qarşısındakı istənilən keşdə.

Təchizatçı giriş məlumatlarına da əks istiqamətdə eyni üst-üstə düşmə lazımdır. Onları build-in içinə tikmək əvəzinə işləyən servisin yenidən oxuduğu sirlər anbarında və ya şifrələnmiş konfiqurasiyada saxlayın; onda dəyişiklik yerləşdirmə yox, konfiqurasiya dəyişikliyi olur. Uzunömürlü açarların üstündə qısaömürlü giriş tokenləri də kömək edir: token sızsa, çoxları onun itdiyini hiss etməmiş vaxtı bitir.

Dəyişmə həm də jurnalın özünü doğrultduğu yerdir. Hər çağırışı hansı açarın və hansı tenantın etdiyini qeyd etmək — sirri və sərnişinin ödəniş məlumatlarını qeyd etmədən — "bu biz idik?" sualına bir həftəyə yox, bir saata cavab verməyə imkan verir.

Tərəfdaşa açar verməzdən əvvəl

Qısa siyahı, çünki uzun versiyası bu yazının qalan hissəsidir:

  • Sorğudakı hər hansı bir şey açarın tenantını dəyişə bilərmi? Dəyişməməlidir.
  • İd qəbul edən hər endpoint sahibliyi yoxlayır və yoxlama uğursuz olanda 404 cavab verirmi?
  • Hər hansı təchizatçı giriş məlumatı və ya ondan törənən sahə brauzerdən əlçatandırmı?
  • B2C cavabında hansısa yerdə, gizli sahələr də daxil olmaqla, net qiymət və ya əlavə varmı?
  • Tərəfdaş sizə zəng etmədən açarı dəyişə bilirmi, siz də ona zəng etmədən ləğv edə bilirsinizmi?

API-mizə giriş necə idarə olunur

Bu bloqun arxasındakı platforma aviabilet və otel API-ləri təqdim edir. Oradakı hər tenant artıq öz admin paneli, öz rezervasiyaları və rollara əsaslanan işçi icazələri ilə işləyir, təchizatçı kontenti isə tenanta birə-bir razılaşmalarla yox, təchizatçı qrupları vasitəsilə çatır. API-yə giriş özünə-xidmət açarı ilə yox, söhbətlə başlayır, qismən yuxarıdakı səbəblərə görə: giriş məlumatı yaranmazdan əvvəl kimin və hansı bazar üçün inteqrasiya etdiyini bilməyə üstünlük veririk. Səyahət API-ləri səhifəsi nəyin mövcud olduğunu və bu söhbətin necə başladığını təsvir edir.

Tekravel Redaksiyası

Səyahət texnologiyaları masası

Tekravel-in səyahət texnologiyaları masası sənaye üçün yazır: agentlik sahibləri, konsolidatorlar və onları inteqrasiya edən developerlər. Hər məqalə dərc olunmazdan əvvəl təsvir etdiyi platformada yoxlanılır.