Cara Membatasi Percobaan Login di Laravel: Throttle, Lockout & Anti Brute Force (Panduan 2026)
Cara membatasi percobaan login di Laravel adalah dengan memasang middleware throttle pada route login, misalnya throttle:5,1 yang berarti maksimal 5 percobaan per menit, lalu menambahkan limiter kedua yang hanya menghitung percobaan gagal per email dan per IP. Kombinasi ini menghentikan brute force tanpa mengunci pengguna sah yang sekadar salah ketik password.
Apa itu login throttling dan brute force?
Brute force adalah serangan yang menebak password dengan mencoba ribuan kombinasi otomatis lewat form login atau endpoint API. Login throttling memutus pola ini: setelah sejumlah percobaan dalam jangka waktu tertentu, server menolak percobaan berikutnya dengan respons 429 Too Many Requests sampai jendela habis.
Yang sering disalahpahami: pembatas bawaan Laravel menghitung semua permintaan ke route login, termasuk yang berhasil. Akibatnya, pengguna yang login-logout berkali-kali dalam semenit bisa ikut terblokir. Panduan ini memperbaiki titik itu: lapisan pertama membatasi total permintaan per IP, lapisan kedua hanya menghitung percobaan yang gagal.
Apa bedanya throttle middleware dan RateLimiter kustom?
| Pendekatan Yang dihitung Cocok untuk | ||
throttle:5,1 di route | Semua permintaan ke route, berhasil maupun gagal | Pengaman cepat satu baris, proyek kecil |
RateLimiter::for('login') bernama | Semua permintaan, tapi limit dan kunci bisa diatur (per IP, per user) | Aplikasi dengan beberapa jenis route login |
| Hitung gagal saja di controller | Hanya percobaan login yang gagal | Produksi: paling adil untuk pengguna sah |
| Throttle per IP + per email | Dua kunci sekaligus | Menutup celah breadth-first (lihat bawah) |
Dokumentasi resmi Laravel (laravel.com/docs/rate-limiting) menjelaskan bahwa throttle memakai cache sebagai penyimpan hitungan. Di shared hosting dengan cache file, limiter tetap bekerja, tapi untuk trafik tinggi Redis jauh lebih konsisten.
Bagaimana cara memasang throttle dasar pada route login?
Langkah tercepat, satu baris di routes/web.php:
Artinya: maksimal 5 permintaan per menit dari satu kunci (IP untuk pengguna belum login). Percobaan ke-6 dalam menit yang sama ditolak dengan status 429 dan header Retry-After. Untuk API, pola yang sama berlaku di routes/api.php, biasanya dengan limit berbeda, misalnya throttle:10,1.
Uji dari terminal setelah memasang: kirim 6 permintaan POST berturut-turut ke endpoint login di staging, lalu periksa bahwa permintaan ke-6 mengembalikan 429, bukan 401 atau 422. Kalau masih lolos, periksa apakah route login Anda benar-benar melewati middleware itu — starter kit dan paket autentikasi kadang mendaftarkan route-nya sendiri.
Bagaimana cara membuat limiter bernama yang lebih rapi?
Untuk aplikasi yang punya login web dan login API, limiter bernama lebih mudah dirawat daripada angka yang tersebar di banyak route. Daftarkan di app/Providers/AppServiceProvider.php:
Lalu pakai di route:
Keuntungan limiter bernama: angka limit hidup di satu tempat, dan Anda bisa menambahkan respons 429 JSON kustom untuk API tanpa mengubah controller.
Bagaimana cara menghitung hanya percobaan login yang gagal?
Ini lapisan yang membedakan pengaman seadanya dengan pengaman yang adil. Di controller login, tambah hitungan hanya saat autentikasi gagal, dan hapus hitungan saat berhasil:
Pola ini menyelesaikan dua masalah sekaligus. Pengguna sah yang salah ketik dua kali lalu ingat passwordnya tidak terblokir, karena hitungan hanya naik saat gagal dan terhapus saat berhasil. Penyerang yang menebak satu akun dari satu IP terkunci setelah 5 kegagalan dalam 5 menit. Angka 5 per 5 menit adalah titik awal yang masuk akal; naikkan ke 10 bila pengguna sering salah ketik, turunkan ke 3 untuk akun admin.
Bagaimana cara menutup celah breadth-first attack?
Ada celah yang jarang dibahas tutorial berbahasa Indonesia: kunci email + IP bisa diakali penyerang yang mencoba satu password ke ribuan email berbeda dari satu IP. Karena setiap email punya kunci sendiri, tidak ada kunci yang mencapai batas, dan serangan lolos. Solusinya: limiter kedua yang kuncinya hanya IP:
Pasang keduanya pada route login: throttle:login-per-ip di level route untuk membatasi total percobaan dari satu IP, plus hitungan gagal per email di controller. Angka per IP harus jauh lebih longgar (misalnya 30 per menit) karena satu IP bisa dipakai bersama — kantor, kampus, atau jaringan seluler yang memakai NAT bisa menampung puluhan pengguna sah di balik satu IP publik. Mengunci satu IP secara permanen karena satu penyerang berarti mengunci semua pengguna sah di balik IP itu. Inilah alasan lockout harus selalu berbatas waktu, tidak pernah permanen.
Satu catatan infrastruktur: bila aplikasi berada di balik Cloudflare atau load balancer, pastikan TrustProxies dikonfigurasi agar $request->ip() membaca IP asli pengunjung, bukan IP proxy. Kalau tidak, semua pengunjung terlihat memakai satu IP dan limiter per IP mengunci semua orang sekaligus.
Apa yang harus ditampilkan saat pengguna terkunci?
Tiga aturan pesan error yang sering dilanggar:
- Jangan membocorkan apakah email terdaftar. Pesan "email tidak ditemukan" dan "password salah" yang berbeda memberi penyerang daftar email valid. Pakai satu pesan generik: "Email atau password salah."
- Tampilkan sisa waktu tunggu. Pesan "coba lagi dalam 47 detik" mengurangi keluhan pengguna dan mencegah mereka menekan tombol login berulang-ulang, yang justru memperpanjang kunci.
- Sediakan jalan keluar. Tautan "Lupa password?" harus selalu terlihat di halaman login yang terkunci. Pengguna yang benar-benar lupa password tidak boleh dipaksa menunggu; mereka butuh jalur reset. Cara membangun jalur reset yang aman dibahas di artikel Cara Membuat Fitur Lupa Password di Laravel.
Lapisan apa lagi yang melengkapi throttle?
Throttle menghentikan tebakan massal, tapi bukan pengaman tunggal. Tiga pelengkap yang paling bernilai:
- reCAPTCHA setelah ambang, bukan sejak awal. Memaksa semua pengguna menyelesaikan captcha sejak percobaan pertama merusak pengalaman login. Munculkan captcha hanya setelah 3 kegagalan. Implementasinya dibahas di artikel Cara Menambahkan Google reCAPTCHA v3 di Laravel.
- Catat percobaan gagal beruntun. Simpan percobaan login gagal ke activity log dengan IP dan email yang dicoba, lalu beri peringatan ke admin bila satu IP memicu kunci berkali-kali dalam sehari. Pola pencatatannya sama dengan yang dibahas di artikel Cara Membuat Activity Log di Laravel.
- Password kuat dan 2FA untuk akun sensitif. Throttle memperlambat penyerang, tapi password
admin123tetap bisa ditebak dalam 5 percobaan. Akun admin dan kasir sebaiknya memakai autentikasi dua faktor. Daftar pengaman lain yang wajib dicek setelah membeli source code ada di artikel 9 Langkah Mengamankan Website Setelah Beli Source Code.
Bagaimana cara menguji throttle sebelum naik ke produksi?
Jangan menguji di produksi dengan akun asli. Di staging, jalankan loop berikut dan amati transisi statusnya:
Pola yang benar: beberapa 422/401 untuk percobaan gagal, lalu 429 setelah batas tercapai, dan percobaan berikutnya setelah jeda menunjukkan Retry-After yang menurun. Bila kunci nyangkut saat pengujian, bersihkan kunci spesifik lewat php artisan tinker dengan RateLimiter::clear('login-gagal:uji@contoh.test|127.0.0.1') — jangan menghapus seluruh cache, karena itu juga menghapus sesi dan antrean yang sedang berjalan.
Kapan cara ini tidak cocok?
Throttle login tidak cocok sebagai satu-satunya pengaman untuk API publik yang dipakai ribuan klien dari IP bersama, karena limiter per IP akan sering salah kunci. Untuk kasus itu, pakai token API per klien dan limiter per token, bukan per IP. Throttle juga tidak menggantikan proteksi terhadap pencurian kredensial: bila password sudah bocor, penyerang hanya butuh satu percobaan yang berhasil.
FAQ
Berapa batas percobaan login yang ideal di Laravel?
Titik awal yang aman adalah 5 percobaan gagal per 5 menit per kombinasi email dan IP, ditambah 30 percobaan per menit per IP untuk menutup breadth-first attack. Sesuaikan dari log: bila banyak pengguna sah terkunci, longgarkan; bila log menunjukkan tebakan beruntun, ketatkan untuk akun admin saja.
Apa yang dikembalikan Laravel saat limit tercapai?
Status 429 Too Many Requests beserta header Retry-After berisi jumlah detik sampai boleh mencoba lagi. Untuk halaman web, tampilkan pesan dengan sisa waktu; untuk API, kembalikan JSON dengan pesan yang sama agar aplikasi mobile bisa menampilkan hitung mundur.
Apakah throttle bawaan Laravel menghitung percobaan yang berhasil?
Ya. Middleware throttle menghitung semua permintaan ke route, tanpa peduli hasilnya. Karena itu panduan ini menambahkan hitungan gagal saja di controller: pengguna sah tidak dihukum karena login berkali-kali, sementara penyerang tetap terkunci setelah sejumlah kegagalan.
Bagaimana kalau pengguna sah terkunci karena satu jaringan dengan penyerang?
Itulah alasan limit per IP harus longgar dan berbatas waktu, bukan permanen. Pengguna yang terkunci bisa menunggu sampai jendela habis atau memakai jalur lupa password. Bila satu kantor besar terus bermasalah, pertimbangkan pengecualian IP kantor di limiter — tapi catat pengecualian itu, karena pengecualian adalah lubang yang harus diaudit.
Apakah throttle menggantikan reCAPTCHA dan 2FA?
Tidak. Throttle memperlambat tebakan, reCAPTCHA membedakan manusia dan bot, dan 2FA melindungi akun walau password bocor. Ketiganya saling melengkapi; throttle adalah lapisan termurah dan sebaiknya dipasang pertama.
Bagaimana cara mereset kunci throttle yang nyangkut?
Gunakan RateLimiter::clear($key) dengan kunci yang persis sama seperti saat membuatnya, lewat php artisan tinker atau endpoint admin khusus. Jangan memakai cache:clear di produksi karena akan menghapus sesi pengguna dan data antrean.
Penutup
Pengaman login yang baik tak terlihat oleh pengguna sah dan terasa seperti tembok bagi bot: 5 percobaan gagal per email dalam 5 menit, 30 percobaan per menit per IP, pesan error generik, dan jalan keluar lewat reset password. Pasang lapisan dasarnya hari ini — satu middleware dan satu limiter bernama — lalu tambahkan hitungan gagal saja saat aplikasi sudah masuk produksi. Kalau Anda memakai source code Laravel dari KiosKoding, cek dulu apakah route login di source code tersebut sudah memakai pola ini; bila belum, potongan kode di atas bisa ditempel langsung tanpa paket tambahan.
Artikel Terkait
PHP 8.6.0 RC5 Rilis 5 November 2026: Kandidat Terakhir Sebelum Final 19 November
14 Nov 2026
Cara Membuat Sistem Membership & Langganan Berbayar di Laravel: Paket, Pembayaran & Middleware (Panduan 2026)
14 Nov 2026
Laravel 13.40.0 Rilis 3 November 2026: Alert Job Lambat, Commit ID Replika & Perbaikan Keamanan Concurrency
14 Nov 2026
Cara Membuat Middleware Kustom di Laravel: Role, Langganan & Header Keamanan (Panduan 2026)
14 Nov 2026