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

Blog / Keamanan / Cara Mengamankan Route, Contro...
Keamanan

Cara Mengamankan Route, Controller, dan API Laravel Menggunakan Middleware dan Policy

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
13 min read
14 views

Pertahanan berlapis untuk setiap request: middleware di route, Policy untuk data, otorisasi di controller, token dengan ability untuk API, rate limiting, binding bertingkat, dan test otomatis yang memastikan tidak ada route yang lupa dilindungi.

Overview

Celah keamanan nomor satu di aplikasi web, menurut OWASP Top 10 2025, adalah Broken Access Control. Di Laravel, penyebabnya biasanya bukan framework, melainkan route yang lupa dilindungi:

  • satu route baru ditambahkan di luar grup auth,
  • endpoint PUT /api/orders/{order} memeriksa login tetapi tidak memeriksa pemilik pesanan,
  • token API untuk aplikasi kasir bisa dipakai untuk menghapus pengguna,
  • endpoint ekspor tanpa batas request dipakai untuk menyedot seluruh data.

Artikel ini menyusun pertahanan berlapis:

Request
  │
  ├─► Middleware global     (HTTPS, trusted proxy, header keamanan)
  ├─► Middleware grup       (web: session + CSRF │ api: stateless)
  ├─► Middleware route      (auth, verified, throttle, can:, abilities:)
  ├─► Route model binding   (scopeBindings: data milik induknya)
  ├─► Form Request          (authorize() + validasi)
  ├─► Controller            (Gate::authorize untuk aturan per data)
  └─► API Resource          (hanya kolom yang boleh terlihat)

Hasil akhir: route web dan API yang terlindungi, middleware kustom untuk status akun, Policy untuk aturan data, token Sanctum dengan ability terbatas, rate limiter per jenis endpoint, dan test yang gagal bila ada route tanpa perlindungan.

Prerequisites

Komponen Versi
PHP 8.3+ (disarankan 8.4)
Laravel 13.x
Laravel Sanctum 4.x
spatie/laravel-permission ^8.0 (opsional)
Testing Pest 4

Contoh memakai aplikasi RW dari artikel Role-Based Access Control di Laravel.

Step-by-step Tutorial

Langkah 1: Pahami Peran Middleware vs Policy

Middleware Policy
Waktu berjalan Sebelum controller Saat dipanggil (route can, controller, Blade)
Tahu tentang data spesifik? Biasanya tidak Ya, menerima model
Cocok untuk Login, verifikasi email, status akun, rate limit, izin umum "Boleh mengubah transaksi ini?"
Contoh auth, throttle:60,1, permission:kas.view TransaksiKasPolicy::approve()

Aturan praktis: middleware menjaga pintu ruangan, Policy menjaga setiap lemari di dalamnya.

Langkah 2: Middleware Grup dan Default yang Aman

Di Laravel 13, konfigurasi middleware ada di bootstrap/app.php:

// bootstrap/app.php
use Illuminate\Foundation\Configuration\Middleware;

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        $middleware->trustProxies(at: env('TRUSTED_PROXIES', '127.0.0.1'));

        $middleware->web(append: [
            \App\Http\Middleware\SecurityHeaders::class,
        ]);

        $middleware->alias([
            'active'     => \App\Http\Middleware\EnsureUserIsActive::class,
            'permission' => \Spatie\Permission\Middleware\PermissionMiddleware::class,
            'abilities'  => \Laravel\Sanctum\Http\Middleware\CheckAbilities::class,
            'ability'    => \Laravel\Sanctum\Http\Middleware\CheckForAnyAbility::class,
        ]);
    })
    ->create();

Grup web sudah menyertakan session, enkripsi cookie, dan verifikasi CSRF. Grup api bersifat stateless dan tidak memeriksa CSRF, karena autentikasinya memakai token.

Header keamanan dibahas lengkap di artikel Laravel Security Hardening. Versi ringkasnya:

// app/Http/Middleware/SecurityHeaders.php
public function handle(Request $request, Closure $next): Response
{
    $response = $next($request);

    $response->headers->set('X-Content-Type-Options', 'nosniff');
    $response->headers->set('X-Frame-Options', 'SAMEORIGIN');
    $response->headers->set('Referrer-Policy', 'strict-origin-when-cross-origin');
    $response->headers->set('Permissions-Policy', 'camera=(), microphone=(), geolocation=()');

    return $response;
}

Langkah 3: Middleware Kustom untuk Status Akun

Session yang sudah aktif tetap berlaku walaupun admin menonaktifkan akun. Middleware ini memutus akses pada request berikutnya:

php artisan make:middleware EnsureUserIsActive
// app/Http/Middleware/EnsureUserIsActive.php
namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Symfony\Component\HttpFoundation\Response;

class EnsureUserIsActive
{
    public function handle(Request $request, Closure $next): Response
    {
        $user = $request->user();

        if ($user && ! $user->is_active) {
            if ($request->expectsJson()) {
                $user->currentAccessToken()?->delete();
                return response()->json(['message' => 'Akun dinonaktifkan.'], 403);
            }

            Auth::guard('web')->logout();
            $request->session()->invalidate();
            $request->session()->regenerateToken();

            return redirect()->route('login')->withErrors(['email' => 'Akun Anda dinonaktifkan.']);
        }

        return $next($request);
    }
}

Langkah 4: Struktur Route Web yang "Aman secara Bawaan"

Susun route agar route baru otomatis masuk grup terlindungi. Route publik dikumpulkan secara eksplisit dan sedikit.

// routes/web.php

// ── Publik (sengaja sedikit dan eksplisit) ────────────────────────
Route::view('/', 'welcome')->name('home');
Route::get('kas/ringkasan-publik', RingkasanKasPublikController::class)->name('kas.publik');

require __DIR__.'/auth.php';   // login, logout, reset password

// ── Wajib login ────────────────────────────────────────────────────
Route::middleware(['auth', 'auth.session', 'verified', 'active'])->group(function () {
    Route::get('dashboard', DashboardController::class)->name('dashboard');

    Route::get('keluarga', [KeluargaController::class, 'index'])
        ->can('viewAny', Keluarga::class)->name('keluarga.index');
    Route::get('keluarga/{keluarga}', [KeluargaController::class, 'show'])
        ->can('view', 'keluarga')->name('keluarga.show');

    Route::middleware('permission:kas.view')->prefix('kas')->name('kas.')->group(function () {
        Route::get('/', [TransaksiKasController::class, 'index'])->name('index');
        Route::post('/', [TransaksiKasController::class, 'store'])->can('create', TransaksiKas::class)->name('store');
        Route::post('{trx}/setujui', [TransaksiKasController::class, 'setujui'])->name('setujui');
    });

    // Aksi sangat sensitif: minta password ulang
    Route::middleware('password.confirm')->group(function () {
        Route::get('pengguna', [PenggunaController::class, 'index'])->can('pengguna.manage');
        Route::delete('pengguna/{user}', [PenggunaController::class, 'destroy'])->can('pengguna.manage');
    });
});

Middleware bawaan yang sering terlupa:

Middleware Fungsi
verified Hanya pengguna dengan email terverifikasi
password.confirm Minta password lagi sebelum aksi sensitif (berlaku beberapa jam)
auth.session Memutus sesi lain saat password diganti
signed URL harus memiliki tanda tangan valid (tautan undangan, unsubscribe)
throttle:x,y Membatasi jumlah request

Langkah 5: Policy untuk Aturan Per Data

Laravel menemukan Policy otomatis bila mengikuti konvensi App\Models\X → App\Policies\XPolicy. Panggil dari tiga tempat:

// 1. Route
Route::put('kas/{trx}', [TransaksiKasController::class, 'update'])->can('update', 'trx');

// 2. Controller
Gate::authorize('update', $trx);

// 3. Form Request
public function authorize(): bool
{
    return $this->user()->can('update', $this->route('trx'));
}

Pilih satu tempat yang konsisten per aksi agar mudah diaudit. Pola yang disarankan: Form Request untuk aksi yang menerima input, dan ->can() di route untuk aksi tanpa input (lihat, hapus).

Kembalikan 404 untuk data yang bukan milik pengguna, agar keberadaan data tidak terungkap:

// app/Policies/IuranPolicy.php
use Illuminate\Auth\Access\Response;

public function view(User $user, Iuran $iuran): Response
{
    return $user->keluarga_id === $iuran->keluarga_id || $user->can('iuran.view')
        ? Response::allow()
        : Response::denyAsNotFound();
}

Dengan denyAsNotFound(), warga yang menebak /iuran/1234 mendapat 404, bukan 403 yang mengonfirmasi bahwa ID itu ada.

Policy untuk pengguna yang belum login. Secara bawaan, Policy langsung menolak tamu. Untuk mengizinkan tamu, buat parameter user nullable:

public function viewPublic(?User $user, TransaksiKas $trx): bool
{
    return $trx->status === 'disetujui';
}

Langkah 6: Middleware di Controller

Bila controller dipakai untuk banyak route, middleware bisa dideklarasikan di controller dengan interface HasMiddleware:

// app/Http/Controllers/LaporanController.php
namespace App\Http\Controllers;

use Illuminate\Routing\Controllers\{HasMiddleware, Middleware};

class LaporanController extends Controller implements HasMiddleware
{
    public static function middleware(): array
    {
        return [
            'auth',
            new Middleware('permission:laporan.export'),
            new Middleware('throttle:exports', only: ['export']),
        ];
    }

    public function index() { /* ... */ }

    public function export() { /* ... */ }
}

Tetap utamakan middleware di file route, karena satu file route lebih mudah diaudit dibanding middleware yang tersebar di banyak controller.

Langkah 7: Binding Bertingkat agar Data Tetap Milik Induknya

Route keluarga/{keluarga}/anggota/{anggota} rawan bila anggota dari keluarga lain bisa diakses lewat URL keluarga yang sah:

// Rawan: anggota 99 milik keluarga lain tetap ditemukan
Route::get('keluarga/{keluarga}/anggota/{anggota}', [AnggotaController::class, 'show']);
// Aman: Laravel memastikan anggota milik keluarga tersebut, bila tidak → 404
Route::get('keluarga/{keluarga}/anggota/{anggota}', [AnggotaController::class, 'show'])
    ->scopeBindings()
    ->can('view', 'keluarga');

scopeBindings() membuat Laravel mencari anggota melalui relasi $keluarga->anggota(), sehingga ID dari keluarga lain menghasilkan 404.

Langkah 8: API dengan Sanctum dan Token Ability

php artisan install:api

Berikan token dengan kemampuan terbatas sesuai kebutuhan klien. Aplikasi kasir iuran tidak perlu izin mengelola pengguna.

// app/Http/Controllers/Api/TokenController.php
public function store(Request $request)
{
    $request->validate([
        'email'       => ['required', 'email'],
        'password'    => ['required'],
        'device_name' => ['required', 'string', 'max:100'],
    ]);

    $user = User::where('email', $request->email)->first();

    if (! $user || ! $user->is_active || ! Hash::check($request->password, $user->password)) {
        throw ValidationException::withMessages(['email' => __('auth.failed')]);
    }

    // ability token => permission yang wajib dimiliki pengguna
    $peta = [
        'iuran:read'   => 'iuran.view',
        'iuran:record' => 'iuran.record',
        'kas:read'     => 'kas.view',
    ];

    $abilities = collect($peta)
        ->filter(fn (string $permission) => $user->can($permission))
        ->keys()
        ->all();

    $token = $user->createToken($request->device_name, $abilities, now()->addDays(30));

    return response()->json(['token' => $token->plainTextToken, 'abilities' => $abilities]);
}

Token hanya diberi ability yang juga diizinkan oleh permission pengguna, dan memiliki masa berlaku 30 hari. Atur juga masa berlaku global di config/sanctum.php ('expiration' => 60 * 24 * 30) dan jadwalkan pembersihan token kedaluwarsa:

// routes/console.php
Schedule::command('sanctum:prune-expired --hours=24')->daily();

Route API:

// routes/api.php
Route::post('v1/tokens', [TokenController::class, 'store'])->middleware('throttle:login')->name('v1.tokens');

Route::prefix('v1')->middleware(['auth:sanctum', 'active', 'throttle:api'])->group(function () {
    Route::get('iuran', [Api\IuranController::class, 'index'])->middleware('abilities:iuran:read');
    Route::post('iuran/{iuran}/bayar', [Api\IuranController::class, 'bayar'])
        ->middleware('abilities:iuran:record')
        ->can('record', 'iuran');

    Route::delete('tokens/current', function (Request $request) {
        $request->user()->currentAccessToken()->delete();      // logout API

        return response()->noContent();
    });
});

Dua lapis pemeriksaan di endpoint bayar: token harus punya ability iuran:record, dan pengguna harus lolos Policy. Token yang dicuri dari aplikasi baca saja tidak bisa dipakai untuk mencatat pembayaran.

Langkah 9: Rate Limiter Per Jenis Endpoint

// app/Providers/AppServiceProvider.php
use Illuminate\Cache\RateLimiting\Limit;
use Illuminate\Support\Facades\RateLimiter;

public function boot(): void
{
    RateLimiter::for('api', fn (Request $request) =>
        Limit::perMinute(60)->by($request->user()?->id ?: $request->ip()));

    RateLimiter::for('login', fn (Request $request) => [
        Limit::perMinute(5)->by(strtolower((string) $request->input('email')).'|'.$request->ip()),
        Limit::perMinute(20)->by($request->ip()),
    ]);

    RateLimiter::for('exports', fn (Request $request) =>
        Limit::perHour(10)->by($request->user()->id)
            ->response(fn () => response('Batas ekspor tercapai. Coba lagi nanti.', 429)));
}

Pisahkan limiter berdasarkan biaya endpoint. Endpoint ekspor atau laporan berat membutuhkan limit jauh lebih ketat daripada endpoint daftar biasa.

Langkah 10: Batasi Data yang Keluar

Otorisasi yang benar bisa sia-sia bila respons membocorkan kolom sensitif.

// app/Http/Resources/UserResource.php
public function toArray(Request $request): array
{
    return [
        'id'    => $this->id,
        'name'  => $this->name,
        'email' => $this->when($request->user()?->can('pengguna.manage'), $this->email),
        'roles' => $this->whenLoaded('roles', fn () => $this->roles->pluck('name')),
    ];
}

Jangan pernah mengembalikan model langsung (return $user;) dari endpoint API. Model mengirim semua kolom yang tidak di-$hidden, termasuk kolom baru yang ditambahkan di kemudian hari.

Atur CORS seketat mungkin di config/cors.php:

'paths'           => ['api/*'],
'allowed_origins' => [env('FRONTEND_URL', 'https://rw.contoh.id')],
'allowed_methods' => ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'],
'supports_credentials' => false,

Langkah 11: Test yang Menangkap Route Tanpa Perlindungan

Test ini memeriksa semua route dan gagal bila ada route non-publik yang bisa diakses tanpa login. Ini jaring pengaman untuk route yang ditambahkan di masa depan.

// tests/Feature/Security/RouteProtectionTest.php
use Illuminate\Support\Facades\Route;

it('semua route kecuali daftar publik memerlukan autentikasi', function () {
    $publik = [
        'home', 'kas.publik', 'login', 'password.request', 'password.reset',
        'password.email', 'password.store', 'v1.tokens',
        'storage.local',                         // file disk lokal (bila 'serve' => true)
    ];

    $tanpaAuth = collect(Route::getRoutes()->getRoutes())
        ->reject(fn ($route) => in_array($route->getName(), $publik, true))
        ->reject(fn ($route) => $route->uri() === 'up')                     // health check bawaan
        ->reject(fn ($route) => str_starts_with($route->uri(), '_')          // route internal paket (_debugbar, dsb.)
                             || str_starts_with($route->uri(), 'sanctum/'))
        ->filter(fn ($route) => collect($route->gatherMiddleware())
            ->doesntContain(fn ($m) => is_string($m) && (str_starts_with($m, 'auth') || $m === 'signed')))
        ->map(fn ($route) => implode('|', $route->methods()).' '.$route->uri())
        ->values();

    expect($tanpaAuth)->toBeEmpty();
});

Test akses per data, termasuk API:

it('token baca saja tidak bisa mencatat pembayaran', function () {
    $bendahara = User::factory()->create()->assignRole('bendahara');
    $iuran = Iuran::factory()->create();

    Sanctum::actingAs($bendahara, ['iuran:read']);

    $this->postJson("/api/v1/iuran/{$iuran->id}/bayar")->assertForbidden();
});

it('warga mendapat 404 untuk iuran keluarga lain', function () {
    $warga = User::factory()->for(Keluarga::factory())->create()->assignRole('warga');
    $iuranLain = Iuran::factory()->create();

    $this->actingAs($warga)->get("/iuran/{$iuranLain->id}")->assertNotFound();
});

it('akun nonaktif langsung dikeluarkan', function () {
    $user = User::factory()->create(['is_active' => false]);

    $this->actingAs($user)->get('/dashboard')->assertRedirect('/login');
    $this->assertGuest();
});

Troubleshooting

Error / Gejala Penyebab Solusi
Route baru bisa diakses tanpa login Ditambahkan di luar grup auth Susun route seperti Langkah 4 dan jalankan test Langkah 11 di CI
Route [login] not defined saat request API tanpa token Middleware auth mencoba redirect ke halaman login Kirim header Accept: application/json dari klien API, atau atur redirectGuestsTo() di bootstrap/app.php
->can('update', 'trx') selalu 403 Nama parameter route berbeda dengan argumen kedua Samakan nama parameter ({trx} ↔ 'trx')
Anggota keluarga lain bisa diakses lewat URL bertingkat Binding tidak di-scope Tambahkan ->scopeBindings()
Token API lama masih bisa dipakai setelah akun dinonaktifkan Token Sanctum tidak dicabut Middleware active menghapus token saat ini; cabut semua token: $user->tokens()->delete()
Target class [abilities] does not exist Alias middleware Sanctum belum didaftarkan Daftarkan alias abilities dan ability di bootstrap/app.php
Semua request API kena 429 dari satu kantor Limiter berbasis IP untuk pengguna terautentikasi Gunakan by($request->user()?->id ?: $request->ip())
CORS error di frontend Origin tidak ada di daftar Tambahkan origin yang tepat; jangan memakai * untuk API yang membawa kredensial

Best Practices

Keamanan

  • Default menolak: route baru otomatis masuk grup terlindungi; route publik ditulis eksplisit.
  • Gabungkan middleware (siapa boleh masuk) dengan Policy (data mana yang boleh disentuh).
  • Gunakan denyAsNotFound() untuk data milik pengguna lain.
  • Token API dengan ability minimal dan masa berlaku terbatas; jadwalkan sanctum:prune-expired.
  • Minta konfirmasi password untuk aksi sensitif (password.confirm).
  • Jangan pernah mengembalikan model mentah dari API; selalu lewat Resource.

Performa

  • Rate limiter memakai cache; gunakan Redis di production.
  • Pemeriksaan Policy yang membutuhkan relasi sebaiknya memakai kolom yang sudah ada di model (misalnya keluarga_id), bukan query tambahan.
  • php artisan route:cache di production mempercepat pencocokan route dan middleware.

Maintainability

  • Satu file route per area (web, api, admin) dengan grup yang jelas.
  • Konsisten memilih satu tempat otorisasi per jenis aksi.
  • Pertahankan test perlindungan route dan test akses per data di CI.
  • Dokumentasikan ability token API di dokumentasi API (lihat artikel Membuat Dokumentasi API dan Panduan Instalasi Source Code Laravel).

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
Laravel Sanctum 4.x
spatie/laravel-permission 8.x
Pest 4.x
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya