Bölüm 27: Raporlar ve Zamanlanan Güvenlik Raporları¶
Sayfanın Amacı¶
Raporlar sayfası (/admin/reports), periyodik güvenlik/uyumluluk raporları üreten ve zamanlayan Enterprise-only bir yönetişim yüzeyidir. Hem talep üzerine (Şimdi Üret) hem de zamanlanmış (haftalık/aylık) rapor üretimini destekler. Bu sayfa reporting lisans özelliği arkasındadır ve Enterprise plan zorunludur; diğer planlarda sidebar'da görünmez.
Her rapor oluşturulduğu anda SHA-256 özetiyle mühürlenir ve değiştirilemez bir kayıt olarak saklanır. Sayfa iki sekmeden oluşur: Geçmiş (üretilmiş raporlar) ve Zamanlamalar (zamanlanmış üretim).
Şimdi Üret — Talep Üzerine Rapor¶
Sayfanın üst kartı, anında rapor üretimini denetler.
Rapor Türü: Üretim her zaman tek türde olur: Güvenlik & Risk. Eski compliance türü bu türle birleştirilmiştir; yalnızca geçmiş kayıtlarda Uyumluluk (Eski) etiketi görünür ve bu kayıtlar aynı eylemlerle görüntülenip indirilebilir.
Dönem: Hazır seçimler Son 1 gün, Son 1 hafta, Son 1 ay (varsayılan), Son 3 ay, Son 6 ay ve Son 1 yıl'dır; pencere her zaman bugüne kadar (geleceğe uzanmaz) tanımlanır. Özel aralık seçildiğinde Başlangıç ve Bitiş tarih girişleri açılır (varsayılanları son 30 gündür):
- İki tarih girilmediyse üretim isteği reddedilir ("Başlangıç ve bitiş tarihlerini seçin").
- Başlangıç bitişten sonra seçilirse yine reddedilir ("Başlangıç tarihi bitiş tarihinden sonra olamaz").
- Sunucu tarafı da aynı kuralı uygular: geçersiz bir tarih veya ters bir aralık, filtresiz/eksik kapsamlı bir rapor üretmek yerine hatayla reddedilir.
Rapor İçeriği: Operatör, rapora dahil edilecek 12 bölümü tek tek seçer:
| Bölüm | İçerik |
|---|---|
| Yönetici Özeti | Toplam istek, izin verilen/engellenen/maskelenen sayıları, benzersiz kullanıcı, risk skoru ve skorun ağırlıklı bileşenleri |
| Token & Maliyet Tasarrufu | Engelleme ve maskeleme sayesinde harcanmayan token/maliyet tahmini |
| Önceki Döneme Göre Değişim | Önceki eşit uzunluktaki döneme göre trend |
| PII Sızıntı Girişimleri | PII kuralı ve yanıt tarayıcısının engellediği girişimler |
| Tehdit Sinyalleri (Injection/ACL/Shadow) | Prompt injection, Model Erişimi reddi ve gölge kullanım sinyalleri |
| En Çok Tetiklenen Kurallar | Denetim bazında tetiklenme sayıları |
| Kullanıcı × Kural | Kullanıcı başına kural aktivitesi ve en sık görünen kullanıcı-kural eşleşmeleri |
| Yakalanan Veri Türleri | E-posta, kredi kartı vb. yakalanan hassas türlerin dökümü |
| Kural × Yakalanan Tür (Detay) | Hangi kuralın hangi veri türünü kaç kez yakaladığı |
| En Riskli Kullanıcılar | Engelleme+maskeleme yoğunluğuna göre sıralı kullanıcılar |
| Model / Sağlayıcı Dağılımı | Trafik ve güvenlik olaylarının model/sağlayıcı bazında dağılımı |
| Kullanım Yoğunluğu (Gün × Saat) | Gün-saat ısı haritası |
Hazır ön ayarlar: "Tüm Detaylar" (tüm bölümler), "PII + Kullanıcılar" (Yönetici Özeti, PII, En Riskli Kullanıcılar, Kullanıcı × Kural, Kural × Yakalanan Tür) ve "Top 10 Listeler" (özet ve ilk-10 listeleri).
Rapor Dili: Türkçe (varsayılan) veya İngilizce.
Marka / Logo: "Raporda logo göster" anahtarı, Settings → Branding'te yapılandırılmış logoyu rapor başlığına damglar. Logo yüklenmişse anahtarın yanında canlı önizleme gösterilir; yüklenmemişse "Logo yüklenmedi — hiçbir şey damgalanmayacak" ipucu ve Ayarlar → Branding'ten yükle bağlantısı görünür (bkz. Bölüm 7).
Geçmiş Sekmesi — Üretilmiş Raporlar¶
Rapor Geçmişi tablosu şu sütunları taşır: Tür (Güvenlik & Risk / Uyumluluk (Eski) etiketi), Dönem, Üretilme, Dil, Durum (Başarılı / Başarısız), Hash ve İşlemler. Geçmiş büyüdükçe tablo sayfalanır (sayfa başına 20 rapor).
- Hash sütunu, raporun SHA-256 içeriğinin ilk 10 karakterini gösterir; imleçle üzerinde durulduğunda tam özet görünür. Bu özet, indirilen dosyanın üretildiği haliyle değişmediğini doğrulamak için kullanılır.
- Henüz görüntülenmemiş veya indirilmemiş raporlar "Yeni" rozetiyle işaretlenir. Görüntüle/PDF/HTML eylemlerinden biri ilk kez kullanıldığında rozet sunucu tarafında düşürülür.
- Eylemler: Görüntüle (raporu yeni sekmede açar), PDF olarak kaydet / yazdır (gizli bir çerçeve üzerinden tarayıcının yazdırma diyaloğunu açar; "PDF olarak kaydet" ile arşivlik dosya üretilir) ve HTML İndir (tek dosyalık HTML; dosya adı rapor türü ve bitiş tarihinden oluşur, örn.
arceris_security_2026-10-29.html). - Silme: Tek rapor veya çoklu seçimle toplu silme ("Seçilenleri Sil") desteklenir; her silme işlemi kalıcıdır ve ayrı ayrı denetim kaydına yazılır. Zamanlama silinmesi üretilmiş raporları etkilemez.
Zamanlamalar Sekmesi — Zamanlanmış Üretim¶
Rapor üretimini otomatikleştirmek için Zamanlama Ekle ile bir zamanlama tanımlanır (varsayılan: Haftalık, Pazartesi 09:00 yerel saat). Zamanlama, talep üzerine üretimle aynı içerik seçimlerini taşır — 12 bölümün tümü, rapor dili ve logo dahil edilir:
- Sıklık: Haftalık (haftanın günü seçilir: Pazartesi–Pazar) veya Aylık (Ayın Günü (1–28) — her ayda bulunmayan günler seçilemez).
- Saat (yerel): 12 saatlik AM/PM girişi; arayüz değeri UTC'ye çevirir.
- Kapsam: Tümü, API veya Tarayıcı (Şeffaf).
- Rapor Dili ve logo dahil etme, talep üzerine üretimdekiyle aynı şekilde seçilir.
- E-posta Alıcıları (virgülle ayrılmış): Üretilen rapor,
[email protected], [email protected]örneğindeki gibi virgülle ayrılmış adrese gönderilir. Gönderim, Settings → E-posta / SMTP'de yapılandırılan sunucu üzerinden yapılır (bkz. Bölüm 6); alıcı tanımlanmamışsa rapor yalnızca geçmişte saklanır. - Etkin anahtarı: Devre dışı zamanlamalar otomatik olarak rapor üretmez.
Zamanlamalar tablosu Sıklık, Gün, Saat (yerel), Alıcılar, Sonraki (bir sonraki çalışma anı, next_run_at) sütunlarıyla listelenir; her çalıştırmadan sonra sonraki çalışma anı bir sonraki periyoda güncellenir. Durum rozeti Etkin / Etkin Değil gösterir.
Rapor Sayımlarının Kaynağı ve Doğruluğu¶
Raporlardaki güvenlik sayımları, Audit Logs → İstek Olayları'nın okuduğu aynı olay kaynağından üretilir; bu nedenle rapordaki "Engellenen" sayısı operatörün İstek Olayları sekmesinde ve panel göstergelerinde gördüğüyle eşleşir (bkz. Bölüm 25). Sayım kuralları:
- Gerçek blok sayılır; müdahale sayılmaz. Maskeleme (redacted), sanitizasyon, yalnızca-algılama ve izin verme satırları "Engellenen" totaline girmez; maskelenen etkileşimler raporda ayrı bir "maskelenen" kalemi olarak gösterilir ve toplam = izin verilen + engellenen + maskelenen olacak şekilde tutarlıdır. Sağlayıcı kaynaklı hatalar (ör. erişilemeyen model sunucusu) ve karantina bildirimleri de blok sayılmaz — bunlar Arceris'in durdurmadığı olaylardır.
- Reddedilen tarayıcı yükleme denemeleri tek blok sayılır. Tarayıcılar reddedilen bir yüklemeyi otomatik olarak yeniden dener (Gemini yaklaşık dört kez); eskiden her deneme ayrı bir blok satırı yazıyor ve tek bir reddedilen ek raporda defalarca "blok" olarak görünüyordu. Artık ilk red kaydı yazılır, yeniden denemeler yalnızca ilk reddin referansını taşıyan küçük, bağlı bir "tekrar" satırı bırakır — o referansla Audit Logs aramasında bulunabilir (bkz. Bölüm 25). İki farklı kullanıcı veya iki farklı dosya yine iki ayrı bloktur.
- Yanıt taraması reddiyleri tüm yollarda sayılır. Bir model yanıtının Yanıt Taraması tarafından reddedilmesi, coding agent (explicit proxy) ve yerel LLM yollarında da artık İstek Olayları'na düştüğü için bu reddiyler raporların "Engellenen" sayısına girer; eskiden yalnızca denetim kaydı yazılıyor ve raporlar bu reddiyleri hiç saymıyordu.
- Katman bazlı sayım farkları olabilir. İstem denetimleri üç katmanda sabit bir sırayla çalışır ve ilk blokta durur: hızlı denetimler (Prompt Guard desenleri, oturum tehdidi, PII kararı, konu sınıflandırıcı) → paketle gelen özel denetim modelleri ve Kurumsal Veri Denetçisi → ICAP DLP ve içerik moderasyonu. Bir isteği birden fazla denetim engelleyebilecek olsa bile istek yalnızca bir kez, en erken engelleyen katmanın denetimi altında sayılır. Bu nedenle eski sürüm raporlarıyla karşılaştırırken kural ve kategori dağılımında farklar görülebilir — içerik artık engellendiği anda sonraki katmanlara gönderilmez, o katmanlar kendi satırlarını yazamaz.
- Kural bazında detay İstek Olayları'ndadır. Raporun "En Çok Tetiklenen Kurallar" bölümü denetim (politika sınıfı) bazında sayar. Hangi kütüphane kuralının, hangi atama yoluyla (doğrudan, rol, LDAP grubu, IP, kural seti) engellediği —
rule_type'tanrule_via'ya kadar kural zinciri — İstek Olayları satırlarında ve dışa aktarımlarında taşınır (bkz. Bölüm 25).
Bütünlük, Marka ve Saklama¶
- Rapor, tek başına taşınabilir tek dosyalık bir HTML belgesidir: logo, kendi içinde base64 veri URI'si olarak gömülür ve yazı tipleri (woff2) belgeye base64 olarak gömülür — rapor hiçbir dış CDN'e başvurmaz, ağdan yalıtılmış (air-gap) ortamda bile tamamıyla açılır. Rapor yüzeyinin marka kuralları için bkz. Bölüm 7.
- Üretilmiş raporlar, silinmedikleri sürece kalıcı olarak veritabanında saklanır; içerik SHA-256 özetiyle mühürlenir.
- Raporlardaki kullanım ve maliyet verilerinin canlı (filtrelenebilir) görünümü Analytics sayfasındadır (bkz. Bölüm 26); zamanlanmış raporlar ise bu verilerin donmuş, imzalı kanıt kopyalarıdır. Yönetişim bağlamında — yapılandırma değişikliklerinin onay akışı ve uyumluluk süreçleri için bkz. Bölüm 28.
Operasyonel Notlar¶
- Raporlar HTML formatında üretilir; tarayıcıda açılabilir, PDF olarak kaydedilebilir ve indirilebilir.
- Zamanlanmış üretim, her çalıştırmadan sonra
next_run_atdeğerini bir sonraki periyoda günceller; devre dışı zamanlamalar çalışmaz ama silinmez. - Lisans devre dışıysa sayfa görünmez; Enterprise plan zorunludur.