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, 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
- Neyin imzalandığı
- Sohbet dışa aktarımlarının karşılaştırılması
- Soruşturma devri
- Devir teslim özeti
- Okunabilir raporlar
- Olay kanonikleştirme
- Aktör semantiği
- Kapsam: süreklilik, boşluklar ve gözlemlenmemiş kimlikler
- Üretici
- Kişi profilleri
- Bağımsız tanık
- Manifest ve kontrol noktaları
- Doğrulama kapsamı
- Ekler
- Dayanıklı toplama ve işlem makbuzları (0.2)
- RFC 3161 hazırlığı ve yanıt doğrulaması (0.2)
- Kanıt modunda isteğe bağlı kayıtlar: drand ve Telegram cihazları
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#
- 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.
- Ç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.
- İ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.
-
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 evidenceParmak 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ğindekey_pinned: truevecheckpoint_checked: trueraporlar. 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).- 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
.tgwpwkonteynerini 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ınunseal-passwordkomutuyla 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. - 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.
- 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 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.htmlveyamessages/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, anahtarlarformat,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 öznitelik2.25.240684792623320047764573196045913242332olarak 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 (veyaTGWITNESS_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ı manifesttereport.originalaltı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.startedile 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_recordolarak 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.strictinobservation.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.unscopedsayı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.