Skip to content

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 saat VERSI_KETENTUAN naik, AppLayout menampilkan layar persetujuan (LayarPersetujuan). Memilih “Nanti saja” memasang cookie sesi browser sv_persetujuan_nanti tanpa memberi izin tulis.
  • Penegakan Mode Hanya-Baca (pesanHanyaBaca): Selama statusPersetujuan(userId).setuju === false (termasuk setelah pengguna memilih Tarik persetujuan melalui tarikAction), seluruh aksi tulis peserta (kirimAction, keteranganAction, kirimFormAction, tandaiSelesaiAction, batalkanTandaAction, pilihAction, batalPilihAction, dan seluruh aksi di /hackathon/actions.ts) menolak mutasi dengan pesan PESAN_HANYA_BACA. Pengguna tetap dapat membaca, mengganti PIN, dan menggunakan /profil/privasi.
  • Hak Akses & Portabilitas (eksporDataSaya): Melalui GET /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 di AuditLog (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
  • 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 acak randomBytes(32).toString("base64url") disimpan pada cookie sv_session (httpOnly: true, secure: NODE_ENV !== "development", sameSite: "lax", path: "/"). Basis data hanya menyimpan SHA-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 httpOnly sv_oauth berumur 10 menit di path /api/auth/google. Token ID ditukar langsung server-to-server melalui TLS ke https://oauth2.googleapis.com/token dan diverifikasi klaim iss, aud, nonce, exp, dan email_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 dengan timingSafeEqual, berlaku 10 menit, maksimal 5 tebakan salah (dihitung atomik dengan updateMany bersyarat sebelum verifikasi agar tebakan paralel tidak berbagi slot), maksimal 3 permintaan per 15 menit.
    • Berhasilnya salah satu jalur mengikat emailTerikatPada, menghapus failedAttempts/lockedUntil, menyetel mustChangePin = true, dan menulis EMAIL_TERIKAT serta AKTIVASI_GOOGLE ke AuditLog.
  • IP Throttling Anti-Spoofing (features/auth/request.ts): getClientIp() membaca x-real-ip terlebih dahulu (diisi oleh Traefik dari soket TCP), kemudian fallback ke entri paling kanan x-forwarded-for. Nilai yang disisipkan klien di kiri x-forwarded-for tidak 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 fitur aspirasi. 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.
  • Penegakan Dua Lapis:
    1. Layout Next.js (requireIzin, requireAdmin) merender 403 Forbidden (src/app/forbidden.tsx) bila izin tidak terpenuhi.
    2. Service selalu memanggil muatPeran(actorId) dari DB pada setiap eksekusi mutasi/baca sensitif, dan getCurrentUser() hanya memuat peran aktif (aktif: true).
  • Anti-Enumerasi NOT_FOUND (404): Pada konten/kepemilikan.ts (muatMilik), hackathon/kelola.ts (muat), dan hackathon/tim.ts (bolehUbah), sumber daya milik peran lain atau tim lain membalas NOT_FOUND (404), bukan FORBIDDEN (403), sehingga pengguna berizin tidak dapat memindai kode FRM-XXXX, PLL-XXXX, atau HKT-XXXX milik 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.
  • 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).
  • Validasi Magic Bytes Server (aspirasi/gambar.ts): jenisDari() memeriksa header biner aktual file (JPEG FF D8 FF, PNG 89 50 4E 47 0D 0A 1A 0A, WebP RIFF<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 setelah isPublik = true.
    • GET /form-banner/[kode]: Hanya pengelola form terkait atau Serdik target saat form efektif TERBUKA/DITUTUP.
    • GET /hackathon-gambar/[kode]/[id]: Hanya anggota tim saat tahap SUBMISI; terbuka bagi pengguna login sejak tahap PENILAIAN.
    • Seluruh route media mengirimkan header Cache-Control: private, X-Content-Type-Options: nosniff, dan Content-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 tag strong, em, u, br, p, ul, ol, li serta atribut aman style="text-align:<arah>" dan data-jarak="lega".
  • Validasi Tautan Eksternal (lib/tautan.ts) & Anti Zip-Bomb (admin/import/parse.ts): Seluruh URL luar wajib protokol https:// dengan hostname bertitik (menolak http:, javascript:, data:). Parser .xlsx admin 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”

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; includeSubDomains
  • X-Content-Type-Options: nosniff
  • X-Frame-Options: DENY
  • Referrer-Policy: strict-origin-when-cross-origin
  • Permissions-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 apabila DEV_LOGIN !== "true", APP_ENV === "production", VERCEL_ENV === "production", atau host DATABASE_URL sama dengan PRODUCTION_DB_HOST.
  • seedRefusal(): Menolak eksekusi script seed apabila APP_ENV === "production" atau VERCEL_ENV === "production", serta menolak basis data non-localhost kecuali SEED_ALLOW_REMOTE=true disetel eksplisit (khusus branch dev/preview).

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).