Manual Formats (HTTP)
Format Hakkında
Manual Formats, kullanıcının kendi log yapısını tanımlamasına olanak tanıyan özelleştirilebilir log formatlarıdır.
TR7, üç farklı manual format tipi sunar; Line Format listesindeki seçenek adlarıyla:
- Manual JSON Format: özel JSON yapısı.
- Manual CEF Format: özel CEF extension alanları.
- Manual Log Line Format: tamamen özel log satırı.
Bu formatlar, Smart Variable sistemi ile entegre çalışır ve yüzlerce farklı değişkeni destekler.
Kullanım senaryoları
- Özel SIEM entegrasyonları.
- Mevcut log formatlarına uyum.
- Minimal log yapısı gereksinimleri.
- Özel analitik ihtiyaçları.
Desteklenen Özellikler
Manual JSON Format
Manual JSON formatı, key-value çiftleri tanımlanarak özel bir JSON yapısı oluşturulmasını sağlar.
Yapılandırma
- Log profilinde Line Format alanında Manual JSON Format seçilir.
- Manual Log Entries tablosunda alanlar tanımlanır.
| Alan | Açıklama |
|---|---|
| Key | JSON key adı. Boş bırakılamaz ve tablo içinde benzersiz olmalıdır. |
| Value | Smart Variable, sabit metin ya da ikisinin karışımı |
INFO
Değeri boş kalan (örneğin vService protokolünün desteklemediği bir değişken içeren) key'ler çıktıda boş değerle korunur; böylece SIEM tarafındaki alan şeması sabit kalır. Protokol uyumsuzluğu tespit edilen alanlar bildirimle raporlanır.
Tablo hiç satır içermeden kaydedilirse çıktı boş bir JSON nesnesi ({}) olur.
Bütün değerler metin olarak yazılır
Manual JSON çıktısında her değer çift tırnak içinde basılır. Sayısal görünen alanlar (port, durum kodu, bayt sayısı, süre) da metin tipindedir; SIEM tarafında sayısal karşılaştırma yapılacaksa alanın tip dönüşümü toplayıcıda tanımlanmalıdır.
İstisna: HTTP vService'lerde Value hücresinde yalnızca %THREAT_INFO bulunan satır tırnak içinde değil, iç içe JSON nesnesi olarak yazılır (değişken oluşmamışsa null); nesnenin içindeki sayılar JSON sayısı, bayraklar true/false olarak gelir. Ayrıntısı SIEM Integration sayfasındadır.
Manual JSON Örnek Yapılandırma
Çıktı Örneği
Yukarıdaki yapılandırma şu satırı üretir:
{
"client_ip": "172.16.101.42",
"client_port": "49602",
"dst_ip": "172.16.102.85",
"dst_port": "8080",
"backend_ip": "172.16.102.168",
"backend_port": "80",
"time": "09/Sep/2026:20:37:06 +0300"
}Manual CEF Format
Manual CEF formatı, standart CEF header'ına özel extension alanlarının eklenmesini sağlar.
Yapılandırma
- Log profilinde Line Format alanında Manual CEF Format seçilir.
- Manual Log Entries tablosunda alanlar tanımlanır.
INFO
JSON'dan farklı olarak, değeri boş kalan extension alanları CEF satırından tümüyle çıkarılır (boş key= girdisi CEF ayrıştırıcılarını yanıltır); çıkarılan alanlar bildirimle raporlanır. L7 TCP vService'lerde header'daki durum kodu ve yanıt kaynağı alanları TCP|TCP olarak yazılır.
CEF Header Yapısı (Otomatik)
CEF:Version|Device Vendor|Device Product|Device Version|Signature ID|Name|Severity|Extension| Alan | Değer | Açıklama |
|---|---|---|
| Version | 0 | CEF format versiyonu |
| Device Vendor | TR7 | Üretici adı |
| Device Product | TR7 ASP | Ürün adı |
| Device Version | v1.9 | Biçim sürümü. Sabittir; kurulu TR7 sürümüyle değişmez. |
| Signature ID | 200 · 418 | HTTP yanıt durum kodu. WAF blokunda WAF profilindeki bloklama kodu yazılır (varsayılan 418). |
| Name | DBE · TR7 | Yanıtın kaynağı; değerlerin tam listesi CEF (HTTP) sayfasındadır |
| Severity | 5 | Sabittir; TR7 bu değeri olayın şiddetine göre değiştirmez. CEF'in tanımladığı 0–10 aralığı yalnızca biçimsel bilgidir. |
Manual Log Entries Tablosu (JSON ve CEF'te aynıdır)
Çıktı Örneği
CEF:0|TR7|TR7 ASP|v1.9|200|DBE|5|name=LOGTEST-H client_ip=172.16.101.42 client_port=49602 dst_ip=172.16.102.85 dst_port=8080 backend_ip=172.16.102.168 backend_port=80 time=09/Sep/2026:20:37:06 +0300Manual Log Line Format
Gelişmiş log satır formatı, Smart Content Builder kullanılarak tamamen özel bir log satırı tanımlanmasını sağlar.
Yapılandırma
- Log profilinde Line Format alanında Manual Log Line Format seçilir.
- Manual Log Line Format alanına Smart Variable'lar içeren format dizgisi yazılır.
Protokol denetimi bu tipte çalışmaz
Manual JSON ve Manual CEF tiplerinde vService protokolünün desteklemediği değişkenler boşaltılır ve bildirimle raporlanır. Manual Log Line Format tipinde bu denetim uygulanmaz: değişken, protokol uygun olmasa bile yapılandırmaya olduğu gibi yazılır. L7 TCP vService'te yalnızca HTTP'de geçerli bir değişken (örneğin durum kodu ya da istek metodu) kullanıldığında satır formatı çözümlenemez ve yük dengeleme motoru başlatılamaz. Bu tipte L7 TCP vService'ler için yalnızca protokolden bağımsız değişkenler kullanılır.
Gelişmiş Log Satırı Örnek Format
Çıktı Örneği
Yukarıdaki format şu satırı üretir:
client_ip: 172.16.101.42 > client_port: 49602 > req_method: GETÖrnek Kullanım Senaryoları
Minimal Erişim Logu
%TIME %SRCIP %HTTPMETHOD %PATH %STATUS %DOWNLOADEDBYTEÇıktı:
09/Sep/2026:20:37:06 +0300 172.16.101.42 GET /login.php 200 1011Güvenlik Odaklı Log
{"ip":"%SRCIP","country":"%COUNTRY","path":"%PATH","waf":"%ISWAFBLOCKED","score":"%WAFSCORE"}Performans İzleme Logu
{"path":"%PATH","status":"%STATUS","tq":"%TIMEREQ","tc":"%TIMESERVERCON","tr":"%TIMESERVERRES","tt":"%TIMETOT"}