Yönetim panelinde bir ayar değiştiğinde veya yazı silindiğinde “bunu kim yaptı?” sorusunun yanıtı yoksa hata çözümü tahmine dönüşür. Audit log, önemli işlemlerin aktörünü, zamanını, hedefini, sonucunu ve gerektiğinde değişikliğin kapsamını kaydeden denetim izidir. Amaç her tıklamayı toplamak değildir. Güvenlik ve hesap verebilirlik açısından anlamlı olayları, gerektiğinde araştırılabilecek kadar ayrıntılı ve korunmuş biçimde saklamaktır. Bu rehberde audit log ile genel etkinlik akışı arasındaki farkı, hangi olayların kaydedileceğini, yönetim ekranının nasıl tasarlanacağını ve kayıtların gizlilik ile bütünlüğünü ele alacağız. OWASP’ın Logging Cheat Sheet belgesi, uygulama günlüklerinde hangi olayların ve alanların değerlendirileceğine dair güvenilir bir çerçeve sunar.
Audit log ile activity log arasındaki fark nedir?
Activity log, ürün içindeki geniş kullanıcı etkinliği akışını gösterebilir: bir görevin tamamlanması, dosya açılması veya profil güncellemesi gibi. Audit log daha dar ve kanıt niteliği taşıyan bir kayıt kümesidir: kimin hangi yetkiyle neyi değiştirdiği ve işlemin sonucunun ne olduğu gibi sorulara yanıt verir. Uygulamada iki sistem aynı olay altyapısından beslenebilir, ancak saklama ve erişim kuralları farklı olabilir. Kullanıcıya gösterilen “son etkinlikler” kartını denetim izi yerine koymayın. Kart okunabilir olsun diye ayrıntıları atabilir, daha kısa süre saklanabilir veya kullanıcı tarafından gizlenebilir. Audit kaydı ise yöneticinin iptal ettiği lisansın eski ve yeni durumunu, istek kimliğini ve zamanı içerebilir. Kayıt, olaydan sonra sessizce değiştirilememelidir.
Hangi olayları kaydetmelisiniz?
Yetki değişikliği, kullanıcı oluşturma veya devre dışı bırakma, parola sıfırlama başlatma, kritik ayar güncellemesi, veri dışa aktarma, toplu silme, ödeme veya lisans durum değişimi audit için güçlü adaylardır. İçerik sitesinde yazının yayımlanması, yayından kaldırılması ve başka bir editör tarafından değiştirilmesi önem taşıyabilir. Her sayfa görüntülemesini aynı veritabanına yazmak ise hacmi büyütür, anlamlı olayı bulmayı zorlaştırır. Başarısız yetki denemelerini de düşünün: erişimi reddedilen bir dışa aktarma girişimi güvenlik incelemesinde değerli olabilir. Ancak şifre denemesinde gönderilen parolayı asla kaydetmeyin. Olay envanterini iş etkisi ve riskine göre oluşturun. “Bu kayıt hangi soruyu yanıtlayacak?” sorusuna cevap veremiyorsanız olayı denetim günlüğüne eklemeyin.
Denetim olayının alanları nasıl tasarlanır?

Her kayıtta olay kimliği, UTC zaman damgası, aktör kimliği, eylem kodu, hedef türü ve hedef kimliği, sonuç, kaynak ve ilişkilendirme kimliği bulunabilir. actor_id normal kullanıcıyı gösterirken otomatik iş için hizmet hesabı veya sistem aktörü kullanılabilir. action alanı serbest yazılmış cümle yerine sürümlü, makinece okunabilir kod olsun: post.publish veya user.role_change gibi. Hedefin eski ve yeni değerleri gerektiğinde küçük, izin verilen bir alan kümesi olarak eklenebilir. Tam nesneyi körlemesine kopyalamak gizli alanları açığa çıkarır. Sonuç “başarılı”, “reddedildi” veya “hata” olarak açık tanımlanmalıdır. İstek kimliği aynı kullanıcı isteğinin birden fazla servis kaydını birleştirmeye yardım eder. IP adresi ve kullanıcı aracısı eklenebilir, ancak saklama amacı ve kişisel veri etkisi değerlendirilmelidir.
Bir değişiklikten önceki ve sonraki değerler nasıl saklanır?
“Ayar değişti” kaydı çoğu incelemede yetersizdir. Hangi alanın hangi değerden hangi değere geçtiği bilinmelidir. Ancak parola özeti, API anahtarı, ödeme bilgisi veya gizli erişim belirteci eski-yeni değer olarak tutulmamalıdır. Böyle alanlar için “değiştirildi” işareti ve ilgili nesne kimliği yeterli olabilir. Diğer alanlarda yalnızca gerçekten değişen değerleri kaydedin. Büyük HTML içeriklerinin tamamı audit log yerine revizyon sisteminde saklanabilir; audit olayında revizyon kimlikleri bulunur. Bu ayrım hem log hacmini hem hassas veri sızıntısı riskini azaltır. Veri biçimini sürümlendirmek, gelecekte alan adları değiştiğinde eski olayları okumayı kolaylaştırır. Olayın açıklamasını sonradan aktör adını yeniden sorgulayarak üretirken, kullanıcı silinmiş olsa bile o dönemdeki bağlamın kaybolmamasını planlayın.
Audit kaydı ne zaman yazılmalı?
Kritik işlem veritabanı işlemi içindeyse, ilgili denetim kaydının da tutarlı şekilde yazılması gerekir. Kullanıcı rolü değişti ama log yazılamadıysa güvenlik izi eksilir; log yazıldı ama rol değişikliği geri alındıysa yanlış başarı kaydı oluşur. Aynı veritabanındaki değişiklik ve audit olayı tek transaction içinde tutulabilir. Ayrı hizmete aktarım gerekiyorsa kalıcı bir outbox kaydı ve güvenilir iletim düşünülür. Başarısız yetki denemesi gibi iş verisini değiştirmeyen olayların ise ayrı kaydedilmesi gerekir. Olayı istemcinin göndermesine güvenmeyin; sunucu aktörü ve sonucu kendi belirlesin. Kullanıcı arayüzünde işlem başarılı mesajı gösterilmeden önce asıl değişikliğin tamamlandığından emin olun. Asenkron audit ile performans kazanırken kayıp olay riskini ölçün; önemli işlemler için sessiz kayıp kabul edilmemelidir.
Yönetim panelinde kayıtlar nasıl gösterilmeli?
Operatörün yanıt aradığı soru genellikle “bu nesneye kim dokundu?”, “şu kişi ne değiştirdi?” veya “bu saat aralığında ne oldu?” olur. Ekranda zaman, aktör, eylem, hedef ve sonuç sütunları bulunmalı; tarih, kullanıcı, eylem ve hedef filtreleri çalışmalıdır. Teknik olay kodunu kullanıcı dostu açıklamaya çevirin, fakat ham olay kimliğine erişim de sağlayın. Bir satıra tıklandığında izin verilen değişiklik farkları ve ilişkilendirme kimliği açılabilir. Çok büyük olay listelerini tek sayfada yüklemeyin; sayfalama ve uygun indeks kullanın. Ekran hem hızlı hem yetki kontrollü olmalıdır. Audit kaydını görebilen herkesin IP adresi veya hassas hedef bilgilerini görmesi gerekmeyebilir. Dışa aktarma özelliği varsa bunu ayrıca yetkilendirin ve dışa aktarmanın kendisini de denetim olayına yazın.
Kimler denetim kayıtlarını görebilir?
Audit log geniş yetkili yönetim ekranının sıradan bir sekmesi gibi görünse de içinde kullanıcı davranışı, güvenlik olayı ve kişisel veri bulunabilir. En az yetki ilkesini uygulayın. İçerik editörü yalnızca kendi yazısıyla ilgili yayın geçmişini görebilir; güvenlik sorumlusu daha geniş kayıtları inceleyebilir; destek görevlisi maskelemiş özetle yetinebilir. Rol kontrolünü yalnızca menüyü gizleyerek yapmayın, sorgu ve dışa aktarma uç noktasında da denetleyin. Bir kiracılı SaaS üründe tenant sınırı özellikle önemlidir; başka müşterinin olayları yanlış filtre nedeniyle görünmemelidir. Yetkili kullanıcının audit kaydını görüntülemesi bile bazı ortamlarda izlenmesi gereken olay olabilir. Geniş erişim taleplerini süreli ve gerekçeli olarak yönetmek, gereksiz kalıcı yetkileri azaltır.
Kayıt bütünlüğü nasıl korunur?

Audit tablosunu uygulama yöneticisinin sıradan düzenleme formuyla değiştirilebilir bırakmayın. Uygulama hesabına yalnızca ekleme ve okuma gibi gerekli yetkileri verin; silme ve güncelleme yetkisi ayrı tutulmalıdır. Daha güçlü gereksinimlerde olayları ayrı hizmete aktarma, değiştirilemez depolama veya kriptografik zincirleme kullanılabilir. Fakat hiçbir teknik yöntem tek başına mutlak kanıt üretmez; anahtar yönetimi, zaman kaynağı ve yöneticilerin erişimi de değerlendirilmelidir. Yedekler ve geri yüklemeler sırasında logların bütünlüğünü test edin. “Log silindi” olayını aynı silinebilir tabloda tutmak yeterli koruma değildir. Saklama süresi dolan kayıtların kontrollü arşivlenmesi ile birinin izini silmek için kayıtları değiştirmesi farklı süreçler olmalıdır. Bu süreçlerin yetki ve denetimi ayrıca tanımlanmalıdır.
Saklama süresi nasıl belirlenir?
Tüm audit olaylarını sonsuza kadar tutmak maliyet ve gizlilik riski yaratır; çok kısa saklamak da olay incelemesini imkânsız kılar. Süreyi yasal yükümlülük, sözleşme, olay tespit süresi ve ürün riskiyle belirleyin. Örneğin kritik yetki değişiklikleri ile sıradan içerik düzenlemeleri farklı sürelerde saklanabilir. Silme veya arşivleme zamanı geldiğinde hangi kayıtların etkilendiği izlenebilir olmalı ve onaylı süreç uygulanmalıdır. Veri minimizasyonu, uzun saklama ihtiyacını azaltır: anahtarın tamamı yerine maskeli referans saklamak gibi. Yedeklerdeki kopyaların ne kadar süre kaldığını da unutmayın. Kullanıcının veri talebi geldiğinde audit kaydını nasıl değerlendireceğiniz, yerel mevzuat ve kayıt tutma gereklerine bağlıdır; bunu kurumsal politika olarak belirleyin. Teknik şema bu politikanın uygulanmasını desteklemelidir.
Loglara hangi veriler yazılmamalı?
Parola, oturum çerezi, API anahtarı, erişim belirteci, kredi kartı verisi ve gereksiz özel içerik audit logda yer almamalıdır. HTTP isteğinin bütün gövdesini “kolay olsun” diye kaydetmek bu verileri fark etmeden taşıyabilir. İzin verilen alan listesiyle olay verisini bilinçli oluşturun. Serbest kullanıcı metni kaydedilecekse uzunluk sınırı ve güvenli gösterim uygulayın; log görüntüleyici de XSS saldırı yüzeyi olabilir. IP adresi, e-posta ve cihaz bilgisi de kişisel veri niteliği taşıyabileceğinden yalnızca gerekli amaç için tutulmalıdır. Hata mesajı bir veritabanı parolasını veya SQL sorgusundaki hassas değeri içeriyorsa doğrudan olay detayına kopyalamayın. Logların yedek, analitik ve uyarı sistemlerine aktarıldığını hesaba katın; ilk kayıttaki sızıntı birçok yere yayılır.
Performans ve indeksleme nasıl ele alınır?
Denetim kayıtları yazma ağırlıklıdır ve zamanla hızla büyür. Olay zamanı, aktör, hedef ve eylem üzerinden en sık kullanılan filtreleri belirleyin. Örneğin bir yazının geçmişini görmek için hedef türü, hedef kimliği ve zaman sıralaması yararlıdır. Gereksiz indeksler her yeni log kaydının yazma maliyetini artırır; gerçek sorgu planıyla karar verin. Eski kayıtları bölümlere ayırma veya arşivleme büyük hacimlerde faydalı olabilir. Yönetim ekranında tarih aralığı varsayılanı ve sayfalama kullanın; sınırsız arama tüm tabloyu taramamalıdır. Olay yazımının yavaşlaması kullanıcı işlemini de etkiliyorsa mimariyi ölçerek değiştirin. Ancak performans için önemli olayları rastgele atlamak denetim amacını bozar. Hangi olayın ne kadar gecikmeyle görünmesinin kabul edilebilir olduğunu önceden belirleyin.
Olayları başka sistemlerle nasıl ilişkilendirirsiniz?
Bir yönetici rol değişimi HTTP isteğiyle başlar, arka plan işi tetikler ve e-posta bildirimi yollar. Bu zinciri anlamak için istek kimliği veya correlation ID kullanılabilir. Her hizmet kendi olayını yazarken aynı ilişkilendirme değerini taşır. Böylece “rol değişti” ile “bildirim gönderilemedi” kayıtları aynı işlem ailesinde görülebilir. Saatlerin farklı sunucularda tutarlı olması önemlidir; UTC saklama ve eşit zaman kaynağı kullanın. Görüntüleme katmanında kullanıcının yerel saatine dönüştürün, ama ham UTC değerini koruyun. İş kimliği, kaynak türü ve sonuç alanları da incelemeyi hızlandırır. Yalnızca benzer zaman damgasına bakıp olayları birbiriyle ilişkilendirmek yanlış sonuca yol açabilir. İlişkilendirme kimliğini tahmin edilebilir sır gibi kullanmayın; amacı iz sürmektir.
Hangi uyarılar gerçekten işe yarar?
Her log satırı için bildirim göndermek kısa sürede uyarı yorgunluğu yaratır. Kritik yetki yükseltmesi, çok sayıda başarısız yönetici girişi, olağan dışı dışa aktarma veya toplu silme gibi olaylar için eşik ve bağlam belirleyin. Bir yöneticinin planlı bakım sırasında yaptığı çoklu değişiklik ile gece beklenmedik hesap hareketi aynı şekilde yorumlanmamalıdır. Uyarıda olay kimliği ve ilgili güvenli bağlantı bulunsun; hassas veri mesajın içinde taşınmasın. Yanlış pozitifleri düzenli gözden geçirin. Bir uyarının sahibi, inceleme süresi ve müdahale adımı belli olmalıdır. Kimsenin bakmadığı alarm güvenlik kontrolü sayılmaz. İşlem sonrasında kaydı koruyarak olayın gerçek saldırı mı, yetkili iş mi, uygulama hatası mı olduğunu belgeleyin.
Örnek: yönetici bir kullanıcının rolünü değiştiriyor
Yönetici arayüzde kullanıcıyı seçip “editör” rolünü “yönetici” yapmayı dener. Sunucu önce yöneticinin bu yetkiye sahip olup olmadığını ve hedefin doğru kiracıda bulunduğunu kontrol eder. Yetki yoksa değişiklik yapılmaz, uygun bir “reddedildi” olayı yazılır. Yetki varsa rol değişimi ve audit kaydı aynı tutarlı işlem içinde tamamlanır. Olayda aktör kimliği, hedef kullanıcı kimliği, eski ve yeni rol, sonuç, zaman ve istek kimliği yer alır. Parola, oturum anahtarı ve kullanıcının diğer özel bilgileri yer almaz. Yönetim ekranı “Özgür, 14:32’de Ayşe’nin rolünü editörden yöneticiye değiştirdi” gibi anlaşılır özet gösterir. Güvenlik sorumlusu gerektiğinde ham olay kodu ve kimliklerle ayrıntıyı görür. Yanlış değişiklik geri alındığında eski olayı silmek yerine yeni bir ters değişiklik olayı oluşur.
Testte hangi durumları sınamalısınız?
Başarılı değişiklikte doğru aktör, hedef ve sonuç kaydediliyor mu? Yetkisiz denemede iş verisi değişmeden reddedilme olayı görülüyor mu? Veritabanı işlemi geri alındığında yanlış başarı kaydı kalıyor mu? Aynı işlem iki kez gönderilirse logların anlamı korunuyor mu? Kullanıcı adı daha sonra değiştiğinde eski olayın bağlamı hâlâ anlaşılır mı? Aktör hesabı silinince kayıt bozuluyor mu? Maskeleme parolayı ve anahtarı hem ekranda hem dışa aktarımda gizliyor mu? Farklı kiracıdaki kullanıcı olayları erişilebilir mi? Saklama süresi dolan kayıtlar kurala göre arşivleniyor mu? Testlerde yalnızca tabloya bir satır eklendiğine bakmak, audit sisteminin asıl güvenlik amacını doğrulamaz.
Eski sistemden audit log düzenine geçiş
Bir uygulamada hâlihazırda yalnızca serbest metin “yönetici işlem yaptı” satırları bulunabilir. Yeni yapılandırılmış olay modeline geçerken eski satırları otomatik olarak güvenilir denetim kaydına dönüştürdüğünüzü varsaymayın. Eski kayıtta aktör veya hedef kimliği yoksa bunlar sonradan kesin biçimde çıkarılamaz. Geçiş tarihini belirleyin, eski kayıtları ayrı kaynak olarak koruyun ve yeni olayların zorunlu alanlarını uygulamada doğrulayın. Yönetim ekranında eski ve yeni kayıtların güven düzeyini karıştırmayın. Geçiş sonrası birkaç kritik işlem için olayın iş verisiyle eşleştiğini elle doğrulayın. Aktör kimliği olmayan sistem görevlerini rastgele bir yöneticiye atamayın; özel sistem aktörü kullanın. Eski veri için saklama ve arşiv politikasını ayrıca yazın. Böylece audit ekranı geçmişe dair sahip olmadığı kesinliği iddia etmez.
Küçük ekipte uygulama sorumluluğu nasıl paylaşılır?
Audit log yalnızca yazılımcının eklediği tablo değildir. Ürün sorumlusu hangi işlemlerin kritik olduğunu seçer, güvenlik sorumlusu erişim ve olay inceleme düzenini belirler, geliştirici olay sözleşmesini uygular, operasyon ekibi yedek ve izleme süreçlerini işletir. Küçük ekipte bu roller aynı kişide olabilir; yine de görevleri açık yazmak yararlıdır. Yeni bir yönetim özelliği eklendiğinde “hangi audit olayı oluşacak?” sorusu geliştirme kontrol listesine girsin. Olay adları merkezi sözlükte tutulsun; bir yerde role.updated, başka yerde user.permission.change kullanılması raporlamayı zorlaştırır. Düzenli örnek incelemeyle logun gerçekten işe yarayıp yaramadığını görün. Gereksiz olayları azaltın, eksik kritik olayı ekleyin; yalnızca kayıt sayısının artmasını başarı saymayın.
Yayına almadan önce kontrol listesi
Özellikle toplu veri değiştiren yeni yönetim işlemlerinde önce küçük bir deneme yapın. Kaydın doğru aktörle, doğru hedef sayısıyla ve doğru sonuçla oluştuğunu görün. Denetim ekranına erişimi olan kişinin bu olayı bulabildiğini de sınayın.
Kaydedilecek kritik olayları ve yanıtlayacağı soruları seçin. Aktör, eylem, hedef, sonuç ve zamanı standart alanlarla tutun. Değişiklik farkını yalnızca izin verilen alanlardan oluşturun. İş verisiyle audit olayının tutarlılığını sağlayın. Görüntüleme ve dışa aktarmayı ayrı yetkilendirin. Kayıt değiştirme ve silme yetkisini sınırlayın. Saklama, arşiv ve geri yükleme politikasını yazın. Hassas bilgiyi loglardan çıkarın. Olayları filtrelenebilir ve ilişkilendirilebilir hâle getirin. Audit logun değeri, çok kayıt biriktirmesinde değil; bir sorun çıktığında güvenilir biçimde “kim, neyi, ne zaman, hangi sonuçla yaptı?” sorusunu yanıtlamasındadır.


