Skip to content
Smarter by Design.Simpler for Business

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 ​

HTTP vService
L7 TCP vService (bazı değişkenler)
WAF Bilgisi
SSL Bilgisi

Manual JSON Format ​

Manual JSON formatı, key-value çiftleri tanımlanarak özel bir JSON yapısı oluşturulmasını sağlar.

Yapılandırma ​

  1. Log profilinde Line Format alanında Manual JSON Format seçilir.
  2. Manual Log Entries tablosunda alanlar tanımlanır.
AlanAçıklama
KeyJSON key adı. Boş bırakılamaz ve tablo içinde benzersiz olmalıdır.
ValueSmart 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ırmaManual JSON Örnek Yapılandırma

Çıktı Örneği ​

Yukarıdaki yapılandırma şu satırı üretir:

json
{
  "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 ​

  1. Log profilinde Line Format alanında Manual CEF Format seçilir.
  2. 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) ​

text
CEF:Version|Device Vendor|Device Product|Device Version|Signature ID|Name|Severity|Extension
AlanDeğerAçıklama
Version0CEF format versiyonu
Device VendorTR7Üretici adı
Device ProductTR7 ASPÜrün adı
Device Versionv1.9Biçim sürümü. Sabittir; kurulu TR7 sürümüyle değişmez.
Signature ID200 · 418HTTP yanıt durum kodu. WAF blokunda WAF profilindeki bloklama kodu yazılır (varsayılan 418).
NameDBE · TR7Yanıtın kaynağı; değerlerin tam listesi CEF (HTTP) sayfasındadır
Severity5Sabittir; 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)Manual Log Entries Tablosu (JSON ve CEF'te aynıdır)

Çıktı Örneği ​

text
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 +0300

Manual 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 ​

  1. Log profilinde Line Format alanında Manual Log Line Format seçilir.
  2. 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 FormatGelişmiş Log Satırı Örnek Format

Çıktı Örneği ​

Yukarıdaki format şu satırı üretir:

text
client_ip: 172.16.101.42 > client_port: 49602 > req_method: GET

Örnek Kullanım Senaryoları ​

Minimal Erişim Logu ​

text
%TIME %SRCIP %HTTPMETHOD %PATH %STATUS %DOWNLOADEDBYTE

Çıktı:

text
09/Sep/2026:20:37:06 +0300 172.16.101.42 GET /login.php 200 1011

Güvenlik Odaklı Log ​

json
{"ip":"%SRCIP","country":"%COUNTRY","path":"%PATH","waf":"%ISWAFBLOCKED","score":"%WAFSCORE"}

Performans İzleme Logu ​

json
{"path":"%PATH","status":"%STATUS","tq":"%TIMEREQ","tc":"%TIMESERVERCON","tr":"%TIMESERVERRES","tt":"%TIMETOT"}