Keamanan & Privasi (SV-SEC-001)
| Field | Nilai |
|---|---|
| ID Dokumen | SV-SEC-001 |
| Pilar | Data |
| Standar Acuan | OWASP ASVS / ISO 27001 / UU PDP No. 27 Tahun 2022 |
| Status | Aktif / Tersinkronisasi dengan Kode |
| Terakhir Diperbarui | 2026-11-21 |
| Sumber Kebenaran | next.config.ts, src/features/auth/*, src/features/privasi/*, src/features/aspirasi/sender.ts, src/features/aspirasi/gambar.ts, src/features/form/hasil.ts, src/features/form/pendahuluan.ts, src/features/admin/audit.ts, prisma/seed-guard.ts, tests/e2e/keamanan.spec.ts |
Dokumen pengendalian keamanan aplikasi dan perlindungan data pribadi Sudirman Voice yang diselaraskan dengan Undang-Undang Nomor 27 Tahun 2022 tentang Pelindungan Data Pribadi (UU PDP) dan praktik keamanan aplikasi web modern.
1. Klasifikasi Data & Inventaris PII (src/features/privasi/ketentuan.ts)
Section titled “1. Klasifikasi Data & Inventaris PII (src/features/privasi/ketentuan.ts)”| Kategori Data | Atribut & Tabel | Klasifikasi | Pengendali & Retensi Akses |
|---|---|---|---|
| Kredensial & Token | users.pin_hash, sessions.token_hash, kode_email.kode_hash |
Sangat Rahasia | Hanya verifikasi server (Argon2id untuk PIN, SHA-256 untuk sesi & kode). Tidak pernah dikembalikan ke UI, CurrentUser, log audit, atau ekspor. |
| Identitas Pribadi (PII) | users: no_serdik, nama, grup, elemen, kelas, email, email_terikat_pada |
Terbatas (PII) | Pemilik akun, Admin, dan pemegang izinDataUser (kecuali akun Admin). Email hanya 1 per akun; untuk tampilan kode OTP disamarkan oleh samarkanEmail() (an***@domain). |
| Data Rahasia / Anonim | aspirations (is_rahasia=true), forms (rahasia=true), polls (anonim=true) |
Rahasia Terisolasi | Identitas (userId) tetap disimpan secara teknis agar pengirim bisa memantau progres & menerima notifikasi, namun dilarang keras dimuat ke UI pengelola, ekspor Excel, maupun AuditLog. |
| Konten Partisipasi & Karya | form_responses, form_answers, poll_votes, hackathon_*, laporan_masalah |
Internal Program | Pengelola sesuai kepemilikan peran (peranId). laporan_masalah hanya dapat dibaca oleh Admin (tanpa PIN, token, atau jawaban survei). |
| Data Teknis & Kepatuhan | audit_logs, persetujuan, permintaan_data, push_subscriptions, email_keluar |
Operasional & Audit | Log audit hanya untuk Admin. Persetujuan & permintaan data dikelola per pemilik & Admin. |
2. Kepatuhan UU PDP No. 27/2022 (features/privasi/)
Section titled “2. Kepatuhan UU PDP No. 27/2022 (features/privasi/)”Sudirman Voice menerapkan pengendalian hak subjek data secara langsung di aplikasi (VERSI_KETENTUAN = 2, tanggal 16 November 2026):
- Persetujuan Berversi (
persetujuan): Saat pertama masuk, atau saatVERSI_KETENTUANnaik,AppLayoutmenampilkan layar persetujuan (LayarPersetujuan). Memilih “Nanti saja” memasang cookie sesi browsersv_persetujuan_nantitanpa memberi izin tulis. - Penegakan Mode Hanya-Baca (
pesanHanyaBaca): SelamastatusPersetujuan(userId).setuju === false(termasuk setelah pengguna memilih Tarik persetujuan melaluitarikAction), seluruh aksi tulis peserta (kirimAction,keteranganAction,kirimFormAction,tandaiSelesaiAction,batalkanTandaAction,pilihAction,batalPilihAction, dan seluruh aksi di/hackathon/actions.ts) menolak mutasi dengan pesanPESAN_HANYA_BACA. Pengguna tetap dapat membaca, mengganti PIN, dan menggunakan/profil/privasi. - Hak Akses & Portabilitas (
eksporDataSaya): MelaluiGET /profil/privasi/unduh, pengguna mengunduh seluruh datanya sendiri dalam satu berkas Excel (data-saya-<noSerdik>.xlsx) berisi 6 sheet: Profil, Aspirasi, Jawaban form, Pilihan polling, Hackathon, dan Persetujuan. - Hak Koreksi, Hapus, Insiden & Pertanyaan (
PermintaanData): Pengguna dapat mengajukan maksimal 3 permintaan per 24 jam (DAT-XXXX) dengan SLA tanggapan Admin maksimal 3 x 24 jam (BATAS_TANGGAP_MS). Perubahan status oleh Admin tercatat diAuditLog(DATA_PERMINTAAN) dan memicu notifikasi + email ke pengaju.
3. Siklus Autentikasi, Throttling & Proteksi Akun
Section titled “3. Siklus Autentikasi, Throttling & Proteksi Akun”sequenceDiagram
participant C as Browser / Client
participant L as login() / throttle.ts / lockout.ts
participant DB as PostgreSQL
C->>L: POST No. Serdik + PIN (ambil IP dari x-real-ip)
L->>L: Validasi format No. Serdik (001-400) & 6 digit PIN
L->>DB: reserveIpAttempt(ip) -> UPSERT login_throttles (maks 20 / 10 menit)
alt IP Melebihi 20 Percobaan
L-->>C: THROTTLED (tidak menjalankan Argon2)
else Slot IP Tersedia
L->>DB: Cari User aktif; jika tidak ada, verifikasi DUMMY_PIN_HASH
L->>DB: reserveAccountAttempt(userId) -> UPDATE atomic users (maks 5 / siklus)
alt Akun Terkunci (lockedUntil > now)
L-->>C: LOCKED (jam buka dalam WIB)
else Slot Akun Tersedia
L->>L: verifyPin(pinHash, pin) [Argon2id]
alt PIN Salah
L->>DB: confirmFailedAttempt() -> catat AUTO_LOCK jika ke-5 (+10 menit)
L-->>C: INVALID (peringatan sisa saat ke-3 & ke-4)
else PIN Benar
L->>DB: confirmSuccess() + refundIpAttempt() + createSession()
L-->>C: Set cookie httpOnly sv_session (token acak 32 byte, DB simpan SHA-256)
end
end
end
3.1 Mekanisme Rinci Autentikasi
Section titled “3.1 Mekanisme Rinci Autentikasi”- PIN & Kebijakan PIN Lemah (
lib/pin.ts,lib/pin-rules.ts): PIN wajib 6 digit angka. Ditolak bila angka identik (111111), deret naik/turun 6 angka (123456,654321), atau pengulangan No. Serdik (033033). Hash menggunakan Argon2id. - Sesi (
features/auth/session.ts,cookie.ts): Token acakrandomBytes(32).toString("base64url")disimpan pada cookiesv_session(httpOnly: true,secure: NODE_ENV !== "development",sameSite: "lax",path: "/"). Basis data hanya menyimpanSHA-256(token). Kedaluwarsa DB 30 hari dengan perpanjangan otomatis bila sisa < 15 hari. Mengganti PIN mencabut seluruh sesi lain milik pengguna tersebut. - Aktivasi & Lupa PIN (
features/auth/google.ts,aktivasi.ts,kode-email.ts):- Google OIDC + PKCE: State, nonce, dan PKCE code verifier (
S256) disimpan dalam cookie httpOnlysv_oauthberumur 10 menit di path/api/auth/google. Token ID ditukar langsung server-to-server melalui TLS kehttps://oauth2.googleapis.com/tokendan diverifikasi klaimiss,aud,nonce,exp, danemail_verified. Alamat email terverifikasi dicocokkan ke email yang telah dicatat Admin untuk akun tersebut (users.email). - Kode Email 6 Digit: Hash
SHA-256(userId:kode), dibandingkan dengantimingSafeEqual, berlaku 10 menit, maksimal 5 tebakan salah (dihitung atomik denganupdateManybersyarat sebelum verifikasi agar tebakan paralel tidak berbagi slot), maksimal 3 permintaan per 15 menit. - Berhasilnya salah satu jalur mengikat
emailTerikatPada, menghapusfailedAttempts/lockedUntil, menyetelmustChangePin = true, dan menulisEMAIL_TERIKATsertaAKTIVASI_GOOGLEkeAuditLog.
- Google OIDC + PKCE: State, nonce, dan PKCE code verifier (
- IP Throttling Anti-Spoofing (
features/auth/request.ts):getClientIp()membacax-real-ipterlebih dahulu (diisi oleh Traefik dari soket TCP), kemudian fallback ke entri paling kananx-forwarded-for. Nilai yang disisipkan klien di kirix-forwarded-fortidak pernah dipercaya. - Anti Open-Redirect (
safeNext): Mengizinkan hanya path lokal yang dimulai dengan satu/tanpa//,\,://, atau karakter kontrol (maks. 2048 karakter).
4. Otorisasi Dinamis (RBAC) & Anti-Enumerasi
Section titled “4. Otorisasi Dinamis (RBAC) & Anti-Enumerasi”- Sumber Kebenaran Tunggal (
src/features/auth/izin.ts):- Peran sistem
ADMIN(kode = "ADMIN") memiliki akses ke semua fitur;LEMUSDIK(kode = "LEMUSDIK") memiliki fituraspirasi. Keduanya dilindungi agar tidak dapat dinonaktifkan (SISTEM), dan Admin tidak dapat mencabut peran Admin miliknya sendiri (SELF_ADMIN) maupun menonaktifkan dirinya sendiri (SELF_DEACTIVATE). - Mutasi peran & aktivasi menggunakan
pg_advisory_xact_lock(724001)untuk menjamin selalu tersisa minimal 1 Admin aktif (LAST_ADMIN). - Pemegang peran dengan
izinDataUser(non-Admin) dapat mengubah data, mereset PIN, mengatur/melepas email, dan membuka kunci akun Serdik biasa, namun dilarang menyentuh akun Admin (targetIsAdmin) maupun membuka halaman Peran/Impor/Log/Laporan/Permintaan Data.
- Peran sistem
- Penegakan Dua Lapis:
- Layout Next.js (
requireIzin,requireAdmin) merender403 Forbidden(src/app/forbidden.tsx) bila izin tidak terpenuhi. - Service selalu memanggil
muatPeran(actorId)dari DB pada setiap eksekusi mutasi/baca sensitif, dangetCurrentUser()hanya memuat peran aktif (aktif: true).
- Layout Next.js (
- Anti-Enumerasi
NOT_FOUND(404): Padakonten/kepemilikan.ts(muatMilik),hackathon/kelola.ts(muat), danhackathon/tim.ts(bolehUbah), sumber daya milik peran lain atau tim lain membalasNOT_FOUND(404), bukanFORBIDDEN(403), sehingga pengguna berizin tidak dapat memindai kodeFRM-XXXX,PLL-XXXX, atauHKT-XXXXmilik peran lain.
5. Jaminan Anonimitas & Kerahasiaan Mutlak
Section titled “5. Jaminan Anonimitas & Kerahasiaan Mutlak”Aturan ini diuji secara otomatis oleh tes integrasi (aspirasi-rahasia.test.ts, form-hasil.test.ts, polling-anonim.test.ts):
| Fitur | Mekanisme Pengamanan di Kode & Basis Data |
|---|---|
Aspirasi Rahasia (isRahasia = true) |
Pilihan dikunci permanen saat dikirim. Dalam lemusdik.ts (SAFE_SELECT & namedSenders()), relasi user hanya diambil untuk baris dengan isRahasia: false. senderLabelAspirasi() hanya menampilkan "Rahasia" (menyembunyikan nama, No. Serdik, Grup, maupun Elemen). Ekspor Excel (lemusdik-export.ts) menuliskan "Rahasia" di kolom Pengirim, Grup, dan Elemen. AuditLog tidak pernah mencatat identitas pengirim aspirasi. |
Form Rahasia (rahasia = true) |
Dalam form/hasil.ts, untuk form rahasia: relasi user tidak pernah dipilih di query Prisma (rahasia ? {} : { user: { select: NAMED_SENDER_SELECT } }), tab responden diblokir (FORBIDDEN), rincian per Grup/Elemen dan kutipan isian teks dinonaktifkan, belumMengisi() hanya mengembalikan jumlah (count), dan sheet Excel menghilangkan seluruh kolom identitas (Pengirim, Nama, No. Serdik, Grup, Elemen). |
Polling Anonim (anonim = true) |
Status anonim terkunci sejak polling diterbitkan (TERBIT). Fungsi rekap SQL (polling/rekap.ts) hanya mengagregasi public.poll_votes tanpa pernah menyentuh tabel users. daftarPemilih() menolak dengan FORBIDDEN bila anonim = true, dan sheet Responden tidak dibuat di Excel. |
| Hackathon: Karya Rahasia & Komentar Juri | Selama tahap SUBMISI, detail submisi dan tangkapan layar hanya bisa diakses anggota tim sendiri (panitia sekalipun hanya melihat progres pengiriman). Komentar juri di halaman Pengumuman disampaikan secara anonim kepada tim tanpa nama juri. |
6. Keamanan Media, Sanitasi HTML & Upload
Section titled “6. Keamanan Media, Sanitasi HTML & Upload”- Penghapusan EXIF & Kompresi Sisi Klien:
- Foto aspirasi & bukti (
pilih-gambar.tsx) serta tangkapan layar hackathon di-render ulang ke elemen<canvas>browser (createImageBitmap+toBlob("image/jpeg", mutu)). Proses re-encoding ini secara efektif menghapus seluruh metadata EXIF termasuk koordinat GPS sebelum diunggah ke server. - Banner form 4:1 (
banner-picker.tsx) dipotong dan di-encode ulang menjadi JPEG (maks. 1600 px, <= 550 KB di klien, maks. 600 KB di server).
- Foto aspirasi & bukti (
- Validasi Magic Bytes Server (
aspirasi/gambar.ts):jenisDari()memeriksa header biner aktual file (JPEGFF D8 FF, PNG89 50 4E 47 0D 0A 1A 0A, WebPRIFF<4-byte-ukuran>WEBP) dan mengabaikan MIME type deklarasi browser. Batas ukuran: <= 1 MB per foto aspirasi/hackathon (maks. 3 foto), <= 600 KB untuk banner. - Penyajian Media Berotorisasi:
GET /aspirasi-gambar/[kode]/[id]: Hanya pengirim aspirasi atau pengelola Aspirasi (izin("aspirasi")); foto bukti (eventId !== null) baru terbuka untuk pengguna login lain setelahisPublik = true.GET /form-banner/[kode]: Hanya pengelola form terkait atau Serdik target saat form efektifTERBUKA/DITUTUP.GET /hackathon-gambar/[kode]/[id]: Hanya anggota tim saat tahapSUBMISI; terbuka bagi pengguna login sejak tahapPENILAIAN.- Seluruh route media mengirimkan header
Cache-Control: private,X-Content-Type-Options: nosniff, danContent-Security-Policy: default-src 'none'.
- Sanitasi Rich Text Pendahuluan Form (
features/form/pendahuluan.ts): Tidak membiarkan HTML pengguna lewat begitu saja; parser token merakit ulang HTML dari awal dan hanya mengizinkan tagstrong,em,u,br,p,ul,ol,liserta atribut amanstyle="text-align:<arah>"dandata-jarak="lega". - Validasi Tautan Eksternal (
lib/tautan.ts) & Anti Zip-Bomb (admin/import/parse.ts): Seluruh URL luar wajib protokolhttps://dengan hostname bertitik (menolakhttp:,javascript:,data:). Parser.xlsxadmin membaca direktori sentral ZIP terlebih dahulu (zipUncompressedSize) dan menolak berkas jika ukuran tak terkompresi > 20 MB.
7. Header Keamanan Browser, CSP, Production Guards & AuditLog
Section titled “7. Header Keamanan Browser, CSP, Production Guards & AuditLog”7.1 Header Keamanan (next.config.ts)
Section titled “7.1 Header Keamanan (next.config.ts)”Diterapkan ke seluruh path (/:path*) dan diuji otomatis di tests/e2e/keamanan.spec.ts:
Content-Security-Policy:default-src 'self'; script-src 'self' 'unsafe-inline' (ditambah 'unsafe-eval' hanya di NODE_ENV=development); style-src 'self' 'unsafe-inline'; img-src 'self' blob: data:; font-src 'self'; connect-src 'self'; worker-src 'self'; manifest-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self' https://accounts.google.com; frame-ancestors 'none'Strict-Transport-Security:max-age=63072000; includeSubDomainsX-Content-Type-Options:nosniffX-Frame-Options:DENYReferrer-Policy:strict-origin-when-cross-originPermissions-Policy:camera=(), microphone=(), geolocation=(), browsing-topics=()Cross-Origin-Opener-Policy:same-origin
7.2 Production Guards (dev-login.ts & seed-guard.ts)
Section titled “7.2 Production Guards (dev-login.ts & seed-guard.ts)”isDevLoginEnabled(): Menolak mutlak Mode Uji apabilaDEV_LOGIN !== "true",APP_ENV === "production",VERCEL_ENV === "production", atau hostDATABASE_URLsama denganPRODUCTION_DB_HOST.seedRefusal(): Menolak eksekusi script seed apabilaAPP_ENV === "production"atauVERCEL_ENV === "production", serta menolak basis data non-localhost kecualiSEED_ALLOW_REMOTE=truedisetel eksplisit (khusus branch dev/preview).
7.3 Jejak Audit (AuditLog)
Section titled “7.3 Jejak Audit (AuditLog)”Semua aksi administratif, manajemen konten, dan keamanan akun dicatat lewat writeAudit() dengan 52 tipe AuditAction. Kolom meta JSON dilarang keras memuat PIN plaintext, pinHash, token sesi, maupun identitas pengirim aspirasi rahasia. Log dapat ditelusuri Admin di /admin/log (50 baris per halaman, filter berdasarkan action dan noSerdik target).