Login yang "berjalan" belum tentu aman. Panduan ini membangun login dan logout dari dasar, lengkap dengan pembatasan percobaan, regenerasi session, logout yang benar, konfigurasi cookie, pencatatan kejadian, dan test otomatis.
Overview
Form login adalah pintu depan aplikasi, dan pintu ini paling sering diserang. Implementasi yang hanya memanggil Auth::attempt() lalu redirect biasanya lolos uji fungsional, tetapi menyisakan celah:
| Celah | Akibat |
|---|---|
| Tanpa pembatasan percobaan | Brute force dan credential stuffing tanpa hambatan |
| Session ID tidak diganti setelah login | Session fixation: penyerang memakai session ID yang ia tanam sebelumnya |
| Pesan error berbeda untuk email salah vs password salah | User enumeration: penyerang tahu email mana yang terdaftar |
Logout lewat GET |
Logout paksa lewat tautan atau gambar dari situs lain |
| Logout tanpa invalidasi session | Data session lama masih bisa dipakai |
Cookie tanpa Secure / HttpOnly |
Cookie dicuri lewat jaringan tidak aman atau skrip XSS |
| Tidak ada log login gagal | Serangan tidak terdeteksi |
Hasil akhir: alur login dan logout berbasis session untuk aplikasi web Laravel yang menutup celah di atas, dengan rate limiting per email+IP, pemeriksaan status akun, konfigurasi cookie production, log keamanan, dan test Pest.
Contoh di seri ini memakai aplikasi administrasi RW (rukun warga) dengan pengguna admin, bendahara, pengurus, dan warga. Peran dan izin dibahas di artikel berikutnya.
Prerequisites
| Komponen | Versi |
|---|---|
| PHP | 8.3+ (disarankan 8.4) |
| Laravel | 13.x |
| Database | MySQL 8.0+ / PostgreSQL 15+ |
| Cache | Redis atau database (dipakai oleh rate limiter) |
| Testing | Pest 4 |
| HTTPS | Wajib di production |
Rekomendasi: untuk proyek baru, mulailah dari starter kit resmi Laravel (React, Vue, Svelte, atau Livewire). Starter kit sudah menerapkan sebagian besar praktik di artikel ini, termasuk autentikasi dua faktor. Artikel ini menjelaskan mekanisme di baliknya, sehingga Anda bisa memeriksa, menyesuaikan, atau membangunnya sendiri bila tidak memakai starter kit.
Step-by-step Tutorial
Langkah 1: Pastikan Password Di-hash dengan Benar
Laravel 11+ memakai cast hashed pada model User, sehingga password otomatis di-hash saat disimpan:
// app/Models/User.php
protected $fillable = ['name', 'email', 'password', 'is_active'];
protected $hidden = ['password', 'remember_token'];
protected function casts(): array
{
return [
'email_verified_at' => 'datetime',
'password' => 'hashed',
'is_active' => 'boolean',
];
}
Tambahkan kolom status akun agar admin bisa menonaktifkan pengguna tanpa menghapusnya:
Schema::table('users', function (Blueprint $table) {
$table->boolean('is_active')->default(true)->after('password');
$table->timestamp('last_login_at')->nullable();
$table->string('last_login_ip', 45)->nullable();
});
Algoritma bawaan adalah bcrypt. Biaya hashing diatur di .env:
BCRYPT_ROUNDS=12
Jangan pernah menyimpan password dengan md5(), sha1(), atau enkripsi yang bisa dibalik. Hashing sengaja dibuat lambat agar brute force terhadap database yang bocor menjadi mahal. Saat pengguna login, Laravel otomatis melakukan rehash bila parameter hashing di konfigurasi berubah.
Langkah 2: Form Request dengan Rate Limiting
Pembatasan percobaan diletakkan di Form Request agar logika login tetap rapi. Kuncinya adalah gabungan email + IP, sehingga satu IP tidak bisa menebak banyak password untuk satu akun, dan satu akun tidak terkunci global oleh orang lain dari IP berbeda.
php artisan make:request Auth/LoginRequest
// app/Http/Requests/Auth/LoginRequest.php
namespace App\Http\Requests\Auth;
use Illuminate\Auth\Events\Lockout;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Support\Facades\{Auth, RateLimiter};
use Illuminate\Support\Str;
use Illuminate\Validation\ValidationException;
class LoginRequest extends FormRequest
{
private const MAX_ATTEMPTS = 5;
private const DECAY_SECONDS = 60;
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'email' => ['required', 'string', 'email', 'max:255'],
'password' => ['required', 'string', 'max:255'],
'remember' => ['sometimes', 'boolean'],
];
}
public function authenticate(): void
{
$this->ensureIsNotRateLimited();
$authenticated = Auth::attemptWhen(
$this->only('email', 'password'),
fn ($user) => $user->is_active, // akun nonaktif ditolak
$this->boolean('remember'),
);
if (! $authenticated) {
RateLimiter::hit($this->throttleKey(), self::DECAY_SECONDS);
throw ValidationException::withMessages([
'email' => __('auth.failed'), // satu pesan umum untuk semua kegagalan
]);
}
RateLimiter::clear($this->throttleKey());
}
private function ensureIsNotRateLimited(): void
{
if (! RateLimiter::tooManyAttempts($this->throttleKey(), self::MAX_ATTEMPTS)) {
return;
}
event(new Lockout($this));
$seconds = RateLimiter::availableIn($this->throttleKey());
throw ValidationException::withMessages([
'email' => __('auth.throttle', ['seconds' => $seconds, 'minutes' => ceil($seconds / 60)]),
]);
}
private function throttleKey(): string
{
return Str::transliterate(Str::lower($this->string('email')).'|'.$this->ip());
}
}
Hal penting dalam kode di atas:
- Pesan error tunggal (
auth.failed) untuk email tidak terdaftar, password salah, maupun akun nonaktif. Penyerang tidak bisa membedakan ketiganya. attemptWhen()memeriksa password dan kondisi tambahan. Akun nonaktif tetap gagal tanpa membocorkan alasannya.Str::lower()dantransliterate()mencegah penghindaran limit dengan variasi huruf besar atau karakter Unicode.
Sesuaikan pesan di lang/id/auth.php:
return [
'failed' => 'Email atau password tidak sesuai.',
'throttle' => 'Terlalu banyak percobaan masuk. Coba lagi dalam :seconds detik.',
];
Langkah 3: Controller Login
php artisan make:controller Auth/AuthenticatedSessionController
// app/Http/Controllers/Auth/AuthenticatedSessionController.php
namespace App\Http\Controllers\Auth;
use App\Http\Controllers\Controller;
use App\Http\Requests\Auth\LoginRequest;
use Illuminate\Http\{RedirectResponse, Request};
use Illuminate\Support\Facades\Auth;
use Illuminate\View\View;
class AuthenticatedSessionController extends Controller
{
public function create(): View
{
return view('auth.login');
}
public function store(LoginRequest $request): RedirectResponse
{
$request->authenticate();
$request->session()->regenerate(); // cegah session fixation
$request->user()->forceFill([
'last_login_at' => now(),
'last_login_ip' => $request->ip(),
])->saveQuietly();
return redirect()->intended(route('dashboard', absolute: false));
}
public function destroy(Request $request): RedirectResponse
{
Auth::guard('web')->logout();
$request->session()->invalidate(); // hapus seluruh data session
$request->session()->regenerateToken(); // token CSRF baru
return redirect('/');
}
}
Tiga baris di destroy() memiliki fungsi berbeda dan ketiganya diperlukan:
| Baris | Fungsi |
|---|---|
logout() |
Menghapus identitas pengguna dari guard dan menghapus remember token |
session()->invalidate() |
Membuang semua data session dan membuat session ID baru |
session()->regenerateToken() |
Membuat token CSRF baru agar token lama tidak bisa dipakai |
redirect()->intended() mengarahkan pengguna ke halaman yang tadi ingin dibuka. Laravel hanya menyimpan URL internal aplikasi untuk keperluan ini, sehingga aman dari open redirect selama Anda tidak membaca URL tujuan langsung dari query string.
Langkah 4: Route dengan Middleware yang Tepat
// routes/web.php
use App\Http\Controllers\Auth\AuthenticatedSessionController;
Route::middleware('guest')->group(function () {
Route::get('login', [AuthenticatedSessionController::class, 'create'])->name('login');
Route::post('login', [AuthenticatedSessionController::class, 'store'])
->middleware('throttle:20,1'); // lapisan kedua: batas per IP untuk endpoint
});
Route::middleware('auth')->group(function () {
Route::post('logout', [AuthenticatedSessionController::class, 'destroy'])->name('logout');
Route::get('dashboard', DashboardController::class)->name('dashboard');
});
guestmengalihkan pengguna yang sudah login agar tidak membuka halaman login lagi.throttle:20,1membatasi total request ke endpoint login per IP, terlepas dari email yang dicoba. Ini melengkapi limit per email+IP di Form Request.- Logout memakai POST, sehingga dilindungi CSRF. Logout lewat
GETbisa dipicu oleh<img src="https://app.test/logout">dari situs mana pun.
Langkah 5: Form Login di Blade
{{-- resources/views/auth/login.blade.php --}}
<form method="POST" action="{{ route('login') }}" novalidate>
@csrf
<label for="email">Email</label>
<input id="email" name="email" type="email" value="{{ old('email') }}"
autocomplete="username" required autofocus>
@error('email') <p class="error">{{ $message }}</p> @enderror
<label for="password">Password</label>
<input id="password" name="password" type="password"
autocomplete="current-password" required>
<label>
<input type="checkbox" name="remember" value="1"> Ingat saya
</label>
<button type="submit">Masuk</button>
</form>
{{-- Tombol logout di layout --}}
<form method="POST" action="{{ route('logout') }}">
@csrf
<button type="submit">Keluar</button>
</form>
Catatan:
old('email')boleh, tetapi jangan pernah mengisi ulang password.autocomplete="current-password"membantu password manager, yang mendorong pengguna memakai password kuat dan unik.
Langkah 6: Konfigurasi Session dan Cookie untuk Production
# .env production
APP_ENV=production
APP_DEBUG=false
APP_URL=https://rw.contoh.id
SESSION_DRIVER=database
SESSION_LIFETIME=120
SESSION_EXPIRE_ON_CLOSE=false
SESSION_ENCRYPT=true
SESSION_SECURE_COOKIE=true
SESSION_HTTP_ONLY=true
SESSION_SAME_SITE=lax
SESSION_DOMAIN=null
| Pengaturan | Alasan |
|---|---|
SESSION_DRIVER=database atau redis |
Session bisa dihapus dari server (misalnya saat akun diblokir) dan berjalan di banyak server |
SESSION_LIFETIME=120 |
Session kedaluwarsa setelah 120 menit tidak aktif; perpendek untuk aplikasi keuangan |
SESSION_SECURE_COOKIE=true |
Cookie hanya dikirim lewat HTTPS |
SESSION_HTTP_ONLY=true |
Cookie tidak bisa dibaca JavaScript, sehingga mengurangi dampak XSS |
SESSION_SAME_SITE=lax |
Cookie tidak dikirim pada request lintas situs selain navigasi biasa; lapisan tambahan terhadap CSRF |
SESSION_DOMAIN=null |
Cookie tidak dibagikan ke subdomain lain |
Bila memakai driver database, pastikan tabel sessions sudah ada (dibuat oleh migration bawaan Laravel). Pastikan juga aplikasi di belakang proxy atau load balancer mempercayai header HTTPS dengan benar (trustProxies di bootstrap/app.php), agar Secure cookie dan $request->ip() bekerja.
Langkah 7: Fitur "Ingat Saya" yang Bertanggung Jawab
Remember me menyimpan cookie jangka panjang. Pertimbangkan:
- Untuk peran sensitif (admin, bendahara), sembunyikan opsi ini atau abaikan nilainya.
- Logout dan perubahan password harus mengganti
remember_token(dilakukan otomatis olehlogout()dan perubahan password lewat broker reset).
// LoginRequest::authenticate()
$remember = $this->boolean('remember') && ! $this->isPrivilegedEmail();
Implementasi isPrivilegedEmail() bergantung pada aplikasi Anda; cara yang lebih sederhana adalah tidak menampilkan checkbox di aplikasi internal.
Langkah 8: Keluarkan Sesi Lain Setelah Ganti Password
Saat pengguna mengganti password karena curiga akunnya dipakai orang lain, sesi di perangkat lain juga harus berakhir.
Aktifkan middleware auth.session pada route yang memerlukan login:
Route::middleware(['auth', 'auth.session'])->group(function () {
// route aplikasi
});
// Setelah password diperbarui dan divalidasi
use Illuminate\Support\Facades\Auth;
Auth::logoutOtherDevices($request->validated('current_password'));
Untuk aplikasi yang memakai session database, admin juga bisa memutus semua sesi pengguna tertentu, misalnya saat akun dinonaktifkan:
DB::table('sessions')->where('user_id', $user->id)->delete();
$user->forceFill(['remember_token' => null, 'is_active' => false])->save();
Langkah 9: Catat Kejadian Autentikasi
Laravel memicu event untuk setiap kejadian autentikasi. Dengarkan untuk keperluan audit dan deteksi serangan:
// app/Providers/AppServiceProvider.php
use Illuminate\Auth\Events\{Failed, Lockout, Login, Logout};
use Illuminate\Support\Facades\{Event, Log};
public function boot(): void
{
Event::listen(Login::class, fn (Login $e) => Log::channel('security')->info('login.success', [
'user_id' => $e->user->getAuthIdentifier(),
'ip' => request()->ip(),
]));
Event::listen(Failed::class, fn (Failed $e) => Log::channel('security')->warning('login.failed', [
'email' => $e->credentials['email'] ?? null,
'ip' => request()->ip(),
]));
Event::listen(Lockout::class, fn (Lockout $e) => Log::channel('security')->alert('login.lockout', [
'email' => $e->request->input('email'),
'ip' => $e->request->ip(),
]));
Event::listen(Logout::class, fn (Logout $e) => Log::channel('security')->info('logout', [
'user_id' => $e->user?->getAuthIdentifier(),
]));
}
// config/logging.php -> 'channels'
'security' => [
'driver' => 'daily',
'path' => storage_path('logs/security.log'),
'level' => 'info',
'days' => 90,
],
Jangan pernah mencatat password, bahkan yang salah. Pengguna sering salah ketik password yang mirip dengan password asli atau password akun lain.
Langkah 10: Autentikasi Dua Faktor untuk Peran Sensitif
Password saja tidak cukup untuk akun yang mengelola uang atau data warga. Gunakan Laravel Fortify, yang menyediakan backend login, registrasi, reset password, dan TOTP (aplikasi authenticator) tanpa mengatur tampilan:
composer require laravel/fortify
php artisan fortify:install
php artisan migrate
Aktifkan fitur 2FA di config/fortify.php:
'features' => [
Features::resetPasswords(),
Features::emailVerification(),
Features::twoFactorAuthentication([
'confirm' => true,
'confirmPassword' => true,
]),
],
Bila memakai Fortify, controller login di artikel ini tidak dibutuhkan lagi karena Fortify menyediakannya. Prinsip di Langkah 2–9 tetap berlaku sebagai daftar periksa: rate limit (diatur lewat RateLimiter::for('login', ...) di FortifyServiceProvider), pesan error umum, regenerasi session, dan logout dengan POST.
Langkah 11: Test Otomatis
// tests/Feature/Auth/LoginTest.php
use App\Models\User;
it('login berhasil dan session diganti', function () {
$user = User::factory()->create(['password' => 'Rahasia#2026']);
$this->get('/login');
$sessionLama = session()->getId();
$this->post('/login', ['email' => $user->email, 'password' => 'Rahasia#2026'])
->assertRedirect('/dashboard');
$this->assertAuthenticatedAs($user);
expect(session()->getId())->not->toBe($sessionLama);
});
it('memberi pesan yang sama untuk email tidak terdaftar dan password salah', function () {
$user = User::factory()->create();
$a = $this->post('/login', ['email' => 'tidakada@contoh.id', 'password' => 'x'])->getSession()->get('errors')->first('email');
$b = $this->post('/login', ['email' => $user->email, 'password' => 'salah'])->getSession()->get('errors')->first('email');
expect($a)->toBe($b);
$this->assertGuest();
});
it('menolak akun nonaktif', function () {
$user = User::factory()->create(['password' => 'Rahasia#2026', 'is_active' => false]);
$this->post('/login', ['email' => $user->email, 'password' => 'Rahasia#2026'])
->assertSessionHasErrors('email');
$this->assertGuest();
});
it('mengunci setelah 5 percobaan gagal, bahkan untuk password yang benar', function () {
$user = User::factory()->create(['password' => 'Rahasia#2026']);
foreach (range(1, 5) as $i) {
$this->post('/login', ['email' => $user->email, 'password' => 'salah']);
}
$this->post('/login', ['email' => $user->email, 'password' => 'Rahasia#2026'])
->assertSessionHasErrors('email');
$this->assertGuest();
});
it('logout hanya lewat POST dan mengganti token CSRF', function () {
$user = User::factory()->create();
$this->actingAs($user)->get('/logout')->assertMethodNotAllowed();
$tokenLama = csrf_token();
$this->actingAs($user)->post('/logout')->assertRedirect('/');
$this->assertGuest();
expect(session()->token())->not->toBe($tokenLama);
});
Test lockout sengaja memakai password yang benar pada percobaan keenam: itulah bukti bahwa akun benar-benar terkunci, bukan sekadar password salah.
php artisan test --filter=LoginTest
Troubleshooting
| Error / Gejala | Penyebab | Solusi |
|---|---|---|
419 Page Expired saat login |
Token CSRF tidak dikirim, session kedaluwarsa, atau cookie session tidak tersimpan | Pastikan @csrf ada; periksa SESSION_DOMAIN dan SESSION_SECURE_COOKIE (cookie Secure tidak tersimpan di HTTP lokal) |
| Login berhasil tetapi langsung kembali ke halaman login | Cookie session tidak terkirim kembali | Periksa domain cookie, HTTPS, dan pengaturan trustProxies di belakang load balancer |
| Rate limit tidak pernah aktif | Cache driver array atau cache tidak bersama antar server |
Gunakan redis atau database untuk CACHE_STORE |
| Semua pengguna di kantor terkunci sekaligus | Hanya IP yang dipakai sebagai kunci, dan semua lewat satu NAT | Gunakan kunci email+IP seperti Langkah 2 |
$request->ip() selalu IP load balancer |
Proxy belum dipercaya | Konfigurasikan trustProxies(at: ...) di bootstrap/app.php |
| Pengguna tetap login setelah akun dinonaktifkan | Session aktif dan remember token masih berlaku | Hapus session pengguna, kosongkan remember_token, atau periksa is_active di middleware |
logoutOtherDevices tidak berpengaruh |
Middleware auth.session belum dipasang |
Tambahkan auth.session pada grup route yang terautentikasi |
Route [login] not defined |
Route login tidak diberi nama login |
Beri ->name('login'); middleware auth mengalihkan ke route bernama ini |
Best Practices
Keamanan
- Gunakan HTTPS di seluruh aplikasi, bukan hanya halaman login, dan aktifkan
SESSION_SECURE_COOKIE. - Selalu
regenerate()session setelah login, daninvalidate()+regenerateToken()saat logout. - Satu pesan error untuk semua kegagalan login; jangan beri tahu apakah email terdaftar.
- Rate limit berlapis: per email+IP di logika login, dan per IP di route.
- Wajibkan 2FA untuk peran yang mengelola uang atau data pribadi.
- Terapkan aturan password yang wajar (lihat artikel Panduan Validasi Form Laravel): panjang minimal, dan pemeriksaan password yang pernah bocor dengan
Password::uncompromised().
Performa
- Gunakan Redis untuk session dan cache rate limiter pada aplikasi dengan trafik tinggi.
- Jangan menaikkan
BCRYPT_ROUNDSterlalu tinggi; ukur waktu hashing di server production (target sekitar 100–300 ms per login).
Maintainability
- Gunakan starter kit resmi atau Fortify untuk proyek baru, dan pakai artikel ini sebagai daftar periksa.
- Simpan log keamanan di channel terpisah dengan masa retensi yang jelas.
- Pertahankan test login, lockout, dan logout di CI agar perubahan di masa depan tidak melemahkan alur ini.
Related Articles
- Cara Menerapkan Role dan Permission Menggunakan Spatie Laravel Permission
- Cara Mengamankan Route, Controller, dan API Laravel Menggunakan Middleware dan Policy
- Mencegah SQL Injection, Cross-Site Scripting, dan CSRF pada Aplikasi Laravel
- Laravel Security Hardening: 15 Langkah Penting Sebelum Aplikasi Dipublikasikan
Last Tested
| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| PHP | 8.4 |
| MySQL | 8.4 LTS |
| Laravel Fortify | 1.x |
| Pest | 4.x |
| Tanggal | 19 Oktober 2026 |