📘 Modul 08: Autentikasi & Keamanan
Pakem Framework menyediakan sistem keamanan ganda (Dual Authentication Suite) yang mencakup autentikasi berbasis Session/Cookie untuk aplikasi web tradisional, serta JSON Web Token (JWT) untuk API mobile/frontend modern.
1. Scaffolding Autentikasi Instan (canting make:auth)
Buat modul registrasi, login, logout, dan dashboard siap pakai hanya dengan satu perintah:
canting make:authPerintah ini akan secara otomatis membuat:
- Controller:
src/app/controllers/auth_controller.rs - Model & Migrasi:
Usermodel dengan hashing password - Halaman View Blade:
resources/views/auth/login.blade.rs,register.blade.rs, dandashboard.blade.rs.
Catatan: Untuk starter kit autentikasi & dashboard modern berbasis Tailwind CSS dan Pure Blade dengan proteksi Anti Brute-Force & Audit Trail, gunakan Pakem Aurora Starter Kit (
canting aurora:install).
2. Password Hashing (Bcrypt)
Pakem menggunakan algoritma hashing Bcrypt standar industri:
use bcrypt::{hash, verify, DEFAULT_COST};
// Hashing password baru
let raw_password = "password_rahasia_123";
let hashed = hash(raw_password, DEFAULT_COST)?;
// Verifikasi password saat login
let is_valid = verify("password_input_user", &hashed)?;
if is_valid {
println!("Password cocok!");
}3. Autentikasi JWT (JSON Web Token)
A. Model Pengguna Terautentikasi (AuthUser)
use pakem::core::auth::AuthUser;
use pakem::http::auth::{generate_token, validate_token};
// 1. Buat instance AuthUser setelah login sukses (berlaku 24 jam)
let user = AuthUser::new(
1, // user_id
"user@example.com".to_string(), // email
"admin".to_string(), // role
vec!["create_post".to_string()], // permissions
24, // masa aktif (jam)
);
// 2. Generate token JWT string
let token = generate_token(&user)?;B. Memproteksi Endpoint dengan AuthUser Extractor
Cukup letakkan auth_user: AuthUser di parameter fungsi controller Anda. Pakem akan otomatis memvalidasi header Authorization: Bearer <token>:
use axum::Json;
use pakem::core::auth::AuthUser;
pub async fn profile(auth_user: AuthUser) -> Json<serde_json::Value> {
Json(serde_json::json!({
"status": "authorized",
"user_id": auth_user.sub,
"email": auth_user.email,
"role": auth_user.role,
}))
}4. Role & Permission Guard (can)
Periksa hak akses user menggunakan method auth_user.can(...):
use axum::http::StatusCode;
pub async fn delete_article(auth_user: AuthUser) -> Result<String, StatusCode> {
if !auth_user.can("delete_post") && auth_user.role != "admin" {
return Err(StatusCode::FORBIDDEN);
}
Ok("Artikel berhasil dihapus".to_string())
}5. Direktif Autentikasi di Blade (@auth, @guest)
Sembunyikan atau tampilkan elemen navigasi berdasarkan status login:
@auth
<span>Halo, {{ $auth.email }}!</span>
<form method="POST" action="/logout">
@csrf
<button type="submit">Keluar</button>
</form>
@endauth
@guest
<a href="/login">Masuk</a>
<a href="/register">Daftar Akun</a>
@endguest6. Pakem Shield Security Audit (canting audit)
Sebelum melakukan deployment ke server produksi, Pakem menyediakan alat audit keamanan otomatis:
canting auditLingkup Pemeriksaan Otomatis:
- Secret & Key Entropy: Memverifikasi kekuatan
APP_KEYdanJWT_SECRET(panjang minimal 32 karakter dan bukan placeholder default). - Debug Mode in Production: Mencegah kebocoran stack trace dan kredensial sensitif jika
APP_DEBUG=trueaktif di lingkunganproduction. - CSRF Protection on Forms: Memindai seluruh template tampilan (
resources/views/) untuk memastikan setiap formulir bermetodePOSTmemiliki direktif@csrf. - Database & Storage Hardening: Memeriksa koneksi database dan isolasi folder upload publik.
- Scoreboard & Actionable Fixes: Memberikan skor keamanan (0–100), peringkat mutu (Grade A+), serta rekomendasi perintah perbaikan secara instan.
7. Ekosistem Keamanan Tingkat Lanjut & Starter Kit
Untuk implementasi keamanan tingkat lanjut dan starter kit siap pakai:
- Modul 14: Pakem Aurora Starter Kit: Paket autentikasi & dashboard elegan dengan Pure Blade + Tailwind CSS (
canting aurora:install). - Modul 15: Enterprise Security & Zero-Panic Safety: Zero-Panic Error Boundary (
catch_unwind), Anti Brute-Force lockout cache, OWASP security headers, dan audit trail ISO 27001.
Navigasi Modul:
- Sebelumnya: Modul 07: Indonesian Script
- Berikutnya: Modul 09: Broadcasting & WebSocket ➔
- Kembali ke: Daftar Isi Dokumentasi