Skip to content

Keamanan Sistem & Privasi Data — Soedirman Digital Repository (SDR)

Field Nilai
ID Dokumen SDR-SEC-001
Pilar Data
Standar Acuan OWASP ASVS / ISO/IEC 27001 / UU PDP No. 27 Tahun 2022
Status Aktif / Tersinkronisasi dengan Kode
Terakhir Diperbarui 2026-11-21
Sumber Kebenaran lib/auth/*, lib/security/sanitize.ts, lib/storage/*, lib/audit/*, lib/validations/*, lib/actions/*, app/api/uploads/route.ts, next.config.ts, proxy.ts, scripts/security-audit.ts, .github/workflows/ci-deploy.yml

1. Klasifikasi Data & Inventaris Data Pribadi (PII)

Section titled “1. Klasifikasi Data & Inventaris Data Pribadi (PII)”

Selaras dengan prinsip perlindungan data pribadi (UU Nomor 27 Tahun 2022 tentang Pelindungan Data Pribadi / UU PDP), seluruh aset data yang diproses SDR diklasifikasikan ke dalam empat tingkat sensitivitas:

Tingkat Klasifikasi Jenis Data & Lokasi Penyimpanan Kontrol Perlindungan
Rahasia Kredensial (Restricted) admins.password_hash (Argon2id), variabel AUTH_SECRET, DATABASE_URL, S3_SECRET_ACCESS_KEY, ADMIN_SEED_PASSWORD Tidak pernah dikirim ke bundle klien; dicegah lewat server-only, validasi scripts/security-audit.ts, dan pemindaian Gitleaks pada CI.
Data Pribadi Internal / Operasional (Confidential / PII) admins.name, admins.username, admins.email, audit_logs.ip_address, audit_logs.user_agent, audit_logs.actor_username, audit_logs.actor_display_name Hanya dapat diakses oleh sesi admin terautentikasi; daftar admin dan log audit global dibatasi khusus SUPER_ADMIN.
Data Kontribusi Pengguna (Internal Review) repository_submissions.submitter_name, catatan rejection_reason, serta data pra-publikasi (DRAFT, deleted_at IS NOT NULL) Terisolasi dari kueri publik; hanya tampil di panel /admin/submissions dan /admin/repositories.
Data Katalog Publik (Public) Karya Repository berstatus PUBLISHED (deleted_at IS NULL), Category, galeri WebP terkonversi (tanpa EXIF), dan target redirect ShortLink Dapat diakses publik tanpa login; metadata EXIF/GPS dihapus otomatis sebelum penyimpanan media.
  • Minimisasi Data & Tujuan Spesifik: Pengunjung katalog publik tidak perlu membuat akun dan tidak dilacak cookie pihak ketiga. Formulir pengajuan (/ajukan) hanya memproses nama pengaju/tim dan informasi karya yang relevan untuk katalog.
  • Penghapusan Metadata Lokasi/Perangkat pada Gambar: processImageBuffer() (lib/storage/image-processing.ts) melakukan re-encoding seluruh unggahan ke format WebP melalui sharp, yang secara bawaan melucuti seluruh blok EXIF (koordinat GPS, model kamera, timestamp perangkat).
  • Retensi Terbatas: Data pengunci login (auth_rate_limits) dan unggahan gagal ditautkan (media_uploads) kedaluwarsa setelah 24 jam (scripts/media-cleanup.ts); repositori terhapus lunak memiliki masa retensi default 30 hari (REPOSITORY_RETENTION_DAYS).
  • Penyensoran Log Audit: sanitizeMetadata() (lib/audit/audit-service.ts) otomatis mengganti kunci sensitif (password, passwordhash, password_hash, confirmpassword, newpassword, currentpassword, token, secret, authorization) menjadi "[REDACTED]" sebelum menyimpan JSONB ke PostgreSQL.

2. Arsitektur Autentikasi & Manajemen Sesi (lib/auth/*)

Section titled “2. Arsitektur Autentikasi & Manajemen Sesi (lib/auth/*)”

2.1 Hashing Kata Sandi (lib/auth/password.ts)

Section titled “2.1 Hashing Kata Sandi (lib/auth/password.ts)”

Menggunakan @node-rs/argon2 dengan parameter baseline OWASP:

  • memoryCost: 19456 (19 MiB)
  • timeCost: 2 iterasi
  • outputLen: 32 byte
  • parallelism: 1

Kebijakan panjang minimum kata sandi di kode:

  • Provisioning seed (prisma/seed.ts), pembuatan akun oleh Super Admin (createAdminAccount), dan reset sandi oleh Super Admin (resetAdminPassword): minimal 12 karakter.
  • Pembaruan kata sandi mandiri melalui /admin/settings (updateAccountCredentials): minimal 8 karakter, wajib memverifikasi currentPassword terlebih dahulu, dan tidak boleh sama dengan kata sandi saat ini.

2.2 Konfigurasi Auth.js v5 (lib/auth/auth.ts)

Section titled “2.2 Konfigurasi Auth.js v5 (lib/auth/auth.ts)”
  • Provider: Credentials menggunakan username (normalisasi trim().toLowerCase(), 3–32 karakter ^[a-z0-9_-]+$) dan password.
  • Strategi Sesi: jwt dengan maxAge: 8 * 60 * 60 (8 jam).
  • Mitigasi Enumeration & Timing Attack:
    • Ketika username tidak ditemukan di PostgreSQL, authorize() tetap menjalankan verifyPassword() terhadap hash Argon2id dummy sebelum mencatat log audit USER_NOT_FOUND dan mengembalikan null.
    • Pesan galat pada UI login (loginAction) diseragamkan menjadi "Username atau kata sandi tidak valid." untuk user tidak ditemukan, akun nonaktif, maupun sandi salah.
  • Catatan Keamanan Konfigurasi: Di lingkungan produksi, variabel AUTH_SECRET wajib diisi dengan string acak minimal 32 karakter karena lib/auth/auth.ts memiliki string fallback pengembangan apabila AUTH_SECRET dan NEXTAUTH_SECRET tidak diset.

2.3 Rate Limiting Berbasis Database (lib/auth/rate-limit.ts)

Section titled “2.3 Rate Limiting Berbasis Database (lib/auth/rate-limit.ts)”
  • Mekanisme pencatatan disimpan di tabel auth_rate_limits dengan kunci login:{normalizedUsername} sehingga konsisten lintas restart maupun replika kontainer.
  • Ambang Bawaan: Maksimal 5 percobaan gagal (DEFAULT_MAX_ATTEMPTS) dalam jendela 15 menit (DEFAULT_WINDOW_MINUTES).
  • Percobaan ke-5 mengaktifkan kolom locked_until = now + 15 menit. Login yang berhasil menghapus record rate-limit lewat resetRateLimit().

2.4 Pencabutan Sesi Aktif via sessionVersion (lib/auth/require-admin.ts)

Section titled “2.4 Pencabutan Sesi Aktif via sessionVersion (lib/auth/require-admin.ts)”

Token JWT stateless tidak bisa dicabut secara native oleh browser pihak lain; oleh karena itu setiap pemeriksaan requireAdmin() melakukan query langsung ke tabel admins:

  1. Memastikan session?.user?.id valid.
  2. Memverifikasi admin masih ada dan admin.isActive === true.
  3. Membandingkan session.user.sessionVersion === admin.sessionVersion.

Kolom sessionVersion otomatis dinaikkan (increment: 1) saat:

  • logoutAction() (keluar sesi)
  • toggleAdminStatus() saat menonaktifkan admin
  • resetAdminPassword() oleh Super Admin
  • prisma/seed.ts (jika ADMIN_SEED_RESET_PASSWORD="true") atau scripts/create-admin.ts

3. Matriks Otorisasi & Kontrol Akses (RBAC)

Section titled “3. Matriks Otorisasi & Kontrol Akses (RBAC)”

Sistem membedakan tiga tingkat akses utama: Publik (Anonim), ADMIN, dan SUPER_ADMIN.

Kapabilitas / Sumber Daya Publik ADMIN SUPER_ADMIN Penjaga Server-Side
Melihat /, /repositories, /categories/[slug], /s/[alias] Diizinkan Diizinkan Diizinkan PUBLIC_WHERE (PUBLISHED, deletedAt: null)
Mengajukan karya lewat /ajukan (submitPublicRepository) Diizinkan Diizinkan Diizinkan Validasi Zod publicSubmissionSchema (masuk status PENDING)
Akses halaman /admin, /admin/repositories/**, /admin/categories, /admin/submissions, /admin/shortlinks, /admin/my-activity, /admin/settings Ditolak (Redirect /admin/login) Diizinkan Diizinkan app/admin/(dashboard)/layout.tsx (requireAdmin(true)) + guard di tiap Server Action
Mengunggah media (POST /api/uploads) & menghapus pending (removeUploadAction) Ditolak (401) Diizinkan Diizinkan requireAdmin(false) + kepemilikan uploadedById === adminId saat hapus
Mengubah username & kata sandi pribadi (updateAccountCredentials) Ditolak Diizinkan Diizinkan requireAdmin(false) + verifikasi currentPassword
Mengatur batas tampilan beranda (updateHomepageDisplayLimit) Ditolak UI disembunyikan Diizinkan UI hanya merender HomepageDisplaySettingCard untuk SUPER_ADMIN; Server Action saat ini memeriksa requireAdmin(true)
Akses /admin/administrators & aksi akun (createAdminAccount, toggleAdminStatus, resetAdminPassword) Ditolak Ditolak (FORBIDDEN / Redirect /admin) Diizinkan requireSuperAdmin(...) + blokir deaktivasi diri sendiri & Super Admin aktif terakhir
Akses /admin/audit-logs (seluruh log sistem) Ditolak Ditolak (Redirect /admin) Diizinkan requireSuperAdmin(true)

[!IMPORTANT] Observasi Konsistensi Kontrol Server-Side: Pada app/admin/(dashboard)/settings/page.tsx dan components/admin/AccountSettingsView.tsx, kartu pengaturan tampilan beranda hanya ditampilkan bagi SUPER_ADMIN. Namun pada fungsi updateHomepageDisplayLimit di lib/actions/system-settings-actions.ts, penjaga yang dipanggil saat ini adalah requireAdmin(true), bukan requireSuperAdmin(false) (dan AuditAction yang dicatat masih ADMIN_PASSWORD_CHANGED). Tim rekayasa perlu menyelaraskan pengecekan tersebut ke requireSuperAdmin(false) bila ingin menegakkan batas peran penuh pada pemanggilan Server Action langsung.


4. Keamanan Unggahan Media & Sanitasi Konten

Section titled “4. Keamanan Unggahan Media & Sanitasi Konten”

4.1 Hardening Unggahan Gambar (app/api/uploads/route.ts & lib/storage/*)

Section titled “4.1 Hardening Unggahan Gambar (app/api/uploads/route.ts & lib/storage/*)”
  1. Otorisasi & Batas Payload: Memanggil requireAdmin(false), memeriksa header Content-Length <= UPLOAD_MAX_BYTES * 1.5, dan memastikan file.size <= UPLOAD_MAX_BYTES (default 5242880 byte / 5 MB).
  2. Inspeksi Magic Bytes (sniffImageFormat): Memeriksa byte awal buffer secara eksplisit:
    • JPEG: FF D8 FF
    • PNG: 89 50 4E 47 0D 0A 1A 0A
    • WebP: RIFF (byte 0–3) + WEBP (byte 8–11)
    • Berkas lain (termasuk SVG, HTML, atau executable seperti MZ...) langsung ditolak.
  3. Proteksi Decompression Bomb & Sanitasi EXIF (processImageBuffer):
    • sharp(inputBuffer, { limitInputPixels: 50000000 }) membatasi resolusi input maksimal 50 MP.
    • Auto-orientasi (.rotate()), resize proporsional maksimal 2560px, dan re-encoding ke image/webp (quality: 85) meluruhkan polyglot payload serta metadata EXIF/GPS.
  4. Kunci Penyimpanan Terkendali (generateStorageKey): Nama file dibentuk server menggunakan UUID acak (repositories/{tahun}/{bulan}/{kind}-{uuid}.webp), menghilangkan risiko path traversal dari nama berkas pengguna.
  5. Fallback Penyimpanan: Jika endpoint S3 tidak terjangkau (ECONNREFUSED, TimeoutError, fetch failed), berkas ditulis ke public/uploads/{storageKey} agar operasional pengembangan tetap berjalan.

4.2 Sanitasi Rich Text HTML (lib/security/sanitize.ts)

Section titled “4.2 Sanitasi Rich Text HTML (lib/security/sanitize.ts)”

Fungsi sanitizeOverview() menyaring HTML dengan sanitize-html:

  • Tag yang diizinkan (allowedTags): p, h2, h3, h4, h5, h6, strong, b, em, i, u, strike, ul, ol, li, a, br, hr, blockquote, code, pre. Tag <h1>, <script>, <iframe>, <img>, serta event handler inline (onerror, onclick, dll.) dibuang.
  • Atribut <a>: Hanya href, name, target, rel, title.
  • Skema <a>: Hanya http, https, dan mailto. Setiap tautan dipaksa memakai target="_blank" dan rel="noopener noreferrer nofollow".

4.3 Validasi Skema URL Eksternal (lib/validations/repository.ts)

Section titled “4.3 Validasi Skema URL Eksternal (lib/validations/repository.ts)”

isValidHttpUrl() mem-parse URL dengan konstruktor new URL() dan hanya mengizinkan protokol http: atau https:. Skema javascript:, data:, file:, maupun vbscript: ditolak pada level skema Zod sebelum tersimpan di database.


Diterapkan pada seluruh rute /(.*) melalui fungsi headers():

Header Nilai yang Diterapkan
Content-Security-Policy default-src 'self'; script-src 'self' 'unsafe-eval' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob: https: http://localhost:9000; font-src 'self' data:; connect-src 'self' https: http://localhost:9000; frame-ancestors 'none'; object-src 'none'; base-uri 'self'; form-action 'self';
X-Frame-Options DENY
X-Content-Type-Options nosniff
Referrer-Policy strict-origin-when-cross-origin
Permissions-Policy camera=(), microphone=(), geolocation=()

(Catatan: Terminasi HTTPS/TLS dan HSTS dikelola oleh reverse proxy/edge server di depan kontainer aplikasi repo.p3mdi.id & go.p3mdi.id.)

5.2 Audit Keamanan Otomatis & Pemindaian Rahasia

Section titled “5.2 Audit Keamanan Otomatis & Pemindaian Rahasia”
  1. scripts/security-audit.ts:
    • Memastikan .gitignore mengabaikan .env, .db_sdr, dan node_modules.
    • Memindai hasil kompilasi .next/static/**/*.js untuk memastikan AUTH_SECRET, ADMIN_SEED_PASSWORD, dan S3_SECRET_ACCESS_KEY tidak bocor ke bundle peramban.
    • Memverifikasi keberadaan seluruh 5 header keamanan di next.config.ts.
  2. GitHub Actions (.github/workflows/ci-deploy.yml):
    • npm audit --omit=dev --audit-level=high memeriksa kerentanan dependensi produksi.
    • ghcr.io/gitleaks/gitleaks:v8.24.2 memindai seluruh riwayat git (git --redact --log-opts=HEAD .) dari kebocoran rahasia.
  3. Verifikasi Keamanan per Fase (scripts/verify-phase3.ts & verify-phase5.ts): Menguji penolakan UNAUTHORIZED pada Server Actions tanpa sesi, sanitasi payload XSS, penolakan skema URL berbahaya, penolakan magic bytes biner palsu (MZ...), dan proteksi robots.ts/sitemap.ts.