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:cachedi 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
- Role-Based Access Control di Laravel: Studi Kasus Admin, Bendahara, Pengurus, dan Warga
- Cara Menerapkan Role dan Permission Menggunakan Spatie Laravel Permission
- Panduan Validasi Form Laravel Menggunakan Form Request dan Custom Validation Rules
- Laravel Security Hardening: 15 Langkah Penting Sebelum Aplikasi Dipublikasikan
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 |