Lewati ke konten
Blog

Keamanan API perjalanan: dari mana data tenant bocor

Redaksi Tekravel
Ditulis dengan bantuan AI

Seorang developer di salah satu agen partner Anda sedang menguji integrasinya pada Selasa sore. Ia melihat endpoint daftar booking menerima agencyId di query string, lalu karena penasaran mengubahnya dari 114 menjadi 115. Responsnya berisi booking milik orang lain: nama penumpang, PNR, dan tarif net yang dibayar agen itu sebelum ditambah margin. Tidak ada yang menyerang apa pun. API hanya memercayai apa yang dikatakan klien. Satu sore itu adalah hampir seluruh inti dari autentikasi dan keamanan API perjalanan, dan itulah sebabnya topik ini layak mendapat perhatian lebih besar daripada yang biasanya diberikan pada layar login.

API perjalanan multi-tenant bocor lewat sejumlah kecil jalur yang bisa diduga. Layak disebut satu per satu, karena masing-masing punya jawaban desain yang jauh lebih murah sebelum peluncuran dibanding sesudahnya.

Tenant bukan parameter

Kesalahan di pembuka tadi bukan soal pemeriksaan yang terlewat. Itu desain yang bertanya kepada pemanggil siapa dirinya, lalu memercayai jawabannya. Pada sistem satu klien, ini sekadar berantakan. Pada platform tempat puluhan agen, sub-agen, dan situs white-label berbagi satu database, seluruh model keamanan bertumpu pada kejujuran setiap integrator yang pernah memegang kunci.

Aturan yang menghapus seluruh kelas bug ini: tenant berasal dari kredensial, bukan dari request. Saat kunci atau token diverifikasi, server menentukan tenant mana pemiliknya, kantor mana di dalam tenant itu, dan peran apa yang dimiliki pemanggil. Sejak itu setiap query berjalan dalam cakupan tersebut. Body request tetap boleh membawa ID agen untuk alasan yang sah, misalnya konsolidator yang membuat booking atas nama salah satu sub-agennya, tetapi server mencocokkan ID itu dengan cakupan yang sudah ditetapkan kredensial. Cakupan tidak pernah diperluas hanya karena sebuah field memintanya.

Dalam praktik, tiga hal berada di sisi server:

  • Scoping di lapisan data, bukan di setiap handler. Filter yang diterapkan otomatis pada setiap query atas tabel milik tenant berarti developer yang lupa klausa where mendapat hasil kosong, bukan data orang lain. Pemeriksaan per handler gagal begitu seseorang menambah endpoint dengan terburu-buru.
  • Pemeriksaan tingkat objek pada setiap ID di path. GET /bookings/98231 harus memastikan booking 98231 berada dalam cakupan pemanggil. Karena ID berurutan, ini lubang paling umum di API perjalanan; nomor booking dan referensi PNR mudah ditebak.
  • Jawaban yang sama untuk "bukan milik Anda" dan "tidak ada". Kembalikan 404 untuk booking tenant lain. Kode 403 membenarkan bahwa datanya nyata, dan itu saja sudah informasi yang ingin dimiliki pesaing.

Pintu darurat pun butuh disiplin yang sama. Kebanyakan platform memerlukan tampilan operator yang membaca lintas tenant: tim support, keuangan, pemilik platform. Jadikan itu peran terpisah, diberikan lewat kode dan dicatat setiap kali dipakai, bukan flag query yang bisa diatur oleh pemanggil terautentikasi mana pun. Tentang bagaimana integrasi sisi klien semestinya berperilaku di sekitar batas-batas ini, artikel tentang integrasi API pemesanan tiket pesawat membahas sisi request-nya.

Kredensial supplier tidak pernah sampai ke browser

Platform perjalanan menyimpan dua jenis rahasia. Yang pertama milik Anda: kunci yang Anda terbitkan untuk partner. Yang kedua milik hubungan Anda dengan supplier: kredensial office GDS, token agregator NDC, kunci API bedbank, sering terikat pada kontrak yang menyebut perusahaan dan nomor IATA Anda. Setiap request yang dibuat dengan kredensial itu, bagi supplier, adalah request dari Anda.

Kredensial tersebut hanya punya satu tempat aman: proses server yang berbicara dengan supplier atas nama pemanggil. Tempatnya bukan di bundle JavaScript aplikasi single-page, di binary aplikasi mobile, di file konfigurasi yang dikirim ke browser "hanya untuk halaman pencarian", atau di pesan error yang dikembalikan saat panggilan ke supplier gagal. Setiap tempat itu pernah menjadi sumber kebocoran di suatu tempat. Siapa saja bisa membuka tab network, dan binary aplikasi bisa dibongkar oleh siapa pun yang mau.

Akibatnya lebih buruk daripada tagihan. Kunci supplier yang bocor memungkinkan orang asing mencari, kadang juga memesan, atas akun Anda: rasio look-to-book yang dijadikan ukuran oleh supplier terkuras, dan dalam kasus terburuk tiket diterbitkan dengan kredit Anda. Supplier tidak akan membedakan lalu lintas itu dari lalu lintas Anda. Hasil yang lazim adalah akun disuspensi selama Anda membuktikan itu bukan Anda, yang bagi agen yang sebagian besar menjual satu maskapai atau satu bedbank berarti toko tutup selama prosesnya.

Dua aturan kecil menyusul. Klien tidak pernah memilih akun supplier mana yang dilewati sebuah request; server memilihnya dari konfigurasi tenant. Dan isi error supplier diterjemahkan sebelum keluar dari API Anda, sebab error mentah supplier kadang memantulkan header request apa adanya.

Berapa sebenarnya biaya tarif net yang bocor

Developer cenderung meranking kebocoran data menurut seberapa pribadi datanya. Dalam distribusi perjalanan, field yang paling berbahaya secara komersial sering kali adalah harga. Tarif net adalah angka yang disepakati supplier untuk Anda dengan syarat tidak diperlihatkan ke publik, dan selisihnya dengan harga jual adalah margin Anda dan margin sub-agen Anda. Tabel di bawah adalah peringkat kasar. Bobot tiap baris bisa Anda nilai berbeda untuk bisnis Anda, dan perbedaan pendapat itu layak dibahas dengan tim sebelum insiden, bukan saat insiden.

Yang bocorSiapa yang biasanya menemukanBiayanya bagi Anda
Tarif net di dalam respons pencarian B2C (tersembunyi di JSON, bukan di layar)Pesaing yang melakukan scraping, pelanggan yang penasaranKeluhan supplier soal paritas harga, dan pelanggan yang bertanya mengapa mereka membayar harga terpublikasi
Margin atau harga net sub-agen lainSub-agen yang membandingkan catatanHarga dibuka kembali di seluruh jaringan; agen dengan kesepakatan lebih baik menjadi bahan pembicaraan
Kredensial supplier di bundle klienSiapa pun yang melihatLalu lintas dan booking di akun Anda, kemungkinan suspensi selama penyelidikan
ID booking atau PNR yang bisa dienumerasiScraper, sesekali jurnalisPaparan data penumpang, yang bobot regulasinya jauh melampaui kerugian komersial
Limit kredit dan saldo agen lainPartner, pesaingAkun terlemah di jaringan Anda menjadi target pembajakan

Baris pertama sering terlewat karena layarnya tampak benar. Halaman menampilkan harga jual; respons yang memberinya data membawa net dan margin sebagai field terpisah karena frontend "mungkin butuh". Bentuk respons per audiens di server. Pemanggil B2C mendapat harga jual dan tidak ada apa pun yang memungkinkan pengurangan. Artikel tentang mendistribusikan tarif net ke sub-agen menjelaskan mengapa selisih itulah yang dijual konsolidator.

Merotasi kredensial tanpa downtime

Setiap kredensial pada akhirnya perlu diganti. Developer keluar dari agen partner, kunci muncul di repositori publik, supplier merotasi kunci sesuai jadwalnya sendiri. Jika rotasi berarti "ganti, lalu semuanya rusak sampai partner redeploy", tidak ada yang merotasi, dan kunci hidup bertahun-tahun.

Rancang tumpang tindih sejak hari pertama. Setiap partner dapat memegang dua kunci aktif sekaligus: membuat yang baru, men-deploy-nya, melihat lalu lintasnya berpindah, dan baru kemudian mencabut yang lama. Agar itu berjalan, platform membutuhkan beberapa komponen yang tidak glamor:

  1. Pengenal kunci yang terlihat, berupa prefiks atau ID yang disimpan di samping rahasia, sehingga log dan tiket support bisa menyebut kunci mana yang melakukan panggilan tanpa ada yang melihat rahasianya.
  2. Rahasia disimpan sebagai hash, ditampilkan sekali saat pembuatan dan tidak pernah lagi. Jika tim support Anda bisa membaca kunci partner, siapa pun yang membobol tool support Anda juga bisa.
  3. Cap waktu penggunaan terakhir per kunci, agar partner bisa melihat bahwa kunci lama sudah sepi sebelum mencabutnya.
  4. Pencabutan yang berlaku seketika, termasuk di cache mana pun di depan autentikasi.

Kredensial supplier memerlukan tumpang tindih yang sama ke arah sebaliknya. Simpan di secrets store atau konfigurasi terenkripsi yang dibaca ulang oleh layanan yang berjalan, bukan ditanam di build, sehingga pergantiannya berupa perubahan konfigurasi, bukan deployment. Access token berumur pendek di atas kunci berumur panjang juga membantu: jika token bocor, ia kedaluwarsa sebelum kebanyakan orang menyadari token itu hilang.

Rotasi juga tempat logging terbayar. Mencatat kunci dan tenant mana yang melakukan setiap panggilan, tanpa mencatat rahasia atau data pembayaran penumpang, memungkinkan Anda menjawab "apakah itu kita?" dalam satu jam, bukan satu minggu.

Sebelum Anda menyerahkan kunci ke partner

Daftar singkat, karena versi panjangnya adalah sisa tulisan ini:

  • Adakah sesuatu di dalam request yang bisa mengubah tenant sebuah kunci? Seharusnya tidak.
  • Apakah setiap endpoint yang menerima ID memeriksa kepemilikan dan menjawab 404 ketika pemeriksaan gagal?
  • Apakah ada kredensial supplier, atau field turunannya, yang bisa dijangkau dari browser?
  • Apakah respons B2C memuat harga net atau margin di mana pun, termasuk field tersembunyi?
  • Bisakah partner merotasi tanpa menelepon Anda, dan bisakah Anda mencabut tanpa menelepon mereka?

Bagaimana akses ke API kami ditangani

Platform di balik blog ini menyediakan API penerbangan dan hotel. Setiap tenant di dalamnya sudah berjalan dengan panel admin sendiri, booking sendiri, dan izin staf berbasis peran, dan konten supplier sampai ke tenant lewat grup supplier, bukan kesepakatan satu lawan satu. Akses ke API dimulai dengan percakapan, bukan kunci swalayan, sebagian karena alasan di atas: kami lebih suka tahu siapa yang berintegrasi, dan untuk pasar mana, sebelum kredensial dibuat. Halaman API perjalanan menjelaskan apa yang tersedia dan bagaimana percakapan itu dimulai.

Redaksi Tekravel

Meja teknologi perjalanan

Meja teknologi perjalanan Tekravel menulis untuk pelaku industri: pemilik agen, konsolidator, dan para pengembang yang mengintegrasikan mereka. Setiap artikel diperiksa pada platform yang dijelaskannya sebelum diterbitkan.