Kumpulan Pola Pencarian

apkleaks tidak menanam satu pun pola sensitif di dalam kode Python. Seluruh aturan pencarian berada di dua berkas JSON di direktori config/, dan kelas APKLeaks hanya menyimpan path ke salah satunya di atribut self.pattern. Atribut itu menunjuk config/regexes.json bila argumen --pattern tidak diberikan (apkleaks/apkleaks.py:35¹).

graph TD
  RX["config/regexes.json<br/>53 kunci, 58 pola"] --> LOAD["json.load di scanning"]
  NK["config/notkeyhacks.json<br/>9 kunci, 10 pola"] -.->|"butuh -p eksplisit"| EXT
  LOAD --> SHAPE{"isinstance(pattern, list)"}
  SHAPE -->|"string"| S1["satu thread untuk satu pola"]
  SHAPE -->|"list"| S2["satu thread per elemen daftar"]
  S1 --> EXT["extract(name, matches)"]
  S2 --> EXT
  EXT --> OUT["out_json results: name + matches"]
  style RX fill:#336791,color:#fff
  style NK fill:#f59e0b,color:#000
  style SHAPE fill:#8b5cf6,color:#fff
  style S2 fill:#8b5cf6,color:#fff
  style LOAD fill:#8b5cf6,color:#fff
  style S1 fill:#2d7d46,color:#fff
  style EXT fill:#2d7d46,color:#fff
  style OUT fill:#2d7d46,color:#fff
%% fig: Bentuk data dua berkas pola dan percabangan scanning
%% desc: regexes.json dimuat lalu dicabangkan menurut tipe nilai, sedangkan notkeyhacks.json hanya terpakai bila path-nya dilewatkan lewat -p.

Dua berkas, dua peran

Kedua berkas memakai bentuk yang sama: satu objek JSON datar yang memetakan nama kunci ke sebuah pola. Isinya berbeda ruang lingkup, dan hanya satu di antaranya yang otomatis dipakai.

Angka pada tabel dihitung dari blok nilai di config/regexes.json:2-61² dan config/notkeyhacks.json:2-13³: 52 kunci bernilai string ditambah 6 pola Amazon_AWS_S3_Bucket, serta 8 kunci bernilai string ditambah 2 pola Adjust_Config.

String tunggal dan daftar string

Sebagian besar kunci bernilai satu string regex, seperti Amazon_AWS_Access_Key_ID yang mengejar prefiks AKIA, A3T, dan sejenisnya (config/regexes.json:2⁴). Sebagian kecil kunci bernilai daftar string, dan Amazon_AWS_S3_Bucket menunjukkan bentuk itu lewat enam varian host S3 (config/regexes.json:3-10⁵). Berkas Android memakai bentuk yang sama sekali untuk Adjust_Config, yang memuat pola AdjustConfig(...) dan setAppSecret (config/notkeyhacks.json:6-9⁶).

scanning membaca kedua bentuk dengan satu percabangan isinstance(pattern, list) (apkleaks/apkleaks.py:125-138⁷). Nilai string dijalankan sekali, nilai daftar dijalankan satu kali per elemen. Setiap eksekusi menjadi satu thread yang memanggil self.extract(name, util.finder(...)) dengan nama kunci yang sama, sehingga kunci berdaftar menyumbang beberapa entri {"name": ..., "matches": ...} bernama identik di out_json["results"] (apkleaks/apkleaks.py:114⁸).

Nama kunci menjadi judul hasil

extract mencetak nama kunci sebagai header [Name] sebelum daftar temuan (apkleaks/apkleaks.py:100-104⁹). Nama itu juga satu-satunya penanda khusus di seluruh alur: extract membandingkan name == "LinkFinder" untuk membuang temuan yang menunjuk pustaka Android dan memangkas kutip di ujung tiap hasil (apkleaks/apkleaks.py:106-109¹⁰).

⚠️ Mengganti nama kunci LinkFinder di berkas pola akan mematikan kedua penyaringan itu. Polanya tetap dijalankan, tetapi hasilnya tidak lagi dibersihkan dari path pustaka Android dan tanda kutipnya.

Kelompok pola di config/regexes.json

Kunci-kunci di berkas ini dikelompokkan menurut jenis rahasia, bukan menurut penyedia tunggal. Tabel berikut memetakan kelompok yang menonjol beserta contoh kuncinya.

config/notkeyhacks.json: pola pemanggilan Android

Sembilan kunci di berkas ini tidak mengejar bentuk token, melainkan pemanggilan API SDK Android. Escape \\( dan \\s? dipakai agar pola cocok dengan sintaks Java/Kotlin seperti AdjustConfig(...), AppCenter.configure(...), setAccessToken(...), dan withAppKey(...) (config/notkeyhacks.json:2-13³).

⚠️ Tidak ada kode yang membuka config/notkeyhacks.json. self.pattern hanya diisi default config/regexes.json (apkleaks/apkleaks.py:35¹), dan scanning hanya membuka berkas yang ditunjuk self.pattern (apkleaks/apkleaks.py:123-124¹⁹). Untuk memakai pola Android ini, lewatkan path-nya secara eksplisit, misalnya apkleaks -f app.apk -p config/notkeyhacks.json. Opsi -p menerima satu path berkas saja (apkleaks/cli.py:26²⁰), jadi regexes.json dan notkeyhacks.json tidak bisa dipakai bersamaan dalam satu pemindaian tanpa digabung lebih dulu.

Pola dijalankan per baris

util.finder mengompilasi pola lalu memanggil matcher.search(line) untuk setiap baris berkas hasil decompile. Temuan dikumpulkan lewat mo.group() dan dikembalikan sebagai sorted(list(set(found))) (apkleaks/utils.py:17-31²¹). Karena search bekerja per baris dan group() mengembalikan bagian yang cocok saja, pola yang membutuhkan konteks lintas baris tidak akan pernah cocok, dan hasil yang tersimpan adalah potongan baris, bukan baris utuh.

Untuk menambah atau mengganti kumpulan pola, lihat Kustomisasi Pola Sendiri. Mekanisme pemindaian dan pewarnaan keluaran dibahas di Mesin Pencarian Regex dan Keluaran Warna.