Panduan praktis untuk developer dan tim teknis: dari persiapan, pemindaian otomatis, sampai perbaikan kode.
Pendahuluan
Laravel sudah menyediakan banyak proteksi bawaan: CSRF token, escaping Blade, query binding Eloquent, hashing password dengan bcrypt/argon2. Namun framework yang aman tidak otomatis membuat aplikasi aman. Kesalahan konfigurasi, dependency usang, otorisasi yang bolong, dan debug mode yang lupa dimatikan adalah penyebab paling sering aplikasi Laravel dibobol di production.
Artikel ini menyajikan checklist audit yang sistematis dengan dua pendekatan:
- OWASP Top 10 sebagai kerangka (apa saja yang harus diperiksa).
- OWASP ZAP sebagai alat pemindai otomatis (bagaimana memeriksanya secara dinamis).
Penting: lakukan scanning hanya pada aplikasi milik sendiri atau yang Anda punya izin tertulis untuk mengujinya. Idealnya jalankan di environment staging, bukan production, karena active scan dapat membuat banyak data sampah dan membebani server.
Persiapan Audit
1. Siapkan environment staging
Salin kode dan struktur database ke staging. Gunakan data dummy, jangan data pelanggan asli.
# Pastikan staging memakai konfigurasi mirip production
php artisan about
php artisan config:show app
Contoh keluaran ringkas:
Environment ........................................................
Application Name ............................................ Laravel
Laravel Version ............................................. 11.x
PHP Version ................................................. 8.3.x
Environment ............................................... staging
Debug Mode .............................................. OFF
URL ........................................ staging.contoh-domain.com
Jika Debug Mode masih ENABLED, hentikan audit dan perbaiki dulu. Itu temuan kritis.
2. Instal OWASP ZAP
Cara paling mudah dan reproducible adalah lewat Docker (berjalan di Windows, Linux, maupun macOS).
docker pull ghcr.io/zaproxy/zaproxy:stable
Alternatif: unduh ZAP Desktop dari situs resmi zaproxy.org jika ingin memakai antarmuka grafis.
Menjalankan OWASP ZAP
ZAP menyediakan beberapa mode. Gunakan sesuai kebutuhan:
| Mode | Skrip | Kegunaan |
|---|---|---|
| Baseline | zap-baseline.py |
Passive scan cepat, aman, cocok untuk CI/CD |
| Full Scan | zap-full-scan.py |
Spider + active scan, lebih lama dan agresif |
| API Scan | zap-api-scan.py |
Untuk REST API berbasis OpenAPI/Swagger |
Baseline scan (PowerShell / Windows)
docker run --rm -v ${PWD}:/zap/wrk/:rw -t ghcr.io/zaproxy/zaproxy:stable `
zap-baseline.py -t https://staging.contoh-domain.com `
-r laporan-zap.html -J laporan-zap.json
Baseline scan (Linux / macOS)
docker run --rm -v $(pwd):/zap/wrk/:rw -t ghcr.io/zaproxy/zaproxy:stable \
zap-baseline.py -t https://staging.contoh-domain.com \
-r laporan-zap.html -J laporan-zap.json
Contoh keluaran konsol:
Total of 38 URLs
PASS: Cookie No HttpOnly Flag [10010]
PASS: Cross-Domain JavaScript Source File Inclusion [10017]
WARN-NEW: Content Security Policy (CSP) Header Not Set [10038] x 12
WARN-NEW: Missing Anti-clickjacking Header [10020] x 12
WARN-NEW: X-Content-Type-Options Header Missing [10021] x 15
WARN-NEW: Server Leaks Version Information via "Server" HTTP Response Header Field [10036] x 15
FAIL-NEW: 0 FAIL-INPROG: 0 WARN-NEW: 4 WARN-INPROG: 0 INFO: 0 IGNORE: 0 PASS: 52
Kode keluar (exit code): 0 = lolos, 1 = ada FAIL, 2 = ada WARN. Ini berguna untuk menggagalkan pipeline CI.
Full scan dengan autentikasi
Banyak celah Laravel ada di balik login (dashboard admin, halaman pesanan). Untuk itu, scan harus dijalankan sebagai user yang sudah login. Di ZAP Desktop, gunakan Context > Authentication (Form-based) dan buat User dengan akun uji. Pastikan akun uji memiliki role berbeda (admin, staff, customer) agar bisa menguji otorisasi.
docker run --rm -v $(pwd):/zap/wrk/:rw -t ghcr.io/zaproxy/zaproxy:stable \
zap-full-scan.py -t https://staging.contoh-domain.com \
-r laporan-full.html -m 10
Opsi -m 10 membatasi waktu spider menjadi 10 menit.
Checklist Berdasarkan OWASP Top 10
Berikut checklist per kategori (acuan OWASP Top 10:2021). Setiap bagian berisi apa yang diperiksa, cara mengujinya, dan contoh perbaikan di Laravel.
A01 - Broken Access Control
Kategori ini menempati peringkat pertama dan paling sering ditemukan di aplikasi Laravel.
Checklist:
- ☐ Setiap route sensitif dilindungi middleware
auth. - ☐ Setiap aksi pada resource (lihat, ubah, hapus) dicek kepemilikan lewat Policy/Gate.
- ☐ Tidak ada IDOR: user A tidak bisa membuka
/orders/123milik user B. - ☐ Halaman admin dipisah dan dibatasi role.
- ☐ Route
debugbar,telescope,horizontidak terbuka untuk publik.
Contoh rawan (IDOR):
// RAWAN: siapa pun yang login bisa mengakses pesanan siapa pun
public function show($id)
{
$order = Order::findOrFail($id);
return view('orders.show', compact('order'));
}
Perbaikan dengan Policy:
php artisan make:policy OrderPolicy --model=Order
// app/Policies/OrderPolicy.php
public function view(User $user, Order $order): bool
{
return $user->id === $order->user_id || $user->isAdmin();
}
// Controller
public function show(Order $order)
{
$this->authorize('view', $order);
return view('orders.show', compact('order'));
}
Cek cepat daftar route dan middleware-nya:
php artisan route:list --columns=method,uri,middleware
+--------+------------------+-----------------+
| Method | URI | Middleware |
+--------+------------------+-----------------+
| GET | admin/dashboard | web, auth |
| GET | orders/{order} | web, auth |
| GET | api/users | api | <-- periksa! tanpa auth
+--------+------------------+-----------------+
A02 - Cryptographic Failures
Checklist:
- ☐ Seluruh situs memakai HTTPS dan HTTP dialihkan ke HTTPS.
- ☐
APP_KEYdi-generate dan tidak pernah masuk repository. - ☐ Password memakai
Hash::make(), bukan MD5/SHA1. - ☐ Data sensitif (NIK, nomor rekening) dienkripsi dengan
Cryptatau castencrypted. - ☐ Cookie sesi memakai flag
securedanhttp_only.
// config/session.php
'secure' => env('SESSION_SECURE_COOKIE', true),
'http_only' => true,
'same_site' => 'lax',
// Model: enkripsi otomatis kolom sensitif
protected function casts(): array
{
return [
'nomor_identitas' => 'encrypted',
'password' => 'hashed',
];
}
Paksa HTTPS di production:
// app/Providers/AppServiceProvider.php
use Illuminate\Support\Facades\URL;
public function boot(): void
{
if ($this->app->environment('production')) {
URL::forceScheme('https');
}
}
A03 - Injection (SQL Injection dan XSS)
Checklist:
- ☐ Tidak ada query mentah yang menyambung string dari input user.
- ☐ Output Blade memakai
{{ }};{!! !!}hanya untuk konten yang sudah disanitasi. - ☐ Semua input divalidasi lewat Form Request.
- ☐ Upload file divalidasi tipe dan ukurannya.
// RAWAN: SQL Injection
$users = DB::select("SELECT * FROM users WHERE email = '$email'");
// AMAN: parameter binding
$users = DB::select('SELECT * FROM users WHERE email = ?', [$email]);
// RAWAN: orderBy dari input mentah
Product::orderBy($request->sort)->get();
// AMAN: whitelist kolom
$sort = in_array($request->sort, ['name', 'price']) ? $request->sort : 'name';
Product::orderBy($sort)->get();
Cari penggunaan berisiko di codebase:
# Linux/macOS/Git Bash
grep -rn "DB::raw\|whereRaw\|selectRaw\|{!!" app resources
# PowerShell
Select-String -Path .\app\*,.\resources\* -Pattern "DB::raw|whereRaw|selectRaw|\{!!" -Recurse
Validasi upload:
public function rules(): array
{
return [
'foto' => ['required', 'image', 'mimes:jpg,jpeg,png,webp', 'max:2048'],
];
}
A04 - Insecure Design
Checklist:
- ☐ Ada pembatasan percobaan (rate limiting) pada login, reset password, OTP, dan checkout.
- ☐ Logika bisnis divalidasi di server (harga, diskon, stok tidak dipercaya dari form).
- ☐ Alur sensitif punya verifikasi ulang (misalnya ganti email atau password).
// Jangan percaya harga dari klien
$product = Product::findOrFail($request->product_id);
$total = $product->price * $request->integer('qty'); // hitung ulang di server
// app/Providers/AppServiceProvider.php
use Illuminate\Cache\RateLimiting\Limit;
use Illuminate\Support\Facades\RateLimiter;
RateLimiter::for('login', function ($request) {
return Limit::perMinute(5)->by($request->ip().'|'.$request->input('email'));
});
// routes/web.php
Route::post('/login', [AuthController::class, 'store'])->middleware('throttle:login');
A05 - Security Misconfiguration
Temuan ZAP paling banyak ada di kategori ini, terutama security header dan error page.
Checklist:
- ☐
APP_DEBUG=falsedanAPP_ENV=productiondi production. - ☐ File
.env,.git,storage/,vendor/tidak bisa diakses lewat web. - ☐ Web root mengarah ke folder
public/. - ☐ Security header terpasang (CSP, X-Frame-Options, X-Content-Type-Options, HSTS, Referrer-Policy).
- ☐ Versi server disembunyikan (
server_tokens offdi Nginx,expose_php = Off).
Uji paparan file sensitif dari terminal:
curl -I https://staging.contoh-domain.com/.env
curl -I https://staging.contoh-domain.com/.git/config
curl -I https://staging.contoh-domain.com/storage/logs/laravel.log
Hasil yang diharapkan:
HTTP/2 404
Jika muncul 200 OK, itu temuan kritis dan harus segera diperbaiki.
Middleware security header:
php artisan make:middleware SecurityHeaders
// app/Http/Middleware/SecurityHeaders.php
public function handle(Request $request, Closure $next)
{
$response = $next($request);
$response->headers->set('X-Frame-Options', 'SAMEORIGIN');
$response->headers->set('X-Content-Type-Options', 'nosniff');
$response->headers->set('Referrer-Policy', 'strict-origin-when-cross-origin');
$response->headers->set('Permissions-Policy', 'camera=(), microphone=(), geolocation=()');
$response->headers->set('Strict-Transport-Security', 'max-age=31536000; includeSubDomains');
$response->headers->set(
'Content-Security-Policy',
"default-src 'self'; img-src 'self' data: https:; script-src 'self'; style-src 'self' 'unsafe-inline'"
);
return $response;
}
Daftarkan di bootstrap/app.php (Laravel 11+):
->withMiddleware(function (Middleware $middleware) {
$middleware->append(\App\Http\Middleware\SecurityHeaders::class);
})
Catatan: CSP yang ketat dapat memblokir script inline, CDN, atau Livewire/Alpine.js. Uji bertahap, mulai dari
Content-Security-Policy-Report-Only, lalu sesuaikan.
Konfigurasi Nginx pendukung:
server_tokens off;
location ~ /\.(?!well-known) {
deny all;
}
A06 - Vulnerable and Outdated Components
Checklist:
- ☐ Laravel, PHP, dan package berada di versi yang masih didukung.
- ☐ Tidak ada package dengan kerentanan yang diketahui.
- ☐ Package yang tidak terpakai dihapus.
composer audit
composer outdated --direct
npm audit
Contoh keluaran:
$ composer audit
Found 1 security vulnerability advisory affecting 1 package:
Package: league/commonmark
CVE: CVE-XXXX-XXXXX
Title: Contoh judul advisory
Affected versions: <2.x.x
Reported at: 2025-01-01T00:00:00+00:00
Jalankan composer audit secara rutin di CI agar tidak terlewat.
A07 - Identification and Authentication Failures
Checklist:
- ☐ Kebijakan password minimal (panjang, tidak umum, tidak bocor).
- ☐ Session di-regenerate setelah login dan dihapus saat logout.
- ☐ Ada rate limiting login (lihat A04).
- ☐ Tersedia 2FA untuk akun admin.
- ☐ Token reset password kedaluwarsa dan sekali pakai.
use Illuminate\Validation\Rules\Password;
'password' => [
'required', 'confirmed',
Password::min(10)->letters()->mixedCase()->numbers()->uncompromised(),
],
// Logout yang benar
Auth::logout();
$request->session()->invalidate();
$request->session()->regenerateToken();
A08 - Software and Data Integrity Failures
Checklist:
- ☐ File
composer.lockdanpackage-lock.jsonikut di-commit. - ☐ Deployment tidak menjalankan skrip dari sumber yang tidak tepercaya.
- ☐ Tidak ada
unserialize()pada data dari user. - ☐ Webhook (payment gateway, WhatsApp, dsb.) memverifikasi signature.
- ☐ Script CDN memakai atribut
integrity(SRI).
// Verifikasi signature webhook
$signature = hash_hmac('sha256', $request->getContent(), config('services.gateway.secret'));
abort_unless(hash_equals($signature, $request->header('X-Signature', '')), 403);
A09 - Security Logging and Monitoring Failures
Checklist:
- ☐ Login gagal, perubahan hak akses, dan aksi admin dicatat.
- ☐ Log tidak berisi password, token, atau data kartu.
- ☐ Ada alert untuk lonjakan error atau percobaan login mencurigakan.
- ☐ Log dirotasi dan tidak dapat diakses publik.
use Illuminate\Support\Facades\Log;
Log::channel('security')->warning('Login gagal', [
'email' => $request->input('email'),
'ip' => $request->ip(),
'ua' => $request->userAgent(),
]);
// config/logging.php
'security' => [
'driver' => 'daily',
'path' => storage_path('logs/security.log'),
'days' => 30,
],
A10 - Server-Side Request Forgery (SSRF)
Checklist:
- ☐ Fitur yang mengambil URL dari user (import gambar, preview link, webhook) memakai whitelist domain.
- ☐ Alamat internal (
127.0.0.1,169.254.169.254, jaringan privat) diblokir.
$host = parse_url($request->input('url'), PHP_URL_HOST);
$allowed = ['cdn.contoh-domain.com', 'images.contoh-domain.com'];
abort_unless(in_array($host, $allowed, true), 422, 'Domain tidak diizinkan');
$response = Http::timeout(5)->get($request->input('url'));
Membaca dan Memprioritaskan Laporan ZAP
Laporan ZAP mengelompokkan temuan berdasarkan tingkat risiko. Gunakan urutan prioritas berikut:
| Risiko | Tindakan |
|---|---|
| High | Perbaiki segera sebelum rilis |
| Medium | Jadwalkan perbaikan dalam sprint berjalan |
| Low | Masukkan ke backlog |
| Informational | Tinjau, abaikan jika tidak relevan |
Langkah menganalisis temuan:
- Buka
laporan-zap.html, lihat ringkasan jumlah alert per level. - Periksa false positive: tidak semua alert adalah celah nyata, verifikasi manual dengan
curlatau browser. - Petakan setiap temuan ke kategori OWASP Top 10 agar terdokumentasi rapi.
- Catat di tracker (GitHub Issues, Trello, atau Jira) lengkap dengan URL, parameter, dan bukti.
- Setelah diperbaiki, scan ulang untuk memastikan temuan hilang.
Untuk menandai false positive yang sudah diverifikasi, gunakan file konfigurasi aturan:
# Hasilkan template konfigurasi
docker run --rm -v $(pwd):/zap/wrk/:rw -t ghcr.io/zaproxy/zaproxy:stable \
zap-baseline.py -t https://staging.contoh-domain.com -g zap-rules.conf
# Ubah aksi aturan tertentu menjadi IGNORE di zap-rules.conf, lalu jalankan:
docker run --rm -v $(pwd):/zap/wrk/:rw -t ghcr.io/zaproxy/zaproxy:stable \
zap-baseline.py -t https://staging.contoh-domain.com -c zap-rules.conf -r laporan.html
Otomatisasi di CI/CD (GitHub Actions)
Agar audit tidak hanya dilakukan sekali, masukkan baseline scan ke pipeline.
# .github/workflows/security.yml
name: Security Scan
on:
schedule:
- cron: '0 2 * * 1' # setiap Senin 02:00 UTC
workflow_dispatch:
jobs:
composer-audit:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: shivammathur/setup-php@v2
with:
php-version: '8.3'
- run: composer install --no-interaction --prefer-dist
- run: composer audit
zap-baseline:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: ZAP Baseline Scan
uses: zaproxy/action-baseline@v0.12.0
with:
target: 'https://staging.contoh-domain.com'
rules_file_name: 'zap-rules.conf'
cmd_options: '-a'
Sesuaikan versi action dengan rilis terbaru di repository resminya.
Checklist Ringkas (Siap Cetak)
Persiapan
- ☐ Audit dilakukan di staging dengan izin yang jelas
- ☐ Akun uji tersedia untuk tiap role
- ☐ Backup database sebelum active scan
Konfigurasi dasar
- ☐
APP_DEBUG=false,APP_ENV=production - ☐ HTTPS aktif dan dipaksa, HSTS terpasang
- ☐
.env,.git, danstorage/tidak dapat diakses publik - ☐ Security header lengkap
Kode aplikasi
- ☐ Policy/Gate di semua resource milik user
- ☐ Form Request untuk validasi input
- ☐ Tidak ada query mentah yang rawan injection
- ☐ Rate limiting pada login dan endpoint sensitif
- ☐ Verifikasi signature pada webhook
Dependency dan operasional
- ☐
composer auditdannpm auditbersih - ☐ Logging keamanan aktif dan tanpa data sensitif
- ☐ ZAP baseline berjalan terjadwal di CI
Penutup
Audit keamanan bukan kegiatan sekali jalan. Kombinasi yang efektif adalah OWASP Top 10 sebagai peta, OWASP ZAP sebagai pemindai dinamis, serta review kode manual untuk logika bisnis dan otorisasi yang tidak bisa dideteksi alat otomatis. Mulailah dengan baseline scan mingguan, perbaiki temuan High dan Medium, lalu tingkatkan ke full scan terautentikasi sebelum rilis besar.
Perlu dicatat, artikel ini mengacu pada OWASP Top 10 edisi 2021 yang masih menjadi rujukan luas. OWASP juga telah merilis pembaruan daftar berikutnya, jadi periksa situs resmi owasp.org untuk penyesuaian kategori; prinsip dan langkah audit di atas tetap relevan.
Referensi: owasp.org/Top10, zaproxy.org/docs, laravel.com/docs/security.