Sebagian isi halaman ini masih dalam bahasa Inggris: teks asli dalam bahasa Inggris telah diubah setelah diterjemahkan.
Referensi / Bukti
Telegram · Format bukti
Isi berkas ZIP yang telah ditandatangani, jenis catatan, tanda terima proses, profil pengguna, salinan di luar lokasi, dan verifikasi offline.
TgWitness menyimpan pengamatan Telegram yang terlihat oleh akun dalam jurnal yang ditandatangani. Penerima dapat memverifikasi catatan, lampiran, dan laporan yang disimpan dengan membandingkannya terhadap kunci pengumpul tepercaya, memeriksa waktu eksternal dari pihak ketiga untuk catatan terakhir, dan membandingkan jurnal tersebut dengan titik pemeriksaan yang telah mereka simpan sebelumnya. Halaman ini menjelaskan format, pemeriksaan, dan materi yang harus disimpan untuk serah terima.
Pengguna dapat memulai dengan VERIFY.cmd di Windows: program ini meminta berkas ZIP asli dan sidik jari kunci yang diperoleh secara independen, menampilkan hasil yang disertai penjelasan, serta menyimpan transkrip verifikasi terpisah. Lihat peluncur verifikasi dan runtime portabel untuk pengaturan dan batasan kepercayaan.
Di halaman ini
- Apa yang ditandatangani
- Membandingkan ekspor obrolan
- Serah terima investigasi
- Ekstrak serah terima
- Laporan yang mudah dibaca
- Kanonisasi peristiwa
- Semantik aktor
- Cakupan: kontinuitas, celah, dan ID yang tidak teramati
- Produsen
- Profil pengguna
- Saksi independen
- Manifest dan titik pemeriksaan
- Ruang lingkup verifikasi
- Lampiran
- Pengumpulan dan pemrosesan tanda terima yang tahan lama (0.2)
- ersiapan RFC 3161 dan verifikasi respons (0.2)
- Catatan opsional dalam mode bukti: drand dan perangkat Telegram
Apa itu "ditandatangani"?#
| Materi | Perlindungan | Apa yang perlu disimpan |
|---|---|---|
| Setiap catatan dalam jurnal, termasuk peristiwa operasional | Rantai SHA-256 dan tanda tangan Ed25519 per peristiwa | events.jsonl asli, sidik jari kunci tepercaya, dan titik pemeriksaan yang disimpan |
| Isi berkas ZIP bukti | manifest.sig menandatangani manifes kanonik, yang mencantumkan hash dari berkas-berkas konten |
File ZIP lengkap, termasuk manifes dan tanda tangannya |
| Lampiran yang disimpan | SHA-256 dan jumlah byte dalam peristiwa media.saved yang ditandatangani; hash berkas dalam manifes ZIP yang ditandatangani |
Byte asli di dalam berkas ZIP yang telah diverifikasi |
| Titik Pemeriksaan | Tanda tangan Ed25519 atas panjang jurnal, hash header, kunci publik, dan waktu pembuatan | Salinan independen yang disimpan sebelum adanya perubahan yang diperdebatkan |
| Bukti transaksi | Catatan yang ditandatangani mengenai versi pengumpul, hash berkas sumber, dan pengaturan awal, juga disertakan dalam process.started |
Bukti transaksi, jurnal terkait, dan bukti lingkungan untuk mode verifikasi yang dipilih |
Laporan yang mudah dibaca: report.html dan bagian-bagiannya, report.json, report.pdf, chat.pdf |
Satu segel Ed25519 per berkas pada isinya; PDF juga dilengkapi dengan tanda tangan standar PDF (lihat Laporan yang dapat dibaca ) | Berkas sebagaimana diterima dan sidik jari kunci tepercaya; berkas ZIP yang dijelaskan di dalamnya |
| CSV mandiri | Tidak ada tanda tangan kriptografis yang berdiri sendiri; hash peristiwa saja tidak cukup | Gunakan salinan persis yang terdapat di dalam berkas ZIP yang telah diverifikasi untuk pemeriksaan integritas |
| Tangkapan layar, cetakan, atau berkas PDF yang dihasilkan oleh peramban | Tidak ada tanda tangan TgWitness pada hasil turunan | Simpan paket asli yang telah diverifikasi dan dokumentasikan bagaimana turunan tersebut dibuat |
Pengumpul memverifikasi tanda tangan jurnal sebelum menghasilkan setiap format ekspor. Laporan HTML dan PDF yang dapat dibaca memiliki segelnya sendiri; CSV mandiri diperiksa sebagai bagian dari ZIP yang ditandatangani. Pertahankan ZIP untuk mempertahankan byte lampiran dan manifest, serta titik pemeriksaan terpisah untuk membandingkan jurnal dengan batas waktu sebelumnya.
Format dan jalur verifikasi#
Mode akuisisi dan format keluaran menjawab pertanyaan yang berbeda. Mode menyediakan bukti pengumpulan dan lingkungan; setiap format mempertahankan atau menyajikan bagian dari catatan tersebut dengan pemeriksaan di bawah ini.
| Hasil | Verifikasi dan penggunaan |
|---|---|
| Bukti ZIP | Peristiwa kanonik, manifes yang ditandatangani, cakupan, entri penyimpanan, lampiran, dan tanda terima eksternal yang tersedia; periksa arsip dan mode akuisisi yang dipilihnya. |
| Kontainer ASiC-E | Bukti dalam bentuk ZIP sebagai wadah ETSI ASiC-E (EN 319 162-1) yang berisi entri mimetype dan berkas META-INF/ASiCManifest.xml, yang ditandatangani menggunakan CAdES dengan sertifikat milik ruang kerja itu sendiri pada tingkat B-B, atau B-T jika fitur penandaan waktu diaktifkan. Validator seperti EU DSS memeriksa format dan integritas, dan karena sertifikat tersebut diterbitkan sendiri, validator melaporkan tidak adanya jangkar kepercayaan. EU DSS 6.3 dengan pengaturan default menolak wadah yang berisi lebih dari 1.000 berkas ("Terlalu banyak berkas terdeteksi"). verify.py memeriksa manifes Ed25519 dan setiap berkas yang terdaftar, nilai SHA-256 dalam META-INF/ASiCManifest.xml serta dalam berkas tambahan ASiCManifestNNN.xml atau ASiCEvidenceRecordManifest.xml, dan akan gagal jika terdapat entri META-INF/ yang tidak tercakup oleh salah satu dari berkas tersebut. Alat ini tidak memeriksa tanda tangan CAdES dan menyatakan hal tersebut secara eksplisit. |
| Laporan HTML dan JSON | Tampilan yang disegel secara individual dengan referensi sumber, juga tercantum dalam manifes ZIP. Jumlah yang tercatat merangkum jenis-jenis peristiwa jurnal. |
| Laporan PDF | Segel Ed25519 ditambah tanda tangan PDF dasar PAdES pada rentang byte: B-B, atau B-T dengan cap waktu tanda tangan jika fitur cap waktu diaktifkan. Verifikator TgWitness menggunakan kunci Ed25519 yang tepercaya; tampilan kepercayaan sertifikat pada penampil merupakan pemeriksaan terpisah. |
| CSV | Tampilan spreadsheet yang tercakup dalam manifes ZIP. Pengesapan rumus melindungi penggunaan spreadsheet; teks asli yang ditandatangani tetap ada di jurnal. |
| JSONL | Catatan peristiwa yang ditandatangani, termasuk referensi lampiran. Berkas ZIP bukti juga memuat byte lampiran yang disimpan. |
| Ekspor obrolan dan tampilan yang kompatibel dengan desktop | Akuisisi riwayat dan catatan log admin yang tersedia, beserta tampilan yang diminta dan arsip yang ditandatangani. Versi yang disimpan dari pemantauan langsung merupakan jalur akuisisi terpisah. |
| Catatan media dan catatan berbasis hash saja | Byte yang disimpan diperiksa berdasarkan SHA-256 dan referensi pesannya. Akuisisi berbasis hash saja mempertahankan metadata hash yang tersedia untuk perbandingan selanjutnya dengan byte file. |
| STIX/MISP dan profil orang | Pengamatan yang diekstraksi dan tertaut ke sumber, ID akun, serta kecocokan analitis. Tanda tangan profil dan hash catatan dapat diverifikasi terhadap bukti asli; asal-usul cache avatar diberi label secara terpisah. |
| Cuplikan serah terima | Aturan pengungkapan yang ditandatangani, catatan yang tidak diubah, dan catatan yang ditandai sebagai diminimalkan yang mempertahankan hash/tanda tangan asli. Gunakan versi asli yang dipertahankan untuk perbandingan yang memerlukan bidang yang disembunyikan. |
| Saksi dan tanda terima waktu | Batas-batas jurnal sebelumnya, kontinuitas, dan klaim waktu terverifikasi masing-masing. Hal-hal tersebut menyertai pemeriksaan akuisisi dan arsip. |
| Pengiriman yang dilindungi kata sandi | Melindungi paket yang disertakan selama transfer. .tgwpw menggunakan enkripsi terotentikasi AES-GCM, termasuk catatan akhir yang terotentikasi; jurnal yang disertakan mempertahankan tanda tangannya dan tanda terima perolehan. |
Cetakan atau tangkapan layar merupakan penyajian materi yang telah ditandatangani. ID laporan, sidik jari kunci, dan referensi QR-nya membantu menemukan berkas asli untuk verifikasi. Pernyataan penyimpanan mencatat pemeriksa yang ditunjuk dan informasi transfer; hasil verifikasi serta tanda terima perolehan disimpan sebagai bukti terpisah.
Tanda tangan eksternal#
Sebuah tanda tangan juga dapat berasal dari kunci yang tidak pernah disimpan oleh TgWitness, seperti
tanda tangan elektronik yang memenuhi syarat dari seorang penyelidik atau stempel organisasi. Pada Ekspor,
tanda tangan eksternal pada ekspor yang telah disiapkan tanpa kata sandi akan memberikan byte-byte yang akan ditandatangani: daftar baru
META-INF/ASiCManifestNNN.xml daftar yang mencantumkan setiap file beserta nilai SHA-256-nya untuk wadah ASiC-E
, atau manifest.json untuk ZIP. Penandatangan mengembalikan CMS (CAdES)
.p7s, baik terpisah maupun dengan konten yang disematkan.
TgWitness memeriksa apakah tanda tangan mencakup byte-byte tersebut secara tepat dan memverifikasinya dengan sertifikat penandatangan (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). Rantai hanya diverifikasi berdasarkan sertifikat akar yang disediakan oleh operator; pencabutan, daftar tepercaya, dan status kualifikasi tidak diperiksa. Panel menampilkan satu status per tanda tangan: menunggu tanda tangan, terlampir dan belum diverifikasi, terverifikasi, algoritma tidak didukung, tanda tangan tidak valid, byte yang ditandatangani tidak cocok, atau sertifikat tidak terhubung ke sertifikat akar yang disediakan. Mengubah ekspor setelah byte dibagikan akan mengatur semua tanda tangannya menjadi "byte yang ditandatangani tidak cocok".
Unduhan dengan tanda tangan akan menambahkan tanda tangan dan manifestnya di bawah META-INF
dalam wadah ASiC-E. Untuk berkas ZIP, fitur ini akan menyimpan berkas ZIP yang tidak diubah, serta .p7s file-file, dan
SIGNATURES.txt ke dalam ZIP luar. Tanda tangan yang tidak valid dan tanda tangan yang menimpa byte lain
ditinggalkan. Tanda tangan dengan algoritma yang tidak dapat diperiksa oleh TgWitness tetap disertakan;
panel menampilkan statusnya, seperti halnya SIGNATURES.txt pada file ZIP.
Gambar obrolan yang ditandatangani#
Mengunduh berkas ZIP yang telah ditandatangani pada pratinjau gambar akan menyimpan halaman-halaman dalam format PNG, pages.sig.json dan
README.txt. Setiap halaman diakhiri dengan nomor catatan jurnal yang ditampilkannya, obrolan,
waktu rendering, sidik jari kunci ruang kerja, dan perintah yang memverifikasinya. Panel
hanya mengirimkan SHA-256 dan nomor catatan dari setiap halaman; server memastikan bahwa catatan-catatan tersebut
merupakan bagian dari obrolan, menandatangani pernyataan (tgwitness-image-attestation-v1) dengan
kunci ruang kerja, dan mencatat proses penandatanganan tersebut sebagai 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
Verifikator memeriksa tanda tangan, mencocokkan setiap berkas PNG dengan halaman yang telah ditandatangani, dan melaporkan
sidik jari kunci. --fingerprint membandingkan penandatangan dengan sidik jari yang diperoleh dari
pengirim secara independen. --evidence membaca berkas ZIP bukti yang telah ditandatangani dari ruang kerja yang sama dan
memastikan setiap catatan gambar hadir dengan hash yang sama. Piksel yang berubah,
pernyataan yang diubah, atau kunci lain akan menyebabkan pemeriksaan gagal. Gambar-gambar tersebut menampilkan catatan yang disimpan dalam
tata letak milik TgWitness sendiri; gambar-gambar tersebut tidak menampilkan apa yang ditampilkan Telegram kepada siapa pun.
Membandingkan ekspor obrolan#
Verifikasi dan bandingkan dua berkas ZIP ekspor obrolan yang ditandatangani dengan sidik jari penandatangan yang disimpan secara terpisah:
python -m tgwitness.verify first.zip --compare second.zip \
--fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256
Opsi --require dan --require-tier tidak dapat digunakan bersamaan dengan --compare; periksa
profil yang diperlukan untuk setiap arsip melalui proses verifikasi masing-masing.
Ketika kedua arsip mencatat ID akun dan obrolan numerik yang sama, catatan dipasangkan
berdasarkan ID pesan. Tidak Berubah berarti kesamaan catatan JSON lengkap yang disimpan:
teks lengkap, penulis, tanggal, target balasan, metadata bersarang, dan bidang yang tidak diketahui semuanya
termasuk. Urutan kunci objek JSON tidak berpengaruh; bidang yang tidak ada, nilai null, tipe nilai,
dan urutan array berpengaruh. Pratinjau 300 karakter hanya untuk tampilan. Entri yang diubah
menyebutkan changed_fields tingkat atas yang berbeda, termasuk perubahan yang tidak terlihat dalam pratinjau tersebut.
ID pesan yang duplikat ditolak alih-alih saling menimpa selama proses pencocokan.
Perbedaan dapat berupa nama tampilan yang berubah, jumlah tampilan, anotasi koleksi, atau metadata pengamatan lainnya. Pengeditan Telegram muncul sebagai peristiwa pengeditan tersendiri, dan verifikasi setiap arsip menunjukkan apakah arsip tersebut utuh. Catatan yang belum diurai tetap termasuk dalam perbandingan dan dibandingkan berdasarkan representasi yang disimpan.
Untuk identitas akun/obrolan yang berbeda atau hilang, alat ini menemukan
korespondensi kandidat menggunakan pengirim, teks lengkap, hash file, jenis media, dan toleransi waktu lima detik,
serta melaporkannya sebagai Matched alih-alih Unchanged. Catatan yang belum diurai
tetap tidak cocok. Perbedaan dalam catatan yang dipasangkan tercantum dalam changed,
termasuk dalam mode konten. Dengan --json, matched menghitung pasangan kandidat dan
unchanged menghitung pasangan yang catatan lengkapnya yang tersimpan sama. Keluaran
changed_fields dan unchanged (bilangan bulat) yang ada tetap kompatibel dengan
hasil perbandingan sebelumnya. Format arsip dan verifikasi tanda tangan tetap tidak berubah.
Serah terima penyelidikan#
- Catat referensi kasus, operator, ID akun Telegram numerik, sumber yang dipilih, kebijakan pengumpulan, dan periode pengumpulan dalam catatan kasus Anda. TgWitness melestarikan pengamatan dan mendukung catatan serta pengumpulan yang tertaut ke sumber di Case Board. Simpan catatan transfer dan penyimpanan bersama materi kasus Anda. Periksa pengaturan pengumpulan yang dimaksud dengan prosedur penerimaan langsung.
- Simpan sidik jari kunci publik ruang kerja secara terpisah sebelum mengandalkan ekspornya. Pertahankan mode bukti dalam keadaan aktif (pengaturan default) agar titik pemeriksaan menerima tanda terima sesuai RFC 3161 dan OpenTimestamps. Simpan titik pemeriksaan yang telah ditandatangani di luar pengumpul selama proses pengumpulan. Catat gangguan dan batasan visibilitas akun.
- Ekspor berkas ZIP yang telah ditandatangani dan simpan tanda terima eksekusi yang telah ditandatangani. Gunakan titik pemeriksaan pada atau sebelum batas jurnal yang diekspor. Titik pemeriksaan yang lebih baru dapat dengan benar menolak ekspor sebelumnya karena terlalu pendek. Ekspor mencakup jurnal ruang kerja secara lengkap, terlepas dari filter panel; tinjau materi tersebut sebelum membagikannya.
-
Mintalah penerima untuk memverifikasi berkas ZIP tersebut dengan salinan verifikator tepercaya, sidik jari yang disediakan secara independen, dan sertifikat akar otoritas cap waktu yang diperoleh secara terpisah. Dari lingkungan checkout tepercaya dengan lingkungan Python yang aktif:
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidenceSidik jari dan cap waktu yang telah diverifikasi dari catatan terakhir memenuhi syarat minimum sebagai bukti; jika tidak,
--require evidenceakan keluar dengan kode 2. Titik pemeriksaan merupakan pemeriksaan pendukung, karena ditandatangani dengan kunci pengumpul. Keluaran yang berhasil melaporkankey_pinned: truedancheckpoint_checked: trueketika kedua masukan disediakan dan diterima. Pertahankan hasil verifikasi.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).- Catat SHA-256 arsip, batas ekspor, tanggal transfer, pengirim, dan
penerima dalam catatan penyimpanan Anda. Jaga agar paket asli tetap utuh dan kerjakan
dari salinan. Bagikan berkas bukti, bukan direktori data pribadi aplikasi,
yang juga berisi sesi akun dan rahasia penandatanganan.
Untuk transfer, pilih ZIP AES-256 yang dilindungi kata sandi atau wadah
.tgwpwyang lebih kuat. ZIP menggunakan derivasi kata sandi berbiaya rendah dari WinZip; gunakan frasa sandi acak yang panjang..tgwpwmenggunakan scrypt dan AES-256-GCM serta dibuka dengan perintahunseal-passworddari verifikator mandiri. Kata sandi tidak disimpan dan hanya melindungi kerahasiaan; penerima mendekripsi arsip dan memverifikasi ekspor yang ditandatangani di dalamnya, yang tidak berubah. - Untuk memberi cap waktu pada titik pemeriksaan di luar mode bukti, ikuti prosedur RFC 3161 dan simpan permintaan, titik pemeriksaan, informasi CA tepercaya, serta respons otoritas yang terverifikasi. Hanya menyiapkan permintaan saja tidak akan menghasilkan cap waktu.
- Catat SHA-256 arsip, batas ekspor, tanggal transfer, pengirim, dan
penerima dalam catatan penyimpanan Anda. Jaga agar paket asli tetap utuh dan kerjakan
dari salinan. Bagikan berkas bukti, bukan direktori data pribadi aplikasi,
yang juga berisi sesi akun dan rahasia penandatanganan.
Untuk transfer, pilih ZIP AES-256 yang dilindungi kata sandi atau wadah
Untuk .tgwpw, gunakan verifikator yang diperoleh secara independen dan pilih berkas keluaran baru
dengan ekstensi asli: python verify.py unseal-password export.tgwpw --out evidence.zip.
Perintah ini akan meminta kata sandi; --password-stdin membaca satu baris untuk otomatisasi.
Perintah ini tidak akan pernah menimpa berkas yang sudah ada dan hanya mempublikasikan teks biasa setelah semua catatan
terverifikasi. Jalankan verifikasi tanda tangan biasa pada berkas yang telah didekripsi setelahnya.
Kontainer ini menggunakan scrypt (N=131072, r=8, p=1, garam 16 byte; sekitar 128 MiB RAM)
dan AES-256-GCM dengan catatan berukuran 1 MiB serta catatan akhir yang terotentikasi. Sebuah catatan
metadata terenkripsi menyimpan nama file bagian dalam, sehingga kontainer yang diunduh dapat diganti namanya.
Verifikasi yang berhasil menetapkan integritas relatif terhadap kunci pengumpul tepercaya dan batas yang dipertahankan. Lihat ruang lingkup verifikasi untuk asumsi kepercayaan dan hasil validasi dari pemeriksaan yang dilakukan.
Cuplikan serah terima#
Sebuah berkas ZIP yang ditandatangani berisi seluruh jurnal ruang kerja. Ketika pengadilan, pengacara, atau unit penanganan pelanggaran hanya memerlukan
beberapa obrolan, periode tertentu, atau orang-orang tertentu, menu Ekspor → Ekstrak Serah Terima akan menyiapkan salinan yang dipersempit
(tgwitness-handover-v1) sesuai dengan aturan pengungkapan yang dipilih.
Operator menyatakan tujuannya dan memilih obrolan, periode opsional (UTC), orang-orang yang
terkait dengan ekstrak tersebut, apa yang terjadi pada orang lain (ditampilkan, diganti dengan nama samaran P01, P02… atau diabaikan
), teks pesan mana yang dipertahankan, lampiran dan foto profil mana yang disertakan, serta apakah
nomor telepon dan alamat email dalam teks disamarkan. Tujuan dan aturan-aturan ini tercantum dalam
manifes yang ditandatangani dan dalam laporan; jurnal mencatat "handover.exported" beserta akses yang
menyiapkannya serta SHA-256 berkas tersebut, bukan isinya.
verify.py memeriksa sebuah ekstrak dengan dua cara. Sebuah catatan yang ditampilkan tidak berubah diverifikasi secara menyeluruh:
isinya dibandingkan dengan hash-nya, tanda tangan Ed25519-nya, serta tautannya ke pendahulunya yang disertakan. Sebuah
catatan yang dipersingkat tetap mempertahankan hash dan tanda tangan aslinya, sehingga tanda tangan tersebut masih dapat diverifikasi, tetapi
bidang-bidang yang disembunyikan tidak dapat dihitung ulang darinya; catatan tersebut menyebutkan apa yang disembunyikan dan laporan
menandainya. Catatan layanan di seluruh akun (mulai dan berhenti, celah cakupan, pemberitahuan koneksi, jaringan, dan penyimpanan,
perubahan cakupan dan pengaturan) hanya menyimpan bidang yang tercantum untuk jenisnya: daftar obrolan di dalamnya dipotong sesuai
obrolan yang dipilih dan jumlah totalnya dihitung ulang, serta celah pemeriksaan langsung dalam obrolan di luar pilihan akan menghilangkan obrolan tersebut, nomor pesannya,
dan akun saksi; dalam obrolan pemeriksaan yang dipilih, akun saksi diganti dengan nama samarannya kecuali
semua orang ditampilkan atau akun tersebut merupakan salah satu dari orang-orang yang dipilih. Manifest tersebut mencantumkan panjang jurnal dan header-nya beserta tanda tangan pengumpul di atas
header tersebut, serta menghitung catatan yang diabaikan; `coverage.json` mendeskripsikan obrolan yang dipilih. Ekstrak baru juga
menyertakan `proofs.jsonl`: untuk setiap catatan yang disertakan dan untuk header jurnal, jalur Merkle dari
hash asli catatan tersebut ke akar jurnal yang disebutkan dalam manifest yang ditandatangani. verify.py memeriksa setiap
jalur, sehingga setiap catatan terbukti termasuk dalam jurnal yang sama dengan panjang dan header tersebut, tanpa perlu
jurnal lengkap; ekstrak berisi 100 pesan dapat diverifikasi dalam sekitar satu detik terlepas dari ukuran jurnal.
--range=CHAT:FROM-TO juga memastikan bahwa pesan dari FROM hingga TO dalam sebuah obrolan terdapat dalam ekstrak
dan melaporkan berapa banyak catatan yang telah diperiksa untuk pesan-pesan tersebut. Nama-nama di dalam
nama berkas tidak terdeteksi. Periksa berkas akhir sebelum membagikannya: teks bebas, nama berkas, dan
lampiran yang dipilih masih dapat mengidentifikasi orang. Simpan ZIP lengkap yang telah ditandatangani: ekstrak ini merupakan pengungkapan, bukan pengganti.
Laporan yang mudah dibaca#
Bukti yang ditandatangani, serah terima, dan file ZIP obrolan berisi laporan HTML dan JSON yang dapat dibaca, serta
PDF jika font yang diperlukan tersedia, dalam bahasa laporan yang dipilih. Setiap
laporan disegel dengan kunci Ed25519 ruang kerja dan dapat diverifikasi secara terpisah: `
python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`.
report.html/chat.html: pernyataan penyegelan (tgwitness-report-seal-v1) menutup berkas dan menandatangani SHA-256 untuk setiap byte di depannya. Jurnal dan obrolan yang panjang dibagi menjadi bagian-bagian dengan ukuran yang dapat dikonfigurasi (Pengaturan Laporan, 500 hingga 100.000 catatan; 5.000 secara default):records/records-0001.htmlataumessages/messages-0001.html, masing-masing disegel dengan nomor, rentang, dan totalnya, serta dicantumkan bersama SHA-256-nya dalam manifes yang ditandatangani. Rangkaian sinyal detak jantung pengumpul ditampilkan sebagai satu baris kecuali jika Pengaturan Laporan mencantumkannya satu per satu.report.json(tgwitness-report-json-v1, kunciformat,report,seal): segel tersebut menandatangani SHA-256 dari JSON kanonik darireport, sehingga fakta-fakta tersebut dapat dibaca oleh sistem dan skrip kasus dan pemilihan untuk perlindungan data dapat dilakukan darinya sementara berkas yang ditandatangani tetap utuh.report.pdf/chat.pdf: dokumen resmi untuk dicetak dan disimpan, ditandatangani dua kali pada byte yang sama, seluruh berkas kecuali nilai tanda tangan (/ByteRange). Tanda tangan PDF standar adalah PAdES baseline (ETSI EN 319 142-1,/SubFilter /ETSI.CAdES.detached: CMS dengan SHA-256 dan ECDSA P-256, sertifikat penandatanganan v2, tanpa waktu penandatanganan CMS; waktu yang diklaim adalah/M) pada tingkat B-B, atau B-T dengan cap waktu tanda tangan RFC 3161 di dalam CMS saat fitur cap waktu diaktifkan dan otoritas cap waktu merespons melalui rute untuk permintaan di luar Telegram. Sistem ini menggunakan sertifikat penandatanganan dokumen yang diterbitkan sendiri dan disimpan di brankas ruang kerja; nomor seri subjeknya adalah sidik jari kunci Ed25519. Segel Ed25519 dikirimkan di dalam CMS sebagai atribut yang tidak ditandatangani2.25.240684792623320047764573196045913242332dan mencantumkan SHA-256 sertifikat tersebut dengan"content": "pdf-byte-range", sehingga kunci Ed25519 menjamin keaslian sertifikat tersebut. Sertifikat ini tidak terakreditasi: pembaca PDF akan menampilkan tanda tangan sebagai valid dan penandatangan sebagai tidak dikenal atau tidak tepercaya hingga sertifikat tersebut dipercaya; bandingkan sidik jari Ed25519 sebagai gantinya. PDF berbahasa Mandarin, Jepang, dan Korea memerlukan font di server (atau diTGWITNESS_FONT_DIR); tanpa font tersebut, berkas ZIP hanya berisi laporan HTML dan JSON saja.report.en.html,report.en.pdf/chat.en.html,chat.en.pdf: dokumen asli berbahasa Inggris dari laporan yang sama jika bahasa laporan bukan bahasa Inggris, disegel dan ditandatangani dengan cara yang sama serta disebut di bawahreport.originaldalam manifes bertanda tangan. Laporan dalam bahasa yang dipilih dibuka dengan rekomendasi untuk mengajukan dokumen asli berbahasa Inggris bersama terjemahan tersertifikasi atau tersumpah; lihat Menerjemahkan laporan untuk pengadilan.
Dalam saluran atau supergrup, Telegram
menomori pesan 1, 2, 3… secara berurutan. Ekspor obrolan mencantumkan
nomor pertama dan terakhir, jumlah yang ada, serta setiap rentetan nomor yang tidak ada dalam
message-ids.json
, manifes, dan header chat.json
, serta menandai setiap celah di mana celah tersebut berada dalam
transkrip. verify.py
menghitung ulang nomor-nomor tersebut mulai dari chat.json
. Nomor yang hilang adalah pesan yang tidak dikembalikan oleh Telegram
(dihapus sebelum ekspor, atau tidak terlihat oleh akun); dalam obrolan pribadi dan
grup dasar, nomor-nomor tersebut dibagikan di semua obrolan akun tersebut dan celah tidak dihitung.
Setelah membaca riwayat, proses ekspor akan meminta Telegram untuk setiap nomor yang tidak ada lagi, berdasarkan nomor (channels.getMessages, hingga 10.000 nomor termasuk 1.000 nomor di bawah pesan pertama, yang tersebar merata di seluruh celah jika jumlahnya lebih banyak). Hasilnya terdapat di message-ids.json dan laporan. Jawaban kosong mencatat bahwa nomor tersebut tidak tersedia untuk akun ini pada saat pemeriksaan ulang; penyebabnya tidak disebutkan. Pesan yang dikembalikan pada pemeriksaan ulang ditambahkan ke ekspor dan ditandai found_on_recheck.
Ketika ruang kerja pengamatan mendeteksi pesan obrolan yang dihapus, hilang saat diperiksa ulang, atau diedit, ekspor obrolan akan menambahkan journal-changes.jsonl: catatan jurnal tersebut, setiap versi yang disimpan, dan pemberitahuannya, masing-masing disertai dengan hash dan tanda tangan Ed25519 yang diterimanya dalam jurnal. verify.py menghitung ulang hash setiap catatan, memeriksa tanda tangannya terhadap kunci ekspor, dan membandingkan jumlahnya dengan manifes yang ditandatangani; ekspor bukti menyimpan rantai hash lengkap. Laporan mencantumkan pesan-pesan ini di bawah "Penghapusan" dan "Versi sebelumnya".
Setiap laporan diawali dengan Singkatnya: satu paragraf, kemudian apa yang ditunjukkan oleh materi tersebut dan apa isi catatan. Stempel segel pada halaman tersebut berubah menjadi kuning ketika browser telah memeriksa tanda tangan segel tersebut, bukan halaman itu sendiri: browser tidak memberikan byte-nya sendiri kepada halaman. Stempel tersebut berubah menjadi hijau hanya ketika pembaca memasukkan berkas ke dalam pemeriksaan di bagian akhir halaman dan setiap byte cocok, serta hanya jika halaman yang ditampilkan adalah berkas tersebut; jika tidak, stempel berubah menjadi merah.
Setiap laporan menyebutkan nama program secara tepat: commit Git saat pengumpul berjalan dari checkout atau
penginstal menetapkan TGWITNESS_COMMIT, serta SHA-256 dari berkas sumbernya (source_tree_sha256,
JSON kanonik dari jalur → SHA-256 dari setiap berkas .py, .js, .css, .html, dan .svg dalam
paket), yang direproduksi oleh checkout dari commit tersebut kecuali jika berkas-berkas tersebut telah diubah. Telegram
klien dinamai berdasarkan perpustakaannya, lapisan API, dan pusat datanya. Saat pemantauan dimulai dan saat ekspor obrolan
dimulai serta diakhiri, pengumpul meminta waktu dari Telegram (updates.getState, dalam
detik penuh) dan mencatat waktu Telegram dikurangi waktu jam pengumpul, dengan ketidakpastian akibat
perjalanan bolak-balik; laporan menampilkan pengukuran ini di bawah Rantai Pengawasan. Ekspor obrolan juga mencatat
waktu saat riwayat dibaca, selain tanggal pesan-pesan tersebut.
Panduan penampil laporan dan arsip offline#
Ekstrak ZIP secara lengkap sebelum membuka chat.html atau report.html. Penampil menyediakan fitur pencarian,
filter, peserta, indikator, detail rekaman, serta pilihan JSON/CSV tanpa memerlukan server. Simpan
viewer/ dan media/ di samping laporan. Pilihan-pilihan tersebut merupakan turunan: gunakan verify.py SELECTION.json
--evidence ARCHIVE.zip untuk membandingkannya dengan arsip yang ditandatangani.
Verifikator memeriksa ID laporan, kunci penandatanganan, batas arsip, dan setiap item yang dipilih; item yang diedit,
hilang, dan duplikat akan ditolak. Catatan pemilihan dan waktu pembuatan tetap menjadi metadata yang tidak ditandatangani.
Kesenjangan nomor pesan hanya ditampilkan untuk umpan obrolan yang lengkap, tidak difilter, dan disusun secara ascending. Menyembunyikan suatu kategori atau kegagalan memuat potongan data tidak boleh mengubah baris yang dihilangkan menjadi bukti adanya pesan yang hilang . Penyorotan pencarian diterapkan pada teks biasa sebelum proses escaping HTML, dengan mempertahankan markup literal.
Browser ini memeriksa tanda tangan manifest, ID laporan dan kuncinya, serta semua hash file yang tercantum. Browser ini menolak struktur ZIP yang ambigu atau tidak valid, nama yang duplikat, dan jalur yang tidak aman, serta membatasi ukuran file hingga 256 MiB dan total isi yang dinyatakan hingga 4 GiB. Gunakan verifikator mandiri untuk arsip yang lebih besar. Pemeriksaan browser ini melengkapi pemeriksaan verifikator terhadap rantai jurnal dan semantik data.
README.txt berisi panduan awal, inventaris berkas yang disesuaikan, petunjuk verifikasi, dan
catatan format data dalam bahasa laporan, diikuti dengan panduan lengkap dalam bahasa Inggris. SHA256SUMS mencakup
file-file yang tercantum di dalamnya, tidak termasuk file itu sendiri, manifest.json, dan manifest.sig; manifest yang ditandatangani
juga mencakup SHA256SUMS. Pertahankan ZIP asli tanpa perubahan dan simpan file kerja di luar
folder yang diekstrak. Laporan PDF mencakup penanda bagian dan identifikasi kasus/laporan pada halaman-halaman selanjutnya.
Percakapan pada saat ekspor#
Ekspor obrolan mencatat apa yang dikatakan Telegram tentang obrolan tersebut saat ekspor dimulai: label milik Telegram
sendiri (scam, fake, restricted beserta alasannya, verified), nama pengguna, deskripsi, jumlah
anggota dan admin, diskusi yang tertaut, perlindungan konten, apakah anggota baru dapat melihat pesan sebelumnya
dan mulai dari pesan mana akun ini dapat melihat riwayat (available_min_id), tanggal
pesan pertama saat obrolan tersebut dibuat, dan SHA-256 foto obrolan (disimpan di media/).
Data ini mencatat posisi akun yang mengekspor dalam obrolan: peran, tanggal bergabung, siapa yang mengundangnya, dan, bagi seorang
admin, hak aksesnya. Permintaan yang ditolak oleh Telegram akan disebutkan sebagai gantinya.
Jika akun yang mengekspor adalah admin, ekspor tersebut membaca log admin obrolan (Telegram menyimpannya selama sekitar
48 jam) ke dalam admin-log.json: penghapusan dan pengeditan beserta konten yang disertakan,
akun yang bertindak, dan tanggal tindakan sumber. Entri-entri ini melengkapi
versi yang ditangkap dari jurnal langsung serta catatan penerimaan penghapusan.
Indikator#
Daftar laporan, dan arsip tersebut berisi indicators.csv
, indicators.stix.json
(STIX 2.1
)
serta indicators.misp.json
(peristiwa MISP
), yang dapat ditindaklanjuti oleh bagian penanganan penyalahgunaan dalam pesan yang terekam:
tautan dan domain (termasuk yang tersembunyi di balik teks, di tombol, dan di pratinjau tautan), alamat mata uang kripto,
nama pengguna dan tautan undangan Telegram
, nomor telepon, alamat email, serta gambar yang disimpan.
Alamat Bitcoin, Litecoin, Dogecoin, dan TRON hanya dicantumkan jika checksum base58-nya valid,
alamat SegWit jika checksum bech32 atau bech32m-nya valid, dan alamat TON jika CRC-nya
valid; alamat EVM dan Solana ditandai sebagai belum diperiksa. Gambar disertai SHA-256
dan hash perseptual
(dHash, 64 bit) yang tetap hampir tidak berubah pada salinan yang dikompres ulang atau diubah ukurannya. Laporan mencatat
indikator agar tidak terbuka secara tidak sengaja (hxxps[://]example[.]com
); berkas-berkas tersebut mempertahankan
nilai-nilai sebagaimana adanya. Setiap indikator ditandai sebagai tidak dikenal dan tidak untuk deteksi otomatis (STIX
,
indicator_types: unknown
, MISP
, to_ids: false
, distribusi ke organisasi sendiri):
tercantumnya indikator tersebut menunjukkan bahwa pesan tersebut mengandung indikator tersebut, bukan berarti indikator tersebut berbahaya. Tautan yang teksnya menampilkan
alamat yang berbeda dari yang sebenarnya dibuka ditandai dalam laporan.
Laporan PDF diakhiri dengan pernyataan pemeriksa yang harus ditandatangani secara manual, daftar periksa untuk notaris atau ahli pengadilan, serta kode QR (juga terdapat di halaman pertama) yang berisi ID laporan, sidik jari kunci, dan SHA-256 dari data otoritatif, sehingga cetakan laporan tersebut dapat dilacak kembali ke arsipnya.
Kanonikalisasi peristiwa#
Masukan hash terdiri dari bidang-bidang berikut ini:
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
Serialisasikan menggunakan JSON yang kompatibel dengan Python dengan UTF-8, kunci objek yang diurutkan, tanpa escaping ASCII, tanpa spasi kosong yang tidak signifikan, dan tanpa NaN/infinity:
json.dumps(value, ensure_ascii=False, sort_keys=True,
separators=(",", ":"), allow_nan=False).encode("utf-8")
SHA-256 dari byte-byte tersebut menjadi hash peristiwa. Tanda tangan menggunakan Ed25519 atas 32 byte hash mentah, kemudian dikodekan dengan base64. Previous_hash pertama adalah 64 angka nol. Nomor urut dimulai dari 1 dan bertambah 1 setiap kali. Semua peristiwa, termasuk peristiwa operasional, berada dalam satu rantai. Tidak ada penekanan pengiriman ganda: pengamatan yang berulang merupakan bukti terpisah, bukan klaim adanya tindakan Telegram yang berbeda.
Data mentah Telegram berbentuk string ISO; bidang biner diubah menjadi objek yang berisi
bytes_base64. Teks pesan, entitas, deskriptor media, metadata balasan, reaksi,
dan tindakan layanan disimpan dalam metadata pesan mentah jika disertakan. Sebuah pesan langsung
juga menyimpan pembaruan Telegram yang mengirimkannya transport_update; ketika
pembaruan tersebut membawa pesan yang sama dengan raw, message bidang tersebut
{"same_as": "raw"} bukan salinan kedua.
observed_at adalah waktu UTC saat kolektor menulis catatan tersebut; source_at adalah tanggal
yang disediakan oleh peristiwa Telegram tersebut. Catatan yang ditulis saat menangani pembaruan langsung menambahkan
payload.received_atwaktu UTC saat pembaruan tersebut diterima oleh pengumpul, dan
payload.processing_delay_ms. Pengeditan langsung mempertahankan tanggal pengeditan yang disediakan,
cuplikan riwayat mempertahankan tanggal pesan dengan waktu pengamatan saat ini, dan
pemberitahuan penghapusan biasa mencatat waktu penerimaan dengan tanggal sumber null. Entri
log admin mempertahankan tanggal tindakan yang disediakan secara terpisah. Urutan penerimaan dan urutan
peristiwa sumber merupakan garis waktu yang berbeda, dengan pengamatan waktu dan bukti penerimaan eksternal
tersedia untuk perbandingan.
Semantik aktor#
Atribusi mengikuti sumber peristiwa. message.new.actor_id dan
message.edited.payload.sender_id mempertahankan pengirim pesan. Pemberitahuan biasa
message.deleted membawa ID pesan dan memiliki bidang aktor bernilai null;
entri log admin yang tersedia membawa tindakan, aktor, dan tanggal yang disediakan.
Pesan layanan keanggotaan mempertahankan pengirim dan jenis tindakan, pembaruan peserta mentah
mempertahankan actor_id yang disediakan, dan cuplikan reaksi mempertahankan
jumlah dan identitas yang terlihat yang disediakan. Bacalah catatan-catatan ini bersama dengan versi
yang ditangkap dan tanda terima interaksi panel.
Pemberitahuan penghapusan untuk obrolan pribadi dan grup biasa hanya berisi ID pesan.
Obrolan-obrolan tersebut berbagi satu urutan ID yang berlaku untuk seluruh akun, sehingga sebuah ID mengidentifikasi satu pesan dari
akun ini. Ketika pesan dengan ID tersebut telah disimpan sebelumnya dalam jurnal ini,
penghapusan tersebut dicatat dalam obrolan tersebut sebagai `message.deleted` dengan `payload.chat_resolution`
sebagai nama metode. ID yang tidak pernah disimpan disimpan sebagai deletion.unscoped: sebuah
pemberitahuan penghapusan aktual yang obrolannya belum dikorelasikan. Hal ini berbeda
dari message.missing_on_recheck, yang mencatat hasil kueri yang tidak tersedia, dan
dari celah dalam ID pesan yang disimpan. Saluran dan supergrup menomori pesan per obrolan dan
tidak pernah dicocokkan dengan cara ini. Ketika pesan yang dihapus dikirim oleh akun yang diamati,
payload.deleted_message_was_outgoing bernilai true; pengirim penghapusan masih belum ditentukan.
Pemberitahuan tanpa cakupan mempertahankan labelnya sendiri karena obrolan yang cocok mungkin berada di luar cakupan pengamatan saat ini atau tidak memiliki kecocokan yang unik. Pemeriksaan ulang ketidakhadiran tetap menjadi pengamatan terpisah dari pemberitahuan penghapusan dalam hitungan laporan, filter, dan label. Pemulihan selanjutnya menghapus status hilang saat ini sambil mempertahankan pemeriksaan yang sebelumnya tidak berhasil dalam riwayat yang ditandatangani; pemberitahuan penghapusan tetap menjadi jenis peristiwa terpisah.
Beberapa ID yang merujuk ke obrolan yang sama dari satu pemberitahuan dikelompokkan sebagai `
deletion.batch`, terlepas dari jumlahnya, dengan ID pesan persis seperti yang dikirim oleh Telegram
serta berapa banyak pesan yang telah dikirim oleh akun ini. Pemberitahuan Telegram
mencantumkan pesan-pesan tersebut; log admin obrolan mencantumkan nama administrator yang bertindak, di mana akun
tersebut dapat membacanya. Tautan (message.deletion_attributed) dibuat berdasarkan mana yang tiba lebih dulu:
sebuah polling yang mendeteksi entri log admin sebelum pemberitahuan penghapusan akan dicocokkan saat pemberitahuan
tersebut tercatat.
Cakupan: kontinuitas, celah, dan ID yang tidak terdeteksi#
Setiap berkas ZIP yang ditandatangani berisi coverage.json, laporan HTML dibuka dengan ringkasan yang sama, dan
verify.py menghitung ulang ringkasan tersebut dari events.jsonl alih-alih mempercayai berkas tersebut:
- Pengamatan dilakukan secara berkelanjutan dari X hingga Y. Sebuah periode dimulai dengan
observation.starteddan berakhir pada saat jeda, penghentian, koneksi Telegram terputus, logout, proses dimulai tanpa penghentian yang teratur, atau lebih dari tiga menit tanpa catatan apa pun selama pengamatan (detak jantung ditulis setiap menit, sehingga keheningan berarti proses berhenti, macet, atau komputer dalam mode tidur). Ketika interval detak jantung diubah di More tools → Parameters, setiap detak jantung mencatatnya dan waktu diam yang diperbolehkan menjadi tiga interval, tidak pernah kurang dari tiga menit. - Daftar celah mencantumkan selang waktu antar periode beserta alasannya. Celah yang masih terbuka pada catatan terakhir
ditandai dengan kode
not_resumed_by_last_record. - ID pesan tidak tercatat. Untuk saluran dan supergrup, yang menghitung jumlah pesan per obrolan, ID yang hilang di antara ID yang tercatat dicantumkan sebagai rentang. ID tersebut dilaporkan sebagai tidak tercatat — dihapus, tidak pernah terkirim, atau berada di luar riwayat yang disimpan — bukan sebagai dihapus. Obrolan pribadi dan grup biasa menggunakan urutan ID yang sama untuk seluruh akun, sehingga celah di dalam satu obrolan semacam itu tidak berarti apa-apa dan tidak dicantumkan di sana.
- Pemberitahuan celah pada tingkat obrolan (misalnya, Telegram meminta pemulihan perbedaan di satu saluran) dihitung sebagai catatan; pemberitahuan tersebut tidak mengganggu cakupan global.
- Catatan sesi. Jendela-jendela di mana penghitung pembaruan Telegram bertambah meskipun tidak ada pembaruan
yang sampai ke sesi ini (
updates_diverted), sesi ini keluar dari daftar sesi Telegram sementara koneksinya tetap aktif (session_revoked_externally), atau jawaban dari probe saksi hanya diterima dari riwayat (probe_ack_missed_live) dicantumkan secara terpisah. Verifikator juga melaporkan asal kunci sesi Telegram, sesi lain yang masuk saat pengamatan dimulai, sesi yang ditambahkan selama pengamatan, pemberitahuan keamanan Telegram (777000), sesi lain yang berakhir dari ruang kerja, periode hanya-sesi, jumlah probe saksi , dan pembaruan panggilan telepon. Lihat akun. Saat fitur obrolan terpilih yang ketat diaktifkan (scope.strictdiobservation.started), daftar sesi (kecuali saat ini adalah satu-satunya sesi, atau saat perangkat Telegram aktif), pemberitahuan keamanan, dan pembaruan panggilan telepon tidak dikumpulkan, sehingga ketidakhadiran mereka tidak berarti apa-apa, dan penghapusan hanya dicocokkan dengan sesi hanya jika sesi tersebut berjalan dalam 10 menit sebelumnya.
Urutan pembaruan (pts)#
Telegram mencatat pembaruan terkait pesan dengan pts: satu urutan untuk akun
(obrolan pribadi dan grup dasar digabungkan) serta satu urutan untuk setiap saluran atau supergrup.
Pengumpul mencatat setiap rentang yang diterimanya tanpa celah sebagai coverage.sequence
catatan: yang pertama dan terakhir pts, jumlah pembaruan dari setiap jenis, dan apakah pembaruan tersebut
dikirim secara langsung atau dikembalikan oleh getDifference atau getChannelDifference. Adanya jeda merupakan sebuah
coverage.gap catatan, dan coverage.gap_closed menamai pts titik di mana urutan
tersebut utuh kembali.
Rangkaian yang tak terputus menunjukkan bahwa setiap pembaruan Telegram yang diberi nomor dalam urutan tersebut, mulai dari
yang pertama hingga yang terakhir, pts telah sampai ke klien Telegram milik pengumpul ini. Hal ini tidak menunjukkan apa pun mengenai
konten Telegram yang tidak pernah dikirim ke akun ini, mengenai waktu sebelum pembaruan pertama yang tercatat
pts, maupun mengenai rentang yang tidak dicatat oleh pengumpul. Sebuah pts perbedaan yang tidak
tercakup oleh rentang atau selisih yang tercatat akan ditampilkan sebagai jeda.
GET /api/continuity jawaban untuk suatu interval (since, until, chat_id) apakah setiap
urutan tidak terputus dan mencantumkan titik-titik putusnya beserta alasannya. verify.py mencetak hal yang sama
dari catatan arsip di bawah bagian “Kelangsungan Urutan”.
Nomor pesan yang hilang (gap_summary)#
For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.
Pratinjau. coverage.json → gap_summary mengukur nomor-nomor yang ditetapkan oleh Telegram dan yang
belum pernah terdeteksi oleh pengumpul ini. Telegram menomori pesan sekali per saluran atau supergrup, dan sekali per
akun di seluruh obrolan pribadi, bot, dan grup biasa. Nomor di antara dua pesan yang teramati
bisa teramati atau hilang; rentang yang berurutan merupakan pernyataan positif bahwa
setiap pesan yang diberi nomor di dalamnya telah teramati. Adanya celah tidak menunjuk pada aktor maupun alasan apa pun.
| Bidang | Arti |
|---|---|
status |
on, atau off saat dinonaktifkan di More tools → Parameters → Gap analysis |
parameters |
Parameter-parameter yang menghasilkan hasil tersebut, sehingga prosesnya dapat diulang |
chats[] |
Satu entri per saluran atau supergrup, masing-masing diberi nomor tersendiri |
account |
Urutan obrolan pribadi, bot, dan grup biasa di seluruh akun |
status (per urutan) |
applicable, atau not_applicable dengan reason |
observed_from, observed_to, span |
Nomor pertama dan terakhir yang diamati serta ukuran rentangnya |
observed, observed_without_content |
Nomor yang teramati; yaitu nomor yang hanya diketahui dari catatan penghapusan atau pemeriksaan ulang |
missing, density, gap_ranges, largest_gap |
Jumlah yang tidak pernah teramati, persentase dari rentang, jumlah putaran, dan putaran terpanjang |
clusters[] |
Kekurangan yang tercantum: low, high, missing, serta nomor-nomor yang teramati di sekitarnya after / before beserta waktu pengamatannya |
service_estimate |
Hanya jika diaktifkan: berapa banyak nomor yang hilang yang akan menjadi pesan layanan berdasarkan porsi pengamatannya. Tidak pernah dikurangkan dari missing |
Validitas diperoleh dari jurnal, tidak pernah diasumsikan:
- Saluran dan supergrup diukur per obrolan, termasuk dalam ekspor obrolan yang dipilih.
Catatan yang dipilih berdasarkan pengirim menjadi dasar pengukuran
not_applicable. - Urutan pesan di seluruh akun hanya diukur dari pesan pertama hingga pesan terakhir yang
diterima saat pengumpulan data seluruh akun diaktifkan, dan mencakup obrolan pribadi, bot, grup biasa,
serta pesan dari akun itu sendiri, tanpa mengecualikan obrolan apa pun (
scope.changed). Angka yang disebutkan olehdeletion.unscopeddihitung sebagai yang teramati tanpa konten. Ekspor atau penyerahan obrolan yang dipilih tidak dapat mengukurnya. Jika pengumpulan seluruh akun dinonaktifkan dan diaktifkan kembali, sebuah catatan menyatakan bahwa angka yang digunakan selama periode tersebut muncul sebagai celah. - Pesan layanan adalah catatan jurnal dengan nomornya masing-masing, sehingga celah-celahnya terisi dengan sendirinya; perkiraan opsional hanya berfungsi sebagai konteks.
verify.py menghitung ulang gap_summary dari events.jsonl dengan parameter dalam
coverage.json (nilai default untuk arsip lama) dan
mencetak baris untuk seluruh akun dalam ringkasan cakupannya. get_capture_status(MCP dan baris perintah) mengembalikan pengukuran yang sama untuk obrolan yang dapat dibaca oleh suatu akses;
urutan seluruh akun hanya dapat diakses jika mencakup seluruh ruang kerja.
Pengamatan berulang terhadap satu pesan layanan dihitung satu kali, dan perkiraan layanan akun hanya menggunakan angka di dalam rentang yang diukur. Ruang lingkup yang diterapkan harus secara eksplisit mempertahankan pesan milik akun itu sendiri sebelum pengukuran di seluruh akun diaktifkan; pengukuran dimulai dari catatan yang membawa informasi tersebut. Rentang yang diukur mencakup pengamatan yang sedang berjalan, dan pelanjutannya dicatat. Kueri arsip langsung memiliki anggaran waktu, termasuk pemindaian basis datanya, dan menandai pengukuran yang belum selesai sebagai pengukuran parsial.
Telegram mendokumentasikan urutan ID pesan yang terpisah. Angka-angka ini menggambarkan pengamatan; pemberitahuan penghapusan, pemeriksaan ulang, dan catatan log admin mengapa suatu angka tidak ada di tempat yang dilaporkan oleh Telegram.
Ketika Telegram berhenti menerima akun tersebut, catatan coverage.gap yang mengakhiri pemantauan
mengandung cause (account_banned, account_frozen, account_deleted, session_duplicated,
session_revoked, session_expired, session_ended, atau not_authorized) dan Telegram
kesalahan; verify.py menyebutkan penyebab di mana periode tersebut berakhir.
Cakupan menggabungkan periode pengamatan yang tercatat, gangguan, dan hasil pesan. Nilai hal ini bersama dengan obrolan yang dipilih, periode, dan kebijakan lampiran; periksa ulang hasil dan celah yang tercatat menunjukkan seberapa lengkap pembaruan akun tersebut diamati.
Produser#
Manifest yang ditandatangani dari berkas ZIP bukti, ekspor obrolan, jurnal saksi, dan pernyataan
berkas profil pengguna berisi producer: perangkat lunak, versi, proyek (PhishDestroy),
halaman utama, dan repositori sumber. Laporan HTML dan verifikator menampilkan catatan
produsen yang ditandatangani ini. Hash berkas sumber mengidentifikasi pohon sumber yang direkam untuk perbandingan
dengan checkout tepercaya. Asal-usul eksekusi diperiksa secara terpisah melalui
pengesahan akuisisi GitHub atau
pengukuran Intel TDX, jika diaktifkan. Arsip yang dibuat sebelum
bidang produser ada tetap didukung dan diidentifikasi sebagai catatan warisan.
Setiap catatan observation.started juga menyebutkan klien Telegram yang melakukan pemantauan: api_id-nya
(bukan hash-nya), apakah itu pasangan publik bawaan atau aplikasi milik operator,
deskripsi klien yang dikirim dalam permintaan koneksi Telegram, serta jenis rute koneksi
dengan mode IP (tanpa alamat proxy atau rahasia). Laporan dan custody.json mencantumkan setiap
klien dan rute yang berbeda beserta waktu perekamannya, serta waktu-waktu ketika tidak ada proxy yang terdaftar yang merespons
dan Telegram mendeteksi alamat server. Jurnal yang direkam sebelum ini menyatakan hal tersebut.
Profil orang#
File profil (tgwitness-dossier-v1, JSON) dibuat berdasarkan permintaan dari catatan yang sudah ada di
jurnal untuk satu obrolan; tidak ada data yang diambil dari Telegram dan isi profil tidak pernah
ditulis ke jurnal (mengaktifkan dan menonaktifkan profil dicatat sebagai dossier.changed).
Untuk setiap orang dengan pesan yang disimpan, alat ini mencantumkan nama dan riwayat nama pengguna, status Telegram
(bot, penipuan, palsu, premium, terverifikasi, dibatasi, dihapus) sebagaimana terlihat pada saat penyimpanan,
foto identitas, SHA-256, dan hash perseptual (pHash, kompatibel dengan imagehash.phash) dari
avatar yang diambil dari cache avatar lokal beserta avatar serupa, aktivitas (pesan pertama dan terakhir,
jumlah, berbagi yang diedit dan dihapus, pesan per jam UTC), siapa yang membalas siapa, obrolan lain
dalam jurnal ini di mana orang tersebut menulis, serta dompet yang disebutkan (BTC, EVM, TRON, TON, LTC,
DOGE, XMR, SOL; alamat Base58Check telah diverifikasi checksum-nya), nomor telepon, nama pengguna, dan
tautan, termasuk tautan yang tersembunyi di balik teks.
Setiap fakta mencantumkan catatan jurnal (seq) asalnya, dan record_hashes menyimpan
hash dari setiap catatan yang dirujuk. Pernyataan tersebut ditandatangani dengan kunci ruang kerja:
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
memeriksa tanda tangan, memverifikasi ekspor bukti itu sendiri (tanda tangan, rantai hash, dan berkas) serta memastikan setiap catatan yang dirujuk tetap ada tanpa perubahan dalam ekspor ruang kerja yang sama tersebut. Hash avatar diberi label sebagai berasal dari cache lokal (bukan catatan jurnal). Sebutan merupakan pencocokan pola dan petunjuk untuk diperiksa. Profil diaktifkan per obrolan, dapat diekspor sebagai ZIP AES-256 dengan kata sandi, dan dihapus saat dinonaktifkan atau saat obrolan dihapus dari sumber.
Saksi independen#
Jurnal saksi (tgwitness-witness-v1) dan postingan salurannya diperiksa berdasarkan
ekspor bukti dengan perintah verify.py --witness … --channel …; lihat saksi independen.
Dengan alamat publik https://t.me/s/… atau https://telegram.me/s/…, verifikator membaca
tanggal setiap postingan dari Telegram, dan tanggal paling awal dari postingan tersebut di bagian awal ekspor
menjadi waktu eksternal untuk catatan terakhir. Tanggal dari sumber lain apa pun merupakan metadata yang disediakan.
Manifest dan titik pemeriksaan#
manifest.json mencakup format, waktu ekspor, kunci publik, sidik jari, panjang jurnal,
hash kepala, cakupan, produsen, batasan, dan SHA-256 dari setiap anggota konten selain
manifest.json dan manifest.sig itu sendiri.
manifest.sig adalah tanda tangan base64 Ed25519 atas manifest JSON kanonik.
Verifikator akan menolak anggota yang tidak terduga/hilang, nama yang duplikat, berkas yang rusak,
urutan/rantai yang terputus, tanda tangan yang tidak valid, dan ketidaksesuaian dengan titik pemeriksaan yang disediakan.
Verifikator tidak pernah mengekstrak jalur arsip. Verifikator membatasi ukuran total yang dinyatakan (tanpa kompresi) hingga 4 GiB;
--max-gib N memungkinkan arsip yang lebih besar yang dibuat dengan batas yang ditingkatkan melalui More tools → Parameters.
Arsip berukuran besar diperiksa oleh beberapa proses secara bersamaan: anggota arsip di-hash secara paralel,
dan setelah 5.000 catatan pertama, hash konten dan tanda tangan setiap catatan diperiksa
oleh proses pekerja sementara proses utama menelusuri rantai, cakupan, dan pengikatan
secara berurutan. --jobs N menentukan jumlah proses; nilai default auto menggunakan satu per CPU,
paling banyak 16, dan --jobs 1 menyimpan semuanya dalam satu proses. Hasilnya sama dalam kedua kasus tersebut,
dan perubahan akan ditolak dengan pesan yang sama. Hash pada posisi yang ditentukan oleh
titik pemeriksaan yang disimpan dan jangkar cap waktu disimpan selama satu putaran tersebut, sehingga setiap jangkar
dibandingkan tanpa perlu membaca jurnal lagi. Pada komputer dengan 32 utas, arsip berukuran 10,8 GB dengan
400.000 catatan membutuhkan waktu 58,9 detik dalam satu proses, 15,2 detik dengan 4 utas, dan 8,4 detik dengan 16 utas; satu kali pemrosesan atas
catatan secara berurutan kemudian menentukan batasnya.
Jalankan verifikasi dari versi TgWitness yang telah Anda instal atau dari checkout yang telah ditinjau. Salinan yang disertakan dalam arsip mendukung penggunaan portabel; bandingkan salinan tersebut dengan instalasi tepercaya Anda sebelum menjalankannya.
Sebuah checkpoint menandatangani pernyataan yang berisi kunci publik, panjang jurnal,
hash awal, dan waktu pembuatan. Checkpoint tersebut juga membawa putaran drand terbaru yang telah
diambil oleh ruang kerja (drand_anchor
): pengumpul meminta relai drand melalui
rute luar ruang kerja sebelum setiap checkpoint berkala, sehingga Hide IP, proxy, dan
rute luar yang dinonaktifkan berlaku, dan pembuatan checkpoint itu sendiri tidak pernah terhubung ke luar. Verifikator dapat memeriksa
apakah arsip yang lebih baru mengandung prefiks yang sama. Dengan --checkpoint
dan --check-drand
, verifikator mengonfirmasi putaran tersebut dengan relai drand dan melaporkan bahwa checkpoint ditandatangani
tidak lebih awal dari waktu putaran tersebut; putaran tersebut tidak mengubah tingkatan jaminan. Simpan
titik pemeriksaan di luar pengumpul, sehingga verifikasi selanjutnya membandingkan arsip dengan
referensi yang disimpan secara terpisah darinya. Kunci pengumpul menandatanganinya, sehingga
hal ini mengikat catatan ke pengumpul hanya jika penerima memperolehnya sebelum arsip, melalui
saluran lain; dengan sendirinya, hal ini tidak memenuhi syarat minimum sebagai bukti.
Membaca hasil verifikasi#
Verifikator melaporkan integritas arsip, verifikasi penanda tangan, dan pemeriksaan jaminan
secara terpisah. Tanda tangan yang sah menunjukkan bahwa byte-byte tersebut tidak berubah sejak
ditandatangani. Operator memberikan sidik jari kunci kepada penerima melalui saluran
terpisah. Tanpa --fingerprint, arsip yang utuh lulus pemeriksaan tanda tangan dan formatnya
dengan signer_pinned: false, dan baris terakhir dimulai dengan
EVIDENCE: minimum not met · missing: confirmed signer key.
Untuk kebijakan arsip lokal otomatis yang memerlukan penandatangan yang disematkan dan persyaratan minimum untuk bukti:
python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence
Gunakan sidik jari yang disimpan melalui saluran tepercaya penerima. Seorang saksi tepercaya
juga dapat mengikat pengumpul melalui jurnal yang disaksikan secara konsisten; berikan
--witness, --witness-fingerprint, dan --require-witness. --strict akan keluar dengan
status 2 jika penandatangan tidak terikat; jika --require-tier atau --require evidence tidak terpenuhi, program juga
akan keluar dengan status 2. --require evidence memerlukan --fingerprint dan waktu eksternal dari
pihak ketiga yang mencakup catatan terakhir.
Baca signer_pinned, requirements_met, dan hasil jaminan, bukan hanya
kode keluarnya saja. Sebaliknya, akuisisi tersegel menggunakan
verifikator atestasi dan kebijakan yang disetujui untuk mengautentikasi ringkasan akuisisi.
Ruang lingkup verifikasi#
Verifikasi memeriksa arsip dan mode pengumpulan yang digunakan untuk membuatnya. Pilih mode yang batas kepercayaannya sesuai dengan kasus tersebut, lalu pertahankan masukan verifikasinya.
| Mode pengumpulan | Apa yang diperiksa oleh verifikator | Masukan verifikasi dan batas kepercayaan |
|---|---|---|
| Ruang kerja lokal | Tanda tangan rekaman, rantai hash, manifest, dan byte lampiran | Sidik jari pengumpul yang disimpan oleh penerima dan waktu eksternal dari pihak ketiga: tanda terima RFC 3161 atau OpenTimestamps yang terverifikasi, atau posting saksi yang dibaca dari t.me. Titik pemeriksaan dan catatan saksi yang disimpan berfungsi sebagai pemeriksaan pendukung |
| Ruang kerja lokal dengan saksi independen | Pemeriksaan arsip serta kesesuaian dengan awalan jurnal sebelumnya yang disimpan oleh saksi | Sidik jari dan catatan saksi; catatan kontrol kunci milik kustodian menunjukkan siapa yang memegang kunci saksi. Dengan --channel https://t.me/s/…, tanggal yang ditetapkan Telegram pada postingan memberikan waktu eksternal |
| Penangkapan GitHub Actions | Pengesahan GitHub atas ringkasan arsip, alur kerja yang disetujui, dan komit pengumpul, pelaksana yang dihosting, asal sesi/kunci baru, serta integritas arsip internal | Kebijakan verifikator tepercaya, repositori pemanggil, dan paket pengesahan GitHub; proses pengumpulan data berjalan di bawah alur kerja yang disematkan |
| Penerapan di cloud | Catatan siklus hidup dan akses penyedia, status firewall dan Cloudflare, serta catatan eksekusi yang ditandatangani oleh pengumpul | Permintaan baca-saja ke penyedia layanan dan Cloudflare; ketersediaan pemeriksaan individual bergantung pada penyedia layanan |
| VM rahasia Intel TDX | Sebutkan tanda tangan dan status platform, yang terkait dengan pernyataan pengumpul, komposisi, dan pengukuran sistem operasi | Rantai kepercayaan Intel dan pengukuran penerapan yang diharapkan; pertahankan hasil dari setiap pemeriksaan TDX yang diperlukan |
Dalam akuisisi tertutup, pengumpul yang disetujui menerima data melalui koneksi Telegram yang terotentikasi di dalam lingkungan yang terverifikasi. Sertifikasi mengikat arsip ke eksekusi tersebut, sehingga verifikasi mencakup proses akuisisi serta integritas berkas di kemudian hari. Hal ini bergantung pada kode yang disetujui dan rantai kepercayaan platform yang tercantum di atas. Verifikasi penangkapan GitHub memerlukan sesi yang dibuat di dalam eksekusi dan menolak penangkapan dari sesi yang diimpor.
Tanda terima eksekusi mencatat versi pengumpul, hash file, dan pengaturan awal. GitHub asal-usul dan pengukuran TDX menyediakan pemeriksaan lingkungan; catatan validasi mengidentifikasi konfigurasi yang diuji.
Dari mana pesan-pesan tersebut berasal#
Telegram mengirimkan pesan ke setiap klien, termasuk aplikasi resmi, dalam sesi MTProto. Kunci otorisasi sesi tersebut dinegosiasikan berdasarkan kunci server yang disematkan Telegram, dan setiap pembaruan diterima dalam bentuk terenkripsi serta diperiksa integritasnya menggunakan kunci tersebut. Pengumpul menerima pesan melalui sesi terotentikasi akun tersebut dan mencatat setiap pengamatan ke dalam jurnal saat pesan tiba, beserta identifikasi obrolan, pesan, dan pengirim, serta tanggal yang ditetapkan Telegram pada setiap pesan. Di GitHub Actions dan penerapan Intel TDX, pengesahan juga mengikat sesi tersebut dan kunci penandatanganan ke eksekusi pengumpul yang disetujui.
Jurnal mencatat asal-usul kunci otorisasi. Masuk melalui telepon atau QR,
atau login independen dari berkas sesi, akan menulis account.authorized dengan
key_origin: "created"; pengumpulan pada kunci .session yang diimpor, TData, atau JSON akan menulis
imported. Kunci yang diimpor juga tetap ada di mana pun asalnya. Penerapan yang terverifikasi
menolak kunci yang diimpor.
Asal-usul suatu catatan di Telegram didasarkan pada koneksi terotentikasi akun tersebut,
catatan koneksi dan penangkapan dalam jurnal, bingkai MTProto yang ditangkap dan dicocokkan dengan entri jurnal
(tgwitness/forensics/), tanggal Telegram dari setiap
pesan, dan—untuk penangkapan yang terverifikasi—lingkungan eksekusi yang terverifikasi. Tanda tangan arsip
menyimpan catatan tersebut untuk pemeriksaan di kemudian hari. Titik pemeriksaan yang disimpan menetapkan batas jurnal
sebelumnya, catatan cakupan menunjukkan hasil pengumpulan, dan cap waktu eksternal yang terverifikasi
menempatkan byte yang telah dikomit ke dalam rentang waktu tertentu.
Untuk ruang kerja lokal, penerima menyediakan masukan dari pengumpul atau saksi tepercaya. Untuk akuisisi yang disegel, kebijakan tepercaya dan pengesahan mengikat ringkasan arsip ke eksekusi pengumpul yang disetujui. Ini adalah jalur verifikasi yang berbeda; laporkan pemeriksaan yang telah diselesaikan untuk jalur yang dipilih.
Lampiran#
File-file diidentifikasi berdasarkan SHA-256 di dalam direktori media/. Sebuah entri media.saved menghubungkan nilai hash dan panjang byte ke peristiwa pesan tertentu. Nama file mentah merupakan metadata, bukan jalur lokal. Byte media diunduh secara asinkron, sehingga penghapusan seketika dapat mencegah proses penangkapan data. Pengumpulan yang dinonaktifkan, berkas berukuran berlebihan/tidak diketahui, kegagalan unduhan, dan unduhan yang terputus akan ditampilkan sebagai hasil. Kerusakan proses dapat meninggalkan berkas parsial yang tidak terreferensikan; berkas-berkas tersebut tidak disertakan dalam ekspor.
Eksportir ZIP memverifikasi media yang disimpan berdasarkan namanya. Ekspor dalam format JSONL, CSV, dan HTML memverifikasi tanda tangan peristiwa tetapi tidak menyertakan byte media. Laporan turunan hanya sebagai kemudahan; events.jsonl adalah representasi peristiwa yang sah.
Ekspor obrolan lengkap menyimpan lampiran sesuai pengaturan lampiran ruang kerja ke dalam
media/, dengan nama SHA-256. Setiap catatan pesan dalam chat.json mencantumkan nama berkasnya (file,
file_sha256) atau alasan ketidakhadirannya (file_status), beserta apa yang dilihat pembaca
di sekitar teks: tautan di balik teks, asal penerusan, tombol bot, tanda tangan, jumlah tampilan, dan
pengatur waktu penghapusan otomatis. verify.py memeriksa apakah setiap berkas yang disebutkan terdapat dalam manifes yang ditandatangani
di bawah hash tersebut.
Penyimpanan yang tahan lama dan tanda terima proses (0.2)#
Sebuah tugas media dan pencatatan peristiwa pesannya dilakukan dalam satu transaksi. Tugas tersebut menyimpan deskriptor pesan TL asli; pengamatan yang ditandatangani mengikat SHA-256, akun, dan kebijakan ukurannya. Pemulihan memverifikasi pengikatan tersebut sebelum mengunduh. Tugas ini tidak pernah mengambil pesan saat ini dan secara diam-diam menggantinya dengan lampiran yang lebih baru. Tugas yang terputus akan dicoba ulang, sementara kegagalan permanen tetap menjadi hasil yang eksplisit.
Setiap ruang kerja memiliki jurnal dan identitas penandatanganan tersendiri. Peristiwa `process.started` mencakup ID eksekusi, jam lokal, versi dependensi, hash berkas sumber, akun/ruang lingkup awal, serta pengaturan penangkapan. Sinyal detak jantung mencakup ID eksekusi, waktu monotonik, dan status antrian. Tanda terima eksekusi juga dapat diunduh sebagai pernyataan yang ditandatangani secara terpisah. Untuk verifikasi lingkungan eksekusi, padukan dengan pengesahan GitHub atau pemeriksaan TDX yang dijelaskan dalam Ruang Lingkup Verifikasi.
Titik pemeriksaan otomatis disimpan secara lokal saat startup, setiap lima menit selama proses pengamatan (Alat Lainnya → Parameter → Titik pemeriksaan yang ditandatangani setiap), dan saat penghentian teratur. Verifikasi saat startup dan ekspor membandingkan jurnal dengan titik pemeriksaan lokal terbaru yang disimpan. Hal ini dapat mendeteksi rollback basis data jika titik pemeriksaan tersebut masih ada. Penyimpanan independen membuat referensi tersebut tetap tersedia di luar ruang kerja; cap waktu eksternal yang terverifikasi juga mengikatnya pada waktu tertentu.
Setelah restart, posisi pembaruan Telegram yang disimpan akan dilanjutkan (catch_up_from di observation.started) dan pembaruan yang terlewat akan diminta. Posisi yang disimpan hanya mencakup pembaruan yang penanganannya telah selesai, sehingga pembaruan yang masih menunggu saat koneksi ditutup atau proses dihentikan akan diminta kembali. Pemeriksaan ulang berkala mencatat message.recovered pesan yang terlewat dan message.missing_on_recheck ketika Telegram tidak lagi menampilkan pesan yang disimpan; hal terakhir ini bukanlah pemberitahuan penghapusan dan tidak menyebutkan siapa yang menghapus maupun waktunya.
Penyalinan dan pemulihan di luar situs (S3)#
Salinan di luar lokasi (Pengaturan → Pemberitahuan dan salinan di luar lokasi → Salinan di luar lokasi, atau
Alat Lainnya → Ekstra → Bukti & cadangan; dinonaktifkan secara default) mengunggah segmen jurnal, berkas yang disimpan, titik pemeriksaan
bersama cap waktunya, serta ekspor obrolan yang telah selesai ke penyimpanan yang kompatibel dengan S3, dienkripsi dengan
AES-256-GCM sebelum diunggah menggunakan kunci yang disimpan di brankas ruang kerja; retensi Object Lock berlaku
jika bucket mendukungnya. Tanpa kunci yang diunduh, salinan tersebut tidak dapat dibaca. Pulihkan dan verifikasi
dengan python -m tgwitness.replica restore --key-file KEY.json --out DIR.
Pemulihan memerlukan direktori biasa yang kosong. Unduhan dan objek yang telah didekripsi tetap berada di penyimpanan sementara pribadi hingga seluruh jurnal dan setiap titik pemeriksaan yang disimpan terverifikasi. Jalur objek yang tidak aman, rentang segmen yang tidak konsisten, dan jurnal yang lebih pendek dari titik pemeriksaan akan ditolak; verifikasi yang gagal tidak akan mempublikasikan file yang dipulihkan. Pemeriksaan retensi membandingkan mode Object Lock yang dikembalikan dan tanggalnya dengan batas waktu yang dikirim saat pengunggahan (toleransi pembulatan satu detik). Batas waktu yang telah kedaluwarsa, tidak valid, atau dipersingkat tidak dianggap terverifikasi. Status tersebut melaporkan objek yang diambil sampelnya yang retensinya dibaca kembali untuk proses pengunggahan tersebut.
Media lokal yang hilang atau rusak dilaporkan sebagai kesalahan pada tahap tersebut dan kursor media tetap berada di depan media tersebut, sehingga file tersebut akan dicoba lagi pada tahap berikutnya; file, titik pemeriksaan, dan ekspor setelahnya tetap disalin. Pemeriksaan pemulihan memverifikasi semua referensi media yang disimpan terhadap hash yang telah didekripsi dan ukuran yang tercatat. Segmen jurnal yang tumpang tindih dan identik dari unggahan yang terputus akan dihilangkan duplikatnya; tumpang tindih yang bertentangan akan ditolak. Titik pemeriksaan yang dibuat selama unggahan ditunda hingga catatan jurnal yang dicakupnya telah disalin, sehingga satu putaran yang telah selesai tidak akan menerbitkan titik pemeriksaan sebelum jurnalnya.
Ekspor snapshot streaming#
Ekspor streaming menggunakan snapshot baca SQLite yang stabil. Bagian awalnya mungkin lebih lama daripada jurnal langsung saat ini ketika pengunduhan selesai. Titik pemeriksaan yang dibuat setelah snapshot tersebut dapat melaporkan dengan benar bahwa arsip tersebut lebih pendek; bandingkan dengan titik pemeriksaan pada atau sebelum awalan yang diekspor, bukan titik pemeriksaan sembarang yang lebih baru.
Persiapan RFC 3161 dan verifikasi respons (0.2)#
Mode Bukti hanya mengirimkan nilai SHA-256 dari setiap titik pemeriksaan yang ditandatangani ke otoritas RFC 3161
yang tercantum dan kalender OpenTimestamps, melalui rute ruang kerja dan tidak pernah melalui MTProxy.
Penandaan waktu diaktifkan secara default di setiap tujuan pengaturan; Bukti untuk suatu kasus juga mencatat drand.
Jawaban disimpan di checkpoints/anchors/, diekspor sebagai .tsr dan .ots berkas di bawah anchors/,
dan diverifikasi oleh verify.py (--tsa-ca memverifikasi tanda tangan TSA; mengonfirmasi bukti OpenTimestamps
dengan ots upgrade dan ots verify).
Otoritas RFC 3161 yang gagal dua kali berturut-turut akan menunggu sebelum upaya berikutnya: satu interval, lalu
dua, empat, dan seterusnya hingga enam jam, atau selama yang diminta oleh Retry-After, hingga satu hari. Jika pemeriksaan
hanya menemukan otoritas yang sedang menunggu, tidak ada catatan yang ditulis; sebaliknya, anchor.completed mencantumkannya di bawah
deferred dengan retry_at. Sampai mereka menjawab kembali, panel menampilkan cap waktu sebagai Degraded.
Panel menyiapkan arsip permintaan yang berisi byte checkpoint.json kanonik, jejak pesan SHA-256 dan nonce acak dalam timestamp.tsq, checksum, serta instruksi. Tidak ada permintaan jaringan yang dilakukan; token yang dikembalikan oleh otoritas untuk permintaan ini adalah timestamp.
python -m tgwitness.anchor verify memeriksa respons terhadap byte checkpoint dan permintaan asli tanpa OpenSSL. File CA tepercaya harus ditentukan secara eksplisit; sertifikat yang disertakan tidak otomatis dipercaya. Pemeriksaan permintaan bersifat opsional di CLI, jadi simpan permintaan dan berikan --request untuk memeriksa nonce. Hasilnya menyatakan apakah nonce diperiksa. Tanda tangan checkpoint kolektor dan jurnal tetap harus diverifikasi terpisah dengan sidik jari kolektor tepercaya.
Verifikasi memeriksa tanda tangan respons, byte titik pemeriksaan, dan, jika disediakan,
permintaan asli di bawah kepercayaan CA yang ditentukan. Untuk cap waktu yang diperoleh dalam mode bukti, verify.py juga memeriksa bukti OCSP atau
CRL (pencabutan sertifikat penandatangan) yang tersimpan.
Lihat prosedur dan hasil validasi.
Catatan opsional dalam mode bukti: perangkat drand dan Telegram#
Dua catatan tambahan dapat dijalankan pada proses yang sama dengan cap waktu. Keduanya hanya berlaku selama
mode bukti diaktifkan. Bukti untuk suatu kasus akan mengaktifkan drand; sebaliknya, keduanya akan dinonaktifkan. Ubah pengaturannya
di More tools → Extras → Evidence & backups → More witnesses · opsional,
atau "drand": true dan "devices": true di POST /api/evidence. Satu kegagalan tidak menghentikan
yang lain atau cap waktu; panel menampilkan hasil terbaru masing-masing di bawah formulir.
drand
(beacon.drand
). Setiap putaran menulis putaran terbaru drand quicknet, yaitu
keacakan publik dari League of Entropy (satu putaran setiap 3 detik), ke dalam jurnal: chain
,
round
, randomness
, signature
, round_time
, dan relay
yang merespons. Putaran yang terverifikasi
dan tidak dapat diprediksi menyediakan referensi waktu bawah untuk materi yang tertaut melalui hash berikutnya.
Cap waktu terverifikasi pada titik pemeriksaan berikutnya memberikan referensi waktu atas. Pemeriksaan ini
membatasi materi yang tertaut. Pengumpul meminta drand.cloudflare.com
terlebih dahulu, kemudian relai Protocol Labs, melalui rute ruang kerja, satu permintaan per putaran.
verify.py
memeriksa apakah setiap nilai acak merupakan SHA-256
dari tanda tangannya dan apakah waktu putaran
sudah tepat, serta melaporkan jumlah putaran, rentang terpanjang tanpa putaran, dan seberapa jauh
ketinggalan jam pengumpul dari drand. --check-drand
membandingkan putaran dengan relai Cloudflare dan relai Protocol Labs, baik semuanya maupun
sampel acak sebanyak 100 dalam jurnal panjang; putaran yang berbeda akan gagal dalam verifikasi.
Perangkat , Telegram, , dan account.devices. Setiap proses membaca sesi akun dengan
account.getAuthorizations, daftar yang ditampilkan Telegram di Pengaturan → Perangkat, dan mencatatnya:
secara lengkap jika terjadi perubahan sejak putaran sebelumnya, beserta hash sesi added dan removed,
jika tidak, hanya jumlahnya dan SHA-256 yang dicatat. Model perangkat, platform, aplikasi, dan versi,
waktu pembuatan dan aktivitas terakhir, negara, serta wilayah disimpan; alamat IP tidak disimpan, karena
ekspor bukti berada di luar kendali Anda. Sesi pengumpul itu sendiri aktif sepanjang waktu, sehingga
hanya aktivitas sesi lain yang dihitung sebagai perubahan. verify.py melaporkan seberapa sering daftar
tersebut direkam serta setiap sesi baru dan yang telah berakhir. Ia hanya membaca daftar tersebut selama proses pengamatan berlangsung.
Apa yang ditampilkannya: drand menyusun catatan-catatan tersebut sesuai urutan waktu publik, dan daftar perangkat merupakan pernyataan Telegram melalui pengumpul, yang ditandatangani oleh pengumpul seperti setiap catatan lainnya.
Log Cloudflare Gateway (cloudflare.gateway_dns). Untuk server yang melakukan resolusi melalui
Cloudflare Gateway ( Gateway DNS ), setiap
salinan menyalin apa yang dicatat Gateway sejak salinan sebelumnya: satu catatan per jendela waktu maksimal tiga
jam dengan from, until, location_id, address server jika ada, dan
queries sebagai [at, name, type, rcode, decision, colo], bahkan jika tidak ada. Atur di bawah
(log Cloudflare Gateway) : akun, lokasi, alamat opsional, dan token baca-saja (Pembacaan
Analytics Read; Zero Trust PII Read untuk menyimpan satu alamat dari lokasi bersama). Panel ini memeriksa
data tersebut dengan satu permintaan sebelum menyimpannya; token tetap terenkripsi dan tidak pernah masuk ke jurnal.
verify.py mencantumkan jendela, nama yang paling sering dicari, dan waktu apa pun yang tidak tercakup oleh salinan; catatan
yang jumlahnya tidak sesuai dengan kuerinya akan gagal. Jendela yang menampung lebih dari satu halaman
kueri dalam satu detik akan menyimpan halaman tersebut dan menyatakan sisanya hilang. Salinan tersebut merupakan
tanggapan Cloudflare melalui pengumpul, yang ditandatangani oleh pengumpul; dalam waktu 24 jam, siapa pun yang memiliki
token baca-saja dapat membandingkannya dengan Cloudflare.