TgWitness / Dokumentasi

Apa yang telah diuji →

Rujukan / Bukti

Telegram · Bagaimana bukti berfungsi

Rantaian hash, tandatangan, titik pemeriksaan dan saksi dijelaskan dengan formula tepat yang digunakan oleh pengesah.

TgWitness / Dokumentasi · Bukti dan pengesahan

Bukti & pengesahan

TgWitness mengekalkan apa yang diperhatikan oleh akaun pengumpul, memautkan pemerhatian tersebut ke dalam jurnal yang disahkan dan membolehkan orang lain mengesahkan eksport berbanding kunci yang dipercayai, masa luaran daripada pihak ketiga dan checkpoint yang disimpan sebelum ini.

Laman web dokumentasi tempatan menambah contoh interaktif di /docs/concepts/, penjelajah keputusan checkpoint di /docs/witness/, dan panduan langkah demi langkah untuk Case Board, reka bentuk laporan dan ekstrak penyerahan. Semua mesej contoh, kiraan dan kelewatan adalah rekaan. Hashes dalam sandbox rantaian dikira dengan SHA-256 dalam pelayar. Tiada apa yang dihantar ke Telegram.

Pada halaman ini

Satu mesej berubah; pemerhatian terkumpul#

Diagram urutanTelegram → Pengumpul: Mesej baru: Bertemu pada pukul 10:00; Pengumpul → Jurnal yang disahkan: Lampirkan message.new; Telegram → Pengumpul: Sunting: Bertemu pada pukul 11:00; Pengumpul → Jurnal yang disahkan: Sertakan mesej.disunting; Telegram → Pengumpul: Notis pemadaman; Pengumpul → Jurnal yang disahkan: Tambah message.deleted; Nota mengenai Jurnal yang disahkan: Perhatian terhadap asal + suntingan + pemadaman kekalTelegramPengumpulJurnal yang disahkanMesej baru: Bertemu pada pukul 10:00Lampirkan message.newSunting: Bertemu pada pukul 11:00Sertakan mesej.disuntingNotis pemadamanTambah message.deletedPerhatian terhadap asal + suntingan + pemadamankekal
Diagram sebagai teks
  1. Telegram → Pengumpul: Mesej baru: Bertemu pada pukul 10:00
  2. Pengumpul → Jurnal yang disahkan: Lampirkan message.new
  3. Telegram → Pengumpul: Sunting: Bertemu pada pukul 11:00
  4. Pengumpul → Jurnal yang disahkan: Sertakan mesej.disunting
  5. Telegram → Pengumpul: Notis pemadaman
  6. Pengumpul → Jurnal yang disahkan: Tambah message.deleted
  7. Nota mengenai Jurnal yang disahkan: Perhatian terhadap asal + suntingan + pemadaman kekal

Susunan ringkas ini menganggap Telegram telah menyampaikan setiap kemas kini dan akaun terpilih dapat melihatnya. Acara operasi juga berkongsi jurnal tersebut. Notis pemadaman tidak memberikan maklumat tentang pemadam atau masa pemadaman yang tepat. Penghantaran berulang merupakan pemerhatian berasingan; tiada penindasan duplikat di seluruh jurnal.

Apa yang dilindungi oleh hash#

Perhatikan, enkod, hashi dan tandatangani: setiap peristiwa baharu merangkumi hash sebelumnya.

Baca formula dari dalam ke luar: C menukarkan sembilan medan menjadi bait tepat; SHA-256 menghasilkan digest mereka; hex ialah cara digest itu disimpan. Hash sebelumnya sudah berada dalam acara. unhex menukarkan semula hash yang disimpan menjadi 32 bait yang ditandatangani oleh Ed25519.

Diagram rantaian statik

Biarkan C(ei) menjadi JSON UTF-8 kanonik bagi sembilan medan peristiwa. Yang pertama previous_hash ialah 64 aksara sifar. Setiap rekod kemudian merangkumi hash heksadesimal rekod sebelumnya:

hi = hex(SHA256(C(ei)))
σi = Ed25519.Sign(sk,unhex(hi))

Tandatangan merangkumi 32 bait digest mentah. Masukan hash mengandungi tepat seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload dan previous_hash. Kunci objek disusun; ruang putih dan pelarian ASCII diabaikan; NaN dan infiniti ditolak. Lihat pengekodan tepat.

Diyagram aliran64 watak sifar → Rekod 1 / hash h1; Rekod 1 / hash h1 → Rekod 2 merangkumi h1 / hash h2; Rekod 2 merangkumi h1 / hash h2 → Rekod 3 merangkumi h2 / hash h3; Rekod 3 merangkumi h2 / hash h3 → Pemeriksaan titik bertandatangan: kira 3, tajuk h3 (simpan di tempat lain)64 watak sifarRekod 1 / hash h1Rekod 2 merangkumi h1/ hash h2Rekod 3 merangkumi h2/ hash h3Pemeriksaan titikbertandatangan: kira3, tajuk h3simpan di tempat lain
Diagram sebagai teks
  1. 64 watak sifar → Rekod 1 / hash h1
  2. Rekod 1 / hash h1 → Rekod 2 merangkumi h1 / hash h2
  3. Rekod 2 merangkumi h1 / hash h2 → Rekod 3 merangkumi h2 / hash h3
  4. Rekod 3 merangkumi h2 / hash h3 → Pemeriksaan titik bertandatangan: kira 3, tajuk h3 (simpan di tempat lain)
Tukar ke jurnal yang disediakan Apa yang mengdeteksinya
Ubah rekod 2 sambil mengekalkan hash yang disimpannya Hash peristiwa yang dikira semula berbeza; tandatanganannya tidak lagi merangkumi peristiwa yang diubah
Bina semula rekod yang diubah dan setiap hash kemudian Tandatangan asal gagal; titik pemeriksaan yang dikekalkan di sempadan terjejas juga tidak sepadan
Buang ekor tetapi biarkan prefiks yang tinggal utuh Satu titik pemeriksaan yang disimpan lebih awal di luar awalan yang diberikan mendedahkan bahawa eksport itu terlalu pendek
Menandatangani semula jurnal pengganti dengan kunci lain Cap cap jari kunci yang dipercayai secara berasingan menolak identiti pengganti

Mengubah medan yang disimpan akan mengubah digestnya; membina semula has tidak memulihkan tandatangan asal.

Cuba logik pada rekod 2: ubah Meet at 11:00 kepada Meet at 12:00 dalam acara yang disimpan. Hash yang dikira semula itu tidak lagi sepadan. Mengira semula rantaian kemudian boleh membaiki pautannya, tetapi tidak dapat menjadikan tandatangan asal merangkumi digest baru. Sebaliknya, suntingan Telegram yang diperhatikan menjadi rekod jurnal baru.

Diagram perubahan statik

Pautan hash sahaja tidak menghalang seseorang daripada mengira semula rantaian pengganti. Kepercayaan datang daripada memeriksa tandatangan di bawah kunci yang dipercayai secara bebas, masa luaran daripada pihak ketiga yang menetapkan kepala jurnal, dan rujukan yang disimpan di luar pengumpul.

Apa yang ditambah oleh titik pemeriksaan awal#

Menyimpan kiraan 3 dan tajuk h3; eksport kemudian 4 rekod diperiksa pada kedudukan 3.

Rujukan kekal tidak berubah sementara jurnal berkembang. Jika penanda aras menyatakan "3 rekod, kepala h3", eksport empat rekod boleh melalui dengan memadankan h3 pada kedudukan 3. Kepala terbarunya ialah h4, yang dijangka berbeza. Eksport hanya dua rekod akan gagal.

Diagram checkpoint statik

Selepas mengesahkan tandatangan checkpoint, kehendaki:

Nexport ≥ Ncheckpoint   and   hexport[Ncheckpoint] = Hcheckpoint

Eksport mungkin melangkaui titik pemeriksaan. Ia mesti sepadan pada sempadan yang dikekalkan. Kunci pengumpul menandatangani titik pemeriksaan, jadi pengumpul boleh menandatangani satu lagi. Ia mengikat rekod hanya jika penerima memperolehinya sebelum arkib, melalui saluran lain; minimum untuk bukti juga memerlukan masa luaran daripada pihak ketiga. Pengesah sebenar juga memeriksa susunan setiap peristiwa, pautan sebelumnya, hash dan tandatangan. Membandingkan hanya kepala simpanan akhir akan terlepas rekod dalaman yang diubah yang hash simpanannya tidak dikemas kini.

Di mana seorang saksi sepatutnya berada#

Diyagram aliranPengumpul / sesi akaun / kunci A → Titik akhir checkpoint baca sahaja; Saksi / kunci pengumpul yang dipin / kunci sendiri B → Jurnal saksi berasingan yang disahkan; Saksi / kunci pengumpul yang dipin / kunci sendiri B → Titik akhir checkpoint baca sahaja (Minta semakan); Titik akhir checkpoint baca sahaja → Saksi / kunci pengumpul yang dipin / kunci sendiri B (Jawapan yang disahkan); Saksi / kunci pengumpul yang dipin / kunci sendiri B → Saluran dengan pos TGW1 yang disahkan (Bot API / token sendiri)Host AHost BPengumpul / sesi akaun /kunci ATitik akhir checkpointbaca sahajaSaksi / kunci pengumpulyang dipin / kunci sendiriBJurnal saksi berasinganyang disahkanSaluran dengan pos TGW1yang disahkanMinta semakanJawapan yang disahkanBot API / token sendiri
Diagram sebagai teks
  1. Pengumpul / sesi akaun / kunci A → Titik akhir checkpoint baca sahaja
  2. Saksi / kunci pengumpul yang dipin / kunci sendiri B → Jurnal saksi berasingan yang disahkan
  3. Saksi / kunci pengumpul yang dipin / kunci sendiri B → Titik akhir checkpoint baca sahaja (Minta semakan)
  4. Titik akhir checkpoint baca sahaja → Saksi / kunci pengumpul yang dipin / kunci sendiri B (Jawapan yang disahkan)
  5. Saksi / kunci pengumpul yang dipin / kunci sendiri B → Saluran dengan pos TGW1 yang disahkan (Bot API / token sendiri)

Saksi merekod rollback, head yang berbeza pada kiraan yang sama, kunci yang ditukar, jawapan tidak sah dan respons yang hilang. Untuk mengesahkan bahawa setiap rekod terdahulu tidak berubah, bandingkan eksport dengan checkpoint yang disimpan. Saksi pada hos lain tidak berkongsi gangguan hos pengumpul; pengendali berasingan memberikan kebebasan tambahan. Pengesah menyemak bahawa kunci saksi berbeza daripada kunci pengumpul; rekod kawalan kunci penjaga menunjukkan siapa yang memegangnya. Telegram meletakkan tarikh pada setiap siaran dalam saluran awam, dan verify.py --channel https://t.me/s/… membaca tarikh tersebut sebagai masa luaran.

Saksi mengesahkan keadaan jurnal yang dilaporkan oleh pengumpul. Gunakan ujian penghantaran terkawal untuk mengukur tindakan Telegram mana yang sampai ke akaun pengumpul. Lihat tetapan saksi.

Uji penghantaran terhadap tindakan yang diketahui#

Gunakan kumpulan terkawal, akaun pengumpulan berasingan dan penanda baharu. Hantar, sunting dan padam secara sengaja, menyemak tangkapan antara peringkat. Tetapkan tindakan yang dijangka dan had masa sebelum memeriksa keputusan.

R = |observed∩expected| / |expected|      Δ t = treceipt - taction

Hanya tindakan yang sepadan dengan jangkaan dikira; resit gandaan tidak meningkatkan penyebut atas. Penyebut bawah mesti tidak sifar. Resit yang hilang tiada kelewatan yang diukur. Dokumen ketidakpastian masa; gunakan masa tindakan pemadaman terkawal anda sendiri, kerana Telegram tidak menyediakan masa pemadaman yang tepat. Hasil seperti 5/6 (83.3%) menerangkan tindakan ujian, bukan kelengkapan semua trafik Telegram.

Pilih aliran kerja#

Panduan lengkap penyiasatan ini mengikuti satu insiden merentasi saluran, kumpulan, bot dan sembang peribadi:

  1. Pada akaun pengumpulan khusus, aktifkan mod Siasatan untuk keseluruhan akaun dan inventori sembang yang boleh diakses. Gunakan sembang terpilih atau folder untuk akaun utama.
  2. Dapatkan snapshot jurnal, sejarah penuh setiap sembang dan lampiran yang disimpan.
  3. Simpan perubahan secara langsung dan sebarang interaksi panel yang disengajakan beserta resitnya.
  4. Ikuti ID penghantar numerik, hubungan balasan, destinasi berulang dan hash fail melalui rekod yang dirujuk dan profil individu.
  5. Tambah nota dan koleksi yang dipautkan kepada sumber dalam Case Board. Rekonstruksi garis masa merentas sembang dengan cap masa dan jurang yang nyata.
  6. Bandingkan ruang kerja akaun lain sambil memisahkan asal usul dan kunci mereka.
  7. Himpunkan dan sahkan jurnal yang ditandatangani, profil dan eksport sejarah dengan nota kes.

Panduan /docs/cases/ di laman web merangkumi peta kes interaktif dan varian untuk pertikaian bot, mesej yang dipadam dan peserta yang menukar nama. Case Board menyimpan nota dan koleksi dalam ruang kerja. Eksport kumpulan mengumpul pakej ruang kerja berasingan; korelasi merentas ruang kerja dan garis masa gabungan kekal sebagai kerja penganalisis.

Pengesahan yang telah diselesaikan dan kerja yang masih tinggal · Eksport dan sahkan · Mulakan dengan satu akaun