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. |
Penyelarasan UU PDP No. 27 Tahun 2022
Section titled “Penyelarasan UU PDP No. 27 Tahun 2022”- 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 melaluisharp, 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:2iterasioutputLen:32byteparallelism: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 memverifikasicurrentPasswordterlebih 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:
Credentialsmenggunakanusername(normalisasitrim().toLowerCase(), 3–32 karakter^[a-z0-9_-]+$) danpassword. - Strategi Sesi:
jwtdenganmaxAge: 8 * 60 * 60(8 jam). - Mitigasi Enumeration & Timing Attack:
- Ketika
usernametidak ditemukan di PostgreSQL,authorize()tetap menjalankanverifyPassword()terhadap hash Argon2id dummy sebelum mencatat log auditUSER_NOT_FOUNDdan mengembalikannull. - Pesan galat pada UI login (
loginAction) diseragamkan menjadi"Username atau kata sandi tidak valid."untuk user tidak ditemukan, akun nonaktif, maupun sandi salah.
- Ketika
- Catatan Keamanan Konfigurasi: Di lingkungan produksi, variabel
AUTH_SECRETwajib diisi dengan string acak minimal 32 karakter karenalib/auth/auth.tsmemiliki string fallback pengembangan apabilaAUTH_SECRETdanNEXTAUTH_SECRETtidak 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_limitsdengan kuncilogin:{normalizedUsername}sehingga konsisten lintas restart maupun replika kontainer. - Ambang Bawaan: Maksimal
5percobaan gagal (DEFAULT_MAX_ATTEMPTS) dalam jendela15menit (DEFAULT_WINDOW_MINUTES). - Percobaan ke-5 mengaktifkan kolom
locked_until = now + 15 menit. Login yang berhasil menghapus record rate-limit lewatresetRateLimit().
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:
- Memastikan
session?.user?.idvalid. - Memverifikasi admin masih ada dan
admin.isActive === true. - Membandingkan
session.user.sessionVersion === admin.sessionVersion.
Kolom sessionVersion otomatis dinaikkan (increment: 1) saat:
logoutAction()(keluar sesi)toggleAdminStatus()saat menonaktifkan adminresetAdminPassword()oleh Super Adminprisma/seed.ts(jikaADMIN_SEED_RESET_PASSWORD="true") atauscripts/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.tsxdancomponents/admin/AccountSettingsView.tsx, kartu pengaturan tampilan beranda hanya ditampilkan bagiSUPER_ADMIN. Namun pada fungsiupdateHomepageDisplayLimitdilib/actions/system-settings-actions.ts, penjaga yang dipanggil saat ini adalahrequireAdmin(true), bukanrequireSuperAdmin(false)(danAuditActionyang dicatat masihADMIN_PASSWORD_CHANGED). Tim rekayasa perlu menyelaraskan pengecekan tersebut kerequireSuperAdmin(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/*)”- Otorisasi & Batas Payload: Memanggil
requireAdmin(false), memeriksa headerContent-Length <= UPLOAD_MAX_BYTES * 1.5, dan memastikanfile.size <= UPLOAD_MAX_BYTES(default5242880byte / 5 MB). - 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.
- JPEG:
- Proteksi Decompression Bomb & Sanitasi EXIF (
processImageBuffer):sharp(inputBuffer, { limitInputPixels: 50000000 })membatasi resolusi input maksimal 50 MP.- Auto-orientasi (
.rotate()), resize proporsional maksimal2560px, dan re-encoding keimage/webp(quality: 85) meluruhkan polyglot payload serta metadata EXIF/GPS.
- 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. - Fallback Penyimpanan: Jika endpoint S3 tidak terjangkau (
ECONNREFUSED,TimeoutError,fetch failed), berkas ditulis kepublic/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>: Hanyahref,name,target,rel,title. - Skema
<a>: Hanyahttp,https, danmailto. Setiap tautan dipaksa memakaitarget="_blank"danrel="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.
5. Header Keamanan HTTP & Pipeline Audit
Section titled “5. Header Keamanan HTTP & Pipeline Audit”5.1 Header Keamanan (next.config.ts)
Section titled “5.1 Header Keamanan (next.config.ts)”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”scripts/security-audit.ts:- Memastikan
.gitignoremengabaikan.env,.db_sdr, dannode_modules. - Memindai hasil kompilasi
.next/static/**/*.jsuntuk memastikanAUTH_SECRET,ADMIN_SEED_PASSWORD, danS3_SECRET_ACCESS_KEYtidak bocor ke bundle peramban. - Memverifikasi keberadaan seluruh 5 header keamanan di
next.config.ts.
- Memastikan
- GitHub Actions (
.github/workflows/ci-deploy.yml):npm audit --omit=dev --audit-level=highmemeriksa kerentanan dependensi produksi.ghcr.io/gitleaks/gitleaks:v8.24.2memindai seluruh riwayat git (git --redact --log-opts=HEAD .) dari kebocoran rahasia.
- Verifikasi Keamanan per Fase (
scripts/verify-phase3.ts&verify-phase5.ts): Menguji penolakanUNAUTHORIZEDpada Server Actions tanpa sesi, sanitasi payload XSS, penolakan skema URL berbahaya, penolakan magic bytes biner palsu (MZ...), dan proteksirobots.ts/sitemap.ts.