Saldırgan nereye girdi, sonra nereye geçti?
crabwalk birden çok makinenin Windows olay günlüklerini (EVTX) okur; oturum açmalarını, servis kurulumlarını, named pipe'ları, süreç ağaçlarını ve dosya bırakmalarını makineler arasında ilişkilendirir. Sonucu bir saldırı yolu grafiği ve tarihli bir saldırı hikâyesi olarak anlatır, her bulguyu MITRE ATT&CK'e eşler. (Yengeçler yan yürür. Saldırganlar da.)
// tamamen çevrimdışı · çalışma zamanında yalnızca evtx (Python 3.10'da ayrıca tomli) · bir Sigma motorunun yerine değil, yanında çalışır
Dokuz dosya, bir saldırı yolu
Depodaki dokuz herkese açık laboratuvar EVTX dosyası (EVTX-ATTACK-SAMPLES) her push'ta yeniden işlenir ve yayımlanır: 13 bulgu, ana zinciri aşağıda gösterilen saldırı yolu ve bunları tarih sırasıyla anlatan hikâye. Demo sayfaları İngilizcedir.
Saldırı hikâyesi →
Ne oldu, adım adım: her satır bir makineden diğerine geçiş ya da bir makinedeki bir bulgu kümesi; kim olarak, nereden, ne zaman.
HTMLRapor →
Tek dosyalık rapor: hikâye, saldırı yolları, önem dereceleri, ATT&CK kapsamı, makine başına zaman çizelgesi, makineler arası hareket tablosu ve sıralı bulgular.
GrafikSaldırı yolları →
Makine başına bir düğüm; bir makinenin üzerine gelin ya da tıklayın, saldırganın nereden geldiğini ve nereye gittiğini izleyin.
ATT&CKNavigator ısı haritası →
Bulguların arkasındaki teknikler, ATT&CK matrisinde bir katman olarak.
Markdownstory.md →
Aynı hikâye, crabwalk hunt --story çıktısı olarak: bir vaka dosyasına ya da
ticket'a yapıştırmak için.
findings.json →
Ham bulgular ve hikâye; kanıt her kaydı EventRecordID'siyle, yani Event Viewer'ın gösterdiği numarayla alıntılar.
Bu dosyalar ayrı ayrı kaydedilmiştir, tek bir saldırı değildir. crabwalk onları
makine adlarının ve adreslerin tekrar ettiği yerde birleştirir; yol, bu bağlamanın ne yaptığını
gösterir, bir saldırının kanıtı değildir. NLLT108334 → PC01 bağlantısı yalnızca
10.0.2.16 adresine dayanır ve bu adres dört hafta arayla iki ilgisiz dosyada
geçer. Demonun hikâyesi bunu kendisi söyler ve aradaki boşluklar için uyarıyla başlar.
Beş karar
Bir sızmanın ardından her SOC/DFIR ekibi aynı soruyu yanıtlar. Araç, bu yanıtı bir analistin savunabileceği biçimde vermek için beş karar etrafında kuruldu.
Olay değil, saldırı adımı
Bir kural motoru olayları tek tek raporlar; crabwalk'un korelasyon kuralları onları bulgulara bağlar. Bir PsExec çalıştırmasının paylaşım erişimi, pipe açılışları ve servis kurulumu tek bir CW-012 bulgusudur. Başka bir kuralın bulgusu, ancak alıntıladığı kayıtların hepsi bu bulguda da varsa, teknikleri ve önem derecesi bununkileri aşmıyorsa, aynı makinedeyse, hesabı ve kaynağı (biliniyorsa) bununkilerle aynıysa ve ikisi arasında en fazla 10 dakika varsa "also matched" olarak onun altına katlanır. Kim ya da nereden konusunda ayrışan bulgular ayrı kalır: birleştirme bir aktörü, kaynağı ya da zamanı asla düşürmez.
Kayıt ne diyorsa o
Her bulgunun eylem cümlesi yalnızca kaydın gösterdiğini söyler: "copied" demek için yazma hakkı içeren bir AccessMask gerekir. Sysmon 3'te Source/Destination yerel/uzak diye okunmaz, çünkü gelen bağlantı kayıtları bu makineyi iki taraftan birine koyabilir; kayıt karşı tarafı söyleyemiyorsa kaynak boş kalır.
Çevrimdışı, en az bağımlılık
Çalışma zamanında yalnızca evtx (Rust tabanlı pyevtx-rs) ve Python 3.10'da TOML için tomli. Ağa hiç çıkmaz. HTML rapor tek dosyadır: satır içi CSS, Python'da üretilen SVG, JavaScript yok. İnternetsiz bir analiz makinesinde açılır.
Fail-closed allowlist
Gürültü bir TOML dosyasıyla bastırılır. Kayıt alanlarına (fields) dayanan bir girişte her kanıt kaydı bir tabloyla tümüyle eşleşmeli ve her tablo, kaydın ne olduğunu söyleyen bir alan (ServiceName, ImagePath, PipeName, CommandLine…) içermelidir; alanlara dayanmayan bir giriş kullanıcı, makine ya da kaynak ölçütlerinden en az biriyle sınırlanmalıdır. Boş tablolar, tanımlayıcı alanı olmayan tablolar ve her değeri kabul eden regex'ler yüklenirken reddedilir; kanıtın yalnızca bir kısmını tanımlayan girişler ve verideki hiçbir kayıtta birlikte geçmeyen alanlar uyarı verir. Bastırılan bulgular sayılarda, JSON'da ve raporda görünür kalır.
Bozuk kanıt asla ölümcül değil
Açılamayan dosyalar (sıfır bayt, kilitli, EVTX değil) ve okunamayan kayıtlar sayılır ve atlanır; çalışma durmaz. Dosya düzeyindeki sorunların hepsi raporlanır. Örtüşen dışa aktarımlardaki aynı kayıt (makine, kanal, EventRecordID, zaman) tek kayda iner. Bozuk girdi yüzünden CLI, yalnızca dosyalar hata verdiyse ve hiç kayıt okunamadıysa 1 koduyla çıkar. Tüm zamanlar UTC'dir.
crabwalk hunt
Kuralların çoğu tek tek olayların değil, olaylardan kurulan durumun üstünde çalışır: makine başına oturumlar, makineler arası kenarlar, birleştirilmiş servis kurulumları. Analiz ve sunum ayrıktır; çıktıların hepsi aynı bulgu listesini okur.
16 kural, yanal hareket ve çevresi
Kapsam bilerek dar: uzaktan çalıştırma, hareketi mümkün kılan kimlik bilgisi saldırıları ve iz silme. Her kuralın veri kaynakları, mantığı, ayarları, yanlış pozitifleri ve kör noktaları tespit referansında.
| Kural | Ne yakalar | ATT&CK | Doğrulama |
|---|---|---|---|
| CW-001 | Uzak oturum açmanın ardından servis kurulumu (PsExec tarzı) | T1021.002 (RDP sonrası T1021.001), T1543.003 | birim testleri |
| CW-002 | Makineler arası RDP zinciri | T1021.001 | birim testi |
| CW-003 | Pass-the-hash izleri; aynı kaynaktan, aynı hesapla ve aynı makinede art arda gelen ayrıcalıklı NTLM oturum açmaları tek bulgu | T1550.002 | korpus |
| CW-004 | Uzak oturumdan zamanlanmış görev oluşturma | T1053.005 | korpus |
| CW-005 | Yönetim paylaşımında (ADMIN$, C$) çalıştırılabilir dosya | T1021.002, T1570 | korpus |
| CW-006 | WMI ile başlatılan süreç | T1047 | korpus |
| CW-007 | WinRM ile uzaktan çalıştırma (wsmprovhost, winrshost) | T1021.006 | korpus |
| CW-008 | Şüpheli PowerShell script block | T1059.001 | korpus |
| CW-009 | Olay günlüğü temizleme; toplu temizleme tek bulgu | T1070.001 | korpus |
| CW-010 | Kerberoasting (RC4 servis bileti) | T1558.003 | birim testleri |
| CW-011 | DCSync (dizin replikasyonu) | T1003.006 | korpus |
| CW-012 | Named pipe üzerinden uzaktan çalıştırma: PsExec, RemCom/impacket, PAExec, CSExec, Cobalt Strike; PsExec'te kaynak makine pipe adından | T1021.002 (yalnızca uzak), T1569.002 (araç pipe'ı, svcctl/ntsvcs ya da kurulum); destekleyen kayıtla T1543.003, T1053.005, T1570 | korpus: 6 pozitif, 4 negatif |
| CW-013 | DCOM ile çalıştırma | T1021.003 | korpus: 2 pozitif, 1 negatif |
| CW-014 | Başka bir makineden Startup klasörüne yazma (SMB ya da RDP) | T1547.001 (+T1021.002, T1570 ya da T1021.001) | korpus: 2 pozitif, 2 negatif |
| CW-015 | RDP istemcisinin sürücüsünden (\\tsclient) program çalıştırma | T1021.001, T1570 | korpus: 1 pozitif |
| CW-016 | RDP oturumunu ele geçirme (tscon) | T1563.002 (+T1543.003) | üçüncü korpus; ikincide kör 3/3 |
22 modül, dört katman
Odaklı, tek sorumluluklu modüller. Kurallar tema başına bir modülde durur ve hepsi ALL_RULES listesinde toplanır.
EVTX → olay, tekilleştirme; bozuk dosya ya da kayıt sayılır, asla ölümcül değil
okunan olay ID'leri ve okurken içerik filtreleri
NormalizedEvent: her kanaldan olay için tek biçim
makine başına oturumlar, makineler arası kenarlar
makine kimliği: IP ↔ ad, kısa ad, anonim ve makine hesapları
ALL_RULES, kuralları çalıştırma ve bulguları birleştirme (merge_overlaps)
Rule, Finding, HuntContext: kuralların paylaştığı durum
CW-001…005: servis kurulumu, RDP zinciri, pass-the-hash, görev, paylaşım
CW-012: named pipe ile uzaktan çalıştırma
CW-006, 007, 008, 013: WMI, WinRM, PowerShell, DCOM
CW-014, 015: Startup klasörü, \\tsclient
CW-016: tscon ile oturum ele geçirme
CW-010, 011: Kerberoasting, DCSync
CW-009: olay günlüğü temizleme
saldırı yolu grafiği; DOT, JSON, SVG, tek başına HTML
saldırı hikâyesi: konsol, Markdown, rapor
TOML ayarları ve fail-closed allowlist
kuralların ürettiği her ATT&CK tekniğinin adı
tek dosya HTML: SVG grafik ve zaman çizelgesi, JS yok
ATT&CK Navigator katmanı (JSON)
ortak CSS, açık/koyu tema, sabit önem derecesi paleti
parse · sessions · hunt · config
Kural yazmanın ötesi
Bir mülakatta anlatmaya değer işler: bir kaydın içinden çıkan bilgi, kör ölçüm ve ölçümün gösterdiği hatalar.
Kaynak makine, hedefin kendi günlüğünden IP → NLLT108334
Adı değiştirilmiş bir PsExec yalnızca hedef makinenin paylaşım erişim günlüğünde (5145)
görünüyordu; bu dosyada Hayabusa 4.1.0 yalnızca bilgi (informational)
düzeyinde iki alarm verdi, Chainsaw 2.16.5 hiç alarm vermedi. PsExec'in stdio pipe adları
<servis>-<kaynak>-<pid>-stdin biçimindedir, burada
blabla-NLLT108334-37048-stdin: CW-012 kaynağı bu adlardan çıkarır, servisin
yeniden adlandırıldığını söyler ve bulguyu grafikte bir kenar yapar. Aşağıdaki hatayı
düzelten Hayabusa 4.2.0 ve Chainsaw 2.17.1 bu dosyada artık dört kayıtta, her kural için
kayıt başına bir tane olmak üzere yüksek (high) düzeyde yedi alarm
veriyor; hiçbiri pipe adından kaynak makinenin adını çıkarmıyor.
Vaka yazısı
Kör koşu, olduğu gibi yayımlandı 3/18 → 6/18
İkinci bir korpus (EVTX-to-MITRE-Attack, 293 dosya), hiçbir kural ona göre yazılmadan önce kör olarak tarandı. Yanal hareket klasöründe crabwalk 18 dosyanın 3'ünde yanal hareket alarmı verdi, Hayabusa 6'sında, Chainsaw 5'inde: ilk korpustaki üstünlük gitmişti. Bu sonuç ham hâliyle yayımlandı; ardından yapılan her değişiklik, onu neyin tetiklediğiyle birlikte listelendi. Bugün 6 dosya: Hayabusa 4.1.0'la eşit; aşağıdaki hatayı düzelten Hayabusa 4.2.0 ise 8 dosyada.
Önce dondur, sonra puanla: CW-016 3/3 · 290 dosyada 0
RDP oturumunu ele geçirme kuralı, bağımsız üçüncü bir korpustaki bir dosyadan ve Microsoft belgelerinden yola çıkılarak tasarlandı, gözden geçirildi ve donduruldu; ancak bundan sonra ikinci korpus üzerinde çalıştırıldı. Daha önce okunmamış üç RDP-hijack dosyasının üçünde de tetiklendi, diğer 290 dosyanın hiçbirinde tetiklenmedi. Bir kural ve üç dosya bir tespit oranı değildir; ama bu korpusta, kural yazılırken görülmemiş tek sonuç budur.
Alarm fırtınası değil, bulgu 91 → 3
Kör koşuda tek bir dosya, 91 olay günlüğünün temizlenmesi için 91 ayrı bulgu üretti: önce birkaç dakika arayla System ve Security, ardından 3 saniye içinde 89 kanal. Artık aynı makinede ve aynı hesapla yapılan, her biri bir öncekinden en fazla bir dakika sonra gelen temizlemeler tek bulgudur; 8 saniyedeki 14 NTLM oturum açması da tek bulgu olur ve sayısını taşır. İkinci korpusun yol açtığı değişikliklerin hepsiyle birlikte, korpusun tamamında alarm sayısı 180'den 72'ye indi.
Yanlış bir "kritik" kaynağında düzeltildi critical → medium, yerel
Bir makinenin kendi üzerinde çalıştırılan PsExec, servis pipe'ına SMB loopback üzerinden ulaştığı için kritik yanal hareket olarak raporlanıyordu. İlk korpustaki yerel örnek adı değiştirilmiş bir servis kullandığından bu boşluk görünmemişti. Artık yerel bir çalıştırma yerel kalır; yanındaki gerçek bir uzak PsExec ise uzak kalır.
Event Viewer'da bulunabilen kanıt 20–22 → 84050–84052
Kanıt önce kaydın dosyadaki sırasını alıntılıyordu ve filtrelenmiş bir dışa aktarım bu sırayı
yeniden numaralar. Artık her kanıt System/EventRecordID'yi, yani Event
Viewer'ın gösterdiği ve her dışa aktarımın koruduğu numarayı taşır. Vaka yazısındaki üç
stdio pipe kaydı böylece 20–22 değil, 84050–84052'dir.
İki motorda hata bulundu, ikisi de düzeltti hayabusa#1932 · chainsaw#245
Karşılaştırma sırasında SigmaHQ'nun Suspicious PsExec Execution kuralının
iki motorda da hiç tetiklenmediği görüldü. Kural, ShareName değerindeki düz
* karakterini kaçış karakteriyle yazar. Bu satırın
ShareName|endswith: 'IPC$' ile değiştirildiği bir kopyası ise aynı üç kayıtta
iki motorda da tetiklendi; yani eksik olan kapsam değil, kaçışlı değerin eşleştirilmesiydi.
İki projeye de bildirildi ve ikisi de düzeltti:
Hayabusa 4.2.0,
Chainsaw 2.17.1
sürümünde. Bu türden kaçışlı paylaşım adları SigmaHQ'nun paylaşım erişimi (5145)
kurallarından sekizini susturuyordu; iki korpus düzeltilmiş sürümlerle yeniden ölçüldüğünde bunlardan beşi
tetikleniyor.
Hayabusa ve Chainsaw ile aynı dosyalarda
Üç araç da aynı dosyaları dosya dosya, her biri kendi sürümüyle gelen kurallarla işledi. Ölçü kaba: orta ya da daha yüksek düzeyde bir alarm var mı ve bu alarm yanal hareket (TA0008 ya da T1021, T1570, T1550, T1563 …) olarak etiketlenmiş mi? Motorlar, bildirdiğimiz hatayı düzelten sürümleriyle de yeniden çalıştırıldı; motor sütunlarında ok, ilk sürümden düzeltilmiş sürüme gider.
| Ölçü | crabwalk ilk koşu → bugün | Hayabusa 4.1.0 → 4.2.0 | Chainsaw 2.16.5 → 2.17.1 |
|---|---|---|---|
| Orta+ alarm veren dosya | 16 → 22 | 29 → 31 | 27 → 29 |
| Yanal hareket alarmı veren dosya | 10 → 16 | 8 → 10 | 6 → 9 |
| Orta+ alarm sayısı | 34 → 41 | 130 → 145 | 110 → 132 |
| Ölçü | crabwalk kör → bugün | Hayabusa 4.1.0 → 4.2.0 | Chainsaw 2.16.5 → 2.17.1 |
|---|---|---|---|
| TA0008 klasörü (18): orta+ alarm veren dosya | 4 → 7 | 11 → 12 | 7 → 7 |
| TA0008 klasörü: yanal hareket alarmı veren dosya | 3 → 6 | 6 → 8 | 5 → 5 |
| 293 dosya: orta+ alarm veren dosya | 53 → 56 | 148 → 151 | 117 → 125 |
| 293 dosya: yanal hareket alarmı veren dosya | 17 → 20 | 27 → 30 | 15 → 16 |
| 293 dosya: orta+ alarm sayısı | 180 → 72 | 2.000 → 2.029 | 1.352 → 1.645 |
Motorlar daha çok dosya işaretler; crabwalk bilerek dardır ve bir Sigma motorunun yanında çalışmak içindir. İlk korpusta ise ilk koşuda 5 dosyada orta+ alarmı yalnızca crabwalk verdi; düzeltilmiş sürümler bunlardan birini, adı değiştirilmiş PsExec'in günlüğünü de yakalıyor. Kalan dördünün üçü hedef makinenin paylaşım erişim günlüğü (5145), biri WinRM/Operational günlüğü. Dosyalar laboratuvarda üretilmiş kısa örneklerdir, dosya başına bir teknik; sahadaki yanlış pozitifler ölçülmedi. Ayarlar, sürümlerin SHA-256 özetleri, dosya başına sonuçlar ve her değişikliğin gerekçesi: BENCHMARK.md (yeniden ölçüm: düzeltilmiş motorlarla).
Otuz saniyede ilk bulgu
Depo dokuz küçük saldırı dosyasıyla gelir: klonladıktan hemen sonra crabwalk'u bunlar üzerinde çalıştırıp ilk bulguları görebilirsiniz.
git clone https://github.com/IlkerUnver00/crabwalk.git
cd crabwalk
pip install -e .
crabwalk hunt demo/evtx --report report.html --graph attack-paths.html --story story.md
# kendi dosyalarınız: crabwalk hunt C:\vaka\evtx --out findings.json --layer nav.json
Doğrulama ve yığın
Her kural elle kurulmuş olaylarla sınanır. 16 kuraldan 13'ü gerçek saldırı dosyalarında da doğrulandı; CW-001, CW-002 ve CW-010 yalnızca birim testleriyle.
Sentetik olaylar, gerçek dosyalar
Birim testleri her kuralı elle kurulmuş olaylarla ve saldırganın varyantlarıyla sınar. Referans listesi (ground truth), EVTX-ATTACK-SAMPLES'tan 22 (dosya, teknik, kural) girdisinin her birinde beklenen kuralın o dosyada tetiklendiğini ve beklenen tekniğin bulgularda yer aldığını, başka saldırılara ait 7 dosyada ise ilgili kuralın sessiz kaldığını doğrular; her dosya tek başına işlenir. Demo dosyalarının beklenen sonuçları testlerde sabittir; her CI koşusu bunları yeniden denetler. 36 korpus testi, korpus depoda olmadığı için yerelde çalışır; CI'da 428 test çalışır.
Ağır bağımlılık yok
Python 3.10+ · evtx — EVTX ayrıştırma (pyevtx-rs)
tomli — yalnızca Python 3.10'da, TOML ayarları için
pytest — geliştirme · GitHub Actions — CI ve bu site
sigma/ — CW-012 sinyallerinin pySigma ile doğrulanmış Sigma çevirileri
HTML, CSS ve SVG Python'da üretilir; web çatısı yok.