TgWitness / Belgeler

Belgeler / 07

Dışa aktarma ve doğrulama

Başka birinin doğrulayabileceği imzalı bir kaydı paylaşın.

Referansı saklayınİmzalı ZIP dosyasını dışa aktarAlıcı doğrular

İmzalar ve kontrol noktaları konusunda yeni misiniz? Örnek bir kaydı değiştirin ve hangi kontroller tarafından tespit edildiğini görün.

Bir kopyayı veri toplayıcıdan uzak tutmak mı istiyorsunuz? S3 kurulumu, Nesne Kilidi veya doğrulanmış kurtarma bölümlerine gidin.

Güvenilir bir kaynak olarak kalın

Çalışma alanının açık anahtar parmak izini toplayıcı dışında saklayın. Toplama işlemi sırasında, imzalı kontrol noktalarını başka bir yerde tutun veya bağımsız bir tanık kullanın. Bu referanslar, alıcının anahtarı ve önceki günlük sınırını kontrol etmesini sağlar.

İmzalı ZIP dosyasını indirin

"Dışa Aktar" seçeneğini açın ve imzalı bir kanıt ZIP dosyası oluşturun. Bu dosya, çalışma alanı günlüğünü ve imzalı bir dosya manifestosunu içerir. Panel filtreleri bu tam günlük dışa aktarımını sınırlamaz: paylaşmadan önce içeriği gözden geçirin.

Bağımsız HTML ve CSV indirmeleri, okuma ve analiz için kullanışlıdır. Doğrulanabilir orijinal belge olarak imzalı ZIP dosyasını saklayın; ayrı HTML veya CSV dosyasında bağımsız bir imza bulunmaz.

TgWitness'in güvenilir bir kopyasıyla doğrulayın

Yüklü proje ortamında, örnek parmak izini ve dosya yollarını değiştirin:

python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --checkpoint retained-checkpoint.json

Her iki referans da geçerli olduğunda, sonuçta key_pinned: true ve checkpoint_checked: true raporlanır. Doğrulama sonucunu orijinal arşivle birlikte saklayın. Saklanan kontrol noktası, dışa aktarım sınırında veya öncesinde olmalıdır.

Sonucu anlayın

  • Bütünlük: Kaydedilen geçmiş ve dışa aktarılan dosyalar, imzalarıyla eşleşir.
  • Önceki gözlem: Harici bir kontrol noktası, dışa aktarılan verileri daha önce saklanmış bir günlük önekiyle karşılaştırmanıza olanak tanır.
  • Uygulama: Kontrollü bir "gönderme → düzenleme → silme" testi, yakalanan kayıtlarla belirli olayları karşılaştırır.

Geçerli bir imza, her Telegram olayının ulaştığını, kaynağın doğruyu söylediğini veya toplayıcının saatinin doğru olduğunu kanıtlamaz.

S3 dış sunucu kopyasını kurun

Çalışma alanınızda, Dışa Aktarımlar → Site dışı kopya seçeneğini açın. Bu isteğe bağlı özellik, AWS S3 ve diğer S3 uyumlu hizmetlerle çalışır. Günlük bölümlerini, saklanan fotoğrafları ve dosyaları, zaman damgası yanıtlarıyla birlikte kontrol noktalarını ve tamamlanmış sohbet dışa aktarımlarını kopyalar. Her nesne, yüklenmeden önce toplayıcıda AES-256-GCM ile şifrelenir.

Çevrimiçi demoda, dosya yükleme özelliği devre dışı bırakılmış halde aynı kontrol öğeleri gösterilmektedir. Depolama kimlik bilgilerinizi yalnızca kendi çalışmakta olan çalışma alanınızda girin.

Tam kapsamlı site dışı kopyalama paneli: uç nokta, bölge, depo, erişim anahtarları, zamanlama, Nesne Kilidi ve kurtarma anahtarı denetimleri
Gelişmiş seçeneklerin de yer aldığı tam panel açılmış haldedir. Depolama kimlik bilgileri gösterilmemektedir.
Dışa Aktarma → Site dışı kopya bölümündeki depolama ayarları
AlanNe yazılmalı
Uç noktaDepolama hizmetinin URL'si; kova yolu veya kimlik bilgileri içermez. Kurgusal örnek: https://s3.example.invalid.
Bölgeİstifacınızın gerektirdiği bölge. Uygulamanın varsayılan ayarı us-east-1'dir.
BucketErişebileceğiniz mevcut bir depo. Kurgusal örnek: example-case-backup.
Bucket içindeki klasörNesne öneki; varsayılan değer tgwitness. Uygulama, bu çalışma alanının imza anahtarı parmak izinden türetilen bir öneki ekler.
Erişim anahtarı kimliği / Gizli erişim anahtarıHer iki depolama kimlik bilgisini de birlikte girin. Bu bilgiler çalışma alanı kasasına kaydedilir. Kaydedilen çifti korumak için sonraki kaydetme işlemlerinde her ikisini de boş bırakın.
Yol biçimli adreslerSağlayıcıya göre, etkinleştirildiğinde endpoint/bucket'yi, devre dışı bırakıldığında ise bucket.endpoint'yi kullanın.
Kopyalama aralığı1 ila 1.440 dakika arasında; varsayılan ayar 5 dakikadır. Zamanlanmış kopyalama işlemleri için uygulamanın çalışır durumda olması gerekir.
Object Lock saklama süresiObject Lock özelliğini destekleyen bir depolama kutusu için saklama süresi ve modu. Sıfır gün seçeneği, depolama kutusunun varsayılan saklama süresinin geçerli kalmasını sağlar.
  1. Hedef adresi ve kimlik bilgilerini girin. Hazırlık aşamasında “Tesis dışında bir kopya sakla” seçeneğinin işaretini kaldırın, ardından “Tesis dışında bir kopya kaydet” seçeneğini seçin.
  2. "Bağlantıyı Test Et" seçeneğini seçin. Bu işlem, şifrelenmiş bir test nesnesini yükler ve depolama yanıtını kontrol eder.
  3. "Şifreleme anahtarını indir" seçeneğini seçin. Bu dosyayı toplayıcıdan ayrı bir yerde saklayın; kurtarma işlemi için gereklidir.
  4. "Dışarıda bir kopya sakla" onay kutusunu işaretleyin ve tekrar kaydedin. Manuel bir işlem için "Şimdi kopyala"yı seçin veya zamanlamayı çalışır durumda bırakın.

Ne yapmaz Bir depolama kovası oluşturmaz. Uygulama durduğunda zamanlanmış yüklemeler de durur.

Saklama süresini ve kopyalama sürecini kontrol edin

"Diğer seçenekler" altından, saklama süresini seçin ve depolama alanınız Object Lock'u destekliyorsa GOVERNANCE veya COMPLIANCE'yi seçin. TgWitness, yüklenen bir nesnenin saklama modunu ve son tarihini geri okur. Durum raporu, onay, eksik saklama veya kontrol hatasını bildirir; yüklemenin başarılı olması tek başına saklamanın onaylandığı anlamına gelmez.

Panel, son geçişi, nesne sayısını, aktarılan bayt sayısını, kopyalanan günlük sınırını ve varsa hataları bildirir. Eksik veya değiştirilmiş yerel ortamlar bildirilir ve bir sonraki geçişte yeniden denenir. Bu ortamdan sonraki dosyalar, kontrol noktaları ve kuyrukta bekleyen dışa aktarımlar yine de kopyalanabilir.

Yüklemeler, çalışma alanının Direct, SOCKS5 veya HTTP yolunu kullanır. MTProxy üzerinden S3 kopyalama kullanılamaz; uygulama doğrudan bağlantıya geri dönmez.

Ne yapmaz Yükleme kabul edildi diye, sağlayıcının Object Lock'u uygulamasını zorunlu kılmaz.

Geri yükleme anahtarını ayrı bir yerde saklayın

İndirilen JSON dosyası, şifre çözme anahtarını, hedef ayarlarını, çalışma alanı nesnesi önekini ve imza anahtarı parmak izini içerir. S3 erişim kimlik bilgilerini içermez: kurtarma işlemi için, depoya okuma erişimi olan ayrı kimlik bilgileri gereklidir.

Uç noktayı, depolama kovasını veya klasör önekini değiştirirseniz, hedef ayarlarının uyumlu olması için anahtar dosyasını yeniden indirin. Uygulama, yerel olarak saklanan günlüğün, dosyaların ve kontrol noktalarının yeni bir kopyasını yeni hedefte başlatır. Tamamlanmış sohbet dışa aktarımları, yerel yükleme kuyruğundan zaten kaldırılmış olsa bile önceki hedeflerinde kalır.

Ne yapmaz Dışa aktarılan anahtar olmadan kopyanın şifresi çözülmez. Depolama erişim kimlik bilgileri bu anahtarın yerini alamaz.

Başka bir makinede geri yükleme ve doğrulama

Güvenilir bir TgWitness kurulumu, indirilen anahtar JSON dosyası, okuma erişimine sahip depolama kimlik bilgileri ve boş bir çıktı dizini kullanın. Aşağıdaki hayali kimlik bilgisi yer tutucularını değiştirin.

Windows PowerShell

$env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY'
$env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY'
python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence

Linux / macOS

export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY'
export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY'
python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence

İndirilen dosyalar ve şifresi çözülmüş nesneler, tüm günlük, saklanan kontrol noktaları ile korunmuş medya hash değerleri ve boyutları kontrol edilirken özel geçici depolama alanında tutulur. Güvenli olmayan yollar, çakışan günlük segmentleri ve kontrol noktasından daha kısa olan günlükler reddedilir. Doğrulama başarısız olursa, geri yüklenen dosyalar yayınlanmaz.

Kurtarma işlemi başarılı olursa, kopyada bulunan içerik için events.jsonl, media/, checkpoints/ ve exports/ değerleri elde edilir. Kurtarılan içerikle birlikte komutun JSON sonucunu da saklayın.

Ne yapmaz Bu araç, günlüğe hiç ulaşmamış gözlemleri yeniden oluşturmaz veya bağımsız olarak saklanan bir kontrol noktası ya da tanığın yerini almaz.