1. Pendahuluan: Lanskap Ancaman Terhadap API Modern
Dalam arsitektur web modern, sebagian besar fungsionalitas bisnis diekspos melalui RESTful atau RPC API endpoint. Pola arsitektur ini memindahkan beban interaksi ke sisi klien, tetapi sekaligus memperluas permukaan serangan (attack surface). Ancaman paling umum yang kami temui dalam audit keamanan web korporat di Indonesia meliputi:
- Broken Object Level Authorization (BOLA / IDOR): Pengguna dapat mengakses atau memodifikasi data entitas lain hanya dengan mengubah ID pada parameter URL.
- Penyimpanan Token Sesi yang Tidak Aman: Menyimpan JWT (JSON Web Token) di
localStoragebrowser yang rentan dibaca oleh skrip jahat pihak ketiga melalui serangan XSS. - Ketiadaan Rate Limiting: Endpoint login dan pendaftaran yang dibiarkan tanpa batas request mudah diserang metode credential stuffing dan brute force.
2. Arsitektur Manajemen Token Sesi Tanpa Celah
Untuk mengeliminasi risiko pencurian token otentikasi, PT. Matoh Technologies mengadopsi standar Secure Cookie-Based Session Management:
Arsitektur Cookie Sesi Aman:
Set-Cookie: __Secure-authjs.session-token=...;
Path=/;
HttpOnly;
Secure;
SameSite=Lax;
Max-Age=2592000- HttpOnly: Menjamin bahwa token sesi sama sekali tidak dapat diakses oleh JavaScript browser (
document.cookie), melumpuhkan dampak pencurian token saat terjadi XSS minor. - Secure: Cookie hanya ditransmisikan melalui kanal terenkripsi HTTPS.
- SameSite=Lax: Melindungi pengguna dari serangan Cross-Site Request Forgery (CSRF) saat membuka tautan dari situs eksternal.
3. Implementasi Rate Limiting Adaptif
Tanpa pembatasan laju permintaan (rate limiting), penyerang dapat membanjiri server dengan ribuan request per detik, melumpuhkan CPU dan koneksi database. Kami mengimplementasikan algoritma Token Bucket adaptif:
// Contoh Penerapan Rate Limiter Adaptif pada Endpoint Kritis
import { checkRateLimit } from "@/lib/rate-limit";
import { NextResponse } from "next/server";
export async function POST(req: Request) {
const ip = req.headers.get("x-forwarded-for")?.split(",")[0] || "127.0.0.1";
// Batasi maksimal 5 percobaan per 1 menit untuk login
const limit = checkRateLimit(`login:${ip}`, { maxRequests: 5, windowMs: 60_000 });
if (!limit.allowed) {
return NextResponse.json(
{ error: "Terlalu banyak permintaan. Silakan tunggu sesaat." },
{ status: 429, headers: { "Retry-After": String(limit.resetInSeconds) } }
);
}
// Lanjutkan pemrosesan kredensial
}4. Mitigasi Path Traversal dan Upload Sanitization
Endpoint yang menerima pengunggahan berkas (seperti tugas siswa atau foto profil) harus diaudit secara menyeluruh dari celah eksekusi kode berbahaya:
- Validasi MIME-Type Sejati: Jangan pernah mempercayai ekstensi nama file dari pengguna. Lakukan inspeksi magic numbers pada byte awal berkas menggunakan library parser biner.
- Normalisasi Nama Berkas: Hindari penyimpanan berkas dengan nama asli pengguna. Buat identifier acak unik (misal:
nanoid() + ".jpg") dan pastikan jalur path tidak mengandung../atau karakter null byte (\0). - Pemisahan Direktori Simpan: Letakkan berkas unggahan di luar folder eksekusi kode server utama agar berkas tidak dapat dipanggil langsung sebagai skrip executable.
5. Rekomendasi Checklist Audit
Bagi tim teknis pengembang platform internal, kami merekomendasikan daftar periksa berkala berikut:
- Nonaktifkan pesan error internal database mentah pada respons HTTP publik.
- Pastikan semua operasi mutasi (POST/PUT/DELETE) memverifikasi hak kepemilikan data (
userIdpada sesi =ownerIdpada database). - Aktifkan rotasi kunci enkripsi JWT secara berkala.
- Jalankan audit dependensi rutin (
npm audit) untuk menambal kelemahan pustaka pihak ketiga.