·12 okuma·Yazar: aegisSoft

Tersine Mühendislik Araç Seti: Kapsamlı Kurulum ve Kullanım Rehberi

aegisSoft tersine mühendislik çalışma alanında kullanılan araçların tamamı: ne işe yaradıkları, nasıl kuruldukları, nasıl ayarlandıkları ve günlük operasyon akışları. AGENTS.md ve PROMPTS.md şablonlarıyla birlikte.

#reverse-engineering#security#tooling#android#windows#network
Kurulum Promptu

İki dil birbirinin aynısıdır (senkron). Promptu kopyalayıp yapay zekâ ajanına verin; blogda anlatılan tüm araçları, resmi linkleri ve kurulumları eksiksiz kursun.

Tersine Mühendislik Araç Seti: Kapsamlı Kurulum ve Kullanım Rehberi

Bu yazı, aegisSoft tersine mühendislik çalışma alanında günlük olarak kullanılan araçların tamamını tek bir yerde toplar. Her araç için ne işe yaradığını, nasıl kurulduğunu, nasıl ayarlandığını ve tipik bir operasyon akışında nasıl kullanıldığını açıklar. Yazı, genelleştirilmiş AGENTS.md ve PROMPTS.md şablonlarıyla birlikte gelir; bu şablonlar aşağıdaki bağlantılardan indirilebilir.

0. Çalışma Alanı Felsefesi

Tersine mühendislikte en sık yapılan hata, araçları kurup sonra "nerede ne var" sorusunu sormaktır. Bu rehberin temel ilkesi şudur: araçlar konumdan bağımsız çağrılabilir olmalı, hiçbir betikte mutlak yol bulunmamalı ve her proje kendi PROJECT.md dosyasını taşımalıdır. Tüm yollar göreli veya ortam değişkeni üzerinden çözümlenir; hiçbir değer sabit kodlanmaz.

Önerilen üst düzey dizin yapısı:

<WORKSPACE_ROOT>/
├── Tools/                 # Tüm analiz araçları (junction/symlink ile sürümden bağımsız)
├── Projects/              # Her proje kendi alt dizininde
│   └── <project_name>/
│       └── PROJECT.md     # Proje kimliği, mimari, derleme komutları, yol haritası
├── evidence/              # Adli çıktılar, pcap, db, strings
├── AGENTS.md              # Bu rehberin bağlayıcı kopyası
└── PROMPTS.md             # Oturum başlatma şablonları

1. Araç Envanteri

Aşağıdaki tablo, çalışma alanında bulunan araçların tamamını, konumlarını, çağrı dosyalarını ve temel amaçlarını listeler. Konumlar göreli (workspace köküne göre) verilmiştir; gerçek kurulumda junction/symlink kullanılır.

AraçKonumÇağrıAmaç
REA (Reverse Engineering Agent)Tools/rea/MCP entegrasyonuBirincil otonom MCP motoru; statik/dinamik RE, ADB ve ikili analiz köprüleri
Detect It Easy (DIE)Tools/die/diec.exe, die.exePE/ELF/Mach-O/APK packer, derleyici, linker, koruma ve entropi tespiti
dnSpyTools/dnspy/dnSpy.exe, dnSpy.Console.exe.NET decompile (C#), CIL opcode yamalama, runtime debugging
Il2CppDumperTools/il2cppdumper/Il2CppDumper.exeUnity IL2CPP sembol, metot ve tip çıkarma (dump.cs, script.json, il2cpp.h)
x64dbg / x32dbgTools/x64dbg/x96dbg.exe, x64dbg.exe, x32dbg.exeWindows yerel ikililer için dinamik kullanıcı alanı debugger
System InformerTools/systeminformer/SystemInformer.exe, peview.exeÇekirdek seviyesi süreç, DLL/handle, bellek ve PE analizi
Process Hacker 2Tools/processhacker/ProcessHacker.exeSüreç, servis ve soket inceleme, çekirdek sürücü kancası
Sysinternals SuiteTools/sysinternals/procmon64.exe, procexp64.exe, autoruns64.exe, strings64.exeCanlı olay yakalama, kalıcılık tespiti, dizgi taraması
Explorer Suite / CFFTools/cff-explorer/CFF Explorer.exe, PE Detective.exePE32/PE32+ başlık modifikasyonu, ASLR/DEP, IAT onarımı
Cheat EngineTools/cheatengine/Cheat Engine.exeBellek tarama, pointer haritalama, AOB enjeksiyon, Lua
7-ZipTools/7zip/7z.exe, 7zFM.exeAPK, IPA, ASAR, MSI, CAB, NSIS ve çoklu format ayıklama
SQLite ToolsTools/sqlite-tools/sqlite3, sqldiff, sqlite3_analyzerSQLite sorgulama, şema dökümü, B-Tree ve diff
WakaruTools/wakaru/wakaru.exeWebpack/Rollup/ESBuild/Vite/Bun paket açma ve JS decompile
Wireshark & TSharkTools/wireshark/WiresharkPortable64.exe, tshark.exe, dumpcap.exePaket yakalama, DPI, TLS deşifreleme
Sigrok-CLI & ZadigTools/sigrok-cli/sigrok-cli.exe, zadig.exeMantıksal analizör, protokol çözme, WinUSB sürücü
JADXTools/jadx/jadx.bat, jadx-gui-*.exeAndroid DEX -> Java kaynak dönüşümü
ApktoolTools/apktool.batAPK/AAB kaynak decode (smali/res) ve rebuild
Cutter / RizinTools/cutter/cutter.exe, rizin.exe, rz-bin, rz-diffELF, PE, Mach-O, ARM64/x86 reversing
GhidraTools/ghidra/ghidraRun.bat, analyzeHeadless.batNSA decompiler, headless otomasyon
ScrcpyTools/scrcpy/scrcpy.exeAndroid ekran yansıtma ve kontrol
PerfettoTools/perfetto/perfetto.exe, traceconv.exeAndroid/sistem performans profilleme
Frida ServerTools/frida-server-*.exeDinamik hook ve bellek enjeksiyonu
Burp Suite CommunityTools/BurpSuiteCommunity/BurpSuiteCommunity.exeWeb proxy, Repeater, Intruder
mitmproxyTools/mitmproxy/mitmproxy.exe, mitmweb.exe, mitmdump.exeTLS-capable intercepting proxy
OWASP ZAPTools/ZAP/ZAP.exe, zap.batWeb güvenlik tarayıcısı ve fuzzer
wabtTools/wabt/bin/wasm2wat.exe, wasm-decompile.exeWebAssembly decompile
PlaywrightSistem genelinpx playwrightHeadless tarayıcı otomasyonu
synchronySistem genelisynchronyjavascript-obfuscator deobfuscation

2. Kurulum ve Ayarlama

2.1. Genel İlkeler

  1. Tüm araçlar tek bir Tools/ kökü altında toplanır; sürümden bağımsız çağrı için junction (Windows) veya symlink (Linux/macOS) kullanılır.
  2. Hiçbir betikte mutlak yol yazılmaz; %~dp0 (Batch), $PSScriptRoot (PowerShell) veya göreli yol kullanılır.
  3. Cihaz kimlikleri, IP/port ve API anahtarları git'e alınmaz; yerel, git-ignored bir yapılandırma dosyasında tutulur.
  4. Her araç PATH üzerinde kayıtlıysa CLI üzerinden doğrudan çağrılabilir olmalıdır.

2.2. Android SDK ve ADB

  • Android SDK kökü ortam değişkeniyle (ANDROID_SDK_ROOT) tanımlanır.
  • platform-tools/ (adb), build-tools/<sürüm>/ (aapt2, d8, zipalign, apksigner) ve platforms/android-<api>/android.jar yolu göreli çözümlenir.
  • ADB kablosuz hata ayıklama (TLS/mDNS) oturumu kurulur; cihaz kimliği ve yedek IP/port yerel yapılandırmada saklanır.
  • Honor MagicOS gibi agresif pil yönetimi olan cihazlarda arka plan servisleri FOREGROUND_SERVICE + kalıcı bildirim + WAKE_LOCK ile donatılır.

2.3. Python, Node.js ve Web Araçları

  • Python 3.10+ ve Scripts dizini PATH üzerinde olmalıdır.
  • Node.js, npm, npx ve global web RE araçları (synchrony, @playwright/cli) sistem genelinde kurulu olur.
  • Playwright tarayıcı çekirdekleri %LOCALAPPDATA%/ms-playwright/ altında bulunur.

2.4. Java ve Android Studio JBR

  • Android Studio JBR (jbr/bin/) javac, keytool, jar sağlar.
  • Sistem Java SDK (JDK 17+) ayrı bir konumda tutulur; JAVA_HOME ile referans verilir.

3. Araç Bazlı Kurulum ve Ayarlama

3.1. SQLite Araçları

  • sqlite3, sqldiff, sqlite3_analyzer PATH üzerinde olmalıdır.
  • Sorgulama: sqlite3 app_data.db, .schema, .tables.
  • CSV/JSON dışa aktarma: sqlite3 -header -csv app_data.db "SELECT * FROM users;" > users.csv.
  • İki DB arası fark: sqldiff before.db after.db > changes.sql.
  • B-Tree haritası: sqlite3_analyzer app_data.db > db_analysis.txt.

3.2. Wakaru (JS Decompiler)

  • wakaru PATH üzerinde olmalıdır.
  • Otomatik bundle ayrıştırma: wakaru -u auto -o output_dir bundle.js.
  • Katı yapısal ayrıştırma: wakaru --unpack=strict -o output_dir bundle.js.
  • Vue 3 SFC kurtarma: wakaru -u auto --vue-sfc -o output_dir app.min.js.
  • Bun executable çıkarma: wakaru bun binary.exe -o unpacked_bun_dir.
  • Source map çıkarma: wakaru extract bundle.js.map -o src_recovered.
  • Dead-code elimination: wakaru -u auto --dce --formatter -o output_dir bundle.js.

3.3. Sigrok-CLI ve Zadig

  • sigrok-cli ve zadig.exe PATH üzerinde olmalıdır.
  • Cihaz tarama: sigrok-cli --scan.
  • Sinyal yakalama: sigrok-cli --driver fx2lafw --config samplerate=1m --samples 100k -o capture.sr.
  • Protokol çözümleme: sigrok-cli -i capture.sr -P i2c:scl=D0:sda=D1 -A i2c=address-data.
  • UART: sigrok-cli -i capture.sr -P uart:rx=D0:baudrate=115200.
  • Sürücü atama: zadig.exe açılarak aygıt için WinUSB veya libusb-win32 seçilir.

3.4. Wireshark ve TShark

  • tshark, dumpcap, editcap, mergecap, capinfos PATH üzerinde olmalıdır.
  • Arayüz listesi: tshark -D.
  • Canlı yakalama: tshark -i 1 -c 100 -w capture.pcapng.
  • Ring buffer: dumpcap -i 1 -b filesize:50000 -w ring_buffer.pcapng.
  • Filtre: tshark -r capture.pcapng -Y "http.request.method == POST or tls.handshake".
  • TLS deşifreleme: SSLKEYLOGFILE ortam değişkeni set edilir, ardından tshark -r capture.pcapng -o "tls.keylog_file:<KEYLOG_PATH>" -Y "http2 or websocket".
  • HTTP obje çıkarma: tshark -r capture.pcapng --export-objects "http,exported_files/".
  • Pcap bölme/birleştirme: editcap, mergecap; özet: capinfos capture.pcapng.

3.5. Detect It Easy (DIE)

  • diec, die, diel PATH üzerinde olmalıdır.
  • Temel analiz: diec target.exe.
  • Entropi: diec -e target.exe (7.2 üzeri packer/şifreli payload işareti).
  • Derin tarama: diec -d target.exe.
  • JSON rapor: diec -j target.exe > analysis.json.
  • GUI: die.exe target.exe.

3.6. Il2CppDumper

  • Il2CppDumper.exe PATH üzerinde olmalıdır.
  • Komut: Il2CppDumper.exe <libil2cpp.so/GameAssembly.dll> <global-metadata.dat> <output_dir>.
  • Çıktılar: dump.cs (sınıf/metot/alan/ofset), script.json (Ghidra/IDA fonksiyon adresleri), il2cpp.h (C++ tip tanımları), stringliteral.json.
  • Ghidra'ya sembol yükleme: ghidra_with_struct.py çalıştırılarak script.json ve il2cpp.h seçilir.

3.7. dnSpy

  • dnSpy.exe, dnSpy.Console.exe PATH üzerinde olmalıdır.
  • Derleme açma: dnSpy.exe Assembly-CSharp.dll.
  • Metot düzenleme: hedef metoda sağ tık -> Edit Method (C#)... -> Compile -> File -> Save Module....
  • CIL yamalama: Edit IL Instructions... ile ldc.i4.1, ret, nop uygulanır.
  • Canlı debugging: Debug -> Attach to Process....

3.8. x64dbg / x32dbg

  • x96dbg.exe, x64dbg.exe, x32dbg.exe PATH üzerinde olmalıdır.
  • Otomatik mimari seçimi: x96dbg.exe target.exe.
  • Kesme noktaları: F2 (software), F7 (step into), F8 (step over), F9 (run).
  • Adrese git: Ctrl+G.
  • Donanımsal kesme: bph <adres> [r|w|x].
  • API kesmesi: bp CreateFileW, bp VirtualAlloc.

3.9. System Informer ve Process Hacker 2

  • SystemInformer.exe, ProcessHacker.exe, peview.exe PATH üzerinde olmalıdır.
  • PE inceleme: peview.exe target.exe.
  • Token yetkileri: hedef süreç -> Properties -> Token sekmesi.
  • Canlı dizgiler: process Properties -> Memory -> Strings.
  • Kilitli handle/mutex: Ctrl+F.

3.10. Sysinternals Suite

  • procmon64.exe, procexp64.exe, autoruns64.exe, strings64.exe, handle64.exe, tcpview64.exe PATH üzerinde olmalıdır.
  • Dizgi çıkarma: strings64.exe -nobanner target.exe > strings.txt.
  • Procmon yakalama: procmon64.exe /accepteula /backingfile capture.pml /quiet.
  • Log açma: procmon64.exe /openlog capture.pml.
  • Autoruns: autorunsc64.exe -accepteula -a * -c > autoruns.csv.
  • Handle: handle64.exe -accepteula -p target.exe.

3.11. CFF Explorer

  • CFF Explorer.exe PATH üzerinde olmalıdır.
  • ASLR/DEP kaldırma: Nt Headers -> Optional Header -> DllCharacteristics alanından DLL can move (ASLR) ve NX compatible (DEP) bayrakları kaldırılır.
  • IAT onarımı: Import Directory / Import Adder.
  • Section yetkileri: Section Headers üzerinden 0xE0000020 (execute/read/write) atanır.

3.12. Cheat Engine

  • Cheat Engine.exe PATH üzerinde olmalıdır.
  • Değer taraması: Exact Value, Value Between, Increased/Decreased; türler: 4 Bytes, Float, Double, Text, AOB.
  • Pointer scan: Generate pointermap, yeniden başlatma, kesişen zincir süzme.
  • AOB injection: Memory Viewer -> Tools -> Auto Assemble.

3.13. 7-Zip

  • 7z.exe, 7zFM.exe PATH üzerinde olmalıdır.
  • Ayıklama: 7z x package.apk -o"unpacked_apk/".
  • Installer çıkarma: 7z x setup.exe -o"extracted_installer/".
  • Listeleme: 7z l target_archive.zip.

3.14. Ghidra

  • ghidraRun.bat, analyzeHeadless.bat PATH üzerinde olmalıdır.
  • Headless analiz: analyzeHeadless.bat <proje_dizini> <proje_adi> -import <ikili> -postScript <script.py>.
  • Il2Cpp sembol aktarımı: Script Manager üzerinden ghidra_with_struct.py çalıştırılır.

3.15. Burp Suite, mitmproxy ve ZAP

  • Burp Suite Community: web proxy, request/response manipülasyonu, Repeater, Intruder.
  • mitmproxy: mitmproxy.exe (CLI), mitmweb.exe (web arayüz), mitmdump.exe (scriptable); HTTP/1, HTTP/2, WebSocket ve TLS desteği.
  • OWASP ZAP: aktif/pasif zafiyet tarama, API fuzzer.

3.16. wabt (WebAssembly)

  • wasm2wat.exe, wat2wasm.exe, wasm-decompile.exe PATH üzerinde olmalıdır.
  • WASM -> WAT: wasm2wat input.wasm -o output.wat.
  • Decompile: wasm-decompile input.wasm -o output.dcmp.

3.17. Playwright ve synchrony

  • Playwright: npx playwright install ile tarayıcı çekirdekleri kurulur.
  • synchrony: npm install -g synchrony ile javascript-obfuscator çıktıları deobfuscate edilir.

4. Genel Operasyon Protokolleri

4.1. Android Veritabanı Adli İncelemesi

  1. Çek: adb shell "run-as <PAKET> cp databases/<DB>.db /sdcard/", adb pull, adb shell rm.
  2. Şema: sqlite3 ./evidence/<DB>.db ".schema" > ./evidence/schema.sql.
  3. Delta: sqldiff ./evidence/before.db ./evidence/after.db > ./evidence/delta.sql.
  4. Depolama: sqlite3_analyzer ./evidence/<DB>.db > ./evidence/storage_stats.txt.

4.2. Ağ Trafiği Yakalama

  1. Yakala: tshark -i 1 -f "tcp port 443 or udp port 53" -w ./evidence/traffic.pcapng.
  2. TLS deşifre: SSLKEYLOGFILE set et, tshark -r ... -o "tls.keylog_file:<PATH>" -Y "http2".
  3. Obje çıkarma: tshark -r ./evidence/traffic.pcapng --export-objects "http,./evidence/extracted_files".

4.3. JavaScript / Electron Paket Açma

  1. Bundle veya app.asar edin.
  2. wakaru -u auto --dce --formatter -o ./decompiled_js/ bundle.js.
  3. Vue SFC: wakaru -u auto --vue-sfc -o ./decompiled_vue/ app.min.js.
  4. Source map: wakaru extract bundle.js.map -o ./recovered_src/.

4.4. Donanım ve Bus Sinyali

  1. Doğrula: sigrok-cli --scan.
  2. Yakala: sigrok-cli --driver fx2lafw --config samplerate=2m --samples 500k -o ./evidence/bus_capture.sr.
  3. Çözümle: sigrok-cli -i ./evidence/bus_capture.sr -P i2c:scl=D0:sda=D1 -A i2c=address-data.

4.5. Unity IL2CPP / Mono

  1. Paketi ayıkla (7-Zip).
  2. Mono: Managed/Assembly-CSharp.dll dosyasını dnSpy ile aç.
  3. IL2CPP: libil2cpp.so/GameAssembly.dll + global-metadata.dat ile Il2CppDumper.exe çalıştır.
  4. dump.cs incele, RVA not et, Ghidra'ya ghidra_with_struct.py ile sembol aktar.

4.6. Windows PE Analizi

  1. diec -e -d target.exe > ./evidence/die_analysis.json.
  2. strings64.exe -nobanner target.exe > ./evidence/strings.txt.
  3. CFF Explorer ile başlık ve bayrak inceleme.
  4. peview.exe target.exe ile RVA ve section doğrulama.

4.7. Canlı Süreç ve Çekirdek Telemetrisi

  1. procmon64.exe /accepteula /backingfile ./evidence/procmon_events.pml /quiet.
  2. Hedef eylemi gerçekleştir.
  3. procmon64.exe /terminate, ardından procmon64.exe /openlog ./evidence/procmon_events.pml.
  4. System Informer ile süreç ağacı, DLL yüklemeleri ve soketleri izle.

4.8. Dinamik Hata Ayıklama

  1. x64dbg.exe target.exe (32-bit ise x32dbg.exe/x96dbg.exe).
  2. TLS/system breakpoint geç, entry point'e gel.
  3. API breakpoint: bp MessageBoxW, bp RegQueryValueExW, bp VirtualProtect.
  4. Cheat Engine ile canlı bellek ve pointer doğrulaması.

5. Güvenlik ve Etik

Bu rehber yalnızca yetkili, savunma amaçlı ve eğitim amaçlı tersine mühendislik için kullanılmalıdır. Üçüncü taraf sistemleri analiz etmeden önce uygun yetkilendirme alınmalıdır. Cihaz kimlikleri, API anahtarları ve tokenlar sürüm kontrolüne alınmamalıdır; çıkarılan sırlar şifreli yerel bir kasada saklanmalıdır. EOF

6. Resmi İndirme Kaynakları

Aşağıdaki bağlantılar yalnızca resmi kaynaklardır. Ayna (mirror) siteler yalnızca resmi kaynak erişilemezse ve kullanıcı onayıyla kullanılır. Kurulumdan sonra sürüm ve SHA-256 özeti Tools/<araç>/VERSION.txt içine yazılır.

AraçResmi Kaynak
REA (Reverse Engineering Agent)https://github.com/morluto/rea
Detect It Easy (DIE)https://github.com/horsicq/detect-it-easy/releases
dnSpyhttps://github.com/dnSpy/dnSpy/releases (bakımı süren fork: https://github.com/dnSpyEx/dnSpy)
Il2CppDumperhttps://github.com/Perfare/Il2CppDumper/releases/latest
x64dbg / x32dbghttps://x64dbg.com/
System Informerhttps://systeminformer.com/downloads
Process Hacker 2https://sourceforge.net/projects/processhacker/files/processhacker2/
Sysinternals Suitehttps://learn.microsoft.com/en-us/sysinternals/downloads/sysinternals-suite
Explorer Suite / CFF Explorerhttps://ntcore.com/explorer-suite/
Cheat Enginehttps://www.cheatengine.org/downloads.php
7-Ziphttps://www.7-zip.org/download.html
SQLite Toolshttps://www.sqlite.org/download.html
Wakaruhttps://github.com/pionxzh/wakaru
Wireshark & TSharkhttps://www.wireshark.org/download.html
Sigrokhttps://sigrok.org/wiki/Downloads
Zadighttps://zadig.akeo.ie/
JADXhttps://github.com/skylot/jadx/releases/latest
Apktoolhttps://github.com/iBotPeaches/Apktool/releases/latest
Cutterhttps://cutter.re/download/
Rizinhttps://rizin.re/
Ghidrahttps://github.com/NationalSecurityAgency/ghidra/releases/latest
Scrcpyhttps://github.com/Genymobile/scrcpy/releases/latest
Perfettohttps://perfetto.dev/
Fridahttps://github.com/frida/frida/releases/latest
Burp Suite Communityhttps://portswigger.net/burp/communitydownload
mitmproxyhttps://www.mitmproxy.org/downloads
OWASP ZAPhttps://www.zaproxy.org/download/
wabthttps://github.com/WebAssembly/wabt/releases/latest
Playwrighthttps://playwright.dev/docs/intro
synchronyhttps://github.com/relative/synchrony
Android SDK Platform Toolshttps://developer.android.com/tools/releases/platform-tools
Android Studiohttps://developer.android.com/studio
JDK (Temurin 17 LTS)https://adoptium.net/temurin/releases/?version=17
Pythonhttps://www.python.org/downloads/
Node.js (LTS)https://nodejs.org/en/download

Tepkiler

Yorumlar ve tepkiler bu tarayıcıda yerel olarak saklanır; hesap gerekmez.

Yorumlar(0 yorum)

Yorumlarda en fazla 3 bağlantı izinlidir; tüm bağlantılar nofollow ile işaretlenir.0/2000

Spam, hakaret veya kötü amaçlı içerik yasaktır.

Henüz yorum yok. İlk yorumu siz yapın.

Kaynaklar

Genelleştirilmiş AGENTS.md ve PROMPTS.md şablonları ile kurulum promptu. Tarayıcıda okuyun veya indirin.

AGENTS.md
İndir

aegisSoft Tersine Mühendislik — AGENTS.md (Genel Şablon)

Bu dosya, aegisSoft tersine mühendislik çalışma alanının bağlayıcı kurallarını içerir. Her ajan ve geliştirici, çalışma alanına girmeden önce bu dosyayı okur.

1. Kimlik ve Misyon

  • Çalışma alanı: aegisSoft reverse engineering workspace.
  • Amaç: yetkili, savunma amaçlı ve eğitim amaçlı tersine mühendislik.
  • Temel ilke: araçlar konumdan bağımsız çağrılabilir, hiçbir betikte mutlak yol yok, her proje kendi PROJECT.md dosyasını taşır.

2. Dizin Yapısı ve Yol Politikası

<WORKSPACE_ROOT>/
├── Tools/
├── Projects/<project_name>/PROJECT.md
├── evidence/
├── AGENTS.md
└── PROMPTS.md
  • Mutlak yol, gizli anahtar, cihaz kimliği, IP/port sabit kodlanmaz.
  • Tüm yollar <WORKSPACE_ROOT>, %~dp0 veya $PSScriptRoot üzerinden göreli çözümlenir.
  • Cihaz kimlikleri, IP/port ve API anahtarları git'e alınmaz; yerel, git-ignored yapılandırma dosyasında tutulur.

3. Platformlar ve Ortam Değişkenleri

  • Windows: junction ile sürümden bağımsız çağrı.
  • Linux/macOS: symlink.
  • Android: ANDROID_SDK_ROOT, JAVA_HOME.
  • Python 3.10+, Node.js/npm/npx, JDK 17+.
  • Her araç PATH üzerinde kayıtlı olmalı.

4. Araç Haritası

Blog yazısındaki envanter tablosu (Araç / Konum / Çağrı / Amaç) bağlayıcıdır. Her araç Tools/<araç>/ altında, junction/symlink ile çağrılır.

5. Resmi Kaynak Politikası

  • Her aracın indirme bağlantısı yalnızca resmi kaynaktan alınır (master prompt Bölüm 1.1).
  • Ayna (mirror) siteler yalnızca resmi kaynak erişilemezse ve kullanıcı onayıyla kullanılır.
  • Kurulumdan sonra sürüm, tarih ve SHA-256 özeti Tools/<araç>/VERSION.txt içine yazılır.
  • Ölü/broken link, sürüm uyuşmazlığı veya eksik bağımlılık tespit edilirse kurulum duraklatılır ve raporlanır.

6. Operasyon Protokolleri

  • Android DB forensics: adb shell run-as, SQLite şema/diff.
  • Ağ trafiği yakalama: tshark, TLS deşifre (SSLKEYLOGFILE), obje çıkarma.
  • JS/Electron paket açma: wakaru, source map, Vue SFC.
  • Donanım ve bus sinyali: sigrok-cli, Zadig sürücü.
  • Unity IL2CPP/Mono: Il2CppDumper, dnSpy, Ghidra sembol aktarımı.
  • Windows PE analizi: diec, strings64, CFF Explorer.
  • Canlı süreç ve çekirdek telemetrisi: procmon64, System Informer.
  • Dinamik hata ayıklama: x64dbg, Cheat Engine.

7. Derleme Standartları

  • Tüm yollar göreli veya ortam değişkeni üzerinden.
  • Android pipeline: aapt2, d8, zipalign, apksigner.
  • Cihaz yapılandırması (kimlik, IP/port) git-ignored yerel dosyada.
  • Honor MagicOS gibi agresif pil yönetimi olan cihazlarda FOREGROUND_SERVICE + kalıcı bildirim + WAKE_LOCK.

8. Proje Yaşam Döngüsü

  • Her proje Projects/<ad>/PROJECT.md taşır.
  • Çalışma alanına girerken önce AGENTS.md okunur.
  • Proje kimliği, mimari, derleme komutları ve yol haritası PROJECT.md içinde.

9. Güvenlik ve Etik

  • Yalnızca yetkili, savunma amaçlı ve eğitim amaçlı tersine mühendislik.
  • Üçüncü taraf sistemler analiz edilmeden önce yetkilendirme alınır.
  • Cihaz kimlikleri, API anahtarları ve tokenlar sürüm kontrolüne alınmaz.
  • Çıkarılan sırlar şifreli yerel kasada saklanır.

10. Doğrulama ve Raporlama

Kurulum/çalışma sonunda ajan şu raporu üretir:

  • Tamamlananlar: kurulan/konfigüre edilen her araç (sürüm + konum).
  • Tamamlanamayanlar: kurulamayan araç/bileşen ve nedeni.
  • Hatalar ve Eksikler: hatalar, eksik bağımlılıklar, bozuk linkler, sürüm uyuşmazlıkları.
  • Mükemmellik Değerlendirmesi: tüm araçlar çağrılabilir mi? mutlak yol var mı? sırlar sürüm kontrolünde mi? dokümanlar eksiksiz mi? Genel durum: MÜKEMMEL / EKSİK / HATALI.
  • Ek kontroller: junction/symlink çözümlenmesi, PATH doğrulaması, her projede PROJECT.md, git durumu.

11. İki Dilli Senkronizasyon

  • Bu dosyanın Türkçe ve İngilizce sürümleri (aegissoft-agents-tr.md, aegissoft-agents-en.md) her zaman aynı içeriği taşır.
  • Birinde yapılan değişiklik diğerine de uygulanır.
  • Prompt dosyaları (aegissoft-master-prompt-tr.md, aegissoft-master-prompt-en.md) da aynı kurala tabidir.

Bu şablon genelleştirilmiştir; gerçek kurulumda <WORKSPACE_ROOT> ve ortam değişkenleri ile doldurulur.

PROMPTS.md
İndir

aegisSoft Tersine Mühendislik — PROMPTS.md (Genel Şablon)

Bu dosya, tersine mühendislik oturumlarını başlatmak için kullanılan şablonları içerir.

1. Oturum Başlatma Şablonu

Çalışma alanı kökü: <WORKSPACE_ROOT>
Hedef: <hedef dosya/uygulama/paket>
Yetkilendirme: <yetki kanıtı / kapsam>
Önce AGENTS.md'yi oku, sonra işlem yap.
Tüm yollar göreli veya ortam değişkeni üzerinden çözümlenir.

2. "Önce AGENTS.md" Kuralı

Her ajan, her oturumun başında AGENTS.md dosyasını okur ve kurallarına uyar. Kurallar çiğnenmez.

3. Araç Çağrı Şablonları (Göreli Yol)

  • SQLite: sqlite3 <db>, .schema, .tables; sqlite3 -header -csv.
  • Wakaru: wakaru -u auto -o <out> <bundle>; --unpack=strict; --vue-sfc; extract.
  • Sigrok: sigrok-cli --scan; --driver ... --samples; -P i2c:....
  • Wireshark: tshark -D; tshark -i <iface> -w <out>; TLS keylog; --export-objects.
  • DIE: diec <target>; -e; -d; -j.
  • Il2CppDumper: Il2CppDumper.exe <lib> <metadata> <out>.
  • x64dbg: x96dbg.exe <target>; bp, bph.
  • CFF Explorer: başlık/bayrak düzenleme, ASLR/DEP.
  • Cheat Engine: bellek tarama, AOB.
  • Ghidra: analyzeHeadless.bat <proj> <name> -import <bin>.

4. Hata / Eksik Raporlama Şablonu

Araç/Bileşen: <ad>
Durum: TAMAMLANDI / TAMAMLANAMADI / HATALI
Neden: <açıklama>
Bozuk link: <varsa URL>
Eksik bağımlılık: <varsa>
Önerilen çözüm: <adım>

5. Doğrulama Komut Listesi

  • where <araç> / which <araç> (PATH doğrulama)
  • dir Tools\<araç> / ls -la Tools/<araç> (junction/symlink)
  • git status (gizli dosya kontrolü)
  • Her projede PROJECT.md varlığı

6. Resmi Link Politikası Hatırlatması

  • Her aracın indirme bağlantısı yalnızca resmi kaynaktan alınır.
  • Ayna (mirror) siteler yalnızca resmi kaynak erişilemezse ve kullanıcı onayıyla.
  • Ölü/broken link tespit edilirse kurulum duraklatılır ve raporlanır.

7. İki Dilli Senkronizasyon

  • Bu dosyanın Türkçe ve İngilizce sürümleri (aegissoft-prompts-tr.md, aegissoft-prompts-en.md) her zaman aynı içeriği taşır.
  • Prompt dosyaları (aegissoft-master-prompt-tr.md, aegissoft-master-prompt-en.md) da aynı kurala tabidir.

Bu şablon genelleştirilmiştir; gerçek kurulumda <WORKSPACE_ROOT> ve ortam değişkenleri ile doldurulur.

Kurulum Promptu (Master)
İndir

aegisSoft Tersine Mühendislik — Kapsamlı Kurulum ve Doğrulama Promptu

Sen deneyimli bir sistem mühendisi ve tersine mühendislik uzmanısın. Görevin, aegisSoft blog yazısında ("Tersine Mühendislik Araç Seti: Kapsamlı Kurulum ve Kullanım Rehberi") anlatılan çalışma alanını eksiksiz, hatasız ve doğrulanmış şekilde kurmaktır. Hiçbir adımı atlamayacaksın, hiçbir yer tutucu veya sahte veri bırakmayacaksın.

0. Genel Kurallar

  • Hiçbir betikte, yapılandırma dosyasında veya dokümanda mutlak yol, gizli anahtar, cihaz kimliği, IP adresi veya port sabit kodlanmaz.
  • Tüm yollar <WORKSPACE_ROOT> değişkenine, %~dp0 (Batch) veya $PSScriptRoot (PowerShell) üzerinden göreli çözümlenir.
  • Her araç CLI üzerinden PATH veya junction/symlink ile çağrılabilir olmalıdır.
  • Her proje kendi PROJECT.md dosyasını taşımalıdır.
  • Yalnızca yetkili, savunma amaçlı ve eğitim amaçlı hedefler üzerinde çalışılır.
  • İki dilli senkronizasyon: Bu promptun Türkçe ve İngilizce sürümleri her zaman aynı içeriği taşır. Birinde yapılan değişiklik diğerine de uygulanır.

1. Resmi Kaynak Politikası (Zorunlu)

  • Her aracın indirme bağlantısı yalnızca resmi kaynaktan alınır (aşağıdaki tablo). Ayna (mirror) siteleri yalnızca resmi kaynak erişilemezse ve kullanıcı onayıyla kullanılır.
  • Kurulumdan sonra sürüm, tarih ve (mümkünse) SHA-256 özeti Tools/<araç>/VERSION.txt içine yazılır.
  • Ölü/broken link, sürüm uyuşmazlığı veya eksik bağımlılık tespit edilirse kurulum duraklatılır ve kullanıcıya raporlanır; sessizce atlanmaz.
  • Aşağıdaki tabloda yer almayan bir araç için link uydurulmaz; kullanıcıdan onay alınır.

1.1 Resmi İndirme Kaynakları

AraçResmi Kaynak
REA (Reverse Engineering Agent)https://github.com/morluto/rea
Detect It Easy (DIE)https://github.com/horsicq/detect-it-easy/releases
dnSpyhttps://github.com/dnSpy/dnSpy/releases (bakımı süren fork: https://github.com/dnSpyEx/dnSpy)
Il2CppDumperhttps://github.com/Perfare/Il2CppDumper/releases/latest
x64dbg / x32dbghttps://x64dbg.com/ (https://github.com/x64dbg/x64dbg/releases)
System Informerhttps://systeminformer.com/downloads
Process Hacker 2https://sourceforge.net/projects/processhacker/files/processhacker2/
Sysinternals Suitehttps://learn.microsoft.com/en-us/sysinternals/downloads/sysinternals-suite
Explorer Suite / CFF Explorerhttps://ntcore.com/explorer-suite/ (https://ntcore.com/files/ExplorerSuite.exe)
Cheat Enginehttps://www.cheatengine.org/downloads.php
7-Ziphttps://www.7-zip.org/download.html
SQLite Toolshttps://www.sqlite.org/download.html
Wakaruhttps://github.com/pionxzh/wakaru (npm: npm install -g @wakaru/cli@latest)
Wireshark & TSharkhttps://www.wireshark.org/download.html
Sigrokhttps://sigrok.org/wiki/Downloads
Zadighttps://zadig.akeo.ie/
JADXhttps://github.com/skylot/jadx/releases/latest
Apktoolhttps://github.com/iBotPeaches/Apktool/releases/latest (https://apktool.org/docs/install/)
Cutterhttps://cutter.re/download/ (https://github.com/rizinorg/cutter/releases)
Rizinhttps://rizin.re/ (https://github.com/rizinorg/rizin/releases)
Ghidrahttps://github.com/NationalSecurityAgency/ghidra/releases/latest
Scrcpyhttps://github.com/Genymobile/scrcpy/releases/latest
Perfetto (traceconv)https://perfetto.dev/ (https://github.com/google/perfetto)
Fridahttps://github.com/frida/frida/releases/latest (https://frida.re/docs/installation/)
Burp Suite Communityhttps://portswigger.net/burp/communitydownload
mitmproxyhttps://www.mitmproxy.org/downloads
OWASP ZAPhttps://www.zaproxy.org/download/
wabthttps://github.com/WebAssembly/wabt/releases/latest
Playwrighthttps://playwright.dev/docs/intro
synchronyhttps://github.com/relative/synchrony
Android SDK Platform Toolshttps://developer.android.com/tools/releases/platform-tools
Android Studiohttps://developer.android.com/studio
JDK (Temurin 17 LTS)https://adoptium.net/temurin/releases/?version=17
Pythonhttps://www.python.org/downloads/
Node.js (LTS)https://nodejs.org/en/download

2. Çalışma Alanı Yapısı

<WORKSPACE_ROOT>/
├── Tools/                 # Tüm analiz araçları (junction/symlink ile sürümden bağımsız)
├── Projects/              # Her proje kendi alt dizininde
│   └── <project_name>/
│       └── PROJECT.md     # Proje kimliği, mimari, derleme komutları, yol haritası
├── evidence/              # Adli çıktılar, pcap, db, strings
├── AGENTS.md              # Bu rehberin bağlayıcı kopyası
└── PROMPTS.md             # Oturum başlatma şablonları

Kurallar: kök dizinde dağınık dosya yok; araçlar Tools/ altında; projeler Projects/ altında.

3. Dizin Junction'ları (Windows) / Symlink'ler (Linux-macOS)

Tools/ altında şu sabit takma adlar oluşturulur: sqlite-tools, wakaru, wireshark, mitmproxy, wabt, BurpSuiteCommunity, cutter, ghidra, jadx, scrcpy, die, dnspy, il2cppdumper, systeminformer, sysinternals, cff-explorer, processhacker, cheatengine, 7zip, jadx, apktool, perfetto, frida, zap.

Her takma ad gerçek sürümden bağımsız dizine işaret eder; sürüm güncellemesinde yalnızca hedef değiştirilir.

4. Araç Envanteri ve Kurulum

Blog yazısındaki tabloyu (Araç / Konum / Çağrı / Amaç) aynen uygula. Her araç için:

  1. Resmi kaynaktan indir (Bölüm 1.1).
  2. Tools/<araç>/ altına çıkar/kur.
  3. PATH'e ekle veya junction oluştur.
  4. Çağrı dosyasını (diec.exe, tshark.exe vb.) test et.
  5. Sürümü VERSION.txt içine yaz.

5. Çalışma Zamanları

  • Android SDK: ANDROID_SDK_ROOT ile tanımlanır; platform-tools, build-tools/<sürüm>, platforms/android-<api> göreli çözümlenir.
  • Android Studio JBR: jbr/bin/ → javac, keytool, jar.
  • JDK 17+: JAVA_HOME ile referans.
  • Python 3.10+ ve Scripts dizini PATH üzerinde.
  • Node.js, npm, npx ve global web RE araçları (synchrony, @playwright/cli) sistem genelinde.
  • Playwright tarayıcı çekirdekleri %LOCALAPPDATA%/ms-playwright/ altında.

6. Araç Bazlı Kurulum ve Ayarlama

Blog yazısındaki Bölüm 3'ü (SQLite, Wakaru, Sigrok, Wireshark, DIE, Il2CppDumper, dnSpy, x64dbg, CFF Explorer, Cheat Engine, 7-Zip, Ghidra, Android SDK/ADB, Python/Node/Java) komutlarıyla birlikte eksiksiz uygula. Her komut göreli yol veya ortam değişkeni kullanır.

7. AGENTS.md ve PROMPTS.md Oluşturma (Zorunlu İçerik)

Çalışma alanı kökünde AGENTS.md ve PROMPTS.md oluşturulur. Aşağıdaki bölümleri zorunlu olarak içerir:

AGENTS.md zorunlu bölümler

  1. Kimlik ve misyon (aegisSoft RE çalışma alanı).
  2. Dizin yapısı ve yol politikası (mutlak yol yasak).
  3. Platformlar (Windows/Linux/macOS/Android) ve ortam değişkenleri.
  4. Araç haritası (Bölüm 4 envanteri, konum+çağrı).
  5. Resmi kaynak politikası (Bölüm 1).
  6. Operasyon protokolleri (Android DB, ağ yakalama, JS/Electron, donanım/bus, Unity IL2CPP/Mono, Windows PE, canlı süreç/çekirdek, dinamik hata ayıklama).
  7. Derleme standartları (göreli yol, Android pipeline, git-ignored cihaz yapılandırması).
  8. Proje yaşam döngüsü (PROJECT.md, AGENTS.md öncelik).
  9. Güvenlik ve etik (yetkili hedef, sırları sürüm kontrolüne alma).
  10. Doğrulama ve raporlama (Bölüm 9).
  11. İki dilli senkronizasyon (TR/EN sürümler eşit).

PROMPTS.md zorunlu bölümler

  1. Oturum başlatma şablonu (workspace kökü, hedef, izin).
  2. "Önce AGENTS.md'yi oku" kuralı.
  3. Araç çağrı şablonları (göreli yol).
  4. Hata/eksik raporlama şablonu.
  5. Doğrulama komut listesi.
  6. Resmi link politikası hatırlatması.

8. Operasyon Protokolleri

Blog yazısındaki Bölüm 4'ü (Android DB forensics, ağ trafiği yakalama, JS/Electron paket açma, donanım ve bus sinyali, Unity IL2CPP/Mono, Windows PE analizi, canlı süreç ve çekirdek telemetrisi, dinamik hata ayıklama) adım adım uygula.

9. Doğrulama ve Son Rapor (Zorunlu)

Kurulum bittikten sonra ajan şu raporu üretir:

9.1 Tamamlananlar

  • Başarıyla kurulan/konfigüre edilen her araç ve bileşen listesi (sürüm + konum).

9.2 Tamamlanamayanlar

  • Herhangi bir nedenle kurulamayan araç/bileşen ve nedeni.

9.3 Hatalar ve Eksikler

  • Karşılaşılan hatalar, eksik bağımlılıklar, bozuk linkler, sürüm uyuşmazlıkları.

9.4 Mükemmellik Değerlendirmesi

  • Tüm araçlar çağrılabilir mi? (Evet/Hayır + detay)
  • Mutlak yol var mı? (Evet/Hayır)
  • Sırlar sürüm kontrolünde mi? (Evet/Hayır)
  • AGENTS.md ve PROMPTS.md eksiksiz mi? (Evet/Hayır)
  • Genel durum: MÜKEMMEL / EKSİK / HATALI ve gerekçe.

9.5 Ek Kontroller

  • Junction/symlink çözümlenmesi (dir/ls -la).
  • PATH doğrulaması (where/which).
  • Her projede PROJECT.md varlığı.
  • Git durumu: izlenmeyen gizli dosya yok.

10. Güvenlik ve Etik

Yalnızca yetkili, savunma amaçlı ve eğitim amaçlı tersine mühendislik. Üçüncü taraf sistemler analiz edilmeden önce yetkilendirme alınır. Cihaz kimlikleri, API anahtarları ve tokenlar sürüm kontrolüne alınmaz; çıkarılan sırlar şifreli yerel kasada saklanır.

11. Yürütme Talimatı

Yukarıdaki tüm bölümleri sırayla uygula. Her adımda doğrulama yap. Sonunda Bölüm 9'daki raporu üret. Hiçbir adımı "yapıldı varsayma" — her aracı gerçekten çağırıp test et.

Command Palette

Search for a command to run...