BOLA pada API terjadi ketika server gagal memeriksa hak pengguna terhadap objek yang diminta. Pada aplikasi pemesanan, objek itu bisa berupa pesanan milik toko lain. Pengguna mungkin sudah mempunyai sesi yang sah, sementara pemeriksaan akses ke pesanan masih belum lengkap. OWASP API1:2023
Tulisan ini membahas cara menyusun pengujian otorisasi API melalui skenario dua toko, membaca bukti, merancang perbaikan, dan melakukan retest. Contoh difokuskan pada pembacaan detail pesanan agar aturan serta hasil pengujiannya dapat ditelusuri dengan jelas.
Seluruh akun, ID pesanan, versi aplikasi, dan respons HTTP di bawah merupakan ilustrasi lab fiktif. Langkah praktik ditujukan untuk lingkungan yang mempunyai izin pengujian dan memakai data sintetis.
Apa hubungan BOLA, IDOR, dan otorisasi API ?
Autentikasi menetapkan identitas pengguna. Otorisasi memutuskan apakah identitas tersebut boleh melakukan tindakan tertentu terhadap suatu sumber daya. Dalam alur pemesanan, keputusan itu mencakup pengguna, toko, pesanan, dan tindakan membaca atau mengubah data. OWASP Authorization Cheat Sheet
Istilah IDOR, singkatan dari Insecure Direct Object References, digunakan untuk membahas akses ke objek melalui referensi yang dikendalikan pengguna tanpa pemeriksaan izin yang memadai. Referensi tersebut dapat muncul sebagai parameter atau bagian dari URL. OWASP WSTG tentang IDOR
Dalam pembahasan keamanan API, BOLA, singkatan dari Broken Object Level Authorization, menekankan kegagalan kebijakan akses pada objek. Skenario mengganti ID pesanan untuk membaca data pihak lain dapat dibahas dalam kedua konteks itu. Format ID, termasuk UUID, tetap perlu disertai pemeriksaan hak akses. OWASP API1:2023
Tentukan kebijakan akses sebelum mengirim request
Bayangkan aplikasi pemesanan yang melayani toko A dan toko B. Setiap toko menjadi batas pemisahan data atau tenant. Pada skenario ini, staf toko A boleh membaca seluruh pesanan toko A. Aturan yang sama berlaku untuk staf toko B. Akses lintas toko oleh staf biasa dilarang.
Gunakan dua akun dan dua pesanan sintetis berikut sebagai bahan pengujian.
| Akun uji | Keanggotaan | Pesanan milik toko |
|---|---|---|
| Staf A | Toko A | ORD-A-1001 |
| Staf B | Toko B | ORD-B-2001 |
Tuliskan aturan tersebut bersama pemilik aplikasi. Jika staf hanya boleh membaca pesanan yang ditugaskan kepadanya, hubungan penugasan juga menjadi bagian dari kebijakan. Bila ada administrator lintas toko, peran itu membutuhkan skenario pengujian tersendiri.
Tentukan pula endpoint, metode HTTP, versi aplikasi, data uji, dan batas dampak. Untuk contoh ini, cakupannya adalah GET /api/orders/{id} pada aplikasi fiktif versi lab-1.0. Pengujian perubahan pesanan berada pada pekerjaan yang perlu disepakati secara terpisah.
Susun matriks pengujian akses antar-toko
Mulailah dengan permintaan yang seharusnya diizinkan. Pastikan staf A dapat membaca ORD-A-1001 dan staf B dapat membaca ORD-B-2001. Pemeriksaan ini membantu memastikan akun, sesi, dan data uji berfungsi sebelum hasil penolakan ditafsirkan.
Selanjutnya, lakukan pemeriksaan akses lintas toko dengan mempertahankan identitas akun. Staf A meminta pesanan toko B, kemudian staf B meminta pesanan toko A. Pengujian tanpa sesi memberikan kontrol tambahan untuk memeriksa batas autentikasi.
| Identitas | Objek yang diminta | Hasil yang diharapkan |
|---|---|---|
| Staf A | Pesanan toko A | Diizinkan |
| Staf A | Pesanan toko B | Ditolak tanpa rincian pesanan |
| Staf B | Pesanan toko B | Diizinkan |
| Staf B | Pesanan toko A | Ditolak tanpa rincian pesanan |
| Tanpa sesi | Salah satu pesanan uji | Ditolak |
Penggunaan lebih dari satu akun membantu membedakan kepemilikan objek dan hak akses. Prinsip pengujian ini juga dijelaskan dalam panduan pengujian IDOR OWASP. OWASP WSTG-ATHZ-04
Baca bukti akses yang melanggar kebijakan
Pada simulasi awal, staf A menggunakan sesi aktifnya untuk membuka pesanan toko B.
GET /api/orders/ORD-B-2001 Sesi aktif: staf A, anggota toko A Server dalam skenario ini mengembalikan 200 OK dengan body berikut.
{ "order_id": "ORD-B-2001", "tenant_id": "toko-b", "items": [{"sku": "DEMO-02", "qty": 2}] } Catatan temuan perlu menghubungkan identitas pengirim, kepemilikan pesanan, dan aturan yang dilanggar. Respons tersebut menjadi bukti yang bermakna ketika sesi benar-benar milik staf A dan ORD-B-2001 benar-benar milik toko B.
Periksa apakah akun uji memiliki peran tambahan, keanggotaan toko lain, atau sesi administrator yang tertinggal. Tinjau pula kemungkinan data berasal dari cache yang salah. Pemeriksaan pembanding membantu mengarahkan perbaikan ke penyebab yang didukung bukti.
Di lab ini, mengetahui ID pesanan merupakan prasyarat. Satu respons menunjukkan akses ke objek tersebut. Kemampuan memperoleh ID lain, membaca seluruh pesanan, atau mengubah data memerlukan pemeriksaan serta bukti tambahan dalam cakupan yang diizinkan.
Perbaiki keputusan akses sebelum data dikirim
Jika peninjauan kode menunjukkan bahwa pencarian pesanan hanya memakai ID tanpa evaluasi kebijakan, tambahkan pemeriksaan izin pada jalur server. Keputusan akses perlu mempertimbangkan keanggotaan toko yang sah dan tindakan yang diminta.
Berikut pseudocode untuk memperlihatkan urutan keputusan. Implementasi produksi perlu mengikuti mekanisme sesi, kebijakan, dan penanganan error pada framework yang digunakan.
session = validate_session(request) if session is invalid: return 401 order = find_order(request.order_id) if order does not exist: return 404 if policy.can_read_order(session.user, order) is false: return 403 without order details return 200 with the permitted order fields Tentukan konteks tenant dari kewenangan pengguna
Pilihan toko yang dikirim browser merupakan masukan yang perlu divalidasi. Server dapat mencocokkannya dengan keanggotaan pengguna yang tersimpan atau konteks sesi yang telah diverifikasi. Sebagai rancangan untuk lab ini, perubahan nilai tenant_id pada request tidak memberikan hak ke toko tambahan.
Lingkupi pencarian data dan keluaran respons
Pada desain yang sesuai, kueri atau repositori dapat dibatasi ke tenant yang berwenang. Kebijakan peran tetap diperlukan jika anggota tenant memiliki izin yang berbeda. Setelah akses disetujui, serializer menentukan bidang pesanan yang boleh terlihat untuk peran tersebut.
Evaluasi kebijakan pada setiap jalur akses
Gunakan aturan akses yang dapat ditinjau dan diuji secara konsisten. Periksa pemanggil service yang sama, termasuk pekerjaan latar belakang jika digunakan. OWASP merekomendasikan hak minimum, penolakan secara default, dan evaluasi izin pada setiap request. OWASP Authorization Cheat Sheet
Lakukan retest pada akses sah dan akses terlarang
Setelah perbaikan, ulangi request awal pada versi fiktif lab-1.1 menggunakan akun dan objek yang sama. Simpan perbandingan respons serta identitas rilis agar hasilnya memiliki konteks.
Tabel berikut merupakan hasil retest ilustratif untuk skenario pembelajaran ini.
| Skenario | lab-1.0 | lab-1.1 |
|---|---|---|
Staf A membaca ORD-A-1001 | 200, data toko A | 200, data toko A |
Staf A membaca ORD-B-2001 | 200, data toko B | 403, tanpa data pesanan |
Staf B membaca ORD-B-2001 | 200, data toko B | 200, data toko B |
Staf B membaca ORD-A-1001 | 200, data toko A | 403, tanpa data pesanan |
| Permintaan tanpa sesi | 401 | 401 |
| Staf A meminta ID yang tidak ada | 404 | 404 |
Periksa body respons ketika akses ditolak. Evaluasi juga header atau metadata yang berpotensi mengungkap informasi yang dibatasi. Untuk alur yang dapat mengubah data, pemeriksaan retest perlu mencakup keadaan objek sesudah request agar perubahan samping terdeteksi.
Akses sah yang tetap berhasil merupakan bagian dari kriteria penerimaan. Penolakan seluruh request dapat membuat pengujian negatif terlihat lulus, sementara fungsi layanan terhenti bagi pengguna yang berwenang.
Pilih respons 403 atau 404 sesuai kebijakan
Dalam rancangan lab ini, akun sah yang tidak berhak membaca pesanan mendapat 403 Forbidden. API juga dapat memilih 404 Not Found untuk menyembunyikan keberadaan sumber daya yang ditolak, sebagaimana diperbolehkan oleh HTTP Semantics. RFC 9110, bagian 15.5.4
Dokumentasikan pilihan tersebut agar pengembang dan penguji mempunyai ekspektasi yang sama. Bila API memakai bearer token dan memberikan status 401, periksa pula mekanisme challenge autentikasinya. RFC 9110 mensyaratkan header WWW-Authenticate yang sesuai pada respons 401. RFC 9110, bagian 15.5.2
Dokumentasikan dampak dan cakupan temuan
Laporan untuk contoh ini dapat dimulai dengan kalimat singkat yang bisa dipahami pemilik bisnis: staf toko A dapat membaca rincian pesanan toko B melalui endpoint detail pesanan dengan menggunakan sesi miliknya sendiri.
Setelah itu, uraikan bahan yang memungkinkan pengembang meninjau masalah dan memeriksa perbaikannya.
| Bagian laporan | Isi untuk skenario lab |
|---|---|
| Aset dan versi | Endpoint detail pesanan pada lab-1.0 |
| Kebijakan | Staf membaca pesanan pada toko tempatnya menjadi anggota |
| Prasyarat | Akun staf aktif dan ID pesanan sintetis milik toko lain |
| Bukti | Request pembanding serta respons yang menunjukkan data lintas toko |
| Dampak teramati | Kode produk dan jumlah barang pada pesanan toko lain terlihat |
| Perbaikan | Evaluasi izin pada objek sebelum mengirimkan data |
| Retest | Versi lab-1.1, skenario yang diulang, dan hasil akses sah maupun terlarang |
Prioritas temuan membutuhkan konteks jenis data, paparan endpoint, prasyarat, dan dampak bisnis. Pada laporan nyata, tambahan kesimpulan seperti akses massal atau pengambilalihan akun harus mempunyai bukti yang sesuai. Untuk lab ini, dampak dibatasi pada pembacaan informasi pesanan yang ditampilkan.
Sebagai materi pendamping, Nusantara Secure menyediakan contoh laporan publik untuk skenario lab serupa, termasuk ringkasan bisnis, bukti ilustratif, rekomendasi, dan tabel retest. Contoh laporan pentest API dan retest
Perluas pengujian sesuai jalur data aplikasi
Sesudah endpoint detail diperiksa, petakan alur lain yang dapat menampilkan atau memproses pesanan. Dalam rancangan pengujian lanjutan, pertimbangkan daftar pesanan, pencarian, ekspor, lampiran, pembatalan, dan proses latar belakang yang menghasilkan dokumen.
Untuk ekspor asinkron, misalnya, catat identitas pembuat pekerjaan dan aturan ketika berkas hasil diambil. Untuk aplikasi dengan fitur berpindah toko, masukkan kasus perubahan tenant aktif dan pencabutan keanggotaan. Setiap perluasan tersebut memerlukan data serta ekspektasi pengujiannya sendiri.
Tambahkan kasus yang sudah disepakati ke pengujian regresi. Catat peran, tindakan, objek, dan tenant agar kegagalan bisa ditelusuri ketika kebijakan berubah. Pemisahan kasus juga membantu menemukan perbaikan yang hanya berlaku pada salah satu jalur aplikasi.
Pertanyaan yang muncul saat meninjau otorisasi
Apakah UUID menyelesaikan masalah akses antar-toko ?
UUID dapat mempersulit penebakan ID, tetapi hak membaca pesanan tetap harus dievaluasi. Dalam rancangan pengujian, gunakan ID sintetis yang sudah diketahui agar hasil menunjukkan perilaku otorisasi terhadap objek tersebut. OWASP API1:2023
Kapan temuan boleh dinyatakan sudah diperbaiki ?
Tentukan kriteria penerimaan sebelum retest. Untuk lab ini, akses lintas toko ditolak tanpa data pesanan, akses toko sendiri tetap bekerja, dan hasilnya dicatat pada versi yang diperiksa. Status perbaikan berlaku pada cakupan pengujian tersebut.
Bagaimana bila dua toko memang boleh berbagi pesanan ?
Tuliskan hubungan berbagi sebagai kebijakan yang eksplisit. Matriks perlu mencakup akses sebelum dibagikan, setelah dibagikan, dan setelah izin berbagi dicabut. Dalam skenario dua toko artikel ini, staf biasa tidak memiliki hubungan berbagi tersebut.
Aturan akses objek apa yang paling sulit dituangkan menjadi pengujian regresi pada aplikasi yang Anda kembangkan ?
