Langkau ke kandungan
Blog

Keselamatan API pelancongan: dari mana data tenan bocor

Sidang Pengarang Tekravel
Ditulis dengan bantuan AI

Seorang pembangun di salah satu ejen rakan kongsi anda sedang menguji integrasinya pada petang Selasa. Dia perasan endpoint senarai tempahan menerima agencyId dalam query string, lalu kerana ingin tahu dia menukarnya daripada 114 kepada 115. Responsnya kembali dengan tempahan milik orang lain: nama penumpang, PNR, dan tambang net yang dibayar ejen itu sebelum margin ditambah. Tiada sesiapa menyerang apa-apa. API hanya mempercayai apa yang klien katakan. Petang itu hampir keseluruhan isi pengesahan dan keselamatan API pelancongan, dan itulah sebabnya topik ini patut mendapat perhatian lebih daripada yang biasanya diberikan kepada skrin log masuk.

API pelancongan berbilang tenan bocor melalui beberapa cara yang boleh diramal. Elok disebut satu persatu, kerana setiap satu ada jawapan reka bentuk yang jauh lebih murah sebelum pelancaran berbanding selepasnya.

Tenan bukan parameter

Kesilapan dalam pembukaan tadi bukan semakan yang tertinggal. Ia reka bentuk yang bertanya kepada pemanggil siapa dirinya, kemudian mempercayai jawapannya. Dalam sistem satu klien, ia sekadar tidak kemas. Pada platform di mana berpuluh ejen, subejen dan tapak white-label berkongsi satu pangkalan data, seluruh model keselamatan bergantung pada kejujuran setiap integrator yang pernah memegang kunci.

Peraturan yang menghapuskan seluruh kelas pepijat ini: tenan datang daripada kelayakan, bukan daripada permintaan. Apabila kunci atau token disahkan, pelayan menentukan tenan mana pemiliknya, pejabat mana dalam tenan itu, dan peranan apa yang dipegang pemanggil. Sejak itu setiap pertanyaan berjalan dalam skop tersebut. Badan permintaan masih boleh membawa ID ejen atas sebab yang sah, misalnya konsolidator yang membuat tempahan bagi pihak salah seorang subejennya, tetapi pelayan menyemak ID itu dengan skop yang telah ditetapkan oleh kelayakan. Ia tidak pernah meluaskan skop hanya kerana sesuatu medan memintanya.

Dalam amalan, tiga perkara berada di sisi pelayan:

  • Scoping di lapisan data, bukan dalam setiap handler. Penapis yang digunakan secara automatik pada setiap pertanyaan ke atas jadual milik tenan bermakna pembangun yang terlupa klausa where mendapat hasil kosong, bukan data orang lain. Semakan setiap handler gagal pada kali pertama seseorang menambah endpoint dengan tergesa-gesa.
  • Semakan peringkat objek pada setiap ID dalam laluan. GET /bookings/98231 mesti mengesahkan tempahan 98231 berada dalam skop pemanggil. ID berurutan menjadikan ini lubang paling biasa dalam API pelancongan, kerana nombor tempahan dan rujukan PNR mudah diteka.
  • Jawapan yang sama untuk "bukan milik anda" dan "tidak wujud". Pulangkan 404 untuk tempahan tenan lain. Kod 403 mengesahkan rekod itu benar-benar ada, dan itu sahaja maklumat yang pesaing mahu miliki.

Pintu kecemasan juga memerlukan disiplin yang sama. Kebanyakan platform perlukan paparan operator yang membaca merentas tenan: sokongan, kewangan, pemilik platform. Jadikan ia peranan berasingan, diberikan dalam kod dan direkodkan setiap kali digunakan, bukan bendera pertanyaan yang boleh ditetapkan oleh mana-mana pemanggil yang disahkan. Tentang bagaimana integrasi pihak klien harus berkelakuan di sekitar sempadan ini, artikel mengenai integrasi API tempahan penerbangan membincangkan sisi permintaannya.

Kelayakan pembekal tidak pernah sampai ke pelayar

Platform pelancongan menyimpan dua jenis rahsia. Yang pertama milik anda: kunci yang anda keluarkan untuk rakan kongsi. Yang kedua milik hubungan anda dengan pembekal: kelayakan office GDS, token pengagregat NDC, kunci API bedbank, selalunya terikat dengan kontrak yang menamakan syarikat anda dan nombor IATA anda. Setiap permintaan yang dibuat dengannya, pada pandangan pembekal, ialah permintaan daripada anda.

Kelayakan itu hanya ada satu tempat selamat: proses pelayan yang berbual dengan pembekal bagi pihak pemanggil. Ia tidak sepatutnya berada dalam bundle JavaScript aplikasi satu halaman, dalam binari aplikasi mudah alih, dalam fail konfigurasi yang dihantar ke pelayar "hanya untuk halaman carian", atau dalam mesej ralat yang dipulangkan apabila panggilan pembekal gagal. Setiap satu daripadanya pernah menjadi punca kebocoran di suatu tempat. Sesiapa boleh membuka tab rangkaian, dan binari aplikasi boleh dibongkar oleh sesiapa yang mahu.

Akibatnya lebih buruk daripada bil. Kunci pembekal yang bocor membolehkan orang asing membuat carian, kadangkala tempahan juga, atas akaun anda: nisbah look-to-book yang digunakan pembekal untuk menilai anda habis, dan dalam kes teruk tiket diterbitkan atas kredit anda. Pembekal tidak akan membezakan trafik itu daripada trafik anda. Hasil lazimnya ialah akaun digantung sementara anda membuktikan ia bukan anda, yang bagi ejen yang kebanyakannya menjual satu syarikat penerbangan atau satu bedbank bermakna kedai tutup sepanjang tempoh itu.

Dua peraturan kecil menyusul. Klien tidak pernah memilih akaun pembekal mana yang dilalui permintaan; pelayan memilihnya daripada konfigurasi tenan. Dan badan ralat pembekal diterjemahkan sebelum meninggalkan API anda, kerana ralat mentah pembekal kadangkala memantulkan header permintaan terus.

Apa sebenarnya kos tambang net yang bocor

Pembangun cenderung menyusun kebocoran data mengikut betapa peribadinya data itu. Dalam pengedaran pelancongan, medan yang paling berbahaya dari sudut komersial selalunya harga. Tambang net ialah angka yang pembekal anda setuju berikan dengan syarat ia tidak ditunjukkan kepada orang ramai, dan jurangnya dengan harga jualan ialah margin anda dan margin subejen anda. Jadual di bawah ialah kedudukan kasar. Anda mungkin menimbang baris-barisnya secara berbeza untuk perniagaan anda, dan perbezaan pendapat itu elok dibincangkan dengan pasukan sebelum insiden, bukan semasanya.

Apa yang bocorSiapa yang biasanya menemuinyaKos kepada anda
Tambang net dalam respons carian B2C (tersembunyi dalam JSON, bukan di skrin)Pesaing yang melakukan scraping, pelanggan yang ingin tahuAduan pembekal tentang pariti harga, dan pelanggan yang bertanya mengapa mereka membayar harga yang diterbitkan
Margin atau harga net subejen lainSubejen yang membandingkan notaHarga dibuka semula di seluruh rangkaian; ejen yang mendapat tawaran lebih baik menjadi bualan
Kelayakan pembekal dalam bundle klienSesiapa yang melihatTrafik dan tempahan atas akaun anda, kemungkinan penggantungan semasa siasatan
ID tempahan atau PNR yang boleh dienumerasiScraper, kadangkala wartawanPendedahan data penumpang, yang berat peraturannya jauh melebihi kerugian komersial
Had kredit dan baki ejen lainRakan kongsi, pesaingAkaun paling lemah dalam rangkaian anda menjadi sasaran pencurian

Baris pertama sering terlepas oleh pasukan kerana skrin kelihatan betul. Halaman menunjukkan harga jualan; respons yang menyuapnya membawa net dan margin sebagai medan berasingan kerana frontend "mungkin memerlukannya". Bentukkan respons mengikut khalayak di pelayan. Pemanggil B2C mendapat harga jualan dan tiada apa yang membolehkan sesiapa menolak. Artikel tentang cara mengedar tambang net kepada subejen menerangkan mengapa jurang itulah yang dijual oleh konsolidator.

Memutar kelayakan tanpa masa henti

Setiap kelayakan akan perlu diganti. Seorang pembangun meninggalkan ejen rakan kongsi, kunci muncul dalam repositori awam, pembekal memutar kunci mengikut jadualnya sendiri. Jika putaran bermakna "tukar dan semuanya rosak sehingga rakan kongsi deploy semula", tiada siapa akan memutar, dan kunci hidup bertahun-tahun.

Reka bentuk untuk pertindihan sejak hari pertama. Setiap rakan kongsi boleh memegang dua kunci aktif serentak: mereka cipta yang baru, deploy, perhatikan trafik berpindah, dan baru kemudian membatalkan yang lama. Agar ia berfungsi, platform memerlukan beberapa komponen yang tidak glamor:

  1. Pengecam kunci yang kelihatan, awalan atau ID yang disimpan di sebelah rahsia, supaya log dan tiket sokongan boleh menyatakan kunci mana yang membuat panggilan tanpa sesiapa melihat rahsianya.
  2. Rahsia disimpan sebagai hash, dipaparkan sekali semasa penciptaan dan tidak lagi selepas itu. Jika pasukan sokongan anda boleh membaca kunci rakan kongsi, sesiapa yang menceroboh alat sokongan anda juga boleh.
  3. Cap masa penggunaan terakhir bagi setiap kunci, supaya rakan kongsi dapat melihat kunci lama sudah senyap sebelum membatalkannya.
  4. Pembatalan yang berkuat kuasa serta-merta, termasuk dalam mana-mana cache di hadapan pengesahan.

Kelayakan pembekal memerlukan pertindihan yang sama ke arah bertentangan. Simpan dalam stor rahsia atau konfigurasi disulitkan yang dibaca semula oleh perkhidmatan yang sedang berjalan, bukan dibakar dalam build, supaya pertukaran ialah perubahan konfigurasi dan bukan deployment. Token akses jangka pendek di atas kunci jangka panjang juga membantu: jika token bocor, ia tamat tempoh sebelum kebanyakan orang sedar ia hilang.

Putaran juga tempat logging membayar balik. Merekodkan kunci dan tenan mana yang membuat setiap panggilan, tanpa merekodkan rahsia atau data pembayaran penumpang, membolehkan anda menjawab "adakah itu kita?" dalam sejam dan bukan seminggu.

Sebelum anda serahkan kunci kepada rakan kongsi

Senarai ringkas, kerana versi panjangnya ialah selebihnya tulisan ini:

  • Adakah apa-apa dalam permintaan boleh menukar tenan sesuatu kunci? Tidak sepatutnya.
  • Adakah setiap endpoint yang menerima ID menyemak pemilikan, dan menjawab 404 apabila semakan gagal?
  • Adakah mana-mana kelayakan pembekal, atau medan terbitan daripadanya, boleh dicapai dari pelayar?
  • Adakah respons B2C mengandungi harga net atau margin di mana-mana, termasuk medan tersembunyi?
  • Bolehkah rakan kongsi memutar tanpa menelefon anda, dan bolehkah anda membatalkan tanpa menelefon mereka?

Bagaimana akses kepada API kami dikendalikan

Platform di sebalik blog ini menyediakan API penerbangan dan hotel. Setiap tenan di dalamnya sudah berjalan dengan panel pentadbir sendiri, tempahan sendiri dan kebenaran kakitangan berasaskan peranan, dan kandungan pembekal sampai kepada tenan melalui kumpulan pembekal, bukan perjanjian satu lawan satu. Akses kepada API bermula dengan perbualan, bukan kunci layan diri, sebahagiannya atas sebab di atas: kami lebih suka tahu siapa yang mengintegrasi, dan untuk pasaran mana, sebelum sebarang kelayakan wujud. Halaman API pelancongan menerangkan apa yang tersedia dan bagaimana perbualan itu bermula.

Sidang Pengarang Tekravel

Meja teknologi pelancongan

Meja teknologi pelancongan Tekravel menulis untuk industri: pemilik agensi, konsolidator dan pembangun yang mengintegrasikan mereka. Setiap artikel disemak pada platform yang diterangkannya sebelum diterbitkan.