TgWitness / Belgeler

Neler test edildi →

Bu sayfanın bazı bölümleri hâlâ İngilizce'dir: İngilizce orijinal metin, çevrildikten sonra değiştirilmiştir.

Referans / Kanıt

Telegram · Kanıt formatı

İmzalı ZIP dosyasının içeriği, kayıt türleri, işlem makbuzları, kullanıcı profilleri, site dışı kopyalar ve çevrimdışı doğrulama.

TgWitness / Belgeler

Kanıt ve doğrulama

TgWitness, hesap tarafından görülebilen Telegram gözlemlerini imzalı bir günlüğe kaydeder. Alıcılar, kaydedilen kayıtları, ekleri ve raporları güvenilir bir toplayıcı anahtarıyla doğrulayabilir, son kayıt için üçüncü bir taraftan gelen harici zamanı kontrol edebilir ve günlüğü daha önce sakladıkları bir kontrol noktasıyla karşılaştırabilir. Bu sayfada, devir için saklanması gereken formatlar, kontroller ve materyaller açıklanmaktadır.

Kullanıcılar, Windows'ta VERIFY.cmd ile başlayabilir: program, orijinal ZIP dosyasını ve bağımsız olarak elde edilmiş anahtar parmak izini ister, açıklayıcı bir sonuç gösterir ve ayrı bir doğrulama transkriptini kaydeder. Kurulum ve güven sınırları için doğrulama başlatıcılarına ve taşınabilir çalışma zamanı 'e bakınız.

Bu sayfada

Neler imzalanır?#

Materyal Koruma Neler saklanmalı
Operasyonel olaylar dahil olmak üzere her günlük kaydı Her olay için bir SHA-256 zinciri ve bir Ed25519 imzası Orijinal events.jsonl, güvenilir anahtar parmak izi ve saklanan kontrol noktası
Kanıt ZIP dosyasının içeriği manifest.sig, içerik dosyalarının hash değerlerini listeleyen kanonik manifestoyu imzalar Manifestosu ve imzası dahil olmak üzere eksiksiz ZIP dosyası
Ekler korunur İmzalı bir media.saved olayındaki SHA-256 ve bayt sayısı; imzalı ZIP manifestosundaki dosya hash değeri Doğrulanmış ZIP dosyasının içindeki orijinal baytlar
Kontrol Noktası Günlük uzunluğu, başlık hash değeri, açık anahtar ve oluşturulma zamanı üzerinde Ed25519 imzası Tartışmalı bir değişiklikten önce saklanan bağımsız bir kopya
Çalıştırma makbuzu Toplayıcı sürümü, kaynak dosya hash değerleri ve başlangıç ayarlarının imzalı kaydı; bu bilgiler process.started dosyasına da dahil edilmiştir. Seçilen doğrulama modu için makbuz, ilgili günlük kaydı ve ortam kanıtları
Okunabilir raporlar: report.html ve bileşenleri, report.json, report.pdf, chat.pdf Her dosyanın içeriği üzerinde bir Ed25519 mührü bulunur; PDF ayrıca standart bir PDF imzası da taşır (bkz. Okunabilir raporlar ) Alınan dosya ve güvenilir anahtar parmak izi; belgede açıklanan ZIP dosyası
Bağımsız CSV Tek başına kriptografik imza yoktur; olay hash'leri tek başına yetersizdir Bütünlük kontrolü için doğrulanmış ZIP dosyasının içindeki metni aynen kullanın
Tarayıcı tarafından oluşturulan ekran görüntüleri, çıktılar veya PDF dosyaları Türetilmiş sürümde TgWitness imzası bulunmamaktadır. Orijinal doğrulanmış paketi saklayın ve türev sürümün nasıl oluşturulduğunu belgelendirin

Toplayıcı, her dışa aktarım formatını oluşturmadan önce günlük imzalarını doğrular. Okunabilir HTML ve PDF raporları kendi mühürlerini taşır; bağımsız CSV dosyası, imzalı bir ZIP dosyasının parçası olarak kontrol edilir. Ek baytlarını ve manifestosunu korumak için ZIP dosyasını koruyun ve günlüğü önceki bir sınırla karşılaştırmak için ayrı bir kontrol noktası oluşturun.

Biçimler ve doğrulama yolları#

Toplama modu ve çıktı biçimi farklı sorulara yanıt verir. Mod, toplama ve ortam kanıtlarını sağlar; her biçim, aşağıdaki kontrollerle o kaydın bir kısmını korur veya sunar.

Çıktı Doğrulama ve kullanım
Kanıt ZIP Kanonik olaylar, imzalı manifest, kapsama alanı, saklama kayıtları, ekler ve mevcut harici makbuzlar; arşivi ve seçilen edinim modunu kontrol edin.
ASiC-E konteyneri mimetype girişi ve META-INF/ASiCManifest.xml dosyası içeren, ETSI ASiC-E konteyneri (EN 319 162-1) olarak ZIP formatındaki kanıt dosyası; çalışma alanının kendi sertifikasıyla B-B seviyesinde veya zaman damgası etkin olduğunda B-T seviyesinde CAdES ile imzalanmış olmalıdır. EU DSS gibi doğrulayıcılar, biçimi ve bütünlüğü kontrol eder ve sertifika kendi kendine verilmiş olduğundan herhangi bir güven bağlantısı olmadığını bildirir. Varsayılan ayarlara sahip EU DSS 6.3, 1000'den fazla dosya içeren bir konteyneri reddeder ("Çok fazla dosya algılandı"). verify.py, Ed25519 manifestosunu ve listelenen her dosyayı, META-INF/ASiCManifest.xml dosyasındaki ve eklenmiş bir ASiCManifestNNN.xml veya ASiCEvidenceRecordManifest.xml dosyasındaki SHA-256 değerlerini kontrol eder ve bunların hiçbirinin kapsamadığı bir META-INF/ girişi olması durumunda hata verir. CAdES imzalarını kontrol etmez ve bunu belirtir.
HTML ve JSON raporları Kaynak referansları içeren, ayrı ayrı mühürlenmiş görünümler; bunlar ZIP manifestosunda da listelenmiştir. Kaydedilen sayıları, günlük olay türlerini özetler.
PDF raporları Ed25519 mührü ve bayt aralığı B-B veya zaman damgası özelliği etkin olduğunda B-T üzerinde bir PAdES temel PDF imzası. TgWitness doğrulayıcısı, güvenilir Ed25519 anahtarını kullanır; görüntüleyicinin sertifika güvenilirliği göstergesi ise ayrı bir kontroldür.
CSV ZIP manifestosu kapsamındaki bir elektronik tablo görünümü. Formül kaçış karakterleri elektronik tablonun kullanımını korur; orijinal imzalı metin günlükte kalır.
JSONL Ek referansları da içeren imzalı olay kayıtları. Kanıt ZIP dosyası ayrıca korunmuş ek baytlarını da içerir.
Sohbet dışa aktarma ve masaüstü uyumlu görünümler Geçmiş verilerinin alınması ve mevcut yönetici günlüğü kayıtları, istenen görüntüleme biçimi ve imzalı arşiv ile birlikte. Canlı izlemenin kaydedilmiş sürümleri ayrı bir veri toplama yoludur.
Medya ve yalnızca hash içeren kayıtlar Kaydedilen baytlar, SHA-256 ve mesaj referanslarıyla karşılaştırılarak kontrol edilir. Yalnızca hash içeren toplama işlemi, dosya baytlarıyla daha sonra karşılaştırılmak üzere mevcut hash meta verilerini korur.
STIX/MISP ve kişi profilleri Kaynağa bağlı çıkarılmış gözlemler, hesap kimlikleri ve analitik eşleşmeler. Profil imzaları ve kayıt hash'leri orijinal kanıtlarla karşılaştırılarak kontrol edilebilir; avatar önbelleği kökeni ayrı olarak etiketlenir.
Devir teslim özeti İmzalı ifşa kuralları, değiştirilmemiş kayıtlar ve orijinal hash değerlerini/imzaları koruyan işaretlenmiş küçültülmüş kayıtlar. Gizlenmiş alanlar gerektiren bir karşılaştırma için saklanan orijinali kullanın.
Tanık ve zaman makbuzları Daha önceki günlük sınırları, süreklilik ve doğrulanmış bireysel zaman iddiaları. Bunlar, toplama ve arşiv kontrollerine eşlik eder.
Şifre korumalı teslimat Aktarım sırasında ekli paketi korur. .tgwpw, kimlik doğrulamalı son kayıt dahil olmak üzere AES-GCM kimlik doğrulamalı şifreleme kullanır; ekli günlük, imzalarını ve edinim makbuzlarını saklar.

Bir çıktı veya ekran görüntüsü, imzalanmış materyalin bir sunumudur. Rapor kimliği, anahtar parmak izi ve QR referansı, doğrulama amacıyla orijinal dosyanın bulunmasına yardımcı olur. Saklama beyanları, sağlanan denetçi ve aktarım bilgilerini kaydeder; doğrulayıcı sonuçları ve edinim makbuzları ayrı kanıtlar olarak saklanır.

Dış imzalar#

Bir imza, TgWitness’in hiçbir zaman elinde bulundurmadığı bir anahtardan da gelebilir; örneğin bir araştırmacının onaylı elektronik imzası veya bir kuruluşun mührü gibi. Dışa Aktarımlarda, şifre içermeyen hazır bir dışa aktarım üzerindeki harici imza, imzalanacak baytları sağlar: bir ASiC-E konteyneri için her dosyanın SHA-256 değerini içeren yeni bir META-INF/ASiCManifestNNN.xml ASiC-E konteyneri için her dosyanın SHA-256 değerini içeren bir liste veya ZIP dosyası manifest.json . İmzalayan, CMS (CAdES) .p7sdöndürür; bu imza, ayrı olabilir veya içeriğe gömülü olabilir.

TgWitness, imzanın tam olarak bu baytları kapsadığını kontrol eder ve imzalayanın sertifikasıyla (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448) doğrulama yapar. Zincir, yalnızca operatörün sağladığı kök sertifikalarla karşılaştırılarak kontrol edilir; iptal durumu, güvenilir listeler ve nitelikli durum kontrol edilmez. Panel, her imza için bir durum gösterir: imza bekleniyor, eklenmiş ve kontrol edilmemiş, doğrulanmış, algoritma desteklenmiyor, imza geçersiz, imzalanmış baytlar eşleşmiyor veya sertifika sağlanan bir kök sertifikaya zincirlenmemiş. Baytlar dağıtıldıktan sonra dışa aktarımın değiştirilmesi, tüm imzalarını "imzalanmış baytlar eşleşmiyor" durumuna getirir.

“İmzalı olarak indir” seçeneği, imzaları ve bunlara ait manifestoları META-INF ASiC-E konteynerine ekler. ZIP dosyası söz konusu olduğunda, değiştirilmemiş ZIP dosyasını, .p7s dosyaları ve SIGNATURES.txt dış ZIP dosyasına yerleştirir. Geçersiz imzalar ve diğer baytların üzerine yazılmış imzalar dışarıda bırakılır. TgWitness algoritmasının doğrulayamadığı bir imza dahil edilir; panel, ZIP dosyası için olduğu gibi SIGNATURES.txt ZIP dosyası için olduğu gibi.

İmzalı sohbet resimleri#

Resim önizlemesindeki imzalı ZIP dosyasını indirdiğinizde sayfalar PNG olarak kaydedilir, pages.sig.json ve README.txt. Her sayfa, gösterdiği günlük kayıt numaraları, sohbet, işleme süresi, çalışma alanı anahtarının parmak izi ve bunu doğrulayan komutla sona erer. Panel, yalnızca her sayfanın SHA-256 değerini ve kayıt numaralarını gönderir; sunucu, kayıtların sohbete ait olduğunu doğrular, beyanı (tgwitness-image-attestation-v1) çalışma alanı anahtarıyla imzalar ve imzalamayı export.image_attested.

python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip

Doğrulayıcı, imzayı kontrol eder, her bir PNG dosyasını imzalanmış bir sayfayla eşleştirir ve anahtar parmak izini bildirir. --fingerprint imzalayanı, göndericiden bağımsız olarak elde edilen bir parmak iziyle karşılaştırır. --evidence Aynı çalışma alanına ait imzalı kanıt ZIP dosyasını okur ve görüntülerin her bir kaydının aynı hash değeriyle mevcut olmasını şart koşar. Değiştirilmiş bir piksel, değiştirilmiş bir ifade veya başka bir anahtar, kontrolün başarısız olmasına neden olur. Görüntüler, TgWitness'in kendi düzeninde kaydedilmiş kayıtları gösterir; Telegram'ın herhangi birine ne gösterdiğini göstermez.

Sohbet dışa aktarımlarının karşılaştırılması#

İmzalanmış iki sohbet dışa aktarım ZIP dosyasını, bağımsız olarak saklanan imzalayıcı parmak izleriyle doğrulayın ve karşılaştırın:

python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256

--require ve --require-tier seçenekleri, --compare seçeneğiyle birlikte kullanıldığında reddedilir; her bir arşivin gerekli profilini, kendi doğrulama işlemiyle kontrol edin.

Her iki arşiv de aynı sayısal hesap ve sohbet kimliklerini kaydettiğinde, kayıtlar mesaj kimliğine göre eşleştirilir. Değişmemiş, kaydedilen tam JSON kaydının eşitliği anlamına gelir: tam metin, yazar, tarihler, yanıt hedefi, iç içe geçmiş meta veriler ve bilinmeyen alanların tümü dahildir. JSON nesnesindeki anahtar sırası önemli değildir; eksik alanlar, null değerler, değer türleri ve dizi sırası önemlidir. 300 karakterlik önizleme yalnızca görüntüleme amaçlıdır. Değiştirilen girdiler, önizlemede görünmeyen değişiklikler de dahil olmak üzere, farklılık gösteren üst düzey changed_fields'yi belirtir. Eşleştirme sırasında, yinelenen mesaj kimlikleri birbirlerinin üzerine yazılmak yerine reddedilir.

Bir fark, değiştirilmiş bir görüntüleme adı, görüntüleme sayısı, toplama açıklaması veya diğer gözlem meta verileri olabilir. Telegram düzenlemeleri kendi düzenleme olayları olarak görünür ve her arşivin doğrulaması, o arşivin bozulmamış olup olmadığını gösterir. Ayrıştırılmamış kayıtlar karşılaştırmada kalır ve kaydedilmiş temsil biçimlerine göre karşılaştırılır.

Farklı veya eksik hesap/sohbet kimlikleri için araç, gönderen, tam metin, dosya hash'i, medya türü ve beş saniyelik zaman toleransı kullanarak aday eşleşmeleri bulur ve bunları Değişmemiş yerine Eşleşti olarak raporlar. Ayrıştırılmamış kayıtlar eşleşmemiş olarak kalır. Eşleştirilmiş kayıtlardaki farklılıklar, içerik modunda da dahil olmak üzere changed altında listelenir. --json seçeneği ile matched, aday çiftleri sayar ve unchanged, tam olarak kaydedilmiş kayıtları eşit olan çiftleri sayar. Mevcut changed_fields ve tamsayı unchanged çıktıları, önceki karşılaştırma sonuçlarıyla uyumlu kalır. Arşiv biçimi ve imza doğrulaması değişmemiştir.

Soruşturma devri#

  1. Vaka referansını, operatörü, sayısal Telegram hesap kimliğini, seçilen kaynakları, toplama politikasını ve toplama süresini vaka notlarınıza kaydedin. TgWitness, gözlemleri korur ve Case Board'da kaynağa bağlı notları ve koleksiyonları destekler. Aktarım ve muhafaza kayıtlarını vaka materyallerinizle birlikte saklayın. Canlı kabul prosedürüyle planlanan toplama ayarlarını kontrol edin.
  2. Çalışma alanının açık anahtar parmak izini, dışa aktarımlarına güvenmeden önce bağımsız olarak saklayın. Kanıt modunu açık tutun (varsayılan ayar), böylece kontrol noktaları RFC 3161 ve OpenTimestamps makbuzlarını alabilsin. Toplama işlemi sırasında imzalanmış kontrol noktalarını toplayıcı dışında kaydedin. Kesintileri ve hesabın görünürlük sınırlarını kaydedin.
  3. İmzalı bir ZIP dosyası dışa aktarın ve imzalı çalıştırma makbuzunu saklayın. Dışa aktarılan günlük sınırında veya öncesinde bir kontrol noktası kullanın. Daha sonraki bir kontrol noktası, daha önceki bir dışa aktarmayı çok kısa olduğu gerekçesiyle doğru bir şekilde reddedebilir. Dışa aktarmalar, panel filtrelerinden bağımsız olarak tam çalışma alanı günlüğünü içerir; paylaşmadan önce materyali gözden geçirin.
  4. Alıcının, ZIP dosyasını güvenilir bir doğrulayıcı kopyası, bağımsız olarak sağlanan parmak izi ve ayrı olarak elde edilen zaman damgası otoritesinin kök sertifikası ile doğrulamasını sağlayın. Python ortamı etkin olan güvenilir bir çalışma ortamından:

    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence

    Parmak izi ve son kaydın doğrulanmış zaman damgası, kanıt için asgari şartları karşılar; aksi takdirde --require evidence, kod 2 ile sonlanır. Kontrol noktası, toplayıcı anahtarıyla imzalandığı için destekleyici bir kontroldür. Başarılı çıktı, her iki girdi de sağlandığında ve kabul edildiğinde key_pinned: true ve checkpoint_checked: true raporlar. Doğrulama sonucunu koruyun.

    For a handover requiring the final exported record to be witnessed, use
    `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
    This refuses an export with an unwitnessed tail. Add
    `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
    witness posts as external time. See the
    [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
    
    1. Arşivin SHA-256 değerini, dışa aktarma sınırını, aktarım tarihini, göndereni ve alıcıyı saklama kaydınızda kaydedin. Orijinal paketi olduğu gibi koruyun ve kopyalar üzerinde çalışın. Uygulamanın özel veri dizini yerine kanıt dosyalarını paylaşın; bu dizin aynı zamanda hesap oturumlarını ve imzalama gizli anahtarlarını da içerir. Aktarım için, parola korumalı AES-256 ZIP dosyasını veya daha güvenli olan .tgwpw konteynerini seçin. ZIP, WinZip’in düşük maliyetli parola türetme yöntemini kullanır; uzun ve rastgele bir parola cümlesi kullanın. .tgwpw, scrypt ve AES-256-GCM kullanır ve bağımsız doğrulayıcının unseal-password komutuyla açılır. Parola saklanmaz ve yalnızca gizliliği korur; alıcı, arşivi şifresini çözer ve içindeki imzalanmış dışa aktarmayı doğrular; bu dosya değiştirilmemiştir.
    2. Kanıt modu dışında bir kontrol noktasına zaman damgası eklemek için RFC 3161 prosedürünü izleyin ve isteği, kontrol noktasını, güvenilir CA bilgilerini ve doğrulanmış yetki yanıtını saklayın. Yalnızca bir istek hazırlamak zaman damgası elde etmez.

.tgwpw için, bağımsız olarak elde edilmiş bir doğrulayıcı kullanın ve orijinal uzantıya sahip yeni bir çıktı dosyası seçin: python verify.py unseal-password export.tgwpw --out evidence.zip. Komut, şifreyi sorar; --password-stdin, otomasyon için tek bir satır okur. Mevcut bir dosyanın üzerine asla yazmaz ve tüm kayıtların doğrulanmasından sonra düz metni yayınlar. Ardından, şifresi çözülmüş dosya üzerinde normal imza doğrulaması yapın. Konteyner, scrypt (N=131072, r=8, p=1, 16 baytlık tuz; yaklaşık 128 MiB RAM) ve 1 MiB'lik kayıtlar ile doğrulanmış bir son kayıt içeren AES-256-GCM kullanır. Şifrelenmiş bir meta veri kaydı, iç dosya adını saklar; böylece indirilen konteynerlerin adı değiştirilebilir.

Başarılı bir doğrulama, güvenilir toplayıcı anahtarı ve korunan sınır ile ilgili bütünlüğü teyit eder. Gerçekleştirilen kontrollerle ilgili güven varsayımları ve doğrulama sonuçları için doğrulama kapsamına bakınız.

Devir teslim özeti#

İmzalı bir ZIP dosyası, çalışma alanının tüm günlüğünü içerir. Bir mahkeme, avukat veya ihbar birimi sadece bazı sohbetlere, belirli bir döneme veya belirli kişilere ihtiyaç duyduğunda, Dışa Aktar → Devir Çıkarımı seçeneği, seçilen ifşa kurallarına göre küçültülmüş bir kopya (tgwitness-handover-v1) hazırlar. Operatör, amacı belirtir ve sohbetleri, isteğe bağlı bir dönemi (UTC), özetin ilgili olduğu kişileri, diğerlerine ne olacağını (gösterilecek, P01, P02… takma adlarıyla değiştirilecek mi yoksa dışarıda bırakılacak mı), hangi mesaj metinlerinin kalacağını, hangi eklerin ve profil fotoğraflarının dahil edileceğini ve metinlerdeki telefon numaraları ile e-posta adreslerinin maskelenip maskelenmeyeceğini belirler. Amaç ve bu kurallar, imzalı manifestoda ve raporda yer alır; günlük, içeriği değil, dosyayı hazırlayan erişim bilgisi ve dosyanın SHA-256 değeriyle birlikte handover.exported kaydını tutar.

verify.py, bir alıntıyı iki şekilde kontrol eder. Değişmemiş olarak gösterilen bir kayıt tam olarak doğrulanır: içeriği, hash değeri, Ed25519 imzası ve dahil edilen bir önceki kayda olan bağlantısı açısından. Kısaltılmış bir kayıt, orijinal hash değerini ve imzayı korur; bu sayede imza hâlâ doğrulanır, ancak gizlenen alanlar bu kayıttan yeniden hesaplanamaz; kayıt, nelerin gizlendiğini belirtir ve rapor bunu işaretler. Hesap genelindeki hizmet kayıtları (başlangıçlar ve sonlandırmalar, kapsama boşlukları, bağlantı, ağ ve depolama bildirimleri, kapsam ve ayar değişiklikleri) yalnızca türlerine göre listelenen alanları tutar: içlerindeki sohbet listeleri seçilen sohbetlere göre kısaltılır ve toplamları yeniden hesaplanır; seçim dışındaki bir sohbetteki canlı-sondalama boşluğu, o sohbeti, mesaj sayılarını ve tanık hesabını kaybettirir; seçilen bir sondalama sohbetinde, tanık hesabı, herkesin gösterilmediği veya seçilen kişilerden biri olmadığı sürece takma adıyla değiştirilir. Manifest, günlük uzunluğunu ve başlığını, o başlığın üzerinde toplayıcının imzasıyla belirtir ve dışarıda bırakılan kayıtların sayısını verir; coverage.json, seçilen sohbetleri tanımlar. Yeni özetler ayrıca proofs.jsonl dosyasını da içerir: dahil edilen her kayıt ve günlük başlığı için, kayıtın orijinal hash değerinden imzalı manifestte belirtilen günlük köküne giden Merkle yolu. verify.py, her bir yolu kontrol eder; böylece her kaydın, tam günlük olmadan da o uzunluk ve başlığa sahip aynı günlüğe ait olduğu gösterilir; 100 mesajlık bir özet, günlük boyutu ne olursa olsun yaklaşık bir saniye içinde kontrol edilir. --range=CHAT:FROM-TO, bir sohbetin FROM ile TO arasındaki mesajların özet içinde olduğunu ek olarak doğrular ve bunlar için kaç kayıt kontrol ettiğini bildirir. Dosya adları içindeki isimler algılanmaz. Paylaşmadan önce son dosyaları gözden geçirin: serbest metin, dosya adları ve seçilen ekler hâlâ kişilerin kimliğini ortaya çıkarabilir. İmzalı ZIP dosyasının tamamını saklayın: özet bir ifşadır, yerine geçen bir şey değildir.

Okunabilir raporlar#

İmzalı kanıtlar, devir teslim ve sohbet ZIP dosyaları, seçilen rapor dilinde okunabilir HTML ve JSON raporları ile gerekli yazı tipleri mevcut olduğunda PDF dosyalarını içerir. Her bir rapor, çalışma alanının Ed25519 anahtarıyla mühürlenir ve ayrı olarak doğrulanabilir: python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP].

  • report.html / chat.html: mühürleme ifadesi (tgwitness-report-seal-v1) dosyayı kapatır ve önündeki her baytın SHA-256'sini imzalar. Uzun günlükler ve sohbetler, yapılandırılabilir boyutta parçalara bölünür (Rapor ayarları, 500 ila 100.000 kayıt; varsayılan olarak 5.000): records/records-0001.html veya messages/messages-0001.html; her biri numarası, aralığı ve toplamıyla mühürlenir ve imzalı manifestoda SHA-256 ile birlikte listelenir. Toplayıcı kalp atışları dizileri, Rapor ayarlarında tek tek listelenmedikçe tek bir satır olarak gösterilir.
  • report.json (tgwitness-report-json-v1, anahtarlar format, report, seal): mühür, report'nin kanonik JSON'sinin SHA-256'sini imzalar; böylece veriler dava sistemleri ve komut dosyaları tarafından okunabilir ve imzalı dosya bütünlüğünü korurken bunlardan veri koruma amacıyla bir seçim yapılabilir.
  • report.pdf / chat.pdf: yazdırma ve arşivleme amaçlı resmi bir belge; aynı baytlar üzerinde iki kez imzalanmış, imza değeri hariç dosyanın tamamı (/ByteRange). Standart PDF imzası PAdES baseline'dır (ETSI EN 319 142-1, /SubFilter /ETSI.CAdES.detached: SHA-256 ve ECDSA P-256 içeren CMS, imza sertifikası v2, CMS imza zamanı yok; beyan edilen zaman /M) B-B seviyesinde veya zaman damgası etkin olduğunda CMS içinde RFC 3161 imza zaman damgası bulunan B-T seviyesindedir ve Telegram dışındaki istekler için yol üzerinden bir zaman damgası yetkilisi yanıt verir. Çalışma alanı kasasında saklanan, kendi kendine verilen bir belge imzalama sertifikası kullanır; bu sertifikanın konu seri numarası, Ed25519 anahtar parmak izidir. Ed25519 mührü, CMS içinde imzasız öznitelik 2.25.240684792623320047764573196045913242332 olarak dolaşır ve sertifikanın SHA-256 değerini "content": "pdf-byte-range", böylece Ed25519 anahtarı sertifikayı doğrular. Sertifika nitelikli değildir: bir PDF okuyucu, sertifika güvenilir hale gelene kadar imzayı geçerli, imzalayanı ise bilinmeyen veya güvenilmez olarak gösterir; bunun yerine Ed25519 parmak izini karşılaştırın. Çince, Japonca ve Korece PDF'ler için sunucuda (veya TGWITNESS_FONT_DIR); yazı tipi yoksa ZIP dosyası yalnızca HTML ve JSON raporlarını içerir.
  • report.en.html, report.en.pdf / chat.en.html, chat.en.pdf: rapor dili İngilizce olmadığında aynı raporun İngilizce orijinali; aynı şekilde mühürlenir ve imzalanır ve imzalı manifestte report.original altında belirtilir. Seçilen dildeki rapor, İngilizce orijinalin onaylı veya yeminli bir çeviriyle birlikte sunulması önerisiyle başlar; bkz. Raporları mahkeme için çevirmek.

Bir kanalda veya süper grupta Telegram , mesajları 1, 2, 3… şeklinde sıralar. Bir sohbet dışa aktarımında ilk ve son numara, mevcut olanların sayısı ve eksik numaraların her bir dizisi message-ids.json , manifest ve chat.json başlığında listelenir ve her bir boşluk, transkriptte bulunduğu yerde işaretlenir. verify.py , chat.json 'den itibaren numaraları yeniden sayar. Eksik bir numara, Telegram 'nin geri döndürmediği bir mesajdır (dışa aktarımdan önce silinmiş veya hesap tarafından görülemiyor olabilir); özel sohbetlerde ve temel gruplarda numaralar hesabın tüm sohbetleri arasında paylaşılır ve boşluklar sayılmaz.

Geçmişi okuduktan sonra, dışa aktarma işlemi Telegram’dan eksik olan her numarayı tekrar, numaraya göre (channels.getMessages, ilk mesajın altındaki 1.000 numara dahil olmak üzere en fazla 10.000 numara; daha fazla boşluk varsa tüm boşluklara eşit olarak dağıtılır). Sonuç, message-ids.json dosyasında ve raporda yer alır. Boş bir yanıt, yeniden kontrol sırasında numaranın bu hesap için kullanılamadığını kaydeder; nedeni belirtilmez. Yeniden kontrol sırasında döndürülen bir mesaj, dışa aktarıma eklenir ve found_on_recheck.

Gözlem çalışma alanı, sohbet mesajlarının silindiğini, yeniden kontrol edildiğinde eksik olduğunu veya düzenlendiğini tespit ettiğinde, sohbet dışa aktarma işlemi şunları ekler journal-changes.jsonl: bu günlük kayıtlarını, her kaydedilmiş sürümü ve bildirimi ekler; her birine günlükte aldığı hash ve Ed25519 imzası eklenir. verify.py Her kaydın hash değerini yeniden hesaplar, imzasını dışa aktarım anahtarıyla karşılaştırır ve sayıyı imzalı manifestoyla karşılaştırır; kanıt dışa aktarımı, eksiksiz hash zincirini içerir. Rapor, bu mesajları Silinenler ve Önceki Sürümler başlıkları altında listeler.

Her rapor Özetle ile başlar: bir paragraf, ardından materyalin neyi gösterdiği ve kaydın neleri içerdiği. Tarayıcı, sayfanın kendisini değil, mührün imzasını doğruladığında sayfanın kendi mühür damgası kehribar rengine döner: bir tarayıcı, bir sayfaya kendi baytlarını vermez. Yalnızca okuyucu dosyayı sayfanın sonundaki kontrol alanına sürüklediğinde ve her bayt eşleştiğinde yeşile döner; ancak bu, gösterilen sayfanın o dosya olması durumunda geçerlidir; aksi takdirde kırmızıya döner.

Her raporda programın adı tam olarak belirtilmelidir: toplayıcı bir checkout'tan çalıştırıldığında veya yükleyici kurulduğunda TGWITNESS_COMMITve kaynak dosyalarının SHA-256 değerleri (source_tree_sha256, yolun kanonik JSON'u → her birin SHA-256'sı .py, .js, .css, .html ve .svg dosyanın SHA-256 değeri), dosyalar değiştirilmedikçe o commit'in checkout'u ile yeniden üretilebilir. Telegram istemcisi, kütüphanesi, API katmanı ve veri merkezi ile adlandırılır. Gözlem başladığında ve bir sohbet dışa aktarma işlemi başladığında ve bittiğinde, toplayıcı Telegram'dan saatini ister (updates.getState, tam saniye) ve Telegram'ın saatinden toplayıcının saatini çıkararak, gidiş-dönüş süresinden kaynaklanan belirsizlikle birlikte kaydeder; raporlar bu ölçümleri "Zincir Sorumluluğu" başlığı altında gösterir. Bir sohbet dışa aktarma işlemi, mesajların tarihlerinin yanı sıra geçmişi ne zaman okuduğunu da kaydeder.

Çevrimdışı rapor görüntüleyici ve arşiv kılavuzu#

chat.html veya report.html dosyasını açmadan önce ZIP dosyasının tamamını çıkarın. Görüntüleyici, sunucu gerektirmeden arama, filtreler, katılımcılar, göstergeler, kayıt ayrıntıları ve JSON/CSV seçimleri sunar. viewer/ ve media/ dosyalarını raporun yanında bulundurun. Seçimler türevlerdir: bunları imzalı arşivle karşılaştırmak için verify.py SELECTION.json --evidence ARCHIVE.zip dosyasını kullanın. Doğrulayıcı, rapor kimliğini, imzalama anahtarını, arşiv sınırını ve seçilen her bir öğeyi kontrol eder; düzenlenmiş, eksik ve yinelenen öğeler kabul edilmez. Seçim notları ve oluşturulma zamanı, imzalanmamış meta veriler olarak kalır.

Mesaj numarası boşlukları yalnızca tam, filtrelenmemiş ve artan sıralı sohbet akışında gösterilir. Bir kategorinin gizlenmesi veya bir veri bloğunun yüklenememesi, atlanan bir satırı eksik bir mesajın kanıtı haline getirmemelidir. Arama vurgulamaları, HTML kaçış kodlamasından önce düz metin üzerinde çalışır ve literal işaretlemeyi korur.

Tarayıcı, manifest imzalarını, rapor kimliğini ve anahtarı ile listelenen tüm dosya hash'lerini kontrol eder. Belirsiz veya hatalı biçimlendirilmiş ZIP yapılarını, yinelenen adları ve güvenli olmayan yolları reddeder; ayrıca dosyaları 256 MiB ile sınırlar ve beyan edilen toplam içerik boyutunu 4 GiB ile sınırlar. Daha büyük arşivler için bağımsız doğrulayıcıyı kullanın. Bu tarayıcı kontrolü, doğrulayıcının günlük zincirleri ve veri anlambilimi üzerindeki kontrollerini tamamlar.

README.txt, başlangıç kılavuzu, uyumlu dosya envanteri, doğrulama talimatları ve rapor dilinde veri formatı notlarını içerir; bunu tam bir İngilizce kılavuz izler. SHA256SUMS, kendisi, manifest.json ve manifest.sig hariç olmak üzere içinde listelenen dosyaları kapsar; imzalı manifest ayrıca SHA256SUMS'yi de kapsar. Orijinal ZIP dosyasını değiştirmeden koruyun ve çalışma dosyalarını çıkarılan klasörün dışına kaydedin. PDF raporları, bölüm yer imlerini ve sonraki sayfalarda vaka/rapor tanımlamalarını içerir.

Dışa aktarım anındaki sohbet#

Bir sohbet dışa aktarma işlemi, dışa aktarma başladığında Telegram'nin sohbet hakkında söylediklerini kaydeder: Telegram'nin kendi etiketleri (scam, fake, restricted ve gerekçeleri, verified), kullanıcı adları, açıklama, üye ve yönetici sayıları, bağlantılı tartışma, içerik koruması, yeni üyelerin önceki mesajları görüp görmediği ve bu hesabın geçmişi hangi mesajdan itibaren görebildiği (available_min_id), sohbetin oluşturulduğu tarihteki 1 numaralı mesajın tarihi ve sohbet fotoğrafının SHA-256 numarası (media/'de kaydedilmiştir). Sohbetteki dışa aktaran hesabın konumunu kaydeder: rol, katılım tarihi, kimin davet ettiği ve bir yönetici için hakları. Telegram'nin reddettiği bir istek ise bunun yerine adlandırılır.

Dışa aktaran hesap bir yönetici olduğunda, dışa aktarım, sohbetin yönetici günlüğünü (Telegram yaklaşık 48 saat saklar) admin-log.json dosyasına okur: silme ve düzenlemeler, sağlanan içerik, eylem gerçekleştiren hesap ve kaynak eylem tarihi ile birlikte. Bu girdiler, canlı günlüğün yakalanan sürümlerini ve silme alma kayıtlarını tamamlar.

Göstergeler#

Rapor listesi ve arşiv, indicators.csv , indicators.stix.json (STIX 2.1 ) ve indicators.misp.json (MISP olayı) olarak, bir suistimal masasının kaydedilmiş mesajlarda harekete geçebileceği unsurları içerir: bağlantılar ve alan adları (metin arkasında, düğmelerde ve bağlantı önizlemelerinde gizlenmiş olanlar dahil), kripto para adresleri, Telegram kullanıcı adları ve davet bağlantıları, telefon numaraları, e-posta adresleri ve kaydedilmiş resimler. Bitcoin, Litecoin, Dogecoin ve TRON adresleri yalnızca base58 sağlama toplamları geçerli olduğunda listelenir; segwit adresleri bech32 veya bech32m sağlama toplamları geçerli olduğunda ve TON adresleri CRC sağlama toplamları geçerli olduğunda listelenir; EVM ve Solana adresleri ise kontrol edilmemiş olarak işaretlenir. Resimler, SHA-256 ve algısal hash (dHash, 64 bit) içerir; bu hash, yeniden sıkıştırılmış veya boyutlandırılmış kopyalarda neredeyse değişmeden kalır. Raporlar, göstergeleri yanlışlıkla açılmayacak şekilde yazar (hxxps[://]example[.]com ); dosyalar değerleri olduğu gibi korur. Her gösterge, bilinmeyen ve otomatik algılama için uygun olmayan olarak işaretlenir (STIX , indicator_types: unknown , MISP , to_ids: false , kendi organizasyona dağıtım): listelenmiş olması, bir mesajın onu içerdiğini gösterir, kötü amaçlı olduğunu değil. Metni, açıldığında görünen adresinden farklı bir adres gösteren bir bağlantı, raporda işaretlenir.

PDF raporları, inceleme görevlisinin elle imzalaması gereken bir beyan, noter veya mahkeme uzmanı için bir kontrol listesi ve rapor kimliği, anahtar parmak izi ile yetkili verilerin SHA-256 numarasını içeren bir QR kodu (aynı zamanda ilk sayfada da bulunur) ile sona erer; böylece yazdırılan kopya arşivine geri bağlanabilir.

Olay kanonikleştirme#

Hash girdisi tam olarak şu alanlardan oluşur:

seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash

UTF-8 ile Python uyumlu JSON kullanarak serileştirin; nesne anahtarları sıralanmış, ASCII kaçış karakteri yok, önemsiz boşluklar yok ve NaN/sonsuzluk yok:

json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")

Bu baytların SHA-256 değeri olay hash'i olur. İmza, 32 ham hash baytı üzerinde Ed25519 ile oluşturulur, ardından base64 ile kodlanır. İlk previous_hash 64 sıfırdan oluşur. Sıra numaraları 1'den başlar ve 1'er artar. Operasyonel olaylar da dahil olmak üzere tüm olaylar tek bir zinciri paylaşır. Yinelenen teslimatların engellenmesi söz konusu değildir: tekrarlanan gözlemler, farklı Telegram eylemlerine dair bir iddia değil, ayrı ayrı alındıklar olarak kabul edilir.

Telegram’ın ham verileri ISO dizeleridir; ikili alanlar ise bytes_base64 içeren nesnelere dönüşür. Mesaj metni, varlıklar, medya tanımlayıcıları, yanıt meta verileri, tepkiler ve hizmet eylemleri, sağlandıkları takdirde ham mesaj meta verilerinde saklanır. Canlı bir mesaj, kendisini ileten Telegram güncellemesini de transport_update; bu güncelleme, raw, message alanı {"same_as": "raw"} ikinci bir kopya yerine kullanılır.

observed_at kayıtın yazıldığı anda koleksiyoncunun UTC saati; source_at o Telegram olayı tarafından sağlanan tarihtir. Canlı güncelleme işlenirken yazılan kayıtlara payload.received_at, güncellemenin toplayıcıya ulaştığı UTC zamanı ve payload.processing_delay_ms. Canlı düzenlemeler sağlanan düzenleme tarihini korur, geçmiş anlık görüntüleri ise mesaj tarihini geçerli gözlem zamanıyla birlikte korur ve sıradan bir silme bildirimi, kaynak tarihi boş olarak alım zamanını kaydeder. Yönetici günlüğü girdileri, sağlanan eylem tarihini ayrı olarak korur. Alım sırası ve kaynak olay sırası, saat gözlemleri ve harici alımların karşılaştırma için mevcut olduğu farklı zaman çizelgeleridir.

Aktör semantiği#

Atıf, olay kaynağını takip eder. message.new.actor_id ve message.edited.payload.sender_id, mesajın gönderenini korur. Sıradan message.deleted bildirimleri mesaj kimliklerini taşır ve aktör alanı null değerindedir; mevcut yönetici günlüğü girişleri, kendilerine atanan eylem, aktör ve tarihi içerir. Üyelik hizmeti mesajları göndereni ve eylem türünü korur; ham katılımcı güncellemeleri kendilerine atanan actor_id'yi korur ve tepki anlık görüntüleri kendilerine atanan sayıları ve görünür kimlikleri korur. Bu kayıtları, yakalanan sürümler ve panel etkileşim makbuzlarıyla birlikte okuyun.

Özel sohbetler ve sıradan gruplar için silme bildirimleri yalnızca mesaj kimliklerini içerir. Bu sohbetler hesap genelinde tek bir kimlik dizisini paylaşır, dolayısıyla bir kimlik bu hesabın tek bir mesajını tanımlar. Bu kimliğe sahip bir mesaj daha önce bu günlüğe kaydedilmişse, silme işlemi o sohbette message.deleted olarak kaydedilir ve payload.chat_resolution yöntemini belirtir. Hiç kaydedilmemiş kimlikler deletion.unscoped olarak tutulur: sohbeti ilişkilendirilmemiş gerçek bir silme bildirimi. Bu durum, erişilemeyen bir sorgu sonucunu kaydeden message.missing_on_recheck'dan ve kaydedilmiş mesaj kimliklerindeki bir boşluktan farklıdır. Kanallar ve süper gruplar, mesajları sohbet başına numaralandırır ve bu şekilde asla eşleştirilmez. Silinen mesaj, gözlemlenen hesap tarafından gönderilmişse, payload.deleted_message_was_outgoing değeri true olur; silen kişinin kimliği yine de belirtilmez.

Kapsam dışı bir bildirim, kendi etiketini korur çünkü eşleşen sohbet, mevcut gözlem kapsamı dışında olabilir veya benzersiz bir eşleşmesi olmayabilir. Yeniden kontrol edilememe durumu, rapor sayımlarında, filtrelerde ve etiketlerde silme bildiriminden ayrı bir gözlem olarak kalır. Daha sonraki bir kurtarma işlemi, imzalı geçmişteki önceki başarısız kontrolü korurken mevcut eksiklik durumunu siler; silme bildirimleri ayrı bir olay türü olarak kalır.

Tek bir bildirimden aynı sohbete ait olduğu belirlenen birden fazla kimlik, sayıları ne olursa olsun deletion.batch olarak gruplandırılır; mesaj kimlikleri, Telegram’ın gönderdiği şekliyle ve bu hesabın kaç tane gönderdiği dikkate alınarak korunur. Telegram’ın bildirimi mesajları listeler; sohbetin yönetici günlüğü ise hesabın okuyabileceği bir yerde görevli yöneticinin adını belirtir. Bağlantı (message.deletion_attributed), hangisi önce gelirse o şekilde oluşturulur: silme bildirimi kaydedildiğinde, silme bildirimi öncesinde yönetici günlüğü girişini gören bir sorgu eşleştirilir.

Kapsam: süreklilik, boşluklar ve gözlemlenmemiş kimlikler#

Her imzalı ZIP dosyası coverage.json'yi içerir; HTML raporu aynı özetle açılır ve verify.py, dosyaya güvenmek yerine events.jsonl'den bu özeti yeniden hesaplar:

  • X'ten Y'ye kadar sürekli olarak gözlemlenir. Bir dönem observation.started ile başlar ve bir duraklama, durdurma, Telegram bağlantısının kesilmesi, oturumdan çıkış, düzgün bir durdurma olmaksızın başlatılan bir işlem veya gözlem sırasında herhangi bir kayıt alınmayan üç dakikadan fazla bir süre ile sona erer (kalp atışları her dakika yazılır, bu nedenle sessizlik işlemin durduğu, donduğu veya bilgisayarın uyku moduna geçtiği anlamına gelir). Diğer araçlar → Parametreler bölümünde kalp atışı aralığı değiştirildiğinde, her kalp atışı bunu kaydeder ve izin verilen sessizlik süresi üç aralığa çıkar; bu süre asla üç dakikadan az olamaz.
  • Boşluklar, dönemler arasındaki süreyi ve nedenini listeler. Son kayıtta hâlâ açık olan bir boşluk, not_resumed_by_last_record olarak işaretlenir.
  • Mesaj kimlikleri gözlemlenmemiştir. Sohbet başına mesaj sayısını belirleyen kanallar ve süper gruplar için, gözlemlenen kimlikler arasındaki eksik kimlikler aralıklar halinde listelenir. Bunlar, "gözlemlenmemiş" — silinmiş, hiç teslim edilmemiş veya kaydedilmiş geçmişin dışında — olarak rapor edilir; asla "silinmiş" olarak rapor edilmez. Özel sohbetler ve normal gruplar hesap genelinde ortak bir sıra numarası kullanır; bu nedenle, bu tür bir sohbet içindeki boşluklar bir anlam ifade etmez ve burada listelenmez.
  • Sohbet düzeyindeki boşluk bildirimleri (örneğin, Telegram'ın bir kanalda farkın telafi edilmesini istemesi gibi) not olarak sayılır; bunlar genel kapsamı kesintiye uğratmaz.
  • Session records. Windows in which Telegram's update counter grew while no update reached this session (updates_diverted), this session left Telegram's session list while its connection kept working (session_revoked_externally), or a witness probe's answer arrived only from history (probe_ack_missed_live) are listed separately. The verifier also reports where the Telegram session key came from, other sessions signed in when observation started, sessions added during observation, Telegram security notices (777000), other sessions ended from the workspace, only-session periods, witness probe counts and phone call updates. See accounts. While strict chosen chats is on (scope.strict in observation.started), the session list (except while this is the only session, or when Telegram devices is on), security notices and phone call updates are not collected, so their absence says nothing, and a deletion is matched to a session check only if one ran in the 10 minutes before it.

Güncelleme dizisi (pts)#

Telegram, mesajlarla ilgili güncellemeleri şu şekilde sıralar: pts: hesap için bir dizi (özel sohbetler ve temel gruplar bir arada) ve her kanal veya süper grup için birer dizi. Toplayıcı, aldığı her diziyi eksiklik olmadan bir coverage.sequence kayıt olarak kaydeder: ilk ve son pts, her türdeki güncelleme sayısı ve bunların canlı olarak gönderilip gönderilmediği veya getDifference veya getChannelDifference. Bir kesinti bir coverage.gap kayıttır ve coverage.gap_closed adlandırır pts dizinin tekrar bütün hale geldiği noktayı belirtir.

Kesintisiz bir dizi, Telegram’ın bu sıralamada numaralandırdığı her güncellemenin, ilk ve son güncelleme arasında pts bu koleksiyoncunun Telegram istemcisine ulaşmıştır. Bu, Telegram'ın bu hesaba hiç göndermediği içerikler, kaydedilen ilk güncellemeden önceki zaman ptsdönem hakkında ya da toplayıcının kaydetmediği aralıklar hakkında hiçbir şey ifade etmez. pts Kayıtlı hiçbir dizi veya farkın kapsamadığı bir ilerleme, bir kesinti olarak gösterilir.

GET /api/continuity bir aralık için cevaplar (since, until, chat_id) her bir dizinin kesintisiz olup olmadığını belirler ve kesintileri nedenleriyle birlikte listeler. verify.py "Dizi sürekliliği" başlığı altındaki bir arşivin kayıtlarından aynı bilgileri yazdırır.

Eksik mesaj numaraları (gap_summary)#

For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.

Önizleme. coverage.json → gap_summary Telegram'ın atadığı ve bu toplayıcının hiç görmediği numaraları ölçer. Telegram, mesajları kanal veya süper grup başına bir kez ve özel sohbetler, botlar ve normal gruplar genelinde hesap başına bir kez numaralandırır. Gözlemlenen iki mesaj arasındaki bir numara ya gözlemlenmiştir ya da eksiktir; ardışık bir aralık, içinde numaralandırılan her mesajın gözlemlendiğine dair kesin bir ifadedir. Bir boşluk, herhangi bir aktörü veya nedeni belirtmez.

Alan Anlam
status on veya Daha fazla araç → Parametreler → Boşluk analizi bölümünde devre dışı bırakıldığında off
parameters Sonucun elde edilmesini sağlayan parametreler; böylece işlem tekrarlanabilir
chats[] Her kanal veya süper grup için birer giriş olacak ve her biri ayrı ayrı numaralandırılacaktır.
account Hesap genelinde özel sohbetler, botlar ve normal grupların sıralaması
status (her sekans için) applicable, veya not_applicable ile reason
observed_from, observed_to, span İlk ve son gözlemlenen numara ile aralığın boyutu
observed, observed_without_content Gözlemlenen numaralar; yalnızca silme veya yeniden kontrol kaydından bilinenler
missing, density, gap_ranges, largest_gap Hiç gözlemlenmemiş sayılar, aralıktaki payları, kaç kez çalıştırıldığı, en uzun çalıştırma süresi
clusters[] Listelenen eksiklikler: low, high, missingve komşu gözlemlenen sayılar after / before ve gözlem zamanları
service_estimate Yalnızca etkinleştirildiğinde: gözlemlenen paylarına göre kaç tane eksik numaranın hizmet mesajı olacağı. Asla şu değerden çıkarılmamalıdır: missing

Geçerlilik, günlüğünden türetilir; asla varsayılmaz:

  • Kanallar ve süper gruplar, sohbet başına ölçülür; ayrıca seçilen sohbetlerin dışa aktarımı sırasında da ölçülür. Gönderici tarafından seçilen kayıtlar ölçüme dahil edilir not_applicable.
  • Hesap genelindeki sıra, yalnızca "tüm hesap toplama" özelliği açıkken gelen ilk mesajdan son mesaja kadar ölçülür ve özel sohbetler, botlar, normal gruplar ve hesabın kendi mesajları dahil edilir; bu tür hiçbir sohbet hariç tutulmaz (scope.changed). " deletion.unscoped sayılan sayılar, içerik olmadan gözlemlenmiş sayılır. Seçilen sohbetlerin dışa aktarılması veya devri bu ölçümü etkilemez. Hesap genelinde veri toplama özelliği kapalı ve açık olarak değiştirildiyse, bu sırada kullanılan sayıların boşluklar olarak göründüğüne dair bir not bulunur.
  • Hizmet mesajları, kendi numaralarına sahip günlük kayıtlarıdır; bu nedenle boşlukları kendiliğinden doldururlar; isteğe bağlı tahmin ise yalnızca bağlam bilgisi niteliğindedir.

verify.py yeniden hesaplar gap_summary 'den events.jsonl imzalı coverage.json (eski arşivler için varsayılanlar) ve kapsam özetinde hesap genelindeki satırı yazdırır. Arşivin get_capture_status(MCP ve komut satırı), bir erişimin okuyabileceği sohbetler için aynı ölçümü döndürür; hesap genelindeki dizi ise yalnızca tüm çalışma alanını kapsayan erişimler için geçerlidir.

Bir hizmet mesajının tekrarlanan gözlemleri bir kez sayılır ve hesap hizmeti tahmini yalnızca ölçülen aralık içindeki sayıları kullanır. Uygulanan kapsam, hesap genelinde ölçüm etkinleştirilmeden önce hesabın kendi mesajlarını açıkça korumalıdır; ölçüm bu bilgiyi taşıyan kayıtlardan başlar. Ölçülen aralık, devam eden gözlemi kapsar ve yeniden başlatılması not edilir. Canlı arşiv sorgusunun, veritabanı taraması da dahil olmak üzere bir zaman bütçesi vardır ve tamamlanmamış bir ölçümü kısmi olarak işaretler.

Telegram, ayrı mesaj kimlik dizilerini belgeler. Bu numaralar gözlemleri, silme bildirimlerini, yeniden kontrolleri ve bir numaranın Telegram’ın bildirdiği yerde neden bulunmadığını açıklayan yönetici günlüğü kaydını tanımlar.

Telegram, hesabı kabul etmeyi durdurduğunda, gözlemi sonlandıran coverage.gap kaydı cause (account_banned, account_frozen, account_deleted, session_duplicated, session_revoked, session_expired, session_ended veya not_authorized) değerini ve Telegram hatasını taşır; verify.py ise dönemin sona erme nedenini belirtir.

Kapsam, kaydedilen gözlem dönemlerini, kesintileri ve mesaj sonuçlarını birleştirir. Bunu, seçilen sohbetler, dönem ve ek politikası ile birlikte değerlendirin; sonuçları ve kaydedilen boşlukları yeniden kontrol edin; hesabın güncellemelerinin ne kadar eksiksiz bir şekilde gözlemlendiğini gösterir.

Yapımcı#

Kanıt ZIP'lerinin, sohbet dışa aktarımlarının, tanık günlüklerinin ve kullanıcı profili dosyalarının beyanının imzalı manifestosu producer bilgisini içerir: yazılım, sürüm, proje (PhishDestroy), ana sayfa ve kaynak depo. HTML raporu ve doğrulayıcı, bu imzalı üretici kaydını gösterir. Kaynak dosya hash'leri, güvenilir bir kontrol listesiyle karşılaştırma için kaydedilen kaynak ağacını tanımlar. Yürütme kökeni, etkinleştirilmişse GitHub edinim tasdiki veya Intel TDX ölçümleri ile ayrı olarak kontrol edilir. Üretici alanı mevcut olmadan önce oluşturulan arşivler desteklenmeye devam eder ve eski kayıtlar olarak tanımlanır.

Her observation.started kaydı, gözlem yapan Telegram istemcisinin adını da belirtir: api_id (asla hash değeri değil), bunun yerleşik bir açık anahtar çifti mi yoksa operatörün kendi uygulaması mı olduğu, Telegram'nin bağlantı isteğinde gönderilen istemci açıklaması ve IP moduyla birlikte bağlantı yolunun türü (proxy adresi veya gizli bilgi yok). Rapor ve custody.json, her bir farklı istemciyi ve rotayı, kaydedildikleri zamanla birlikte listeler; ayrıca listelenen hiçbir proxy'nin yanıt vermediği zamanları ve Telegram'nin sunucunun adresini gördüğü zamanları da gösterir. Bundan önce kaydedilen günlükler de bunu doğrulamaktadır.

Kişi profilleri#

Bir profil dosyası (tgwitness-dossier-v1, JSON), talep üzerine, bir sohbet için günlüğünde halihazırda bulunan kayıtlardan oluşturulur; Telegram'dan hiçbir şey alınmaz ve profil içeriği asla günlüğe yazılmaz (profillerin açılıp kapatılması dossier.changed olarak kaydedilir). Kaydedilmiş mesajı olan her kişi için, kaydetme anında görüldüğü şekliyle isim ve kullanıcı adı geçmişi, Telegram işaretleri (bot, dolandırıcılık, sahte, premium, doğrulanmış, kısıtlanmış, silinmiş) ile profil fotoğraf kimlikleri, yerel avatar önbelleğindeki benzer avatarların SHA-256 ve algısal hash (pHash, imagehash.phash ile uyumlu) değerleri, etkinlik (ilk ve son mesaj, sayılar, düzenlenmiş ve silinmiş paylaşımlar, UTC saatine göre mesajlar), kimin kime yanıt verdiği, kişinin yazdığı ve bahsedilen cüzdanlar (BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; Base58Check adresleri sağlama toplamı ile doğrulanır), telefon numaraları, kullanıcı adları ve metin arkasında gizlenmiş bağlantılar dahil olmak üzere bağlantılar.

Her bir gerçek, kaynaklandığı günlük kayıtlarını (seq) listeler ve record_hashes, bağlantı verilen her kaydın hash değerini içerir. Açıklama, çalışma alanı anahtarıyla imzalanmıştır:

python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip

imzayı kontrol eder, kanıt dışa aktarımının kendisini (imza, hash zinciri ve dosyalar) doğrular ve atıfta bulunulan her kaydın aynı çalışma alanının söz konusu dışa aktarımında değiştirilmemiş olarak mevcut olduğunu teyit eder. Avatar hash'leri yerel önbellekten geldiği şeklinde etiketlenir (günlük kayıtlarından değil). Bahsetmeler desen eşleşmeleri ve kontrol edilmesi gereken ipuçlarıdır. Profiller sohbet bazında etkinleştirilir, şifreli bir AES-256 ZIP dosyası olarak dışa aktarılabilir ve devre dışı bırakıldığında veya sohbet kaynaklardan kaldırıldığında silinir.

Bağımsız tanık#

Bir tanık günlüğü (tgwitness-witness-v1) ve kanal gönderileri, verify.py --witness … --channel … komutuyla bir kanıt dışa aktarımına göre kontrol edilir; bkz. bağımsız tanık. Halka açık bir https://t.me/s/… veya https://telegram.me/s/… adresi ile doğrulayıcı, Telegram’dan her gönderinin tarihini okur ve dışa aktarım başındaki en erken tarih, son kayıt için harici zaman olarak kabul edilir. Diğer kaynaklardan gelen tarihler, sağlanan meta verilerdir.

Manifest ve kontrol noktaları#

manifest.json dosyası, formatı, dışa aktarım zamanını, açık anahtarı, parmak izini, günlük uzunluğunu, başlık hash'ini, kapsamı, üreticiyi, sınırlamaları ve manifest.json ile manifest.sig'un kendileri dışındaki her içerik elemanının SHA-256 değerini içerir. manifest.sig, kanonik manifest JSON üzerinde oluşturulan base64 Ed25519 imzasıdır. Doğrulayıcı, beklenmeyen/eksik elemanları, yinelenen adları, bozuk dosyaları, bozuk sıra/zinciri, geçersiz imzaları ve sağlanan kontrol noktasıyla uyuşmazlıkları reddeder. Arşiv yollarını asla ayıklamaz. Beyan edilen toplam sıkıştırılmamış boyutu 4 GiB ile sınırlar; --max-gib N, Daha fazla araç → Parametreler sınırının yükseltilmesiyle daha büyük arşivlere izin verir.

Büyük bir arşiv, aynı anda birkaç işlem tarafından kontrol edilir: üyeler paralel olarak hash işlemine tabi tutulur; ve ilk 5.000 kayıttan sonra, her bir kaydın içerik hash değeri ve imzası, ana işlem zinciri, kapsama alanı ve bağlamaları sırayla takip ederken işçi işlemleri tarafından kontrol edilir. --jobs N işlem sayısını belirler; varsayılan auto değer, CPU başına bir işlem kullanır, en fazla 16'dır ve --jobs 1 her şeyi tek bir işlemde tutar. Her iki durumda da sonuç aynıdır ve değişiklik aynı mesajla reddedilir. Saklanan kontrol noktaları ve zaman damgası bağlantı noktaları tarafından belirtilen konumlardaki hash değerleri bu tek geçiş sırasında saklanır, böylece her bağlantı noktası günlüğü tekrar okumadan karşılaştırılır. 32 iş parçacıklı bir bilgisayarda, 400.000 kaydı içeren 10,8 GB'lık bir arşivin işlenmesi tek işlemde 58,9 saniye, 4 işlemde 15,2 saniye ve 16 işlemde 8,4 saniye sürdü; kayıtlar üzerinde sırayla yapılan tek bir geçiş, sınırı belirler.

Doğrulamayı, kurulu TgWitness sürümünüzden veya incelenmiş bir checkout'tan çalıştırın. Arşivde bulunan kopya taşınabilir kullanım için uygundur; çalıştırmadan önce bu kopyayı güvenilir kurulumunuzla karşılaştırın.

Bir kontrol noktası, açık anahtar, günlük uzunluğu, başlık hash'i ve oluşturulma zamanını içeren bir beyanı imzalar. Ayrıca, çalışma alanının aldığı en yeni drand turunu da taşır (drand_anchor ): toplayıcı, her periyodik kontrol noktasından önce çalışma alanının dış rotası üzerinden bir drand aktarıcısına sorgu gönderir; böylece IP Gizleme, proxy'ler ve devre dışı bırakılmış dış rota geçerli olur ve kontrol noktasının kendisi asla dışarıya bağlanmaz. Doğrulayıcı, daha sonraki bir arşivin aynı önek içerdiğini kontrol edebilir. --checkpoint ve --check-drand komutlarıyla, drand aktarıcıları aracılığıyla o turu doğrular ve kontrol noktasının en erken o turun zamanında imzalandığını bildirir; tur, güvence kademesini değiştirmez. Kontrol noktasını toplayıcının dışında saklayın, böylece sonraki doğrulama işlemi, arşivi ondan ayrı olarak tutulan bir referansla karşılaştırır. Toplayıcı anahtarı bunu imzalar, böylece kayıtları, alıcının arşivden önce başka bir kanal aracılığıyla elde etmiş olması durumunda yalnızca ona bağlar; tek başına kanıt için asgari şartı karşılamaz.

Bir doğrulama sonucunu okuma#

Doğrulayıcı, arşiv bütünlüğü, imzalayanın sabitlenmesi ve güvence kontrollerini ayrı ayrı raporlar. Geçerli bir imza, baytların imzalandıklarından bu yana değişmediğini gösterir. Operatör, anahtar parmak izini alıcıya ayrı bir kanal üzerinden iletir. --fingerprint, bozulmamış bir arşiv imza ve biçim kontrollerinden geçer signer_pinned: false, ve son satır şu şekilde başlar: EVIDENCE: minimum not met · missing: confirmed signer key.

Sabitlenmiş bir imzalayıcı ve kanıt için asgari düzeyde gereklilikler içeren otomatik bir yerel arşivleme politikası için:

python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence

Alıcının güvenilir kanalı aracılığıyla saklanan bir parmak izi kullanın. Güvenilir bir tanık, tutarlı bir tanık günlüğü aracılığıyla toplayıcıyı sabitleyebilir; --witness, --witness-fingerprint ve --require-witness parametrelerini sağlayın. --strict, sabitlenmemiş bir imzalayıcı için 2 durum koduyla sonlanır; karşılanmayan bir --require-tier veya --require evidence koşulu da 2 durum koduyla sonlanır. --require evidence koşulu, --fingerprint parametresini ve son kaydı kapsayan bir üçüncü taraftan gelen harici zaman bilgisini gerektirir. Yalnızca çıkış kodunu değil, signer_pinned, requirements_met ve güvence sonuçlarını da okuyun. Sealed acquisition ise, edinim özetini doğrulamak için kendi doğrulama denetleyicisini ve onaylanmış politikasını kullanır.

Doğrulama kapsamı#

Doğrulama işlemi, arşivi ve arşivin oluşturulmasında kullanılan toplama modunu kontrol eder. Duruma uygun güven sınırına sahip modu seçin, ardından bu modun doğrulama girdilerini koruyun.

Toplama modu Doğrulayıcının kontrol ettiği unsurlar Doğrulama girdileri ve güven sınırı
Yerel çalışma alanı İmzaları, hash zincirini, manifestoyu ve ek baytlarını kaydedin Alıcı tarafından saklanan toplayıcı parmak izi ve üçüncü bir taraftan alınan harici zaman bilgisi: doğrulanmış RFC 3161 veya OpenTimestamps makbuzları ya da t.me adresinden okunan tanık gönderileri. Saklanan kontrol noktaları ve tanık kayıtları, doğrulama işlemlerini destekler.
Bağımsız bir tanık içeren yerel çalışma alanı Arşiv kontrolleri ve tanık tarafından saklanan önceki günlük önekiyle uyumluluk Tanık parmak izi ve kayıtları; muhafızın anahtar kontrol kaydı, tanık anahtarının kimde olduğunu gösterir. --channel https://t.me/s/… ile Telegram'ın gönderilere koyduğu tarihler harici zaman sağlar
GitHub Actions kaydı Arşiv özetinin GitHub onayı, onaylanmış iş akışı ve toplayıcı taahhütleri, barındırılan çalıştırıcı, yeni oturum/anahtar kaynağı ve dahili arşiv bütünlüğü Güvenilir doğrulayıcı politikası, arayan deposu ve GitHub tasdik paketi; toplama işlemi sabitlenmiş iş akışı altında yürütülür
Bulut dağıtımı Sağlayıcı yaşam döngüsü ve erişim kayıtları, güvenlik duvarı ve Cloudflare durumu ile toplayıcının imzalı çalıştırma kaydı Sağlayıcıya ve Cloudflare’e yönelik salt okunur sorgular; tek tek kontrollerin kullanılabilirliği sağlayıcıya bağlıdır
Intel TDX gizli sanal makinesi İmza ve platform durumunu, toplayıcı beyanına, kompozisyona ve işletim sistemi ölçümlerine bağlayarak alıntılayın. Intel güven zinciri ve beklenen dağıtım ölçümleri; gerekli tüm TDX kontrollerinin sonuçlarını koruyun

Mühürlü veri toplama işleminde, onaylanmış toplayıcı, doğrulanmış ortam içindeki kimliği doğrulanmış bir Telegram bağlantısı aracılığıyla verileri alır. Tasdik, arşivi o yürütme işlemine bağlar; böylece doğrulama, veri toplama işleminin yanı sıra daha sonraki dosya bütünlüğünü de kapsar. Bu, onaylanmış koda ve yukarıda listelenen platform güven zincirine dayanır. GitHub yakalama doğrulaması, çalıştırma içinde oluşturulan bir oturum gerektirir ve ithal edilmiş oturum yakalamalarını reddeder.

Çalıştırma makbuzu, toplayıcı sürümünü, dosya hash değerlerini ve başlangıç ayarlarını kaydeder. GitHub kaynak bilgisi ve TDX ölçümleri ortam kontrollerini sağlar; doğrulama kaydı , test edilen yapılandırmaları tanımlar.

Mesajların kaynağı#

Telegram, resmi uygulamalar da dahil olmak üzere her istemciye mesajları bir MTProto oturumu içinde iletir. Oturumun yetkilendirme anahtarı, Telegram’ın sabitlenmiş sunucu anahtarıyla eşleştirilir ve her güncelleme, bu anahtar altında şifrelenmiş ve bütünlük kontrolünden geçirilmiş olarak ulaşır. Toplayıcı, mesajları hesabın kimlik doğrulaması yapılmış oturumu aracılığıyla alır ve her bir gözlemi, geldiği anda günlüğe, sohbet, mesaj ve gönderen tanımlayıcıları ile Telegram’ın her mesaja ayarladığı tarih bilgileriyle birlikte imzalar. GitHub’daki Actions yakalama ve Intel TDX dağıtımlarında, doğrulama işlemi ayrıca o oturumu ve imza anahtarını onaylanmış toplayıcı yürütmesine bağlar.

Günlük, yetkilendirme anahtarının nereden geldiğini kaydeder. Telefon veya QR ile oturum açma, ya da bir oturum dosyasından bağımsız oturum açma, account.authorized değerini key_origin: "created" ile yazar; içe aktarılmış bir .session, TData veya JSON anahtarı üzerinden toplama işlemi yapıldığında imported yazılır. İçe aktarılmış bir anahtar, nereden gelirse gelsin yine de mevcuttur. Onaylı dağıtımlar içe aktarılmış anahtarları reddeder.

Bir kaydın Telegram kaynağına ilişkin kanıt, hesabın kimlik doğrulamalı bağlantısına, günlükteki bağlantı ve yakalama kayıtlarına, günlük girdileriyle eşleştirilen yakalanmış MTProto çerçevelerine (tgwitness/forensics/), her bir mesajın Telegram tarihine ve onaylanmış yakalama durumunda doğrulanmış yürütme ortamına dayanır. Arşiv imzaları, bu kaydı daha sonra kontrol edilebilmesi için korur. Saklanan kontrol noktaları önceki günlük sınırlarını belirler, kapsama kayıtları toplama sonuçlarını gösterir ve doğrulanmış harici zaman damgaları, kaydedilen baytları zamansal olarak konumlandırır.

Yerel bir çalışma alanı için, alıcı güvenilir toplayıcı veya tanık girdilerini sağlar. Mühürlü toplama için, güvenilir politika ve tasdik, arşiv özetini onaylanmış toplayıcı yürütmesine bağlar. Bunlar farklı doğrulama yollarıdır; seçilen yol için tamamlanan kontrolleri raporlayın.

Ekler#

Dosyalar, media/ dizininde SHA-256 ile tanımlanır. Bir media.saved olayı, bir hash değerini ve bayt uzunluğunu belirli bir mesaj olayına bağlar. Ham dosya adları meta verilerdir, asla yerel yollar değildir. Medya baytları eşzamansız olarak indirilir; bu nedenle anında silme işlemi, yakalamayı engelleyebilir. Devre dışı bırakılmış toplama, aşırı büyük/boyutu bilinmeyen dosyalar, indirme hataları ve kesintiye uğrayan indirmeler sonuçlar olarak görüntülenir. Bir işlem çökmesi, referanssız kısmi dosyalar bırakabilir; bunlar dışa aktarımlara dahil edilmez.

ZIP dışa aktarıcısı, depolanan medya dosyalarını adlarına göre doğrular. JSONL, CSV ve HTML dışa aktarımları olay imzalarını doğrular ancak medya baytlarını içermez. Türetilmiş raporlar kolaylık sağlar; events.jsonl dosyası, olayların resmi temsilidir.

Tam bir sohbet dışa aktarma işlemi, çalışma alanının ek ayarlarında belirtilen ekleri media/ dizinine, SHA-256 adıyla kaydeder. chat.json'deki her mesaj kaydı, dosya adını (file, file_sha256) veya eksik olma nedenini (file_status) belirtir; buna ek olarak okuyucunun metin etrafında gördükleri de dahil edilir: metnin arkasındaki bağlantılar, iletme kaynağı, bot düğmeleri, imza, görüntüleme sayısı ve otomatik silme zamanlayıcısı. verify.py, adlandırılmış her dosyanın o hash altındaki imzalı manifestoda bulunduğunu kontrol eder.

Kalıcı toplama ve işlem makbuzları (0.2)#

Bir medya işi ve ilgili mesaj olayı, tek bir işlemde kaydedilir. İş, orijinal TL mesaj tanımlayıcısını depolar; imzalı gözlem, SHA-256 değerini, hesabı ve boyut politikasını bağlar. Kurtarma işlemi, indirme öncesinde bu bağlamayı doğrular. Asla mevcut mesajı almaz ve sessizce daha yeni bir eki ikame eder. Kesintiye uğrayan işler yeniden denenirken, kalıcı hata açık bir sonuç olarak kalır.

Her çalışma alanının kendi günlüğü ve imzalama kimliği vardır. Bir process.started olayı şunları içerir: çalıştırma kimliği, yerel saatler, bağımlılık sürümleri, kaynak dosya hash'leri, başlangıç hesabı/kapsamı ve yakalama ayarları. Heartbeat'ler çalıştırma kimliğini, monotonik zamanı ve kuyruk durumunu içerir. Çalıştırma makbuzu, ayrı olarak imzalanmış bir bildirim olarak da indirilebilir. Yürütme ortamının doğrulanması için, bunu Doğrulama kapsamı bölümünde açıklanan GitHub tasdiki veya TDX kontrolleriyle birlikte kullanın.

Otomatik kontrol noktaları, başlangıçta, gözlem sırasında her beş dakikada bir (Diğer araçlar → Parametreler → Her [süre] imzalı kontrol noktası) ve düzgün bir şekilde durdurulduğunda yerel olarak saklanır. Başlangıç doğrulaması ve dışa aktarma, günlüğü en son saklanan yerel kontrol noktasıyla karşılaştırır. Bu, kontrol noktası korunmuşsa bir veritabanı geri alma işlemini tespit edebilir. Bağımsız saklama, bu referansı çalışma alanı dışında kullanılabilir tutar; doğrulanmış bir harici zaman damgası ise bunu zamana ek olarak sabitler.

Yeniden başlatmanın ardından, kaydedilmiş Telegram güncelleme konumu devam ettirilir (catch_up_from içinde observation.started) ve kaçırılan güncellemeler istenir. Kaydedilen konum, yalnızca işlenmesi tamamlanmış güncellemeleri kapsar; bu nedenle, bağlantı kesildiğinde veya işlem durdurulduğunda hâlâ beklemede olan güncellemeler yeniden istenir. Periyodik bir yeniden kontrol, message.recovered ve message.missing_on_recheck Telegram artık kaydedilmiş bir mesajı döndürmediğinde kontrol edilir; ikincisi bir silme bildirimi değildir ve silen kişinin adını veya zamanı belirtmez.

Site dışı yedekleme ve geri yükleme (S3)#

Tesis dışı kopya (Ayarlar → Bildirimler ve tesis dışı kopya → Tesis dışı kopya veya Diğer araçlar → Ekstralar → Kanıtlar ve yedeklemeler; varsayılan olarak kapalıdır), günlük segmentlerini, korunan dosyaları, kontrol noktalarını zaman damgalarıyla birlikte ve tamamlanmış sohbet dışa aktarımlarını, çalışma alanı kasasında saklanan bir anahtar altında yüklemeden önce AES-256-GCM ile şifrelenmiş olarak S3 uyumlu depolama alanına yükler; Nesne Kilidi saklama süresi, kova bunu desteklediğinde geçerlidir. İndirilmiş anahtar olmadan kopya okunamaz. Geri yükleme ve doğrulama işlemini python -m tgwitness.replica restore --key-file KEY.json --out DIR komutuyla gerçekleştirin.

Geri yükleme işlemi için boş bir normal dizin gereklidir. İndirilen ve şifresi çözülmüş nesneler, tüm günlük ve saklanan her kontrol noktası doğrulanana kadar özel geçici depolama alanında kalır. Güvenli olmayan nesne yolları, tutarsız segment aralıkları ve bir kontrol noktasından daha kısa günlükler reddedilir; başarısız doğrulama durumunda geri yüklenen dosya yayınlanmaz. Saklama kontrolleri, geri döndürülen Nesne Kilidi modunu ve tarihini, yükleme sırasında gönderilen son tarihle karşılaştırır (bir saniyelik yuvarlama toleransı). Süresi dolmuş, geçersiz veya kısaltılmış son tarihler doğrulanmış olarak kabul edilmez. Durum raporu, o yükleme geçişi için saklama süresi okunan örnek nesneyi bildirir.

Eksik veya bozuk yerel medya, geçiş hatası olarak rapor edilir ve medya imleci bunun önünde tutulur, böylece dosya bir sonraki geçişte tekrar denenir; bundan sonraki dosyalar, kontrol noktaları ve dışa aktarımlar yine de kopyalanır. Geri yükleme, şifresi çözülmüş hash değerleri ve kaydedilen boyutlara göre tüm korunmuş medya referanslarını kontrol eder. Kesintiye uğrayan yüklemelerden kaynaklanan aynı çakışan günlük segmentleri tekilleştirilir; çakışan kısımlar reddedilir. Yükleme sırasında oluşturulan kontrol noktaları, kapsadıkları günlük kayıtları kopyalanana kadar ertelenir; böylece tamamlanan bir geçiş, kontrol noktasını günlükten önce yayınlamaz.

Akış halinde dışa aktarma anlık görüntüleri#

Akışlı dışa aktarımlar, kararlı bir SQLite okuma anlık görüntüsü kullanır. İndirme işlemi tamamlandığında, bu anlık görüntünün başlangıcı mevcut canlı günlüğünden daha eski olabilir. Bu anlık görüntünün ardından oluşturulan bir kontrol noktası, arşivin daha kısa olduğunu doğru bir şekilde bildirebilir; bunu, dışa aktarılan önekle aynı veya ondan önceki bir kontrol noktasıyla karşılaştırın, keyfi olarak daha sonraki bir kontrol noktasıyla değil.

RFC 3161 hazırlığı ve yanıt doğrulaması (0.2)#

Kanıt modu, her imzalanmış kontrol noktasının yalnızca SHA-256 değerini, listelenen RFC 3161 yetkili kurumlarına ve OpenTimestamps takvimlerine, çalışma alanı rotası üzerinden gönderir; MTProxy üzerinden asla göndermez. Zaman damgaları, her kurulum hedefinde varsayılan olarak etkindir; Bir vaka için kanıt, drand değerini de kaydeder. Cevaplar checkpoints/anchors/, şu şekilde dışa aktarılır .tsr ve .ots dosyalar halinde anchors/, ve verify.py (--tsa-ca TSA imzasını kontrol eder; OpenTimestamps kanıtlarını ile ots upgrade ve ots verify).

Arka arkaya iki kez başarısız olan bir RFC 3161 yetkilisi, bir sonraki deneme öncesinde bekler: bir aralık, ardından iki, dört ve böylece altı saate kadar, ya da Retry-After'de belirtilen süre kadar, en fazla bir gün. Yalnızca bekleyen yetkililer bulan bir geçiş, herhangi bir kayıt yazmaz; aksi takdirde anchor.completed, bunları deferred altında retry_at ile listeler. Tekrar yanıt verene kadar, panel zaman damgalarını Degraded olarak gösterir.

Panel, timestamp.tsq dosyasında kanonik checkpoint.json baytlarını, bir SHA-256 mesaj izini ve rastgele bir nonce'u, sağlama toplamlarını ve talimatları içeren bir istek arşivi hazırlar. Herhangi bir ağ isteği yapılmaz; yetkili kurumun bu istek için döndürdüğü belirteç, zaman damgasıdır.

python -m tgwitness.anchor verify, yanıtı kontrol noktası baytlarına ve özgün isteğe göre OpenSSL olmadan denetler. Güvenilir CA dosyası açıkça belirtilmelidir; ekli sertifikalar otomatik olarak güvenilir sayılmaz. CLI'de isteğin denetlenmesi isteğe bağlıdır; bu yüzden isteği saklayın ve nonce'u denetlemek için --request verin. Sonuç, denetlenip denetlenmediğini belirtir. Toplayıcının kontrol noktası imzası ve günlük yine de güvenilir toplayıcı parmak iziyle ayrıca doğrulanmalıdır.

Doğrulama, yanıt imzasını, kontrol noktası baytlarını ve (varsa) belirtilen CA güveni kapsamında orijinal isteği kontrol eder. Kanıt modunda elde edilen zaman damgaları için verify.py ayrıca depolanan OCSP veya CRL kanıtlarını (imza sertifikası iptali) kontrol eder. Prosedüre ve doğrulama sonuçlarına bakınız.

Kanıt modunda isteğe bağlı kayıtlar: drand ve Telegram cihazları#

Zaman damgalarıyla aynı geçişlerde iki kayıt daha çalışabilir. Her ikisi de yalnızca kanıt modu açıkken geçerlidir. Bir davaya ilişkin deliller drand'ı etkinleştirir; aksi takdirde her ikisi de çalışmaya başlar. Bunları “Diğer araçlar → Ekstralar → Kanıtlar ve yedeklemeler →” altında değiştirin: Daha fazla tanık · isteğe bağlı, veya "drand": true ve "devices": true içinde POST /api/evidence. Bir arıza, diğerini veya zaman damgalarını durdurmaz; panel, her birinin en son sonucunu formun altında gösterir.

drand (beacon.drand ). Her geçiş, League of Entropy’nin halka açık rastgelelik kaynağı olan drand quicknet’in en yeni turunu (her 3 saniyede bir tur) günlüğe yazar: chain , round , randomness , signature , round_time ve yanıt veren relay . Doğrulanmış öngörülemez bir tur, sonraki hash bağlantılı materyal için daha düşük bir zaman referansı sağlar. Daha sonraki bir kontrol noktasında doğrulanmış bir zaman damgası, üst zaman referansı sağlar. Bu kontroller bağlantılı içeriği sınırlar. Toplayıcı, her geçişte bir istekle önce drand.cloudflare.com ’a, ardından çalışma alanı rotası üzerinden Protocol Labs’ın aktarıcılarına başvurur.

verify.py , her bir rastgeleliğin imzasının SHA-256 olup olmadığını ve tur süresinin doğru olup olmadığını kontrol eder; turları, tur olmayan en uzun aralığı ve toplayıcının saatinin drand'dan ne kadar geride kaldığını raporlar. --check-drand , turları bir Cloudflare aktarıcısıyla ve bir Protocol Labs aktarıcısıyla karşılaştırır; bu karşılaştırma tüm veriler üzerinde veya uzun bir günlükteki rastgele seçilmiş 100 örnek üzerinde yapılır; farklılık gösteren bir tur, doğrulamayı geçemez.

, Telegram, (account.devices) cihazları. Her geçişte, account.getAuthorizations ile hesabın oturumları okunur; Telegram listesi Ayarlar → Cihazlar bölümünde gösterilir ve şu şekilde kaydedilir: önceki geçişten bu yana değişiklik olmuşsa tam olarak, added ve removed oturum hash'leriyle birlikte; aksi takdirde sadece sayısı ve SHA-256 ile kaydedilir. Cihaz modeli, platform, uygulama ve sürüm, oluşturulma tarihi ve son etkinlik, ülke ve bölge saklanır; IP adresleri saklanmaz, çünkü kanıtların dışa aktarılması sizin kontrolünüz dışındadır. Toplayıcının kendi oturumu her zaman aktiftir, bu nedenle sadece diğer oturumların etkinliği bir değişiklik olarak sayılır. verify.py, listenin ne sıklıkla kaydedildiğini ve her yeni ve sona eren oturumu bildirir. Listeyi yalnızca gözlem çalışırken okur.

Bunların gösterdiği şey: drand, kayıtları genel zamana göre sıralar ve cihaz listesi, toplayıcı aracılığıyla Telegram’ın beyanıdır; bu beyan, diğer tüm kayıtlar gibi toplayıcı tarafından imzalanır.

Cloudflare Gateway günlüğü (cloudflare.gateway_dns). Cloudflare Gateway (Gateway DNS) üzerinden çözümleme yapan bir sunucu için, her kopyalama işlemi, bir önceki kopyalamadan bu yana Gateway'in kaydettiği verileri kopyalar: en fazla üç saatlik bir zaman aralığı başına bir kayıt; from, until, location_id, ayarlanmışsa sunucunun address ve queries ile [at, name, type, rcode, decision, colo] (hiçbiri yoksa da). altında ayarlayın. Cloudflare Gateway günlüğü : hesap, konum, isteğe bağlı adres ve bir salt okunur belirteç (Hesap Analytics Okuma; paylaşılan bir konumun tek bir adresini saklamak için Zero Trust PII Okuma). Panel, kaydetmeden önce bunları tek bir istekle kontrol eder; jeton şifreli kalır ve asla günlüğe girmez. verify.py, pencereleri, en çok aranan isimleri ve kopyanın kapsamadığı zamanları listeler; sayısı sorgularıyla eşleşmeyen bir kayıt başarısız olur. Tek bir saniye içinde birden fazla sayfa sorgu barındıran bir pencere, o sayfayı saklar ve geri kalanının eksik olduğunu belirtir. Kopya, toplayıcı aracılığıyla Cloudflare’in verdiği ve toplayıcı tarafından imzalanmış yanıttır; 24 saat içinde salt okunur jetona sahip herkes bunu Cloudflare ile karşılaştırabilir.