QRadar Reference Set ve Building Block: Kuralları Yönetilebilir Hale Getirmek

QRadar’da reference set ve building block, korelasyon kurallarını daha okunabilir, yönetilebilir ve daha az yanlış pozitif üretir hale getiren iki temel yapı taşıdır. Reference set, kurallarda kullanılacak değer listelerini (IP, kullanıcı, hash, domain) tutar. Building block ise kurallarda tekrar tekrar kullanılan koşulları tek bir yerde tanımlar. Bu rehberde ikisinin ne olduğunu, ne zaman hangisinin kullanılacağını ve gerçek SOC senaryolarında nasıl birlikte çalıştıklarını anlatıyoruz.
Reference Set Nedir?
Reference set, QRadar’da tek tip değerlerden oluşan bir listedir. Kurallar, gelen olaydaki bir alanın bu listede olup olmadığını kontrol edebilir. Elle, CSV ile, API ile veya kural yanıtı (rule response) ile doldurulabilir.
| Tür | Örnek kullanım |
|---|---|
| IP | Tehdit istihbaratından gelen zararlı IP’ler, yetkili tarayıcı IP’leri, yedekleme sunucuları |
| AlphaNumeric (Alfanümerik) | Yönetici hesapları, servis hesapları, zararlı domainler, dosya hash’leri |
| Numeric | Kritik port numaraları, olay ID’leri |
| Port | İzin verilen veya şüpheli servis portları |
| Date | Bir değerin listeye eklendiği zamanın tutulması gereken senaryolar |
Reference set’lerde Time to Live (TTL) tanımlanabilir. Örneğin tehdit istihbaratından gelen IP’lerin 30 gün sonra otomatik olarak listeden düşmesi, eski ve artık geçersiz göstergelerin yanlış alarm üretmesini engeller.
Reference Set Nasıl Oluşturulur?
- Admin sekmesinden Reference Set Management bölümünü açın.
- Add ile yeni bir set oluşturun; ad, tür ve gerekiyorsa TTL belirleyin.
- Değerleri elle ekleyin veya CSV dosyası içe aktarın.
- Seti kullanacak kuralda “when any of these properties are contained in any of these reference set(s)” testini seçin.
Komut satırından toplu yönetim için Console üzerinde ReferenceDataUtil.sh aracı, otomasyon için ise REST API’deki /api/reference_data/sets uç noktası kullanılabilir.
Building Block Nedir?
Building block (BB), kendi başına offense üretmeyen, yalnızca koşul tanımlayan bir kural türüdür. Diğer kurallar “when an event matches any of the following rules” testiyle building block’u çağırır. Böylece aynı koşul onlarca kurala ayrı ayrı yazılmaz.
QRadar varsayılan olarak birçok building block ile gelir. Bunların en önemlileri host tanımlama building block’larıdır:
BB:HostDefinition: DNS ServersBB:HostDefinition: Mail ServersBB:HostDefinition: Proxy ServersBB:HostDefinition: Network Management ServersBB:HostDefinition: VA Scanner Source IP
Bu building block’ları kendi ortamınızın IP adresleriyle doldurmak, QRadar kurulumundan sonra yapılması gereken ilk ayar işlerinden biridir. Örneğin zafiyet tarayıcınızın IP’si VA Scanner Source IP içinde tanımlı değilse, her tarama port tarama ve keşif alarmları üretir.
Reference Set mi, Building Block mu?
| Soru | Reference Set | Building Block |
|---|---|---|
| Ne tutar? | Değer listesi | Koşul (test) kombinasyonu |
| Sık değişir mi? | Evet, otomatik veya elle güncellenebilir | Daha durağandır |
| Kim günceller? | Analist, API, tehdit istihbaratı akışı, kural yanıtı | Kural yöneticisi |
| Tipik örnek | “Yönetici hesapları listesi” | “Başarısız oturum açma olayı” tanımı |
En güçlü yapı ikisini birlikte kullanmaktır: Building block koşulu tanımlar, reference set ise o koşulun hangi değerler için geçerli olacağını belirler.
Senaryo 1: Yönetici Hesaplarıyla Mesai Dışı Oturum Açma
- Reference set:
Admin_Accounts(AlphaNumeric) – yönetici hesap adları. - Building block:
BB: Basarili Oturum Acma– başarılı kimlik doğrulama kategorisindeki olaylar. - Kural: Olay BB ile eşleşiyorsa, kullanıcı adı
Admin_Accountsiçindeyse ve olay saati mesai dışındaysa offense üret.
Yeni bir yönetici eklendiğinde kuralı değil, yalnızca reference set’i güncellemeniz yeterlidir.
Senaryo 2: Tehdit İstihbaratı IP’leriyle İletişim
- Reference set:
TI_Malicious_IPs(IP, TTL: 30 gün) – tehdit istihbaratı kaynağından API ile beslenir. - Kural: Hedef IP
TI_Malicious_IPsiçinde olan ve firewall tarafından izin verilen bağlantılarda offense üret.
Engellenen bağlantıları ayrı ve daha düşük önemde değerlendirmek, analistin gerçekten risk taşıyan bağlantılara odaklanmasını sağlar.
Senaryo 3: Yanlış Pozitifleri Azaltmak İçin İstisna Listeleri
Bir kural, yetkili bir servis hesabı veya tarama sunucusu yüzünden sürekli alarm üretiyorsa kuralı kapatmak yerine bir istisna reference set’i oluşturun ve kurala “and NOT when … contained in” testini ekleyin. Bu yöntem kuralın geri kalan kapsamını korur ve istisnaların görünür, denetlenebilir bir listede tutulmasını sağlar. Ayrıntılı yaklaşım için QRadar false positive yönetimi yazısına bakabilirsiniz.
İyi Uygulamalar
- Anlamlı isimlendirme kullanın:
TI_Malicious_IPs,Exception_Scanner_IPsgibi amacı belli eden adlar seçin. - TTL belirleyin: Tehdit göstergeleri ve geçici istisnalar süresiz kalmamalıdır.
- İstisnaları belgeleyin: Bir değerin neden, kim tarafından ve ne zaman eklendiğini kayıt altına alın.
- Varsayılan building block’ları düzenlemeden önce kopyalayın: Güncellemelerde değişikliklerin kaybolmasını önler.
- Kullanılmayan setleri temizleyin: Hiçbir kuralda referans verilmeyen setler karmaşa yaratır.
Sık Sorulan Sorular
Reference set ile reference map arasındaki fark nedir?
Reference set yalnızca değer listesi tutar. Reference map ise anahtar-değer çiftleri tutar; örneğin kullanıcı adı ile departman eşlemesi. Daha karmaşık ilişkiler için reference map of sets ve reference table yapıları da vardır.
Reference set’e kural ile otomatik değer eklenebilir mi?
Evet. Kuralın yanıt (rule response) bölümünde “Add to a Reference Set” seçeneğiyle, kuralı tetikleyen olaydaki bir değer otomatik olarak listeye eklenebilir.
Building block offense üretir mi?
Hayır. Building block yalnızca koşul tanımlar; offense üretmek için bir kural tarafından çağrılması gerekir.




