# Telegram · Format bukti

Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/evidence/

Isi berkas ZIP yang telah ditandatangani, jenis catatan, tanda terima proses, profil pengguna, salinan di luar lokasi, dan verifikasi offline.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt)

Translation coverage: this edition includes material from the English original.

Isi berkas ZIP yang telah ditandatangani, jenis catatan, tanda terima proses, profil pengguna, salinan di luar lokasi, dan verifikasi offline.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Bukti & verifikasi](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

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](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md) untuk pengaturan dan batasan kepercayaan.

**Di halaman ini**

- [Apa yang ditandatangani](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#what-is-signed)
- [Membandingkan ekspor obrolan](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#comparing-chat-exports)
- [Serah terima investigasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#investigation-handoff)
- [Ekstrak serah terima](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#handover-extract)
- [Laporan yang mudah dibaca](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#readable-reports)
- [Kanonisasi peristiwa](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#event-canonicalization)
- [Semantik aktor](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#actor-semantics)
- [Cakupan: kontinuitas, celah, dan ID yang tidak teramati](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)
- [Produsen](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#producer)
- [Profil pengguna](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#people-profiles)
- [Saksi independen](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#independent-witness)
- [Manifest dan titik pemeriksaan](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#manifest-and-checkpoints)
- [Ruang lingkup verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope)
- [Lampiran](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#attachments)
- [Pengumpulan dan pemrosesan tanda terima yang tahan lama (0.2)](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#durable-collection-and-process-receipts-02)
- [ersiapan RFC 3161 dan verifikasi respons (0.2)](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)
- [Catatan opsional dalam mode bukti: drand dan perangkat Telegram](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)

## 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](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#readable-reports)) | 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

1. 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](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/). Simpan catatan transfer dan penyimpanan bersama materi kasus Anda. Periksa pengaturan pengumpulan yang dimaksud dengan [prosedur penerimaan langsung](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md).
2. 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.
3. 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.
4. 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 evidence
   ```

   Sidik jari dan cap waktu yang telah diverifikasi dari catatan terakhir memenuhi syarat minimum sebagai bukti; jika tidak, `--require evidence` akan keluar dengan kode 2. Titik pemeriksaan merupakan pemeriksaan pendukung, karena ditandatangani dengan kunci pengumpul. Keluaran yang berhasil melaporkan `key_pinned: true` dan `checkpoint_checked: true` ketika 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).
   ```

   1. 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 `.tgwpw` yang lebih kuat. ZIP menggunakan derivasi kata sandi berbiaya rendah dari WinZip; gunakan frasa sandi acak yang panjang. `.tgwpw` menggunakan scrypt dan AES-256-GCM serta dibuka dengan perintah `unseal-password` dari verifikator mandiri. Kata sandi tidak disimpan dan hanya melindungi kerahasiaan; penerima mendekripsi arsip dan memverifikasi ekspor yang ditandatangani di dalamnya, yang tidak berubah.
   2. Untuk memberi cap waktu pada titik pemeriksaan di luar mode bukti, ikuti [prosedur RFC 3161](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/) dan simpan permintaan, titik pemeriksaan, informasi CA tepercaya, serta respons otoritas yang terverifikasi. Hanya menyiapkan permintaan saja tidak akan menghasilkan cap waktu.

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](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope) untuk asumsi kepercayaan dan [hasil validasi](https://phishdestroy.io/tgwitness/id/docs/reference/verification/) 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.html` atau `messages/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`, kunci `format`, `report`, `seal`): segel tersebut menandatangani SHA-256 dari JSON kanonik dari `report`, 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 ditandatangani `2.25.240684792623320047764573196045913242332` dan 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 di `TGWITNESS_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 bawah `report.original` dalam 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](https://phishdestroy.io/tgwitness/id/docs/reference/translation/).

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_at`waktu 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](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#own-actions).

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.started` dan 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](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#witness-probe). Saat fitur [obrolan terpilih yang ketat](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#strict-chosen-chats) diaktifkan (`scope.strict` di `observation.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](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md).

**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 oleh `deletion.unscoped` dihitung 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](https://core.telegram.org/api/updates#message-id-sequences). 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) atau [pengukuran Intel TDX](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/), 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](https://phishdestroy.io/tgwitness/id/docs/reference/witness/). 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | 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](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/) | 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](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-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/`](https://github.com/phishdestroy/TgWitness/tree/main/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](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope).

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](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/#signing-certificate-revocation)) yang tersimpan. Lihat [prosedur](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/) dan [hasil validasi](https://phishdestroy.io/tgwitness/id/docs/reference/verification/).

## 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](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)), 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.
