crabwalk · proje
Windows EVTX yanal hareket avcısı

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

Demo dosyalarındaki bulgular, önem derecesine göre
demo/evtx · 9 dosya · 129 kayıt13 bulgu · 3 saldırı yolu kenarı · 8 ATT&CK tekniği
16
tespit kuralı · her bulgu ATT&CK tekniğiyle
464
test · 428'i CI'da (Python 3.10–3.12), 36 korpus testi yerelde
571
herkese açık EVTX dosyasında çalıştırıldı · iki bağımsız korpus
3/3
CW-016 kör puanlandı: 3 RDP-hijack dosyasının 3'ünde tetiklendi, diğer 290 dosyada sessiz
Canlı demo

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.

NLLT108334→ PC01→ WIN-77LTAPHIQ1R (ayrıca: IEWIN7)

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.

Tasarım ilkeleri

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.

Korelasyon

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.

Kanıt

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.

Güvenlik

Ç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.

Ayar

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.

Dayanıklılık

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.

Boru hattı

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.

parse
EVTX → normalize edilmiş olay akışı; 10 kanalda 54 olay ID'si, yüksek hacimli ID'ler (Sysmon 11/13) okunurken daraltılır
dedup
örtüşen dışa aktarımlar: aynı kayıt (makine, kanal, EventRecordID, zaman) bir kez sayılır
sessions
LogonId yaşam döngüleri, gelen uzak oturum kenarları (4624, RDP), giden açık kimlik bilgisi kenarları (4648), 4672 ile ayrıcalık
context
servis kurulumları 7045 + 4697 + Sysmon 13 birleşik; IP ↔ makine adı çözümleme; bir bağlantının karşı tarafı
rules
16 kural, tema başına bir modül → bulgu: teknik, önem derecesi, makine, hesap, kaynak, kanıt
merge · allow
bir bulgunun kayıtlarını, tekniklerini ve aktörünü zaten anlatan başka bir kuralın bulgusu onu içine alır; TOML allowlist kurallardan sonra eler, elenenler görünür kalır
graph
makine başına bir düğüm; kenarlar oturum hareketinden ve kaynağı bilinen bulgulardan; yerleşim DAG üzerinde en uzun yol
story
her satır bir kenar ziyareti ya da bir kuralın bir makinedeki bulgu kümesi; 7 günden uzun boşluklar için önce uyarı
output
konsol · JSON · tek dosya HTML rapor · grafik (HTML, DOT, JSON) · Markdown hikâye · ATT&CK Navigator katmanı
Kapsam

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.

KuralNe yakalarATT&CKDoğrulama
CW-001Uzak oturum açmanın ardından servis kurulumu (PsExec tarzı)T1021.002 (RDP sonrası T1021.001), T1543.003birim testleri
CW-002Makineler arası RDP zinciriT1021.001birim testi
CW-003Pass-the-hash izleri; aynı kaynaktan, aynı hesapla ve aynı makinede art arda gelen ayrıcalıklı NTLM oturum açmaları tek bulguT1550.002korpus
CW-004Uzak oturumdan zamanlanmış görev oluşturmaT1053.005korpus
CW-005Yönetim paylaşımında (ADMIN$, C$) çalıştırılabilir dosyaT1021.002, T1570korpus
CW-006WMI ile başlatılan süreçT1047korpus
CW-007WinRM ile uzaktan çalıştırma (wsmprovhost, winrshost)T1021.006korpus
CW-008Şüpheli PowerShell script blockT1059.001korpus
CW-009Olay günlüğü temizleme; toplu temizleme tek bulguT1070.001korpus
CW-010Kerberoasting (RC4 servis bileti)T1558.003birim testleri
CW-011DCSync (dizin replikasyonu)T1003.006korpus
CW-012Named pipe üzerinden uzaktan çalıştırma: PsExec, RemCom/impacket, PAExec, CSExec, Cobalt Strike; PsExec'te kaynak makine pipe adındanT1021.002 (yalnızca uzak), T1569.002 (araç pipe'ı, svcctl/ntsvcs ya da kurulum); destekleyen kayıtla T1543.003, T1053.005, T1570korpus: 6 pozitif, 4 negatif
CW-013DCOM ile çalıştırmaT1021.003korpus: 2 pozitif, 1 negatif
CW-014Baş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-015RDP istemcisinin sürücüsünden (\\tsclient) program çalıştırmaT1021.001, T1570korpus: 1 pozitif
CW-016RDP oturumunu ele geçirme (tscon)T1563.002 (+T1543.003)üçüncü korpus; ikincide kör 3/3
Modül haritası

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.

Okuma & durum
parser.py

EVTX → olay, tekilleştirme; bozuk dosya ya da kayıt sayılır, asla ölümcül değil

catalog.py

okunan olay ID'leri ve okurken içerik filtreleri

models.py

NormalizedEvent: her kanaldan olay için tek biçim

sessions.py

makine başına oturumlar, makineler arası kenarlar

hosts.py

makine kimliği: IP ↔ ad, kısa ad, anonim ve makine hesapları

Kurallar · rules/
__init__.py

ALL_RULES, kuralları çalıştırma ve bulguları birleştirme (merge_overlaps)

base.py

Rule, Finding, HuntContext: kuralların paylaştığı durum

lateral.py

CW-001…005: servis kurulumu, RDP zinciri, pass-the-hash, görev, paylaşım

pipes.py

CW-012: named pipe ile uzaktan çalıştırma

execution.py

CW-006, 007, 008, 013: WMI, WinRM, PowerShell, DCOM

remote_files.py

CW-014, 015: Startup klasörü, \\tsclient

rdp.py

CW-016: tscon ile oturum ele geçirme

credentials.py

CW-010, 011: Kerberoasting, DCSync

antiforensics.py

CW-009: olay günlüğü temizleme

Korelasyon & ayar
graph.py

saldırı yolu grafiği; DOT, JSON, SVG, tek başına HTML

narrative.py

saldırı hikâyesi: konsol, Markdown, rapor

config.py

TOML ayarları ve fail-closed allowlist

attack.py

kuralların ürettiği her ATT&CK tekniğinin adı

Çıktı
report.py

tek dosya HTML: SVG grafik ve zaman çizelgesi, JS yok

navigator.py

ATT&CK Navigator katmanı (JSON)

style.py

ortak CSS, açık/koyu tema, sabit önem derecesi paleti

cli.py

parse · sessions · hunt · config

Mühendislik öne çıkanları

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.

Ölçüm

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.

İlk korpus: EVTX-ATTACK-SAMPLES, Lateral Movement (47 dosya) crabwalk'un kuralları bu korpus üzerinde yazıldı; tablo bu yüzden crabwalk lehinedir.
Ölçücrabwalk ilk koşu → bugünHayabusa 4.1.0 → 4.2.0Chainsaw 2.16.5 → 2.17.1
Orta+ alarm veren dosya16 → 2229 → 3127 → 29
Yanal hareket alarmı veren dosya10 → 168 → 106 → 9
Orta+ alarm sayısı34 → 41130 → 145110 → 132
İkinci korpus: EVTX-to-MITRE-Attack (293 dosya) Kör koşuya kadar hiçbir kural bu korpusa göre yazılmamıştı. crabwalk sütununda okun sağındaki (bugün) değerler, bu korpusun sonuçlarından yapılan dört değişiklikten ve kör puanlanan CW-016'dan sonra ölçüldü.
Ölçücrabwalk kör → bugünHayabusa 4.1.0 → 4.2.0Chainsaw 2.16.5 → 2.17.1
TA0008 klasörü (18): orta+ alarm veren dosya4 → 711 → 127 → 7
TA0008 klasörü: yanal hareket alarmı veren dosya3 → 66 → 85 → 5
293 dosya: orta+ alarm veren dosya53 → 56148 → 151117 → 125
293 dosya: yanal hareket alarmı veren dosya17 → 2027 → 3015 → 16
293 dosya: orta+ alarm sayısı180 → 722.000 → 2.0291.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).

Hızlı başlangıç

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
Test & teknoloji

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.

464 test

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.

Yığın

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.