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

Blog / Keamanan / Panduan Implementasi Login dan...
Keamanan

Panduan Implementasi Login dan Logout Laravel dengan Praktik Keamanan yang Benar

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
14 min read
11 views

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() dan transliterate() 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');
});
  • guest mengalihkan pengguna yang sudah login agar tidak membuka halaman login lagi.
  • throttle:20,1 membatasi 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 GET bisa 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 oleh logout() 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, dan invalidate() + 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_ROUNDS terlalu 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

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

Bagikan artikel:

Artikel lainnya