Dokumen ini menjelaskan langkah-langkah keamanan yang benar-benar diterapkan dalam kode TIARA saat ini, batasan yang ada, dan hal-hal yang belum diimplementasikan. Kejujuran tentang batasan lebih penting daripada kesan.
- Semua kata sandi di-hash menggunakan bcrypt sebelum disimpan ke tabel
users. - Kata sandi plaintext tidak disimpan di database.
- Token akses ditandatangani dengan HS256 menggunakan
JWT_SECRET_KEY(disarankan minimal 32 karakter acak; nilai bawaan diconfig.pyhanya placeholder dan wajib diganti). - Payload token berisi:
sub(user ID),type: "access". - Token akses berlaku 60 menit (dikonfigurasi via
ACCESS_TOKEN_EXPIRE_MINUTES). - Token dikirim di header
Authorization: Bearer <token>. - Token harus bertipe
"access"; token lain ditolak dengan 401. - Refresh token belum diimplementasikan.
- Setelah caregiver memverifikasi PIN, sistem menerbitkan token dashboard terpisah (JWT pendek, TTL 30 menit,
CAREGIVER_DASHBOARD_TOKEN_EXPIRE_MINUTES). - Token ini dikirim di header
X-Dashboard-Tokenpada setiap permintaan ke endpoint caregiver. - Backend memverifikasi bahwa token milik akun caregiver yang sama dengan JWT utama; token akun lain ditolak dengan 403.
Diterapkan melalui dependency FastAPI (require_role) di backend, bukan hanya redirect frontend.
Tiga peran yang ada: elderly, caregiver, healthcare.
| Grup Endpoint | Elderly | Caregiver | Healthcare |
|---|---|---|---|
/api/v1/auth/* |
Ya | Ya | Ya |
/api/v1/elderly/* |
Ya | Tidak | Tidak |
/api/v1/elderly/checkin/* |
Ya | Tidak | Tidak |
/api/v1/caregiver/* |
Tidak | Ya + PIN | Tidak |
/api/v1/healthcare/* |
Tidak | Tidak | Ya |
Peran admin tercantum di dokumen desain lama tetapi tidak diimplementasikan di kode saat ini.
- PIN di-hash dengan bcrypt sebelum disimpan ke tabel
caregiver_pins. - PIN plaintext tidak pernah disimpan.
- Endpoint caregiver yang memerlukan PIN mengembalikan 403 dengan kode
PIN_DIPERLUKANbila headerX-Dashboard-Tokentidak ada, kadaluarsa, atau milik akun lain. - Frontend membaca kode
PIN_DIPERLUKANdan mengarahkan pengguna ke halaman PIN. - Kunci sementara: 5 kali PIN salah berturut-turut mengunci verifikasi PIN selama 15 menit (respons 429). Penghitung gagal direset setelah PIN benar. Angkanya diambil dari
PIN_MAX_ATTEMPTSdanPIN_LOCKOUT_MINUTESdibackend/app/core/constants.py.
Konfigurasi CORS di backend/app/main.py:
allow_origins: nilai dariFRONTEND_URL(bisa berisi beberapa origin dipisah koma).allow_origin_regex: mengizinkanhttps://(www\.)?tiaracare\.my\.iddanhttp://localhost:<port>.- Header yang diizinkan:
Authorization,Content-Type,Accept,X-Dashboard-Token. - Jangan mengatur
FRONTEND_URL=*di lingkungan produksi.
- Setiap berkas audio rekaman disimpan dalam format terenkripsi dengan ekstensi
.webm.enc. - Enkripsi menggunakan Fernet (AES-128-CBC + HMAC-SHA256) dari library
cryptography. - Kunci enkripsi dibaca dari variabel lingkungan
MEDIA_ENCRYPTION_KEYdibackend/.env. - Dekripsi dilakukan hanya di memori saat pemrosesan; berkas terenkripsi tidak pernah ditulis ulang ke disk dalam bentuk plaintext.
- Peringatan: jika
MEDIA_ENCRYPTION_KEYhilang, semua rekaman terenkripsi menjadi permanen tidak bisa dibuka. Simpan salinan kunci secara aman. - Ini adalah enkripsi saat disimpan (at rest) saja. Untuk produksi, HTTPS tetap diperlukan untuk enkripsi saat transit.
Cara membuat kunci Fernet baru:
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"- Teks transkrip di tabel
transcriptsdisimpan sebagai plaintext di database PostgreSQL. - Kolom teks lain (jawaban, ringkasan skor, indikator) juga plaintext.
- Enkripsi database atau enkripsi kolom-per-kolom belum diimplementasikan.
- Semua rahasia (kunci JWT, kunci enkripsi media, kunci API LLM, URL database) disimpan di
backend/.env. - File
.envdan.env.localdikecualikan oleh.gitignore(baris.env,.env.local,.env.*.local). .env.exampledisediakan dengan semua nama variabel tetapi tanpa nilai nyata.- Jangan pernah hardcode nilai rahasia di dalam kode atau mendorong file
.envke repositori.
- Sesi check-in hanya bisa dimulai bila
consent: truedikirim kePOST /elderly/checkin/start. - Tanpa persetujuan, API mengembalikan 400.
- Waktu persetujuan disimpan di kolom
consent_atdi tabelcheckin_sessions.
| Aspek | Kondisi Saat Ini |
|---|---|
| Data yang dikumpulkan | Audio rekaman suara per pertanyaan check-in; transkrip teks; fitur pola bicara; skor risiko; jurnal suasana hati; pesan chat panduan |
| Tempat penyimpanan | Database PostgreSQL (metadata dan analisis); filesystem lokal MEDIA_STORAGE_PATH (berkas audio .webm.enc) |
| Siapa yang bisa melihat analisis | Caregiver (via dashboard + PIN); tenaga kesehatan (via dashboard peran) |
| Yang tidak ditampilkan ke lansia | Skor risiko dan data klinis tidak ditampilkan di antarmuka lansia, hanya pesan dorongan hangat |
| Retensi data otomatis | Belum ada kebijakan retensi otomatis di kode. Tidak ada penghapusan terjadwal. |
| Penghapusan akun | Soft delete (flag is_deleted) pada tabel users; berkas media tidak dihapus otomatis |
| Data simulasi | Sesi berlabel provider="simulasi-demo" adalah data buatan dari skrip seed, bukan rekaman nyata |
| Jurnal suasana hati | Disimpan di database tetapi belum ditampilkan ke caregiver maupun tenaga kesehatan |
- HTTPS tidak diterapkan di lapisan aplikasi; perlu dikonfigurasi di reverse proxy atau platform hosting untuk produksi.
- Enkripsi teks transkrip di database belum ada.
- Pemisahan tabel kredensial dari profil pengguna belum dilakukan (semua di tabel
users). - Audit log akses dashboard caregiver belum diimplementasikan.
- Rate limiting pada endpoint autentikasi belum diimplementasikan.
- Notifikasi push, WhatsApp, atau email tidak ada; semua alert hanya muncul di dashboard saat dibuka.
- Alur penghapusan data pengguna (permintaan GDPR-style) belum ada.
- Audit keamanan eksternal belum dilakukan. Jangan mengklaim kepatuhan regulasi penuh.
- Sertifikasi keamanan apa pun belum ada.
Jika menemukan kerentanan keamanan, hubungi tim TIARA secara pribadi sebelum membuat laporan publik.
Kontak: [isi alamat email atau saluran pelaporan tim di sini]
Harap sertakan: deskripsi kerentanan, langkah reproduksi, dampak yang mungkin terjadi, dan saran perbaikan bila ada.