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 alan | Yazılmayan içerik |
|---|---|
| actor type / id | prompt |
| correlation_id | model cevabı |
| action | ham API anahtarı |
| method / path | sağlayıcı kimlik bilgisi |
| status / outcome | istek gövdesi |
| IP hash | araç 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üdahale | Zincir doğrulamasının sonucu |
|---|---|
| Kayıt değiştirilirse | Parmak izi tutmaz; kayıt sıra numarasıyla gösterilir |
| Kayıt silinirse | Sıra numarasında boşluk oluşur: "kayıt eksik" |
| Araya kayıt eklenirse | Sonraki 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
| İşlem | Sonuç | Koşul |
|---|---|---|
| 3.000 kaydın yazılması | 305 ms, zincir sağlam | İki sunucu aynı anda |
| 3.000 kaydın doğrulanması | 39 ms | Aynı test |
| 244.939 kaydın doğrulanması | 6,4 sn, zincir sağlam | Yerel yük testi, 3 kopya |
| Düzgün kapatmada kayıp | 0 kayıt | 150 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.