Psaní detekčního pravidla typu korelace okna¶
Pravidlo pro korelaci okna je velmi všestranný typ detekce, který může identifikovat kombinace událostí v čase. Tento příklad ukazuje některé techniky, které můžete použít při psaní pravidel pro korelaci okna, ale existuje mnoho dalších možností, takže tato stránka vám poskytne další vedení.
Než budete moci napsat nové detekční pravidlo, musíte:
- Rozhodnout, jakou aktivitu hledáte, a rozhodnout časový rámec, ve kterém je tato aktivita významná.
- Identifikovat, který zdroj dat produkuje logy, které by mohly spustit pozitivní detekci, a zjistit, jaké informace tyto logy obsahují.
- Rozhodnout, co chcete, aby se stalo, když je aktivita detekována.
Použijte TeskaLabs SP-Lang pro psaní korelačních pravidel.
Sekce korelačního pravidla¶
Zahrňte následující sekce do vašeho pravidla:
- Define: Informace, které popisují vaše pravidlo.
- Predicate: Sekce
predicateje filtr, který identifikuje, které logy vyhodnotit, a které logy ignorovat. - Evaluate: Sekce
evaluatetřídí nebo organizuje data k analýze. - Analyze: Sekce
analyzedefinuje a hledá požadovaný vzorec — včetně testovacího výrazu uvnitřanalyze.test, který rozhodne, kdy okno odpovídá (viz níže). - Trigger: Sekce
triggerdefinuje, co se stane při pozitivní detekci. - Test (volitelné): Top-level testovací případy s ukázkovými událostmi a očekávaným výstupem pro offline validaci pravidla.
K lepšímu pochopení struktury korelačního pravidla okna konzultujte tento příklad.
Výkon
Po nasazení pravidla otevřete Detekce ve webové aplikaci a zkontrolujte Total time. Udržujte Total time pod 5 sekundami; pokud je vyšší, optimalizujte predikáty (strukturovaná pole, ne podřetězec v message).
Závorky
Slova v závorkách () jsou zástupné symboly, které ukazují, že by v této části obvykle byla hodnota. Korelační pravidla nepoužívají závorky.
Define¶
Vždy zahrňte do define:
| Položka v pravidlu | Jak zahrnout |
|---|---|
|
Pojmenujte pravidlo. I když název nemá žádný vliv na funkčnost pravidla, měl by být jasný a snadno pochopitelný pro vás i ostatní. |
|
Popište pravidlo stručně a přesně. Popis také nemá vliv na funkčnost pravidla, ale může pomoct vám i ostatním pochopit, k čemu pravidlo slouží. |
|
Zahrňte tento řádek tak, jak je. type ovlivňuje funkčnost pravidla. Pravidlo používá correlator/window k fungování jako korelátor oken.
|
Pro nastavení skupiny pro hodnocení rizika přidejte do sekce define volbu lookup_group.
define:
lookup_group: myGroup
Predicate¶
Sekce predicate je filtr. Při psaní predicate používáte SP-Lang výrazy ke struktuře podmínek filtru pro "povolení" pouze logů, které jsou relevantní k aktivitě nebo vzorci, který pravidlo detekuje.
Pokud log splňuje podmínky predikátu, je analyzován v dalších krocích detekčního pravidla spolu s dalšími souvisejícími logy. Pokud log nesplňuje podmínky predikátu, detekční pravidlo log ignoruje.
Viz tato příručka, abyste se dozvěděli více o psaní predikátů.
Evaluate¶
Jakýkoli log, který projde filtrem v predicate, je hodnocen v evaluate. Sekce evaluate organizuje data, aby mohla být analyzována. Obvykle nelze odhalit bezpečnostní hrozbu (nebo jiné významné vzorce) pouze na základě jedné události (například jednoho neúspěšného pokusu o přihlášení), proto je potřeba psát detekční pravidla k seskupení událostí dohromady, aby se našly vzorce, které ukazují na bezpečnostní nebo provozní problémy.
Sekce evaluate vytváří neviditelné hodnotící okno - můžete si okno představit jako tabulku. Tabulku používá sekce analyze k detekci aktivity, kterou hledá detekční pravidlo.
Můžete vidět příklad sekcí evaluate a analyze spolupracujících zde.
Položka v evaluate |
Jak zahrnout |
|---|---|
|
dimension vytváří řádky v tabulce. V tabulce jsou hodnoty specifikovaných polí seskupeny do jednoho řádku (viz tabulka níže).
|
|
by vytváří sloupce v tabulce. Ve většině případů je @timestamp správnou volbou, protože pravidla korelace oken jsou založena na čase. Takže každý sloupec v tabulce je interval času, který specifikuje resolution.
|
|
Jednotka resolution je sekundy. Každý časový interval bude počet sekund, které určíte.
|
|
Pole saturation nastavuje, kolikrát může být spouštěč aktivován, než pravidlo přestane počítat události v jedné buňce, které způsobily spuštění (viz tabulka níže). S doporučeným nasycením 1 přestanou být relevantní události, které se stanou v rámci stejného určeného časového rámce (resolution), počítány po jednom spuštění. Nastavení saturace na 1 zabraňuje dalšímu spouštění pro totožné chování ve stejném časovém rámci.
|
Analyze¶
analyze používá tabulku vytvořenou sekcí evaluate, aby zjistil, zda se stala aktivita, kterou hledá detekční pravidlo.
Můžete vidět příklad sekcí evaluate a analyze spolupracujících zde.
Položka v analyze |
Jak zahrnout |
|---|---|
|
Okno analyzuje specifikovaný počet buněk v tabulce vytvořené sekcí evaluate, z nichž každá představuje logy v určeném časovém rámci. Hoppingové okno: Okno bude počítat hodnoty v buňkách, testující všechny přilehlé kombinace buněk, aby pokryla stanovené časové období, s přesahem. Hoppingové okno je doporučeno. Tumblingové okno: Okno počítá hodnoty v buňkách, testující všechny přilehlé kombinace buněk, aby pokryla stanovené časové období, BEZ přesahu. Viz poznámka níže pro další informace o hoppingových a tumblingových oknech. |
|
aggregate závisí na dimension. Použijte unique count, abyste zajistili, že pravidlo nebude počítat stejnou hodnotu vašeho specifikovaného pole v dimension více než jednou.
|
|
Span nastavuje počet buněk v tabulce, které budou analyzovány najednou. span vynásobený resolution je časový rámec, ve kterém korelační pravidlo hledá vzorec nebo chování. (Například 2*60 je 2 minutový časový rámec.)
|
|
Výraz !GE znamená "větší než nebo rovno" a !ARG VALUE odkazuje na výstupní hodnotu funkce aggregate. Hodnota uvedená pod !ARG VALUE je počet unikátních výskytů hodnoty v jednom analyzačním okně, které spustí korelační pravidlo.
|
Hoppingová vs. tumblingová okna
Tato stránka o tumblingových a hoppingových oknech vám může pomoci pochopit různé typy analyzačních oken.
Agregace distance a velocity
Pro distance nastavte analyze.dimension na source.geo.location (nebo jiný geo point) pro impossible travel (práh v metrech), nebo na numerické pole pro kumulativní změnu mezi vzorky. Pro velocity použijte numerické pole (rychlost změny). Viz Window Correlator: distance a velocity.
Trigger¶
Po identifikaci podezřelé aktivity, kterou jste specifikovali, pravidlo může:
- Odeslat detekci do Elasticsearch jako dokument. Poté můžete vidět detekci jako log v TeskaLabs LogMan.io. Můžete vytvořit svůj vlastní dashboard pro zobrazení detekcí korelačních pravidel, nebo najít logy v Průzkumník.
- Poslat notifikaci emailem
Navštivte stránku triggerů pro nastavení triggerů vytvářejících události a stránku notifikací pro odesílání zpráv z detekcí.
Test (volitelné, pro validaci pravidla)¶
Top-level sekce test je volitelná. Je oddělená od analyze.test, což je SP-Lang výraz vyhodnocovaný na agregovaných hodnotách při živé korelaci (viz Analyze). Top-level test definuje pojmenované testovací případy pro syntetické události a ověření očekávaného výstupu triggeru — užitečné při psaní nebo revizi vícefázových window pravidel.
Struktura:
test: Mapa názvů případů na definice (např.test1,negative_no_trigger).lookups(volitelné, na případ): Seed dat lookupu pro offline validaci, když predikát používá lookupy. Deklarace musí existovat pod/Lookups/; viz Testování pravidel s lookupy.input: Seznam syntetických událostí. Každá by měla odpovídat schématu pravidla (např. ECS pole vpredicateaevaluate.dimension). Zahrňte:@timestamp: V interní časové reprezentaci korelačního pravidla (Nanosecond Counter Time), konzistentně s ostatními pravidly.tenant: Identifikátor tenantu pro test._id: Stabilní identifikátor každého řádku vstupu; očekávanérelated.eventsve výstupu na ně může odkazovat.- Další pole vyžadovaná predikáty (např.
we.channel,event.code,host.id,process.executable). output: Očekávaný výsledek korelace při spuštění — typicky pole complex / alert události (např.event.kind,event.dataset,event.risk_score,related.events,rule.id,rule.name,rule.description,rule.ruleset, dimenzní pole a MITRE nebo ECS threat metadata zdefine).
Příklad kostry:
trigger:
- event:
host.id: !ITEM EVENT host.id
# ...
test:
test1:
input:
- "@timestamp": 142446461673537536
"we.channel": "Microsoft-Windows-Sysmon/Operational"
"event.code": "1"
"host.id": "test.host.domain"
"tenant": "default"
"_id": 1
# ... další události splňující všechny fáze korelace
output:
tenant: default
event.kind: alert
event.dataset: complex
related.events:
- 1
# ...
rule.name: "Your rule name"
rule.id: "/Correlations/Path/To/Your Rule.yaml"
whitelist_case:
lookups:
excludedipaddresses:
10.0.0.5: {}
input:
- "@timestamp": 142446461673537536
source.ip: 10.0.0.5
tenant: default
_id: 2
output: null # pravidlo by nemělo spustit, když je IP na whitelistu
Důležité rozdíly:
| Sekce | Účel |
|---|---|
analyze.test |
SP-Lang výraz vyhodnocený na agregovaných výsledcích okna při živé korelaci (např. !GE na !ARG nebo !ARG VALUE). Vyžadováno pro spuštění pravidla. |
Top-level test |
Volitelné fixture: ukázkové události input a očekávaný output pro nástroje nebo ruční validaci chování pravidla. |
test.<case>.lookups |
Volitelné řádky lookupu pro daný případ, když predikát čte lookup; viz Testování pravidel s lookupy. |
Pokud pravidlo používá více vstupních fází (páry logsource + predicate pod inputs), syntetické události v test.input musí kolektivně splnit logiku korelace, aby test okna prošel a trigger vytvořil dokumentovaný output.