Bir günlük arşiv dosyasının içinde ne var?

ZIP'i açıyoruz

Panelden bir gün seçip dışa aktardığınızda elinize bir ZIP dosyası geçer. Çoğu işletme sahibi bu dosyayı hiç açmaz; haklı olarak "panel doğruladı, yeter" der. Ama bir gün bu dosyayı sizden başkası açacak: bir denetçi, bir bilirkişi, kendi IT ekibiniz. İçinde ne olduğunu bilmek sizi rahatlatır.

Bu yazıda örnek bir günün dizinini yürüyoruz. Satırlar tamamen kurgusaldır; dosya adları ve alan sıralaması kurulumunuza göre küçük farklar gösterebilir. Aşağıdaki yapı anlatım içindir, indirilebilir bir örnek dosya değildir.

Dizin yapısı

Bir gün, kendi adını taşıyan bir dizindir. İçinde üç tür dosya bulunur:

2026-09-14/
  sessions.csv        kayıt satırları
  manifest.txt        dosya özetleri ve zincir bağı
  manifest.tsr        RFC 3161 zaman damgası tokeni

Birden fazla gün dışa aktardığınızda her gün için bir dizin ve ZIP'in kökünde panelin ürettiği bir doğrulama raporu bulunur. Damga servisinin sertifika zinciri de ZIP'e eklenir; openssl için gerekecek.

Kayıt satırları: alan alan

Kurgusal üç satır:

start,end,mac,ip,nat_ip,nat_port,auth_type,auth_ref
2026-09-14T08:12:31+03:00,2026-09-14T09:40:02+03:00,a4:6b:xx:xx:21:0e,10.20.1.57,203.0.113.8,41022,sms,c1f3…9a
2026-09-14T08:15:04+03:00,2026-09-14T08:31:48+03:00,d8:3a:xx:xx:7c:f1,10.20.1.58,203.0.113.8,41023,coupon,KFE-4D7Q
2026-09-14T12:02:19+03:00,2026-09-14T14:02:19+03:00,f0:9e:xx:xx:b3:44,10.20.1.61,203.0.113.8,41031,email,7e02…d4

Alan	Anlamı	Not
start, end	Oturum başlangıç ve bitiş	Zaman dilimi dahil; saat NTP ile senkron
mac	Misafir cihazının donanım adresi	Örnekte kısmen gizlendi
ip	Kutunun o cihaza verdiği iç IP	Resmi talepler bu alana göre eşleşir
nat_ip, nat_port	Varsa dış IP ve port	CGNAT ya da tek dış IP durumunda talebi eşleştirmeyi sağlar
auth_type	Doğrulama yöntemi	sms, coupon, email, user
auth_ref	Doğrulama referansı	Telefon numarası açık yazılmaz; şifreli ya da özet biçiminde tutulur. Kupon kodu olduğu gibi görünür.

Üçüncü satıra dikkat: oturum tam iki saat sürmüş ve kapanmış. Bu, planda tanımlı oturum süresinin dolmasıdır; misafir çıkış yapmasa da kayıt kapanır.

Neyin olmadığı kadar önemli

Dosyada şunlar yoktur: misafirin adı, ziyaret ettiği siteler, URL'ler, mesaj içerikleri, konum, SMS'in metni. Kutu bunları toplamaz; dolayısıyla dışa aktaramaz da. Denetçiye arşivi gösterirken bunu açıkça söyleyin: kayıt, iç IP dağıtımının kaydıdır; içeriğin değil.

Telefon numarası kutuda şifreli saklanır ve panelde yetkili role maskeli görünür. Dışa aktarılan dosyada auth_ref alanının biçimi kurulum ayarınıza bağlıdır; her durumda açık numara satıra yazılmaz.

Manifest: zincirin halkası

manifest.txt, günün parmak izidir. Kurgusal içerik:

day: 2026-09-14
prev: 5b2e…c7a1          önceki günün manifest özeti
sha256 sessions.csv  e3a9…41f0
rows: 318

İki şey yapar. Birincisi, günün her dosyasının SHA-256 özetini listeler; dosyada bir karakter değişirse özet tutmaz. İkincisi, prev satırıyla önceki günün manifest özetini taşır; böylece bugün geçmişe bağlanır. Zincir dediğimiz şey, manifestlerin birbirini bu satırla tutmasıdır.

Damga dosyası: bağımsız tanık

manifest.tsr, RFC 3161 zaman damgası tokenidir. Kutu, manifest dosyasının özetini damga servisine gönderir; servis özetin yanına kendi saatini yazar ve kendi anahtarıyla imzalar. Dosya ikili biçimdedir, metin editöründe açılmaz; openssl okur.

Servise yalnızca özet gittiğini bir kez daha söyleyelim: sessions.csv kutudan çıkmaz.

Üç komutla doğrulama

Bir bilgisayarda openssl ve sha256sum yeterlidir. Dizinin içindeyken:

1. Dosya özetleri manifest ile tutuyor mu?

sha256sum -c <(grep '^sha256' manifest.txt | awk '{print $3"  "$2}')

Çıktı sessions.csv: OK olmalı. Değilse dosya manifest yazıldıktan sonra değişmiştir.

2. Zincir önceki güne bağlı mı?

sha256sum ../2026-09-13/manifest.txt

Çıkan özet, bugünün manifestindeki prev satırıyla aynı olmalı. Birkaç günü peş peşe yaparsanız zinciri elle yürümüş olursunuz.

3. Zaman damgası geçerli mi ve manifest'e ait mi?

openssl ts -verify -data manifest.txt -in manifest.tsr -CAfile tsa-chain.pem

Çıktı Verification: OK olmalı. Bu satır üç şeyi birden söyler: token geçerli bir servis tarafından imzalanmış, token manifest'in özetine ait ve içindeki saat o anki saattir. Damganın tarihini görmek için openssl ts -reply -in manifest.tsr -text komutu tokenin içini metin olarak gösterir.

Üç komut da OK dediyse elinizde bütün, zincire bağlı ve tarihli bir gün vardır. Panelin doğrulama raporu aynı üç kontrolü sizin için yapar; komutlar, panel olmadan da aynı sonuca ulaşabildiğinizi gösterir.

Doğrulama başarısızsa

Belirti	Olası sebep	Ne yaparsınız
1. komut FAILED	Dosya dışa aktarmadan sonra değişti ya da bozuldu	Panelden ya da SFTP kopyasından tekrar alın
2. komut tutmuyor	Önceki gün farklı bir dışa aktarmadan geliyor	İki günü aynı dışa aktarma ile alın
3. komut hata	Sertifika zinciri eksik ya da damga dosyası yanlış güne ait	ZIP'teki sertifika dosyasını kullanın, dizini kontrol edin

Dosyada gerçek bir bütünlük sorunu varsa bunu gizlemeyin; panelin doğrulama raporu ve SFTP kopyası ile karşılaştırın, sonucu not edin.

Neden önemli

Bir günün dosyasını bir kez açıp bu üç komutu çalıştırmak on dakika sürer. Sonrasında "kayıtlar imzalı" cümlesini ezberden değil, bilerek söylersiniz. Bu farkı denetçi de, bilirkişi de hisseder.

Kutunun kayıt mekanizmasını kutu sayfasında bulabilirsiniz; teknik sorularınız için iletişime geçin.