android-skills 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +130 -2
  3. package/android-ui-minimal/SKILL.md +98 -0
  4. package/android-ui-minimal/references/anti-slop-checklist.md +61 -0
  5. package/android-ui-minimal/references/clarifying-questions.md +55 -0
  6. package/android-ui-minimal/references/color-and-contrast.md +104 -0
  7. package/android-ui-minimal/references/compose-patterns.md +120 -0
  8. package/android-ui-minimal/references/reconstruction-workflow.md +74 -0
  9. package/android-ui-minimal/references/typography-spacing.md +93 -0
  10. package/android-ui-minimal/scripts/contrast.py +68 -0
  11. package/android-ui-minimal/scripts/gen_tokens.py +165 -0
  12. package/android-ui-minimal/scripts/lint_ui.py +189 -0
  13. package/android-ui-security-review/SKILL.md +93 -0
  14. package/android-ui-security-review/references/checklist.md +95 -0
  15. package/android-ui-security-review/references/components-intents.md +74 -0
  16. package/android-ui-security-review/references/compose-risks.md +86 -0
  17. package/android-ui-security-review/references/input-and-state.md +77 -0
  18. package/android-ui-security-review/references/network-storage.md +87 -0
  19. package/android-ui-security-review/references/report-template.md +71 -0
  20. package/android-ui-security-review/references/sensitive-data-ui.md +73 -0
  21. package/android-ui-security-review/references/webview.md +105 -0
  22. package/android-ui-security-review/scripts/scan.py +411 -0
  23. package/bin/android-skills.js +47 -0
  24. package/install.py +337 -0
  25. package/opencode/commands/ui-minimal.md +9 -0
  26. package/opencode/commands/ui-security.md +9 -0
  27. package/package.json +43 -4
@@ -0,0 +1,95 @@
1
+ # Checklist keamanan UI Android
2
+
3
+ ID dipakai oleh `scripts/scan.py` dan laporan. Untuk setiap butir: risiko, cara memeriksa, perbaikan.
4
+
5
+ ## A. WebView
6
+
7
+ | ID | Risiko | Periksa | Perbaikan |
8
+ |---|---|---|---|
9
+ | W-JS | XSS menjadi eksekusi kode di app jika konten tak tepercaya | `javaScriptEnabled` | Aktifkan hanya untuk konten tepercaya |
10
+ | W-INTERFACE | Halaman web memanggil kode Kotlin | `addJavascriptInterface` | Metode minimal, hanya konten lokal, atau WebMessageListener dengan origin terbatas |
11
+ | W-FILE / W-FILE2 | Baca file lokal dari halaman jahat | `allowFileAccess*`, `allowUniversalAccessFromFileURLs` | Matikan, pakai `WebViewAssetLoader` |
12
+ | W-MIXED | Konten http disuntik ke halaman https | `MIXED_CONTENT_ALWAYS_ALLOW` | `NEVER_ALLOW` |
13
+ | W-SSL | MITM | `onReceivedSslError` + `proceed()` | `cancel()` |
14
+ | W-DEBUG | Inspeksi WebView di release | `setWebContentsDebuggingEnabled(true)` | Hanya debug |
15
+ | W-LOADURL-HTTP / W-LOADURL-DYN | Memuat URL http atau URL tak tepercaya | `loadUrl("http://...")`, `loadUrl(variabel)` | HTTPS, allowlist skema dan host |
16
+ | W-LOADDATA | HTML disisipi data tak tepercaya | `loadData*` dengan interpolasi | Escape atau jangan rakit HTML |
17
+ | W-CONTENT | Akses content provider dari WebView | `allowContentAccess` | Matikan bila tidak perlu |
18
+ | W-EVALJS | Injeksi skrip | `evaluateJavascript` dengan string rakitan | JSON ter-escape, `postWebMessage` |
19
+
20
+ ## B. Komponen dan intent
21
+
22
+ | ID | Risiko | Periksa | Perbaikan |
23
+ |---|---|---|---|
24
+ | M-EXPORT-IMPLICIT | Komponen terbuka tak sengaja | intent-filter tanpa `exported` | Set eksplisit |
25
+ | M-EXPORT | Aplikasi lain memicu komponen | `exported="true"` | Permission signature atau false |
26
+ | M-PROVIDER / M-GRANT | Kebocoran data | provider exported, grantUriPermissions | Batasi path dan izin |
27
+ | M-APPLINK | Pembajakan link | https tanpa `autoVerify` | App Links terverifikasi |
28
+ | M-DEEPLINK | Input tak tepercaya | intent-filter BROWSABLE | Validasi parameter |
29
+ | C-REDIRECT | Intent redirection | Meluncurkan Intent dari extra | Validasi tujuan, hapus flag URI |
30
+ | C-PENDING | Intent dimodifikasi pihak lain | PendingIntent tanpa flag | `FLAG_IMMUTABLE`, Intent eksplisit |
31
+ | C-RECEIVER | Receiver terekspos | `registerReceiver` | `RECEIVER_NOT_EXPORTED` |
32
+ | C-BROADCAST | Data bocor lewat broadcast | `sendBroadcast` | `setPackage`, permission |
33
+ | C-IMPLICIT | Membuka URI sembarang | `ACTION_VIEW` + Uri dinamis | Validasi skema dan host |
34
+ | C-FILEPROVIDER | Berbagi file berlebih | path root di XML provider | Subfolder spesifik |
35
+ | M-PERM | Permukaan serangan | Izin berisiko | Hapus atau ganti API aman |
36
+
37
+ ## C. Data sensitif di UI
38
+
39
+ | ID | Risiko | Periksa | Perbaikan |
40
+ |---|---|---|---|
41
+ | U-SECURE | Screenshot dan pratinjau recents bocor | Tidak ada `FLAG_SECURE` di layar sensitif | Set flag per layar |
42
+ | U-TAPJACK | Overlay menipu pengguna | Tombol sensitif tanpa filter touch | `filterTouchesWhenObscured` |
43
+ | U-LOG | Data bocor lewat logcat | Log berisi token, password | Hapus log, strip di release |
44
+ | U-STACKTRACE | Info internal bocor | `printStackTrace`, Toast exception | Pesan generik |
45
+ | U-CLIPBOARD | Aplikasi lain membaca clipboard | `setPrimaryClip` data rahasia | Hindari, tandai sensitif |
46
+ | U-SAVEABLE | Rahasia di Bundle | `rememberSaveable` + password | `remember` |
47
+ | U-AUTOFILL | Autofill mengirim data ke layanan pihak ketiga | `importantForAutofill="yes"` | Cek manual field sensitif |
48
+ | U-PWFIELD / U-INPUTTYPE | Password terlihat atau di-cache keyboard | TextField tanpa transformasi | Transformasi + tipe keyboard |
49
+
50
+ ## D. Input dan state
51
+
52
+ | ID | Risiko | Periksa | Perbaikan |
53
+ |---|---|---|---|
54
+ | I-SQL | SQL injection | `rawQuery` rakitan string | Parameter binding |
55
+ | I-PATH | Path traversal | `File(...)` dari input | canonicalPath + allowlist |
56
+ | I-DEEPLINK | Parameter tak tepercaya | `getQueryParameter` | Validasi |
57
+ | I-HTML | Render HTML tak tepercaya | `Html.fromHtml` | Sumber tepercaya |
58
+ | I-RANDOM | Token tebakan | `Random` | `SecureRandom` |
59
+ | I-HASH / I-CIPHER | Kripto lemah | MD5, SHA-1, ECB | SHA-256, AES-GCM |
60
+
61
+ ## E. Jaringan dan penyimpanan
62
+
63
+ | ID | Risiko | Periksa | Perbaikan |
64
+ |---|---|---|---|
65
+ | N-HTTP | Cleartext | URL `http://` | HTTPS |
66
+ | M-CLEARTEXT / N-NSC-CLEAR | Cleartext global | Manifest, NSC | Matikan |
67
+ | N-NSC-USER | CA pengguna dipercaya | `src="user"` | Hanya debug |
68
+ | N-TRUSTALL / N-HOSTNAME | MITM total | TrustManager dan HostnameVerifier kustom | Hapus |
69
+ | N-PINNING | Pemalsuan sertifikat | OkHttp tanpa pinning | Pertimbangkan pinning |
70
+ | S-PREFS | Rahasia terbaca | SharedPreferences biasa | Enkripsi Keystore |
71
+ | S-WORLD | File dibaca aplikasi lain | `MODE_WORLD_*` | `MODE_PRIVATE` |
72
+ | S-EXTERNAL | Data di penyimpanan bersama | External storage | Penyimpanan privat |
73
+ | M-BACKUP | Data ikut backup | `allowBackup` | Matikan atau kecualikan |
74
+ | M-DEBUGGABLE | Debugging di produksi | `debuggable` | Hapus |
75
+
76
+ ## F. Secret
77
+
78
+ | ID | Periksa |
79
+ |---|---|
80
+ | S-SECRET | Nilai literal pada variabel bernama key, token, secret |
81
+ | S-PRIVKEY | Header kunci privat |
82
+ | S-AWS, S-TOKENFMT, S-GOOGLEKEY | Format token yang dikenal |
83
+
84
+ Aturan: apa pun yang dikirim ke klien dianggap publik. Secret sungguhan hidup di server.
85
+
86
+ ## Pemeriksaan manual yang tidak bisa diotomatisasi
87
+
88
+ 1. Apakah layar sensitif hanya bisa diakses setelah autentikasi? Apa yang terjadi saat proses dimatikan lalu dibuka lewat deep link?
89
+ 2. Apakah logout membersihkan state, cache gambar, WebView cookies, dan clipboard?
90
+ 3. Apakah aksi sensitif (transfer, hapus akun) meminta autentikasi ulang atau BiometricPrompt dengan CryptoObject?
91
+ 4. Apakah pesan error membocorkan perbedaan "pengguna tidak ada" dan "password salah"?
92
+ 5. Apakah ada logika keamanan yang hanya dilakukan di klien (cek harga, cek peran)? Itu harus diulang di server.
93
+ 6. Apakah gambar atau URL dari server dimuat tanpa batas ukuran atau skema?
94
+ 7. Apakah library pihak ketiga (WebView wrapper, SDK iklan) menambah izin atau komponen exported lewat manifest merge? Periksa manifest hasil merge (`app/build/intermediates/merged_manifests`).
95
+ 8. Apakah ProGuard atau R8 aktif untuk release dan tidak membocorkan nama sensitif?
@@ -0,0 +1,74 @@
1
+ # Komponen, intent, deep link
2
+
3
+ ## Exported
4
+
5
+ Sejak target SDK 31, komponen dengan `intent-filter` wajib punya `android:exported` eksplisit. Aturan:
6
+ - Default `false`. Ubah ke `true` hanya jika aplikasi lain memang harus memanggilnya.
7
+ - Activity launcher harus exported. Activity lain biasanya tidak.
8
+ - Service, receiver, provider exported wajib dilindungi `android:permission` (signature) kecuali sengaja publik.
9
+ - Periksa manifest hasil merge, karena library bisa menambah komponen exported.
10
+
11
+ ## Activity yang menerima data dari luar
12
+
13
+ Perlakukan `intent.extras`, `intent.data`, dan `intent.action` sebagai input tak tepercaya.
14
+
15
+ ```kotlin
16
+ val id = intent.getStringExtra("id")?.takeIf { it.matches(Regex("[A-Za-z0-9_-]{1,64}")) }
17
+ ?: return finish()
18
+ ```
19
+
20
+ Jangan:
21
+ - Meneruskan extra langsung ke query, path file, URL WebView, atau `startActivity`.
22
+ - Mengasumsikan tipe extra benar. Gunakan versi API bertipe (`getParcelableExtra(key, Clazz::class.java)`) dan tangani null.
23
+ - Mempercayai `callingPackage` sebagai autentikasi.
24
+
25
+ ## Intent redirection
26
+
27
+ Pola rawan:
28
+
29
+ ```kotlin
30
+ val forward = intent.getParcelableExtra<Intent>("next")
31
+ startActivity(forward) // penyerang memilih tujuan, termasuk komponen privat
32
+ ```
33
+
34
+ Perbaikan: jangan terima Intent di extra. Jika tak bisa dihindari, resolve dan batasi tujuan ke allowlist komponen, hapus `FLAG_GRANT_*_URI_PERMISSION`, dan jangan jalankan dengan hak lebih tinggi.
35
+
36
+ ## Deep link
37
+
38
+ - Validasi skema, host, path, dan setiap parameter.
39
+ - Gunakan App Links terverifikasi (`autoVerify="true"`, `assetlinks.json`) untuk https.
40
+ - Skema kustom bisa dibajak aplikasi lain. Jangan kirim token lewat skema kustom.
41
+ - Jangan langsung melewati autentikasi karena datang dari deep link. Cek sesi sebelum menampilkan layar sensitif.
42
+ - Hati-hati parameter `redirect`, `url`, `next`. Allowlist tujuan untuk mencegah open redirect.
43
+ - Argumen Navigation Compose dari deep link tetap input tak tepercaya.
44
+
45
+ ## PendingIntent
46
+
47
+ - Selalu set `FLAG_IMMUTABLE` kecuali memang butuh diisi ulang (`FLAG_MUTABLE`).
48
+ - Intent di dalamnya eksplisit (komponen atau package ditentukan). Jangan Intent kosong.
49
+ - Untuk notifikasi, jangan sisipkan data sensitif di extra.
50
+
51
+ ## Broadcast
52
+
53
+ - `registerReceiver` pada Android 13+ butuh `RECEIVER_NOT_EXPORTED` untuk broadcast internal.
54
+ - `sendBroadcast` dengan data sensitif: batasi ke paket sendiri (`setPackage`) atau gunakan izin.
55
+ - Pertimbangkan alternatif dalam proses (Flow, SharedFlow) daripada broadcast.
56
+
57
+ ## FileProvider dan berbagi file
58
+
59
+ - Definisikan path sesempit mungkin, jangan `root-path` atau `.`
60
+ - Gunakan `FileProvider.getUriForFile`, bukan `Uri.fromFile`.
61
+ - Beri `FLAG_GRANT_READ_URI_PERMISSION` hanya ke penerima spesifik dan pada Intent yang dikirim, bukan membuat provider exported.
62
+ - Validasi nama file dari pengguna (hapus `..`, pemisah path) sebelum menulis.
63
+
64
+ ## Share dan menerima konten
65
+
66
+ - Aktivitas `ACTION_SEND` menerima teks atau Uri dari aplikasi mana pun. Validasi ukuran, tipe MIME, dan skema Uri (`content` saja, bukan `file`).
67
+ - Salin ke penyimpanan privat sebelum diproses. Jangan membuka `content://` dengan path dari input.
68
+
69
+ ## Tapjacking
70
+
71
+ Layar yang memicu aksi sensitif dengan satu ketukan bisa ditumpuk overlay.
72
+ - View: `filterTouchesWhenObscured = true`.
73
+ - Compose: baca `LocalView.current` dan atur properti yang sama pada view root, atau periksa `MotionEvent.FLAG_WINDOW_IS_OBSCURED` dan tolak aksi.
74
+ - Untuk konfirmasi penting, tambah langkah eksplisit (dialog dengan teks jelas).
@@ -0,0 +1,86 @@
1
+ # Risiko khusus Jetpack Compose
2
+
3
+ ## State yang bertahan
4
+
5
+ - `rememberSaveable` menyimpan nilai ke Bundle (bisa dipulihkan setelah process death, bisa terlihat di tool debug). Jangan pakai untuk password, PIN, token.
6
+ - `SavedStateHandle` di ViewModel sama risikonya.
7
+ - Gunakan `remember` untuk rahasia dan hapus saat layar keluar komposisi (`DisposableEffect`).
8
+
9
+ ```kotlin
10
+ var pin by remember { mutableStateOf("") }
11
+ DisposableEffect(Unit) { onDispose { pin = "" } }
12
+ ```
13
+
14
+ String di JVM tidak bisa dihapus dari memori dengan pasti. Jangan klaim "dihapus aman", hanya kurangi umur referensi.
15
+
16
+ ## Text field
17
+
18
+ ```kotlin
19
+ OutlinedTextField(
20
+ value = password,
21
+ onValueChange = { password = it },
22
+ visualTransformation = if (visible) VisualTransformation.None else PasswordVisualTransformation(),
23
+ keyboardOptions = KeyboardOptions(
24
+ keyboardType = KeyboardType.Password,
25
+ autoCorrectEnabled = false,
26
+ imeAction = ImeAction.Done,
27
+ ),
28
+ singleLine = true,
29
+ )
30
+ ```
31
+
32
+ - Tombol tampilkan password bersifat sementara. Sembunyikan lagi saat layar kehilangan fokus atau aplikasi ke background.
33
+ - Gunakan `Modifier.semantics { password() }` agar layanan aksesibilitas dan autofill memperlakukannya sebagai password.
34
+ - Batasi panjang input (`onValueChange = { if (it.length <= 64) ... }`).
35
+
36
+ ## Semantics dan aksesibilitas
37
+
38
+ - `contentDescription` dan `stateDescription` terbaca oleh layanan aksesibilitas. Jangan taruh data rahasia di sana.
39
+ - Untuk konten yang tidak boleh dibaca layanan aksesibilitas, gunakan `Modifier.clearAndSetSemantics { }` atau `invisibleToUser()` secara hati-hati, dengan tetap menyediakan alternatif bagi pengguna yang butuh.
40
+ - Layanan aksesibilitas berbahaya bisa membaca layar. Untuk layar paling sensitif, pertimbangkan FLAG_SECURE dan pemeriksaan layanan aksesibilitas aktif.
41
+
42
+ ## AndroidView dan interop
43
+
44
+ - `AndroidView { WebView(it) }` mewarisi semua risiko WebView (lihat `webview.md`).
45
+ - Lepaskan resource di `onRelease`. Jangan menyimpan Context Activity di objek berumur panjang.
46
+
47
+ ## Navigasi
48
+
49
+ - Argumen route adalah string di back stack dan deep link. Jangan kirim objek sensitif sebagai argumen. Kirim ID, ambil data dari repository.
50
+ - `navDeepLink` mengekspos route ke luar. Cek autentikasi di tujuan, bukan hanya di layar awal.
51
+ - Pastikan `popUpTo` setelah login/logout membersihkan back stack agar pengguna tidak kembali ke layar sensitif.
52
+
53
+ ## Preview dan data contoh
54
+
55
+ - Jangan taruh data nyata, token, atau URL internal di `@Preview` atau data contoh. Itu ikut ke repo.
56
+ - Kode preview ikut APK jika tidak dibungkus debug source set. Pakai `debugImplementation` untuk tooling preview.
57
+
58
+ ## Layar sensitif
59
+
60
+ - Pasang FLAG_SECURE di Activity host. Compose single-activity berarti flag berlaku ke semua layar. Atur dinamis per rute:
61
+
62
+ ```kotlin
63
+ @Composable
64
+ fun SecureScreen(content: @Composable () -> Unit) {
65
+ val window = (LocalContext.current as Activity).window
66
+ DisposableEffect(Unit) {
67
+ window.addFlags(WindowManager.LayoutParams.FLAG_SECURE)
68
+ onDispose { window.clearFlags(WindowManager.LayoutParams.FLAG_SECURE) }
69
+ }
70
+ content()
71
+ }
72
+ ```
73
+
74
+ ## Dialog dan overlay
75
+
76
+ - Dialog Compose membuat window sendiri. `DialogProperties(securePolicy = SecureFlagPolicy.SecureOn)` memasang FLAG_SECURE untuk dialog sensitif.
77
+ - Pemicu aksi destruktif atau finansial di dialog tetap rentan tapjacking. Lihat `components-intents.md`.
78
+
79
+ ## Efek samping
80
+
81
+ - `LaunchedEffect` yang mengirim data ke jaringan berdasarkan input pengguna bisa terpicu berulang saat rekomposisi atau perubahan konfigurasi. Pastikan kunci efek benar agar aksi sensitif tidak terkirim ganda.
82
+
83
+ ## Library UI pihak ketiga
84
+
85
+ - Tinjau izin dan komponen yang ditambahkan lewat manifest merge.
86
+ - Pertimbangkan versi yang dikunci dan pembaruan keamanan. Hindari library yang tidak dipelihara untuk tugas sensitif (WebView wrapper, scanner QR, input kartu).
@@ -0,0 +1,77 @@
1
+ # Input dan state dari luar
2
+
3
+ Setiap nilai yang tidak dibuat langsung oleh kode kamu adalah tak tepercaya: input pengguna, extra intent, deep link, respons jaringan, isi file, clipboard, hasil `ContentResolver`, argumen navigasi, isi QR.
4
+
5
+ ## Validasi
6
+
7
+ - Validasi di batas masuk (ViewModel atau use case), bukan tersebar di composable.
8
+ - Gunakan allowlist, bukan blocklist: panjang, karakter, rentang, enum.
9
+ - Parse ke tipe kuat sedini mungkin (`UUID`, `Int`, `enum`), tangani kegagalan.
10
+ - Validasi di klien hanya untuk pengalaman pengguna. Server tetap memvalidasi ulang.
11
+
12
+ ```kotlin
13
+ fun parseAmount(raw: String): Long? =
14
+ raw.takeIf { it.length <= 12 && it.all(Char::isDigit) }?.toLongOrNull()
15
+ ?.takeIf { it in 1..100_000_000 }
16
+ ```
17
+
18
+ ## Injeksi
19
+
20
+ | Konteks | Risiko | Cegah |
21
+ |---|---|---|
22
+ | SQLite | SQL injection | Parameter binding, Room |
23
+ | WebView | XSS, JS injection | Jangan rakit HTML/JS, JSON ter-escape |
24
+ | Intent / URI | Redirection, open redirect | Allowlist skema dan host |
25
+ | File | Path traversal | `canonicalPath` + direktori dasar |
26
+ | Regex | ReDoS | Hindari pola berulang bersarang pada input pengguna, batasi panjang |
27
+ | Format string | Kebocoran | Jangan pakai input pengguna sebagai format |
28
+
29
+ Path traversal:
30
+
31
+ ```kotlin
32
+ val base = File(context.filesDir, "uploads").canonicalFile
33
+ val target = File(base, name).canonicalFile
34
+ require(target.path.startsWith(base.path + File.separator)) { "path tidak valid" }
35
+ ```
36
+
37
+ ## Deep link dan argumen navigasi
38
+
39
+ ```kotlin
40
+ composable("detail/{id}") { entry ->
41
+ val id = entry.arguments?.getString("id")?.toLongOrNull() ?: return@composable
42
+ // cek otorisasi: apakah pengguna ini boleh melihat id ini?
43
+ }
44
+ ```
45
+
46
+ ID di URL bukan otorisasi. Periksa hak akses di server (IDOR).
47
+
48
+ ## QR dan konten dari kamera
49
+
50
+ - Perlakukan sebagai URL tak tepercaya. Tampilkan tujuan ke pengguna sebelum membuka.
51
+ - Batasi skema (`https`). Jangan membuka `intent://` atau `javascript:`.
52
+
53
+ ## Respons jaringan
54
+
55
+ - Gunakan model data bertipe, abaikan field tak dikenal, tangani field hilang.
56
+ - Batasi ukuran respons dan jumlah item yang dirender.
57
+ - Jangan merender HTML dari respons kecuali lewat sanitasi.
58
+ - URL gambar dari server: izinkan hanya https, batasi ukuran decode (`size(...)` di Coil).
59
+
60
+ ## Teks tampilan
61
+
62
+ - Teks pengguna yang ditampilkan di `Text` aman dari injeksi HTML. Risiko muncul saat memakai `Html.fromHtml`, `AnnotatedString` dari markup, atau WebView.
63
+ - Batasi panjang teks dan baris (`maxLines`, `overflow`) agar tampilan tidak dirusak.
64
+ - Waspadai karakter kontrol arah (bidi) pada nama file atau nama pengguna yang tampil di UI konfirmasi.
65
+
66
+ ## Race dan state
67
+
68
+ - Cegah double submit pada aksi sensitif: nonaktifkan tombol saat proses, gunakan idempotency key ke server.
69
+ - Jangan memutuskan keamanan dari state UI (`isAdmin` di ViewModel). Server yang menentukan.
70
+ - Setelah proses dimatikan, state UI bisa dipulihkan dengan nilai usang. Verifikasi ulang sesi sebelum aksi sensitif.
71
+
72
+ ## Validasi di sisi klien yang sering salah
73
+
74
+ - Menyembunyikan tombol bukan kontrol akses.
75
+ - Obfuskasi (R8) bukan enkripsi.
76
+ - Root atau emulator detection bukan batas keamanan.
77
+ - Pembatasan percobaan PIN hanya di klien bisa dilewati.
@@ -0,0 +1,87 @@
1
+ # Jaringan dan penyimpanan (sudut pandang UI)
2
+
3
+ ## Cleartext
4
+
5
+ - Manifest: jangan set `usesCleartextTraffic="true"`.
6
+ - Target SDK 28+ sudah memblokir cleartext secara default. Pengecualian harus lewat `network_security_config` dan sempit.
7
+ - Semua URL API, gambar, dan WebView memakai `https://`.
8
+
9
+ ## network_security_config
10
+
11
+ Contoh aman untuk release:
12
+
13
+ ```xml
14
+ <network-security-config>
15
+ <base-config cleartextTrafficPermitted="false">
16
+ <trust-anchors>
17
+ <certificates src="system" />
18
+ </trust-anchors>
19
+ </base-config>
20
+ <debug-overrides>
21
+ <trust-anchors>
22
+ <certificates src="user" />
23
+ </trust-anchors>
24
+ </debug-overrides>
25
+ </network-security-config>
26
+ ```
27
+
28
+ Jangan percaya CA pengguna (`src="user"`) di release.
29
+
30
+ ## Certificate pinning
31
+
32
+ Untuk aplikasi berisiko tinggi (keuangan, kesehatan), pinning mengurangi risiko CA palsu. Tapi:
33
+ - Pin ke public key (SPKI), sertakan minimal satu cadangan.
34
+ - Siapkan rencana rotasi dan kedaluwarsa pin. Pin yang salah membuat aplikasi tidak bisa terhubung.
35
+ - Pinning bukan pengganti validasi server.
36
+
37
+ ```kotlin
38
+ val pinner = CertificatePinner.Builder()
39
+ .add("api.contoh.com", "sha256/AAAA...=", "sha256/BBBB...=")
40
+ .build()
41
+ ```
42
+
43
+ ## TrustManager dan HostnameVerifier kustom
44
+
45
+ Jangan pernah mengimplementasi yang menerima semua sertifikat atau semua host, termasuk "sementara untuk dev". Untuk server dev dengan sertifikat sendiri, daftarkan CA dev di `debug-overrides`.
46
+
47
+ ## Penyimpanan
48
+
49
+ | Jenis data | Tempat |
50
+ |---|---|
51
+ | Token sesi | Penyimpanan privat terenkripsi dengan kunci Android Keystore |
52
+ | Preferensi non-sensitif | DataStore atau SharedPreferences |
53
+ | Cache gambar | Cache privat, bersihkan saat logout |
54
+ | Berkas pengguna | `filesDir` (privat) atau SAF/MediaStore atas pilihan pengguna |
55
+
56
+ Catatan: `EncryptedSharedPreferences` dari `androidx.security:security-crypto` sudah ditandai deprecated pada rilis terbaru. Cek versi yang kamu pakai dan pertimbangkan Keystore langsung atau Tink dengan DataStore terenkripsi.
57
+
58
+ Aturan:
59
+ - Simpan seminimal mungkin. Token berumur pendek + refresh token yang bisa dicabut.
60
+ - Kunci enkripsi tidak pernah di source atau di aset.
61
+ - Gunakan `setUserAuthenticationRequired(true)` untuk kunci yang melindungi data paling sensitif.
62
+ - Jangan simpan password. Simpan token.
63
+
64
+ ## Backup
65
+
66
+ - `android:allowBackup="false"`, atau definisikan `dataExtractionRules` (Android 12+) dan `fullBackupContent` yang mengecualikan database, token, dan preferensi sensitif.
67
+
68
+ ## Berkas dan penyimpanan bersama
69
+
70
+ - Hindari menulis data sensitif ke penyimpanan eksternal atau MediaStore.
71
+ - Hapus berkas sementara setelah dipakai.
72
+ - Hati-hati nama berkas dari server atau pengguna.
73
+
74
+ ## Secret di aplikasi
75
+
76
+ - Semua yang ada di APK bisa diekstrak: string, resource, BuildConfig, aset, native library.
77
+ - API key yang memang harus di klien (maps, analytics) wajib dibatasi di sisi penyedia (package name + SHA-1, daftar API, kuota).
78
+ - Secret yang memberi akses penuh (kunci server, kunci layanan cloud) tidak boleh di klien. Pindahkan ke backend atau proxy.
79
+ - Jika sudah terlanjur dikomit: cabut dan rotasi dulu, baru bersihkan histori git.
80
+ - Untuk aplikasi BYOK (pengguna memasukkan API key sendiri): simpan terenkripsi Keystore, jangan log, jangan masukkan ke crash report, jangan kirim ke pihak selain penyedia yang dituju, mask saat tampil.
81
+
82
+ ## Rilis
83
+
84
+ - Aktifkan R8 (`isMinifyEnabled = true`) dan `isShrinkResources` untuk release.
85
+ - Tanda tangani dengan kunci yang disimpan aman, bukan di repo.
86
+ - Pastikan `debuggable` false, logging dimatikan, WebView debugging mati.
87
+ - Gunakan Play Integrity API bila perlu, dengan verifikasi di server.
@@ -0,0 +1,71 @@
1
+ # Template laporan
2
+
3
+ Gunakan format ini. Singkat, spesifik, dapat ditindaklanjuti. Tanpa emoji.
4
+
5
+ ```
6
+ # Laporan review keamanan UI: <nama aplikasi>
7
+
8
+ Tanggal: <tanggal>
9
+ Ruang lingkup: <modul, variant, targetSdk>
10
+ Metode: pemindaian otomatis (scan.py) + tinjauan manual terhadap <area>
11
+ Tidak diperiksa: <backend, native code, SDK pihak ketiga, dll>
12
+
13
+ ## Ringkasan
14
+ <2-4 kalimat: jumlah temuan per tingkat, hal paling mendesak>
15
+
16
+ | Tingkat | Jumlah | Terkonfirmasi | False positive |
17
+ |---|---|---|---|
18
+
19
+ ## Temuan
20
+
21
+ ### [HIGH] W-INTERFACE: addJavascriptInterface pada WebView yang memuat URL eksternal
22
+ - Lokasi: app/src/main/java/.../HelpScreen.kt:84
23
+ - Status: terkonfirmasi | mungkin | false positive
24
+ - Dampak: halaman yang dikompromikan bisa memanggil metode `bridge.*` dan membaca <apa>
25
+ - Skenario: <langkah minimal, konseptual, pada aplikasi milik sendiri>
26
+ - Perbaikan: <perubahan konkret + contoh kode pendek>
27
+ - Catatan: <efek samping, versi API>
28
+
29
+ (ulangi per temuan, urutkan critical ke info)
30
+
31
+ ## Hal yang sudah baik
32
+ <singkat, berdasarkan bukti: misalnya "semua komponen exported punya permission">
33
+
34
+ ## Rekomendasi lanjutan
35
+ <hal di luar ruang lingkup: pentest, review backend, dependensi>
36
+ ```
37
+
38
+ ## Menilai tingkat keparahan
39
+
40
+ Nilai dengan dua pertanyaan:
41
+
42
+ 1. **Kemudahan eksploitasi**
43
+ - Mudah: aplikasi lain di perangkat atau halaman web bisa memicunya tanpa interaksi khusus
44
+ - Sedang: butuh interaksi pengguna atau kondisi tertentu
45
+ - Sulit: butuh akses fisik, root, atau rantai beberapa kelemahan
46
+ 2. **Dampak**
47
+ - Tinggi: kebocoran kredensial, eksekusi kode, pengambilalihan akun, kehilangan dana
48
+ - Sedang: kebocoran data terbatas, bypass fitur
49
+ - Rendah: informasi teknis, hardening
50
+
51
+ | Dampak \ Kemudahan | Mudah | Sedang | Sulit |
52
+ |---|---|---|---|
53
+ | Tinggi | critical | high | medium |
54
+ | Sedang | high | medium | low |
55
+ | Rendah | medium | low | info |
56
+
57
+ Penyesuaian:
58
+ - Hanya di source set debug: turunkan satu tingkat dan catat apakah bisa bocor ke release.
59
+ - Aplikasi memproses data keuangan, kesehatan, atau identitas: naikkan satu tingkat untuk kebocoran data.
60
+ - Aplikasi tanpa data pengguna dan tanpa akun: turunkan satu tingkat untuk hardening.
61
+ - Keyakinan rendah (false positive mungkin): tetap laporkan sebagai "mungkin" dan jelaskan apa yang perlu dicek.
62
+
63
+ ## Menangani secret
64
+
65
+ Jika menemukan secret, di laporan tulis hanya empat karakter awal dan jenisnya ("AIza****", API key Google). Rekomendasikan rotasi sebelum perbaikan lain.
66
+
67
+ ## Setelah perbaikan
68
+
69
+ - Jalankan ulang `scan.py` dan bandingkan jumlah temuan.
70
+ - Jalankan build release dan uji alur yang disentuh.
71
+ - Catat temuan yang sengaja ditekan dengan `sec-ignore` beserta alasannya.
@@ -0,0 +1,73 @@
1
+ # Data sensitif di lapisan UI
2
+
3
+ Data sensitif: password, PIN, OTP, token, nomor kartu, data kesehatan, identitas, pesan pribadi.
4
+
5
+ ## Screenshot dan layar recents
6
+
7
+ ```kotlin
8
+ window.setFlags(WindowManager.LayoutParams.FLAG_SECURE, WindowManager.LayoutParams.FLAG_SECURE)
9
+ ```
10
+
11
+ - Pasang di layar login, OTP, PIN, pembayaran, dan layar yang menampilkan data pribadi.
12
+ - Pasang di `onCreate` sebelum `setContent`. Lepas di layar yang tidak sensitif jika flag dipasang di Activity bersama.
13
+ - FLAG_SECURE juga menyembunyikan konten dari pratinjau recents dan perekaman layar.
14
+ - Pada Android 13+, `setRecentsScreenshotEnabled(false)` menyembunyikan pratinjau recents tanpa memblokir screenshot.
15
+
16
+ ## Clipboard
17
+
18
+ - Jangan menyalin password, token, OTP otomatis.
19
+ - Jika ada tombol "salin" untuk data sensitif:
20
+ ```kotlin
21
+ val clip = ClipData.newPlainText("kode", value).apply {
22
+ description.extras = PersistableBundle().apply {
23
+ putBoolean("android.content.extra.IS_SENSITIVE", true)
24
+ }
25
+ }
26
+ ```
27
+ Dan hapus clipboard setelah jeda singkat.
28
+ - Jangan membaca clipboard tanpa tindakan pengguna.
29
+
30
+ ## Field input
31
+
32
+ - Password: `PasswordVisualTransformation`, `KeyboardType.Password`, `autoCorrect = false`.
33
+ - OTP dan PIN: `KeyboardType.NumberPassword`.
34
+ - Nonaktifkan saran keyboard untuk field rahasia (`autoCorrectEnabled = false`).
35
+ - XML: `android:inputType="textPassword"`, `android:importantForAutofill` sesuai kebutuhan.
36
+ - Autofill: izinkan untuk password manager sah, tapi nonaktifkan untuk field sekali-pakai yang tidak perlu (`importantForAutofill="no"`).
37
+
38
+ ## State dan proses
39
+
40
+ - Jangan simpan rahasia di `rememberSaveable`, `SavedStateHandle`, atau `onSaveInstanceState`. Bundle dapat bertahan dan terbaca di tempat lain.
41
+ - Hapus state sensitif dari ViewModel saat logout dan saat layar ditutup.
42
+ - `Parcelable` berisi token yang dikirim antar Activity bisa terlihat di log atau dump. Kirim ID, bukan nilai rahasia.
43
+
44
+ ## Log
45
+
46
+ - Jangan log token, password, OTP, atau seluruh body respons.
47
+ - Gunakan logger yang tidak berbuat apa-apa di release (pohon Timber hanya ditanam di debug).
48
+ - Hapus `println` dan `Log.*` dari jalur autentikasi.
49
+ - R8 dapat menghapus `Log.d/v` dengan aturan `-assumenosideeffects`, tetapi jangan jadikan itu satu-satunya pertahanan.
50
+
51
+ ## Notifikasi
52
+
53
+ - Jangan tampilkan konten sensitif di lock screen: `setVisibility(NotificationCompat.VISIBILITY_PRIVATE)` dengan `setPublicVersion`.
54
+ - Jangan sisipkan token di extra PendingIntent notifikasi.
55
+
56
+ ## Kesalahan dan pesan
57
+
58
+ - Pesan error ke pengguna bersifat generik. Detail teknis hanya di log debug.
59
+ - Login: pesan sama untuk "akun tidak ada" dan "password salah".
60
+
61
+ ## Gambar dan tampilan
62
+
63
+ - Cache gambar (Coil, Glide) bisa menyimpan gambar sensitif di disk. Nonaktifkan cache disk untuk gambar dokumen identitas, atau bersihkan saat logout.
64
+ - Jangan menampilkan data sensitif utuh jika tidak perlu: nomor kartu dimasker, tampilkan 4 digit terakhir.
65
+
66
+ ## Biometrik
67
+
68
+ - Gunakan `BiometricPrompt` dengan `CryptoObject` untuk aksi yang melindungi kunci, bukan sekadar boolean "berhasil".
69
+ - Jangan menyimpan status "sudah autentikasi" di variabel yang bisa dimanipulasi di perangkat root tanpa verifikasi server.
70
+
71
+ ## Logout
72
+
73
+ Checklist pembersihan: token, ViewModel, cache disk dan memori, cookie WebView, `WebStorage`, clipboard, notifikasi, database lokal berisi data pengguna, preferensi.
@@ -0,0 +1,105 @@
1
+ # WebView aman
2
+
3
+ ## Prinsip
4
+
5
+ Anggap semua konten web tak tepercaya kecuali berasal dari aset aplikasi sendiri. Semakin banyak kemampuan yang diberikan ke WebView, semakin besar akibat satu XSS.
6
+
7
+ ## Konfigurasi dasar
8
+
9
+ ```kotlin
10
+ fun WebView.hardened() {
11
+ settings.apply {
12
+ javaScriptEnabled = false // aktifkan hanya bila perlu
13
+ allowFileAccess = false
14
+ allowContentAccess = false
15
+ allowFileAccessFromFileURLs = false
16
+ allowUniversalAccessFromFileURLs = false
17
+ mixedContentMode = WebSettings.MIXED_CONTENT_NEVER_ALLOW
18
+ setSupportMultipleWindows(false)
19
+ safeBrowsingEnabled = true
20
+ domStorageEnabled = false // aktifkan hanya bila perlu
21
+ javaScriptCanOpenWindowsAutomatically = false
22
+ }
23
+ }
24
+ ```
25
+
26
+ ## Muat konten lokal dengan WebViewAssetLoader
27
+
28
+ ```kotlin
29
+ val loader = WebViewAssetLoader.Builder()
30
+ .addPathHandler("/assets/", WebViewAssetLoader.AssetsPathHandler(context))
31
+ .build()
32
+
33
+ webView.webViewClient = object : WebViewClient() {
34
+ override fun shouldInterceptRequest(view: WebView, request: WebResourceRequest) =
35
+ loader.shouldInterceptRequest(request.url)
36
+ }
37
+ webView.loadUrl("https://appassets.androidplatform.net/assets/index.html")
38
+ ```
39
+
40
+ Hindari `file:///android_asset/` untuk konten yang memakai JavaScript.
41
+
42
+ ## Allowlist navigasi
43
+
44
+ ```kotlin
45
+ private val allowedHosts = setOf("example.com", "appassets.androidplatform.net")
46
+
47
+ override fun shouldOverrideUrlLoading(view: WebView, req: WebResourceRequest): Boolean {
48
+ val uri = req.url
49
+ val ok = uri.scheme == "https" && uri.host in allowedHosts
50
+ if (!ok) { /* buka di browser eksternal atau tolak */ }
51
+ return !ok
52
+ }
53
+ ```
54
+
55
+ Periksa host dengan pencocokan penuh. Jangan `host.endsWith("example.com")` karena `evilexample.com` lolos. Gunakan `host == d || host.endsWith(".$d")`.
56
+
57
+ ## Jembatan JS ke Kotlin
58
+
59
+ Pilihan lebih aman daripada `addJavascriptInterface`:
60
+
61
+ ```kotlin
62
+ if (WebViewFeature.isFeatureSupported(WebViewFeature.WEB_MESSAGE_LISTENER)) {
63
+ WebViewCompat.addWebMessageListener(
64
+ webView, "bridge", setOf("https://appassets.androidplatform.net"),
65
+ ) { _, message, origin, _, reply -> /* validasi message.data */ }
66
+ }
67
+ ```
68
+
69
+ Jika tetap memakai `addJavascriptInterface`:
70
+ - Hanya untuk konten lokal yang kamu kendalikan.
71
+ - Metode diberi `@JavascriptInterface`, jumlahnya minimal.
72
+ - Validasi semua argumen sebagai input tak tepercaya.
73
+ - Jangan ekspos kemampuan sensitif (file, kredensial, intent).
74
+
75
+ ## Error SSL
76
+
77
+ ```kotlin
78
+ override fun onReceivedSslError(v: WebView, h: SslErrorHandler, e: SslError) {
79
+ h.cancel() // jangan pernah proceed()
80
+ }
81
+ ```
82
+
83
+ ## Cookie dan penyimpanan
84
+
85
+ - Hapus cookie, cache, dan `WebStorage` saat logout.
86
+ - Jangan simpan token di `localStorage` WebView jika bisa dihindari.
87
+ - `CookieManager.setAcceptThirdPartyCookies(webView, false)`.
88
+
89
+ ## Unduhan dan izin
90
+
91
+ - Tangani `setDownloadListener` dengan validasi tipe dan sumber.
92
+ - Tolak `onPermissionRequest` (kamera, mikrofon) kecuali dari origin tepercaya.
93
+ - Tolak `onShowFileChooser` dari origin tak tepercaya.
94
+
95
+ ## Compose
96
+
97
+ `AndroidView` yang membungkus WebView mewarisi semua risiko di atas. Buat WebView di `factory`, lepaskan di `onRelease` (`destroy()`), dan jangan menyimpan referensi ke Activity.
98
+
99
+ ## Anti-pola
100
+
101
+ - `loadUrl(intent.data.toString())` tanpa validasi.
102
+ - `evaluateJavascript("setName('$name')")` dengan `name` dari pengguna.
103
+ - `setJavaScriptEnabled(true)` + `addJavascriptInterface` + memuat URL eksternal.
104
+ - Mengabaikan `onReceivedSslError` agar "tes jalan".
105
+ - Debugging WebView aktif di release.