Kontrol

Audit Log

Audit Log, Base Interactive'in AI gateway'i BaseLLM'de "kim, ne yaptı ve sonuç ne oldu?" sorusunu cevaplayan, değiştirilemez denetim ve uyumluluk katmanıdır. Her kayıt bir öncekinin parmak izini taşır; bir kayıt değiştirilir ya da silinirse zincir doğrulaması bunu sıra numarasıyla gösterir.

Ne tutar, ne tutmaz

Audit Log içerik yerine olay metadata'sı tutar. Kayıt alanları API'deki adlarıyla aşağıdadır.

Tutulan alanYazılmayan içerik
actor type / idprompt
correlation_idmodel cevabı
actionham API anahtarı
method / pathsağlayıcı kimlik bilgisi
status / outcomeistek gövdesi
IP hasharaç argümanı
user-agent
metadata.durationMs

Olay türleri ve mimari

  • HTTP request
  • policy.violation
  • pii.detection
  • settings.update
  • settings.restart

Audit, ana uygulama veritabanından ayrı bir PostgreSQL veritabanında tutulur ve oradan SIEM'e toplu olarak aktarılır. correlation_id, audit kaydını aynı isteğin kullanım ve log kayıtlarına bağlar.

Değiştirilemez kayıt zinciri

Her kaydın bir sıra numarası (seq), kendi parmak izi (row_hash) ve önceki kaydın parmak izi (prev_hash) vardır; parmak izi SHA-256'dır.

MüdahaleZincir doğrulamasının sonucu
Kayıt değiştirilirseParmak izi tutmaz; kayıt sıra numarasıyla gösterilir
Kayıt silinirseSıra numarasında boşluk oluşur: "kayıt eksik"
Araya kayıt eklenirseSonraki kaydın "önceki iz" alanı tutmaz

Dört katmanlı koruma

  • Veritabanı engeli 1: Audit tablosunda UPDATE, DELETE ve TRUNCATE engellenir.
  • Zincir 2: Engel yönetici yetkisiyle kapatılıp kayda dokunulursa parmak izleri tutmaz.
  • Dış kopya (SIEM) 3: Her kaydın parmak izi SIEM'e de gider; zincir baştan yazılsa bile kopya ele verir.
  • Otomatik kontrol 4: Zincir her gün baştan sona kontrol edilir; bozulma hata kaydı olarak SIEM'e gider.

Yönetici zinciri istediği an Sistem Kayıtları › Denetim ekranındaki "Zinciri doğrula" düğmesiyle kontrol edebilir. Bozulma varsa sonuç, sıra numarasını ve bozulma türünü yazar. Alarm kuralını güvenlik ekibiniz SIEM'de tanımlar.

Performans ve dikkat edilecekler

İşlemSonuçKoşul
3.000 kaydın yazılması305 ms, zincir sağlamİki sunucu aynı anda
3.000 kaydın doğrulanması39 msAynı test
244.939 kaydın doğrulanması6,4 sn, zincir sağlamYerel yük testi, 3 kopya
Düzgün kapatmada kayıp0 kayıt150 istek/sn, 3 kopyadan biri kapatıldı
  • Ani çökmede yalnızca son ~100 ms içinde bellekte bekleyen kayıtlar etkilenebilir.
  • Veritabanı kesintisinde bellekte en çok 20.000 kayıt bekletilir; aşılırsa uyarı yazılır.
  • Tam yetkili biri zinciri baştan yazarsa bunu SIEM'deki kopya ortaya çıkarır.
  • Akış başladıktan sonra oluşan sağlayıcı hatası audit'te 200 / başarılı yazılır.
  • pii.detection kaydının maskeli örneği SIEM'e meta_maskedSample olarak gider.

Sık sorulan sorular

LLM gateway audit log'u prompt ve model cevabını saklar mı?

Hayır. Audit Log içerik değil olay metadata'sı tutar: kim, hangi işlem, sonuç, süre ve IP'nin parmak izi. Prompt, model cevabı, istek gövdesi ve ham API anahtarı yazılmaz.

Bir kaydın sonradan değiştirilmediği nasıl kanıtlanır?

Her kayıt bir öncekinin SHA-256 parmak izini taşır. Değiştirilen, silinen ya da araya eklenen kayıt zincir doğrulamasında sıra numarasıyla görünür. Zincir her gün otomatik kontrol edilir ve yönetici "Zinciri doğrula" düğmesiyle istediği an kontrol edebilir.

Kayıtlar SIEM'e gönderilebilir mi?

Evet. Audit ayrı bir PostgreSQL veritabanında tutulur ve oradan SIEM'e toplu aktarılır; her kaydın parmak izi de SIEM'e gider. Ayrıntılar SIEM'e aktarım sayfasındadır.

Kişisel veri tespitleri de kayda geçer mi?

Evet, pii.detection olayı olarak; ham değer değil yalnız maskelenmiş örnek yazılır. Ayrıntılar Hassas veri maskeleme sayfasındadır.

Model, token ve maliyet bilgisi nerede?

Kullanım kaydında tutulur ve Bütçe ve maliyet ekranında görünür. Audit kaydına aynı correlation_id ile bağlanır.