# TgWitness · Bahasa Indonesia > Documentation edition: Bahasa Indonesia. Project version: `0.9.3`. Source branch: `main`. This index links the Markdown editions of the public pages. The complete handbook is built from the same page content, including source URLs. Sections without a translation appear in English. - [Project context, installation, measured scale and verification](https://phishdestroy.io/tgwitness/docs/reference/overview/index.md) - [English project summary](https://phishdestroy.io/tgwitness/llms.txt) - [Complete handbook · Bahasa Indonesia](https://phishdestroy.io/tgwitness/id/llms-full.txt) - [Complete handbook as Markdown · Bahasa Indonesia](https://phishdestroy.github.io/TgWitness/id/llms-full.md) - [Source code and release history](https://github.com/phishdestroy/TgWitness) - [Collection modes and evidence levels](https://phishdestroy.io/tgwitness/id/guides/modes.md) - [Published checks and measurements](https://phishdestroy.io/tgwitness/docs/validation/index.md) ## Complete documentation map ### Guides - [Mengelola arsip](https://phishdestroy.io/tgwitness/id/docs/archive/index.md): Muat riwayat, cari catatan yang disimpan, tinjau sumber AI, dan hubungkan alat Anda. - [Penangkapan GitHub Actions](https://phishdestroy.io/tgwitness/id/docs/capture/index.md): Pilih Takeout, ekspor API biasa atau jurnal obrolan pada runner GitHub sementara. - [Akun khusus](https://phishdestroy.io/tgwitness/id/docs/dedicated-account/index.md): Siapkan akun Telegram terpisah untuk pengumpulan data. - [Mulai dalam hitungan menit](https://phishdestroy.io/tgwitness/id/docs/start/index.md): Instal dengan satu perintah, hubungkan akun Telegram, dan ekspor arsip yang dapat diverifikasi di Windows, Linux, atau macOS. - [Hubungkan akun](https://phishdestroy.io/tgwitness/id/docs/accounts/index.md): Hubungkan Telegram melalui kode QR, nomor telepon, atau impor sesi. Pilih sumber dan pastikan pesan baru masuk ke jurnal Anda. - [Pilih proxy](https://phishdestroy.io/tgwitness/id/docs/proxies/index.md): Pertahankan rute MTProxy otomatis atau gunakan proxy Anda sendiri. Pilih mode IP, aturan cadangan, dan rute untuk permintaan eksternal. - [Ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/exports/index.md): Ekspor riwayat Telegram yang terekam, verifikasi tanda tangan, dan bandingkan jurnal tersebut dengan titik pemeriksaan yang disimpan oleh saksi independen. - [Lihat cara kerja bukti ini](https://phishdestroy.io/tgwitness/id/docs/concepts/index.md): Lacak pesan mulai dari saat ditangkap hingga titik pemeriksaan. Ubah catatan sampel, hitung ulang rantai SHA-256-nya, dan lihat apa yang terdeteksi oleh titik pemeriksaan yang disimpan. - [Selidiki seluruh obrolan](https://phishdestroy.io/tgwitness/id/docs/cases/index.md): Lakukan penyelidikan Telegram secara menyeluruh di seluruh saluran, grup, obrolan pribadi, dan bot: pencatatan seluruh akun, riwayat, kontak, tautan, berkas, garis waktu, dan bukti yang terverifikasi. - [Buat Case Board](https://phishdestroy.io/tgwitness/id/docs/case-board/index.md): Kumpulkan pengamatan yang disimpan, sorotan yang tepat, dan potongan tindakan di papan pribadi, diskusikan dengan tim Anda, dan sajikan kumpulan tersebut. - [Rancang laporan](https://phishdestroy.io/tgwitness/id/docs/reports/index.md): Pilih data laporan, salah satu dari delapan desain, dan isinya, lalu pratinjau dan ekspor dalam format HTML, PDF yang ditandatangani, atau paket bukti lengkap. - [Siapkan salinan untuk dibagikan](https://phishdestroy.io/tgwitness/id/docs/handover/index.md): Pilih catatan dan bidang yang dapat diterima oleh penerima, periksa salinan akhir, dan verifikasi manifes yang telah ditandatangani serta batas jurnal sumbernya. - [Kelola sekelompok akun](https://phishdestroy.io/tgwitness/id/docs/groups/index.md): Bandingkan ruang kerja grup, temukan sumber, tinjau periode pengamatan, dan terapkan pengaturan bersama dengan pengecualian per akun. - [Jaga keamanannya](https://phishdestroy.io/tgwitness/id/docs/security/index.md): Lihat di mana sesi, kunci, dan bukti disimpan, apa saja yang keluar dari perangkat Anda, apa saja yang dilindungi oleh sistem keamanan, dan cara memperkuat instalasi. - [Bagikan sebuah kasus](https://phishdestroy.io/tgwitness/id/docs/access/index.md): Berikan akses kepada peninjau dan analis ke akun dan obrolan yang dipilih, dengan izin terpisah, batasan sesi, dan token yang dapat dicabut. - [Siapkan bot saksi](https://phishdestroy.io/tgwitness/id/docs/witness/index.md): Publikasikan titik pemeriksaan jurnal yang ditandatangani ke saluran Telegram Anda dengan saksi terpisah, kunci tersendiri, dan akses pengumpul yang hanya dapat dibaca. - [Mengapa Zero Trust: Taylor Wessing, Dr. Zurheide, Dr. Schelinski](https://phishdestroy.io/tgwitness/id/docs/signed-export/index.md): Studi kasus zero-trust: sebuah tanggapan terkait GDPR yang ditandatangani oleh Dr. Patrick Zurheide dan Dr. Tobias Schelinski dari Taylor Wessing, yang telah diverifikasi berdasarkan dokumennya sendiri, serta model yang dapat diverifikasi yang tidak akan memberikan ruang bagi penipuan atau keraguan. - [Jaga agar tetap berjalan](https://phishdestroy.io/tgwitness/id/docs/server/index.md): Jalankan TgWitness di server yang dilengkapi penyimpanan permanen, akses panel pribadi, pencadangan, dan pemeriksaan setelah server di-restart. - [Temukan apa yang salah](https://phishdestroy.io/tgwitness/id/docs/troubleshooting/index.md): Periksa akses panel, koneksi Telegram, pesan yang hilang, FloodWait, dan status saksi menggunakan sinyal yang tepat untuk setiap masalah. ### Reference - [Obrolan Rahasia: penyiapan dan perekaman](https://phishdestroy.io/tgwitness/id/docs/reference/secret-chats/index.md): Pasang ekstra protokol Obrolan Rahasia, aktifkan per akun, dan rekam obrolan yang dibuat atau diterima TgWitness. - [TgWitness: awal, skala, dan bukti](https://phishdestroy.io/tgwitness/id/docs/reference/overview/index.md): Instal dengan satu perintah atau jalankan di GitHub Actions. Pahami opsi investigasi, skala yang dipublikasikan, dan apa yang diverifikasi oleh arsip. - [Muat riwayat sumber](https://phishdestroy.io/tgwitness/id/docs/reference/history/index.md): Muat pesan-pesan sebelumnya dari sumber yang diaktifkan, jeda dan lanjutkan, serta verifikasi laporan kemajuan yang telah ditandatangani. - [Analisis arsip](https://phishdestroy.io/tgwitness/id/docs/reference/analysis/index.md): Cari pesan yang disimpan, tinjau masukan AI, dan simpan laporan analitis beserta referensi sumbernya. - [Baris perintah](https://phishdestroy.io/tgwitness/id/docs/reference/cli/index.md): Cari, baca konteks, hitung aktivitas, dan ekspor pesan yang disimpan dari skrip dan agen, dengan output --json, kode keluar yang stabil, dan token baca-saja yang terbatas cakupannya. - [Pencarian teks lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/search/index.md): Temukan pesan yang disimpan berdasarkan bentuk kata, frasa persis, domain, dan @nama pengguna, dengan hasil yang paling sesuai ditampilkan terlebih dahulu, serta indeks yang terikat pada jurnal yang ditandatangani. - [MCP hanya baca](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/index.md): Hubungkan klien MCP ke ruang kerja dan obrolan yang dipilih dengan akses yang memiliki batas waktu dan dapat dicabut. - [OCR dan transkripsi lokal](https://phishdestroy.io/tgwitness/id/docs/reference/media-analysis/index.md): Kenali gambar dan audio yang direkam menggunakan worker lokal; jaga agar teks yang dihasilkan tetap tertaut ke berkas asalnya. - [Webhook keluar](https://phishdestroy.io/tgwitness/id/docs/reference/webhooks/index.md): Mengirimkan peristiwa yang telah difilter ke penerima HTTPS dengan tanda tangan HMAC, upaya pengiriman ulang, dan status pengiriman. - [Pemberitahuan ketidakcocokan operator](https://phishdestroy.io/tgwitness/id/docs/reference/notice/index.md): Pemberitahuan operator kami mengenai Taylor Wessing dan catatan sumbernya. - [Pemberitahuan mengenai lisensi dan ketidakcocokan arsitektur](https://phishdestroy.io/tgwitness/id/docs/reference/license/index.md): TgWitness dilisensikan di bawah lisensi MIT untuk semua orang, dan mengapa alat ini secara arsitektural tidak kompatibel dengan alur kerja Taylor Wessing. - [Panduan cepat](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/index.md): Semua cara untuk menginstal dan menjalankan TgWitness: paket Windows, Python, Docker, dan demo sintetis, beserta pemeriksaan awal. - [Format akun dan sesi](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/index.md): Masuk menggunakan nomor telepon, kode QR, atau kunci otentikasi, impor sesi Telethon, Pyrogram, atau Telegram Desktop, dan kelola beberapa akun. - [Akses dan izin](https://phishdestroy.io/tgwitness/id/docs/reference/access/index.md): Tentukan cakupan akses ke akun dan obrolan, pilih izin, batasi sesi dan alamat IP, serta cabut akses. - [Koneksi, proxy, dan perlindungan data](https://phishdestroy.io/tgwitness/id/docs/reference/connection/index.md): Otentikasi, kumpulan proxy otomatis, mode IP, kebijakan cadangan, permintaan eksternal, dan penyimpanan rahasia. - [Penerapan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/index.md): Jalankan TgWitness sebagai layanan di Windows, Linux, macOS, atau Docker, melalui HTTPS, dengan fitur pencadangan dan pembaruan. - [Cara kerja pengumpulan data](https://phishdestroy.io/tgwitness/id/docs/reference/collection/index.md): Ruang lingkup pengamatan, pembaruan langsung, pemeriksaan ulang, lampiran, tindakan pengguna, dan arti dari "gap", per catatan. - [Alur kerja dan operasi](https://phishdestroy.io/tgwitness/id/docs/reference/operations/index.md): Pengoperasian harian panel: mode, kategori pemantauan, parameter, pemberitahuan, ekspor, pencadangan, dan kapasitas. - [Mode penyelidikan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/index.md): Penyelidikan menyeluruh terhadap akun, mencakup saluran, grup, obrolan pribadi, dan bot, mulai dari lingkup penyelidikan hingga paket kasus yang terverifikasi. - [Referensi Case Board](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/index.md): Bookmark, sorotan tepat, potongan tindakan, diskusi, akses terbatas, dan riwayat anotasi yang ditandatangani yang digunakan oleh Case Board. - [Konfigurasi dan verifikasi laporan](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/index.md): Filter laporan, delapan desain, preset konten, riwayat perubahan yang disimpan, dan penilaian yang disertakan dalam ekspor yang telah ditandatangani. - [Fitur dan cakupan](https://phishdestroy.io/tgwitness/id/docs/reference/features/index.md): Model pengumpulan saat ini, alur kerja multi-akun, ekspor, dan batasan operasional TgWitness. - [Cara kerja bukti tersebut](https://phishdestroy.io/tgwitness/id/docs/reference/how-it-works/index.md): Penjelasan mengenai rantai hash, tanda tangan, titik pemeriksaan, dan saksi, disertai rumus-rumus tepat yang digunakan oleh verifikator. - [Format bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/index.md): Isi berkas ZIP yang telah ditandatangani, jenis catatan, tanda terima proses, profil pengguna, salinan di luar lokasi, dan verifikasi offline. - [Saksi independen](https://phishdestroy.io/tgwitness/id/docs/reference/witness/index.md): Jalankan TgWitness dengan kunci dan botnya sendiri, publikasikan titik pemeriksaan yang ditandatangani ke saluran, dan periksa ekspor data berdasarkan titik pemeriksaan tersebut. - [Cap waktu](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/index.md): Stempel waktu RFC 3161 untuk titik pemeriksaan yang ditandatangani: apa yang dikirimkan ke otoritas dan bagaimana responsnya diverifikasi. - [Menerjemahkan laporan untuk pengadilan](https://phishdestroy.io/tgwitness/id/docs/reference/translation/index.md): Berkas mana yang asli, apa yang diajukan bersama terjemahan tersumpah, dan istilah yang dipertahankan penerjemah. - [Keamanan dan penanganan data](https://phishdestroy.io/tgwitness/id/docs/reference/security/index.md): Model ancaman, model akses, data rahasia yang disimpan, paparan jaringan, impor sesi, dan cara melaporkan kerentanan. - [Arsitektur](https://phishdestroy.io/tgwitness/id/docs/reference/architecture/index.md): Komponen-komponen kolektor, panel, jurnal, pekerja, dan saksi, serta bagaimana data berpindah di antara komponen-komponen tersebut. - [Apa yang telah diuji](https://phishdestroy.io/tgwitness/id/docs/reference/verification/index.md): Uji coba Telegram secara langsung, pemeriksaan otomatis, pemeriksaan browser, dan putaran kualifikasi berikutnya. - [Daftar Perubahan](https://phishdestroy.io/tgwitness/id/docs/reference/changelog/index.md): Setiap perubahan per versi, termasuk perubahan yang belum dirilis. - [Panduan panel](https://phishdestroy.io/tgwitness/id/docs/reference/panel/index.md): Setiap layar pada panel: obrolan, jurnal, sumber, ekspor, Ekstra, mode perlindungan, dan pemeriksaan kode. - [Pengaturan awal dan konfigurasi](https://phishdestroy.io/tgwitness/id/docs/reference/settings/index.md): Wizard pengaturan, tujuan, tingkat antarmuka, rute koneksi, dan pengaturan yang dibagikan oleh sebuah grup akun. - [Instal, verifikasi, dan perbarui](https://phishdestroy.io/tgwitness/id/docs/reference/installation/index.md): Instal dengan satu perintah, periksa tanda tangan dan hash, perbarui, dan hapus instalasi. - [Penyimpanan dan pemulihan](https://phishdestroy.io/tgwitness/id/docs/reference/storage/index.md): Pencadangan, pemindahan berkas lama ke cloud Anda, salinan di bawah Object Lock, dan pemulihan di perangkat baru. - [Ekspor akun](https://phishdestroy.io/tgwitness/id/docs/reference/account-export/index.md): Ekspor apa yang dapat dibaca oleh suatu akun saat ini: cakupan, tugas yang dapat dilanjutkan, arsip yang telah ditandatangani, dan salinan berbagi yang telah diminimalkan. - [Galeri publik](https://phishdestroy.io/tgwitness/id/docs/reference/showcase/index.md): Publikasikan pesan yang disimpan dari saluran publik yang dipilih serta snapshot yang ditandatangani melalui tautan yang kedaluwarsa dan dapat dicabut. - [Penerapan dengan jaminan keamanan tinggi](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/index.md): Server yang diamankan 24/7 di Hetzner atau Phala Cloud, Gateway DNS, serta pemeriksaan yang dapat diulang oleh pihak ketiga. --- # Telegram · Mulai dalam hitungan menit Canonical page: https://phishdestroy.io/tgwitness/id/docs/start/ Instal dengan satu perintah, hubungkan akun Telegram, dan ekspor arsip yang dapat diverifikasi di Windows, Linux, atau macOS. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Instal dengan satu perintah, hubungkan akun Telegram, dan pilih apa yang ingin disimpan. ## Instal di komputer Anda Penginstal ini mencakup Python dan dependensinya. Mulailah dengan mengekspor obrolan; tambahkan alat pengamatan dan investigasi saat Anda membutuhkannya. ### Linux / macOS ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` ### Windows · PowerShell / CMD ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Server Ubuntu: jalankan sebagai root. Desktop: jalankan sebagai pengguna biasa. Buka alamat panel yang ditampilkan oleh penginstal dan gunakan kunci aksesnya. Kemudian, hubungkan akun Telegram Anda. Kunci panel dan otorisasi Telegram Anda bersifat terpisah. [Instalasi, tanda tangan, dan pembaruan](https://phishdestroy.io/tgwitness/docs/reference/installation/) menjelaskan build yang diunduh, akses lokal, dan opsi server. [Petunjuk sumber dan Docker](https://phishdestroy.io/tgwitness/docs/reference/quickstart/) tetap tersedia. ## Pilih tugas pertama Anda 1. [Hubungkan akun](https://phishdestroy.io/tgwitness/id/docs/accounts/) melalui telepon, QR, atau impor sesi yang didukung. 2. Pilih cakupan obrolan, folder, atau akun. 3. [Ekspor riwayat yang dipilih](https://phishdestroy.io/tgwitness/docs/reference/account-export/), atau mulai pemantauan untuk menyimpan perubahan di masa mendatang. 4. [Verifikasi arsip](https://phishdestroy.io/tgwitness/id/docs/exports/) dengan sidik jari kunci tepercaya yang terpisah. ## Gunakan GitHub Runner sementara [Panduan GitHub Actions](https://phishdestroy.io/tgwitness/docs/capture/) memandu Anda melalui proses fork, otorisasi, cakupan, dan kata sandi arsip. Unduh hasil terenkripsi beserta riwayat alur kerjanya setelah proses berjalan. Alur kerja ini tidak memerlukan server pengumpul permanen. ## Jelajahi situs ini tanpa perlu membuat akun [Buka demo browser](https://phishdestroy.github.io/TgWitness/demo/?lang=id) untuk menjelajahi pesan fiktif, membandingkan suntingan, dan memeriksa hasil ekspor sebelum menginstal apa pun. ![Tampilan percakapan TgWitness dengan contoh pesan](https://phishdestroy.io/tgwitness/assets/chats-dark.png?v=684f81f890cc) Contoh ruang kerja. Jurnal Anda sendiri dimulai secara terpisah. ## Lanjutkan penyelidikan Untuk pekerjaan yang sedang berlangsung, tambahkan sumber, kebijakan berkas, pencarian, laporan, dan izin berbagi yang dibutuhkan kasus Anda. [Mulai, skalakan, dan bukti](https://phishdestroy.io/tgwitness/docs/reference/overview/) menjelaskan pilihan dan pengukuran yang telah dipublikasikan. Untuk instalasi server, ikuti panduan "[Keep it running"](https://phishdestroy.io/tgwitness/id/docs/server/). --- # Gunakan akun terpisah. Jangan pernah menggunakan akun utama Anda. Canonical page: https://phishdestroy.io/tgwitness/id/docs/dedicated-account/ Siapkan akun Telegram terpisah untuk pengumpulan data. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Baca sebelum Anda menghubungkan akun Saran kami agar Anda tidak menggunakan akun utama Anda bukanlah lelucon. Ini adalah kenyataan. Akun utama - Dengan hash aplikasi Anda sendiri, 99% akun akan keluar - Pemblokiran akun hanya karena tingkat kepercayaan yang rendah sering terjadi - Menggunakan akun utama Anda adalah ide yang benar-benar bodoh Akun tambahan pada pasangan ID API/hash API publik - Lebih dari satu juta akun telah didaftarkan melalui pasangan ID API/hash API ini - Pasangan API ID/API hash ini telah aktif selama lebih dari 5 tahun - Tidak ada yang dapat melihat data Anda apa pun melalui pasangan API ini 01 ## Mengapa Anda tidak boleh menggunakan akun utama Anda Ini adalah informasi yang akurat. Kami tahu persis di mana letak kendala dari masalah-masalah ini. 1. ### Dengan hash aplikasi Anda sendiri, 99% akun akan keluar Masuk ke my.telegram.org menggunakan akun yang tidak Anda miliki aksesnya, untuk mendapatkan hash aplikasi, dan kemudian setiap permintaan yang dilakukan melalui hash aplikasi tersebut berarti ada kemungkinan 99% bahwa akun tersebut telah keluar. Anda dapat memeriksanya. 2. ### Pemblokiran akun hanya karena tingkat kepercayaan yang rendah sering terjadi Akun diblokir hanya karena Telegram tidak mempercayainya, dan pemblokiran semacam itu sering terjadi. Anda juga dapat memeriksanya. Menggunakan akun Anda sendiri adalah ide yang benar-benar bodoh. 3. ### Kunci sesi yang disalin dapat dicabut Menjalankan kunci TData/sesi yang diimpor di Telegram Desktop dan TgWitness secara bersamaan dapat memicu pesan `AUTH_KEY_DUPLICATED`. Telegram akan membatalkan otorisasi tersebut, sehingga kedua salinan tersebut memerlukan proses login baru. Akun khusus tidak dapat mencegah hal ini. Tutup sepenuhnya klien asli dan biarkan tetap tertutup saat menggunakan sesi yang diimpor. Untuk penggunaan paralel, masuk ke TgWitness melalui ponsel atau QR untuk membuat otorisasi terpisah; klien lain yang telah diotorisasi secara terpisah dapat tetap masuk. [Baca peringatan impor sesi](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=id#session-warning) Dokumentasi Telegram - [Kesalahan saat logout: AUTH_KEY_UNREGISTERED, SESSION_REVOKED](https://core.telegram.org/api/errors) - [Membuat hash aplikasi Anda sendiri: mendapatkan api_id](https://core.telegram.org/api/obtaining_api_id) 02 ## Mengapa TgWitness beroperasi melalui pasangan app hash dan app ID publik Itulah mengapa kami membangun TgWitness berdasarkan pasangan hash aplikasi/ID aplikasi publik. Menurut logika kami, risiko pemblokiran lebih kecil dengan menggunakan pasangan tersebut: lebih dari satu juta akun Telegram telah terdaftar melalui pasangan ini, dan banyak program berbeda beroperasi melalui pasangan tersebut. Menurut logika kami, ini lebih baik daripada bekerja langsung dengan hash aplikasi pribadi: pasangan ini sudah pasti ada selama lebih dari 5 tahun. ### Pasangan API ID/API hash baru Anda sendiri Dibuat di my.telegram.org dari akun tersebut. - Sekitar 99% dari akun-akun ini akan keluar secara otomatis - Satu aplikasi baru, satu akun ### Pasangan ID API publik/API hash dari kumpulan Pasangan API ID/API hash yang sama yang digunakan oleh banyak program. - Lebih dari satu juta akun terdaftar - Berbagai program yang berbeda - Pasangan API ini telah beroperasi selama lebih dari 5 tahun ### Mengapa tidak ada yang dapat melihat data Anda melalui pasangan API ini - #### Pasangan API tersebut adalah nama, bukan kunci Telegram meminta ID API dan hash API saat sebuah program terhubung dan saat meminta kode login. Keduanya berfungsi untuk mengidentifikasi aplikasi dan tidak memberikan akses ke akun apa pun; dokumentasi Telethon menyebutkan bahwa satu pasangan ID dan hash tersebut dapat digunakan dengan nomor telepon apa pun. - #### Kunci sesi Anda tidak pernah meninggalkan server Anda Proses masuk (login) menciptakan kunci otorisasi melalui pertukaran Diffie–Hellman antara TgWitness Anda dan Telegram; kunci itu sendiri tidak pernah dikirim. Dokumentasi Telegram: setelah otorisasi, kunci tersebut dikaitkan dengan pengguna, dan setiap panggilan yang menggunakan kunci ini dijalankan sebagai pengguna tersebut. Program lain dengan pasangan kunci yang sama memiliki kunci mereka sendiri dan tidak dapat menggunakan kunci Anda. - #### Lalu lintas data dienkripsi menggunakan kunci Anda Setiap permintaan dan respons dienkripsi menggunakan kunci otorisasi sesi, bukan menggunakan hash API. Mengetahui hash API tidak akan mendekripsi apa pun. - #### Pemilik pasangan ID API/hash API tidak melihat apa pun Telegram tidak memiliki metode yang menampilkan daftar akun, sesi, atau pesan berdasarkan ID API. Pemilik pasangan akun tersebut hanya dapat melihat pengaturan aplikasinya di my.telegram.org. - #### Hanya akun Anda yang dapat melihat aplikasi mana yang dimaksud Pengaturan → Perangkat pada akun Anda mencantumkan nama aplikasi dan ID API, perangkat, alamat IP, serta tanggal dari setiap sesi. Tidak ada orang lain yang mendapatkan daftar ini. Dokumentasi Telegram - [Otorisasi pengguna: kunci tersebut terikat pada pengguna](https://core.telegram.org/api/auth) - [auth.sendCode: api_id, api_hash](https://core.telegram.org/method/auth.sendCode) - [initConnection](https://core.telegram.org/method/initConnection) - [Membuat kunci otorisasi MTProto](https://core.telegram.org/mtproto/auth_key) - [Enkripsi MTProto](https://core.telegram.org/mtproto/description) - [account.getAuthorizations](https://core.telegram.org/method/account.getAuthorizations) - [Apa saja yang terkandung dalam entri otorisasi (sesi) Telegram](https://core.telegram.org/constructor/authorization) - [Mendapatkan api_id](https://core.telegram.org/api/obtaining_api_id) - [Kode sumber terbuka aplikasi Telegram](https://telegram.org/apps#source-code) Pustaka dan utas diskusi - [Telethon: masuk ke Telegram](https://docs.telethon.dev/en/stable/basic/signing-in.html) - [opentele: kredensial API dari aplikasi resmi](https://opentele.readthedocs.io/en/latest/documentation/authorization/api/) - [opentele: TelegramClient](https://opentele.readthedocs.io/en/latest/documentation/telethon/telegramclient/) - [Stack Overflow: apakah api_hash harus dijaga kerahasiaannya?](https://stackoverflow.com/questions/49490818/should-telegram-api-hash-be-kept-secret) ### Pasangan API ID/API hash yang sama di program lain 7 Pasangan API ID/API hash dari aplikasi Telegram resmi bersifat publik dan terintegrasi ke dalam banyak program dan pustaka independen: - [opentelePython · src/api.py](https://github.com/anmv/opentele/blob/4df17bd8c443d6452afc5a2d29ec7922fad1a5c3/src/api.py#L575) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [opentele2Rust · opentele2-core/src/api.rs](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/api.rs#L641) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [GrampoPython · Grampo/ut/api.py](https://github.com/abbas-bachari/Grampo/blob/00aa662d853c4ac2180432371c5e0d9444bbfe9e/Grampo/ut/api.py#L526) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [tgmanagePython · api/schemas/api_app.py](https://github.com/xdsnich/tgmanage/blob/f67c46be0ab234bd04526a8663d3936bd98a8597/api/schemas/api_app.py#L47) - Android 6 - iOS 8 - Desktop 2040 - macOS 2834 - Telegram X 21724 - Web K 2496 - [LyChatBotTDLib · helpers/tdlib/index.js](https://github.com/LyoSU/LyChatBot/blob/fac0ae5d5f2cddb8a26312014f51c0f6f40ec191/helpers/tdlib/index.js#L11) - macOS 2834 - [hsadasdPython · config.py](https://github.com/herobrinovaleksandr-png/hsadasd/blob/6842c74895038c16e219324fcd07dbe8153f37f0/config.py#L68) - Desktop 2040 - Desktop 17349 - Telegram X 21724 - macOS 2834 - iOS 10840 - Web 2496 - +4 - [blb.teamblb.team/threads/…294](https://blb.team/threads/app-hash-app-id-ofitsial-nykh-kliyentov.294/) - Android 4 · 5 · 6 - iOS 8 - Desktop 2040 - Desktop 17349 - macOS 2834 - Telegram X 21724 Sebuah postingan forum yang mencantumkan pasangan API ID/API hash dari aplikasi Telegram resmi, yang dipublikasikan untuk mendaftarkan akun 03 ## Cara membuat akun tambahan Akun Telegram memerlukan nomor telepon untuk menerima kode login. Pilih berdasarkan berapa lama akun tersebut harus tetap aktif. - Pilihan terbaik ### SIM prabayar atau eSIM ******** Berapa lama masa berlakunya Selama Anda terus mengisi ulang saldo Perlu diingat Yang paling andal: Telegram paling baik menerima nomor ponsel asli. Nomor yang ditarik kembali oleh operator akan diberikan kepada orang lain. - ### Aplikasi dengan nomor telepon virtual ******** Berapa lama masa berlakunya Selama aplikasi tersebut menyimpan nomor telepon tersebut Perlu diingat Telegram mungkin menolak nomor virtual, tidak mengirimkan kode, atau langsung membatasi akun baru; beberapa aplikasi menarik kembali nomor yang tidak digunakan. - ### Penyewaan nomor telepon ******** Berapa lama masa berlakunya Untuk masa sewa Perlu diingat Setelah selesai, nomor tersebut akan dialihkan ke pelanggan berikutnya. - ### Aktivasi satu kali ******** Berapa lama masa berlakunya Hanya satu kode login Perlu diingat Nomor tersebut langsung kembali ke kumpulan, seringkali disertai riwayat pemilik sebelumnya. Tetapkan kata sandi cloud sebelum melakukan hal lain. Siapa pun yang memiliki nomor tersebut di kemudian hari dapat meminta kode login. Kata sandi cloud (verifikasi dua langkah) mencegah mereka masuk; tanpa kata sandi tersebut, akun tersebut menjadi milik pemilik nomor berikutnya. Dokumentasi Telegram - [FAQ Spam: nomor virtual dan pemilik sebelumnya](https://telegram.org/faq_spam) - [Verifikasi dua langkah](https://core.telegram.org/api/srp) ### Nomor +888 yang disewa (Fragment) Beberapa pasar dan layanan menawarkan penyewaan sementara nomor +888 resmi Telegram dari Fragment. Perkiraan harga: US$20 per hari. - Anda dapat mendaftarkan akun secara langsung di Telegram Web atau Telegram Desktop. - Anda dapat menghapus akun pada nomor tersebut dan membuat yang baru. - Akun-akun ini umumnya menghadapi lebih sedikit pemeriksaan anti-penipuan, tetapi tidak memberikan kekebalan atau hak istimewa khusus. Nomor tersebut bukan milik Anda. Setelah masa sewa berakhir, pemilik dapat mengambilnya kembali. Segera atur kata sandi cloud dan jangan menganggap akun ini sebagai akun jangka panjang. Memiliki nomor +888 sendiri atau menggunakan SIM prabayar yang Anda kendalikan tetap lebih dapat diandalkan. ### Akun siap pakai dari pasar online Beberapa pasar (misalnya G2G atau Z2U) menjual akun Telegram siap pakai — baru, yang sudah lama, atau dengan file sesi. - [G2G: Daftar akun Telegram](https://www.g2g.com/uk/categories/telegram-accounts) - [Z2U: Daftar akun Telegram](https://www.z2u.com/telegram/accounts-5-15140) JANGAN PERNAH MENGGUNAKAN AKUN UTAMA ANDA! Akun khusus yang diperoleh dengan cara ini tetap lebih aman daripada memasukkan akun Telegram utama Anda ke dalam TgWitness. #### Peringatan sebelum pembelian - Hal ini melanggar Ketentuan Layanan Telegram. - Banyak akun yang didaftarkan secara massal (pendaftaran otomatis) atau memiliki riwayat yang tidak diketahui. - Beberapa penjual mungkin masih memiliki akses pemulihan. - Akun dari pasar semacam itu sering kali diblokir atau dibatasi di kemudian hari. - Hindari pasar gelap yang secara terbuka menjual perangkat pencurian, alat phishing, atau akun yang jelas-jelas dicuri. - Membeli akun — bahkan yang diiklankan sebagai "auto-reg" — dari platform yang secara terbuka menjual alat phishing, pencuri data, sesi yang dicuri, atau akun, tidak hanya melanggar Ketentuan Layanan Telegram tetapi juga undang-undang di sebagian besar negara. Hal ini dapat membuat bukti Anda tidak sah di kemudian hari. Pilihlah dengan hati-hati. #### Jika Anda menggunakan opsi ini 1. Perlakukan akun ini sebagai akun sekali pakai. 2. Akhiri semua sesi lainnya, atur kata sandi cloud, dan ubah metode pemulihan segera. 3. Gunakan 2–3 akun dari penyedia yang berbeda atau akun yang Anda daftarkan sendiri. **Premium, penghapusan, dan penundaan tujuh hari** Jika akun tersebut memiliki Premium, seseorang yang memiliki akses ke nomor telepon tersebut tidak dapat langsung menghapus akun tersebut. Anda akan menerima pemberitahuan dan memiliki waktu tujuh hari sebelum akun tersebut dihapus. Hal ini penting karena penyelidikan Anda bergantung pada akun tersebut: Anda masih memiliki waktu untuk menyiapkan akun pengganti. **Akun baru dan kredensial API** Jika Anda memperoleh dan menggunakan api_id/api_hash Anda sendiri dari akun baru yang Anda daftarkan sendiri menggunakan nomor dari layanan SMS, akun tersebut akan keluar pada permintaan API pertama atau otorisasi sesi. Ingatlah hal ini saat merencanakan penyelidikan. 04 ## Membuat akun Mulai dari mendapatkan nomor telepon hingga obrolan pertama yang terekam. 1. ### Dapatkan nomor telepon SIM prabayar atau eSIM jika akun harus aktif dalam jangka panjang; sewa atau aktivasi satu kali untuk pekerjaan jangka pendek. Layanan-layanan tersebut tercantum di bawah ini. 2. ### Daftarkan akun terpisah dari akun utama Anda Daftarkan diri Anda di aplikasi Telegram resmi menggunakan perangkat terpisah, emulator, atau profil ponsel, bukan di perangkat yang sama dengan akun utama Anda. 3. ### Lindungi akun dengan kata sandi cloud Segera atur kata sandi cloud dan alamat email pemulihan yang tidak digunakan di tempat lain. 4. ### Batasi pengaturan privasi akun Nomor telepon **"Tidak ada**", "Temukan saya melalui nomor saya", **"Kontak saya**", "Terakhir terlihat", foto profil, dan bio **"Tidak ada"** atau "**Kontak saya**"; matikan sinkronisasi kontak. 5. ### Mencegah akun agar tidak terhapus secara otomatis Atur fitur penghancuran otomatis akun ke periode terpanjang, sehingga TgWitness yang dihentikan tidak akan membuat Anda kehilangan akun. 6. ### Buat profil yang netral untuk akun tersebut Tidak ada nama, foto, nama pengguna, atau deskripsi profil dari akun Anda yang lain, serta tidak ada kontak pribadi. 7. ### Biarkan akun baru tersebut 'beradaptasi' Pada awalnya, bergabunglah hanya di beberapa obrolan setiap hari. Akun baru yang terburu-buru akan dibatasi terlebih dahulu. 8. ### Jangan berbagi apa pun dengan bot Jangan pernah menekan tombol “Bagikan nomor telepon” atau “Bagikan lokasi” untuk bot. Buka tautan dan Mini Apps melalui VPN atau proxy di perangkat tersebut. 9. ### Hubungkan akun tersebut ke TgWitness Di ruang kerja Anda sendiri, sambungkan melalui **Akun → Kode QR**, lalu tekan **Sumber → Mode Investigasi**. Aplikasi ini adalah tempat Anda bertindak, sedangkan TgWitness adalah pencatatnya. Dokumentasi Telegram - [Verifikasi dua langkah](https://core.telegram.org/api/srp) - [Pengaturan privasi](https://core.telegram.org/api/privacy) - [Penghapusan otomatis akun jika tidak aktif](https://core.telegram.org/method/account.setAccountTTL) 05 ## Layanan nomor telepon Ini adalah opsi-opsi untuk memulai. Negara, harga, dan apakah Telegram menerima nomor tertentu sering berubah, jadi periksa terlebih dahulu sebelum membayar. ### SIM prabayar dan eSIM 11 - [SMARTYsmarty.co.uk](https://smarty.co.uk) - UK - SIM - [VOXIvoxi.co.uk](https://www.voxi.co.uk) - UK - SIM - [iD Mobileidmobile.co.uk](https://www.idmobile.co.uk) - UK - SIM - [Threethree.co.uk](https://www.three.co.uk) - UK - SIM - [Asda Mobilemobile.asda.com](https://mobile.asda.com) - UK - SIM - [Ultra Mobileultramobile.com](https://www.ultramobile.com) - US - Prabayar Paket PayGo, sangat murah - [US Mobileusmobile.com](https://www.usmobile.com) - US - Prabayar - [Mint Mobilemintmobile.com](https://www.mintmobile.com) - US - Prabayar - [Tracfonetracfone.com](https://www.tracfone.com) - US - Prabayar - [eSIM Plusesimplus.me](https://esimplus.me) - eSIM - [Numero eSIMnumeroesim.com](https://numeroesim.com) - eSIM ### Aplikasi dengan nomor telepon virtual 20 - [Google Voicevoice.google.com](https://voice.google.com) - US Hanya untuk AS; pendaftaran memerlukan nomor telepon AS - [TextNowtextnow.com](https://www.textnow.com) - US - CA Nomor tersebut akan ditarik kembali jika Anda tidak menggunakannya - [TextFreetextfree.us](https://www.textfree.us) - US - [2ndLine2ndline.co](https://www.2ndline.co) - US - CA - [Talkatonetalkatone.com](https://www.talkatone.com) - US - [TextMego-text.me](https://go-text.me) - US - CA - Negara lain - [textPlustextplus.com](https://textplus.com) [Google Play](https://play.google.com/store/apps/details?id=com.gogii.textplus) - [FreeToneGoogle Play](https://play.google.com/store/apps/details?id=com.textmeinc.freetone) - US [TextMe Up · textmeup.com](https://www.textmeup.com) - [Nextplusnextplus.me](https://nextplus.me) - US - [Dingtonedingtone.me](https://www.dingtone.me) - US - CA - [Burnerburnerapp.com](https://www.burnerapp.com) - US - CA - Layanan berbayar Dengan masa uji coba - [Hushedhushed.com](https://hushed.com) - Banyak negara - Layanan berbayar Harga murah - [Sidelinesideline.com](https://www.sideline.com) - US - [MySudomysudo.com](https://mysudo.com) - US - CA - UK - [2NumberGoogle Play](https://play.google.com/store/apps/details?id=com.bpmobile.second.phone) [App Store](https://apps.apple.com/app/id1216135390) - [SLYNUMBERslynumber.com](https://slynumber.com) [Google Play](https://play.google.com/store/apps/details?id=com.dev.slynumber) - [Phonerphonerapp.com](https://phonerapp.com) - [Onoffonoff.app](https://www.onoff.app) - EU Nomor ponsel Eropa dalam sebuah aplikasi - [Sonetelsonetel.com](https://sonetel.com) - Banyak negara - Nomor gratis - [Zadarmazadarma.com](https://zadarma.com) - Banyak negara Nomor telepon virtual ### Penyewaan nomor telepon dan aktivasi satu kali 12 Dengan menyewa nomor telepon, Anda dapat menggunakannya selama berminggu-minggu atau berbulan-bulan. Aktivasi satu kali akan memberikan satu kode login: atur kata sandi cloud segera setelah mendaftar. - [OnlineSimonlinesim.io](https://onlinesim.io) - Penyewaan nomor - Aktivasi satu kali - [SMSPVAsmspva.com](https://smspva.com) - Penyewaan nomor - Aktivasi satu kali - [5SIM5sim.net](https://5sim.net) - Penyewaan nomor - Aktivasi satu kali - [SMSPoolsmspool.net](https://www.smspool.net) - Penyewaan nomor - Aktivasi satu kali - [VAK-SMSvak-sms.com](https://vak-sms.com) - Penyewaan nomor - Aktivasi satu kali - [TextVerifiedtextverified.com](https://www.textverified.com) - Penyewaan nomor - Aktivasi satu kali - [JuicySMSjuicysms.com](https://juicysms.com) - Penyewaan nomor - Aktivasi satu kali - [365SMS365sms.org](https://365sms.org) - Penyewaan nomor - Aktivasi satu kali - [SIMSMSsimsms.org](https://simsms.org) - Penyewaan nomor - Aktivasi satu kali - [GrizzlySMSgrizzlysms.com](https://grizzlysms.com) - Aktivasi satu kali - [SMS-MANsms-man.com](https://sms-man.com) - Aktivasi satu kali - [Tiger SMStiger-sms.com](https://tiger-sms.com) - Aktivasi satu kali --- # Telegram · Hubungkan akun Canonical page: https://phishdestroy.io/tgwitness/id/docs/accounts/ Hubungkan Telegram melalui kode QR, nomor telepon, atau impor sesi. Pilih sumber dan pastikan pesan baru masuk ke jurnal Anda. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Satu ruang kerja = satu akun, jurnalnya, dan kuncinya. ## Pilih cara masuk **Akun** → tambah ruang kerja → pengaturan koneksi. Gunakan akun terpisah untuk ini. - **Kode QR:** pindai dari layar Perangkat di Telegram lalu konfirmasi. - **Nomor telepon:** nomor, kode, lalu kata sandi 2FA jika ada. - **Impor sesi:** berkas sesi Anda sendiri atau data Telegram Desktop. Gunakan profil API bawaan atau API ID dan hash Anda sendiri. Itu hanya mengenali aplikasinya, tidak memasukkan Anda dan tidak menyembunyikan apa pun. **Perlu proxy terlebih dahulu?** Anda dapat [memilih dan menguji rute koneksi](https://phishdestroy.io/tgwitness/id/docs/proxies/) sebelum masuk. Setiap akun memiliki rute tersendiri. ## Pilih apa yang ingin diamati 1. Pilih obrolan, grup, atau kanal yang Anda perlukan. 2. Periksa pengaturan pengumpulan, termasuk media. 3. Jalankan lalu periksa koneksi dan aktivitas terbaru. Akun harus punya akses. Admin dan anggota melihat hal yang berbeda; jurnal menunjukkan apa yang diterima akun ini. Seluruh akun? **Sumber → Cakupan pengamatan → Mode investigasi**, periksa, lalu **Simpan cakupan**. Panduan lengkap: [menyelidiki seluruh akun](https://phishdestroy.io/tgwitness/id/docs/cases/). ## Periksa jalur lengkapnya Di grup uji Anda, kirim pesan dari akun lain, sunting, lalu hapus. Ketiga peristiwa harus muncul di jurnal. Lalu [ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/exports/). "Terhubung" berarti koneksinya berfungsi. Pesan uji yang tertangkap berarti peristiwa benar-benar sampai. ## Tambahkan akun lain Ruang kerja baru di **Akun**, langkah yang sama. Catat sidik jari kunci setiap akun supaya ekspornya bisa dibedakan nanti. --- # Telegram · Pilih proxy Canonical page: https://phishdestroy.io/tgwitness/id/docs/proxies/ Pertahankan rute MTProxy otomatis atau gunakan proxy Anda sendiri. Pilih mode IP, aturan cadangan, dan rute untuk permintaan eksternal. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Jaga akun tetap online dan putuskan sendiri apakah ia boleh menampilkan IP server Anda. ## Pilih mode IP terlebih dahulu 01**Sembunyikan alamat** Hanya proxy. Jika tidak ada yang berfungsi, ia menunggu. 02**Langsung sebagai pilihan terakhir** Langsung terhubung setelah jeda, lalu kembali ke proxy begitu ada yang berfungsi. 03**Server yang berada di balik terowongan atau VPN** Koneksi langsung boleh. Mode ini tidak menyiapkan atau memeriksa VPN untuk Anda. Rute menentukan koneksi. Mode IP menentukan apakah koneksi langsung diizinkan. ## Biarkan kolam menjaga rute 1. **Akun → Pengaturan → Pengaturan koneksi**. 2. Pilih mode IP dan **MTProxy otomatis**, atau rute tetap. 3. Simpan, lalu **Uji koneksi Telegram** (juga berfungsi sebelum masuk). 4. Mulai pengumpulan dan kirim pesan uji ke diri sendiri. Ruang kerja baru dimulai dengan MTProxy otomatis dan **Sembunyikan alamat**. Pool memakai empat daftar publik, menguji server, mempertahankan yang baik, dan mengganti yang mati. ## Gunakan proxy Anda sendiri SOCKS5, HTTP CONNECT, tautan proxy Telegram, atau katalog operator. Jeda pengamatan sebelum mengganti. Rahasia Fake TLS (`ee`…) tidak berfungsi. **Pengaturan rotasi, berbagi, dan percobaan ulang** **Parameter → MTProxy otomatis**: ambang kegagalan, jeda, rotasi, akun per proxy. Batas 1 berarti akun menunggu alih-alih berbagi. Proxy berbeda tetap bisa berbagi IP keluar yang sama. ## Memisahkan Telegram dari permintaan eksternal MTProxy hanya membawa Telegram. Cap waktu, notifikasi, salinan, dan pemeriksaan kode lewat proxy SOCKS5/HTTP terpisah, rute SOCKS5/HTTP akun, atau langsung jika mode mengizinkan. Atau matikan saja. `TGWITNESS_PROXY_FEED_PROXY` menetapkan rute untuk mengunduh daftar. [Saksi](https://phishdestroy.io/tgwitness/id/docs/witness/) punya pengaturannya sendiri. Semua ini tidak menyentuh browser atau jaringan sistem Anda. Lainnya: [mode dan nilai bawaan](https://phishdestroy.io/tgwitness/id/docs/reference/connection/#ip-modes), [siapa yang boleh mengubah rute](https://phishdestroy.io/tgwitness/id/docs/access/). --- # Telegram · Ekspor dan verifikasi Canonical page: https://phishdestroy.io/tgwitness/id/docs/exports/ Ekspor riwayat Telegram yang terekam, verifikasi tanda tangan, dan bandingkan jurnal tersebut dengan titik pemeriksaan yang disimpan oleh saksi independen. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Serahkan berkas yang bisa diperiksa penerima sendiri terhadap ruang kerja Anda. Simpan referensiEkspor ZIP yang ditandatanganiPenerima memverifikasi Baru mengenal tanda tangan dan checkpoint? [Ubah contoh catatan](https://phishdestroy.io/tgwitness/id/docs/concepts/#chain) dan lihat pemeriksaan mana yang menangkapnya. Ingin menyimpan salinan di luar sistem pengumpul? Kunjungi [pengaturan S3](https://phishdestroy.io/tgwitness/id/docs/exports/#s3), [Object Lock,](https://phishdestroy.io/tgwitness/id/docs/exports/#s3-retention) atau [pemulihan terverifikasi](https://phishdestroy.io/tgwitness/id/docs/exports/#s3-restore). ## Simpan sebagai referensi tepercaya Catat sidik jari kunci ruang kerja di tempat lain selain di pengumpul. Saat mengumpulkan, aktifkan mode bukti agar titik pemeriksaan mendapatkan cap waktu sesuai standar RFC 3161 dan OpenTimestamps, atau jalankan [saksi](https://phishdestroy.io/tgwitness/id/docs/witness/) yang memposting ke saluran publik. Simpan juga titik pemeriksaan yang ditandatangani di tempat lain: penerima akan memverifikasi kunci, waktu, dan keadaan jurnal sebelumnya berdasarkan titik pemeriksaan tersebut. ## Unduh ZIP yang telah ditandatangani **Ekspor** → ZIP bukti bertanda tangan. Isinya seluruh jurnal dan manifes berkas bertanda tangan. Bentuk laporan yang mudah dibaca di [Report studio](https://phishdestroy.io/tgwitness/id/docs/reports/), atau kirim hanya data pilihan sebagai [ekstrak serah terima](https://phishdestroy.io/tgwitness/id/docs/handover/). Laporan HTML, PDF, dan JSON punya segelnya sendiri. CSV hanya salinan kerja; untuk integritas gunakan CSV di dalam ZIP yang sudah diverifikasi. ## Verifikasi dengan salinan TgWitness yang tepercaya Di lingkungan proyek, dengan sidik jari dan path Anda sendiri: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` Sebuah pass menampilkan `key_pinned: true` dan `checkpoint_checked: true`. `--require evidence` juga memerlukan waktu dari pihak ketiga untuk catatan terakhir, seperti cap waktu yang telah diverifikasi: checkpoint ditandatangani dengan kunci Anda sendiri, jadi sendirian saja tidak cukup. Simpan output tersebut di samping arsip. Checkpoint harus berada pada atau sebelum akhir ekspor. ## Gunakan hasil verifikasi - **Berkas:** manifes mengikat hash-nya, tanda tangan mengikat jurnal. Setiap perubahan akan terlihat. - **Identitas:** sidik jari yang Anda simpan membuktikan itu kunci yang Anda harapkan. - **Keadaan sebelumnya:** checkpoint membandingkan ekspor dengan awal jurnal yang disimpan sebelum serah terima. - **Cakupan:** celah, hasil akuisisi, dan uji kirim → sunting → hapus menunjukkan apa yang benar-benar ditangkap pengaturan ini. Detail: [apa yang dibuktikan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope). ## Siapkan salinan cadangan di luar lokasi di S3 **Ekspor → Salinan luar** di ruang kerja Anda. Berfungsi dengan AWS S3 dan apa pun yang kompatibel dengan S3. Menyalin segmen jurnal, berkas tersimpan, checkpoint beserta cap waktunya, dan ekspor obrolan yang selesai, masing-masing dienkripsi dengan `AES-256-GCM` sebelum meninggalkan kolektor. Demo online menampilkan kontrol ini dengan unggahan nonaktif. Masukkan kredensial asli hanya di instalasi Anda sendiri. [![Panel salinan lengkap di luar situs: titik akhir, wilayah, bucket, kunci akses, jadwal, penguncian objek, dan kontrol kunci pemulihan](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4)](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4) Panel lengkap dengan opsi lanjutan yang diperluas. Tidak ada kredensial penyimpanan yang ditampilkan. | Bidang | Apa yang harus dimasukkan | | --- | --- | | Titik akhir | URL penyimpanan, tanpa path bucket atau kredensial. Contoh: `https://s3.example.invalid`. | | Wilayah | Sesuai kebutuhan penyedia Anda. Bawaan `us-east-1`. | | Bucket | Bucket yang sudah ada dan bisa Anda tulisi. Contoh: `example-case-backup`. | | Folder di dalam bucket | Prefiks, bawaan `tgwitness`. Prefiks per ruang kerja ditambahkan di atasnya. | | ID Kunci Akses / Kunci Akses Rahasia | Keduanya bersama, disimpan di brankas. Kosongkan keduanya nanti untuk mempertahankannya. | | Alamat bergaya jalur | Aktif: `endpoint/bucket`. Nonaktif: `bucket.endpoint`. Tergantung penyedia. | | Interval penyalinan | 1 sampai 1.440 menit, bawaan 5. Hanya selama aplikasi berjalan. | | Penyimpanan Object Lock | Hari dan mode, jika bucket mendukung Object Lock. Nol mempertahankan bawaan bucket. | 1. Buat bucket, isi tujuan dan kredensial dengan **Simpan salinan luar** tidak dicentang, lalu klik **Simpan pengaturan salinan luar**. 2. **Uji koneksi** mengunggah objek uji terenkripsi. 3. **Unduh kunci enkripsi** dan simpan jauh dari kolektor. Tanpa kunci, tidak ada pemulihan. 4. Centang **Simpan salinan luar**, simpan, lalu **Salin sekarang** atau biarkan jadwal berjalan. ## Periksa retensi dan kemajuan penyalinan Di **Opsi lain**, pilih hari retensi dan `GOVERNANCE` atau `COMPLIANCE`. TgWitness membaca kembali retensi dari objek yang diunggah dan memberi tahu: terkonfirmasi, tidak ada, atau pemeriksaan gagal. Panel menampilkan lintasan terakhir, jumlah objek, byte, batas jurnal yang disalin, dan galat. Berkas lokal yang hilang dilaporkan dan dicoba lagi pada lintasan berikutnya; sisanya tetap disalin. Unggahan lewat koneksi langsung, SOCKS5, atau HTTP. Dengan rute khusus MTProxy, salinan menunggu dengan galat. ## Simpan kunci pemulihan secara terpisah JSON kunci berisi kunci dekripsi, tujuan, prefiks, dan sidik jari kunci. Untuk pemulihan Anda perlu itu ditambah kredensial penyimpanan dengan akses baca. Mengubah endpoint, bucket, atau prefiks? Unduh kuncinya lagi. Salinan baru dimulai di tujuan baru; ekspor lama tetap di tempatnya. ## Pulihkan dan verifikasi di mesin lain Anda perlu instalasi TgWitness yang tepercaya, JSON kunci, kredensial baca-saja, dan folder kosong: ### Windows PowerShell ``` $env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY' $env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` ### Linux / macOS ``` export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY' export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` Semuanya diperiksa dulu di folder sementara pribadi: seluruh jurnal, checkpoint, hash dan ukuran berkas. Path tidak aman, segmen yang bertentangan, atau jurnal yang lebih pendek dari checkpoint-nya akan gagal, dan saat itu tidak ada yang ditulis. Jika berhasil, Anda mendapat `events.jsonl`, `media/`, `checkpoints/`, dan `exports/`. Simpan keluaran JSON perintahnya bersama itu dan bandingkan dengan checkpoint atau catatan saksi yang Anda simpan sendiri. --- # Telegram · Penangkapan GitHub Actions Canonical page: https://phishdestroy.io/tgwitness/id/docs/capture/ Pilih Takeout, ekspor API biasa atau jurnal obrolan pada runner GitHub sementara. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Pilih Takeout, ekspor API biasa atau jurnal obrolan pada runner GitHub sementara. Aktifkan JavaScript untuk membuat kunci dan mendekripsi arsip Anda. **Referensi lengkap** [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penangkapan mandiri](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md) ![Penangkapan mandiri](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b) **Pratinjau tersedia dari halaman `main`.** Sebuah fork menjalankan alur kerja yang disematkan dan dapat digunakan kembali dari `phishdestroy/TgWitness`. Alur kerja tersebut mengekspor akun, obrolan yang dipilih, atau jurnal peristiwa dari satu obrolan menggunakan sesi Telegram yang baru dibuat, memverifikasi berkas ZIP atau manifes multipart sebagai bukti, dan hanya mengunggah data yang dienkripsi oleh penerima. Panel administrasi biasa tidak ditampilkan. Pilih `client=official_web` untuk menjalankan [saksi klien resmi](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) dengan kontrol Telegram Web yang dilindungi dan video. Fitur ini memerlukan proxy hulu milik Anda sendiri dan memantau satu obrolan yang ditampilkan. Secara default, `client=api` tetap mempertahankan mode ekspor akun lengkap yang dijelaskan di bawah ini. Verifikator memeriksa arsip tersebut dengan membandingkannya terhadap surat pernyataan GitHub-nya, alur kerja yang telah disetujui, serta commit pengumpul, dan hash jurnal serta lampiran yang telah ditandatangani. Proses pengumpulan menggunakan kode hulu yang telah di-pin dan penyimpanan baru. Seorang peninjau dapat memeriksa kode tersebut dan memverifikasi arsip yang diserahkan dengan membandingkannya terhadap catatan proses eksekusinya. **Di halaman ini** - [Alur pengguna](https://phishdestroy.io/tgwitness/id/docs/capture/#user-flow) - [Alokasi waktu sesi](https://phishdestroy.io/tgwitness/id/docs/capture/#session-time-budget) - [Pilih mode ini atau ruang kerja permanen](https://phishdestroy.io/tgwitness/id/docs/capture/#choose-this-mode-or-a-persistent-workspace) - [Apa yang bersifat publik, dan apa yang harus tetap bersifat pribadi](https://phishdestroy.io/tgwitness/id/docs/capture/#what-is-public-and-what-must-stay-private) - [Pemecahan Masalah](https://phishdestroy.io/tgwitness/id/docs/capture/#troubleshooting) - [Dekripsi dan verifikasi lokal](https://phishdestroy.io/tgwitness/id/docs/capture/#local-decryption-and-verification) - [Bagaimana garpu tersebut tetap berada di luar proses penangkapan](https://phishdestroy.io/tgwitness/id/docs/capture/#how-the-fork-is-kept-outside-the-capture-process) - [Serah terima kriptografis](https://phishdestroy.io/tgwitness/id/docs/capture/#cryptographic-handoff) - [Ruang lingkup dan validasi](https://phishdestroy.io/tgwitness/id/docs/capture/#scope-and-validation) - [Urutan rilis pengelola](https://phishdestroy.io/tgwitness/id/docs/capture/#maintainer-release-sequence) ## pengguna# Pemandu ini menjelaskan lima tahap dan memungkinkan Anda mencoba penggantian pesan atau pengumpul pada data contoh. **Pilihan Mulai Penangkapan** akan membuka wizard. 1. Pilih **GitHub Actions capture (pratinjau)** di halaman beranda proyek, layar masuk ruang kerja, atau **Ekspor → Buka pembantu capture**. Anda juga dapat membuka [pembantu resmi](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) atau `tgwitness/static/capture.html` dari checkout tepercaya di peramban modern. Helper ini tidak melakukan permintaan jaringan apa pun untuk pemrosesan kunci atau file. Helper ini mendukung bahasa antarmuka situs; panel pengumpulan sementara mendukung bahasa Inggris dan Rusia, serta terbuka dalam bahasa browser jika bahasa tersebut termasuk di antaranya. 2. Buat kunci dan simpan **berkas sealed-key.json**. Ini adalah satu-satunya kunci pribadi untuk mendekripsi. Salin nilai kunci publik **penerima** yang terpisah. Jika kunci pribadi hilang, Anda akan kehilangan akses baik ke koneksi maupun arsip. Pastikan Anda telah menyimpannya untuk melanjutkan ke langkah berikutnya. Jika Anda sudah memiliki berkas pengiriman, muat kunci yang telah disimpan dan pilih **Saya sudah memiliki arsip**. 3. Lakukan fork pada TgWitness, aktifkan fitur Actions di fork tersebut, lalu jalankan **fitur Sealed chat capture**. Tempelkan alamat publik penerima dan pilih durasi 30, 60, atau 120 menit. Jangan pernah mencantumkan nomor telepon, kode login, kata sandi Telegram, kunci pribadi, atau sesi di input alur kerja, commit, isu, atau log. 4. Selama proses berjalan, unduh **sealed-connection** dari Artifacts dan ekstrak file tersebut. Muat `connection.tgwsealed` di dalam helper, menggunakan kunci pribadi yang telah disimpan. Tautan yang dihasilkan berisi rahasia akses acak di fragmen URL-nya. Jaga kerahasiaan tautan ini. Panel akan menghapus fragmen tersebut dan menyimpan rahasia di penyimpanan sesi tab ini; rahasia tersebut tidak disimpan dalam log akses HTTP. 5. Buka tautan koneksi. Masuk menggunakan kode QR, atau dengan nomor telepon Anda dan kode masuk. Masukkan kata sandi verifikasi dua langkah jika Telegram memintanya. Kumpulan kredensial API bawaan digunakan secara default, sama seperti ruang kerja biasa. Anda dapat memperluas bagian kredensial khusus opsional dan memasukkan keduanya `api_id` dan `api_hash` dari [my.telegram.org/apps](https://my.telegram.org/apps). Biarkan kedua kolom kosong untuk menggunakan kumpulan bawaan; pasangan yang tidak lengkap atau salah format akan ditolak. Impor sesi tidak diperbolehkan. Pilih mode ekspor dan cakupan. Tautan koneksi berisi rahasia akses: jaga kerahasiaannya. 6. Pilih **Telegram Takeout**, **API Telegram Reguler**, atau **jurnal peristiwa obrolan**. Untuk ekspor akun, pilih semua obrolan yang dapat diakses atau muat dan pilih satu atau lebih obrolan, lalu tentukan tanggal, jenis obrolan, kategori akun, dan aturan lampiran. Periksa pengaturan dan ukuran, secara opsional simpan file JSON pengaturan untuk peninjau independen, lalu tekan **Mulai penangkapan**. Pengaturan tidak dapat diubah setelah dimulai. Fitur Lanjutkan hanya berfungsi selama proses ini masih berjalan; penghentian dini akan menyimpan data yang telah diperoleh dan mencatat celah data. Kedaluwarsa batas waktu setelah proses dimulai akan menghasilkan arsip yang secara eksplisit tidak lengkap; kedaluwarsa sebelum proses dimulai atau pembatalan tidak akan menghasilkan arsip apa pun. 7. Tunggu hingga **hasil yang disegel** tersedia, unduh dan ekstrak, lalu dekripsi `delivery.tgwsealed` di dalam helper. Anda akan menerima `delivery.zip`, yang berisi `evidence.zip`, `attestation.jsonl`, serta petunjuk. Dekripsi melalui browser terbatas hingga 256 MiB; paket yang lebih besar gunakan perintah streaming lokal di bawah ini. Hasil berukuran besar juga mencakup `delivery-NNNNNN.tgwsealed` bagian-bagian; bagian utama `delivery.tgwsealed` kemudian berisi `evidence.parts.json` dan surat keterangan. Unduh setiap bagian dan gabungkan secara lokal seperti yang dijelaskan di bawah ini. 8. Akhiri sesi sementara di Pengaturan Telegram → Perangkat jika pencabutan belum dikonfirmasi atau proses berjalan dihentikan. Penyelesaian normal akan meminta pengguna untuk keluar, dan proses tersebut mencatat apakah pencabutan telah dikonfirmasi. Repositori tersebut harus berisi commit sumber yang telah dipublikasikan dan disematkan serta commit alur kerja yang dapat digunakan kembali. Cabang lokal saja tidak dapat dipanggil oleh repositori GitHub lainnya. ## waktu sesi# Sebelum pengambilan, **Hitung waktu dan ukuran** memperkirakan riwayat dan berkas yang dipilih berdasarkan jumlah pesan dan sampel terbatas. Tampilan mencakup waktu yang telah dihabiskan untuk masuk, perkiraan waktu pengumpulan, dan cadangan waktu untuk pengemasan. Untuk berkas, perkiraan awal menggunakan 1 MiB/s dan margin waktu dua kali lipat; kemajuan menggantikan asumsi tersebut dengan laju yang terukur. Gunakan **Hanya pesan** atau pilih lebih sedikit obrolan jika perkiraan waktunya melebihi waktu yang tersisa. Waktu tunggu Takeout yang dilaporkan oleh Telegram dimasukkan ke dalam anggaran. Pengumpul menghentikan proses pengumpulan ketika waktu yang tersisa diperlukan untuk pengemasan, menyimpan data yang telah dikumpulkan, dan menandai hasil sebagian. Oleh karena itu, sesi berdurasi 120 menit memanfaatkan sisa jendela pengumpulan yang tersedia alih-alih menunggu batas waktu sebelum menyiapkan arsip. Tampilan menampilkan pilihan-pilihan yang ukuran penuhnya tidak dapat diambil sampelnya. ## Pilih mode ini atau permanen# | Mode pengambilan gambar | Ruang lingkup yang dapat dikonfigurasi | Perbedaan | | --- | --- | --- | | Telegram Takeout, pilihan bawaan | Semua obrolan cloud yang dapat diakses atau obrolan yang dipilih, tanggal, kategori akun, kebijakan media, dan tampilan JSON/HTML | Menggunakan mekanisme ekspor resmi Telegram; mungkin diperlukan persetujuan atau masa tunggu. Takeout dapat mencantumkan saluran/grup yang tersisa jika Telegram mengizinkannya dan meminta data pribadi tambahan. | | API Telegram Standar | Cakupan akun dan pilihan keluaran yang sama, tergantung pada metode yang tersedia melalui API reguler | Tidak menginisialisasi Takeout; tidak dapat menampilkan daftar saluran/supergrup yang tersisa atau mengambil data pribadi yang hanya tersedia di Takeout. Kontak yang dimaksud mencakup pengguna Telegram, bukan seluruh daftar kontak telepon yang tersimpan. Batasan frekuensi tetap berlaku. | | Jurnal acara obrolan | Satu obrolan yang dipilih, kebijakan lampiran, dan avatar opsional | Menampilkan riwayat dan perubahan yang teramati selama proses ini berlangsung. Kategori akun, filter tanggal, dan tampilan yang kompatibel dengan Desktop tidak berlaku. | Ketiga mode tersebut memiliki sertifikasi GitHub dan pengiriman terenkripsi yang sama. Takeout memilih metode akuisisi dan tidak akan pernah diganti secara diam-diam dengan akses API biasa. TgWitness menghasilkan tampilan JSON/HTML dari catatan yang ditangkap dan mempertahankan metode akuisisi yang dipilih dalam ekspor. Lihat [API resmi Takeout](https://core.telegram.org/api/takeout). Secara default, fitur ini menggunakan Takeout, mencakup semua jenis obrolan yang dapat diakses—termasuk obrolan yang diarsipkan—semua tanggal, profil akun, dan kontak, serta file JSON dan HTML yang kompatibel, dan unduhan file. Kuota media awal adalah 4 GiB, dengan batas ukuran file per jenis yang terlihat; untuk file yang lebih besar atau jika kuota unduhan telah habis, akan digunakan hash server jika tersedia. Periksa batas-batas ini sebelum melakukan pengumpulan. Hash tidak dapat merekonstruksi sebuah file. Foto opsional, cerita, metadata sesi, dan data pribadi tambahan tetap menjadi pilihan terpisah. Proses pengambilan data mungkin memerlukan persetujuan dalam sesi Telegram yang sudah ada. Telegram yang menentukan waktu tunda tersebut; proses login baru atau pelaksana baru tidak dapat melewatinya. Jendela waktu pengambilan maksimum adalah 120 menit, termasuk proses login dan persetujuan, sehingga akun besar atau waktu tunggu persetujuan yang lama mungkin tidak dapat diselesaikan. Ekspor lokal yang tetap ada dapat melanjutkan sesi yang sama, tetapi tidak mewarisi sertifikasi GitHub. ### Setujui dan verifikasi Setelah **memeriksa pengaturan dan ukuran**, gunakan "**Simpan Pengaturan" untuk verifikasi**. Setujui hasil `sealed-export-settings.json` dengan peninjau sebelum pengumpulan. Perubahan akan membatalkan penilaian yang telah disimpan. Pengumpul menandatangani pengaturan yang berlaku beserta SHA-256-nya, dan tanda terima ekspor akun mengikat opsi yang sama. Verifikator melaporkan mode aktual, pemilihan, dan kelengkapan, serta menolak ketidaksesuaian antara jurnal dan ekspor akun bersarang. ``` python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete ``` `--expected-selection` menolak jenis transportasi, cakupan obrolan, filter, atau kebijakan lampiran yang berbeda. `--require-complete` hanya menerima ekspor akun dan jurnal obrolan yang tercatat sebagai lengkap. Tanpa bendera-bendera ini, verifikasi tetap memeriksa asal-usul dan integritas sambil melaporkan pengaturan yang tercatat serta celah yang ada. Sepakati pilihan yang diharapkan sebelum proses dijalankan dan simpan secara terpisah dari arsip. Ruang lingkup dan interval akuisisi mengidentifikasi materi yang ditangkap selama proses; gunakan pengamatan sebelumnya yang disimpan saat membandingkan versi-versi sebelumnya. | Kebutuhan | Mode | | --- | --- | | Ekspor data akun yang dapat diakses atau obrolan yang dipilih selama sesi terbatas, dan berikan arsip yang telah diverifikasi secara eksternal kepada pihak yang melakukan peninjauan | Tangkapan layar GitHub Actions (pratinjau) | | Memantau beberapa obrolan secara terus-menerus, mengelola akun, mencari, dan membaca arsip yang terus bertambah | Ruang kerja lokal atau Docker | Ini akan memulai proses penangkapan terpisah dengan login baru. Proses ini tidak akan mengunggah jurnal lokal Anda yang sudah ada, mengekspor ruang kerja yang sedang terbuka, atau menggunakan kembali sesi Telegram-nya. Proses penangkapan di cloud yang belum selesai tidak dapat dilanjutkan setelah pelaksananya dihentikan; alur kerja baru akan memulai proses penangkapan baru. Pilihan **Ekspor → Buka alat bantu penangkapan** di ruang kerja akan membuka wizard lengkap di dalam panel. Halaman mandiri menggunakan wizard, kontrol, dan tema yang sama. Keduanya menyimpan kunci dan proses dekripsi di browser Anda. Proses awal alur kerja GitHub dan panel Telegram sementara terbuka di tab terpisah; wizard akan memberi tahu Anda kapan harus kembali. Mengunci ruang kerja akan menghapus kunci yang tersimpan di memori wizard. File kunci yang Anda simpan tetap berada di perangkat Anda. ## Apa yang bersifat publik, dan apa yang harus tetap bersifat Pengumpulan data dijalankan pada runner standar yang dihosting di GitHub. GitHub, pengumpul yang telah disetujui serta dependensinya, halaman pembantu, peramban, dan terowongan HTTPS merupakan bagian-bagian yang tepercaya dalam konfigurasi ini. Host sementara memproses sesi Telegram dan pesan teks biasa; artefak yang dikirimkan dienkripsi untuk penerima. Proses forking menyalin kode proyek ke repositori Anda. Proses ini **tidak** mengekspor akun Telegram Anda. Input alur kerja penerima berupa kunci enkripsi publik. Simpan `sealed-key.json`, kredensial Telegram, kode login, kata sandi 2FA, dan URL koneksi yang telah didekripsi agar tidak dimasukkan ke dalam commit, input alur kerja, dan log publik. Alur kerja ini mempublikasikan artefak koneksi/hasil yang terenkripsi selama satu hari. Unduh keduanya tepat waktu; ketersediaan GitHub Actions, batasan akun, dan penagihan berlaku. Fork publik bukanlah jaminan akan sumber daya komputasi gratis tanpa batas. Tidak ada pembayaran atau token akses GitHub yang dimasukkan ke dalam helper. Kunci dekripsi pribadi tetap tersimpan di browser/file Anda. Materi sesi Telegram dan catatan teks biasa pasti tersimpan di dalam penyimpanan sementara. GitHub dan terowongan HTTPS tetap menjadi infrastruktur tepercaya. Proses pengesahan mungkin membuat ringkasan arsip dan identitas alur kerja menjadi publik; isi arsip tidak disertakan dalam pengesahan. Cap waktu pengesahan bukanlah cap waktu pesan. ## Pemecahan | Gejala | Langkah selanjutnya | | --- | --- | | Tidak **Jalankan alur kerja** tombol | Buatlah fork Anda sendiri, aktifkan Actions, dan sinkronkan dengan upstream `main`. Jangan mengedit pin hulu yang telah disetujui untuk menghindari kegagalan. | | Bukan `sealed-connection` artefak | Periksa apakah pekerjaan tersebut telah dimulai dan menyelesaikan tahap startup/pengunggahan. Kegagalan pada antrian, runner, pengunduhan gambar, terowongan, atau kebijakan repositori dapat menghambat proses startup. | | Tidak dapat membuka koneksi | Muat kunci yang telah disimpan untuk sesi ini, ekstrak artefak yang telah diunduh, dan pilih `connection.tgwsealed`. Runner harus masih aktif. | | Sejarah sedang ditangguhkan | Periksa status panel dan gunakan opsi "Lanjutkan" selama sesi masih aktif, atau selesaikan dengan data yang sudah terkumpul. Batasan Telegram dan konten yang tidak dapat diakses dapat menyebabkan adanya celah. | | Tidak `sealed-result` | Pembatalan atau kedaluwarsa sebelum proses pengumpulan dimulai tidak akan menghasilkan arsip; proses tersebut kemudian berakhir dengan pemberitahuan **Tidak ada arsip**. Langkah pengumpulan, pengesahan, atau pengemasan yang gagal juga akan menghambat pengiriman; langkah yang gagal tersebut mencantumkan alasan yang diberikan oleh supervisor tanpa menyertakan data pribadi. Periksa hal tersebut tanpa perlu memasukkan kredensial. | | Browser tidak dapat mendekripsi arsip berukuran besar | Gunakan CLI streaming di bawah ini untuk paket yang ukurannya lebih besar dari 256 MiB. Kunci pribadi yang salah atau hilang tidak dapat mendekripsi hasilnya. | | Proses verifikasi menolak penandatangan | Gunakan instalasi TgWitness terbaru yang terpercaya dan pemanggil yang tepat `OWNER/REPOSITORY`. Jangan terima kebijakan pengganti yang disertakan dalam arsip tersebut. | | Telegram masih mencantumkan sesi sementara tersebut | Hentikan prosesnya di Pengaturan → Perangkat. Proses keluar mungkin gagal, dan alur kerja yang dihentikan secara paksa mungkin tidak menjalankan proses pembersihan. | Sebelum mengandalkan pratinjau ini, cobalah percakapan kecil yang Anda kendalikan: buat pesan dan lampiran, kumpulkan keduanya, dekripsi hasilnya, jalankan verifikator, periksa hasil cakupan/media, dan pastikan pencabutan sesi Telegram. Pemeriksaan otomatis menggunakan klien Telegram sintetis ditambah uji sertifikat GitHub asli yang terpisah; belum ada catatan pengujian menggunakan akun aktif pada revisi saat ini. ## Dekripsi dan lokal# Gunakan alat dari sumber yang tepercaya dan independen, bukan berkas yang dapat dieksekusi yang disediakan oleh arsip bukti yang tidak dikenal: ``` python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip # Unzip delivery.zip using your archive manager, then: python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` Untuk pengiriman multipart, dekripsi paket utama terlebih dahulu dan simpan manifest yang telah diekstrak di samping setiap bagian yang terenkripsi, lalu jalankan: ``` python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` Manifest adalah subjek yang telah diverifikasi dan mengikat setiap bagian serta berkas ZIP yang telah digabungkan. Gunakan `--max-gib` untuk menetapkan batas verifikasi tanpa kompresi yang sesuai untuk arsip berukuran besar; nilai defaultnya adalah 4 GiB. Pemeriksaan "expected-selection" dan "complete-scope" juga berfungsi pada pengiriman multipart. Python 3.11 ke atas, dependensi proyek, dan GitHub CLI versi terbaru yang mendukung `--signer-digest` dan `--deny-self-hosted-runners` diperlukan. Generator kunci CLI juga tersedia: `python -m tgwitness.sealed_crypto keygen sealed-key.json`. Verifikator menggunakan `tgwitness/sealed_policy.json` dari instalasi tepercaya. Verifikator memeriksa repositori pemanggil, alur kerja penandatangan hulu, komitmen penandatangan yang disetujui, persyaratan pelaksana yang dihosting, ringkasan ZIP lengkap, jurnal internal, dan integritas lampiran, asal kunci akun yang baru, serta komitmen pengumpul yang diharapkan. Verifikator menampilkan riwayat dan hasil media, bukan menyiratkan bahwa semua data telah disimpan. Daftar rilis yang disetujui yang kosong akan dianggap gagal. Memperbarui kebijakan merupakan keputusan kepercayaan yang eksplisit; jangan pernah menerima kebijakan yang diusulkan oleh arsip itu sendiri secara otomatis. Untuk penggunaan offline, peroleh akar sertifikat tepercaya terlebih dahulu dari lingkungan yang tepercaya: ``` gh attestation trusted-root > trusted_root.jsonl python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl ``` Cap waktu pada surat pernyataan tersebut berkaitan dengan komitmen arsip. Cap waktu tersebut tidak mengautentikasi cap waktu pesan atau jam dinding milik pengumpul. Lihat [opsi verifikasi GitHub](https://cli.github.com/manual/gh_attestation_verify). ## Bagaimana garpu tetap berada di luar penangkapan# Panggilan tersebut berisi referensi tingkat pekerjaan ke alur kerja hulu yang dapat digunakan kembali pada SHA commit lengkap. Alur kerja tersebut secara eksplisit melakukan check-out **repositori hulu pada SHA kolektor tetap**. Alur kerja default `actions/checkout` dalam alur kerja yang dapat digunakan kembali akan melakukan checkout terhadap pemanggil dan secara sengaja tidak digunakan. Alur kerja ini tidak memulihkan cache pemanggil, menggunakan artefak pemanggil, menjalankan file pemanggil, atau menerima URL sumber/gambar, perintah shell, file ZIP yang telah disiapkan, atau hash untuk ditandatangani. Alur kerja ini menerima penerima publik yang terbatas dan durasi sesi yang ditentukan. Tindakan, gambar dasar Python, dan cloudflared dikunci oleh ringkasan yang tidak dapat diubah; ketergantungan Python menggunakan persyaratan yang sudah terkunci dengan hash. Gambar tersebut dibangun dari sumber tepercaya tanpa cache. Collector berjalan sebagai pengguna non-root dengan image read-only, kemampuan Linux yang dibatasi, batasan sumber daya, serta tanpa lingkungan soket Docker atau token GitHub. Satu-satunya direktori yang dipasang adalah direktori konfigurasi baru, ruang kerja, dan direktori keluaran. Aplikasi FastAPI yang dibatasi ini menyediakan fitur login, dialog, pengaturan akun atau koleksi obrolan yang dapat dikonfigurasi, status, lanjutkan, selesaikan, dan pembatalan. Tidak ada rute unduhan teks biasa, rute administrasi umum, rute impor, atau titik akhir penandatanganan. Pengawas menghentikan kontainer yang terhubung ke jaringan sebelum tindakan verifikasi membaca versi final yang telah diperbaiki `evidence.zip` atau `evidence.parts.json`. Kontainer pengemasan tidak memiliki jaringan. Langkah-langkah unggahan hanya menyebutkan `connection.tgwsealed` dan `delivery*.tgwsealed`; baik bukti teks biasa maupun kredensial Telegram tidak diunggah sebagai artefak. Proses pembersihan menghapus direktori dan kontainer pribadi, dan GitHub membuang VM runner yang dihosting setelah pekerjaan selesai. Retensi artefak berlaku selama satu hari; unduh sebelum masa berlaku habis. Pemilik fork dapat mengganti pihak yang memanggil atau membuat berkas bertanda tangan yang berbeda. Pemeriksa ketat harus menolak hasil yang dihasilkan **alur kerja penandatangan yang berbeda/ringkasan**. Pembangunan ini masih bergantung pada tidak adanya bug yang dapat dieksploitasi dalam kode yang telah disetujui serta pada integritas runner dan infrastruktur penandatanganan GitHub. ## kriptografis# Setiap kunci penerima menggunakan RSA-3072 (impor RSA-4096 juga diterima), dengan eksponen 65537. Setiap amplop memiliki kunci AES-256 acak yang baru dan nonce 96-bit. RSA-OAEP dengan SHA-256/MGF1-SHA256 membungkus kunci AES. AES-GCM dengan tag 128-bit mengautentikasi prefiks dan muatan secara keseluruhan. Kunci publik penerima berbentuk DER SPKI dalam base64; berkas kunci pribadi berisi DER PKCS8 dalam base64. Byte-byte amplop terdiri dari `TGWSEAL1\n`, panjang header JSON tipe uint32 big-endian, header, teks terenkripsi, dan tag GCM berukuran 16 byte. Panjang header tepat `algorithm`, `key`, dan `nonce`; algoritmanya adalah `RSA-OAEP-256+A256GCM`. Awalan lengkap hingga header merupakan data otentikasi tambahan GCM. Ukuran header dibatasi hingga 8192 byte. CLI mengalirkan muatan hingga 8 GiB dan melakukan otentikasi sebelum menyiapkan keluaran yang diminta; CLI menolak menimpa tujuan yang sudah ada. Ini adalah selubung khusus proyek di sekitar primitif kriptografi standar: RSA-OAEP dengan SHA-256 dan AES-256-GCM, yang tersedia di OpenSSL dan setiap perpustakaan kriptografi utama. Byte bukti asli diverifikasi **sebelum** bukti dan verifikasi tersebut dimasukkan ke dalam paket luar yang terenkripsi. Hal ini mencegah terjadinya ketergantungan sirkuler antara hash arsip dan sertifikat yang terdapat di dalam arsip yang sama. Untuk repositori publik, metadata verifikasi (repositori, alur kerja, commit, nama artefak, dan ringkasan) bersifat publik. Jangan pernah mencantumkan nama obrolan dalam metadata publik. ## Ruang lingkup dan Mode ini menggunakan mesin jurnal bertanda tangan dan ekspor akun. Obrolan Rahasia, riwayat yang dihapus sebelum proses pengumpulan, serta data yang tidak dapat diakses oleh akun tersebut tidak termasuk. Obrolan cloud pribadi memenuhi syarat jika dipilih. Pemilih obrolan dibatasi hingga 20.000 dialog; ekspor akun akan mendeteksi inventarisnya sendiri. Data yang hilang, berkas yang gagal, dan tugas yang belum selesai dicatat. Batas lampiran serta batas ruang disk dan waktu pelaksana tetap berlaku. Pengiriman berukuran besar menggunakan bagian-bagian terenkripsi alih-alih batas pengiriman tetap sebesar 4 GiB. Penyelesaian berarti tugas-tugas terpilih yang dibekukan telah selesai, bukan berarti setiap catatan historis Telegram ada di dalam arsip. Jurnal obrolan juga dapat memantau pembaruan secara langsung; tidak ada satu pun mode yang merupakan snapshot atomik. Tangkapan layar dan rekaman layar yang dihasilkan bukan bagian dari mode ini. Pengujian mencakup login baru sintetis, isolasi cakupan, media, pembatalan, penyelesaian tenggat waktu sebagian, kegagalan logout, jalur dan bidang API yang dilarang, penolakan ruang kerja yang dimuat sebelumnya, penolakan kunci salah dan manipulasi, bendera verifikator yang diwajibkan, serta interoperabilitas enkripsi browser/Python. Pengujian penerimaan browser menggunakan attestation tiruan yang diberi label jelas; ini bukanlah pengujian Sigstore yang sesungguhnya. Pengujian penerimaan menggunakan hosted-runner asli, Docker, attestation GitHub, dan Telegram langsung harus dilaporkan secara terpisah dari pemeriksaan sintetis lokal. [Ketentuan GitHub Actions](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) membatasi penggunaan runner yang dihosting hanya untuk siklus hidup proyek perangkat lunak. Membuat fork tidak menghapus pembatasan ini; pratinjau ini tidak boleh dipromosikan sebagai layanan hosting produksi gratis tanpa batasan. [Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) juga ditujukan untuk pengujian dan pengembangan. Fitur helper/workflows cocok untuk mengevaluasi fitur ini; kelayakan layanan produksi tetap menjadi persyaratan penyebaran yang terpisah. ## rilis pengelola# 1. Lakukan commit dan tinjau kode kolektor, pengawas, definisi kontainer, serta serangkaian pengujian. 2. Simpan commit kolektor tersebut di `sealed-collector.yml`, lalu lakukan commit/tinjau alur kerja yang dapat digunakan kembali. Jangan pernah secara diam-diam menentukan checkout berdasarkan SHA pemanggil. 3. Sematkan commit alur kerja yang dapat digunakan kembali di `sealed-witness.yml` dan tambahkan pasangan SHA workflow/collector-nya ke `sealed_policy.json` dalam rilis tepercaya. 4. Publikasikan semua commit yang dirujuk beserta helper-nya, lalu uji fork independen dan sertifikat GitHub yang asli. Jangan menggabungkan (squash) commit yang dirujuk oleh pin-pin ini kecuali jika rujukan tersebut dibuat ulang dan dipublikasikan kembali. Lihat [alur kerja yang dapat digunakan kembali dan pernyataan kepastian](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) untuk memahami perbedaan antara repositori pemanggil dan penandatangan hulu. --- # Telegram · Selidiki seluruh obrolan Canonical page: https://phishdestroy.io/tgwitness/id/docs/cases/ Lakukan penyelidikan Telegram secara menyeluruh di seluruh saluran, grup, obrolan pribadi, dan bot: pencatatan seluruh akun, riwayat, kontak, tautan, berkas, garis waktu, dan bukti yang terverifikasi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Satu kasus utuh di kanal, grup, obrolan pribadi, dan bot: kumpulkan, hubungkan titik-titiknya, susun ulang lini masa, serahkan. Satu insiden karangan, dari awal sampai akhir. Pengumpulan, pencarian, dan profil orang menemukan catatannya, [Case Board](https://phishdestroy.io/tgwitness/id/docs/case-board/) menatanya, [Report studio](https://phishdestroy.io/tgwitness/id/docs/reports/) menyajikannya. KASUS YANG TELAH DITANGANI / TUJUAN PEMBAYARAN YANG BERUBAH ### Satu insiden. Empat percakapan. Jejak yang perlu direkonstruksi. Sebuah postingan kanal mengarah ke bot. Sebuah grup membicarakan tautan pembayaran baru dan bot menampilkannya. Postingan disunting, obrolan pribadi mengulang tautannya, pesan grup menghilang. Siapa yang memposting setiap versi?Di mana tautan tersebut muncul?File mana yang disimpan?Apa yang berubah, dan kapan? Memuat riwayat, AI, MCP, OCR, dan webhook: [Mengolah arsip](https://phishdestroy.io/tgwitness/id/docs/archive/). ## 1. Menjangkau seluruh akun Cakupan seluruh akun hanya di akun khusus. Akun utama memakai obrolan pilihan atau satu folder. 1. [Sambungkan akunnya](https://phishdestroy.io/tgwitness/id/docs/accounts/) di ruang kerja sendiri. Catat referensi kasus, ID akun, ruang kerja, dan sidik jari kunci. 2. **Sumber → Cakupan pengamatan → Mode investigasi**: **Seluruh akun**, keempat jenis sumber, **Tindakan sendiri**. Setiap obrolan baru disimpan profilnya dan **200 pesan terlihat** terakhirnya. **Simpan cakupan** lalu konfirmasi. 3. **Muat obrolan** dan bandingkan dengan daftar obrolan akun. Batasnya 1.000 dialog (hingga 20.000 di **Parameter → Obrolan yang dibaca dari daftar akun**); yang melebihi batas muncul begitu aktif. 4. **Pengaturan perekaman** → **Semua aktivitas terlihat**, periksa batas lampiran dan ruang disk. Mulai, lalu uji dengan satu pesan, satu suntingan, dan satu penghapusan. SaluranGrupObrolan pribadiBot SATU AKUN / SATU KUNCI PENANDATANGANAN**Semua aktivitas yang terlihat di akun yang dipilih → satu jurnal** Pesan · pengeditan · pemberitahuan penghapusan · reaksi yang terlihat · peristiwa keanggotaan · tindakan sendiri "Seluruh akun" berarti setiap obrolan yang bisa dibuka akun ini, dikurangi pengecualian. Obrolan rahasia direkam oleh modul Secret Chats. Obrolan baru bergabung saat muncul; riwayat lama dimuat sesuai permintaan. ## 2. Mengumpulkan riwayat dan menyimpan berkas-berkas tersebut Buat koleksi Case Board dan tandai yang penting. Simpan daftar sumber: ID obrolan, judul, akun, peran, awal penangkapan langsung, hasil riwayat, hasil media, celah. | Kebutuhan | Tindakan di panel | Fitur yang disediakan | | --- | --- | --- | | Riwayat di seluruh obrolan yang diaktifkan | Sumber → Muat riwayat lengkap | Pesan-pesan lama yang tersedia dimasukkan ke dalam jurnal ruang kerja, dilengkapi dengan fitur jeda/lanjutkan serta laporan kemajuan yang telah ditandatangani. [Panduan riwayat](https://phishdestroy.io/tgwitness/id/docs/reference/history/). | | Konteks obrolan yang ada dalam jurnal | Sumber → Pengaturan perekaman → Cuplikan riwayat | Pesan terbaru sebagai catatan bertanda tangan. Bawaan 500, hingga 10.000 di **Parameter → Snapshot riwayat terbesar**. | | Riwayat lengkap dari satu obrolan yang saat ini terlihat | Ekspor obrolan lengkap → Ekspor obrolan lengkap, atau Obrolan → Ekspor obrolan | Paket bertanda tangan terpisah dengan `chat.json` dan `chat.html`, satu per obrolan. | | Konteks saat obrolan baru muncul | Ruang lingkup pengamatan → Saat obrolan atau bot baru muncul | Profilnya dan hingga 1.000 pesan terbaru (200 dalam mode investigasi). Tidak berlaku untuk obrolan yang sudah ada. | | Ukuran lampiran | Unduh lampiran yang terlihat + batas per jenis | Cari `media.saved` dengan SHA-256 dan ukuran. Dalam antrean, dilewati, atau gagal berarti tidak tersimpan. | Ekspor obrolan tidak masuk ke jurnal atau profil orang. Untuk mencari riwayat lama di dalam TgWitness, gunakan **Muat seluruh riwayat** atau snapshot. Di sini: kanal, grup, obrolan bot, dan obrolan pribadi, ditambah berkas faktur dan hash-nya. Yang dihapus sebelum penangkapan sudah hilang. ## 3. Catat percakapan yang terus berkembang dan tindakan Anda sendiri Biarkan berjalan. Beri bintang pada obrolan panas sebagai prioritas, atur pemeriksaan ulang di **Pengaturan perekaman → Periksa ulang**, dan pantau `recheck.completed`, FloodWait, serta hasil media. **Obrolan → Profil → Simpan profil sekarang** menyimpan deskripsi obrolan, perintah bot, dan metadata lain. **Mengikuti bot atau undangan sebagai bagian dari kasus** 1. **Obrolan → Buka tautan Telegram**, simpan pratinjaunya dulu. Tautan dan pratinjau menjadi catatan bertanda tangan. 2. Jika perlu, **Gabung / buka dan amati** bergabung ke obrolan atau memulai bot dengan parameter mulainya. 3. Untuk mendokumentasikan tindakan, balas atau gunakan **Tekan tombol** dari panel. Anda mendapat `interaction.requested` dan `interaction.result` beserta jawaban bot. Ini tindakan sungguhan. Tombol yang ditekan di aplikasi lain tidak terlihat, hanya jawaban bot. Tanpa aplikasi web, pembayaran, atau telepon/lokasi. ## 4. Melacak orang, tautan, dan berkas di seluruh obrolan 1. **Jurnal**, **Semua sumber**, cari frasa, domain, atau nama pengguna. Buka hasilnya dan kirim **Ke papan**. 2. **Obrolan → Orang → Aktifkan profil**, pilih seseorang: riwayat nama, balasan, aktivitas, **Juga di…**, tautan, dompet, telepon. Buka catatan yang dikutip. 3. Ikuti ID pengguna numerik yang sama ke obrolan lain. Nama, dompet, atau avatar yang cocok adalah petunjuk untuk dicocokkan dengan ID numerik. 4. Bandingkan hash berkas. SHA-256 sama = byte sama. PETA KASUS / IKUTI REFERENSIKasus fiktif · bukan grafik aktual SALURAN / PENGUMUMAN**Asli → tujuan yang telah diedit** Catatan #101, #188 Pesan #84 · pengirim tidak diketahui KELOMPOK / OPERASI**Pengguna 71001 memposting tautan baru** Catatan #146 · pesan #309 Bukti penyimpanan berkas #151 BOT / PERCAKAPAN PEMESANAN**Sebuah tombol mengarah ke tujuan tersebut** Catatan #173 · pesan #12 Metadata tombol "Kembali" PRIVAT / TINDAK LANJUT**Pengguna 71001 mengulangi tujuan** Catatan #205 · pesan #922 Tanda terima file yang disimpan #209 Empat obrolan memberikan pengamatan yang berbeda-beda. Ikuti catatan sumber untuk setiap koneksi; postingan saluran tersebut tidak mencantumkan pengirimnya. ID numerik dan referensi catatan dibuat khusus untuk panduan ini. Peta penjelasan ini menunjukkan cara menghubungkan hasil pencarian, profil, dan catatan yang diperiksa; Case Board menyimpan kartu dan referensi sumber yang sesuai. | Koneksi | Pengamatan pendukung | Kesimpulan yang perlu dipertahankan | | --- | --- | --- | | Akun Telegram yang sama | ID Pengguna 71001 di grup #146 dan obrolan pribadi #205 | ID pengirim yang sama di kedua obrolan. | | Tujuan yang diulang | `pay.example.invalid/new` di #146, metadata tombol #173, postingan yang diedit #188 dan #205 | Tautan yang sama di empat tempat. | | Ukuran file yang sama | Nilai SHA-256 yang sama persis pada tanda terima media yang telah selesai #151 dan #209 | Kedua berkas identik byte demi byte. | Profil hanya mencakup orang yang menulis sesuatu di *ruang kerja ini*, bukan daftar anggota. Kutipan per fakta: **Parameter → Catatan dikutip per fakta**. ## 5. Rekonstruksi urutan dan tandai celah-celahnya Versi di **Obrolan**, lalu **Jurnal** dengan **Semua sumber** + **Suntingan**, **Penghapusan**, **Cakupan**. Masukkan kedua waktu ke lini masa: tanggal Telegram dan saat diamati. 1. 09:00 · #101**Postingan saluran yang direkam** Tujuan asli tetap dipertahankan. 2. 09:12 · #146 / #151**Grup memperkenalkan tautan yang berbeda** Pengguna 71001 mempostingnya; unduhan lampiran selesai. 3. 09:16 · #173**Bot menampilkan tujuan yang sama** Metadata keyboard yang disimpan berisi tautan tersebut. 4. 09:20 · #188**Perubahan pengumuman saluran** Baik pengamatan asli maupun yang telah diedit tetap dipertahankan. 5. 09:24 · #205 / #209**Tindak lanjut pribadi mengulanginya** Lampiran yang disimpan memiliki nilai SHA-256 lengkap yang sama dengan #151. 6. 09:28 · #231**Pemberitahuan penghapusan grup telah diterima** Pengamatan sebelumnya tetap berlaku; baik pihak yang menghapus maupun waktu penghapusan yang tepat tidak disebutkan. Contoh waktu pengamatan dan referensi. Catatan jurnal lainnya terdapat di antara entri-entri ini. Urutan jurnal adalah urutan kedatangan, belum tentu urutan kejadian. Pisahkan catatan langsung, snapshot, pesan yang dipulihkan, penghapusan, dan "tidak ditemukan saat periksa ulang", dan tandai setiap celah sebagai tidak diketahui. ## 6. Perluas penerapan ke akun pengumpul lainnya Satu ruang kerja per akun, langkah yang sama. Catat peran dan sidik jari masing-masing. Nomor pesan berlaku per akun, jadi selalu sebutkan ruang kerja dan obrolannya. [Grup akun](https://phishdestroy.io/tgwitness/id/docs/groups/) menampilkan status, berbagi pengaturan, dan mengekspor semuanya bersama, masing-masing dengan jurnal dan kuncinya sendiri. Lini masa lintas akun Anda susun di catatan Anda. Kasus panjang? Tambahkan [saksi independen](https://phishdestroy.io/tgwitness/id/docs/witness/) dan uji apa yang benar-benar ditangkap setiap akun. ## 7. Serahkan paket kasus yang dapat diverifikasi ZIP bertanda tangan dari setiap ruang kerja (selalu seluruh jurnal, filter tidak berpengaruh), ditambah profil orang, ekspor obrolan, dan berkas. ``` CASE-001/ # assembled by the analyst case-notes.md # question, findings, alternative explanations sources.csv # every chat, role, acquisition result and gap timeline.csv # account + chat + message + seq + both times workspace-A/ evidence.zip # complete signed observation journal retained-checkpoint.json profiles-operations.json # separately signed people profiles history-channel.zip # signed current-history export history-group.zip verification.txt workspace-B/ # separate journal and trusted fingerprint witness/ # retained checks, journal and signed posts SHA256SUMS # hashes of the delivered files ``` Kirim sidik jari secara terpisah. Verifikasi semuanya terhadap ruang kerjanya sendiri: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` Checkpoint tersebut ditandatangani dengan kunci pengumpul, sehingga secara mandiri tidak memenuhi syarat minimum sebagai bukti; `--require evidence` juga memerlukan cap waktu yang diverifikasi atau posting saksi yang mencakup catatan terakhir. Simpan keluaran verifikator, berkas asli, cakupan, dan catatan serah terima bersama temuan Anda. Tulis semuanya di Report studio. Jika penerima butuh lebih sedikit, siapkan [serah terima ringkas](https://phishdestroy.io/tgwitness/id/docs/handover/). --- # Telegram · Buat Case Board Canonical page: https://phishdestroy.io/tgwitness/id/docs/case-board/ Kumpulkan pengamatan yang disimpan, sorotan yang tepat, dan potongan tindakan di papan pribadi, diskusikan dengan tim Anda, dan sajikan kumpulan tersebut. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Ubah pesan tersimpan menjadi kasus yang dikerjakan tim Anda bersama. Penanda, kutipan persis, potongan, dan diskusi, masing-masing terhubung ke sumbernya. Setiap perubahan adalah revisi bertanda tangan. ## Dari pesan ke kartu kasus 1. **Investigasi → Case Board** (mode Standar atau Ahli). Buat koleksi untuk kasusnya. 2. Di **Jurnal** atau obrolan, tekan **Ke papan** (atau **B**). Kartu masuk ke Kotak masuk; beri judul lalu pindahkan. 3. Pilih teks di pesan, **Sorot → papan** menyimpan kutipan persis dan versinya. Catat mengapa itu penting. 4. Diskusikan, beri status, kembali ke sumber kapan pun perlu. **Presentasi** membawa tim menelusuri materinya. ### Ikuti satu tautan pembayaran yang telah diubah Contoh sintetis · ilustrasi lokal 1. **Rekam.** Buka pengamatan yang disimpan #142 beserta versi pesannya. 2. **Tandai.** Simpan kutipan, referensi sumber, dan pertanyaan Anda pada sebuah kartu. 3. **Tinjau.** Tambahkan komentar tim dan pindahkan kartu ke tahap Tinjau. 4. **Tampilkan.** Lakukan panduan langkah demi langkah melalui proses pengumpulan dan buka konteks sumber yang dikutip. #### Catatan yang disimpan #142 “Gunakan tautan pembayaran yang baru.” Obrolan Operasional · pesan 38 · diamati pukul 09:12 UTC #### Kartu: tujuan diubah > Gunakan tautan pembayaran yang baru. Pertanyaan: tujuan mana yang muncul di versi sebelumnya? #### Tinjauan tim Analis: bandingkan dengan pengamatan #101. Status: Peninjauan · revisi dipertahankan #### Konteks sumber Kartu → versi yang disimpan → pengamatan sebelumnya Anotasi dan pengamatan Telegram tetap dapat diidentifikasi secara terpisah. ## Simpan rentang yang berguna sekali saja Shift-klik dua pesan untuk **Potongan di antara**, gunakan **Potongan menurut waktu**, atau simpan filter Jurnal saat ini. **Tampilkan catatan sejak penanda** memperlihatkan yang datang kemudian. Potongan waktu memakai waktu pengamatan; potongan ID pesan mengikuti pesan-pesan itu saat berubah. ## Berikan peran yang tepat kepada setiap rekan kerja **Peninjau** membaca, **Analis** menambah kartu dan komentar, **Operator** juga mengelola koleksi dan keputusan. Izin obrolan juga berlaku untuk kartu. ## Selesaikan pekerjaan ini menjadi hasil akhir yang siap diserahkan Potongan diekspor sebagai JSON bertanda tangan atau CSV. Laporan bisa memuat penanda, potongan, dan komentar; atur itu di [Report studio](https://phishdestroy.io/tgwitness/id/docs/reports/). Untuk penerima terbatas, gunakan [serah terima](https://phishdestroy.io/tgwitness/id/docs/handover/). Detail: [referensi Case Board](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/). --- # Telegram · Rancang laporan Canonical page: https://phishdestroy.io/tgwitness/id/docs/reports/ Pilih data laporan, salah satu dari delapan desain, dan isinya, lalu pratinjau dan ekspor dalam format HTML, PDF yang ditandatangani, atau paket bukti lengkap. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Bawa pembaca dari pertanyaan kasus langsung ke catatan yang tersimpan. Report studio menggabungkan data pilihan Anda, riwayat perubahan, grafik, dan temuan Anda. Delapan desain, HTML dan PDF asli. Setiap laporan HTML, PDF, dan JSON disegel dengan kunci Anda. ## Buat laporan dalam tiga langkah 1. **Ekspor → Atur dan pratinjau → Data**: seluruh ruang kerja, atau obrolan, penulis, tanggal (UTC, saat TgWitness melihat catatan), dan jenis catatan pilihan Anda. 2. **Desain & isi**: pilih desain dan isinya: grafik, peserta, transkrip, perubahan, item Case Board, detail kasus, dan catatan. 3. **Pratinjau**: periksa jumlah, aktivitas, sampel, dan rentang ID yang hilang. Simpan, lalu unduh format yang Anda perlukan. ### Susun materi yang disimpan tersebut agar mudah dipahami oleh pembaca Contoh sintetis · tata letak skematis, bukan laporan yang dihasilkan 1. **Pilih.** Pilih dua obrolan dan periode pengamatan untuk kasus tersebut. 2. **Tulis.** Pilih tata letak dan bagian-bagian yang menjawab pertanyaan tersebut. 3. **Pratinjau.** Periksa jumlah yang dipilih dan teks sebelum dan sesudah yang telah disimpan. 4. **Verifikasi.** Buat berkas akhir dan periksa tanda tangannya dengan sidik jari ruang kerja tepercaya. #### Catatan terpilih 2 obrolan · 1 hari pengamatan Pesan, pengeditan, dan pemberitahuan penghapusan #### Struktur laporan ##### Perubahan tujuan pembayaran Pertanyaan kasus → ruang lingkup → temuan → referensi catatan **Konteks pesan** Pengamatan #142: “Gunakan tautan pembayaran yang baru.” **Perubahan yang disimpan** Sebelum: old.example.invalid → Setelah: new.example.invalid #### Tinjau pilihan tersebut 18 komentar · 2 suntingan yang disimpan Waktu pengiriman, pengeditan, dan pemantauan memiliki label terpisah. #### Hasil akhir PDF yang ditandatangani + JSON yang ditandatangani, atau ZIP yang ditandatangani beserta laporannya yang dapat dibaca Penerima memeriksa berkas dan sidik jari yang tepercaya. ## Pilih gaya penulisan **Classic, Editorial, Briefing, Analytics, Technical, Overview, Reading series, and Ledger & margin**: catatan yang sama, tampilan berbeda. Saat diganti, pilihan dan catatan tetap. Bahasa apa pun dari 25 bahasa. PDF dibuat dengan font bawaan, tanpa browser. Bahasa Tionghoa, Jepang, dan Korea perlu font seperti Noto Sans CJK di server (di sistem atau di `TGWITNESS_FONT_DIR`); jika tidak, Anda hanya mendapat HTML dan JSON. ## Baca perubahan beserta konteksnya Suntingan menampilkan sebelum dan sesudah, penghapusan menampilkan versi tersimpan terakhir. Balasan, terusan, reaksi, tombol, dan lampiran mempertahankan rujukannya. Pratinjau desain memakai 50.000 catatan pertama, pratinjau data menghitung semuanya dengan tepat. Untuk tata letak halaman final, buat PDF-nya. ## Pilih salinan untuk penerima dengan cermat Filter hanya membentuk laporan; ZIP bukti tetap berisi seluruh jurnal dan berkas. Jika penerima harus mendapat lebih sedikit, gunakan [serah terima ringkas](https://phishdestroy.io/tgwitness/id/docs/handover/). Lainnya: [isi laporan](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/), [memverifikasi ekspor](https://phishdestroy.io/tgwitness/id/docs/exports/). --- # Telegram · Siapkan salinan untuk dibagikan Canonical page: https://phishdestroy.io/tgwitness/id/docs/handover/ Pilih catatan dan bidang yang dapat diterima oleh penerima, periksa salinan akhir, dan verifikasi manifes yang telah ditandatangani serta batas jurnal sumbernya. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Bagikan hanya yang perlu, berkas asli tetap utuh. Serah terima adalah ekstrak bertanda tangan terpisah: pilih obrolan dan orang, sembunyikan identitas atau teks, tentukan berkas dan catatan tim yang ikut. Manifes mencatat apa yang dipertahankan, diringkas, dan dikeluarkan. ## Siapkan ekstrak untuk penerima 1. **Ekspor → Ekstrak serah terima**: tulis tujuannya, pilih obrolan dan periode, lalu **Muat orang dari obrolan pilihan** jika Anda butuh orang bernama. 2. Semua orang lain: nama samaran, dikeluarkan, atau sesuai rekaman. Teks dan berkas adalah sakelar terpisah; telepon dan email bisa disamarkan. 3. Case Board: tidak ada, penanda dan potongan, atau kartu dengan komentar. Nama tim bisa diganti alias. 4. **Unduh ekstrak serah terima**, buka, verifikasi, dan periksa sebelum dikirim. ### Satu salinan asli, satu salinan untuk dibagikan Contoh sintetis · hanya untuk ilustrasi identitas 1. **Pilih.** Sertakan obrolan kasus dan identifikasi orang yang menjadi subjek cuplikan tersebut. 2. **Minimalkan.** Pilih bagaimana peserta lain ditampilkan dalam salinan yang dibagikan. 3. **Periksa.** Buka laporan dan catatan dari arsip yang dihasilkan sebelum mengirimkannya. 4. **Bagikan.** Kirimkan salinan yang telah diperiksa dan sampaikan sidik jari tepercaya-nya secara terpisah. #### Pengamatan asli Nora · pengguna 71002 “Saya telah menerima tautan yang telah direvisi.” Jurnal sumber menyimpan pengamatan yang disimpan ini. #### Salinan untuk Penerima Tampilkan sesuai catatan: Nora · pengguna 71002 · “Saya telah menerima tautan yang telah direvisi.” Nama samaran: P01 · “Saya telah menerima tautan yang telah direvisi.” Hapus: pesan peserta ini tidak dimasukkan ke dalam teks. #### Periksa berkas-berkas yang sebenarnya Baca file report.html dan records.jsonl. Periksa identitas, teks, lampiran, dan komentar tim (jika ada). #### Kutipan yang ditandatangani Pemilihan + hash file + manifest yang ditandatangani Sebuah paket terpisah yang terhubung dengan batas jurnal sumbernya ## Gunakan kontrol-kontrol tersebut secara bersamaan | Kontrol | Dampak terhadap teks | | --- | --- | | Orang | Orang yang dipilih tetap bernama; yang lain mendapat nama samaran atau dikeluarkan. | | Teks | Semua teks, hanya teks orang yang dipilih dan akun Anda, atau tidak ada. | | Berkas | Berkas orang yang dipilih dan akun Anda, semua berkas yang ditampilkan, atau tidak ada. | | Papan Kasus | Tidak ada, penanda dan potongan, atau kartu dengan diskusi. | Baca juga teks dan berkasnya: nama samaran tidak menghapus nama yang tertulis di dalam pesan atau lampiran. Jika berkas yang dipilih hilang, pulihkan atau keluarkan lampirannya. ## Pastikan teks dapat diverifikasi secara independen ``` python -m tgwitness.verify handover.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` Simpan sendiri arsip asli dan checkpoint-nya. Penerima bisa memverifikasi salinannya tanpa menerima seluruh ruang kerja. Desain: [Report studio](https://phishdestroy.io/tgwitness/id/docs/reports/). Rujukan tepercaya: [verifikasi ekspor](https://phishdestroy.io/tgwitness/id/docs/exports/). --- # Telegram · Kelola sekelompok akun Canonical page: https://phishdestroy.io/tgwitness/id/docs/groups/ Bandingkan ruang kerja grup, temukan sumber, tinjau periode pengamatan, dan terapkan pengaturan bersama dengan pengecualian per akun. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Jalankan beberapa akun bersama, masing-masing tetap dengan catatan dan kuncinya sendiri. Grup menyatukan status koneksi, mulai/jeda, pengaturan bersama, dan ekspor di satu layar. Praktis saat beberapa akun menangani kasus yang sama. ## Buka ikhtisar grup Buka grupnya di **Akun**. Setiap akun menampilkan status, rute, latensi, dan pesan tersimpan terakhir. **Perlu perhatian** mencantumkan yang bermasalah, **Perbaiki** membawa Anda langsung ke sana. **Mulai semua** / **Jeda semua** bertanya dulu sebelum bertindak. **Pengaturan grup** dibagikan, tetapi nilai milik akun tetap ada sampai Anda menggantinya. ### Tinjau perubahan rute di seluruh grup Contoh sintetis · pemeriksaan dan hasil ilustratif 1. **Pilih.** Pilih grup dan tinjau akun mana saja yang akan berubah. 2. **Persiapkan.** Pertahankan jalur akun tersebut jika memang harus tetap terpisah. 3. **Periksa.** Uji koneksi yang diusulkan dan periksa hasil pengukuran. 4. **Terapkan.** Periksa kembali sebelum menyimpan dan tinjau hasilnya untuk setiap akun. #### Tim kasus Pengumpul saluran · Pengumpul grup · Akun referensi 3 ruang kerja terpisah #### Pilihan yang telah ditinjau 2 akun mengikuti rute yang diusulkan. Akun referensi memiliki jalurnya sendiri. #### Pemeriksaan persiapan Pengumpul saluran: Waktu transmisi Telegram 84 ms Pengumpul grup: Waktu transmisi Telegram 91 ms Angka-angka ini adalah angka fiktif yang digunakan sebagai contoh. #### Hasil aplikasi Pengumpul saluran: rute disimpan, pengamatan dilanjutkan. Pengumpul grup: pemeriksaan ulang gagal, pengaturan sebelumnya dipulihkan. Akun referensi: rute asli dipertahankan. ## Ubah alur dengan menambahkan langkah peninjauan 1. **Ubah rute grup**, pilih jenis dan pengaturannya. 2. **Tinjau pilihan**: akun mana yang berubah dan mana yang punya rute sendiri. 3. **Siapkan dan periksa** menguji koneksi Telegram baru, dan jika memungkinkan juga IP keluar. 4. **Terapkan koneksi yang diperiksa** dan lihat setiap hasilnya. Akun yang berjalan melanjutkan, yang diam tetap diam. Latensi adalah waktu menyiapkan koneksi Telegram; IP keluar adalah yang ditampilkan rute saat diperiksa. Hasilnya bisa berbeda per akun. ## Gunakan akses tumpang tindih **Obrolan yang dilihat beberapa akun** mencantumkan sumber bersama dan cakupannya. Kanal dan supergrup bisa diekspor beberapa akun sekaligus lewat **Ekspor dengan … akun**. Obrolan pribadi dan grup biasa tidak bisa; nomor pesannya berlaku per akun. ## Ekspor grup sebagai paket **Ekspor grup** memberi satu ZIP berisi ekspor bertanda tangan setiap akun dan daftar bertanda tangannya. Masing-masing mempertahankan sidik jarinya untuk verifikasi. Lini masa gabungan tetap Anda susun sendiri. Berikutnya: [laporan](https://phishdestroy.io/tgwitness/id/docs/reports/), [Case Board](https://phishdestroy.io/tgwitness/id/docs/case-board/), [memverifikasi ekspor](https://phishdestroy.io/tgwitness/id/docs/exports/). --- # Telegram · Lihat cara kerja bukti ini Canonical page: https://phishdestroy.io/tgwitness/id/docs/concepts/ Lacak pesan mulai dari saat ditangkap hingga titik pemeriksaan. Ubah catatan sampel, hitung ulang rantai SHA-256-nya, dan lihat apa yang terdeteksi oleh titik pemeriksaan yang disimpan. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Pesan berubah. Catatan Anda tentang apa yang Anda lihat seharusnya tidak, dan siapa pun seharusnya bisa memeriksanya. Di bawah ada dua eksperimen kecil. Pesan fiktif, semuanya berjalan di browser Anda, tidak ada yang dikirim ke Telegram. ## Dari ekspor obrolan menjadi catatan yang dapat diverifikasi [Ekspor Telegram Desktop](https://telegram.org/blog/export-and-more) menyimpan riwayat yang terlihat saat ini sebagai HTML atau JSON. TgWitness menambahkan jurnal perubahan yang terus berjalan, tanda tangan di setiap catatan, dan checkpoint yang bisa dibandingkan orang lain. | Tugas | Ekspor Telegram Desktop | TgWitness | | --- | --- | --- | | Baca percakapan yang disimpan | HTML atau JSON dengan media yang dipilih | Obrolan yang disimpan, jurnal yang dapat dicari, dan laporan offline | | Ikuti perubahan dari waktu ke waktu | Riwayat yang tersedia saat diekspor | Versi lama, suntingan berikutnya, dan penghapusan, semuanya disimpan | | Periksa berkas setelah penyerahan | Berkas ekspor HTML/JSON standar tidak ditandatangani | Manifes bertanda tangan, catatan bertanda tangan, dan laporan bersegel, diperiksa dengan kunci tepercaya | | Bandingkan dengan status yang disimpan sebelumnya | Simpan salinan referensi terpisah atau hash | Titik pemeriksaan yang ditandatangani, saksi terpisah, dan cap waktu eksternal opsional | Perbandingan ini berdasarkan [kode ekspor Telegram Desktop](https://github.com/telegramdesktop/tdesktop/tree/768d47cda6c7f447c10a25d1f363279493a90ed7/Telegram/SourceFiles/export/output) per 2 November 2026. ## Satu pesan, tiga pengamatan Pesan baru, suntingan, dan penghapusan menjadi tiga catatan terpisah. Suntingan tidak menimpa yang pertama, dan penghapusan tidak menghilangkannya. 01 / PERJALANAN PESANUrutan ilustratif Telegram delivers an update to the collector, which appends a journal record. · Telegram · Pengumpul · Jurnal · perbarui → · tambahkan → TAMPILAN OBrolan SAAT INI Pesan #42 Pesan telah dihapus Pesan tersebut telah menghilang dari tampilan obrolan. JURNAL PENGAMATAN 3 catatan 1. 01 `message.new` Bertemu pukul 10.00 ✓ 2. 02 `message.edited` Bertemu pukul 11.00 ✓ 3. 03 `message.deleted` Pemberitahuan penghapusan untuk #42 ✓ Ketiga pengamatan yang diterima tetap tersimpan dalam jurnal tersebut. Jalur yang disederhanakan untuk satu sumber yang telah dipilih. Catatan operasional juga mencakup jurnal asli. Pencatatan bergantung pada apa yang dapat dilihat oleh akun tersebut dan apa yang disediakan oleh Telegram. ## Ubah catatan. Ikuti hash-nya. Setiap catatan berisi hash catatan sebelumnya. Checkpoint yang disimpan di tempat lain mengunci panjang jurnal dan hash terakhir. 02 / HASH-CHAIN SANDBOXSHA-256 asli · contoh catatan CATATAN 01**Pesan diterima**`h₁ = SHA-256(e₁)`Tautan ke 64 nol CATATAN 02**Bertemu pukul 11.00**`h₂ = SHA-256(e₂)`Termasuk h₁ CATATAN 03**Penghapusan terdeteksi**`h₃ = SHA-256(e₃)`Termasuk h₂ DISIMPAN DI TEMPAT LAIN**3 catatan · kepala `h₃`**Bandingkan batas yang telah diperbaiki ini dengan jurnal yang disediakan. Mengubah suatu peristiwa akan mengubah hash-nya. Membangun ulang rantai akan mengubah bagian awalnya. Menghapus bagian akhir akan membuatnya lebih pendek daripada titik pemeriksaan yang disimpan. **Periksa catatan 2 dan hash lengkapnya** Ini adalah JSON UTF-8 yang telah di-hash persis seperti pada contoh ini. Nilai-nilainya fiktif; sembilan bidang dan serialisasinya sesuai dengan format jurnal. ``` ``` Catatan yang disimpan 2 hash `` Hash catatan 2 yang dihitung ulang `` Sandbox ini menghitung hash, bukan tanda tangan. Verifikator yang sebenarnya juga memeriksa tanda tangan Ed25519, urutan, dan tautan setiap peristiwa. Membangun ulang hash saja tidak dapat menghasilkan tanda tangan yang valid di bawah kunci tepercaya. ## Aturan sebenarnya, dalam beberapa baris HASH + TANDA TANGAN h0 = 064 hi = hex(SHA-256(C(ei))) σi = Ed25519.Sign(sk, unhex(hi)) **C** adalah sembilan kolom peristiwa sebagai JSON UTF-8: kunci terurut, tanpa spasi tambahan, tanpa escape ASCII, tanpa NaN/tak hingga. `previous_hash` adalah hi−1, h0 adalah 64 nol, dan tanda tangan mencakup 32 byte mentah digest. Kolomnya: `seq`, `observed_at`, `source_at`, `kind`, `chat_id`, `message_id`, `actor_id`, `payload`, `previous_hash`. Spesifikasi lengkap: [pengodean peristiwa](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#event-canonicalization). TITIK PERIKSA YANG DISIMPAN Nexport ≥ Ncheckpoint hexport[Ncheckpoint] = Hcheckpoint Periksa tanda tangan checkpoint dengan kunci yang dipatok, lalu bandingkan dengan jurnal. Ekspor yang lebih baru boleh lebih panjang, tetapi harus cocok di checkpoint. ## Tiga pertanyaan, tiga pemeriksaan yang berbeda [01 / INTEGRITAS**Apakah catatan ini berubah?** Hash dan tanda tangan terhadap kunci yang Anda percayai.](https://phishdestroy.io/tgwitness/id/docs/exports/)[02 / KONTINUITAS**Apa yang telah disimpan sebelumnya?** Bandingkan ekspor dengan checkpoint yang disimpan saksi.](https://phishdestroy.io/tgwitness/id/docs/witness/)[03 / PENYAMPAIAN**Apakah peristiwa uji coba ini telah diterima?** Kirim, sunting, dan hapus pesan uji, lalu lihat apa yang ditangkap setiap akun.](https://phishdestroy.io/tgwitness/id/docs/cases/) Tanda tangan menjawab "apakah diubah?", checkpoint menjawab "apakah cocok dengan yang ada sebelumnya?", pesan uji menjawab "apakah kita menangkap semuanya?". [Apa yang dibuktikan verifikasi.](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope) Berikutnya: [investigasi seluruh akun](https://phishdestroy.io/tgwitness/id/docs/cases/) dari awal hingga paket kasus. [Klinik Ekspor: saksikan eksperimen terkontrol di Desktop](https://phishdestroy.io/tgwitness/id/docs/export-clinic/). Bandingkan film berdurasi dua menit, rekaman aslinya, dan tujuh pasang hasil ekspor uji coba. Modifikasi lokal diungkapkan. --- # Telegram · Jaga keamanannya Canonical page: https://phishdestroy.io/tgwitness/id/docs/security/ Lihat di mana sesi, kunci, dan bukti disimpan, apa saja yang keluar dari perangkat Anda, apa saja yang dilindungi oleh sistem keamanan, dan cara memperkuat instalasi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Apa yang keluar dari mesin Anda, apa yang dibuka setiap rahasia, dan apa yang dilindungi versus apa yang menjadi tanggung jawab Anda. **127.0.0.1**alamat panel secara default **256-bit**token panel acak **0**CDN, analitik, atau font jarak jauh **Ed25519**tanda tangan pada setiap catatan ## Tempat semua data disimpan Kolektor, panel, dan setiap catatan tetap di mesin Anda. Secara bawaan hanya Telegram yang dihubungi; selebihnya sakelar terpisah. 06 / APA YANG DITINGGALKAN MESINProses instalasi Anda KOMPUTER ATAU SERVER ANDA **Panel**127.0.0.1:8787 · token bearer **Pengumpul**satu klien Telegram per ruang kerja DIREKTORI DATA **Jurnal**SQLite · berantai hash · ditandatangani **Media**file yang diberi nama berdasarkan SHA-256 **Vault**Fernet · sesi, pasangan API, kunci penandatanganan, proxy - **Telegram**Selalu · melalui rute Anda Koneksi MTProto akun ini: langsung, SOCKS5, HTTP, atau MTProxy. Mode Sembunyikan IP menunggu proxy yang berfungsi. Pengalihan ke koneksi langsung memerlukan mode yang secara eksplisit mengizinkannya. - **Teks di luar situs**Opsional · dinonaktifkan secara default Jurnal, berkas, dan titik pemeriksaan dienkripsi dengan AES-GCM sebelum diunggah ke penyimpanan yang kompatibel dengan S3. Kunci tetap berada di tangan Anda; lampiran diberi nama berdasarkan hash yang dienkripsi dengan kunci, bukan hash isinya. - **Pemberitahuan**Opsional · dinonaktifkan secara default Masalah dan jumlah perubahan disertai judul obrolan. Kutipan pesan hanya dikirim jika Anda mengaktifkannya. - **Otoritas cap waktu**Opsional · dinonaktifkan secara default Hanya nilai SHA-256 dari titik pemeriksaan yang ditandatangani dan nilai nonce acak. Tidak ada pesan, tidak ada nama obrolan. - **Saksi**Opsional · dinonaktifkan secara default Mengekstrak titik pemeriksaan yang ditandatangani dan penghitung penangkapan menggunakan token baca-saja. Alat ini tidak dapat membaca percakapan atau mengubah pengaturan. Pengaturan default: hanya koneksi Telegram yang keluar dari mesin ini. Tujuan penyimpanan opsional dikonfigurasi per ruang kerja. ## Apa yang terungkap dari setiap rahasia | Rahasia | Di mana disimpan | Apa yang dapat diakses | Jika bocor | | --- | --- | --- | --- | | **Token panel** | `panel-token.txt` di direktori data; browser menyimpannya per tab | Semua hal di setiap ruang kerja | Hentikan TgWitness, hapus `panel-token.txt`, jalankan lagi: Anda mendapat yang baru | | **Sesi Telegram** | Vault, terenkripsi (`credentials.enc`) | Akun Telegram itu sendiri | Akhiri sesi di Telegram melalui *Pengaturan → Perangkat* | | **Kunci penandatanganan** | Vault, terenkripsi (`signing.enc`) | Menandatangani catatan dengan sidik jari Anda | Checkpoint di tempat lain, saksi, dan cap waktu tetap menunjukkan apa yang ada sebelumnya | | **Kunci brankas** | `vault.key` di samping data, atau kunci induk eksternal | Brankas | Anggap sesi dan kunci tanda tangan juga bocor | | **Token Witness** | Di server TgWitness | Baca-saja: checkpoint dan status | Hapus di halaman saksi, buat yang baru | | **Kunci teks di luar situs** | Vault; unduh sekali untuk pemulihan | Salinan luar | Siapa pun yang juga memegang bucket bisa mendekripsinya: anggap salinannya terbuka | ## Apa saja yang dilindungi oleh perlindungan ini ### Tercakup - Catatan yang diubah, dihapus, atau diurutkan ulang: rantai hash atau tanda tangan rusak. - Jurnal yang dipotong atau dibangun ulang setelah Anda menyimpan checkpoint di tempat lain: checkpoint tidak cocok lagi. - Menebak token: 256 bit acak, perbandingan waktu konstan; 15 kegagalan per menit dan alamatnya diblokir. - Konten obrolan yang berbahaya: teks tetap teks, tidak pernah HTML; lampiran diunduh sebagai berkas; panel tidak memuat apa pun dari situs lain. - Direktori data yang dicuri dengan kunci brankas eksternal: sesi dan kunci tetap terenkripsi. ### Terserah Anda - Token utama bisa melakukan apa saja. Beri orang lain akses terbatas dan simpan token utama untuk diri sendiri. - Simpan sidik jari dan checkpoint di tempat lain. - Enkripsi disknya, batasi izinnya. - HTTP biasa di luar localhost membocorkan token. Gunakan HTTPS atau tunnel SSH. - Periksa cakupan untuk menemukan celah dan uji pengiriman di akun dan sumber Anda sendiri. [Bagikan akses ke sebuah kasus](https://phishdestroy.io/tgwitness/id/docs/access/) dengan izin, masa berlaku, dan batas sesi. ## Memperkuat instalasi 0 dari 8 selesai 1. **Gunakan akun Telegram khusus**, jangan pernah akun utama. 2. **Biarkan panel di 127.0.0.1.** Akses jarak jauh hanya lewat HTTPS (Caddy bawaan) atau tunnel SSH. 3. **Enkripsi disk** tempat direktori data. 4. **Batasi direktori data** untuk akun layanan (0700 di Unix, izin folder di Windows). 5. **Simpan kunci brankas di tempat lain** di server: atur `TGWITNESS_VAULT_KEY_FILE` sebelum start pertama. 6. **Simpan sidik jari dan checkpoint** di sistem lain, jalankan saksi di host lain. 7. **Jangan pernah mengunggah** kunci `data/`, sesi, `panel-token.txt`, atau vault ke GitHub atau obrolan. 8. **Jangan mencatat** header `Authorization` atau isi permintaan di proxy terbalik. **Apakah saya dapat mengubah token panel tanpa kehilangan data?** Ya, token hanya membuka panel. Hentikan TgWitness, hapus `panel-token.txt`, jalankan lagi. Jurnal, sesi, dan kunci tetap ada. Jika `TGWITNESS_TOKEN` diatur, nilai itu yang dipakai, bukan berkasnya. ## Laporkan kerentanan **Security → Report a vulnerability** di GitHub. Versi, dampak, dan contoh minimal dengan data fiktif. Jangan pernah mengirim kredensial, folder akun, atau bukti asli. Jika pelaporan privat nonaktif, buka issue untuk meminta saluran privat, tanpa detail exploit. --- # Telegram · Siapkan bot saksi Canonical page: https://phishdestroy.io/tgwitness/id/docs/witness/ Publikasikan titik pemeriksaan jurnal yang ditandatangani ke saluran Telegram Anda dengan saksi terpisah, kunci tersendiri, dan akses pengumpul yang hanya dapat dibaca. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Proses terpisah memeriksa jurnal Anda dan menerbitkan checkpoint bertanda tangan ke sebuah kanal. ## Dua server, dua kunci penandatanganan HOST A / COLLECTOR**Akun + jurnal** Kunci penandatanganan Pengumpul Sesi Telegram Titik akhir checkpoint yang hanya dapat dibaca ← minta jawaban yang ditandatangani → HOST B / WITNESS**Verifikasi + simpan** Sidik jari pengumpul yang disematkan Kunci penandatanganan saksi terpisah Jurnal sendiri + token bot Saksi → API Bot Telegram →**Saluran Anda · posting TGW1 yang ditandatangani** Witness melakukan verifikasi sendiri. Akses pengumpul bersifat hanya baca. Publikasi bot menggunakan koneksi dan token Witness; tidak ada sesi akun yang diberikan kepada Witness. 03 / KEPUTUSAN CHECKPOINTContoh jawaban TERAKHIR DITERIMA**120 catatan**`head 9c7d…` JAWABAN BERIKUTNYA**128 catatan**`head a4f2…` Diterima: jumlahnya bertambah, tanda tangan terverifikasi, dan kuncinya cocok. Saksi mempertahankan batas baru ini. Semua contoh jawaban mengasumsikan adanya tanda tangan yang valid dan kunci yang disematkan. Hash yang disebutkan di sini hanyalah ilustrasi singkat. Untuk memastikan seluruh prefiks lama tidak berubah, bandingkan ekspor dengan checkpoint yang disimpan. ## Siapkan bot dan saluran Buat bot dengan BotFather dan izinkan ia memposting di kanal Anda. Jalankan saksi di tempat lain: host lain, idealnya dikelola orang lain, jauh lebih berharga daripada proses kedua di samping kolektor. ## Tiga langkah di bagian Ekstra 1. **Akses baca-saja.** **Tambahan → Saksi independen**, buat token, simpan berkasnya. Ia membaca checkpoint dan status, tidak lebih. 2. **Kanal dan interval.** Kanal Telegram atau webhook Discord, ditambah alamat kolektor yang bisa dijangkau saksi. Simpan berkas pengaturan. 3. **Jalankan.** Taruh `witness.json`, `witness-token.txt`, dan `bot-token.txt` bersama di host saksi lalu jalankan: ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json ``` Tunggu postingan bertanda tangan pertama di kanal, lalu simpan sidik jari saksi di tempat aman. Lebih suka Discord? Simpan URL webhook sebagai `discord-webhook.txt`. Satu saksi memposting ke satu tempat; pemeriksaan panjang tiba di Discord sebagai berkas. ## Pilih seberapa sering ingin mempublikasikan Memposting setiap pemeriksaan memberi catatan luar yang rutin: setiap lima menit berarti sekitar 288 postingan per hari per ruang kerja. Pengaturan lanjutan bisa memposting hanya saat ada perubahan atau masalah, memakai proxy, atau Bot API khusus. **Apa sebenarnya yang dibuktikan oleh bot tersebut?** Ia meminta checkpoint bertanda tangan dari kolektor, memeriksanya dengan kunci yang diharapkan, dan menyimpan jurnal bertanda tangan sendiri, termasuk jawaban yang terlewat dan ditolak. Ia memeriksa keadaan jurnal, tidak mengamati Telegram sendiri. Untuk itu, lakukan uji pengiriman terkendali. ## Periksa bukti tersebut nanti Simpan jurnal saksi, postingan, dan sidik jarinya. [Cara memeriksanya](https://phishdestroy.io/tgwitness/id/docs/reference/witness/#verify) terhadap ekspor kolektor. --- # Mengapa Zero Trust: Taylor Wessing, Dr. Zurheide, Dr. Schelinski Canonical page: https://phishdestroy.io/tgwitness/id/docs/signed-export/ Studi kasus zero-trust: sebuah tanggapan terkait GDPR yang ditandatangani oleh Dr. Patrick Zurheide dan Dr. Tobias Schelinski dari Taylor Wessing, yang telah diverifikasi berdasarkan dokumennya sendiri, serta model yang dapat diverifikasi yang tidak akan memberikan ruang bagi penipuan atau keraguan. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) **Studi kasus langsung**Dokumen asli · tanda tangan asli · nilai hash yang dipublikasikan di bawah ini · hasil perhitungan dapat direproduksi secara offline Sebuah studi kasus mengenai mengapa prinsip zero trust sangat diperlukan. Satu permohonan akses terhadap data pribadi seseorang berdasarkan Pasal 15 GDPR, yang dijawab oleh mitra-mitra sebuah firma hukum internasional terkemuka dengan tanda tangan yang terverifikasi. Setiap jaminan dalam jawaban tersebut harus diterima begitu saja: tanda tangan, gelar jabatan, “peninjauan manual selama sebulan”, perlindungan pihak ketiga, serta pernyataan bahwa “setiap pengadilan akan setuju”. Setelah dicek dengan berkas yang diserahkan, tidak ada satupun yang terbukti benar. Halaman ini menunjukkan apa yang dihasilkan oleh kepercayaan, dan bagaimana model yang dapat diverifikasi tidak akan memberikan ruang untuk penipuan atau keraguan. 15 Agustus 2025 · surat[Dr. Tobias Schelinski](https://www.taylorwessing.com/en/people/germany/hamburg/dr-tobias-schelinski)Mitra, Taylor Wessing · pengacara spesialis hukum teknologi informasi 1 Oktober 2025 · surat dan Lampiran 1[Dr. Patrick Zurheide, LL.M.](https://www.taylorwessing.com/de/people/germany/hamburg/patrick-vincent-zurheide)Salary Partner, Taylor Wessing, sejak 2025 · Teknologi Informasi, perlindungan data, dan sengketa hukum di bidang teknologi Informasi mengenai jabatan profesional diambil dari profil yang tertaut milik firma tersebut. Halaman ini tidak menyebutkan apakah pemblokiran akun Steam tersebut beralasan. Halaman ini hanya menampilkan isi berkas yang diserahkan serta isi surat-surat yang telah ditandatangani mengenai hal tersebut. Setiap angka dapat diverifikasi berdasarkan berkas-berkas tersebut. **830 halaman**dalam lampiran surat kedua **36 detik**mulai dari pembuatan hingga perubahan terakhir pada lampiran tersebut **905.672 karakter** yang dapat dibaca di bawah persegi panjang hitam tersebut **2 tanda tangan**sebagaimana dinyatakan dalam kedua surat tersebut, masing-masing satu **Singkatnya,** tanda tangan menunjukkan siapa yang mengirimkan sebuah berkas. Tanda tangan tersebut tidak dapat memastikan apakah berkas tersebut lengkap, benar, atau asli. Hanya pemeriksaan terhadap byte-byte-nya yang dapat memastikan hal itu, dan siapa pun dapat melakukan pemeriksaan tersebut. ## Zero trust: periksa berkasnya, bukan pengirimnya Zero trust berarti tidak ada pihak yang harus dipercaya: baik perusahaan, jabatan, tanda tangan, maupun kami sendiri. Jawaban atas permintaan akses harus membuktikan keabsahannya sendiri. Jawaban tersebut harus menjawab tiga pertanyaan, dan tanda tangan tidak menjawab satupun dari pertanyaan-pertanyaan tersebut. **Apakah salinannya sudah lengkap?**Apakah pemohon sudah memiliki semua yang menjadi haknya, dan apakah setiap hal yang terlewatkan telah diperhitungkan dan dijelaskan? **Apakah teksnya masih sama?**Apakah setiap catatan tersebut sesuai dengan data yang semula disimpan, dan apakah perubahan yang dilakukan kemudian akan terlihat? **Siapa yang menentukan apa yang disembunyikan?**Apakah penahanan tersebut diputuskan oleh pihak yang berwenang untuk mengambil keputusan, dan apakah ada pihak yang dapat memeriksanya setelahnya? Sebagian besar sengketa hukum di Uni Eropa tetap tertutup: penyelesaian berdasarkan perjanjian kerahasiaan (NDA), berkas yang disegel, serta putusan yang tak pernah dipublikasikan. Kami tidak keberatan dengan hal itu. Kasus ini berbeda, dan mungkin bukan karena peristiwa yang terjadi di dalamnya langka. Kasus ini tidak melibatkan perjanjian kerahasiaan maupun putusan pengadilan, sehingga dapat dibaca dari awal hingga akhir: undang-undang yang sangat sederhana, yaitu GDPR; satu permohonan untuk mengakses data pribadi seseorang; apa yang sebenarnya diserahkan; serta kotak hitam yang dapat dihapus oleh siapa pun. Yang membuatnya unik adalah siapa yang menjawab, dan bagaimana caranya. Dr. Tobias Schelinski dan Dr. Patrick Zurheide adalah mitra di Taylor Wessing, yang menurut deskripsi mereka sendiri merupakan [“perusahaan jasa hukum terkemuka di Eropa”](https://www.businesswire.com/news/home/20251217415857/en/Taylor-Wessing-Diversifies-Its-International-Strategy). Keduanya memiliki gelar doktor; salah satunya adalah pengacara spesialis bersertifikat di bidang hukum TI, sedangkan yang lain memiliki gelar Master of Laws dari Aberdeen. Mereka membutuhkan waktu 106 hari untuk tidak memproses permintaan akses yang sah. Dalam prosesnya, mereka menyerahkan teks pengaduan dan data login lebih dari 1.800 orang lain—beberapa di antaranya mungkin masih di bawah umur—kepada pemilik akun yang dilaporkan, dengan bagian-bagian tertentu disamarkan menggunakan kotak hitam yang dapat dihapus oleh siapa saja. **Pandangan PhishDestroy.** Data login, yaitu nama pengguna, merupakan data yang sangat pribadi. Data ini digunakan kembali di berbagai layanan, dan akun yang telah ada selama bertahun-tahun, dalam kebanyakan kasus, terkait dengan orang sungguhan yang dapat diidentifikasi melalui akun tersebut. Jika hanya melihat lima puluh fragmen yang terlihat, kami berpendapat bahwa pengadilan mana pun memang dapat disesatkan. Dengan gambaran lengkapnya, urutan waktu dan perhitungan pada halaman ini memperjelas bahwa permintaan berdasarkan GDPR tersebut tidak diproses. Tidak adanya tanda tangan maupun kesalahan ejaan nama tidak mengubah fakta tersebut. ## Apa yang dihasilkan oleh sistem kepercayaan, dan apa yang seharusnya dilakukan oleh model tersebut Setiap pernyataan dalam jawaban di bawah ini disesuaikan dengan berkas yang diserahkan, serta dengan model yang dapat diverifikasi yang diusulkan pada halaman ini. Bukti untuk setiap baris tercantum lebih lanjut di bawah ini. **Tanda tangan** „Dieses Schreiben ist qualifiziert elektronisch signiert“ Di sana tertulis siapa yang mengirim surat-surat itu. Di bawahnya, 905.672 karakter tetap dapat dibaca di balik persegi panjang hitam. [Bukti](https://phishdestroy.io/tgwitness/id/docs/signed-export/#signature) Perusahaan tersebut menandatangani hash yang di-salt dari setiap bidang yang disembunyikan. Yang diperiksa adalah isinya, bukan pengirimnya. **Pemilihan** Penasihat yang menentukan apa yang boleh dibaca oleh pemohon. Tersisa 50 keluhan yang masih dapat dibaca, semuanya diajukan setelah pemblokiran dan permohonan tersebut; 43 di antaranya adalah “Suspected Hijacker”. 1.944 telah ditutupi. [Bukti](https://phishdestroy.io/tgwitness/id/docs/signed-export/#convenient) Sebuah aturan ditetapkan dan ditandatangani saat salinan dibuat, setiap catatan yang ditahan dihitung, dan pilihan tersebut ditinjau oleh pihak berwenang. **“Satu bulan peninjauan manual”** „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ Sebuah berkas setebal 830 halaman yang dibuat dalam waktu 36 detik. Baris pertama yang dapat dibaca di dalamnya berisi kata-kata hinaan homofobik, dan keluhan-keluhan yang masih dapat dibaca bertentangan dengan isi berkas itu sendiri. [Bukti](https://phishdestroy.io/tgwitness/id/docs/signed-export/#refuted) Pendapat siapa pun soal usaha itu tidak berarti apa-apa. Berkas itu sendiri yang membuktikannya, dan siapa pun bisa menemukan kontradiksi di dalamnya. **Hak pihak ketiga** „soweit keine Rechte Dritter entgegenstehen“ Data login dan teks keluhan dari lebih dari 1.800 orang lainnya, ditampilkan dalam kotak persegi panjang hitam yang dapat dihapus oleh siapa saja. [Bukti](https://phishdestroy.io/tgwitness/id/docs/signed-export/#under) Data orang lain tidak pernah masuk ke salinan pemohon. Data tersebut dikirim dalam bentuk terenkripsi yang hanya dapat dibuka dengan kunci pihak berwenang. **Salinan data tersebut** „Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ Pembayaran, tiket dukungan, dan catatan yang terkait dengan blok tersebut tidak ada. Hanya keluhan-keluhan yang tampak lengkap. [Bukti](https://phishdestroy.io/tgwitness/id/docs/signed-export/#inventory) Daftar muatan yang telah ditandatangani mencantumkan barang-barang yang termasuk serta menyebutkan barang-barang yang tidak termasuk. Tidak ada barang yang terlewat. **“Setiap pengadilan”** „Aus unserer Erfahrung wird jedes Gericht …“ Lima puluh potongan informasi bisa menyesatkan. Berkas selengkapnya menunjukkan adanya permintaan yang tidak diproses. [Bukti](https://phishdestroy.io/tgwitness/id/docs/signed-export/#authority) Pengadilan atau otoritas pengawas membuka dokumen asli selengkapnya dan memeriksa setiap kolom untuk memastikan kesesuaiannya dengan apa yang telah ditandatangani oleh perusahaan. **Setiap baris memiliki bentuk yang sama.** Sebuah jaminan yang harus dipercaya, sebuah berkas yang bertentangan dengannya, dan sebuah pemeriksaan yang seharusnya membuat jaminan tersebut tidak diperlukan. Dengan model ini, tidak ada yang bisa menipu dan tidak ada yang perlu diragukan: pemohon melihat apa yang menjadi haknya, pihak berwenang melihat sisanya, dan setiap kolom terikat pada apa yang telah ditandatangani oleh perusahaan. [Lihat modelnya](https://phishdestroy.io/tgwitness/id/docs/signed-export/#sealed) ## Bukti-bukti, poin demi poin Setiap poin dalam perbandingan di atas didasarkan pada berkas-berkas berikut: dua surat bertanda tangan dan Anlage 1. Referensi halaman mengacu pada urutan halaman dalam file PDF, dan setiap gambar dapat direproduksi secara offline. ### Teks tersebut tetap berada di bawah persegi panjang hitam. Beginilah tampilan jawaban atas permintaan akses sederhana ketika berasal dari pihak yang paling berwenang di bidangnya. Persegi panjang hitam tersebut menyisakan teks aslinya dalam berkas. Hal itu memungkinkan untuk membaca dan membandingkan kedua kelompok: 50 deskripsi yang tetap terlihat dan 1.944 deskripsi yang disamarkan. SURAT ITUBERKAS YANG TELAH DIKIRIM “Terlepas dari rincian pengaduan tersebut” Angka tersebut saja konon menunjukkan adanya pelanggaran berulang terhadap perjanjian Steam. Dr. Schelinski · 15 Agustus 2025 · hlm. 2 „Unabhängig von den Einzelheiten der Beschwerden …“ **50** deskripsi akan tetap ditampilkan pada **Agustus–September 2025** **1.944 deskripsi** yang tercakup selama periode **Februari 2021–Juli 2025** 43 dari 50 deskripsi yang terlihat telah diberi label “Suspected Hijacker”. Dari 1.944 deskripsi yang tercakup, 269 di antaranya memiliki label tersebut. Lampiran 1, hlm. 444–620. Ada satu catatan lagi yang kolom deskripsinya kosong: 50 + 1.944 + 1 = 1.995 baris dalam tabel yang disertakan. ### Lima puluh pengaduan yang mudah ditangani oleh penasihat hukum Surat bulan Oktober tersebut menyebutkan alasan pemblokiran akun tersebut: akun tersebut diblokir karena „Used for Hijacking“ (Dr. Zurheide, hlm. 8). Dari lima puluh pengaduan yang diizinkan untuk dibaca oleh pemohon, 43 di antaranya berisi pernyataan yang sama: “Suspected Hijacker”. Kelima puluh permintaan tersebut diajukan beberapa bulan setelah akun tersebut diblokir secara permanen, setelah permintaan akses, dan setelah sesi masuk terakhir yang tercatat dalam berkas yang sama. Lampiran 1, halaman 1, mencantumkan `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)`. Akun tersebut diblokir pada 7 Mei 2025. Pada 9 Mei 2025, Tim Dukungan Steam menanggapi tiket pertama: pemblokiran tersebut bukanlah kesalahan, bersifat permanen, dan tiket tersebut ditutup. Permohonan akses diajukan pada 17 Juni. Berdasarkan keterangan dalam surat-surat tersebut, pihak ketiga telah menguasai akun tersebut pada saat itu: Dr. Schelinski menulis bahwa akun tersebut diperoleh dari pihak ketiga setelah 3 Mei 2025 (hlm. 2), dan Dr. Zurheide menyebutkan bahwa pihak ketiga melakukan pembayaran melalui akun tersebut setelah 3 Mei, dengan pembayaran terakhir pada 30 Juli 2025 (hlm. 1–2). Tabel pengaduan yang disertakan kemudian mencatat: **53**Agustus 2024 **54**Sep **70**Okt **79**Nov **82**Des **92**Januari 2025 **32**Feb **35**Maret **20**Apr **12**Mei*diblokir pada 7 Mei ; terakhir masuk pada 23 Mei* **1**Jun **7**Jul **47**Agustus **3**Sep Teks pengaduan di bawah persegi panjang hitamTeks pengaduan tetap dapat dibaca Jumlah keluhan per bulan dalam Lampiran 1, Agustus 2024 hingga September 2025, dihitung berdasarkan lapisan teks berkas; riwayat lengkapnya terdapat di bagian [Verifikasi Sendiri](https://phishdestroy.io/tgwitness/id/docs/signed-export/#verify). Setelah pemblokiran pada 7 Mei dan sesi masuk terakhir pada 23 Mei: satu keluhan pada Juni, tujuh pada Juli, lalu 47 pada Agustus. 1. 3 Mei 2025**Mulai tanggal ini, sesuai dengan surat-surat tersebut: pihak ketiga**Keterangan tersebut “diperoleh dari pihak ketiga”: Dr. Schelinski, hlm. 2 · “pembayaran oleh pihak ketiga”: Dr. Zurheide, hlm. 1 2. 7 Mei 2025**Akun diblokir**Uap 3. 9 Mei 2025**Bukan kesalahan, bersifat permanen; tiket ditutup**Dukungan Steam, tiket pertama 4. 23 Mei 2025**Masuk terakhir**Lampiran 1, hlm. 1 5. 17 Juni 2025**Permohonan akses**Dr. Zurheide, hlm. 1 6. 29 Juli 2025**Jangka waktu tersebut dimulai, “jika memang ada”**Dr. Schelinski, hlm. 1 7. 30 Juli 2025**“Pembayaran oleh pihak ketiga” terakhir; data yang dikaitkan dengan pemohon hanya mulai dari sini**Dr. Zurheide, hlm. 2 8. Agustus 2025**47 keluhan, semuanya dapat dibaca**Lampiran 1, hlm. 444–448 9. 15 Agustus 2025**Pemberhentian: 1.938 pengaduan, “terlepas dari rinciannya”**Dr. Schelinski, hlm. 2 10. September 2025**3 keluhan, mudah dipahami**Lampiran 1, hlm. 444 11. 29 September 2025**“Tanggal Laporan”**Lampiran 1, hlm. 1 12. 1 Oktober 2025**Jawabannya: “selama sebulan penuh”, data dibersihkan “secara manual”**Dr. Zurheide, hlm. 1 Dr. Zurheide menulis bahwa periode satu bulan penuh harus digunakan dan data tersebut harus dibersihkan secara manual: „musste leider die volle Monatsfrist ausgeschöpft werden … manuell die Daten bereinigt werden mussten“ (hlm. 1). Tiga dari pengaduan yang dapat dibaca bertanggal September 2025, dan laporan itu sendiri bertanggal 29 September. Pengaduan-pengaduan tersebut diajukan pada minggu-minggu terakhir menjelang diajukannya jawaban, sementara—menurut keterangannya—data sedang diolah. > “This account just started acting shady overnight” > > Suspected Hijacker · Agustus 2025 · hlm. 446 > “Suddenly messaging people weird links probably stolen” > > Suspected Hijacker · Agustus 2025 · hlm. 448 > “Friend warned me to report this one” > > Suspected Hijacker · Agustus 2025 · hlm. 446 > “Everyone in voice chat agrees it's a stolen account” > > Suspected Hijacker · Agustus 2025 · hlm. 446 #### Berkas yang sama justru bertentangan dengan pernyataan mereka Beberapa dari lima puluh orang tersebut mengajukan klaim yang dapat diverifikasi oleh Anlage 1 sendiri. Berkas tersebut mencatat riwayat login akun dan riwayat keamanannya. Keduanya tercantum di dalamnya; riwayat keamanannya berada di bawah persegi panjang hitam. Dapat dibaca dari kiri · Suspected Hijacker · Agustus 2025 · hlm. 446 > “My friend can't log in, says someone changed the password” Sejarah Keamanan · hlm. 830 · di bawah persegi panjang hitam**Perubahan kata sandi terakhir: Juli 2024** Bukan dibuat oleh pemiliknya, seperti yang terlihat pada berkas yang sama. Tidak ada perubahan kata sandi pada tahun 2025. Tersedia untuk dibaca · Agustus 2025 · hlm. 446, 448 > “This account just started acting shady overnight” > “Suddenly messaging people weird links probably stolen” Riwayat Masuk · hlm. 1–119**Masuk terakhir: 23 Mei 2025** Riwayat masuk berakhir pada Mei 2025. Tidak ada satu pun catatan masuk yang tercatat pada bulan Juni, Juli, Agustus, atau September. Akun tersebut telah diblokir sejak 7 Mei 2025; pada 9 Mei, Tim Dukungan Steam menyatakan bahwa pemblokiran tersebut bersifat permanen. Tersedia untuk dibaca · Agustus 2025 · hlm. 445, 448 > “Real person probably got locked out” > “My friend said they can't get into this account anymore” Sejarah Keamanan · hlm. 830**Tidak ada perubahan kebijakan keamanan pada tahun 2025** Perubahan terakhir yang tercatat dalam riwayat keamanan adalah pengaturan ulang kata sandi pada Juli 2024. **Hasil pembacaan PhishDestroy.** Ungkapan kasar di halaman 444 perlu diterjemahkan. Keluhan-keluhan ini ditulis dalam bahasa Inggris, dan jawabannya terdapat dalam berkas yang sama. Setelah satu bulan proses peninjauan manual, teks tersebut menjadi mudah dibaca, dan kalimat yang bertentangan dengan keluhan-keluhan tersebut ditandai dengan kotak persegi panjang. #### Bagaimana kelima puluh orang itu membaca Format tidak membuktikan siapa yang menulis pengaduan tersebut. Justru hal itulah yang akan diperhatikan pengadilan sebelum mempertimbangkannya. | Periksa | Tersisa yang dapat dibaca · 50 | Terselubung · 1.944 | | --- | --- | --- | | Periode | Agustus–September 2025 | Feb 2021–Jul 2025 | | “Suspected Hijacker” kategori | **86%**43 dari 50 | **13**,8% dari 1.944 | | Deskripsi berisi huruf Sirilik | **4%**2 dari 50 | **55.4%**1.077 dari 1.944 | | Login reporter: huruf Latin + 3–5 digit | **62%**31 dari 50 | **21,**6% dari 420 dari 1.944 | Huruf Sirilik: setidaknya satu karakter dari aksara tersebut. Pola login: huruf Latin yang diikuti oleh 3–5 digit, tidak ada yang lain. Seluruh 1.995 akun login reporter, termasuk yang terdapat di samping 50 teks yang terlihat, telah tercakup dan tetap dapat diekstraksi. Tidak ada akun login reporter yang dicantumkan di sini. Empat teks yang dapat dibaca terulang persis sama di sembilan catatan; “Acting way off pretty sure someone else is using it” muncul tiga kali (hlm. 446, 447). Dr. Schelinski · 15 Agustus 2025 · hlm. 2 > „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ “Terlepas dari rincian pengaduan tersebut, jumlahnya saja sudah menunjukkan …” **Apakah isi tersebut benar-benar tidak relevan bagi pengadilan?** Dr. Zurheide · 1 Oktober 2025 · hlm. 9 > „Aus unserer Erfahrung wird jedes Gericht die Sperrung … als rechtmäßig qualifizieren.“ “Berdasarkan pengalaman kami, setiap pengadilan akan menilai pemblokiran tersebut … sebagai tindakan yang sah.” **Apakah pengalamannya mencakup semua pengadilan? Dan apakah semua pengadilan akan sependapat, jika data diolah seperti ini?** Kedua pertanyaan tersebut diajukan oleh PhishDestroy. Kami tidak menyatakan bagaimana pengadilan seharusnya memutuskan soal pemblokiran tersebut. Kami hanya menyatakan bahwa pengadilan seharusnya dapat membaca apa yang diminta untuk dihitung. ### Apa yang disembunyikan oleh persegi panjang hitam tersebut Kedua surat tersebut membahas keluhan yang sama dengan dua cara berbeda. Dr. Schelinski menganggap semua keluhan tersebut sebagai kesalahan pemohon, „1.938 Mal“, terlepas dari rinciannya (15 Agustus 2025, hlm. 2). Dr. Zurheide kemudian menetapkan batas waktu pada 30 Juli 2025: hanya mulai tanggal tersebut „können wir … davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen“ (1 Oktober 2025, hlm. 2). Persegi panjang hitam tersebut mengikuti garis tersebut: setiap teks keluhan hingga 23 Juli 2025—yang terakhir sebelum tanggal tersebut—tertutupi; sedangkan setiap teks keluhan mulai Agustus ke depan dapat dibaca. **Ulasan dari PhishDestroy.** Sebelum 30 Juli 2025, jumlah pengaduan tersebut diperhitungkan sebagai angka terhadap pemohon, dan tidak diungkapkan kepadanya karena dianggap sebagai data yang bukan miliknya. Surat bulan Oktober itu sendiri berargumen berdasarkan „zwischen 2019 und 2023“ (hlm. 7). Lampiran 1 · halaman 444 · baris pertama yang dapat dibaca Offensive AvatarSeptember 2025`p***r` Sebuah kata hinaan homofobik, yang disamarkan di sini. Ini adalah entri pertama yang dapat dibaca oleh pemohon, setelah satu bulan proses peninjauan manual. #### Apa yang ada di bawah persegi panjang-persegi panjang itu 1.148 pengaduan, lebih dari setengah jumlah yang tercantum dalam tabel, diajukan sebagai “Offensive Profile”. Tak satu pun yang masih bisa dibaca: teks pada 1.147 di antaranya tertutupi, dan satu lagi tidak memiliki teks sama sekali. Jika dibaca dari balik persegi panjang-persegi panjang tersebut—tanpa perlu login—deskripsi yang tertutupi itu terus-menerus mengulang tema yang sama: | Tema | Tertutup | Mudah dibaca | | --- | --- | --- | | Nazi, Nazisme | **110** | 0 | | Kebencian, ujaran kebencian | **108** | 0 | | Rasisme | **99** | 0 | | Ukraina, rakyat Ukraina | **90** | 0 | | Russofobia | **84** | 0 | | Menghina bangsa atau orang Rusia | **65** | 0 | | Propaganda | **64** | 0 | | Sebuah julukan yang menghina bagi orang Ukraina | **50** | 0 | | Politik | **46** | 0 | 615 dari 1.944 deskripsi yang dianalisis menyinggung setidaknya satu dari tema-tema ini; tidak ada satupun dari lima puluh deskripsi yang dapat dibaca yang melakukannya. Teks-teks panjang juga terulang: 18 teks yang terdiri dari delapan kata atau lebih muncul persis sama di 48 baris. Dua di antaranya, masing-masing empat kali: > “I made this account to report this user because he has stolen my account” > > Tertutup · 4 baris > “I created this account in order to expose this user because he robbed my account.” > > Tertutup · 4 baris Salah satu dari lima puluh teks yang dapat dibaca (hlm. 448) adalah halaman profil Steam yang ditempelkan dan mencantumkan nama-nama pengguna lain. Teks tersebut tidak dicantumkan di sini. Kotak-kotak tersebut menutupi nama pengguna setiap reporter dan membuat halaman tersebut tetap dapat dibaca. ### Pernyataan-pernyataan dan dokumen-dokumen yang disertakan Setiap pernyataan di bawah ini dikutip dari surat-surat yang telah ditandatangani. Setiap catatan terdapat dalam berkas-berkas yang mereka serahkan. Dr. Schelinski · hlm. 2 ### “Ratusan” setiap tahun „In jedem Jahr, bis ins Jahr 2025 hinein, gab es demnach hunderte Beschwerden.“ **2021: 25 · 2022: 122** Jumlah tahunan tercantum dalam tabel pengaduan yang disertakan. Jumlah bulanan selengkapnya dapat dilihat di bagian [Verifikasi sendiri](https://phishdestroy.io/tgwitness/id/docs/signed-export/#verify). Dr. Zurheide · hlm. 1 ### Selama sebulan penuh, dibersihkan dengan tangan „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ **36 detik** Anlage 1 dibuat pada pukul 19:58:05 dan terakhir diubah pada pukul 19:58:41, mencakup 830 halaman. Keluhan pertama yang dapat dibaca di dalamnya adalah kata-kata kasar yang bersifat homofobik. Dr. Schelinski · hlm. 3 ### Perlindungan hak pihak ketiga „soweit keine Rechte Dritter entgegenstehen“ **Tersisa 905.672 karakter** Teks di bawah 1.044 persegi panjang hitam yang saling tumpang tindih tersebut masih dapat dibaca. Persegi panjang-persegi panjang tersebut juga menutupi riwayat keamanan akun itu sendiri (hlm. 830). Dr. Zurheide · hlm. 7 ### “Antara tahun 2019 dan 2023” „Über einen Zeitraum von mehreren Jahren, zwischen 2019 und 2023 …“ **Dibuat pada Agustus 2020** Lampiran 1, halaman 1, mencantumkan tanggal pembuatan akun tersebut: Agustus 2020. Dr. Zurheide · hlm. 9 ### Setiap pengadilan pasti akan sependapat „jedes Gericht … als rechtmäßig qualifizieren“ **Prakiraan cuaca** Kalimat tersebut menyatakan bahwa setiap pengadilan akan memutuskan bahwa pemblokiran akun Steam adalah sah. Kalimat tersebut tidak menyebutkan nama pengadilan mana pun dan tidak mengutip putusan apa pun. ### Apa yang dapat dan tidak dapat diungkapkan oleh tanda tangan Tanda tangan elektronik yang memenuhi syarat merupakan bukti kuat mengenai pengirim. Tanda tangan tersebut bukanlah bukti mengenai isi pesan. Kedua hal tersebut harus diperiksa secara terpisah. ### Sebuah tanda tangan dapat menunjukkan - siapa yang menandatangani dokumen tersebut - bahwa byte yang telah ditandatangani tidak berubah sejak proses penandatanganan ### Tanda tangan tidak dapat ditampilkan - bahwa proses ekspor telah selesai - bahwa proses penyuntingan telah menghapus sesuatu - bahwa pernyataan-pernyataan di dalamnya benar - agar ada yang membacanya sebelum menandatanganinya TIGA PENGECEKAN · NOMOR DOKUMEN 42603633 · LAMPIRAN 1Offline 01 · PENGIRIM**Tanda tangan elektronik yang sah**`„qualifiziert elektronisch signiert“`Dinyatakan oleh perusahaan pada halaman 9. 02 · INTEGRITAS**SHA-256 dari Lampiran 1**`2bb927e2…4ff7d6af`Cocok dengan hash yang terekam. 03 · ISI**Lapisan teks dari Lampiran 1**`pdftotext Anlage1.pdf -`905.672 karakter yang dapat dibaca di bawah 1.044 persegi panjang. Pengirim: telah dinyatakan. Integritas: sesuai. Isi: rusak. Tanda tangan tersebut menjawab pertanyaan pertama, tetapi tidak menjawab pertanyaan-pertanyaan lainnya. Pemeriksaan 02 dan 03 hanya memerlukan berkas tersebut dan alat-alat standar. Pemeriksaan 01 menunjukkan siapa yang mengirimkannya. Hanya pemeriksaan 02 dan 03 yang menunjukkan apa yang dikirimkan. Nomor Dokumen 42603633 · halaman 1Satu halaman, dua ejaan `Dr. Patrick Zurheide, LL.M. (Aberdeen)`Penandatangan `p.zurheode@*****wessing.com`Kop surat `p.zurheide@*****wessing.com`Catatan publik Judulnya dieja dengan benar. Namun, nama penandatangan yang tertera di kop surat tidak dieja dengan benar. Halaman 6 berisi „Die Antwortet lautet ja, in den dort genannten Grenzen.“ dua kali, kata demi kata, di akhir bagian 1.5 dan 1.6. Halaman 3 mengirimkan data tersebut dengan „Anbei übersenden wie Ihnen …“. ### Permintaan yang dimaksudkan untuk dipenuhi melalui ekspor tersebut Di balik tanda tangan-tanda tangan tersebut terdapat satu permohonan untuk mendapatkan data pribadi. Undang-undang yang mengatur hal tersebut cukup singkat. PERATURAN (UE) 2016/679 · TEKS RESMI Pasal 15 ayat (1) “Subjek data berhak memperoleh konfirmasi dari pengendali data mengenai apakah data pribadi yang berkaitan dengannya sedang diproses atau tidak, dan, jika memang demikian, berhak mengakses data pribadi tersebut …” Pasal 15 ayat (3) “Pengendali data wajib memberikan salinan data pribadi yang sedang diproses.” Pasal 12 ayat (3) “… tanpa penundaan yang tidak wajar dan dalam hal apa pun paling lambat satu bulan sejak diterimanya permohonan tersebut. Jangka waktu tersebut dapat diperpanjang hingga dua bulan lagi jika diperlukan …” Sumber: [EUR-Lex](https://eur-lex.europa.eu/eli/reg/2016/679/oj) Para penulis surat itu mengetahui hukum ini. Surat Dr. Zurheide diawali dengan hal tersebut: „nachfolgend erteilen wir Namens und in Vollmacht unserer Mandantin Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ (hlm. 1). Selain satu referensi mengenai hak pihak ketiga (Dr. Schelinski, hlm. 3), tidak ada satu pun surat yang mengutip ketentuan yang memungkinkan pengendali data untuk membatasi akses: baik Pasal 12 ayat (5), Pasal 23, maupun Undang-Undang Perlindungan Data Jerman (BDSG). Yang justru diterima dalam permohonan tersebut adalah: 1. 15 Agustus 2025 · Dr. Schelinski · hlm. 1**Batas waktu, “jika memang ada”** „Die Frist nach Art. 15 DSGVO hat, wenn überhaupt, erst … am 29. Juli 2025 begonnen“ 2. 15 Agustus 2025 · Dr. Schelinski · hlm. 2**Akun tersebut telah dinonaktifkan** „Hiermit kündigen wir daher Namens und in Vollmacht der Valve Corporation … mit sofortiger Wirkung.“ 3. 15 Agustus 2025 · Dr. Schelinski · hlm. 2**Pembuktian berdasarkan jumlah: 1.938 pengaduan, terlepas dari rinciannya** „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ 4. 1 Oktober 2025 · Dr. Zurheide · hlm. 2**Data dibatasi hingga 30 Juli 2025** „… können wir erst ab diesem Zeitpunkt davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen.“ 5. 1 Oktober 2025 · Dr. Zurheide · hlm. 8**Selebihnya, dengan syarat** „Gerne beauskunften wir die restlichen (bzw. noch weitere) personenbezogene Daten, sobald Ihr Mandant uns nachvollziehbar darstellen kann …“ 6. 1 Oktober 2025 · Dr. Zurheide · hlm. 8**“Kaki tangan”** „… dass Ihr Mandant bzw. dessen Komplizen seine Phishing-Angriffe … in verschleierter Form fortsetzen will“ 7. 1 Oktober 2025 · Dr. Zurheide · hlm. 9**Empat undang-undang pidana** „… §§ 263, 263a, 202a, 303a StGB) einer strafrechtlichen Verfolgung zuzuführen.“ **Tak satu pun dari hal ini tercantum dalam Pasal 15.** Hak akses tidak dicabut oleh pemutusan hubungan, perkiraan mengenai putusan pengadilan, atau undang-undang pidana. 106 hari setelah permohonan diajukan, hak tersebut tetap berlaku persis seperti yang tertulis. **Tafsiran PhishDestroy.** Para dokter mengutip undang-undang tersebut di halaman 1, namun kemudian menulis seolah-olah undang-undang tersebut tidak ada. ### Surat tersebut mencantumkan hal-hal yang diproses oleh Valve. Dokumen tersebut tidak mencantumkan sebagian besar hal tersebut. Pada halaman 2–6, surat bulan Oktober tersebut mengutip Kebijakan Privasi Steam untuk menjelaskan data pribadi yang diproses oleh Valve. Setiap kategori yang disebutkan dalam surat tersebut dibandingkan di bawah ini dengan Lampiran 1. Lampiran 1 terdiri dari dua belas bagian: akun, profil, riwayat nama, login, kunci produk, waktu bermain, nomor telepon, keluhan, obrolan, perangkat Steam Guard, teman, dan perubahan keamanan. | Data | Disebutkan dalam surat tersebut | Dalam Lampiran 1 | | --- | --- | --- | | Transaksi dan pembayaran | „Transaktions- und Zahlungsdaten“ · p. 2 „… Transaktionsdaten … für einen Zeitraum von bis zu zehn (10) Jahren aufbewahren muss“ · p. 6 | **Tidak hadir** | | Perdagangan dan Pasar Komunitas | „… Konsistenz des Gameplays oder Steam-Community-Marktes …“ · p. 6 | **Tidak hadir** | | Prestasi, kemajuan permainan, item dalam permainan | „Ihre erspielten Errungenschaften … Ihren Spielfortschritt … Ihre im Spiel erhaltenen Gegenstände“ · p. 4 | **Tidak hadir** | | Kepemilikan game | „… mindestens Ihr Eigentum am fraglichen Spiel“ · p. 4 | **Tidak hadir** · waktu bermain dan 100 kali penekanan tombol hanya dalam satu hari | | Level, lencana, kartu koleksi | „Daten über die Nutzung des Steam-Clients und der Steam-Websites“ · p. 3 · items and market · pp. 4, 6 | **Tidak hadir** | | Postingan, komentar, pengikut | „… veröffentlichen, kommentieren oder denen Benutzer folgen“ · p. 3 „Message Boards, Foren und/oder Chatbereiche“ · p. 5 | **Tidak hadir** | | Obrolan | „Informationen, die Benutzer im Chat gesendet haben“ · p. 3 | 2 entri, telah dibahas | | Tiket dukungan | „… wenn Benutzer Informationen oder Support von Valve anfordern“ · p. 3 | **Tidak hadir** · termasuk tiket bulan Mei 2025 yang mengonfirmasi pemblokiran tersebut | | Akun pihak ketiga yang terhubung | „… mit dem Konto eines Drittanbieters zu verknüpfen“ · p. 5 | **Tidak hadir** | | Catatan di balik blok tersebut | „Zum Entdecken von Verstößen erforderliche Informationen“ · p. 3 „… nach einer manuellen Prüfung durch einen Mitarbeiter der Valve Corporation“ · p. 7 | **Tidak ada** · tidak ada catatan tinjauan, tidak ada tautan perangkat, tidak ada laporan phishing | **Surat tersebut menjelaskan data tersebut. Lampiran tersebut tidak memuat data tersebut.** Pembayaran merupakan dasar kesimpulan kedua pengacara mengenai kepemilikan, namun kategori pembayaran justru tidak dicantumkan dalam berkas tersebut. #### Apa saja yang tercantum dalam berkas tersebut, dan untuk periode mana Periode diambil dari tanggal-tanggal yang tercantum dalam berkas tersebut, termasuk tanggal-tanggal yang terdapat di bawah persegi panjang hitam. | Bagian | Dalam Lampiran 1 | Periode dalam berkas | | --- | --- | --- | | Data akun dasar · email, negara, nama pengguna, ID Steam | Mudah dibaca | Kondisi saat ini | | Masuk | Tanggal dan jenis dapat dibaca; waktu, alamat IP, dan ID perangkat tertutupi | Okt 2023 – Mei 2025 · akun ini telah ada sejak Agustus 2020 | | Waktu Bermain | Permainan dapat dibaca; tanggal dan waktu penggunaan terakhir tercantum | Desember 2020 – Mei 2025 | | Obrolan | 2 entri, telah dibahas | Hanya pada September 2025 | | Keluhan terhadap akun tersebut | 1.995 baris · 50 deskripsi yang dapat dibaca | Feb 2021 – Sep 2025 | | Teman dan blok | 5.789 baris · telah dibahas | Feb 2021 – Sep 2025 | | Perangkat Steam Guard · nomor telepon terdaftar · perubahan pengaturan keamanan | Tertutup | Catatan keamanan: Agustus 2020 – Juli 2024 · 4 baris | | Aktivasi kunci produk | Tombol-tombol yang dibahas | 100 baris, satu tanggal: 13 Maret 2025 | **Tampaknya hanya keluhan-keluhan itulah yang tercantum secara lengkap.** Hampir tidak ada data lain yang tercantum: riwayat login dimulai pada Oktober 2023, daftar teman pada Februari 2021, kunci produk hanya untuk satu hari, dan kategori-kategori lengkap dari toko Valve sama sekali tidak ada. Kategori-kategori yang menjadi dasar keputusan dalam surat tersebut—yaitu pembayaran dan catatan di balik pemblokiran—sama sekali tidak terdapat dalam berkas tersebut. Daftar teman berisi 5.789 baris: 4.410 “Pengguna yang Diblokir”, 1.182 “Teman”, dan 200 “Pengundang”, dengan tanggal mulai 24 Februari 2021 hingga 28 September 2025; 74 di antaranya bertanggal setelah sesi masuk terakhir. Tidak dapat dipastikan dari berkas tersebut apakah daftar ini merupakan daftar koneksi terkini atau riwayat lengkap yang mencakup koneksi yang telah dihapus. Jawaban atas Pasal 15 ayat (1) memunculkan tiga pertanyaan tambahan. Penerima (poin c) dan sumber data (poin g) hanya disebutkan sebagai teks kebijakan umum, bukan khusus untuk akun ini. Jangka waktu penyimpanan (poin d) merupakan kutipan dari kebijakan tersebut, tanpa rincian lebih lanjut. Dan surat tersebut mengirimkan data „als Anlage 1 und 2“ (hlm. 3); di sini hanya Lampiran 1 yang dibahas. ### Valve telah memverifikasi siapa pemilik akun tersebut Akun tersebut didaftarkan sebagai mitra Steamworks untuk menerbitkan sebuah game. Proses tersebut mencakup biaya Steam Direct sebesar 100 USD, wawancara perpajakan, rincian rekening bank untuk pencairan dana, serta verifikasi identitas yang dilakukan oleh Valve sendiri. Semua itu merupakan data pribadi yang diproses oleh Valve. Pasal 15 GDPR mencakup setiap kategori data pribadi yang diproses, bukan hanya yang tercantum dalam kebijakan privasi. Tak satu pun dari data tersebut tercantum dalam Lampiran 1. Dr. Schelinski · hlm. 1 ### “Tidak ada satu pun bukti kepemilikan” „… kein einziger Beleg für die Inhaberschaft (Verfügungsbefugnis) Ihres Mandanten für den Account …“ **Identitas telah diverifikasi oleh Valve** Verifikasi mitra, dokumen-dokumennya, dan pembayaran sebesar 100 dolar AS disimpan oleh klien yang dimaksud dalam surat tersebut. Dr. Schelinski · hlm. 3 ### Bukti yang diminta dari pemohon „… gefälschten ‚Utility Bill‘ …“ · „… tatsächlich alleiniger Inhaber des Accounts …“ **Bukti tidak diberikan kepada pemohon** Pemohon diminta untuk membuktikan kepemilikannya, sementara catatan kepemilikan yang telah diverifikasi oleh Valve sendiri tidak dimasukkan ke dalam salinan yang diberikan kepadanya. ## Modelnya: tidak ada yang memutuskan sendirian, tidak ada yang bisa ditukar Ini bukan soal satu perangkat lunak saja. Ini soal siapa yang mengambil keputusan. Dalam kasus ini, dua pengacara yang memutuskan lima puluh pengaduan mana yang dianggap penting dan sisanya tidak. Tidak ada pengadilan, tidak ada badan pengawas. Ada hal-hal yang harus tetap dirahasiakan: data login para jurnalis merupakan data milik orang lain. Pertanyaannya adalah siapa yang memutuskan, dan apakah ada pihak yang dapat memeriksa keputusan tersebut setelahnya. Sebuah persegi panjang hitam tidak menjawab kedua pertanyaan itu, dan siapa pun dapat menghapusnya. Dua alat standar dapat menjawab keduanya: hash dengan salt pada salinan peminta, dan salinan asli yang disegel menggunakan kunci publik dari otoritas pengawas atau pengadilan. KOMITMEN YANG KUAT · SATU PER LAPANGAN YANG DITUTUP c = SHA-256(salt ‖ value) Salt terdiri dari 16 byte acak, yang dihasilkan baru untuk setiap bidang. Salinan yang dimiliki peminta berisi `c` sebagai pengganti nilai tersebut, di bawah tanda tangan perusahaan. Nilai tersebut beserta salt-nya dikirimkan dalam amplop yang dienkripsi menggunakan kunci publik otoritas, baik dengan OpenPGP maupun dengan X25519 dan AES-GCM. Tanpa kunci pribadi otoritas, tidak ada yang dapat membukanya, dan perusahaan tidak dapat mengganti nilai tersebut tanpa melanggar komitmen yang telah ditandatanganinya. 1. Langkah 1 · pemohon**Serahkan salinan dan amplopnya** Salinan yang telah ditandatangani beserta komitmen-komitmennya serta amplop yang telah disegel diserahkan kepada otoritas pengawas atau pengadilan. 2. Langkah 2 · pihak berwenang**Membuka amplop dan menghitung ulang** Inspektur mendekripsi data tersebut menggunakan kunci pribadi otoritas dan menghitung ulang SHA-256(salt ‖ nilai) untuk setiap bidang. Setiap hasil harus sama dengan komitmen yang telah ditandatangani oleh perusahaan. 3. Langkah 3 · sebuah lembaga independen**Menentukan apa yang sebenarnya dilindungi** Pihak berwenang—bukan perusahaan—yang memeriksa seluruh informasi yang ditahan, dalam hal ini 1.944 teks pengaduan dan riwayat keamanan, serta memutuskan apakah hak pihak ketiga mengharuskan informasi tersebut ditahan. LAMPIRAN 1 · HALAMAN 514 · SATU BARIS, DUA CARA UNTUK MENYEMBUNYIKANNYALangsung · di browser Anda Seperti yang dikirimkan · persegi panjang hitamHanya tampilan overlay Aspose.PDF for .NET 20.8 · page 514Lapisan teks + persegi panjang Reporter: [login · tidak dipublikasikan ulang di sini] Tanggal: 2024-03-28 Jenis: Offensive Profile Teks: русофоб Persegi panjang hitam digambar di atasnya. Teks di bawahnya tetap ada di dalam berkas. Salinan pemohon · komitmen yang diikatDitandatangani oleh firma tersebut c = SHA-256(salt ‖ value)Disegel atas nama pihak berwenang Wartawan: [dirahasiakan · komitmen] Tanggal: 2024-03-28 Jenis: Offensive Profile Teks: [withheld · commitment] Envelope · RSA-OAEP-256 + AES-256-GCMuntuk kunci publik otoritas tersebut Salinan tersebut memuat komitmen. Nilai dan garam terdapat di dalam amplop. 1. **1.** Pemohon menyerahkan salinan dan amplop tersebut 2. **2**Pihak berwenang membuka data tersebut dan menghitung ulang setiap komitmen 3. **3.** Pihak berwenang yang menentukan apa saja yang akan ditahan Kedua panel tersebut menyembunyikan dua bidang yang sama. Baca byte mentah, lalu jalankan pemeriksaan otoritas. Kiri: satu baris dari Anlage 1 sebagaimana diterima; teks pengaduan terletak di bawah persegi panjang hitam pada halaman 514 dan dikutip tanpa login pelapor, di mana kolomnya berisi penanda tempat. Kanan: baris yang sama dengan komitmen yang disandikan, nilainya disegel menggunakan kunci otoritas. Pasangan kunci dihasilkan di peramban Anda untuk demonstrasi ini, dan amplopnya adalah yang digunakan TgWitness untuk pengiriman tersegel. Keputusan pada langkah 3 merupakan contoh. **Tidak ada yang memutuskan sendirian**Perusahaan tersebut tetap yang mengusulkan hal-hal apa saja yang harus dirahasiakan. Seseorang yang memiliki gambaran lengkap dan tidak memiliki kepentingan dalam sengketa tersebut yang memeriksanya. **Tidak ada yang bocor**Pemohon tidak dapat melihat data orang lain. Salt membuat komitmen tersebut tidak berguna untuk ditebak: tanpa salt, keluhan yang terdiri dari satu kata dapat ditemukan dengan melakukan hashing terhadap daftar kata. **Tidak ada yang bisa ditukar**Setiap nilai harus sesuai dengan komitmen yang telah ditandatangani oleh perusahaan. Jika teksnya berbeda atau tidak ada, maka pemeriksaan tersebut tidak lulus. **Tanda tangan itu memiliki arti**Tanda tangan yang sah atas komitmen-komitmen tersebut mengikat perusahaan terhadap setiap nilai tersembunyi, bukan hanya terhadap surat pengantar. **Judul tidaklah penting**Pemeriksaannya bersifat aritmatika. Yang dibutuhkan adalah salinan, amplop, dan kunci dari pihak berwenang, bukan sekadar kata-kata siapa pun. Semua ini tidak memerlukan infrastruktur baru. Otoritas pengawas Jerman sudah mempublikasikan kunci OpenPGP: Komisaris Federal untuk Perlindungan Data [mencantumkan satu kunci untuk setiap unit](https://www.bfdi.bund.de/DE/Service/Kontakt/Schluessel/Schluessel-node.html), dan LfDI Baden-Württemberg [menyediakan kunci publiknya untuk surat elektronik terenkripsi](https://www.baden-wuerttemberg.datenschutz.de/kontaktdaten-des-verantwortlichen/). Pengadilan-pengadilan di Jerman sudah menerima berkas-berkas melalui EGVP, yang [enkripsi ujung-ke-ujungnya didasarkan pada protokol OSCI](https://egvp.justiz.de/behoerdenpostfach/Informationsmaterial_fuer_Behoerden_zu_BeBPo_und_eEB_V1_3_2.pdf). **Pendapat PhishDestroy.** Siapa yang memberi hak kepada penasihat hukum untuk menentukan apa yang penting dan apa yang tidak? Pengacara seharusnya tidak mengambil keputusan tersebut. Segala sesuatunya harus diserahkan: bukan dalam bentuk persegi panjang hitam yang bisa dihapus oleh siapa saja, melainkan disegel dan hanya dapat dibuka dengan kunci dari pengadilan atau otoritas pengawas, sehingga tidak ada ruang bagi “kesalahan”, “kesalahpahaman”, atau hanya menampilkan apa yang menguntungkan. ## Model yang jujur: data lengkap, aturan yang dinyatakan secara eksplisit, serta kunci yang memiliki wewenang Pemohon akan menerima semua hal yang tidak menjadi sengketa, sekaligus. Segala sesuatu yang ditahan tidak disembunyikan dengan dalih apa pun dan tidak disimpan secara diam-diam. Dokumen tersebut dikirimkan, dalam bentuk lengkap dan telah ditandatangani, serta dienkripsi menggunakan kunci otoritas yang berwenang untuk mengambil keputusan terkait hal tersebut. | Pertanyaan | Apa yang terjadi | Model yang jujur | | --- | --- | --- | | Siapa yang memutuskan apa yang ditahan | Kuasa hukum pihak yang terlibat dalam sengketa | Sebuah aturan yang ditetapkan dan ditandatangani saat salinan tersebut dibuat; pihak berwenang memeriksanya | | Apa yang diterima oleh pemohon | Baris-baris tertentu; seluruh kategori tidak ada; batas pemotongan tanpa catatan di belakangnya | Setiap catatan yang tidak dipersengketakan, segera | | Data pihak ketiga | Penuh dengan gambar dan masih tersimpan dalam berkas | Dihapus dari salinan pemohon; tetap dipertahankan dalam naskah asli untuk keperluan referensi | | Suku cadang yang ditahan | Jumlahnya tidak diketahui, isinya tidak diketahui | Telah dicantumkan dalam manifes yang ditandatangani; salinan asli lengkap telah dienkripsi menggunakan kunci pihak berwenang | | Bukti mengenai bagaimana salinan tersebut dipilih | Hanya ada karena proses penyuntingan tersebut gagal | Termasuk: aturan, jumlah, hash dari file asli | | Bidang yang diperdebatkan | Ditetapkan dalam surat tersebut: “setiap pengadilan akan sependapat” | Ditetapkan oleh otoritas pengawas atau pengadilan, siapa yang berhak membukanya | | Waktu | 106 hari | Ekspor ditambah pengiriman | | Peran penasihat hukum | Menetapkan ruang lingkup, beban pembuktian, dan putusan | Menangani sengketa di pengadilan; tidak mengedit data pemohon | Otoritas tersebut juga tidak memerlukan kepercayaan. Pasal 58 ayat (1) huruf e GDPR telah memberikan kewenangan kepada otoritas pengawas untuk memperoleh akses ke seluruh data pribadi yang diproses oleh pengendali data. Model tersebut hanya menyerahkannya dalam bentuk yang dapat diverifikasi saat diterima. **Alasan-alasan yang disebutkan dalam surat-surat tersebut—keraguan mengenai kepemilikan, pembayaran oleh pihak ketiga, keluhan, serta dugaan phishing—menjelaskan mengapa Pasal 15 tidak dipenuhi. Alasan-alasan tersebut tidak memenuhi ketentuan tersebut.** Apa pun dasarnya, hasilnya tetap sama: pemohon tidak menerima datanya, data orang lain diserahkan berdasarkan dokumen-dokumen tersebut, dan pemilihan data tersebut hanya dapat diverifikasi secara kebetulan. Akses terhadap data merupakan hak subjek data, bukan alat tawar-menawar dalam sengketa pihak lain. ## Bagaimana TgWitness menyimpan dokumen asli dan memastikan salinan-salinannya dapat diverifikasi TgWitness mengekspor percakapan sebagai bukti. Desainnya berawal dari pelajaran yang dipetik dari kasus ini: sebuah ekspor tidak boleh diminta untuk dipercaya hanya karena siapa yang menyerahkannya. Jurnal asli yang terekam tetap disimpan. Salinan yang dibagikan mencatat catatan dan bidang yang dipilih, aturan pengungkapan, serta jumlah catatan yang dikecualikan dalam manifesnya yang telah ditandatangani. Prinsip “zero trust” berlaku bagi semua pihak, termasuk kami. Melestarikan ### Simpan yang asli Simpan seluruh catatan jurnal yang telah direkam beserta tanda tangannya. Simpan salinan cadangan secara terpisah agar penggantian atau pemotongan yang dilakukan di kemudian hari dapat diverifikasi. Lindungi ### Enkripsi pengiriman Enkripsi arsip menggunakan kunci penerima atau lindungi pengiriman dengan kata sandi. Untuk mendekripsi, diperlukan kunci atau kata sandi yang sesuai. Mengungkapkan ### Sebutkan hal-hal yang terlewatkan Cantumkan tujuan dan aturan dalam manifes yang telah ditandatangani. Tandai catatan yang telah dipersingkat, hitung jumlah catatan yang dikecualikan, dan simpan tautan ke jurnal sumber. TgWitness sudah menyegel dokumen asli secara utuh untuk kunci penerima, dengan amplop yang digunakan dalam demonstrasi di atas, serta menandai bagian mana yang disembunyikan dalam pengungkapan. Pihak verifikator memeriksa tanda tangan catatan dan tautan salinan yang dibagikan ke jurnal sumber; untuk memverifikasi konten yang disembunyikan berdasarkan hash aslinya, diperlukan salinan asli lengkap yang disimpan. Komitmen yang diberi salt per bidang untuk suatu otoritas merupakan langkah yang diusulkan dalam kasus ini. | Dalam Lampiran 1 | Fitur TgWitness | Cek yang telah diproses | | --- | --- | --- | | Teks di bawah persegi panjang hitam | Kolom yang disembunyikan dihapus dari salinan yang dibagikan; salinan aslinya disimpan secara terpisah | Penghilangan yang disebutkan secara eksplisit dan hash catatan asli | | 50 deskripsi terlihat; 1.944 tercakup | Aturan pengungkapan yang telah ditandatangani dan jumlah catatan yang dikecualikan | Ruang lingkup yang dipilih dan referensi jurnal asalnya | | Lampiran PDF | Pengiriman arsip yang telah disadap dalam bentuk terenkripsi | Dekripsi terotentikasi; tanda tangan arsip dan hash | | File yang diidentifikasi berdasarkan SHA-256 di bawah ini | Catat nilai hash, tanda tangan, dan titik pemeriksaan yang disimpan | Perbandingan dengan jurnal yang telah disimpan sebelumnya | ### Apa yang dijamin oleh perangkat lunak ini **Keandalan data**Setiap catatan diubah menjadi hash dan disusun dalam rantai, lalu ditandatangani menggunakan algoritma Ed25519. Pihak verifikator menghitung ulang setiap catatan, sehingga setiap perubahan akan terdeteksi. **Pengiriman yang bisa Anda periksa**Arsip dikirim dalam bentuk terenkripsi kepada penerimanya; arsip berukuran besar dikirim dalam bagian-bagian terenkripsi yang dilengkapi dengan daftar isi yang ditandatangani, kemudian disatukan dan diverifikasi secara lokal. **Data orang lain tetap dirahasiakan**Salinan bersama secara otomatis menyembunyikan data tertentu dan mencantumkan apa saja yang disembunyikan. Pengungkapan nilai yang disamarkan di panel akan diaudit. **Tidak ada ruang untuk kesalahan**Pemeriksaannya bersifat aritmatika: berkas, sidik jari kunci tepercaya, dan titik pemeriksaan yang disimpan. Tidak diperlukan pernyataan dari siapa pun. **Tidak ada ruang untuk manipulasi**Perubahan dan penghapusan akan menjadi catatan baru, jurnal yang dipersingkat tidak akan lolos saat dibandingkan dengan titik pemeriksaan yang disimpan, dan pengungkapan tidak akan pernah terlihat lengkap jika memang belum lengkap. Kesalahan ketik pada sebuah nama tidak mengubah data yang telah ditandatangani oleh perangkat lunak. Terlambat satu bulan dari batas waktu tidak mengubah catatan asli. Setiap perubahan akan memutus rantai, dan pihak verifikator akan mengatakannya. Cobalah kedua opsi di bawah ini. SHA-256 · DI BROWSER ANDAEdit salah satu baris tersebut Sebagaimana ditandatangani · di atas kop surat`86582990a7b364adbd83071c9edb4774ed6e8ea50b80dca1ae426c3fa679a1d6` Catatan publik`17fae25500c51998112b146c76b21b04bf3d4034407f2f958bced7d6d6e928ba` **1** karakter yang berbeda**60** dari 64 digit heksadesimal berbeda**128** dari 256 bit berbeda Hanya selisih satu karakter. Dua sidik jari yang tidak saling terkait. Sebuah hash mendeteksi satu huruf yang terlewatkan dalam proses penandatanganan. Sebuah judul hanyalah tambahan byte: hal itu mengubah sidik jari, bukan fakta-faktanya. JURNAL BERTAANDATANGAN · VERSI SINGKATCatatan ilustratif CATATAN 1**17.06.2025 · access request**`adc396074b0f04…`= hash yang disimpan CATATAN 2**01.10.2025 · letterhead p.zurheode**`0b8eda5c2f43ae…`= hash yang disimpan CATATAN 3**01.10.2025 · Anlage 1 · 830 pages**`dbe2eef85bfb5a…`= hash yang disimpan Setiap catatan menyimpan "sidik jari" dari catatan sebelumnya. Mengubah catatan ke-2 akan mengubah nilai hash-nya dan memutus hubungan dengan catatan ke-3. Disederhanakan: setiap sidik jari mencakup sidik jari sebelumnya dan satu baris teks. TgWitness menghitung hash dari sembilan bidang peristiwa kanonik, salah satunya adalah hash sebelumnya, dan menandatangani setiap ringkasan dengan Ed25519. [Lihat rantai lengkap beserta titik-titik pemeriksaan](https://phishdestroy.io/tgwitness/id/docs/concepts/) [Cara Kerja Pembagian Salinan di TgWitness](https://phishdestroy.io/tgwitness/id/docs/handover/) · [Amplop yang tersegel](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md#cryptographic-handoff) · [Ruang lingkup pelaksanaan dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) ## Coba periksa sendiri Setiap otoritas pengawas, pengadilan, atau auditor yang memiliki berkas-berkas tersebut dapat mengulangi setiap pemeriksaan yang tercantum di halaman ini secara offline. Hanya hasil agregat yang ditampilkan: detail login pelapor, pengenal akun, dan data profil tidak dipublikasikan di sini. **Seluruh bulan: 2021–2025** | Tahun | Jan | Feb | Maret | Apr | Mei | Jun | Jul | Agustus | Sep | Okt | Nov | Des | Total | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 2021 | 0 | 2 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 1 | 20 | **25** | | 2022 | 10 | 7 | 43 | 9 | 2 | 7 | 2 | 11 | 7 | 6 | 5 | 13 | **122** | | 2023 | 111 | 48 | 156 | 59 | 52 | 53 | 66 | 52 | 73 | 44 | 53 | 58 | **825** | | 2024 | 69 | 58 | 111 | 36 | 33 | 46 | 83 | 53 | 54 | 70 | 79 | 82 | **774** | | 2025 | 92 | 32 | 35 | 20 | 12 | 1 | 7 | 47 | 3 | — | — | — | **249** | 0 berarti tidak ada catatan untuk bulan tersebut dalam ekspor ini; — berada di luar batas waktu September 2025. Total: **1.995**. **Semua kategori laporan dalam tabel yang disertakan** | Jenis laporan yang terekam | Semua catatan | Deskripsi yang mudah dipahami | Uraian yang tercakup | | --- | --- | --- | --- | | Offensive Profile | 1,148 | 0 | 1,147 | | Suspected Hijacker | 312 | 43 | 269 | | Menyontek | 290 | 2 | 288 | | Offensive Persona Name | 87 | 1 | 86 | | Offensive Avatar | 57 | 3 | 54 | | Pelecehan | 46 | 1 | 45 | | Spam | 37 | 0 | 37 | | Spoofing | 16 | 0 | 16 | | Moderasi Otomatis | 1 | 0 | 1 | | Penipuan Perdagangan | 1 | 0 | 1 | Yang Offensive Profile Jumlah tersebut sudah termasuk satu deskripsi yang kosong. Total: 1.995 catatan, 50 deskripsi yang dapat dibaca, 1.944 deskripsi yang tercakup, 1 deskripsi yang kosong. **Riwayat masuk dan keamanan** Lampiran 1, halaman 1: `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)` dan `Date of Report: 09-29-2025`. Riwayat masuk pada halaman 1–119 mencantumkan sesi masuk terbaru terlebih dahulu; entri terbarunya berasal dari Mei 2025, dan tidak ada yang lebih baru dari itu. Halaman 830, “Riwayat Keamanan”, ditutupi oleh persegi panjang hitam. Perubahan kata sandi terakhir tercatat pada Juli 2024; tidak ada perubahan yang tercatat pada tahun 2025. Tanggal, alamat, dan pengenal dari baris-baris tersebut tidak dicantumkan. ``` pdftotext -f 1 -l 1 Anlage1.pdf - # last logon, date of report pdftotext -f 830 -l 830 Anlage1.pdf - # security history ``` **Metadata PDF dan pernyataan tanda tangan** Metadata PDF: pembuat `Aspose.PDF for .NET 20.8`; dibuat pada 1 Oktober 2025, pukul 19:58:05; diubah pada pukul 19:58:41, keduanya dalam zona waktu UTC+02:00. Kedua cap waktu tersebut adalah **selisih 36 detik**. Kedua surat tersebut mencantumkan pernyataan mengenai tanda tangan elektronik yang sah pada halaman terakhirnya: „Dieses Schreiben ist qualifiziert elektronisch signiert“. Validasi tanda tangan merupakan pemeriksaan terpisah dari pemeriksaan isi dan pemeriksaan penyamaran yang ditampilkan di sini. **Tampilkan kembali jumlahnya dan bandingkan hash sumbernya** Skrip penghitungan tersebut tertaut ke hash Anlage 1 di bawah ini. Skrip ini merekonstruksi baris-baris tabel pada halaman 444–620 dan menggabungkan 118 sel yang melintasi batas halaman. Visibilitas ditentukan berdasarkan persimpangan kotak kata dengan persegi panjang hitam yang tidak tembus pandang; satu deskripsi yang kosong dicatat secara terpisah. Penghitungan karakter Sirilik menggunakan rentang U+0400–U+052F. Perbandingan format login menggunakan pola string lengkap `[A-Za-z]+[0-9]{3,5}`. Jumlah pengulangan dihitung setelah spasi kosong yang dihasilkan dari proses ekstraksi dinormalisasi. Jumlah kata dalam deskripsi yang dianalisis selalu sesuai dengan akar kata. Ini adalah pengukuran deskriptif, bukan temuan otomatis terkait kepenulisan bersama atau pelanggaran etika. Perkiraan bahasa opsional dalam JSON menggunakan Lingua 2.2.0 secara lokal; teks yang pendek dan ambigu tetap tidak diberi label. Penghitungan 905.672 karakter ini menghitung setiap karakter non-spasi yang kotak pembatasnya berpotongan sekali dengan persegi panjang hitam; 1.044 dari 1.329 persegi panjang hitam tersebut tumpang tindih dengan teks semacam itu. [Jumlah agregat · JSON](https://phishdestroy.io/tgwitness/assets/signed-export-statistics.json?v=b84f21c8824d) · [Skrip penghitungan lokal · Python](https://phishdestroy.github.io/TgWitness/assets/signed-export-audit.py) ``` python signed-export-audit.py Anlage1.pdf --output counts.json sha256sum Anlage1.pdf pdfinfo Anlage1.pdf | grep -E "Producer|CreationDate|ModDate" pdftotext -layout Anlage1.pdf - | less ``` Skrip ini memerlukan PyMuPDF dan lingua-language-detector. Skrip ini tidak melakukan permintaan jaringan apa pun dan menghasilkan data agregat, bukan teks keluhan atau data login. | Berkas | SHA-256 | | --- | --- | | Nomor Dokumen 42603633 (Dr. Zurheide) | `de0fdcf6bfaccedc98d1670438bc7ca3330479096875e716dbb9678922b43ab9` | | Nomor Dokumen 42282474 (Dr. Schelinski) | `b48e09c28ee40a46f1d404041751f718fb185d1eb774ddabb4373fdd53bbe2f1` | | Lampiran 1 | `2bb927e2c42fdc2e3ad089ae302dd887c343f6798aba00fcfac279224ff7d6af` | **Pelajaran yang bisa dipetik dari setiap dokumen ekspor.** Pengacara dapat menandatangani dokumen ekspor. Tanda tangan tersebut menunjukkan siapa yang mengirimkannya, bukan kebenaran isi dokumen tersebut. Kebenaran adalah apa yang tetap bertahan setelah melalui verifikasi yang dapat dilakukan oleh siapa pun. ## Sikap kami **Sikap PhishDestroy.** Kami menghormati hukum dan pengadilan. Hukum bukanlah musuh kebenaran. Mereka yang memutarbalikkan hukum agar tidak perlu mematuhinya bukanlah sekutu pengadilan, dan gelar doktor tidak dapat dijadikan landasan otoritas bagi pengadilan. Gelar doktor hanyalah sebuah fakta historis: sebuah karya penelitian dalam bidang teoretis yang sempit, yang dipertahankan sekali saja. Gelar tersebut tidak menjadikan siapa pun sebagai pengacara di bidang TI. Sejauh yang kami lihat, tidak ada satu pun dalam judul tersebut yang dapat menjelaskan kesalahan-kesalahan tersebut: baik argumen yang tertulis di bawah tanda tangan, nama yang salah eja, maupun kebocoran data yang justru diklaim akan dilindungi oleh surat-surat tersebut. Kedua pihak yang menandatangani kemudian mengajukan permohonan penghapusan dari hasil pencarian berdasarkan Pasal 17 (lihat [pemberitahuan operator](https://phishdestroy.io/tgwitness/id/docs/reference/notice/)). Hak untuk dilupakan tidak seharusnya menghapus kelalaian profesional yang dilakukan oleh seorang profesional. Dan apakah ada yang memeriksa dokumen-dokumen yang dikirimkan dengan tanda tangan terverifikasi? Surat-surat ini terkesan seperti email kepada seorang teman, bukan seperti dokumen yang memiliki signifikansi publik. Prinsip "zero trust" berlaku bagi semua orang. Uang itu baik. Namun, menurut kami, menjual undang-undang negara sendiri demi uang bukanlah cara terbaik untuk memanfaatkannya. Tapi kami bukan ahli. PhishDestroy bukanlah pihak yang terlibat dalam sengketa ini dan tidak menyatakan apakah pemblokiran akun Steam tersebut dapat dibenarkan. Subjek data tidak diidentifikasi di halaman ini; pengenal akun, nama pengguna, alamat IP, dan data pribadi tidak dicantumkan. Teks pengaduan dikutip tanpa mencantumkan nama pengguna pelapor, termasuk teks di bawah kotak hitam, yang tetap ada di lapisan teks berkas. Surat-surat: Dok.-Nr. 42282474, 15 Agustus 2025 (3 halaman); Dok.-Nr. 42603633, 1 Oktober 2025 (9 halaman). Lampiran: Anlage 1 (830 halaman). Referensi halaman mengikuti urutan halaman PDF. Terjemahan bahasa Inggris dari kutipan bahasa Jerman merupakan hasil terjemahan kami. [Dokumen kasus selengkapnya](https://phishdestroy.io/steam_dossier/taylor_wessing) · [Berkas GDPR selama 106 hari](https://github.com/phishdestroy/TgWitness/blob/main/docs/TAYLOR-WESSING-GDPR-FILE.md). --- # Telegram · Mengelola arsip Canonical page: https://phishdestroy.io/tgwitness/id/docs/archive/ Muat riwayat, cari catatan yang disimpan, tinjau sumber AI, dan hubungkan alat Anda. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Temukan pesan. Periksa sumbernya. Bangun kasusnya. 01**Menampilkan riwayat** Tarik pesan lama dari sumber aktif Anda ke ruang kerja. 02**Ikuti sumber-sumbernya** Cari, lalu buka pesan tersimpan di balik setiap hasil. 03**Pastikan proses serah terima tetap jelas** Analisis Anda di satu berkas, bukti bertanda tangan di sebelahnya. Catatan yang direkam, teks yang dikenali, dan kesimpulan analis tetap terpisah. ## Muat pesan-pesan sebelumnya 1. **Sumber → Obrolan dalam cakupan**: periksa obrolan aktif, mulai pengamatan. 2. **Muat seluruh riwayat**. Daftar sumber diambil apa adanya saat itu. 3. **Jeda riwayat** / **Lanjutkan riwayat** kapan saja. Setelah dimulai ulang, lanjutkan secara manual. 4. Periksa hasil per sumber dan antrean unduhan, simpan laporan kemajuan bertanda tangan bersama ekspor. Ini mengisi ruang kerja. Ekspor satu obrolan ke HTML/JSON adalah hal lain. [Detail](https://phishdestroy.io/tgwitness/id/docs/reference/history/). ## Cari dulu, baru putuskan soal AI 1. **Jurnal** mencari secara lokal, dengan filter sumber dan waktu. 2. Cari frasa atau domain, buka catatannya dan versinya. 3. Untuk AI, admin menyiapkan penyedia di **Integrasi**. Lalu **Tanya arsip**: pilih obrolan dan periode, lihat **Data yang dikirim ke model**, dan hapus centang yang tidak boleh keluar. 4. Periksa kutipannya, simpan jawaban sebagai laporan, tambahkan catatan Anda. Pencarian tidak butuh AI. Laporan menyimpan sumber dan revisinya, terpisah dari jurnal bertanda tangan. [Penyiapan penyedia](https://phishdestroy.io/tgwitness/id/docs/reference/analysis/). ## Pilih koneksi yang Anda butuhkan | Tugas | Buka | Pengaturan | | --- | --- | --- | | Izinkan klien AI membaca obrolan pilihan | **Integrasi → MCP** | [Pasang MCP, buat token terbatas, sambungkan](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/) | | Mengenali teks dalam media yang disimpan | Catatan `media.saved` → **Mengenali lampiran** | [Siapkan worker Docker lokal](https://phishdestroy.io/tgwitness/id/docs/reference/media-analysis/) | | Kirim peristiwa ke n8n atau SIEM | **Integrasi → Webhook keluar** | [Tambahkan penerima, periksa HMAC, buang ID ganda](https://phishdestroy.io/tgwitness/id/docs/reference/webhooks/) | **Token akses mana yang harus ditempatkan di mana?** Akses panel untuk manusia. MCP punya token baca-saja sendiri, webhook punya rahasia HMAC sendiri. Tidak ada yang butuh sesi Telegram. [Bagikan akses panel](https://phishdestroy.io/tgwitness/id/docs/access/) atau [konfigurasikan klien MCP](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/). ## Sampaikan sumber dan kesimpulan Taruh laporan di sebelah ZIP bertanda tangan. Laporan adalah bacaan Anda atas sumbernya; ZIP adalah yang diverifikasi penerima. [Ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/exports/) · [Melakukan penyelidikan secara menyeluruh](https://phishdestroy.io/tgwitness/id/docs/cases/) --- # Telegram · Bagikan sebuah kasus Canonical page: https://phishdestroy.io/tgwitness/id/docs/access/ Berikan akses kepada peninjau dan analis ke akun dan obrolan yang dipilih, dengan izin terpisah, batasan sesi, dan token yang dapat dicabut. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Bagikan kasus yang dibutuhkan seseorang. Tetap kendalikan sisanya. 01**Pilih bukti** Seluruh ruang kerja atau obrolan tertentu. 02**Pilih tindakan** Lihat, ekspor, atau hanya operasi yang mereka perlukan. 03**Tentukan batasannya** Token pribadi dengan masa berlaku, batas sesi, dan aturan IP jika Anda mau. Cakupan pengumpulan menentukan apa yang direkam. Cakupan akses menentukan apa yang dapat dilihat dan dilakukan oleh seseorang. ## Berikan akses kepada seseorang 1. Sebagai admin, buka **Akses**. 2. Beri nama, pilih ruang kerja dan obrolan. 3. Peninjau cukup dengan **Lihat**. Tambahkan **Ekspor** untuk unduhan. 4. Tentukan batasan, lalu tekan **Buat akses**. 5. Salin token (hanya ditampilkan sekali) dan kirim secara pribadi bersama alamat panel. 6. Periksa dulu apa yang akan mereka lihat di sesi browser terpisah. ## Mulailah dengan tugas yang perlu mereka lakukan | Orang | Akses | Hasil | | --- | --- | --- | | Peninjau | Obrolan terpilih; hanya dapat dilihat | Membaca obrolan, tidak bisa mengubah apa pun. | | Analis | Obrolan terpilih; lihat dan ekspor | Membaca dan mengunduh yang dibutuhkan kasus. | | Operator | Ruang kerja yang dipilih secara keseluruhan; sumber dan koleksi | Memutuskan apa yang diamati, memulai dan menghentikan kolektor. | Ini hanya contoh, bukan peran tetap. Akses yang terbatas pada obrolan tidak pernah mendapat pengaturan akun atau ekspor jurnal lengkap. Akses semua ruang kerja mencakup akun yang ditambahkan kemudian. ## Anda dapat mengubah pikiran Anda kapan saja Ubah akses kapan saja, berlaku sejak permintaan berikutnya. Akhiri satu sesi atau cabut semuanya. Berkas yang sudah diunduh tidak bisa ditarik. Pengumpulan tetap berjalan. **Batas sesi dan IP** Batasi sesi paralel dan login, tetapkan tanggal akhir, izinkan IP atau subnet, atau kunci ke IP login pertama. Masa berlaku dihitung dari ketidakaktifan; panel yang terbuka dihitung aktif. Di balik proxy, periksa IP klien mana yang dilihat aplikasi. **Kunci utama dan log aktivitas** Token utama tetap di tangan admin. Akses yang diterbitkan tidak bisa mengelola akses orang lain atau membuka konsol admin. Perubahan akses dan sesi ditandatangani ke jurnal, tanpa token. Admin server tetap bisa melihat semuanya. Ketujuh izin dan aturan sesi: [referensi akses](https://phishdestroy.io/tgwitness/id/docs/reference/access/). --- # Telegram · Jaga agar tetap berjalan Canonical page: https://phishdestroy.io/tgwitness/id/docs/server/ Jalankan TgWitness di server yang dilengkapi penyimpanan permanen, akses panel pribadi, pencadangan, dan pemeriksaan setelah server di-restart. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Jaga kolektor tetap berjalan dan data aman melewati restart. ## Pilih metode peluncuran Native: [peluncur](https://phishdestroy.io/tgwitness/id/docs/start/) ditambah templat layanan di [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Docker, dari folder proyek: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Panel mendengarkan di localhost:8787. Buka secara lokal atau lewat tunnel SSH, dengan token dari perintah kedua. ## Pertahankan seluruh direktori data Native: `data/live`. Docker: volume `tgwitness-data`. Jurnal, sesi, dan kunci harus bersama. Ekspor bertanda tangan adalah bukti, bukan cadangan. 1. Hentikan pengumpulan dulu. 2. Salin seluruh direktori data ke tempat aman di luar host. 3. Coba pulihkan di instalasi terpisah sebelum Anda mempercayainya. ## Periksa kembali setelah restart Periksa ruang kerja dan kunci, koneksi, sumber, dan apakah pesan baru masuk. TgWitness mengejar apa yang masih dimiliki Telegram, bukan semua yang terjadi selama ia mati. Kontainer "sehat" berarti server web menjawab. Apakah pengumpulan berjalan, pesan uji dan saksi yang akan memberi tahu. ## Hanya publikasikan apa yang Anda maksudkan HTTPS, volume, pembaruan, dan pemulihan ada di referensi deployment. Yang benar-benar diuji: [catatan validasi](https://phishdestroy.io/tgwitness/id/docs/reference/verification/). --- # Telegram · Temukan apa yang salah Canonical page: https://phishdestroy.io/tgwitness/id/docs/troubleshooting/ Periksa akses panel, koneksi Telegram, pesan yang hilang, FloodWait, dan status saksi menggunakan sinyal yang tepat untuk setiap masalah. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Mulai dari gejalanya, periksa satu hal setiap kali. ## Panel meminta token Yang diminta adalah token panel dari berkas yang disebut peluncur. Docker: `docker compose exec tgwitness cat /data/panel-token.txt`. Bukan kode Telegram, bukan token bot, bukan token saksi. ## Telegram tidak terhubung Jalankan pemeriksaan koneksi. Di proxy publik, pilih yang lain dan simpan. Periksa jenis proxy dan format rahasianya. Memperbarui daftar tidak mengganti rute dengan sendirinya. ## Terhubung, tetapi tidak ada pesan baru 1. Apakah pengamatan berjalan, di ruang kerja yang benar? 2. Apakah sumbernya dipilih dan terlihat oleh akun itu? 3. Kirim pesan unik di grup uji Anda lalu cari pesan itu. 4. Cari gangguan atau galat Telegram di jurnal. Obrolan yang sepi memang tidak punya hal baru. Jika kelengkapan penting, lakukan uji pengiriman terkendali. ## FloodWait atau jeda setelah restart FloodWait adalah Telegram berkata "pelan-pelan". Tunggu sampai lewat dan kurangi beban; menyambung ulang tidak membantu. Setelah restart, TgWitness mengejar apa yang masih dimiliki Telegram; sisanya adalah celah, jadi catat. ## Bot ini telah dikonfigurasi tetapi tidak memposting apa pun Apakah saksi berjalan, bisakah bot memposting di kanal, bisakah ia menjangkau kolektor dan Bot API? Cari postingan yang gagal di jurnalnya. Kueri di sisi kolektor tidak berarti postingan terkirim. ## Di mana integrasi token GitHub? **Sedang direncanakan.** Bagian "Extras" menjelaskan alur kerja verifikasi fork dan build yang diusulkan. Saat ini belum ada formulir token GitHub atau verifikasi otomatis yang memastikan bahwa instalasi yang berjalan sesuai dengan repositori. Lihat [status fitur saat ini](https://phishdestroy.io/tgwitness/id/docs/reference/features/). Melaporkan bug? Versi, sistem operasi, langkah, dan galat tanpa data pribadi. Jangan pernah menaruh sesi, token, pesan pribadi, atau direktori data di issue publik. --- # Export Clinic Canonical page: https://phishdestroy.io/tgwitness/id/docs/export-clinic/ Saksikan eksperimen ekspor Telegram Desktop yang terkendali, bandingkan tujuh percakapan uji coba, dan periksa rekaman asli serta berkas-berkas yang terkait. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Di jendela obrolan tertulis "FAIL". Di halaman yang diekspor tertulis "PASS". Perhatikan perubahannya, bandingkan kedua berkas tersebut, dan periksa bagaimana hal itu bisa terjadi. Percobaan ini menggunakan akun uji coba dan percakapan yang telah disusun sebelumnya. Telegram Desktop diunduh dari sumber resminya dan berkas eksekusinya tidak diubah. Seorang asisten lokal sengaja mengubah beberapa berkas ekspor yang dipilih. Perhatikan proses pengunduhan, masuk, dan ekspor, lalu bandingkan percakapan Telegram dengan kode HTML dan JSON yang telah diubah. Eksperimen ini menunjukkan bagian mana dari hasil ekspor biasa yang dapat diubah dan mengapa pencatatan proses pengumpulan data itu penting. Film ringkasan berdurasi **1:59,7****6:08,8** rekaman sumber lengkap**7** percakapan uji coba ## Tonton eksperimennya [Unduh filmnya](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) 1:59,7 · Langkah-langkah penyiapan dan langkah-langkah yang diulang dipercepat ×2–×15 dan diberi label. Proses masuk, ekspor pertama, dan perbandingan yang dipilih dijalankan pada kecepatan aslinya. Tanpa audio. [Unduh file MKV asli ↗](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) ## Bandingkan hasil ekspor pengujian Kutipan-kutipan ini diambil dari berkas JSON yang disimpan dan dimodifikasi. Pilih jenis percakapan, bandingkan pesannya, lalu unduh ekspor berpasangan yang lengkap untuk memeriksa sendiri berkas HTML, JSON, dan gambar yang disertakan. ### Klinik Ekspor | Pemeriksaan PDF 5 pesan · 2 yang diubah **SEBELUM PERUBAHAN DI TINGKAT DAERAH**Byte asli tetap dipertahankan PEMERIKSAAN DOKUMEN / UJI SINTETIS HASIL: GAGAL Teks tersembunyi masih dapat dipilih di bawah persegi panjang hitam. Ini adalah hasil yang telah diprogram untuk berkas PDF demonstrasi, bukan hasil pemeriksaan terhadap dokumen pihak ketiga. d58d19814e1e07d5… **SETELAH PERUBAHAN DI TINGKAT LOKAL**Byte yang diubah secara sengaja PEMERIKSAAN DOKUMEN / UJI SINTETIS HASIL: LULUS Semua teks sensitif telah dihapus secara permanen. Ini adalah hasil demonstrasi yang sengaja diganti. 83a0a37eb7110d51… result.json · pesan 1216 Isi adegan yang telah ditulis dalam skenario. Kesimpulan bot tersebut bukanlah hasil pemeriksaan terhadap dokumen pihak ketiga yang sebenarnya. Pesan 1 dari 2 telah diubah **Bandingkan gambar yang disertakan dalam ekspor ini** ![Gambar sebelum dimodifikasi secara lokal](https://phishdestroy.io/tgwitness/id/docs/export-clinic/) SEBELUMNYA · byte gambar yang disimpan ![Gambar yang dimodifikasi secara sengaja](https://phishdestroy.io/tgwitness/id/docs/export-clinic/) SETELAH · gambar yang sengaja diganti Lampiran tidak disertakan dalam ekspor bot ini. Arsip tersebut tetap mempertahankan batasan tersebut. JavaScript dinonaktifkan. Fitur perbandingan bot bawaan dan semua unduhan tetap tersedia. Unduh arsip yang sudah digabungkan untuk melihat enam percakapan lainnya. ## Apa yang ditunjukkan oleh perbandingan tersebut [Fitur ekspor standar](https://telegram.org/blog/export-and-more) Telegram menyimpan riwayat percakapan dan media yang dipilih sebagai berkas lokal. Di sini, seorang pengguna yang memiliki akses tulis mengubah berkas-berkas tersebut sementara klien resmi tetap menampilkan percakapan aslinya. Berkas-berkas yang disandingkan ini memungkinkan Anda memeriksa setiap perubahan. 1. **Aplikasi resmi:** unduh, masuk, dan lihat percakapan uji coba. 2. **Ekspor asli:** klien menulis kode HTML, JSON, dan gambar-gambar yang dipilih. 3. **Intervensi yang diungkapkan:** seorang pembantu lokal dengan sengaja mengubah berkas-berkas tertentu. 4. **Perbandingan:** percakapan dan ekspor yang telah diubah ditampilkan berdampingan. ### Catat data tersebut saat dikumpulkan Waktu penandatanganan sangat penting. Menandatangani ekspor yang telah diubah akan mengabadikan versi yang telah diubah tersebut. TgWitness terhubung ke Telegram, merekam konten yang dikirimkan ke akun tersebut, serta menandatangani dan menghubungkan entri jurnal selama proses pengumpulan. Penerima dapat memverifikasi catatan dan berkas yang disimpan dengan membandingkannya terhadap tanda tangan tersebut dan titik pemeriksaan yang disimpan secara independen. Untuk proses pengumpulan data yang direkam secara eksternal, [GitHub Actions](https://phishdestroy.io/tgwitness/id/docs/capture/)menjalankan pengumpul TgWitness yang telah ditandai dengan sesi Telegram baru. GitHub memverifikasi arsip yang dihasilkan. Proses verifikasi memeriksa alur kerja dan versi pengumpul yang telah disetujui, ringkasan arsip, jurnal, serta lampiran. [Memverifikasi arsip TgWitness](https://phishdestroy.io/tgwitness/id/docs/exports/#verify) · [Cobalah mengubah catatan yang telah ditandatangani](https://phishdestroy.io/tgwitness/id/docs/concepts/#chain) · [Jalankan penangkapan GitHub](https://phishdestroy.io/tgwitness/id/docs/capture/) ## Apa Sebenarnya yang Disertifikasi oleh Alat Forensik? Export Clinic menunjukkan satu kasus tertentu. Pola yang terungkap di dalamnya tidak hanya terjadi di Telegram. Dalam sebagian besar proses hukum yang telah kami tinjau — baik dalam berkas pengadilan, pembahasan kasus, maupun analisis yang dipublikasikan — “bukti digital” memiliki format yang konsisten: ekspor Telegram (berupa berkas HTML atau JSON, terkadang rekaman layar monitor, terkadang video dari iPhone yang menampilkan navigasi melalui halaman profil) yang disertai dengan tanda tangan ahli. Itulah biasanya rantai pembuktian secara keseluruhan. Ekspor Telegram memberikan gambaran singkat mengenai portabilitas data pribadi. TgWitness menambahkan catatan pengambilan data, pengamatan dan perubahan yang disimpan, hash berkas, tanda tangan pengumpul, serta catatan verifikasi eksternal yang tersedia untuk mode yang dipilih. Secara keseluruhan, hal-hal ini memungkinkan penerima membandingkan materi yang disimpan dengan konteks, waktu, dan kondisi pengumpulannya yang tercatat. ### Alat-alatnya itu jujur. Masalahnya adalah apa yang orang anggap sebagai bukti yang ditunjukkan oleh alat-alat tersebut. Kami telah bekerja sama langsung dengan UFED Cellebrite. Perangkat lunak ini sangat bagus. Ketika perangkat lunak ini mengekstrak data dari suatu perangkat, menghitung nilai hash SHA-256, dan menghasilkan laporan yang ditandatangani, hal itu secara akurat membuktikan satu hal saja: *Byte-byte ini sudah ada di perangkat ini pada saat proses ekstraksi, dan tidak ada yang berubah selama proses pengiriman.* Itu benar adanya. Itu bermanfaat. Itulah keseluruhan kesimpulan yang dapat ditarik darinya. Alat tersebut tidak memberikan informasi apa pun mengenai apa yang ada di perangkat tersebut sebelum pihak penegak hukum menyentuhnya. Alat tersebut juga tidak memberikan informasi apa pun mengenai apakah data tersebut mencerminkan kenyataan di masa lalu. Alat tersebut akurat. Alat tersebut bukanlah saksi. Kita bisa menggunakan alat-alat yang dirancang khusus untuk menangani ekspor obrolan Telegram — penampil, pengarsip, dan pembungkus untuk presentasi di pengadilan — menguji masing-masing alat tersebut dengan berkas ekspor yang telah disiapkan, lalu menyusun tabel perbandingan. Namun, kita tidak akan melakukannya. Intinya bukanlah alat mana yang mampu mendeteksi apa. Tak satu pun dari alat-alat itu yang mampu melakukannya. Mereka hanya memproses apa yang terkandung dalam berkas ekspor tersebut. Jika struktur berkas ekspor telah ditentukan sebelum berkas tersebut diproses oleh alat-alat tersebut, maka alat-alat itu akan melaporkan struktur tersebut secara akurat. Tanda tangan kriptografis menjamin keutuhan data *sejak saat penandatanganan dan seterusnya*. Tanda tangan ini tidak memberikan pernyataan apa pun mengenai apa yang terjadi sebelumnya. Jika data masukan telah disusun sebelum proses ekstraksi, laporan tersebut secara kriptografis sempurna namun secara faktual salah. Alat ini melaporkan kedua hasil tersebut dengan cara yang sama. ### Kesenjangan Akuntabilitas Bayangkan sebuah yurisdiksi di mana peralatan forensik diperoleh melalui tender publik — versi, konfigurasi, dan jadwal pengadaan yang tercantum dalam catatan publik. Di mana tidak ada undang-undang yang mewajibkan perangkat tersebut menggunakan firmware terbaru. Di mana saksi ahli tidak dikenai pertanggungjawaban pidana pribadi di hadapan pengadilan atas kesimpulan yang mereka sampaikan. Di Amerika Serikat dan Inggris Raya, seorang ahli forensik bertanggung jawab secara hukum secara pribadi atas setiap tindakan yang dilakukannya terkait barang bukti. Tanggung jawab tersebut — bukan perangkat lunaknya — lah yang membuat rantai barang bukti dapat berfungsi. Jika tanggung jawab itu dihilangkan, alat yang semula digunakan untuk menegakkan keadilan justru dapat dimanfaatkan untuk tujuan apa pun yang dianggap menguntungkan oleh pemegang lisensi. **Konstruksi teknis dari keadaan perangkat sebelum terjadinya kejang** Jika seseorang mengetahui adanya serangan yang akan terjadi dengan waktu persiapan yang cukup — tujuh hari sudah lebih dari cukup — reaksi panik justru kontraproduktif dan, di beberapa yurisdiksi, bahkan dapat dianggap sebagai tindak pidana tersendiri. Seseorang yang sudah siap, dengan akses teknis dan sumber daya yang memadai, akan melakukan hal yang berbeda: ia akan mengatur kondisi perangkat. **Jendela firmware.** Perangkat Samsung Galaxy S Ultra dan Z Fold kelas atas — dilengkapi perlindungan Knox dan bootloader terkunci. Selisih waktu antara peluncuran patch keamanan dan ketersediaannya untuk perangkat di wilayah tertentu biasanya mencapai satu bulan. Untuk model yang baru diluncurkan, rentang waktu tersebut pada tiga hingga empat bulan pertama jauh lebih lama. Sejauh yang kami ketahui, tidak ada yurisdiksi yang secara hukum mewajibkan penggunaan firmware terbaru pada perangkat pribadi. **Alat tingkat layanan.** Perangkat lunak pemeliharaan komersial memungkinkan akses tingkat rendah ke perangkat selama jendela waktu ini tanpa memicu indikator gangguan Knox yang biasanya dicari oleh ahli forensik. **Pembuatan urutan waktu.** Cadangan perangkat lengkap yang diterapkan ke emulator, manipulasi waktu berbasis skrip, dan isolasi jaringan, memungkinkan pembuatan urutan waktu peristiwa yang diinginkan: panggilan, pesan, aktivitas aplikasi, serta koordinat GPS. **Lokasi tanpa paparan sinyal seluler.** Catatan tagihan menara seluler dapat diverifikasi secara independen — jangan sentuh data tersebut. Sebagai gantinya, koneksi ke titik akses Wi-Fi publik dicatat. Alamat MAC dari infrastruktur publik dikumpulkan secara sistematis dan didistribusikan oleh perusahaan teknologi besar. Rantai geografis yang berkelanjutan yang mencakup periode apa pun yang diinginkan dapat disusun dari data yang tersedia untuk umum. **Rotasi akun.** Penghapusan akun Samsung membutuhkan waktu sekitar tujuh hari hingga akun tersebut benar-benar terhapus. Akun baru dibuat, lalu cadangan yang telah disiapkan dipulihkan. Tidak ada konflik integritas sistem, bootloader tetap utuh, dan tidak ada tanda perusakan yang terpicu. **Telegram secara khusus.** Pada beberapa jenis perangkat tertentu, basis data dan cache aplikasi — percakapan, media, metadata notifikasi, pola aktivitas — dapat diganti pada tingkat kemampuan sistem operasi tanpa perlu akses root konvensional. Analisis mendalam oleh para ahli yang meneliti dump mentah lengkap berpotensi mendeteksi anomali. Analisis tersebut mahal, lambat, dan berdasarkan pengalaman kami, pada dasarnya tidak pernah diminta dalam proses hukum standar. ### Masukan Sampah, Keluaran Sampah Laporan yang telah ditandatangani mengaitkan byte yang diekstraksi dengan proses akuisisi tersebut. Riwayat perangkat sebelumnya dievaluasi menggunakan catatan dari periode sebelumnya. Rangkaian proses yang terjadi selanjutnya — para saksi ahli yang menelaah hasil analisis alat tersebut, menyusun analisis, dan menandatangani kesimpulan — juga sama akuratnya pada setiap langkahnya. Tak seorang pun dalam rangkaian tersebut berbohong. Tak seorang pun dalam rangkaian tersebut membuktikan kebenaran sejarah. Setiap peserta melaporkan dengan akurat apa yang mereka terima dari langkah sebelumnya. Gelar doktor merupakan bukti bahwa penelitian di masa lalu telah diselesaikan. Gelar tersebut bukanlah sertifikasi kompetensi saat ini, dan tidak dapat menjadikan suatu pernyataan yang secara matematis tidak dapat diverifikasi menjadi benar. Kami mengusulkan standar yang berbeda: **percayalah pada matematika, bukan pada gelar.** ### Zero Trust sebagai Bukti Dalam keamanan informasi, "Zero Trust" berarti tidak ada pihak yang dipercaya secara otomatis, terlepas dari jabatannya atau kredensialnya — setiap klaim harus diverifikasi secara independen. Kami mengusulkan penerapan prinsip yang sama pada bukti digital. Kepercayaan adalah titik kelemahan. Jika suatu klaim tidak dapat diverifikasi secara independen dan matematis, maka itu adalah klaim yang didasarkan pada kepercayaan — dan kepercayaan dapat disalahgunakan, dibeli, atau dipaksakan. Khusus untuk bukti ekspor Telegram: jangan percaya pada kami, jangan percaya pada Telegram, jangan percaya pada analis, dan jangan percaya pada saksi ahli. Periksa kembali perhitungannya. Bagaimana hal itu diterapkan dalam praktiknya: Sertifikasi TgWitness merujuk pada model SLSA v1 Level 3 — riwayat pembangunan yang ditandatangani oleh infrastruktur GitHub Actions, yang terikat pada hash commit dan eksekusi alur kerja tertentu. Sertifikasi tersebut dapat diverifikasi secara independen, tanpa harus mempercayai pihak mana pun yang terlibat dalam proses pengumpulan data. Hal ini tidak menghilangkan semua asumsi kepercayaan — melainkan mendokumentasikan dengan tepat asumsi mana saja yang masih berlaku, serta apa saja asumsi tersebut. **Tentang saksi ahli dan insentif finansial** Seorang pengacara yang mewakili salah satu pihak dalam suatu sengketa, sekaligus menampilkan diri sebagai ahli pihak ketiga yang netral dalam proses hukum yang sama, dengan imbalan yang bergantung pada hasil yang diperoleh kliennya: inilah kontradiksi struktural. Kami tidak sedang menuduh siapa pun. Kami bertanya mengapa struktur ini dianggap dapat diterima, dan mengapa hal ini sangat jarang ditelaah. Argumen balasan yang umum: *seberapa besar kerugian yang akan mereka tanggung jika berbohong?* Di yurisdiksi yang mengakui hak atas penghapusan data dan hak untuk dilupakan, biaya praktis yang harus ditanggung dalam menindaklanjuti kesaksian palsu dari seorang ahli seringkali sangat kecil. Mereka yang menyampaikan kekhawatiran terkait kesimpulan ahli yang keliru biasanya menerima surat resmi yang meminta agar kekhawatiran tersebut dihentikan. Proses tersebut mahal bagi pihak yang menyampaikan kekhawatiran. Namun, hal itu tidak mahal bagi sang ahli. Kami tidak bermaksud mengatakan bahwa semua saksi ahli itu tidak jujur. Yang kami maksudkan adalah bahwa ungkapan “biaya yang harus mereka tanggung jika berbohong terlalu besar” bukanlah standar pembuktian. Itu adalah standar kepercayaan. Dan kepercayaan adalah suatu kerentanan. Seseorang yang ingin menggugat sebuah pernyataan TgWitness harus dapat merusak tanda tangan kriptografis tersebut, meyakinkan infrastruktur penandatanganan GitHub untuk secara retroaktif menyatakan sesuatu yang sebenarnya tidak pernah dijalankan, dan melakukannya terhadap riwayat commit yang tidak dapat diubah — dengan adanya saksi. Jika kemampuan-kemampuan tersebut memang ada dan hanya disembunyikan di balik kesulitan dalam mengoperasikan perangkat lunak PDF, kami akan dengan tulus menyambut baik demonstrasinya. Kami tidak mengklaim bahwa alat-alat kami lebih baik — kami tidak memiliki produk komersial dan tidak tertarik untuk memilikinya. Kami mengamati sebuah masalah: anggapan yang meluas bahwa hasil perangkat lunak forensik sama dengan kebenaran historis, dan bahwa tanda tangan ahli sama dengan bukti. Anggapan tersebut jarang dipertanyakan pada tingkat teknis dalam proses persidangan di mana hal itu paling penting. Eksperimen ini merupakan salah satu titik data terkontrol. Perhitungan matematis tidak memihak pada gelar apa pun. ## Unduh materi-materi tersebut Video dan berkas ZIP disimpan di [phishdestroy.io](https://phishdestroy.io/). Pilih berkas yang ingin Anda periksa. Kedua berkas ZIP tersebut berisi data uji coba terpilih dan dokumentasi. Alat modifikasi, kode sumber, konfigurasi, kredensial, dan sesi tidak disertakan. ### Sebelum / sesudah ekspor Tujuh percakapan uji coba: HTML, JSON, gambar yang disertakan, dan aset penampil standar. Termasuk manifes berkas dan daftar perubahan terpilih. [Ekspor uji coba · ZIP · 3,0 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-paired-files.zip) Tidak ada video. Tidak ada alat modifikasi. ### Video + ekspor hasil pengujian Rekaman asli selengkapnya, film berdurasi dua menit, file ekspor yang berpasangan, penjelasan, tinjauan metadata, peta pengeditan, dan checksum. [Ekspor video + tes · ZIP · 46,9 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-review-package.zip) Berisi berkas ZIP yang lebih kecil. Tanpa alat modifikasi. **Apa sebenarnya isi dari file ZIP berukuran 46,9 MB itu?** - `video/ExportClinic_2026-11-03_12-50-40.mkv` — rekaman lengkap yang belum diedit, 6:08,8. - `video/export-clinic-2min.mp4` — cuplikan film, 1:59,7. - `data/export-clinic-paired-files.zip` — ekstrak berkas ZIP bersarang ini untuk memeriksa `before/` dan `modified/` folder-folder tersebut. - `description/article-en.md` — penjelasannya dan batasan-batasannya. - `verification/` — empat berkas JSON/Markdown yang mencakup pengeditan peta, pemeriksaan metadata, dan tinjauan paket. - `README.md` dan `SHA256SUMS.txt` — membaca petunjuk dan checksum berkas. Ada sepuluh berkas di dalam arsip ZIP luar. Berkas MP4 lengkap yang terpisah tidak disertakan karena berkas MKV aslinya sudah berisi rekaman lengkap. Bagian standar `js/script.js` di dalam setiap obrolan yang diekspor adalah aset penampil HTML Telegram yang tidak diubah. ### File video per buah - [MKV Asli · 6:08,8 · 29,6 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) — rekaman sumber yang identik hingga tingkat byte. - [Buka file MP4 lengkap · 6:08,8 · 29,9 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-full.mp4) — konversi format yang kompatibel dengan browser, tanpa pengkodean ulang video. - [Buka file MP4 yang dikompresi · 1:59,7 · 14,3 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) — perubahan kecepatan pemutaran ditandai. [Unduh checksum](https://phishdestroy.io/tgwitness/assets/export-clinic/SHA256SUMS.txt)[Peta pengeditan video](https://phishdestroy.io/tgwitness/assets/export-clinic/recording-manifest.json?v=42fbcde007f1)[Daftar isi berkas berpasangan](https://phishdestroy.io/tgwitness/assets/export-clinic/review-file-manifest.json?v=c725b2ecbe50)[Peninjauan metadata](https://phishdestroy.io/tgwitness/assets/export-clinic/original-metadata-notes.md)[Panduan Penjelasan dan Verifikasi Terkini](https://phishdestroy.io/tgwitness/assets/export-clinic/article-en.md) Berkas ZIP ulasan yang dapat diunduh ini tetap menyertakan berkas README dan artikel aslinya. Penjelasan saat ini mencakup panduan pengumpulan dan verifikasi TgWitness. **Bagaimana “sebelumnya” disusun:** ini adalah struktur folder sebelum perubahan yang telah direkonstruksi. File-file yang mengalami perubahan dipulihkan byte demi byte dari cadangan yang disimpan dan dicocokkan dengan nilai hash yang tercatat. Aset-aset penampil yang tidak mengalami perubahan disalin dari ekspor yang telah diambil. Daftar file (manifest) mencatat versi-versi yang disediakan. Dari ketujuh percakapan tersebut, terdapat 45 catatan pesan; 17 catatan dan 32 berkas berbeda. Setiap versi berisi 340 berkas. Lampiran PDF tidak disertakan dalam ekspor yang terekam dan tidak terdapat dalam arsip-arsip ini. ## Rincian eksperimen **Di mana perubahan itu terjadi?** Seorang pembantu lokal mengubah berkas-berkas yang dibuat oleh Telegram Desktop. Berkas eksekusi klien resmi dan percakapan yang terlihat di Telegram tetap tidak berubah. Perbandingan tersebut menampilkan pesan-pesan asli di samping ekspor yang telah diubah. **Apakah ini ekspor data akun yang lengkap?** Tidak. Materi tersebut mencakup tujuh percakapan uji coba yang dimiliki: obrolan pribadi, bot, grup pribadi, supergrup pribadi dan publik, serta saluran pribadi dan publik. Materi tersebut berisi 45 catatan pesan. Tidak ada obrolan yang tidak terkait, kontak, atau arsip seluruh akun yang disertakan. **Apakah lampiran PDF-nya sudah disertakan?** Tidak. Pengaturan ekspor yang terekam tidak mencakup lampiran berkas. Pesan dan gambar uji coba tersebut merujuk pada sebuah berkas PDF, namun arsip-arsip ini tidak berisi berkas PDF tersebut. Perbedaan ini tetap dipertahankan dalam berkas-berkas dan deskripsinya. **Apakah paket tersebut sudah termasuk alat modifikasi?** Tidak ada file eksekusi, kode sumber pembantu, konfigurasi transformasi, data sesi, kredensial, atau log kerja lengkap yang disertakan. File-file JavaScript berukuran kecil di dalam ekspor yang berpasangan tersebut merupakan aset penampil HTML standar Telegram yang tidak diubah, dan telah diverifikasi identik di kedua versi. **Bagaimana cara memeriksa file yang telah diunduh?** Hitung nilai SHA-256 setiap berkas dan bandingkan dengan checksum yang dipublikasikan. Nilai yang cocok menandakan bahwa Anda memiliki byte yang sama dengan yang dipublikasikan. Daftar isi berkas mencantumkan kedua versi ekspor; peta pengeditan video mendokumentasikan versi ringkas film tersebut. Waktu perekaman diambil dari jam sistem host. **Bagaimana TgWitness membuat catatan tersebut dapat diverifikasi?** Pengumpul menandatangani entri saat menerima data dari Telegram. Arsip tersebut mencakup jurnal, hash berkas, dan data verifikasi. Simpan sidik jari kunci dan titik pemeriksaan secara terpisah, lalu bandingkan salinan penerima dengan keduanya. Fitur penangkapan GitHub menambahkan verifikasi terhadap alur kerja pengumpulan yang disetujui beserta hasilnya. [Ikuti langkah-langkah verifikasi ↗](https://phishdestroy.io/tgwitness/id/docs/exports/) Tujuh percakapan tersebut telah disiapkan untuk eksperimen ini. Rekaman, file ekspor yang berpasangan, dan buku besar perubahan mencatat perubahan pada file lokal yang dijelaskan di atas. Eksperimen berkas lokal terkontrol · 3 November 2026 SHA-256 lengkap telah disalin --- # 56 329 pesan. Canonical page: https://phishdestroy.io/tgwitness/id/docs/validation/ 56.329 pesan Telegram diekspor dalam dua kali pengujian terukur. Bandingkan jumlah pesan, kecepatan pengumpulan, waktu ekspor, dan arsip yang ditandatangani. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) TGWITNESS / EKSPOR NYATA Telah direkam. Telah diekspor. Dua ekspor Telegram terbaru, lengkap dengan catatan waktu mulai dari proses pengumpulan hingga arsip jadi. Jelajahi ruang kerja, periksa datanya, dan unduh contohnya. [Jelajahi demo ini](https://phishdestroy.github.io/TgWitness/demo/?lang=en)[Unduh contoh ekspor](https://phishdestroy.github.io/TgWitness/demo/downloads/tgwitness-demo.zip) Demo interaktif dan contoh tersebut menggunakan pesan fiktif. Pengukuran di bawah ini diambil dari proses ekspor yang sebenarnya. TGW / 001 Tangkapan layar yang direkam · bukan pemantauan langsung Diverifikasi pada 2026-11-06 18:37:38 UTC Revisi yang telah diuji [92e539af](https://github.com/phishdestroy/TgWitness/commit/92e539af40d8368d198ff5e040f1d876f2c1310e) Teks + metadata · arsip yang telah ditandatangani **56 329**Pesan yang diekspor **160.531**Pesan per · putaran koleksi terbaik **2**Rangkaian ekspor yang telah ditandatangani **3**Server yang telah diperiksa Server AWARP · 2 akun **27 030**Pesan yang diekspor **142.983**pesan per detik Hanya pengambilan sendiri 189.043 s Ekspor lengkap 211.647 s Server BWARP · 2 akun **29 299**Pesan yang diekspor **160.531**pesan per detik Hanya pengambilan sendiri 182.513 s Ekspor lengkap 206.650 s 01 / ## Diukur berdasarkan ekspor riil. Satu ekspor baru per server, dengan menggunakan dua akun di masing-masing server. Teks dan metadata dikirim melalui WARP; lampiran tidak termasuk. pesan per detik Server A**142.983 pesan per detik** Server B**160.531 pesan per detik** Server C Belum diukur — Pesan ÷ waktu pengumpulan. Persiapan, pemilihan, dan pengemasan tidak termasuk dalam rentang waktu ini. Jumlah pesan dibagi dengan total waktu ekspor yang terukur, termasuk persiapan dan pengemasan. Tidak ada tanda terima tolok ukur pengumpulan untuk server C. Tidak ada catatan yang digunakan kembali atau ID duplikat di kedua proses tersebut. Server A juga menjalankan proses pembacaan sumber terlindungi di latar belakang. Jeda FloodWait dipatuhi: A · 4, B · 3. **Pengukuran yang tepat & nilai hash arsip** | Server | Pesan | Hanya pengambilan sendiri | Ekspor lengkap | | --- | --- | --- | --- | | Server A | 27 030 | 189.043 s **142.983 pesan per detik** | 211.647 s **127.713 pesan per detik** | | 2026-11-06T18:26:51.500Z → 2026-11-06T18:30:23.228Z SHA-256 `20e507fc68446680ed002fd486d0968a944ec0c71e02f937331ae2b19ab4cd66` | | | | | Server B | 29 299 | 182.513 s **160.531 pesan per detik** | 206.650 s **141.781 pesan per detik** | | 2026-11-06T18:25:40.419Z → 2026-11-06T18:29:07.173Z SHA-256 `824601b502762efaabb8ff9afdb1e8d7fff189862ef2cbc4d8d26d0d68c83e4c` | | | | Kedua arsip tersebut telah lolos verifikasi menggunakan kunci kolektor yang disematkan. 02 / ## Ketiganya, dengan ruang lingkupnya dijelaskan secara rinci. Integritas jurnal, izin file, penyimpanan, rute jaringan, dan proses yang sedang berjalan diperiksa pada setiap server. A Telah diperiksa ### Server A Pengumpulan & ekspor 8 vCPU · 16 GiB · Ubuntu 24.04 Jurnal yang telah diperiksa 21 Acara jurnal 4 517 Titik Pemeriksaan 147 Penetapan tolok ukur pengumpulan data terbaru, verifikasi arsip, dan pemeriksaan integritas cadangan. B Telah diperiksa ### Server B Pengumpulan & ekspor 8 vCPU · 16 GiB · Ubuntu 24.04 Jurnal yang telah diperiksa 21 Acara jurnal 1 993 Titik Pemeriksaan 147 Penetapan tolok ukur pengumpulan data terbaru, verifikasi arsip, dan pemeriksaan integritas cadangan. C Telah diperiksa ### Server C Panel & VM bersarang 8 vCPU · 32 GiB · Ubuntu 24.04 Jurnal yang telah diperiksa 14 Acara jurnal 7 185 Titik Pemeriksaan 973 Otentikasi panel, pengikatan loopback, dan VM bersarang telah diperiksa. Tidak ada pengukuran kinerja pengumpulan data pada server ini. **Hasil pengujian, ruang lingkup, dan catatan teknis** 03 / ## Lintasan dan celah, berdampingan. Hasil terbaru per kasus pytest, termasuk pengulangan. Rangkaian pengujian browser mandiri dan rangkaian pengujian bukti dihitung secara terpisah di bawah ini; keduanya tidak dimasukkan ke dalam total pytest. **1 585**Lulus **3**Gagal **37**Dilewati Tiga uji browser penangkapan memerlukan sandbox Chromium, yang tidak disediakan oleh kontainer-kontainer ini; sandbox tetap diaktifkan. 37 kasus platform yang dilewati dihitung secara terpisah dari hasil lulus. - Paket peramban**102 telah disahkan** - Paket antarmuka**66 telah disahkan** - Kumpulan bukti**15 telah disahkan** - Paket situs web**9 telah disahkan** - Suite tambahan**13 telah disahkan** 04 / ## Ruang lingkup ringkasan ini. 1. 01 ### Sandbox peramban Tiga pemeriksaan peramban menunggu lingkungan yang dilengkapi dengan sandbox Chromium. 2. 02 ### Keterbaruan cadangan 42 jurnal cadangan dan 51.285 berkas telah lulus pemeriksaan integritas. Pada saat pengambilan snapshot, cadangan terbaru tertinggal 3.507 peristiwa dari pengumpulan data secara real-time. 3. 03 ### Jangkauan jaringan 24 dari 40 rute memenuhi syarat. 16 akun lainnya tetap terputus alih-alih beralih ke koneksi langsung. 4. 04 ### Waktu independen Jurnal saksi yang disimpan telah lulus pemeriksaan integritas. Peristiwa terakhirnya terjadi pada pukul 07:27 UTC tanggal 6 November. 5. 05 ### Pengendalian keamanan Perlindungan kunci, perlindungan akun, penyimpanan yang tahan lama, dan kontrol pelepasan dijelaskan dalam model keamanan; temuan terbuka dari audit ini tercantum dalam laporan yang telah ditandatangani. 6. 06 ### Server yang telah diperiksa Tiga server yang telah diperiksa merupakan cakupan halaman ini. 7. 07 ### Beban kerja yang diukur Dua sumber publik, dua kali pengujian terpisah, teks dan metadata tanpa unduhan lampiran. Server C dijalankan tanpa pengukuran laju pengumpulan data. Setiap angka berlaku untuk beban kerja yang tercatat masing-masing. 05 / ## Sebuah catatan yang sudah usang, yang dapat ditelusuri kembali ke angka-angka tersebut. Pengukuran yang dilakukan oleh pengelola, yang ditandatangani dengan kunci audit. Berkas JSON tersebut hanya berisi data agregat. Identitas sumber dan akun, isi pesan, kredensial, serta arsip pribadi tidak dipublikasikan. 1. Tandai revisi sumber dan verifikasi rilis yang telah diinstal. 2. Kumpulkan ke dalam ruang kerja baru, tanpa menyertakan catatan yang telah digunakan kembali. 3. Ukur interval pengumpulan dan interval ekspor lengkap secara terpisah. 4. Verifikasi arsip tersebut menggunakan kunci yang telah disematkan; simpan nilai SHA-256-nya. Rilis yang telah diuji `92e539af40d8-83e41104669e` [Unduh datanya ↓](https://phishdestroy.io/tgwitness/validation/snapshot.json) SIGNED AUDIT / ENGLISH ### Check the numbers. The English report includes the measured results, open findings and a reproducible signature check. [Read the report ↗](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)[Signed statement ↓](https://phishdestroy.io/tgwitness/validation/audit/PROOF.json)[Measurements CSV ↓](https://phishdestroy.github.io/TgWitness/validation/audit/MEASUREMENTS.csv)[Python verifier ↓](https://phishdestroy.github.io/TgWitness/validation/audit/VERIFY.py)[File checksums ↓](https://phishdestroy.io/tgwitness/validation/audit/SHA256SUMS.txt) The signature binds the report and its measurements to the audit key; a change to any signed file fails VERIFY.py. The report records the completed audit at 19:08 UTC; the infrastructure snapshot above was taken earlier. **Ringkasan tanda terima sumber** Hash-hash ini mengidentifikasi tanda terima yang telah ditandatangani dan disimpan dari hasil pengukuran tersebut; salinan asli yang bersifat rahasia disimpan oleh pengelola. - benchmark-1.json`66cdf2db25901ee1f780a0e2d14b9b84888dbe525bff73bae19819b217f95d0c` - benchmark-2.json`ad2978fe2a7563476da43293eaaf5f498ee12522f0ea3e401bc43205c64874d1` - test-totals.json`922cf87d9320b149f2fc6791fc05f98335ec0952f9258e6eaeff179aeef33bb1` - infra-summary.json`325d390ef752b15f44203f97348863e24f0f631fe88998d5e1f398a5311a9339` Setiap gambar mencantumkan nomor revisinya, beban kerja, dan lingkungannya. Pengukuran yang tidak dilakukan ditampilkan sebagai data yang hilang. --- # TgWitness: Telegram Export, OSINT & Verification Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/ Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/llms.txt) Instal dengan satu perintah atau jalankan di GitHub Actions. Pahami opsi investigasi, skala yang dipublikasikan, dan apa yang diverifikasi oleh arsip. TgWitness adalah eksportir Telegram dan ruang kerja investigasi sumber terbuka. Instal dengan satu perintah, hubungkan akun, pilih obrolan, dan ekspor arsip yang telah ditandatangani . Alat ini juga mendukung pengumpulan sementara di GitHub Actions serta kelanjutan investigasi dengan penyimpanan suntingan, catatan penghapusan, pencarian, dan laporan. ## Mulailah dengan tugas yang Anda miliki | Tugas Anda | Jalur terpendek | Apa yang Anda terima | | --- | --- | --- | | Simpan percakapan atau akun | Instal, hubungkan akun, pilih cakupan ekspor | Arsip yang ditandatangani berisi riwayat yang dipilih, hasil pengumpulan, dan materi verifikasi | | Kumpulkan pada runner sementara | Gunakan GitHub Actions untuk menangkap data, otorisasi sesi baru, dan pilih cakupan | Arsip terenkripsi dengan riwayat alur kerja GitHub | | Ikuti perubahan dari waktu ke waktu | Pertahankan pengamatan agar tetap berjalan untuk obrolan yang dipilih | Versi yang disimpan, pemberitahuan penghapusan, lampiran, dan cakupan yang terekam | | Selidiki dan bagikan temuan | Cari di arsip, gunakan Case Board, dan konfigurasikan laporan atau salinan untuk dibagikan | Temuan yang tertaut ke sumber dan penyerahan yang dapat diverifikasi yang sesuai untuk penerima | ### Instalasi dengan satu perintah Penginstal mencakup Python dan dependensinya. Pengunduhan kode sumber, Docker, penyedia AI, dan saksi independen merupakan pilihan opsional, bukan prasyarat penginstalan. Linux / macOS: ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Windows, di PowerShell atau Command Prompt: ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Buka panel, hubungkan akun Telegram Anda, dan pilih cakupan pengumpulan data. Proses instalasi tidak secara otomatis memulai pengumpulan data. Panduan instalasi menjelaskan akses lokal, server, pembaruan, dan cara memeriksa build yang telah diunduh. Untuk menjalankan alat ini sementara, ikuti [Penangkapan GitHub Actions](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). Alur kerja tersebut memerlukan fork GitHub, otorisasi, dan kata sandi arsip. Halaman penangkapan menjelaskan langkah-langkah tersebut serta batas waktu sesi sebelum eksekusi. Unduh dan simpan arsip hasil serta materi verifikasinya. ## Pengaturan tambahan jika diperlukan untuk tugas ini Ekspor obrolan tunggal memerlukan akun dan cakupan yang dipilih. Pemantauan berkelanjutan, beberapa akun, proxy, kebijakan lampiran, desain laporan, akses peninjau, cap waktu eksternal, dan penyimpanan di luar situs memenuhi berbagai kebutuhan investigasi dan penyerahan. Konfigurasikan fitur-fitur tersebut jika relevan. Cakupan, izin, dan salinan berbagi yang diminimalkan membantu operator memilih apa yang akan dikumpulkan dan diungkapkan. Panduan yurisdiksi dan pengaturan laporan mencatat prosedur yang dipilih serta langkah-langkah persiapan. Lihat [ekspor akun](https://phishdestroy.io/tgwitness/id/docs/reference/account-export/), [akses,](https://phishdestroy.io/tgwitness/id/docs/reference/access/) dan [konfigurasi laporan](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/). Aplikasi ini berjalan di komputer atau server yang dipilih. Pengumpulan dasar tidak memerlukan GPU atau LLM. OCR opsional, transkripsi, dan analisis AI memiliki persyaratan sumber daya tersendiri. Sesuaikan skala penerapan dengan laju pesan, lampiran, riwayat yang disimpan, dan akun yang aktif secara bersamaan. ## Pertahankan catatan ini, siapa pun yang diuntungkan darinya Tujuannya adalah untuk melestarikan materi yang diamati, konteks, dan perubahannya terlepas dari posisi siapa pun yang didukungnya. Bukti mungkin bertentangan dengan penjelasan pengumpul sendiri tentang peristiwa tersebut. Pastikan pengamatan sumber, cakupan yang terlewat, dan kesimpulan analitis tetap dapat diidentifikasi sehingga orang lain dapat menilai materi yang sama. Logikanya adalah: pengamatan yang terlihat di akun → jurnal yang ditandatangani → ekspor → verifikasi penerima. Pengeditan yang disimpan menambah versi. Penghapusan pengamatan tetap mempertahankan konten yang sebelumnya ditangkap. Catatan cakupan menunjukkan gangguan yang diketahui. Laporan dan analisis AI merujuk kembali ke sumber yang disimpan; sebuah interpretasi tidak menjadi pengamatan sumber hanya karena muncul dalam laporan yang ditandatangani. | Pemeriksaan verifikasi | Apa yang dapat dipastikan oleh penerima | | --- | --- | | Hash file, tanda tangan, dan rantai jurnal | Catatan dan berkas yang disediakan sesuai dengan batas kunci dan jurnal yang diharapkan | | Titik pemeriksaan atau saksi yang disimpan secara terpisah | Arsip ini sesuai dengan status jurnal yang disimpan sebelumnya | | Cap waktu eksternal yang terverifikasi | Byte yang dirujuk telah ada pada waktu yang ditandai berdasarkan asumsi kepercayaan yang disebutkan | | Pengesahan penangkapan GitHub | Arsip tersebut sesuai dengan alur kerja yang disetujui, revisi pengumpul, dan ringkasan yang tercatat | | Pengesahan Intel TDX | Kutipan, status platform, pengukuran OS/aplikasi yang diharapkan, keaktualan, dan identitas pengumpul telah lulus pemeriksaan yang telah dikonfigurasi | Dalam akuisisi yang terverifikasi, koneksi Telegram yang diautentikasi dari pengumpul yang disetujui serta outputnya terikat pada lingkungan eksekusi yang telah diperiksa. Arsip menyimpan konten dan konteks yang ditangkap; laporan dan analisis merujuk kembali ke catatan-catatan tersebut. Gunakan langkah-langkah verifikasi khusus mode dan masukan tepercaya yang tercantum dalam [panduan kepercayaan](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) dan [format bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/). ## Skala yang dipublikasikan dan kinerja yang diukur Hasil berikut ini menggambarkan beban kerja dan tanggal yang berbeda. Jumlahnya tidak dapat dipertukarkan: sebuah peristiwa jurnal tidak selalu sama dengan pesan Telegram yang unik. | Tanggal | Beban kerja | Hasil yang diterbitkan | Apa yang diukur | | --- | --- | --- | --- | | 1 November 2026 | Server yang sedang berjalan, sepuluh basis data ruang kerja | Catatan jurnal 1,610,818; peristiwa pesan baru 900,232, peristiwa pengeditan 80,683, dan peristiwa penghapusan 400,536 | Inventaris jurnal yang disimpan yang hanya dapat dibaca | | 5 November 2026 | Cari di antara pesan sintetis 1,000,000 dalam obrolan 200 | Indeks dibangun dalam 71 detik; waktu pencarian median per kueri sebesar 9–190 ms | Uji kinerja pencarian lokal | | 6 November 2026 | Dua ekspor Telegram terbaru yang asli | Pesan 27,030 dan 29,299; 56,329 pada kedua kali pengujian | Dua akun per proses melalui WARP, teks dan metadata, tanpa unduhan lampiran | | 6 November 2026 | Dua ekspor yang sama, termasuk persiapan dan pengemasan | 127.713 dan 141.781 pesan per detik | Tingkat ekspor lengkap yang diukur; kedua arsip telah diverifikasi menggunakan kunci yang disematkan | [Catatan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/verification/) memberikan inventaris server, pemeriksaan pengumpulan secara langsung, dan pengukuran pencarian. [Kinerja ekspor](https://phishdestroy.io/tgwitness/docs/validation/) mempublikasikan dua proses eksekusi nyata, perangkat keras, durasi, hash arsip, dan file pengukuran yang ditandatangani, masing-masing dengan revisi dan kondisinya yang tercatat. [Kualifikasi riwayat publik](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) juga mencatat **48 arsip terverifikasi dengan 3,598,381 catatan** di seluruh daftar masukan 50 sumber dan 40 ruang kerja akun. Sumber A dengan delapan akun memperoleh **768,007 catatan riwayat dalam 1,117.082 detik**, termasuk waktu tunggu: **687.512 catatan per detik**, dengan unduhan lampiran dinonaktifkan. Upaya lengkap, termasuk validasi, memakan waktu 1,574.920 detik. Pengukuran ini menggambarkan beban kerja tersebut, bersama dengan contoh ekspor baru yang lebih kecil di atas. ### Riwayat pengujian dan durasi TgWitness telah dikembangkan dan diuji selama sekitar enam bulan. Pengumpul, jurnal yang ditandatangani, dan verifikator dibuat terlebih dahulu; panel web dan modul tambahan dibangun di atasnya kemudian. Repositori ini dibuat baru pada 29 Oktober 2026 untuk publikasi dan dimulai dengan kode yang sudah ada, sehingga usianya tidak sama dengan usia proyek ([riwayat pengembangan](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)). Beban kerja kumulatif yang telah dijalankan mencapai sekitar 100 juta, termasuk eksekusi sebelumnya, kegagalan, perbaikan, dan validasi berulang. Eksekusi terpilih, masing-masing dengan revisi, metode, dan hasilnya sendiri, didokumentasikan dalam [pengukuran publik yang diberi tanggal](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements). ## Baca status kemampuan secara tepat Nilai setiap alur kerja berdasarkan implementasinya, build yang dipublikasikan, dan pengujian yang tercatat. Sumbernya saat ini diberi label pratinjau. Label rilis tersebut ada bersamaan dengan koleksi yang berfungsi, ekspor, verifikasi independen, dan pengukuran skala yang dipublikasikan. Fitur pratinjau dan alur kerja yang tervalidasi dapat ada dalam aplikasi yang sama; jelaskan fitur spesifik dan bukti di balik penilaian tersebut. Gunakan [kemampuan saat ini](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [fitur dan batasan](https://phishdestroy.io/tgwitness/id/docs/reference/features/), [verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/verification/) dan [catatan perubahan](https://phishdestroy.io/tgwitness/id/docs/reference/changelog/) bersama-sama. Catat revisi yang diuji saat mengutip hasil. 6 Snapshot pengukuran bulan November juga menyimpan tes yang gagal dan dilewati; tes-tes tersebut tidak dianggap lulus. ## Dapat dibaca oleh manusia dan alat AI Situs web ini menyediakan `llms.txt` yang ringkas, buku panduan lengkap dalam bahasa Inggris pada `llms-full.txt` dan `llms-full.md`, serta edisi Markdown dari halaman-halamannya. Ini adalah format dokumentasi, bukan persyaratan AI untuk menjalankan TgWitness. Akses baris perintah opsional [MCP](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/) dan memungkinkan alat yang berwenang membaca catatan tersimpan yang dipilih. Isi pesan tetap merupakan masukan yang tidak dapat dipercaya. Ringkasan harus mencantumkan sumber, membedakan fakta yang diamati dari kesimpulan, dan mempertahankan ketidakpastian. Pencarian teks lengkap, OCR, dan hasil AI tidak mengubah pengamatan asli yang telah ditandatangani. --- # Telegram · Panduan cepat Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/ Semua cara untuk menginstal dan menjalankan TgWitness: paket Windows, Python, Docker, dan demo sintetis, beserta pemeriksaan awal. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Semua cara untuk menginstal dan menjalankan TgWitness: paket Windows, Python, Docker, dan demo sintetis, beserta pemeriksaan awal. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Memulai](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) **Bahasa Inggris** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [Ukraina](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [Português (Brasil)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [Bahasa Turki](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [العربية](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [Urdu](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [Hindi](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [Bahasa Indonesia](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [Bahasa Vietnam](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [Bahasa Mandarin (Sederhana)](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md) TgWitness adalah aplikasi mandiri untuk memantau grup dan saluran Telegram yang dapat diakses oleh akun Anda. Aplikasi ini berjalan secara lokal dengan direktori data tersendiri. **Pertama kali berkunjung?** [Jelajahi demo](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/#explore-the-interface) sebelum menghubungkan akun. [Pilih panduan](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) untuk proxy, saksi, ekspor, atau pengaturan server. [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) (pratinjau) menjalankan proses penangkapan di fork GitHub Anda sendiri, bukan di instalasi lokal. ## Instal dan mulai Penginstal terpandu ini menyertakan Python-nya sendiri dan memeriksa hash paket serta tanda tangan rilis sebelum menginstal. Menjalankannya kembali akan memperbarui instalasi yang sudah ada. **Linux / macOS:** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` **Windows (PowerShell atau Command Prompt):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Di server Ubuntu, jalankan sebagai root untuk menginstal layanan latar belakang; di desktop, jalankan sebagai pengguna biasa. Di Ubuntu, penginstal menampilkan alamat panel dan kunci akses; di macOS dan Windows, panel lokal terbuka di browser Anda. Lanjutkan ke bagian **Hubungkan Telegram** di bawah ini. Bagian [Instal, verifikasi, dan perbarui](https://phishdestroy.io/tgwitness/id/docs/reference/installation/) mencakup pilihan akses server, pemeriksaan skrip sebelum dijalankan, pembaruan, dan penghapusan. ### Metode lain Rilis GitHub, kode sumber, dan Docker merupakan alternatif dari penginstal. Unduhan portabel tersedia setelah build rilis diterbitkan: | Host | Tidak ada yang diinstal | Dari sumber: Python 3.11+ | Docker: Engine/Desktop dengan Compose 2.20+ | | --- | --- | --- | --- | | Windows | Ekstrak `TgWitness--windows-amd64-portable.zip` dari GitHub Releases, klik dua kali `TgWitness.cmd` | Klik dua kali `Start.cmd` | Klik dua kali `scripts\Docker.cmd` | | Linux / macOS | — | `sh start.sh` | `sh scripts/docker-start.sh` | Untuk metode kode sumber, [unduh dan ekstrak `main` saat ini](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) atau kloning repositori: ``` git clone https://github.com/phishdestroy/TgWitness.git cd TgWitness ``` `Start.cmd` menawarkan untuk menginstal Python 3.12 bagi pengguna Windows Anda jika tidak ditemukan Python yang sesuai (winget, atau penginstal python.org bertanda tangan). `start.sh` mencetak perintah instalasi yang tepat untuk distribusi Linux atau macOS Anda jika Python belum ada. Peluncuran kode sumber pertama akan membuat `.venv` dan menginstal dependensi secara otomatis. Docker membangun aplikasi dan menjalankannya di latar belakang; Python di host tidak diperlukan. `scripts\Docker.cmd` dan `scripts/docker-start.sh` menampilkan alamat panel dan token saat kontainer dalam kondisi baik. Perintah Docker yang setara di setiap host yang didukung adalah: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Buka **http://127.0.0.1:8787**. Gunakan token yang dicetak oleh Docker helper atau perintah Docker kedua, atau baca **berkas data/live/panel-token.txt** untuk instalasi portabel atau dari sumber. Lanjutkan ke bagian "**Connect Telegram"** di bawah ini. Instalasi native dan Docker menggunakan penyimpanan terpisah; menjalankan Docker tidak akan mengimpor jurnal native yang sudah ada. Untuk server, [proses penerapan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) mencakup HTTPS otomatis, restart, publikasi gambar, pembaruan, dan pencadangan. ## Jelajahi antarmuka 1. Jalankan **TgWitness-Demo.cmd** dalam paket portabel, **scripts\Demo.cmd** di folder sumber Windows, atau `sh start.sh --demo` di Linux/macOS. Peluncuran dari folder sumber akan terlebih dahulu membuat `.venv` dan menginstal dependensi. 2. Buka **http://127.0.0.1:8787**. 3. Demo lokal akan membuka jurnal contoh secara otomatis. Tidak diperlukan salinan token untuk akses lokal langsung. Pesan demo bersifat fiktif. Mode demo tidak dapat terhubung ke akun Telegram yang sebenarnya. ## Hubungkan Telegram > [!PERINGATAN] **Gunakan akun khusus.** Telegram dapat membatasi atau memblokir akun secara permanen karena volume permintaan yang dianggap berlebihan, apa pun kliennya. Hubungkan akun yang disiapkan untuk pengamatan, bukan akun pribadi atau yang berharga, dan buat ID API / hash pada akun khusus. 1. Jika demo bawaan sedang berjalan, hentikan dan jalankan **Start.cmd** atau `sh start.sh`. Jika tidak, biarkan instalasi langsung yang telah dijalankan di atas tetap berjalan. 2. Gunakan token panel untuk masuk. Ruang kerja baru akan terbuka [pada pengaturan awal](https://phishdestroy.io/tgwitness/id/docs/reference/settings/). Pilih **Hanya unduh**, **Ikuti obrolan**, atau **Bukti untuk suatu kasus**. 3. Periksa pengaturan koneksi. Konfigurasikan proxy Anda sendiri jika diperlukan; pengaturan koneksi tetap tersedia setelah penyiapan. 4. Di **Connect Telegram**, pilih nomor telepon, kode QR, berkas akun (TData, `.session`, StringSession, JSON akun), atau kunci otorisasi lengkap. Lengkapi konfirmasi Telegram, kode, dan kata sandi dua langkah saat diminta. 5. Periksa akun yang ditampilkan, pilih obrolan, dan tinjau pengaturan Anda. Selesaikan dari layar terakhir. Untuk **opsi Hanya unduh**, **Mulai ekspor** akan memulai proses ekspor satu kali dan membuka halaman Ekspor untuk menampilkan kemajuannya; opsi ini tidak mengaktifkan pemantauan berkelanjutan. Setelah pengaturan, **Chats → Choose** mengubah obrolan yang dipilih. **Pengaturan** mengontrol pengumpulan dan berkas; **More tools → Sources** menyediakan daftar sumber terperinci pada tingkat Standard atau Expert. [Panduan panel](https://phishdestroy.io/tgwitness/id/docs/reference/panel/) menjelaskan enam bagian utama dan kontrol kontekstualnya. **API ID + Hash** bersifat opsional: ruang kerja menggunakan pasangan yang disimpan atau diimpor, atau pasangan yang aktif dari kumpulan bawaan. Untuk menggunakan aplikasi Anda sendiri, tempelkan satu pasangan `API ID:API Hash` ke kolom API ID. Untuk **Kunci Otentikasi**, tempelkan seluruh 512 karakter heksadesimal dan pilih DC ID yang disediakan. ID Pengguna bersifat opsional dan akan diverifikasi jika dimasukkan. Kredensial API mengidentifikasi aplikasi Anda; kredensial tersebut tidak secara otomatis memberikan otorisasi atas akun. Grup pribadi tidak memerlukan nama pengguna publik, tetapi akun Anda harus memiliki akses. Untuk akun yang sudah ada, lihat [format akun dan sesi](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/): panel ini mendukung Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP akun tunggal, dan file JSON akun yang didukung. Pilih sesi beserta file JSON-nya secara bersamaan, tekan **Periksa file**, lalu **Hubungkan akun**. Masuk melalui QR juga tersedia dengan pengaturan API opsional yang sama. TDLib, sesi bot, dan inventaris akun CSV/JSON tidak didukung. Untuk beberapa akun, gunakan **Akun → Impor akun** dan pilih file sesi yang didukung. File JSON pendamping dipasangkan berdasarkan nama dasar (basename); setiap akun yang diimpor mendapatkan ruang kerjanya sendiri. Lihat [impor massal dan grup akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#bulk-import-and-account-groups). Untuk menambahkan akun lain, tekan **+** di samping pemilih akun atau gunakan **Akun → Tambahkan akun**. Ruang kerja memiliki sesi, jurnal, kunci, sumber, dan antrian yang terpisah. Beralih antar tampilan tidak menghentikan pengumpul lainnya. Akun Telegram yang sama tidak dapat ditugaskan ke dua ruang kerja dalam instalasi ini. Tidak ada batasan jumlah ruang kerja; mereka berbagi satu proses, sehingga kapasitas bergantung pada mesin. Token panel langsung melindungi akses ke otorisasi Telegram dan materi yang disimpan Anda; token ini terpisah dari kredensial API Telegram. Hanya demo lokal yang secara eksplisit dijalankan dan diakses secara langsung yang mendapatkan akses otomatis. Demo jarak jauh/proksi tetap menggunakan `data/demo/panel-token.txt`. ## Tinjau dan ekspor - **Jurnal:** cari dan saring pengamatan berdasarkan sumber dan jenis peristiwa. - Pilih suatu peristiwa untuk memeriksa catatan aslinya, atribusi, dan versi yang disimpan. - Rincian pengeditan menampilkan konten sebelum dan sesudah yang tersedia. Rincian penghapusan menampilkan konten terakhir yang terekam, jika ada; pelaku yang tidak dikenal tetap tidak diketahui. - **Format ekspor:** ZIP yang ditandatangani, JSONL, CSV, dan HTML offline. - **Ekspor obrolan lengkap** (**Obrolan → Ekspor obrolan**, atau **Ekspor → Tangkap atau ekspor satu obrolan**): unduh seluruh riwayat yang terlihat dari satu obrolan sebagai bundel yang ditandatangani dengan `chat.json` (gaya ekspor Telegram) dan berkas `chat.html` yang dapat dibaca. Obrolan pribadi berfungsi jika akun tersebut merupakan anggota. Ini adalah cuplikan saat ini, bukan rekonstruksi pesan yang dihapus atau diedit sebelumnya. Verifikasi salinan dengan `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256`. - **Simpan titik pemeriksaan:** jaga agar batas jurnal yang ditandatangani tetap berada di luar pengumpul. - **Unduh tanda terima eksekusi yang ditandatangani:** simpan catatan program/versi pengumpul. - **Siapkan permintaan cap waktu:** siapkan permintaan offline kepada otoritas cap waktu; ikuti panduan di [TIMESTAMP.md](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/) untuk memperoleh dan memverifikasi respons. - **Verifikasi jurnal:** periksa tanda tangan peristiwa dan tautan rantai. Ekspor ZIP juga memeriksa media. Browser yang didukung dapat menyimpan ekspor berukuran besar langsung ke file yang dipilih. Browser lain hanya dapat menyimpan dalam buffer maksimal 128 MiB. Selama server berjalan, CLI streaming mendukung unduhan berukuran lebih besar tanpa perlu menyimpan seluruh respons dalam buffer: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Untuk ruang kerja lain, tambahkan `--profile ID` menggunakan **Ekspor → ID Ruang Kerja**. Untuk server jarak jauh, tambahkan `--url https://your-server`. Batas transfer default adalah 5 GiB; `--max-mib` mengubahnya. Konten ZIP yang ditandatangani memiliki batas verifikasi terkompresi terpisah sebesar 4 GiB secara default (**More tools → Parameters** menaikkannya; verifikasi arsip semacam itu dengan `verify.py --max-gib N`). Verifikasi arsip menggunakan salinan verifier yang tepercaya, sidik jari kunci yang disimpan secara independen, dan, sebagai bukti minimal, sertifikat akar otoritas cap waktu (`--tsa-ca`). ## Periksa proses instalasi ``` python start.py --setup-only python start.py --check python start.py --check --json ``` `--check` memeriksa dependensi lokal, dukungan penandatanganan, penyimpanan, konfigurasi kunci, dan alamat pendengar. Alat ini tidak menginstal apa pun atau terhubung ke Telegram. Port yang sedang digunakan mungkin menandakan adanya instance lain yang sedang berjalan. Gunakan `--port` yang berbeda atau hentikan instance tersebut terlebih dahulu. Launcher diinstal ke `.venv`. Perintah tambahan `python -m tgwitness...` harus menggunakan `.venv\Scripts\python.exe` di Windows atau `.venv/bin/python` di Linux/macOS, kecuali jika lingkungan tersebut sudah diaktifkan. ## Sesi, perlindungan, dan pengoperasian Sebuah `.session` Telethon SQLite yang tertutup dan konsisten dapat dikonversi secara lokal dengan `python -m tgwitness.sessions account.session --out account.tgwitness-session`, kemudian dimuat di **More tools → Account → Files**. Impor berkas langsung dan login QR juga tersedia. Lihat [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) untuk format login, SOCKS5, HTTP CONNECT, MTProxy, dan kunci utama eksternal. **Menjeda pengamatan** akan menghentikan pengumpulan data. **Mengunci** hanya menutup akses browser. Menutup tab tidak menghentikan proses pengumpul data. Menghentikan proses akan menghentikan pengumpulan data; cuplikan riwayat tidak dapat merekonstruksi semua pengeditan atau penghapusan yang terlewatkan. Lihat [cara kerja pengumpulan data](https://phishdestroy.io/tgwitness/id/docs/reference/collection/) terkait kebijakan peristiwa, antrian lampiran, isolasi akun, dan perilaku saat dimulai ulang. Sesi dan rahasia dienkripsi. Isi pesan, media, dan ekspor memerlukan disk atau volume terenkripsi. Verifikasi tanda tangan jurnal terhadap kunci tepercaya dan simpan titik pemeriksaan secara terpisah. Tinjau catatan penangkapan, bukti waktu eksternal, dan pernyataan lingkungan untuk mode pengumpulan yang dipilih. Baca [OPERATIONS.md](https://phishdestroy.io/tgwitness/id/docs/reference/operations/) untuk pencadangan/pemulihan, [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) untuk hosting, dan [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) untuk contoh layanan. Panel yang telah diinstal juga menyertakan panduan pengaturan offline di `/guide.html`. Verifikasi aktual dan batasan yang masih ada dicatat dalam [berkas VERIFICATION.md](https://phishdestroy.io/tgwitness/id/docs/reference/verification/) dan [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md). --- # Instal, verifikasi, dan perbarui Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/installation/ Instal dengan satu perintah, periksa tanda tangan dan hash, perbarui, dan hapus instalasi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Instal dengan satu perintah, periksa tanda tangan dan hash, perbarui, dan hapus instalasi. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Memulai](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/) ![Memulai](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Proyek](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [Panduan cepat](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/) · [Penerapan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) **Di halaman ini** - [Instal dengan satu perintah](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#install-with-one-command) - [Tempat segalanya berjalan](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#where-everything-runs) - [Pengaturan pencarian teks lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#full-text-search-settings) - [Akses baris perintah](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#command-line-access) - [Verifikasi sebelum menjalankan](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#verify-before-running) - [Perbarui instalasi yang sudah ada](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#update-an-existing-installation) - [Perintah sehari-hari di Ubuntu](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#everyday-commands-on-ubuntu) - [Hapus TgWitness](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#remove-tgwitness) ## Instal dengan satu perintah Layanan unduhan resmi proyek ini, `get.destroy.tools`, menyediakan penginstal berpanduan dan berkas rilisnya yang telah ditandatangani. Layanan ini mencakup runtime Python pribadi dan memverifikasi hash paket serta tanda tangan rilis sebelum instalasi. Setiap publikasi memperbarui skrip entri, hash, tanda tangan, dan informasi build secara bersamaan; setiap build juga memiliki URL rilis yang tidak dapat diubah. Pilih penginstal terpandu untuk pengaturan singkat, atau gunakan [rilis GitHub, kode sumber, atau Docker](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/) . Ini adalah jalur instalasi yang didukung untuk proyek sumber terbuka yang sama. Untuk penerapan yang memerlukan persetujuan build yang tepat sebelum eksekusi, gunakan [Verifikasi sebelum menjalankan](https://phishdestroy.io/tgwitness/id/docs/reference/installation/#verify-before-running) dengan sidik jari kunci rilis yang disimpan secara independen dan URL build yang tidak dapat diubah . Memperbarui layanan unduhan tidak akan memperbarui panel yang telah terinstal secara otomatis. **Linux / macOS (Bash):** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Di server Ubuntu, jalankan sebagai root untuk menginstal layanan latar belakang. Di desktop, jalankan sebagai pengguna biasa. **Windows (PowerShell atau Command Prompt):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Tidak diperlukan administrator di Windows. Proses PowerShell anak akan membiarkan terminal Anda tetap terbuka dengan hasilnya. Python dan dependensinya tetap berada di dalam instalasi. Di Ubuntu, pilih **"Komputer ini**", **"Tautan HTTPS sementara"**, atau "**Domain sendiri**". Penginstal akan menampilkan alamat panel dan kunci akses. Untuk tautan sementara, buka alamat HTTPS tersebut di browser Anda dan masukkan kuncinya. Untuk akses lokal pada server jarak jauh, gunakan pengalihan SSH dari komputer Anda (`ssh -L 8787:127.0.0.1:8787 user@server`) dan buka `http://127.0.0.1:8787`. Di macOS dan Windows, panel lokal akan terbuka di browser Anda; biarkan terminalnya tetap berjalan. Masuk ke Telegram di panel dan pilih apa yang ingin dikumpulkan. Instalasi saja tidak akan memulai pengumpulan data Telegram. ## Tempat semuanya berjalan `get.destroy.tools` adalah **Cloudflare Worker yang melayani unduhan statis**. Alat ini tidak memiliki panel TgWitness, sesi Telegram, atau basis data bukti pengguna. Alat ini tidak diarahkan ke VPS proyek. Aplikasi ini berjalan di mesin tempat Anda menjalankan perintah tersebut. | Instalasi | Program | Data | | --- | --- | --- | | Ubuntu sebagai root | `/opt/tgwitness` | Layanan sistem: `/var/lib/tgwitness-`; gunakan `tgwitness paths` untuk jalur yang tepat. | | Pengguna Linux / macOS | `~/.local/share/tgwitness` | `data/live` di bawah instalasi tersebut. | | Pengguna Windows | `%LOCALAPPDATA%\TgWitness` | `data\live` di bawah instalasi tersebut. | Pilih `TGWITNESS_INSTALL_DIR` untuk memilih folder lain. Versi yang terinstal dan datanya terpisah. Penginstal tidak mengunggah akun, pesan, atau kunci Anda ke situs unduhan. Memilih terowongan Cloudflare akan mengarahkan lalu lintas panel melalui Cloudflare; menggunakan domain Anda sendiri akan mengarahkannya ke server Anda sendiri. Dengan `TGWITNESS_TRUSTED_PROXIES`, panel menerima satu `X-Forwarded-Proto: https` dari proxy tepercaya untuk mengatur cookie unduhan aman. Setiap instalasi mencakup berkas **START-HERE.html** dan **START-HERE.txt**, yang berisi jalur lokal, perintah, dan tautan ke repositori. Jalankan `tgwitness guide` untuk membuka panduan. Di Windows, gunakan `& "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide` di PowerShell. ## Pengaturan pencarian teks lengkap [Pencarian teks lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/search/) (pratinjau) tidak memerlukan pengaturan. Indeksnya dibangun di latar belakang setelah pembaruan. | Variabel atau perintah | Efek | | --- | --- | | `TGWITNESS_FULLTEXT=disk` | Secara default: indeks disimpan di `search/fulltext.sqlite3` setiap ruang kerja | | `TGWITNESS_FULLTEXT=memory` | Tidak ada berkas indeks; indeks dibangun ulang setiap kali aplikasi dimulai | | `TGWITNESS_FULLTEXT=off` | Tanpa indeks; hanya pencarian teks persis | | `tgwitness index status` | Indeks status setiap ruang kerja | | `tgwitness stop`, `tgwitness index rebuild`, `tgwitness start` | Bangun ulang setiap indeks dari jurnal yang ditandatangani | Pilihan administrator di **Jurnal → Filter → Indeks Pencarian** akan menggantikan variabel untuk ruang kerja tersebut. Perintah akan mencari direktori data dari instalasi yang menjalankannya; di tempat lain, tambahkan `--data-dir` dengan jalur dari `tgwitness paths`. Untuk kamus bahasa Ukraina lengkap (data GPL-3.0), instal `pymorphy3-dicts-uk` di lingkungan Python instalasi tersebut. ## Akses baris perintah [Baris](https://phishdestroy.io/tgwitness/id/docs/reference/cli/) [perintah](https://phishdestroy.io/tgwitness/id/docs/reference/cli/) (pratinjau) membaca arsip untuk skrip dan agen. | Variabel | Efek | | --- | --- | | `TGWITNESS_URL` | Alamat panel untuk `tgwitness search`, `context`, `messages`, `stats` dan `export`; default `http://127.0.0.1:8787` ketika token telah ditetapkan | | `TGWITNESS_MCP_TOKEN` | Simpan token koneksi dari **More tools → Integrations → MCP**, yang dibagikan dengan klien MCP; `--token-file` membacanya dari berkas sebagai gantinya | | `TGWITNESS_DATA` | Direktori data dibaca secara langsung jika tidak `--data-dir`, URL, atau token yang diberikan | ## Verifikasi sebelum dijalankan Penginstal menyematkan kunci publik rilis proyek dan memeriksa tanda tangan SHA-256 dan RSA pada paket aplikasi serta kunci dependensi sebelum menginstalnya. Baik Bash maupun PowerShell akan berhenti jika pemeriksaan yang diperlukan gagal. Skrip awal dikirim melalui HTTPS dan memiliki tanda tangan terpisah; perintah di bawah ini juga memungkinkan Anda memverifikasi skrip tersebut sebelum menjalankannya. Kunci rilis publiknya adalah [release-signing.pub](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/release-signing.pub). SHA-256-nya adalah: ``` 039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d ``` Simpan sidik jari ini dari revisi repositori yang Anda percayai. Checksum dari server unduhan yang sama akan mendeteksi ketidaksesuaian; kunci publik yang tepercaya secara independen adalah yang mengautentikasi tanda tangan rilis. Gunakan direktori baru yang kosong untuk mengunduh berkas verifikasi di bawah ini. **Linux / macOS — jalankan di direktori unduhan baru yang kosong** (memerlukan curl dan OpenSSL): ``` curl -fSLO https://get.destroy.tools/install.sh && curl -fSLO https://get.destroy.tools/install.sh.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh && bash install.sh ``` Rantai `&&` rantai akan berhenti sebelum eksekusi jika unduhan, sidik jari kunci, atau pemeriksaan tanda tangan gagal. Jika terjadi publikasi baru antara saat mengunduh skrip dan tanda tangannya, unduh keduanya kembali. Penginstal lama tetap mempertahankan URL paketnya yang tidak dapat diubah. **Windows — periksa SHA-256 sebelum menjalankannya:** ``` Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing Get-FileHash .\install.ps1 -Algorithm SHA256 Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt ``` Bandingkan hash tersebut dengan `install.ps1` baris tersebut. Untuk pemeriksaan tanda tangan secara independen, gunakan OpenSSL (misalnya, dari Git Bash) dan sidik jari kunci publik yang sama di atas: ``` curl -fSLO https://get.destroy.tools/install.ps1 && curl -fSLO https://get.destroy.tools/install.ps1.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 && powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1 ``` Instalasi Windows sendiri memverifikasi tanda tangan paket dengan .NET dan tidak memerlukan OpenSSL. Ini adalah tanda tangan RSA-3072 / SHA-256 yang terpisah, bukan Authenticode. [Manifest](https://get.destroy.tools/manifest.json) mencatat versi perangkat lunak, komit Git yang tepat, ID rilis yang tidak dapat diubah, dan SHA-256 setiap artefak. Halaman tersebut menautkan ke sumber yang sesuai. Manifest dan daftar checksum juga memiliki tanda tangan yang terpisah (`manifest.json.sig` dan `SHA256SUMS.txt.sig`). ## Perbarui instalasi yang sudah ada **Publikasi baru memperbarui situs unduhan; program yang sudah terinstal akan diperbarui saat Anda menjalankan penginstal lagi.** Tidak ada pembaruan tanpa pengawasan atau restart otomatis pada koleksi yang sedang berjalan. Saluran penginstal saat ini adalah **pratinjau**; saluran ini mengikuti build yang telah diterbitkan dan diperiksa dari `main`, yang commit-nya bisa lebih baru daripada rilis GitHub bernomor terakhir. Versi halaman ini berasal dari `pyproject.toml`; commit dan ID build-nya membedakan pembaruan dalam versi pratinjau yang sama. Publikasi dilakukan secara otomatis setelah commit tersebut lulus pemeriksaan aplikasi dan keamanan, serta paket yang ditandatangani telah diautentikasi, diinstal, dan diperiksa di Ubuntu dan Windows. Permintaan pull yang mengubah penginstal juga menjalankan `install.sh` dan `install.ps1` dua kali terhadap salinan lokal situs. Selama pemeriksaan berlangsung, atau jika gagal, perintah yang sama akan terus menginstal build yang telah diperiksa sebelumnya. Manifest build menunjukkan commit mana yang saat ini tersedia; nomor versi sendiri mungkin tetap sama di antara pembaruan pratinjau. Gunakan folder instalasi dan pengguna OS yang sama seperti sebelumnya. Cadangkan seluruh direktori data dengan menghentikan pengumpulan data; `tgwitness paths` mengidentifikasinya. Ekspor yang ditandatangani bukanlah cadangan instalasi yang lengkap. **Instalasi root Ubuntu di `/opt/tgwitness`:** ``` curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start ``` Setelah instalasi berhasil: ``` /opt/tgwitness/bin/tgwitness restart /opt/tgwitness/bin/tgwitness status /opt/tgwitness/bin/tgwitness open ``` Untuk instalasi pengguna Linux/macOS, gunakan `TGWITNESS_INSTALL_DIR` atau pengaturan default, lalu jalankan perintah instalasi pertama sekali lagi. Tutup panel yang sedang aktif sebelum melakukan pembaruan, lalu buka kembali setelahnya. Untuk layanan pengguna Linux yang telah dikonfigurasi , jalankan perintah `tgwitness restart` perintahnya. **Windows:** tutup panel yang sedang berjalan, jalankan perintah instalasi Windows lagi, lalu buka `bin\tgwitness.cmd` di instalasi yang sama. Penginstal menyimpan data, sesi, pengaturan akses, dan kunci penandatanganan. Penginstal hanya akan mengganti peluncur setelah lingkungan baru lulus pemeriksaan; jika instalasi gagal, peluncur sebelumnya akan tetap ada. Simpan cadangan sebelum peningkatan untuk perubahan format penyimpanan. ## Perintah sehari-hari di Ubuntu | Perintah | Hasil | | --- | --- | | `tgwitness open` | URL panel saat ini dan kunci akses. | | `tgwitness paths` | Jalur program, data, dan panduan yang tepat. | | `tgwitness guide --print` | Petunjuk penggunaan dalam mode offline. | | `tgwitness status` / `tgwitness logs` | Ketersediaan / log layanan. | | `tgwitness stop` / `tgwitness start` | Hentikan / lanjutkan layanan; simpan data. | | `tgwitness token rotate` | Ganti kunci administrator dan akhiri sesi browser. | | `tgwitness tunnel off` | Nonaktifkan terowongan cepat publik; pertahankan panel lokal. | | `tgwitness tunnel on` / `tgwitness tunnel restart` | Buat tautan terowongan cepat / ganti alamatnya. | Lihat [bagian Akses](https://phishdestroy.io/tgwitness/id/docs/reference/access/) untuk token rekan kerja, sesi, dan pembatasan IP, serta [publikasi penginstal](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/README.md#automatic-publication-from-github) untuk alur kerja rilis dari GitHub ke Cloudflare. ## Hapus TgWitness Tidak ada program penghapus instalasi: Anda cukup menghentikan panel dan menghapus foldernya. Menghapus folder data akan menghapus jurnal, kunci penandatanganan, sesi Telegram, dan file yang disimpan secara permanen. Sebelum itu: 1. Ekspor apa yang Anda butuhkan (**Ekspor → Unduh ZIP yang telah ditandatangani**) dan simpan sidik jari kunci penandatanganan serta titik pemeriksaan di luar mesin ini. Untuk menyimpan ruang kerja itu sendiri, salin seluruh folder data setelah pengumpulan data dihentikan. 2. Hapus server yang dibuat di bawah **More tools → Extras → Server 24/7** dari bagian **Your servers** atau dengan perintah `python -m tgwitness.cloud destroy`; penyedia layanan akan terus menagih biaya untuk server tersebut hingga dihapus. 3. Akhiri sesi setiap akun di Telegram melalui **Pengaturan → Perangkat**. Menghapus file-file tersebut tidak akan membuat sesi tersebut keluar di sisi Telegram. **Instalasi root di Ubuntu.** Perhatikan folder data, hentikan layanan, lalu hapus layanan, folder, dan pintasan: ``` /opt/tgwitness/bin/tgwitness paths /opt/tgwitness/bin/tgwitness stop systemctl list-unit-files 'tgwitness-*' systemctl disable tgwitness- rm /etc/systemd/system/tgwitness-.service systemctl daemon-reload rm -rf /opt/tgwitness /var/lib/tgwitness- /usr/local/bin/tgwitness ``` **Instalasi untuk pengguna Linux atau macOS.** Tutup panel. Layanan pengguna Linux yang telah dikonfigurasi dihentikan dengan `systemctl --user disable --now tgwitness-`; unitnya berada di `~/.config/systemd/user/`. Kemudian hapus `~/.local/share/tgwitness` (atau `TGWITNESS_INSTALL_DIR`) serta `~/.local/bin/tgwitness` pintasan. **Windows.** Tutup panel dan hapus `%LOCALAPPDATA%\TgWitness` (atau `TGWITNESS_INSTALL_DIR`). Penginstal tidak menambahkan layanan, tugas terjadwal, atau pintasan apa pun. --- # Telegram · Pengaturan awal dan konfigurasi Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/settings/ Wizard pengaturan, tujuan, tingkat antarmuka, rute koneksi, dan pengaturan yang dibagikan oleh sebuah grup akun. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Wizard pengaturan, tujuan, tingkat antarmuka, rute koneksi, dan pengaturan yang dibagikan oleh sebuah grup akun. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Memulai](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/) ![Memulai](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/) · [Koneksi](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) · [Akses](https://phishdestroy.io/tgwitness/id/docs/reference/access/) Ruang kerja baru akan terbuka `/first-run`. Layar pertama menanyakan apa yang ingin Anda lakukan: **Hanya mengunduh**, **Mengikuti obrolan**, atau **Bukti untuk suatu kasus**. Pilihan tersebut menentukan tujuan dan tingkat antarmuka: Sederhana untuk Hanya mengunduh, Standar untuk dua pilihan lainnya. Tingkat tersebut menentukan berapa banyak bidang yang ditampilkan pada setiap formulir; setiap halaman tetap ada di menu. **Opsi tambahan** di layar yang sama secara eksplisit mengatur tingkat antarmuka, tema, dan zona waktu; daftar bahasa terdapat di bagian atas panduan. Layar berikutnya mencakup koneksi, Telegram, dan obrolan. Rute koneksi tetap terlipat selama pemeriksaan otomatis berlangsung dan terbuka jika pemeriksaan gagal. Bilah kemajuan lima tahap akan kembali ke tahap yang telah diselesaikan. Setiap jawaban disimpan di server segera setelah diubah, sehingga memuat ulang halaman akan melanjutkan langkah yang sama. Layar terakhir mencantumkan jawaban-jawaban tersebut dan memungkinkan Anda kembali ke jawaban mana pun. Bahasa, zona waktu IANA, tema, dan tingkat disimpan per operator dan per ruang kerja. Pengaturan defaultnya adalah bahasa browser, zona waktu perangkat, tema sistem, dan antarmuka sederhana. Mengubah bahasa tidak akan memengaruhi sesi panel. Waktu dalam jurnal yang ditandatangani tidak akan pernah berubah. `/settings` mengedit catatan yang sama dengan wizard. Pencarian mencakup bidang utama, parameter, dan formulir tambahan; bidang tersembunyi dapat dibuka tanpa mengubah tingkat. Tingkat hanya mengubah apa yang ditampilkan: server memeriksa izin sendiri. Bagian yang semua pengaturannya berada di atas tingkat yang dipilih tetap menampilkannya. Pengaturan pengumpulan dan koneksi pertama menjadi wewenang administrator ruang kerja. Halaman pengaturan berupa daftar. Kartu akun di atas membuka **Akun Telegram**. Di bawahnya setiap baris menyebut bagian dan nilai yang dipakai: **Chat mana?** dan **Koneksi** di bawah **Akun**; **Tujuan**, **Perekaman dan file**, **Perlindungan rekaman**, dan **Notifikasi dan salinan eksternal** di bawah **Perekaman**; **Bahasa, waktu, dan tampilan** di bawah **Panel**; dan halaman ahli di bawah **Alat lainnya**. Di samping daftar, sebuah kartu menunjukkan apakah nilai yang disarankan aktif, beserta nilai utama dan **Batalkan perubahan terakhir**, sedangkan **Perubahan terbaru** mencantumkan suntingan terbaru. Sebuah bagian akan terbuka dalam jendela di atas daftar dan memiliki alamatnya sendiri, seperti `/settings/connection`. Panah kembali, tombol tutup, tombol Escape, klik di luar jendela, dan tombol Kembali pada browser akan mengembalikan ke daftar. **Pilihan Obrolan mana?** akan disimpan bersama **Simpan pilihan obrolan**; jika ditutup dengan perubahan yang belum disimpan, sistem akan menanyakan konfirmasi terlebih dahulu. Penyimpanan mempertahankan jenis sumber, obrolan yang dikecualikan, tindakan pengguna, dan pengaturan obrolan baru dari **Alat Lainnya → Sumber → Cakupan**; obrolan yang dipilih di sini akan dihapus dari daftar obrolan yang dikecualikan dan dicatat sebagai sumber yang dipilih secara manual. Setiap perubahan menampilkan **opsi Undo** selama 20 detik, dan setiap entri di **Perubahan Terbaru** dapat dibatalkan nanti. Sebuah pembatalan hanya mengembalikan pengaturan yang diubah oleh entri tersebut, termasuk batas file kustom. Jika perubahan selanjutnya memengaruhi pengaturan yang sama, pembatalan akan ditolak dan tidak ada yang berubah. Pembatalan merupakan catatan baru `settings.changed` di jurnal. | Tingkat | Bidang | Sidebar | | --- | --- | --- | | Sederhana | Hanya hal-hal yang penting | Beranda, Obrolan, Jurnal, Ekspor, Akun, dan Pengaturan | | Standar | Pengaturan umum beserta penjelasannya | Menambahkan Papan Kasus, Sumber, Akses, dan Dokumentasi di bawah Alat Lainnya | | Ahli | Semua bidang, batasan, dan detail teknis | Juga menambahkan Peta Sistem, Topologi Jaringan, Ekstra, Tanya Arsip, Parameter, Akun, Log Sistem, dan Integrasi di bawah bagian Alat Lainnya | Nama bagian tetap sama di setiap tingkat. Buka Penampilan di bagian bawah bilah samping untuk mengubah tingkatnya. [Panduan panel](https://phishdestroy.io/tgwitness/id/docs/reference/panel/) menjelaskan setiap bagian. ## Tujuan | Tujuan | Koleksi | Berkas | Layanan eksternal | Alamat server | | --- | --- | --- | --- | --- | | Unduh saja | Ekspor satu kali dimulai dari layar pengaturan akhir; pengumpulan berkelanjutan tetap dinonaktifkan | Foto berukuran hingga 20 MB | Cap waktu | Otomatis | | Ikuti obrolan | Berkelanjutan | Foto dan video berdurasi hingga 60 detik / 20 MB | Cap waktu dan pemberitahuan masalah | Otomatis | | Bukti dalam suatu perkara | Berkelanjutan | Semua berkas berukuran hingga 1 GB | Cap waktu, drand, notifikasi | Tidak, sembunyikan | Salinan di luar platform, bot saksi, dan pemeriksaan kode direkomendasikan sebagai bukti. Alamat penyimpanan dan pemberitahuan memerlukan tujuan terlebih dahulu. Fitur yang terhubung ke layanan eksternal meminta izin untuk mengirim permintaan di luar Telegram; menonaktifkan fitur tersebut juga akan menonaktifkan cap waktu, pemberitahuan, dan salinan di luar platform secara bersamaan. Mengubah target akan menampilkan perbedaannya terlebih dahulu, dan perubahan manual dapat dipertahankan. Bidang yang berbeda dari target akan ditandai **sebagai “Diubah oleh Anda”** dan dapat dikembalikan. Revisi pengaturan mencegah perbedaan yang telah ditinjau diterapkan di atas perubahan yang dibuat di tab lain. ## Koneksi Sampai rute dipilih di sini, ruang kerja baru akan menggunakan **MTProxy Otomatis · daftar publik** dengan opsi **Sembunyikan alamat** ([keamanan koneksi](https://phishdestroy.io/tgwitness/id/docs/reference/connection/)). Pilihan **Otomatis** di bawah ini merupakan langkah pengaturan tersendiri. **Automatic** mencoba WARP, kemudian server MTProxy publik, lalu koneksi langsung, yang terakhir hanya jika alamat server dapat ditampilkan. Automatic dan WARP dapat menginstal komponen yang diperiksa hash-nya dan mendaftarkan server ke Cloudflare; tanpa persetujuan tersebut, Automatic melewati WARP. WARP menggunakan pengelola wgcf/wireproxy yang ada dan port SOCKS5 lokal; tabel perutean sistem tidak diubah. **Impor massal** meminta rute sebelum sesi apa pun mencapai Telegram: WARP (default), MTProxy publik, atau langsung. Pemeriksaan sesi menggunakan jenis rute yang sama, dan setiap akun yang diimpor mendapatkan terowongan WARP-nya sendiri sebelum masuk pertama kali. Proksi Anda sendiri menerima `tg://proxy`, `socks5://`, `http://` dan `https://`. Sertifikat proksi HTTPS diperiksa sebelum kredensial dikirim ke proksi tersebut. Pemeriksaan koneksi berlaku selama lima menit dan terikat pada rute, kebijakan, dan jawaban wizard; mengubah salah satu dari ketiganya memerlukan pemeriksaan baru. Opsi **“Lanjutkan tanpa pemeriksaan”** tersedia dan tidak menggantikan proses masuk ke Telegram. Rute yang dipilih akan diperiksa ulang di latar belakang, dan fitur “Otomatis” akan menjalankan rantai prosesnya kembali setelah koneksi terputus. Jika tidak ada proxy publik yang merespons, hitungan akan berubah menjadi merah disertai tindakan WARP dan pemeriksaan ulang. ## Grup akun Akun-akun dalam sebuah grup berbagi pengaturannya. Buka **Akun → Grup dan pengaturan bersama → Pengaturan bersama**, atau **Pengaturan grup** di halaman Pengaturan akun. Grup ini berbagi tujuan, berkas yang disimpan, cap waktu, drand, pemberitahuan masalah, salinan di luar situs, permintaan di luar Telegram, mode IP, apa yang akan direkam, jadwal pemeriksaan ulang, aturan pemberitahuan, pengaturan laporan, parameter, dan rute koneksi. Tujuan pemberitahuan, kredensial proxy, dan proses masuk tetap per akun, begitu pula pengaktifan dan penundaan pengumpulan data. - Setiap anggota mengikuti grup tersebut. Pengaturan menandai nilai 🔗 **Dari grup** atau ✏️ **Nilai sendiri**; **Kembali ke nilai grup** akan mengembalikannya ke nilai semula. - Sebuah perubahan mencantumkan akun-akun yang terpengaruh (**Berlaku untuk 2 dari 3 akun**) dan meminta konfirmasi per akun sebelum mengganti nilai aslinya. Akun yang tidak dicentang akan mempertahankan nilainya. - Parameter yang tidak dibagikan oleh grup akan tetap berstatus **“Tidak dibagikan”: setiap akun mempertahankan nilainya sendiri** hingga Anda menekan **“Bagikan nilai ini**”. - **Menyalin pengaturan dari satu akun** akan menjadikan nilai-nilai dari akun yang dipilih sebagai pengaturan grup. - Akun yang dipindahkan ke dalam grup akan ditanya**, “Apakah ingin menggunakan nilai-nilai grup ini?”** Jika tidak, akun tersebut akan tetap menggunakan nilai-nilainya sendiri, yang ditandai dengan ✏️. Akun yang ditambahkan kemudian akan mulai menggunakan nilai-nilai grup tersebut. - Sebuah akun pengamat mempertahankan mode IP-nya hingga dihentikan sementara. Setiap perubahan dicatat dalam jurnal yang ditandatangani di ruang kerja utama dan di setiap anggota yang terlibat. Menghapus sebuah grup tidak akan menghapus akun-akun di dalamnya beserta nilai-nilai terkini mereka. Halaman grup `/groups/` menampilkan anggota, hal-hal yang perlu diperhatikan, dan obrolan yang dapat dilihat oleh beberapa akun. Lihat [grup akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#bulk-import-and-account-groups). ## Ruang kerja yang ada Ruang kerja yang sedang dalam sesi atau yang pengaturannya telah diselesaikan sebelumnya tidak menampilkan wizard tersebut. Nilainya tidak diganti oleh tujuan saat halaman dimuat. Menyembunyikan bidang tidak akan menonaktifkan fitur tersebut atau menghapus nilainya. **Membuka pengaturan pertama** di Pengaturan akan menampilkan layar yang sama lagi; menyelesaikannya tidak akan memulai ekspor atau pengamatan baru dan akan menampilkan pesan tersebut, serta pilihan obrolan yang diubah hanya akan disimpan jika Anda memilih **Simpan pilihan obrolan**. Perkiraan ukuran dan waktu mencakup hingga tiga obrolan yang dipilih dan hingga 20 pesan dari masing-masing obrolan. Ini hanyalah perkiraan: perkiraan ini tidak memprediksi batasan Telegram, kecepatan server tertentu, atau file-file dalam setiap obrolan. --- # Telegram · Format akun dan sesi Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/accounts/ Masuk menggunakan nomor telepon, kode QR, atau kunci otentikasi, impor sesi Telethon, Pyrogram, atau Telegram Desktop, dan kelola beberapa akun. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Masuk menggunakan nomor telepon, kode QR, atau kunci otentikasi, impor sesi Telethon, Pyrogram, atau Telegram Desktop, dan kelola beberapa akun. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Memulai](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/) ![Memulai](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) TgWitness masuk sebagai **akun pengguna Telegram** (bukan bot) melalui MTProto, menggunakan Telethon. Setiap akun berada di **ruang** kerja tersendiri (disebut *workspace* dalam API dan alat baris perintah) dengan sesi, sumber, jurnal, dan kunci penandatanganan tersendiri. Berkas sesi, string sesi, dan Kunci Otentikasi merupakan **otorisasi akun**: siapa pun yang memilikinya dapat bertindak sebagai akun tersebut. Ketiganya tidak berisi riwayat pesan. > [!PERINGATAN] **Gunakan akun khusus.** Telegram membatasi dan dapat memblokir akun secara permanen karena volume permintaan yang dianggap berlebihan, terlepas dari klien atau tujuannya, dan hanya mendokumentasikan batasan-batasan tersebut sebagian saja. Hubungkan akun yang disiapkan untuk pengamatan, bukan akun pribadi atau akun berharga lainnya, dan buat ID API / hash API pada akun khusus tersebut. - [Sekilas](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#at-a-glance) - [Sebelum memulai: ID API dan hash API](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#before-you-start-api-id-and-api-hash) - [Nomor telepon](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#phone-number) · [Kode QR](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#qr-code) · [Kunci Otentikasi + ID DC](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#auth-key--dc-id) - [Berkas akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#pyrogram-session) · [Pasangan sesi + JSON](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#telethon-stringsession) · [Kunci otentikasi dan DC dalam satu baris](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [JSON Akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json) - [Identifikasi apa yang Anda miliki](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#identify-what-you-have) · [Format yang tidak didukung](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#unsupported-formats) - [Beberapa akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#multiple-accounts) · [Menjaga keamanan berkas akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#keeping-account-files-safe) · [Pemecahan Masalah](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#troubleshooting) ## Sekilas | Apa yang Anda miliki | Tab di **Tambahkan akun** | Anda juga akan memerlukan | | --- | --- | --- | | Nomor telepon dan akses ke kode login-nya | **Telepon** | Kata sandi 2FA jika diaktifkan | | Telegram terbuka di perangkat lain | **Kode QR** | Kata sandi 2FA jika diaktifkan | | Berkas `.session` (Telethon atau Pyrogram) | **Berkas** | Berkas JSON pelengkap opsional untuk pengaturan aplikasi | | `.session` + `.json` dengan nama yang sama | **Berkas** (pilih keduanya) | Biasanya tidak ada yang lain | | Folder `tdata` di Telegram Desktop | **Berkas** (dalam format ZIP) | Kode sandi lokal Desktop, jika ada yang ditetapkan | | Sebuah Telethon StringSession (teks, `.txt`, `.tgwitness-session`) | **Berkas** | Tidak diperlukan pasangan API terpisah | | Kunci otentikasi dan DC dalam satu baris, `<512 hex>:<1–5>` | **Berkas** (tempelan atau berkas teks) | Tidak diperlukan pasangan API terpisah | | `.json` dengan sesi atau Kunci Otentikasi | **Berkas** | Tidak diperlukan pasangan API terpisah | | Kunci Otentikasi (512 karakter heksadesimal) dan nomor DC-nya | **Kunci otentikasi** | ID Pengguna (opsional) | TgWitness mengenali berkas berdasarkan **isinya**, bukan namanya. Mengganti nama berkas tidak akan mengubah isinya. ## Sebelum memulai: ID API dan hash API Anda dapat masuk tanpa perlu membuat aplikasi API Telegram. Jika tidak ada pasangan yang dimasukkan, diimpor, atau sudah disimpan di ruang kerja, TgWitness akan memilih pasangan dari kumpulan bawaan yang berisi 50 pasangan API publik (`tgwitness/api_pool.py`), dengan memprioritaskan Telegram Desktop untuk proses masuk baru dan menggunakan pasangan yang sudah disimpan terlebih dahulu; kandidat lainnya diacak. Jika Telegram menolak sebuah pasangan (`API_ID_INVALID`, `API_ID_PUBLISHED_FLOOD`, `UPDATE_APP_TO_LOGIN`), pasangan berikutnya akan dicoba, hingga delapan kali per proses masuk; pasangan yang ditolak dilewati hingga aplikasi dimulai ulang. Pasangan yang digunakan untuk masuk akan disimpan bersama akun tersebut dan digunakan kembali untuk akun tersebut. Pasangan bawaan bersifat publik: pasangan tersebut dipublikasikan dalam kode sumber terbuka klien dan pustaka Telegram. **ID API** dan **hash API** mengidentifikasi aplikasi tersebut kepada Telegram dan tidak memberikan akses apa pun ke data akun. Proses masuk menggunakan otorisasi akun itu sendiri: kode login dan kata sandi 2FA, atau sesi yang telah diotorisasi oleh akun tersebut. Setiap `observation.started` catatan mencantumkan pasangan yang digunakan, sehingga pasangan bawaan didokumentasikan untuk pengadilan dengan cara yang sama seperti milik Anda sendiri. Anda dapat memasukkan pasangan Anda sendiri dari my.telegram.org sebagai gantinya. Berdasarkan pengalaman proyek ini, pasangan pribadi yang baru akan membuat sebagian besar akun terlogout, jadi gunakanlah hanya jika suatu kasus memerlukan aplikasi Anda sendiri: buatlah dengan akun khusus dan masukkan sebelum pengumpulan dimulai (langkah-langkah di bawah ini). Bidang koneksi yang hilang menggunakan pasangan perangkat/OS yang deterministik dari katalog [opentele2 2.0.0 yang disertakan](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735): Desktop `2040`, Android `6`, Android X `21724`, iOS `10840`, macOS `2834`, dan Web `2496`. ID build sumber Android `4` juga menggunakan katalog Android, sebagaimana diidentifikasi dalam [BuildVars Telegram Android](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java). Web secara default menggunakan A; sufiks versi aplikasi yang diimpor `K` atau paket bahasa `macos` memilih K, dan versi `0.7.0` memilih Webogram. ID aplikasi yang tidak dikenal mempertahankan pengaturan default host Telethon. Bidang yang diimpor selalu diutamakan, termasuk versi aplikasi yang lebih lama dan paket bahasa yang kosong. Katalog tidak pernah mengubah ID/hash API. Cuplikan versinya ditinjau secara eksplisit, bukan diambil saat login. Profil yang disimpan tetap stabil setelah pembaruan. `account.getAuthorizations` melaporkan metadata otorisasi Telegram yang tersimpan; ini bukanlah duplikat dari setiap `initConnection` baru. Bandingkan dengan profil yang sebenarnya dikirim. Menghubungkan otorisasi yang sudah ada tidak memvalidasi hash API yang menyertainya: `initConnection` mengirimkan ID API, sedangkan hash digunakan oleh permintaan login. Setelah otorisasi ponsel baru atau QR, TgWitness meminta konfigurasi, DC terdekat, status online, bahasa (jika paket bahasa tidak kosong), pembaruan aplikasi, dan pembaruan syarat layanan, dengan jeda 0.3–1.5 detik antar permintaan. Pembaruan status secara singkat menandai akun sebagai online. Urutan ini dijalankan sekali setelah login selesai, bukan saat impor, koneksi ulang, atau restart. Otorisasi disimpan terlebih dahulu; permintaan yang gagal menghentikan urutan tanpa mencoba ulang atau membatalkan login. Hasilnya dicatat sebagai `account.initialized`, dengan nama kesalahan alih-alih isi respons. Kebijakan Telegram sendiri yang menentukan batasan akun. Untuk `tdesktop` , jika `tz_offset` tidak ada, maka digunakan offset UTC lokal server, dibulatkan ke 900 detik menggunakan algoritma [opentele2](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (MIT; lisensi di `tgwitness/client_profiles.LICENSE` ). Nilai ini diperbarui pada setiap koneksi sehingga perubahan waktu musim panas tercermin. `tz_offset` yang diimpor memiliki prioritas di setiap platform dan dipertahankan persis seperti aslinya, termasuk nilai nol. Entri `initConnection.params` lainnya tetap dipertahankan. Formulir masuk HTTP menerima zona waktu numerik yang dikembalikan oleh impor berkas; nilai boolean, pecahan, dan offset di luar rentang yang didukung akan ditolak. Rute langsung, SOCKS5, dan HTTP CONNECT menggunakan `ConnectionTcpObfuscated` (MTProto yang disingkat dan dikaburkan) dari Telethon. HTTPS CONNECT mempertahankan TLS ke proxy dan menggunakan transportasi yang disamarkan yang sama di dalam terowongan. MTProxy mempertahankan transportasi perantara acak dan penanganan rahasia yang diwajibkan. Pergantian rute menerapkan pilihan yang sama. Pengaburan mengubah pembingkaian paket; hal ini tidak menyembunyikan akun atau metadata kliennya dari Telegram atau menyiratkan kekebalan terhadap pembatasan. Setelah menghubungkan klien yang terotorisasi, TgWitness memeriksa konfigurasi, DC terdekat, otorisasi saat ini, baseline lapisan yang telah ditinjau, bahasa, pembaruan aplikasi, dan pembaruan syarat dan ketentuan layanan. Diagnostik ini dijalankan sekali per instance klien, sebelum pengumpulan data, dan ditampilkan di bawah detail koneksi beserta waktunya. `account.connection_checked` mencatat hasilnya tanpa hash sesi, alamat IP, token, atau hash API. Mereka tidak pernah menyetujui syarat dan ketentuan atau menginstal pembaruan. Kegagalan permintaan atau FloodWait menghentikan permintaan berikutnya; hasil yang hilang tetap tidak diketahui. Pemeriksaan lokal tetap dapat melaporkan hasilnya sementara pemeriksaan jaringan dilewati. Dengan [opsi obrolan terpilih yang ketat](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#strict-chosen-chats) diaktifkan, otorisasi saat ini tidak diminta dan pemeriksaan tersebut ditampilkan sebagai dilewati. Setelah masuk dan pada setiap koneksi baru, TgWitness membaca pengaturan konten sensitif akun tersebut. Jika pengaturan tersebut dalam keadaan nonaktif dan Telegram mengizinkan perubahan, TgWitness akan mengaktifkannya agar konten yang ditandai Telegram sebagai sensitif (18+) tersimpan, serta mencatat nilai ` `account.content_settings``. Pengaturan ini milik akun dan berlaku di setiap aplikasi Telegram. Fitur "Obrolan Terpilih" tidak memengaruhi pengaturan ini; aktifkan fitur tersebut sebelum masuk. Permintaan yang dilakukan secara bersamaan untuk memulihkan koneksi satu ruang kerja akan berbagi klien yang sama dan menunggu hingga proses penyiapan koneksinya selesai. Upaya yang gagal atau dibatalkan akan membebaskan permintaan berikutnya untuk mencoba kembali. Jika kredensial yang tersimpan, klien, atau status otorisasi berubah selama proses penyiapan, upaya yang lebih lama akan dihentikan alih-alih melaporkan bahwa koneksi sudah siap. Diagnostik FloodWait menyimpan metode TL yang gagal, pembungkus Takeout/range apa pun, penundaan yang diminta server, dan batas waktu efektif di `telegram.backoff`. Rincian koneksi menampilkan metode dan batas waktu saat permintaan ditangguhkan. Diagnostik ini mencakup penghitung panggilan klien per metode sejak klien tersebut dibuat; penghitung ini menghitung resolusi peer bersarang secara terpisah, tetapi tidak menghitung paket atau upaya percobaan ulang internal Telethon. Penghitung saat ini juga tersedia sebagai `collector.rpc_activity` di API status. Tidak ada argumen permintaan, nama pengguna, hash akses, atau teks pengecualian yang disertakan. Diagnostik terakhir dan batas waktu penuh tetap ada setelah restart. Penundaan sebelumnya tanpa catatan metode tidak dapat diatribusikan secara retrospektif. Lihat batas ekspor untuk tinjauan sumber dan perbedaan antara penemuan dan perolehan riwayat. `official_app=True` atau `False` adalah bendera otorisasi saat ini dari Telegram. Tidak ada satu pun nilai tersebut yang menentukan apakah akun tersebut dibatasi, tepercaya, atau sedang dalam pengamatan. Snapshot mode bukti `account.devices` yang ada tetap mencatat riwayat semua perangkat yang masuk; diagnostik koneksi hanya menyimpan deskripsi perangkat saat ini. Sebelum koneksi, pemeriksaan penasihat membandingkan platform API, paket bahasa, format perangkat/OS dan versi aplikasi, pengaturan wilayah sistem seluler, serta lapisan skema aktual Telethon dengan dasar katalog yang telah ditinjau. Peringatan muncul di log server dan metadata status akun; peringatan tersebut tidak pernah menggantikan nilai yang diimpor atau mengubah lapisan skema. Lapisan yang berbeda merupakan sinyal untuk meninjau kompatibilitas; status koneksi akun itu sendiri menunjukkan apakah koneksi berfungsi. Telegram menentukan batasan di sisi mereka, terlepas dari profil klien mana yang digunakan. Status akun yang terputus menggunakan profil yang tersimpan alih-alih membuat deskripsi perangkat baru. Untuk menggunakan aplikasi Anda sendiri sebagai gantinya: 1. Buka [my.telegram.org](https://my.telegram.org) dan masuk menggunakan nomor telepon apa pun yang Anda miliki. Kode verifikasi akan dikirimkan melalui aplikasi Telegram, bukan melalui SMS. 2. Pilih **alat pengembangan API**. 3. Buat aplikasi: judul dan nama pendek apa saja (5–32 huruf), platform **Desktop**. URL dan deskripsi dapat dikosongkan. 4. Salin **App api_id** (sebuah angka) dan **App api_hash** (32 karakter heksadesimal). Di panel, buka bagian **API ID + Hash** di bawah formulir masuk. Anda dapat menempelkan satu pasangan `api_id:api_hash` ke kolom **API ID**, dan kedua kolom tersebut akan terisi otomatis. Satu pasangan dapat digunakan untuk semua akun Anda. Setelah login berhasil, data tersebut disimpan dalam bentuk terenkripsi, hanya di ruang kerja tersebut, dan tidak pernah dikirim kembali ke browser. Terdapat tiga jenis kredensial yang terlibat: | Rahasia | Buka | Lokasi | | --- | --- | --- | | Token panel | Panel web TgWitness | `panel-token.txt` di direktori data, atau `TGWITNESS_TOKEN` | | ID API + hash | Tidak ada yang berdiri sendiri; mengidentifikasi aplikasi tersebut | Pasangan bawaan, pengaturan yang diimpor, atau aplikasi Anda sendiri di my.telegram.org | | Otorisasi akun | Akun Telegram | Dibuat melalui login via telepon/QR atau dimasukkan sebagai sesi | Jika Telegram harus diakses melalui proxy, atur terlebih dahulu di **menu Lainnya → Akun → Pengaturan → Pengaturan koneksi → Ubah rute koneksi**. ## Nomor telepon 1. Buka **Alat Lainnya → Akun**, tab **Telepon**, lalu masukkan nomor dalam format internasional, misalnya `+44 7700 900123`. Spasi dan tanda hubung akan dihapus secara otomatis. 2. Tekan **Lanjutkan**. Kolom API ID + Hash dapat dibiarkan kosong. 3. Masukkan kode yang dikirimkan Telegram, biasanya ke aplikasi Telegram; Telegram yang menentukan apakah akan mengirim SMS. 4. Jika akun tersebut memiliki verifikasi dua langkah, masukkan kata sandi tersebut. Ini bukanlah token panel maupun kode sandi perangkat. 5. Periksa ID akun yang ditampilkan setelah masuk, lalu pilih sumber. Kode login dan kata sandi 2FA tidak pernah disimpan ke disk. ## Kode QR Gunakan ini jika akun sudah masuk (login) di ponsel atau komputer lain. 1. Tab **Kode QR** → **Tampilkan kode QR**. Kolom API ID + Hash dapat dibiarkan kosong. 2. Pada perangkat yang sudah masuk: **Pengaturan → Perangkat → Hubungkan Perangkat Desktop**, pindai kode dan konfirmasi. 3. Masukkan kata sandi 2FA di TgWitness jika Telegram memintanya. Gambar QR dihasilkan secara lokal. Kode memiliki masa berlaku; tekan "**Buat kode QR lain"** untuk mencoba lagi. Mengunci panel, berpindah ruang kerja, atau memulai sesi login baru akan membatalkan kode yang sedang diproses. ## Kunci Otentikasi + ID DC Kunci Otorisasi (Auth Key) adalah otorisasi mentah berukuran 256 byte yang mendasari setiap sesi Telegram, ditulis dalam bentuk **512 karakter heksadesimal**, bersama dengan nomor pusat data **DC 1–5**. 1. Tab **Kunci Otentikasi**. Tempelkan kunci secara lengkap; kunci yang dipersingkat yang mengandung `…` tidak akan berfungsi. 2. Pilih DC ID yang disertakan bersama kunci tersebut. 3. Masukkan **ID Pengguna** (opsional). TgWitness kemudian akan menolak terhubung jika Telegram melaporkan akun yang berbeda. 4. **Akun** Press **Connect**. Kunci Otentikasi (512 karakter) bukanlah hash API (32 karakter). Kunci yang sama juga dapat diimpor sebagai JSON, lihat [JSON Akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json). ## Berkas akun Buka **Tambah Akun → File** dan pilih hingga **empat file yang terkait dengan satu akun**, dengan total ukuran **8 MiB**, tekan **Periksa File**, lalu **Hubungkan Akun**. Memilih file atau menempelkan teks sesi tidak akan mengirimkan apa pun; **tombol Periksa File** akan mengirimkannya ke server TgWitness Anda, yang akan membacanya tanpa perlu masuk dan menampilkan sesi yang ditemukan. Formulir **Files**, **Auth key**, dan formulir impor massal menampilkan peringatan sesi paralel sebelum terhubung. Secara default, otorisasi yang diimpor akan digunakan kembali. Biarkan klien asli tetap tertutup selama kuncinya digunakan di sini. **Files** dan **Auth key** juga menawarkan **Buat otorisasi independen**, yang dijelaskan di bawah ini. Impor massal masih menggunakan mode langsung. Masuk melalui telepon dan QR interaktif membuat otorisasi terpisah. Judul peringatan tetap terlihat di formulir impor; penjelasan lengkapnya terbuka secara otomatis saat file atau string kunci/sesi disediakan. Peringatan ini dapat ditutup setelah dibaca, sehingga pemilih file dan kontrol koneksi tetap dapat digunakan di ponsel. [Penerapan yang telah diverifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/) (Phala Cloud, Intel TDX) tidak melakukan pengumpulan data berdasarkan kunci yang diimpor. Di sana, **File** dan **Kunci Otentikasi** hanya terhubung jika opsi **Buat otorisasi independen**dipilih; impor massal ditolak. Masuk melalui telepon dan QR code berfungsi seperti biasa. - File dikonversi **di memori** pada server TgWitness Anda. Unggahan tidak disimpan, file ZIP tidak diekstrak ke disk, dan tidak ada layanan eksternal yang dihubungi. - Sesi yang dihasilkan kemudian diverifikasi dengan Telegram. Jika sebuah berkas mencantumkan ID pengguna, ID tersebut harus sesuai dengan akun yang dilaporkan oleh Telegram. - Berkas yang mendeskripsikan akun yang berbeda atau kredensial API yang berbeda akan ditolak daripada memilih salah satunya. - **Kode sandi atau teks sesi** berisi bidang kode sandi lokal TData, sebuah kotak untuk menempelkan StringSession dan **membaca berkas tanpa masuk** (mengisi formulir tanpa menghubungi Telegram). Menempelkan StringSession akan menghapus file yang dipilih, dan memilih file akan menghapus teks yang ditempelkan, sehingga pemeriksaan dan koneksi menggunakan pilihan terbaru. Setelah mengubah kode sandi, tekan **Periksa file** lagi. ### Buat otorisasi independen Pilih **Buat otorisasi independen** sebelum menghubungkan berkas yang diimpor atau Kunci Otorisasi. TgWitness menghubungkan donor yang diimpor sebentar, menggunakannya untuk menyetujui token login QR klien baru, dan memutuskan koneksi donor segera setelah persetujuan. Klien baru memiliki kunci otorisasi sendiri dan profil Desktop yang dipilih secara terpisah. Kredensial API dan profil perangkat yang disediakan oleh donor hanya digunakan untuk koneksi donor. Tidak ada otorisasi yang ada yang dicabut atau dibatalkan. **Pastikan klien asli donor tetap ditutup sepenuhnya selama langkah ini.** Koneksi awal masih menggunakan kunci yang disalin, sehingga mode ini tidak dapat menghilangkan risiko penggunaan paralel pada tahap awal tersebut. Setelah otorisasi baru terhubung, pemilik dapat membuka kembali klien asli dan menggunakan keduanya secara bersamaan. Masuk dengan **kode QR** interaktif memungkinkan klien asli menyetujui proses masuk tanpa menyalin atau menghubungkan kuncinya di sini. **Jangan logout atau mengakhiri sesi donor.** Ketika sesi yang menyetujui login QR berakhir, Telegram juga mengakhiri sesi yang telah disetujuinya; dalam pengujian langsung, otorisasi baru terhenti dalam waktu satu detik setelah donor logout. Proses impor mencatat sesi donor (`session_origin.approved_by`: perangkat, ID API, dan waktu pembuatan). Daftar sesi menandainya, **Akhiri sesi** akan menolaknya, sedangkan **Akhiri semua sesi lainnya** dan **Jadikan ini satu-satunya sesi** akan membiarkannya tetap masuk. Jika Telegram meminta 2FA, mode ini menggunakan `twoFA` dari JSON yang dipilih jika tersedia, atau meminta kata sandi. Jika kata sandi yang diimpor ditolak, sistem akan kembali ke formulir kata sandi. Kata sandi tidak disimpan. Kunci kandidat disimpan dalam bentuk terenkripsi di `independent_login.enc`, termasuk perubahan selama migrasi pusat data. Setelah terjadi gangguan, pilih donor yang sama dan opsi ini untuk melanjutkan kandidat yang disimpan. Donor diperiksa dengan `help.getAppConfig` sebelum persetujuan; akun yang dibekukan akan terhenti di sana. Jika Telegram menolak donor sebelum menyetujui proses masuk, kunci kandidat yang tidak disetujui akan dibuang dan proses impor dapat dimulai kembali. Donor lain hanya akan menggantikan kunci kandidat yang tersimpan jika Telegram melaporkan bahwa kandidat tersebut belum masuk; kunci kandidat yang sudah masuk atau sedang menunggu kata sandi 2FA-nya akan dipertahankan. Ruang kerja tetap dicadangkan untuk akun tersebut; kegagalan penyelesaian tidak menghapus ruang kerja baru tersebut. Simpan direktori datanya dan kunci brankasnya. Kredensial akhir dan `account.authorized` catatan jurnal mencakup metode impor, format masukan, dan ID API donor, tanpa kunci atau kata sandi donor. Pada 5 November 2026, sebuah akun khusus lulus pemeriksaan langsung dengan donatur Telethon, Pyrogram, dan TData: penyelesaian 2FA, kunci otorisasi baru yang berbeda, akses bersamaan oleh donatur dan klien baru, serta membaca saluran publik. Kasus Telethon juga melanjutkan kandidat yang disimpan setelah terjadi gangguan pada langkah kata sandi. Setiap otorisasi baru menyelesaikan enam permintaan inisialisasi pasca-login, dan jurnalnya yang ditandatangani terverifikasi. Sesi asli tetap dapat digunakan dalam keempat format yang disediakan. Basis data kesalahan [RPC Telegram](https://core.telegram.org/api/errors.json) mengaitkan `FRESH_CHANGE_ADMINS_FORBIDDEN` dengan pergantian admin, `FRESH_CHANGE_PHONE_FORBIDDEN` dengan perubahan nomor telepon, dan `FRESH_RESET_AUTHORISATION_FORBIDDEN` dengan pencabutan sesi lain, perubahan masa berlakunya, atau pendaftaran kunci akses. `SESSION_TOO_FRESH_*` dan `PASSWORD_TOO_FRESH_*` berkaitan dengan pengalihan kepemilikan serta penarikan pendapatan atau hadiah. Ini bukanlah operasi pengumpulan; login baru tidak berarti larangan pembacaan selama 24 jam secara menyeluruh. Ekspor dapat secara terpisah mengembalikan `TAKEOUT_INIT_DELAY_*`. TgWitness mempertahankan jeda yang diminta server dan tidak mencoba kembali penerimaan token secara otomatis atau mencabut sesi untuk mengatasi pembatasan. **Alat lainnya → Akun → Keamanan akun → Sesi akun ini → Akhiri semua sesi lainnya** memanggil ``auth.resetAuthorizations`` atas permintaan operator dan mencatat ``account.all_other_sessions_terminated`` beserta jumlah sesi sebelum dan sesudahnya. Telegram menerimanya dari sesi yang telah masuk selama 24 jam. Ketika ruang kerja ini masuk melalui QR dari sesi yang diimpor, sesi yang menyetujuinya tetap masuk: TgWitness mengakhiri sesi lainnya satu per satu dengan ``account.resetAuthorization`` dan mencatat ``kept_approving_session``. **Jadikan ini sebagai satu-satunya sesi**, lalu hentikan dengan alasan tersebut dan jangan ubah kata sandi. **Jadikan sesi ini satu-satunya yang** melakukan hal yang sama untuk kunci yang dibuat dengan masuk dari ruang kerja ini, lalu aktifkan kata sandi dua langkah jika akun tersebut belum memilikinya. Panel akan menampilkan kata sandi tersebut sekali; TgWitness menyimpannya di brankas ruang kerja hanya sampai saat itu. Catatan jurnal `session.exclusive_from`. Jika Telegram kemudian mencantumkan sesi lain, jurnal mencatatnya `session.exclusive_ended` dan panel akan menampilkan peringatan. Verifikator akan mencetak keduanya. **Jadikan ini satu-satunya sesi ketika Telegram mengizinkannya sebagai** tindakan yang sama berdasarkan timer. Opsi ini muncul di bawah **Sesi akun ini** untuk kunci yang dibuat di ruang kerja ini dan dicatat sebagai `session.exclusive_automatic`. Selama pemantauan, pengumpul memeriksa setiap lima menit apakah 24 jam telah berlalu sejak catatan `account.authorized` kunci tersebut — Telegram menjawab `FRESH_RESET_AUTHORISATION_FORBIDDEN` sebelum itu — dan kemudian menjalankan operasi yang sama sekali. Keberhasilan dicatat sebagai `session.exclusive_from`, seperti tombol manual. Penolakan dicatat sekali sebagai `session.exclusive_postponed` dengan alasan dari Telegram, dan pengumpul mencoba kembali dengan penundaan yang semakin lama hingga enam jam. Akses baca-saja tidak berpengaruh di sini: mengakhiri sesi merupakan tindakan keamanan akun, bukan tindakan obrolan. Kata sandi dua langkah yang dihasilkan oleh proses otomatis disimpan di brankas ruang kerja, dienkripsi dengan kunci ruang kerja, sebelum Telegram menetapkannya. Panel mengambilnya sekali dari `POST /api/account/sessions/only/password`, yang kemudian menghapusnya, dan menampilkannya di dialog yang sama seperti alur manual saat Anda membuka **Sesi akun ini**. Halaman koneksi mencatat bahwa ada kata sandi yang menunggu. Kata sandi tersebut tidak pernah masuk ke jurnal dan tetap ada setelah sistem di-restart hingga ditampilkan. Sesi baru juga dilaporkan selama proses pengamatan: ketika daftar sesi Telegram bertambah satu entri, catatan `account.sessions` mencatatnya di bawah `added` dan panel menampilkan peringatan yang mencantumkan perangkat, aplikasi, dan negara dari snapshot tersebut. ### Probe saksi **Alat lainnya → Akun → Keamanan akun → Pemeriksaan probe saksi** memeriksa apakah klien lain menerima pembaruan dari akun ini. Tambahkan ruang kerja kedua yang masuk dengan akun Telegram berbeda dan kunci sesi tersendiri, buat grup pribadi dengan kedua akun tersebut, lalu pilih grup itu sebagai **obrolan Probe** dan ruang kerja kedua sebagai **ruang kerja Saksi**, kemudian aktifkan probe. Kedua akun harus menonaktifkan **mode Hanya Baca**, dan ruang kerja saksi harus dalam mode pengamatan. Saat melakukan pengamatan, ruang kerja ini mengirimkan `probe::` ke grup setiap 60–120 detik dan mencatat `probe.sent`. Saksi menjawab `ack::` dan mencatat `probe.seen` serta `probe.ack_sent`. Sebuah ack yang mencapai sesi ini sebagai pembaruan langsung dalam waktu 20 detik dicatat sebagai `probe.acked`. Jika tidak, ruang kerja membaca riwayat terbaru grup. Sebuah ack yang ditemukan di sana tetapi tidak dikirim secara langsung dicatat sebagai `coverage.gap` dengan alasan `probe_ack_missed_live`: panel mengeluarkan peringatan dan menandai penerimaan peristiwa sebagai gagal hingga ack berikutnya tiba secara langsung (`connection.restored`, alasan `probe_ack_live`). Tidak ada ack yang dicatat sebagai `probe.unanswered`; gangguan koneksi selama masa tunggu atau riwayat yang tidak dapat dibaca dicatat sebagai `probe.inconclusive`. Pembatasan baca-saja, pembatasan Telegram, dan jeda FloodWait dicatat sekali sebagai `probe.skipped`. ### Telethon `.session` | | | | --- | --- | | Apa itu | Basis data SQLite yang dibuat oleh alat berbasis Telethon, misalnya `my_account.session` | | Diakui oleh | Tabel `sessions` (bersama dengan `dc_id`, `server_address`, `port`, `auth_key`) dan `version` = 7 atau 8 | | Persyaratan | Tepat satu baris sesi yang diotorisasi; basis data yang tertutup dan lengkap | Tutup terlebih dahulu program yang membuat berkas tersebut. Jika terdapat `my_account.session-journal` atau `my_account.session-wal` di sampingnya, berarti basis data belum diselesaikan: buka dan tutup klien aslinya dengan benar. Menghapus berkas-berkas sidecar tersebut dapat meninggalkan salinan yang rusak. ### Pyrogram `.session` | | | | --- | --- | | Apa itu | Alat berbasis Pyrogram yang menggunakan basis data SQLite | | Diakui oleh | Tabel `sessions` dengan `dc_id`, `auth_key`, `test_mode`, `user_id`, `is_bot`; `version` = 2 atau 3 | | Persyaratan | Satu sesi **pengguna** yang berwenang di jaringan produksi. Sesi bot dan test-DC ditolak | ID pengguna yang disimpan akan diverifikasi dengan Telegram saat login. ### Pasangan sesi + JSON Akun sering kali didistribusikan dalam bentuk dua berkas dengan nama yang sama, misalnya `447700900123.session` dan `447700900123.json`. Pilih **keduanya** sekaligus. - Dari JSON, TgWitness menggunakan `app_id`/`api_id` dan `app_hash`/`api_hash`, sehingga Anda biasanya tidak perlu memasukkan kredensial API. - Profil koneksi menggunakan `device_model` (alias `device`), `system_version` (alias `sdk`), `app_version`, `lang_code`, `system_lang_code` (alias `system_lang_pack`), `lang_pack`, dan `tz_offset` opsional (detik dari UTC, -43200 hingga 50400). Bidang yang diisi memiliki prioritas lebih tinggi daripada nilai default yang dihasilkan dan bahasa panel/browser . Alias yang bertentangan akan ditolak. Profil yang telah diselesaikan disimpan dalam kredensial ruang kerja terenkripsi dan digunakan kembali setelah restart, termasuk versi aplikasinya. - `phone`, pengaturan proxy, dan token perangkat di**abaikan**. `twoFA` bersifat hanya baca ketika **Buat otorisasi independen** dipilih; impor langsung mengabaikannya. - JSON tanpa bidang otorisasi yang didukung hanyalah metadata. Tambahkan berkas sesi atau lanjutkan dengan login melalui telepon atau QR. JSON yang berisi sesi yang didukung atau Kunci Otorisasi dapat melakukan otorisasi secara mandiri; lihat [Account JSON](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json). ### Telegram Desktop (TData) TData adalah folder `tdata` dari aplikasi Telegram Desktop (aplikasi lintas platform dari desktop.telegram.org). | Sistem | Lokasi default `tdata` | | --- | --- | | Windows | `%APPDATA%\Telegram Desktop\tdata` (Telegram portabel: di sebelah `Telegram.exe`) | | Linux | `~/.local/share/TelegramDesktop/tdata` | | macOS | `~/Library/Application Support/Telegram Desktop/tdata` | Untuk mengimpornya: > **Peringatan sesi paralel.** Impor TData langsung menggunakan kembali kunci otorisasi Telegram Desktop. Jangan gunakan kunci tersebut di Desktop dan TgWitness secara bersamaan. Telegram dapat membatalkan otorisasi tersebut dengan `AUTH_KEY_DUPLICATED`, sehingga kedua salinan menjadi tidak dapat digunakan hingga login baru dilakukan. > > > > Tutup Desktop sepenuhnya, termasuk proses tray-nya, dan biarkan salinan tersebut tetap tertutup saat TgWitness menggunakan sesi yang diimpor. **Tutup, jangan logout atau mencabut sesi:** pencabutan juga akan membatalkan salinan yang diimpor. Jika Anda memerlukan kedua klien berjalan, pilih **Buat otorisasi independen** dan biarkan Desktop tetap tertutup hingga login baru berhasil, atau masuk ke TgWitness melalui telepon atau QR. Akun khusus disarankan, tetapi tidak menjamin keamanan kunci kloning untuk digunakan secara paralel. > > > > Hal ini juga berlaku untuk berkas yang diimpor `.session` , teks StringSession, dan Auth Key HEX. Klien lain dengan otorisasi yang dibuat secara mandiri dapat tetap masuk. Lihat [dokumentasi AUTH_KEY_DUPLICATED dari Telegram](https://core.telegram.org/api/errors#406-not-acceptable). 1. Keluar sepenuhnya dari Telegram Desktop. 2. Buatlah berkas ZIP yang **hanya** berisi dua item berikut dari `tdata`: - `key_datas` - file berhuruf 16 yang berakhiran `s` di sebelahnya, biasanya `D877F783D5D3EF8Cs` Mengompres seluruh folder beserta cache medianya biasanya melebihi batas (512 entri, 32 MiB setelah diekstrak). 3. Pilih berkas ZIP di bagian "**Files**". Jika Telegram Desktop memiliki **kode sandi lokal**, masukkan kode tersebut di kolom **"Passcode" atau "session text"** terlebih dahulu. Ini bukanlah kata sandi 2FA. Didukung: satu akun per arsip, penyimpanan modern `key_datas`/`key_data0`/`key_data1`, kode sandi lokal. Tidak didukung: folder dengan beberapa akun yang masuk, tata letak Desktop versi lama, file ZIP yang dilindungi kata sandi, dan aplikasi asli macOS terpisah "Telegram for macOS". ### Telethon StringSession Satu baris teks, biasanya dimulai dengan `1` dan panjangnya sekitar 350 karakter. Unggah berkas tersebut sebagai berkas `.txt` atau `.tgwitness-session` (maksimal 4 KiB), atau tempelkan di bawah **kolom Kode Akses atau teks sesi**. Hanya string Telethon yang diterima; string Pyrogram dan TDLib menggunakan format yang berbeda. ### Kunci otentikasi dan DC dalam satu baris Daftar akun sering kali memuat otorisasi mentah dalam bentuk `<512 hexadecimal characters>:`, misalnya `a1b2…ef:5`. Tempelkan baris tersebut di bawah **kolom Kode Akses atau teks sesi**, muat sebagai berkas teks, atau masukkan ke dalam bidang `session` pada [JSON Akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json). TgWitness memetakan DC 1–5 ke alamat produksi yang sama seperti impor JSON `auth_key` + `dc_id` dan melaporkan formatnya sebagai **Kunci Otorisasi HEX dan DC**. Nomor DC atau panjang kunci lain apa pun akan ditolak. ### JSON Akun Satu objek JSON, maksimal **64 KiB**, dalam berkas dengan ekstensi **`.json`**. | Bidang (alias) | Arti | | --- | --- | | `api_id` (`app_id`) | ID Aplikasi, sebuah bilangan positif | | `api_hash` (`app_hash`) | Hash aplikasi, 32 karakter heksadesimal | | `string_session` (`session_string`, `session_str`; `session` versi lama) | Teks Telethon StringSession, atau `<512 hexadecimal characters>:`, bukan nama berkas | | `auth_key` (`auth_key_hex`) + `dc_id` | Kunci Otentikasi (Auth Key) lengkap berpanjang 512 karakter dan DC 1–5 | | `user_id` (`id`) | Opsional; diverifikasi dengan Telegram sebelum otorisasi disimpan | | `device_model` (`device`) | Deskripsi perangkat koneksi | | `system_version` (`sdk`) | Versi OS koneksi | | `app_version` | Versi aplikasi yang dikirim ke Telegram | | `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | Bahasa klien, bahasa sistem, dan paket bahasa klien; nilai kosong untuk `lang_pack` diperbolehkan | | `tz_offset` | Offset UTC opsional dalam detik, dikirim dalam `initConnection.params`; bilangan bulat atau string bilangan desimal | Jika alias dan nama utama keduanya ada, keduanya harus sama. Bidang sesi Telethon yang eksplisit memiliki prioritas lebih tinggi daripada blob `session` generik dalam format lain. Jika keduanya berisi sesi Telethon yang dapat dikenali, keduanya harus menggambarkan otorisasi yang sama. Tanpa bidang eksplisit, `session` harus berupa StringSession Telethon yang valid atau kunci otorisasi dan DC dalam bentuk `<512 hexadecimal characters>:`. Contoh: ``` { "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" } ``` ``` { "api_id": 1234567, "api_hash": "0123456789abcdef0123456789abcdef", "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS", "dc_id": 2, "user_id": 123456789 } ``` Contoh pertama hanya mengisi kredensial API; masuk dengan nomor telepon atau QR, atau tambahkan berkas sesi. Daftar massal (array JSON akun) tidak diterima. ## Identifikasi apa yang Anda miliki | Anda melihat | Ini adalah | Penggunaan | | --- | --- | --- | | `*.session`; saat dibuka di editor teks, bagian atasnya menampilkan `SQLite format 3` | Telethon atau Pyrogram SQLite | **Berkas** (terdeteksi secara otomatis) | | Folder `tdata` yang berisi `key_datas` | Telegram Desktop TData | Kompres dua berkas menjadi ZIP, lalu **Berkas** | | Satu baris teks yang dimulai dengan `1`, ~350 karakter | Telethon StringSession | **Berkas** | | Satu baris teks `512 characters 0-9a-f`, diikuti `:` dan angka 1–5 | Kunci otentikasi dan DC | **Berkas**, **kode sandi kotak, atau teks sesi** | | `*.json` dengan `app_id`/`app_hash` | Metadata pendamping | **Berkas**, beserta sesi-nya | | `*.json` dengan `auth_key` atau `string_session` | JSON Akun | **Berkas** | | 512 karakter `0-9a-f` | Kunci Otentikasi | **Kunci otentikasi** | | 32 karakter `0-9a-f` | Hash API | **ID API + Hash** | | `td.binlog` atau `db.sqlite` dari aplikasi TDLib | Penyimpanan TDLib | Tidak didukung | | `123456789:AA…` | Token bot | Tidak didukung | ## Format yang tidak didukung | Format | Alternatif | | --- | --- | | Penyimpanan TDLib (`td.binlog`) dan ekspor TDLib | Masuk menggunakan nomor telepon atau QR | | **String** sesi Pyrogram | Gunakan berkas Pyrogram `.session`, atau ponsel/QR | | TData dengan beberapa akun yang telah masuk | Keluar dari akun-akun lain di Telegram Desktop, atau gunakan berkas sesi masing-masing akun | | Token bot | Tidak didukung: TgWitness beroperasi sebagai akun pengguna | | Daftar CSV/JSON dari banyak akun | Impor file sesi yang didukung melalui **Akun → Impor akun**, atau masuk melalui telepon/QR di ruang kerja terpisah | | Sesi Test-DC atau bot | Gunakan akun pengguna produksi | ## Beberapa akun Tekan **tombol +** di samping pemilih akun, atau buka **Alat lainnya → Akun → Pengaturan → Pengaturan koneksi → Ruang kerja**, masukkan label, lalu masuk. - Jumlah ruang kerja tidak terbatas, termasuk ruang kerja utama. Masing-masing memiliki sesi, rute proxy , sumber, kebijakan penangkapan, jurnal, kunci penandatanganan, titik pemeriksaan, dan ekspor tersendiri. - Mengganti ruang kerja yang ditampilkan tidak akan menghentikan ruang kerja lainnya. - Sebuah jurnal tetap terikat pada akun yang membuatnya. Masuk dengan akun yang berbeda memerlukan ruang kerja lain, dan satu akun tidak dapat ditugaskan ke dua ruang kerja. - Token panel utama mengontrol semua ruang kerja. [Akses yang diberikan](https://phishdestroy.io/tgwitness/id/docs/reference/access/) dapat membatasi orang lain hanya pada akun dan obrolan tertentu, dengan izin dan batas sesi yang terpisah. - **Akun** mengganti nama ruang kerja dan menghapus ruang kerja yang ditambahkan, beserta sesi, jurnal, sumber, dan kunci penandatanganan. Ruang kerja utama tidak dapat dihapus dari panel. ### Impor massal dan grup akun Gunakan **Akun → Impor akun** untuk menambahkan beberapa akun, pasangkan berkas berdasarkan nama dasar dan lihat hasil login masing-masing. Setiap akun memiliki ruang kerja tersendiri. Sebuah grup menyatukan akun-akun yang terkait tanpa menggabungkan sesi, kunci, atau bukti mereka. **Buka grup** di **bagian Akun** untuk menuju ke halamannya di `/groups/`: - **Akun:** rute koneksi, pengamatan, dan pesan terakhir setiap anggota, dengan **Mulai Semua** dan **Jeda Semua**. - **Perlu perhatian:** akun yang telah keluar, tidak tersedia, atau mengalami masalah koneksi, input, sumber, atau media; setiap nama mengarah ke kartunya masing-masing. - **Obrolan di beberapa akun menampilkan:** sumber yang dibagikan, akun-akun yang mengamati obrolan tersebut, dan gangguan dalam periode pengamatan ruang kerja yang tersedia (hingga tujuh hari). **Ekspor dengan N akun** membagi ekspor saluran atau supergrup di antara akun-akun tersebut dan menandatangani satu arsip. - **Ekspor grup:** satu ZIP dengan ekspor yang telah ditandatangani dari setiap akun di bawah `accounts/` dan `manifest.json` mencantumkan SHA-256 dan sidik jari kunci masing-masing, yang ditandatangani oleh ruang kerja utama di `manifest.signature.json`. Verifikasi setiap arsip akun secara terpisah dengan `python -m tgwitness.verify` dan sidik jari tepercaya akun tersebut. Anggota berbagi pengaturan grup; sebuah akun dapat mempertahankan nilai-nilainya sendiri. Lihat [pengaturan bersama](https://phishdestroy.io/tgwitness/id/docs/reference/settings/#account-groups), [panduan impor dan grup](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) dan [dasbor kolam MTProxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources). ## Keluar **Alat lainnya → Akun → Keluar dari Telegram** (dengan pengamatan ditangguhkan) meminta Telegram untuk mengakhiri sesi, sehingga sesi tersebut juga menghilang dari **Pengaturan → Perangkat** akun, dan menghapus sesi dari brankas ruang kerja. Jurnal, sumber, pengaturan, dan kunci penandatanganan tetap ada, dan jurnal mencatat proses keluar tersebut. Ruang kerja tersebut masih milik akunnya: hanya akun tersebut yang dapat terhubung kembali ke ruang kerja tersebut. Jika Telegram tidak merespons, sesi tersebut tetap dihapus di sini dan panel akan menampilkannya; akhiri sesi tersebut di Telegram melalui **Pengaturan → Perangkat**. ## Saat Telegram mengakhiri sesi Jika Telegram memblokir, membekukan, atau mengeluarkan akun, atau mengakhiri sesi dari perangkat lain, jurnal akan mencatat penyebabnya, kesalahan Telegram, rute, dan pusat data. Kondisi akun ditampilkan dalam **“Unduh laporan kehilangan akun**”: berkas JSON yang ditandatangani berisi catatan jurnal selama 24 jam sebelum kehilangan akun, yaitu koneksi, rute, sesi, pemberitahuan akun, dan celah cakupan, masing-masing dilengkapi dengan hash jurnal dan tanda tangannya. Periksa dengan `python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP`; ekspor bukti berisi rantai hash lengkap. Akun yang dibekukan juga terdeteksi saat terhubung dan selama pemantauan, serta tindakan pengiriman dan bergabungnya dinonaktifkan. ## Menjaga keamanan berkas akun - Perlakukan setiap `.session`, TData ZIP, StringSession, Auth Key, dan JSON akun seperti kata sandi. TgWitness menyimpan otorisasi yang diimpor di dalam brankas terenkripsinya; Anda dapat menghapus file aslinya setelahnya. - Jangan menjalankan otorisasi yang sama di dua program sekaligus. Telegram dapat mencabutnya (`AUTH_KEY_DUPLICATED`), dan kedua salinan tersebut akan berhenti berfungsi. - Sesi yang telah kedaluwarsa atau dicabut tidak dapat diaktifkan kembali melalui konversi. Silakan masuk kembali. ## Pemecahan Masalah | Pesan atau gejala | Apa yang harus dilakukan | | --- | --- | | *Tidak dapat membaca sesi ini. Tutup klien aslinya…* | Berkas SQLite sedang terbuka atau belum selesai (sidecar `-journal`/`-wal`). Tutup program aslinya dengan benar, lalu salin kembali berkas tersebut. | | *Skema SQLite Telethon yang didukung: 7 dan 8* / *Pyrogram … 2 dan 3* | File ini dibuat menggunakan versi pustaka yang sangat lama atau tidak dikenal. Silakan masuk menggunakan nomor telepon/QR. | | *Hanya sesi pengguna produksi yang berwenang yang didukung* | Berkas Pyrogram tersebut milik bot atau jaringan uji coba. | | *Arsip TData melebihi 512 entri atau 32 MiB* | Hanya berkas ZIP `key_datas` dan `D877F783D5D3EF8Cs`, bukan seluruh folder. | | *Tidak dapat mendekripsi TData. Periksa kode sandi lokal Desktop* | Masukkan kode sandi lokal Telegram Desktop di kolom "**Passcode**" **atau "session text**". | | *Impor satu akun TData pada satu waktu* | Telegram Desktop memiliki beberapa akun; lihat [Format yang Tidak Didukung](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#unsupported-formats). | | *Berkas-berkas yang dipilih menjelaskan akun-akun yang berbeda atau kredensial API* | Pilih file dari satu akun saja. | | *JSON tidak berisi kredensial API atau otorisasi yang didukung* | Periksa nama-nama bidang dalam [JSON Akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json). | | *Hanya metadata API* | JSON ini tidak memiliki sesi. Tambahkan berkas `.session` atau gunakan nomor telepon/kode QR. | | *Kunci Otorisasi HEX harus berisi seluruh 512 karakter heksadesimal* | Kunci tersebut terpotong atau mengandung `…`. | | ID akun tidak sesuai dengan akun yang diimpor | ID pengguna pada berkas tersebut berbeda dengan yang dilaporkan oleh Telegram; berkas tersebut diperuntukkan bagi akun lain. | | Akun ini sudah terdaftar di ruang kerja lain | Buka ruang kerja tersebut daripada menambahkan akun dua kali. | | Sudah terhubung, tetapi grup pribadi tidak muncul dalam daftar obrolan di **Alat Lainnya → Sumber** | Periksa keanggotaan. Pemilih memeriksa 1,000 dialog pertama; tingkatkan batasnya di **Alat Lainnya → Parameter**. | | Koneksi proxy gagal | Periksa rute dan mode IP. Secara otomatis, MTProxy akan mencoba entri lain yang berfungsi. Sembunyikan penundaan alamat; Direct sebagai pilihan terakhir dapat terhubung langsung setelah penundaan yang telah dikonfigurasi. Lihat [mode perutean](https://phishdestroy.io/tgwitness/id/docs/reference/connection/#ip-modes). | Lihat juga: [koneksi dan keamanan](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) untuk proxy dan enkripsi, serta [cara kerja pengumpulan](https://phishdestroy.io/tgwitness/id/docs/reference/collection/) data yang direkam setelah masuk. --- # Telegram · Akses dan izin Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/access/ Tentukan cakupan akses ke akun dan obrolan, pilih izin, batasi sesi dan alamat IP, serta cabut akses. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Tentukan cakupan akses ke akun dan obrolan, pilih izin, batasi sesi dan alamat IP, serta cabut akses. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Memulai](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/) ![Memulai](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) Berikan akses kepada peninjau ke satu obrolan, izin kepada analis untuk mengekspor suatu kasus, atau kontrol kepada operator atas akun-akun yang dipilih. Setiap orang mendapatkan tokennya masing-masing. Token panel utama tetap berada di tangan administrator. [Pengaturan akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/) · [Rute koneksi](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) · [Model keamanan](https://phishdestroy.io/tgwitness/id/docs/reference/security/) ## Dua cakupan, dua tugas yang berbeda **Cakupan pengumpulan** menentukan apa yang direkam oleh suatu akun: obrolan terpilih, folder Telegram, atau seluruh akun. **Cakupan akses** menentukan akun dan obrolan mana saja dari yang telah direkam tersebut yang dapat dilihat dan digunakan oleh orang lain. Memberikan akses tidak berarti bergabung ke obrolan Telegram, memulai pengumpulan, atau memberikan izin akun Telegram. Sebuah akses dapat membuka ruang kerja yang dipilih, obrolan tertentu di dalamnya, semua ruang kerja, atau setiap akun dalam sebuah [grup akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#bulk-import-and-account-groups). **Semua ruang kerja, termasuk yang ditambahkan kemudian**, juga mencakup akun-akun di masa mendatang. Akses grup juga mencakup akun-akun yang ditambahkan ke grup tersebut di kemudian hari. Pilih ruang kerja secara eksplisit jika kasus harus dibatasi hanya pada ruang kerja tersebut. ## Berikan akses kepada seseorang 1. Masuk sebagai administrator utama dan buka **Alat Lainnya → Akses**. 2. Di bawah bagian "**Berikan akses kepada seseorang**", masukkan nama yang akan Anda kenali dalam log. 3. Pilih ruang kerja dan, jika diperlukan, obrolan individu. 4. Pilih tindakan yang mungkin dilakukan oleh orang ini. Opsi "**Lihat"** selalu disertakan. 5. Tentukan masa berlaku, batas masuk/sesi, dan alamat yang diizinkan sesuai kebutuhan. 6. Tekan **"Buat Akses**". Salin token sekarang: token ini hanya ditampilkan sekali. 7. Kirim alamat panel dan token secara pribadi. Penerima memasukkan token tersebut di halaman masuk biasa; mereka tidak memerlukan token panel utama Anda atau sesi Telegram. Buka panel yang berisi token yang diterbitkan dalam sesi browser terpisah dan periksa obrolan yang terlihat serta tindakan yang diizinkan sebelum menyerahkannya. Nama akses tetap tersimpan dalam penyimpanan lokal terenkripsi dan diselesaikan melalui panel administrator. Nama dihilangkan dari catatan audit akses baru dan pembuatan ruang kerja; catatan yang sudah ditandatangani tetap mempertahankan bidang aslinya. ## Pilih izin Untuk demonstrasi publik berbasis teks saja, gunakan **"Public showcase"** alih-alih akses peninjau biasa. Fitur ini menampilkan saluran publik yang dipilih secara eksplisit, riwayat suntingan dan penghapusan yang disimpan, serta statistik yang ditandatangani, dengan kolom penulis disamarkan dan berkas ditutup pada batas API. [Buat dan verifikasi showcase](https://phishdestroy.io/tgwitness/id/docs/reference/showcase/). | Izin | Fitur yang ditawarkan | | --- | --- | | `view` | Baca obrolan yang diizinkan, pesan yang direkam, profil, berkas, dan catatan jurnal yang telah difilter. Selalu disertakan. | | `export` | Ekspor riwayat obrolan dan berkas yang diizinkan. Ekspor bukti seluruh ruang kerja memerlukan akses ke seluruh ruang kerja. | | `sources` | Kelola sumber, snapshot, dan penangkapan profil. Akses terbatas pada obrolan hanya dapat diterapkan pada obrolan yang diizinkan; penemuan sumber dan pengaturan cakupan di seluruh akun tetap dinonaktifkan. | | `collect` | Memulai atau menghentikan pengumpul data. Membutuhkan akses ke seluruh ruang kerja karena pengumpulan data memengaruhi akun. | | `interact` | Lakukan interaksi Telegram yang didukung dalam lingkup akses. Akses terbatas pada obrolan tidak dapat menggunakan pratinjau tautan di seluruh akun. | | `settings` | Ubah pengaturan pengumpulan data, cap waktu, pemberitahuan, salinan di luar situs, dan parameter. Membutuhkan akses ke seluruh ruang kerja. | | `account` | Masuk atau keluar dari Telegram dan kelola rute koneksi. Membutuhkan akses ke seluruh ruang kerja. | | `board.read` | Baca catatan Papan Kasus hanya di dalam ruang kerja dan obrolan yang diizinkan. | | `board.write` | Tambahkan penanda, sorotan, potongan, komentar, serta status terbuka/tinjau. Juga memerlukan ``board.read``. | | `board.manage` | Kelola koleksi, status akhir tim, dan kartu peserta lainnya. Juga memerlukan akses baca/tulis ke papan. | Hanya administrator utama yang dapat mengunduh kunci pemulihan replika di luar lokasi. Akses `settings` atau `account` yang didelegasikan tidak memberikan kunci tersebut. Izin dan cakupan diperiksa secara bersamaan. Mencentang suatu izin tidak akan membuka obrolan lain atau membuka operasi di seluruh ruang kerja untuk akses yang terbatas pada obrolan tertentu. Untuk ekspor paralel, akses harus mencakup obrolan yang diekspor di setiap akun yang dipilih. Akses yang diterbitkan tidak dapat membuat akses baru, mengelola sesi orang lain, atau membuka konsol administrator. ### Tiga pengaturan yang berguna | Orang | Ruang Lingkup | Izin | | --- | --- | --- | | Peninjau | Percakapan yang direkam dari satu kasus | `view` | | Analis yang sedang mempersiapkan serah terima | Percakapan yang akan diselidiki dan diekspor | `view`, `export`; tambahkan `interact` hanya jika mereka harus bertindak melalui Telegram | | Operator pengumpulan data | Ruang kerja yang dipilih secara keseluruhan | `view`, `sources`, `collect`; tambahkan `settings` atau `account` hanya jika diperlukan | Pengaturan awal formulir Akses juga mencakup Papan Kasus: Peninjau dapat membaca, Analis dapat membaca dan menulis, serta Operator dapat mengelolanya. Pengaturan awal tetap dapat diedit, dan izin yang ada tidak secara otomatis diperluas. Lihat [Papan Kasus](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/) untuk cakupan obrolan yang diwarisi dan privasi ekspor. ## Batasan dan sesi | Pengaturan | Cara kerjanya | | --- | --- | | Sesi paralel | Batasi sesi simultan menjadi 1–100. Saat mencapai batas tersebut, tolak upaya masuk berikutnya atau akhiri sesi yang paling lama. | | Masuk diperbolehkan | Batasi penggunaan token yang berhasil untuk memulai sesi. Sesi yang sudah ada tidak akan berakhir hanya karena batas masuk terakhir yang diizinkan telah digunakan. | | Berlaku hingga | Akses ini memiliki batas waktu kedaluwarsa yang mutlak. Akses yang telah kedaluwarsa tidak dapat masuk atau terus melakukan permintaan. | | Menit tanpa aktivitas | Batas waktu ketidakaktifan sesi, mulai dari 5 menit hingga 30 hari. Permintaan yang berhasil akan memperpanjangnya; panel yang terbuka dapat mempertahankan status aktifnya dengan melakukan polling. | | Alamat yang diizinkan | Terima alamat IP tertentu atau subnet CIDR. Biarkan kosong untuk mengizinkan alamat apa pun kecuali jika pengikatan saat masuk pertama kali diaktifkan. | | Terikat pada sesi masuk pertama | Pendaftaran pertama yang berhasil akan menetapkan alamat yang diizinkan untuk akses tersebut. | IP adalah alamat klien yang terlihat oleh aplikasi. Jika berada di balik proxy terbalik atau terowongan, periksa alamat yang ditampilkan di "**Sesi Terbuka"** sebelum mengandalkan aturan IP: jika tidak, beberapa pengguna mungkin tampak berbagi alamat proxy tersebut. ## Mengubah atau mencabut akses Edit entri di bawah "**Akses yang Diberikan"** untuk mengubah cakupan, izin, atau batasannya. Perubahan cakupan dan izin akan diperiksa pada permintaan berikutnya, termasuk permintaan dari sesi yang sudah terbuka. Mencabut akses akan mengakhiri sesi-sesi tersebut dan membuat token yang diterbitkan tidak dapat digunakan lagi. **Sesi yang terbuka** juga memungkinkan administrator mengakhiri sesi individu tanpa mencabut seluruh akses. Salinan ekspor yang disimpan mempertahankan pembuatnya, ruang kerja, cakupan obrolan, dan izin yang diperlukan. Akses yang diterbitkan hanya dapat mencantumkan atau mengunduh salinannya sendiri selama izin tersebut masih berlaku; salinan yang berisi Case Board juga memerlukan `board.read`. Administrator dapat mengambil semua salinan. Salinan lama tanpa metadata ini dan bundel grup hanya dapat diakses oleh administrator. Tiket unduhan dan respons berkas yang telah disiapkan akan memeriksa kembali akses setelah berkas disiapkan, sebelum mengirimkan byte-byte berkas tersebut. Setiap pengguna, termasuk administrator, dapat memiliki sepuluh tiket unduhan yang tertunda per ruang kerja; batas keseluruhan ruang kerja adalah 1,000. Tiket kedaluwarsa setelah 120 detik dan hanya dapat digunakan sekali. Pencabutan tidak dapat menarik kembali berkas yang telah diunduh oleh seseorang. Keluar dari akun, mengunci panel, atau mengakhiri sesi tidak akan menghentikan pengumpul yang sedang berjalan. ## Apa yang dapat dilihat oleh administrator Peninjau dan analis menerima laporan kemajuan pengumpulan data tanpa titik akhir proxy, diagnostik pool, jalur server, atau kesalahan koneksi mentah. Diagnostik koneksi memerlukan izin `account` untuk seluruh ruang kerja. Membaca notifikasi, salinan di luar lokasi, dan pengaturan parameter memerlukan izin `settings`. String User-Agent lengkap dari browser tidak disimpan dalam sesi akses. Pembaruan juga menghapusnya dari cache sesi yang dapat diubah. Log proses panel menyembunyikan literal IP, kredensial URL, dan rahasia berlabel. Log layanan lokal dan catatan jurnal yang telah ditandatangani sebelumnya tidak ditulis ulang. Aturan akses dan catatan masuk yang ditandatangani masih menggunakan alamat klien. ### Ganti kunci utama Gunakan **Alat Lainnya → Akses → Batas Saya → Terbitkan ulang kunci administrator**, atau jalankan `tgwitness token rotate` dari instalasi yang dikelola saat panel sedang berjalan. Semua sesi browser yang ada akan berakhir, termasuk sesi yang dibuka dengan token rekan kerja . Browser yang meminta akan menerima sesi baru; simpan kunci administrator yang baru sebelum menyembunyikannya. Token rekan kerja yang telah diterbitkan tetap berlaku hingga dicabut secara terpisah. Instalasi yang menggunakan `TGWITNESS_TOKEN` harus mengubah pengaturan lingkungan tersebut dan memulai ulang. ### Batas permintaan dan proxy API ini mengizinkan hingga 600 permintaan per menit per klien dan kelompok kredensial: panel, archive/MCP, atau saksi. Waktu tunggu otentikasi berlaku terpisah untuk masing-masing kelompok ini. Sepuluh upaya otentikasi yang ditolak dalam satu menit akan memicu waktu tunggu eksponensial, mulai dari satu detik hingga lima menit. Upaya yang gagal setelah masa pendinginan akan memperpanjangnya; sepuluh menit tanpa upaya yang gagal akan mereset eskalasi. Penolakan mengembalikan HTTP 429 dan `Retry-After` . Batasan disimpan dalam memori, dibagikan di seluruh ruang kerja dalam satu proses panel; restart akan menghapusnya. Streaming langsung dibatasi hingga empat per token pembawa dan 32 untuk proses panel. Membuka streaming juga menghabiskan kuota permintaan API. Badan permintaan memiliki batas waktu penerimaan 60 detik, dikurangi menjadi 10 detik untuk login, akses demo, API arsip, dan jalur witness-head, atau 8 detik untuk transportasi MCP. Setiap aplikasi mengizinkan empat badan yang belum selesai per alamat klien, dengan batas keseluruhan 32 dan 64 MiB alokasi rute yang disediakan. Permintaan tanpa badan tidak menghabiskan slot ini. Badan yang berukuran berlebihan mengembalikan 413, badan yang habis waktu mengembalikan 408, dan kapasitas klien yang terlampaui mengembalikan 429 dengan `Retry-After: 1`. Kapasitas badan pesan keseluruhan yang habis akan mengembalikan kode status 503 dengan `Retry-After`. Header IP yang diteruskan diabaikan kecuali jika rekan TCP yang sebenarnya termasuk dalam `TGWITNESS_TRUSTED_PROXIES` (IP yang dipisahkan dengan koma atau CIDR). Atur `TGWITNESS_PROXY_HEADER` menjadi `x-forwarded-for` atau `cf-connecting-ip`. XFF dilacak dari proxy terdekat menuju rekan pertama yang tidak tepercaya. Metadata alamat tepercaya yang salah format atau duplikat akan ditolak, sehingga tidak dapat mewarisi alamat proxy yang ada dalam daftar putih . Terowongan cepat yang dikelola mempercayai konektor cloudflared lokal; pengaturan domain sendiri mempercayai Caddy lokal. Penerapan langsung secara default tidak mempercayai proxy apa pun. Jika Anda menjalankan Uvicorn sendiri, nonaktifkan pemrosesan header proxy-nya agar batas ini menerima peer yang sebenarnya. `TGWITNESS_PANEL_ALLOWED_IPS` membatasi semua akses panel, termasuk administrator, hanya ke alamat IP atau CIDR yang terdaftar. Probe identitas perutean penginstal tetap publik dan tidak mengembalikan data akun apa pun. Sertakan rute administratif lokal yang diperlukan sebelum mengaktifkan daftar izinkan. Panduan **START-HERE** untuk instalasi terkelola mencakup konfigurasi layanan dan petunjuk pemulihan. Pemilih kueri API `ws` harus mengidentifikasi ruang kerja dalam jalur permintaan; pemilih yang tidak dikenal, tidak cocok, dan duplikat akan ditolak dengan kode status 404. Skrip dan gaya panel membawa metadata integritas SHA-384. Peta impor juga mencakup modul JS yang diimpor secara lokal di peramban yang mendukung integritas peta impor. Respons bahasa yang dihasilkan secara dinamis terpisah. Pemeriksaan ini mendeteksi penggantian aset relatif terhadap halaman yang dikirimkan; halaman itu sendiri dan hash-nya berasal dari server panel, jadi lindungi server tersebut dan jalur pengirimannya. **Log sejak awal ini** menggabungkan log proses dengan aktivitas jurnal dari setiap ruang kerja: masuk, penolakan, perubahan rute, dan tindakan operator. Ini adalah konsol dalam memori untuk proses saat ini, bukan salinan permanen dari setiap pesan. Peristiwa pesan yang sering terjadi tetap tersimpan dalam jurnal daripada memenuhi konsol. Penerbitan, perubahan, dan pencabutan akses, serta memulai atau mengakhiri sesi, juga menghasilkan catatan jurnal `access.*` yang ditandatangani. Token tidak termasuk dalam catatan tersebut. Token yang diterbitkan dan kredensial sesi disimpan sebagai hash di brankas terenkripsi. Masuk QR yang tertunda merupakan bagian dari sesi panel yang memulainya. Mengakhiri atau mencabut sesi tersebut, atau merotasi token panel utama, akan membatalkan klien QR yang tertunda di server. Hal ini juga berlaku ketika browser tidak dapat mengirim permintaan pembatalan sendiri. Rotasi token juga membatalkan proses masuk QR yang dimulai langsung dengan token panel utama. Permintaan QR yang menunggu operasi lain akan memeriksa akses kembali sebelum dimulai. Otorisasi Telegram yang telah selesai dan proses masuk yang tertunda yang dimulai oleh sesi panel lain tetap dipertahankan. ****Administrator utama dan batas kepercayaan**** Token panel utama tetap tidak dibatasi. Masuk ke browser menggunakan token tersebut akan membuat sesi yang tunduk pada batas sesi yang dikonfigurasi oleh administrator. Skrip yang mengirimkan token utama secara langsung tetap memiliki akses penuh dan tidak dihitung sebagai sesi browser. Ini adalah kontrol akses tingkat aplikasi dalam satu instalasi. Semua ruang kerja berbagi proses server; ini bukanlah isolasi dari administrator host. Jaga kerahasiaan token utama, sesi Telegram, kunci penandatanganan, dan direktori data. Token saksi adalah kredensial titik pemeriksaan/kesehatan yang terpisah, bukan token akses panel. --- # Telegram · Koneksi, proxy, dan perlindungan data Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/connection/ Otentikasi, kumpulan proxy otomatis, mode IP, kebijakan cadangan, permintaan eksternal, dan penyimpanan rahasia. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Otentikasi, kumpulan proxy otomatis, mode IP, kebijakan cadangan, permintaan eksternal, dan penyimpanan rahasia. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penerapan dan pemulihan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) ![Penerapan & pemulihan](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Dokumen ini menjelaskan perilaku TgWitness0.9.3 dan batasannya. Otentikasi, akses sumber, konektivitas jaringan, dan kelengkapan penangkapan merupakan status yang terpisah. Untuk langkah-langkah masuk, format berkas, dan akun ganda, mulailah dengan [akun dan format sesi](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/). Untuk kebijakan peristiwa dan perilaku restart, lihat [cara kerja pengumpulan](https://phishdestroy.io/tgwitness/id/docs/reference/collection/). ## Panduan pengaturan koneksi Di **menu Alat Lainnya → Akun → Rute Koneksi**, administrator dapat memilih **Akun ini**, **Grup akun,** atau **Semua akun**, lalu memilih sebuah rute. **Pilihan Tinjau** menampilkan daftar akun yang terpengaruh. Opsi **Siapkan dan Periksa** menguji rute yang diusulkan tanpa mengubah rute yang telah disimpan. **Opsi Terapkan Koneksi yang Telah Diperiksa** memvalidasi pratinjau, menjeda pemantauan jika diperlukan, menyimpan rute, dan melanjutkan pemantauan yang sebelumnya sedang berjalan. Pengumpulan data tidak akan pernah dimulai di akun yang sebelumnya tidak aktif. Unduhan riwayat tetap dijeda dan dapat dilanjutkan secara terpisah. Jeda ekspor yang sedang aktif sebelum beralih. Perubahan grup secara default mempertahankan akun dengan rute masing-masing. Hapus opsi tersebut hanya jika pratinjau mencantumkan perubahan yang Anda inginkan. Aplikasi melaporkan hasil setiap akun; ini bukan transaksi "semua atau tidak sama sekali" yang mencakup seluruh basis data. Peralihan yang gagal akan mengembalikan pengaturan sebelumnya pada akun tersebut. Kegagalan dalam melanjutkan akan ditampilkan secara eksplisit. Pratinjau kedaluwarsa setelah sepuluh menit dan perubahan pada pengaturan koneksi atau keanggotaan grup memerlukan pemeriksaan ulang. Fitur "Apply" menggunakan kembali hasil pemeriksaan awal yang berhasil selama maksimal 90 detik jika rute, mode, dan kebijakannya tidak berubah. Terowongan yang dikelola harus tetap memiliki proses yang sedang berjalan yang sama. Hasil yang lebih lama, proses terowongan yang telah diubah, dan rute kumpulan MTProxy otomatis akan diperiksa kembali. Catatan aplikasi yang ditandatangani menyimpan waktu pemeriksaan asli serta mencatat penggunaan kembali dan lamanya waktu. Setiap pemeriksaan awal menutup klien sementara yang belum diautentikasi; pengumpul terhubung menggunakan sesi terotorisasi miliknya sendiri. | Rute | Apa yang dikelola oleh TgWitness | | --- | --- | | Langsung | Koneksi dari host; VPN host eksternal tidak terdeteksi atau tidak diberlakukan. | | VPN | Satu profil WireGuard dengan tunnel penuh per akun, dijalankan oleh proses SOCKS5 di ruang pengguna lokal. Tidak ada antarmuka host atau driver yang diinstal. | | Proksi saya | Kredensial SOCKS5, HTTP CONNECT, atau MTProxy. Sebuah URL dapat diisi pada kolom SOCKS5/HTTP. Memilih beberapa akun akan membagikan proxy yang dimasukkan ini. | | MTProto Publik | Pool yang ada menetapkan rute Telegram. Permintaan eksternal dinonaktifkan hingga proxy terpisah yang sesuai dikonfigurasi di pengaturan lanjutan. | | WARP | Terowongan lokal terpisah untuk setiap akun yang dipilih, dengan pendaftaran WARP dan profil WireGuard yang disimpan di brankas akun tersebut. | Pemeriksaan rute saat ini menggunakan koneksi Telegram baru yang belum diautentikasi, bukan sesi akun tersebut. Pemeriksaan ini membuka koneksi melalui rute ke pusat data akun dan melakukan satu kali perjalanan bolak-balik MTProto yang belum diautentikasi (`req_pq_multi`); proses ini tidak membuat kunci otorisasi dan tidak menggunakan akun apa pun. Latensi yang dilaporkan adalah waktu koneksi ditambah waktu bolak-balik tersebut, dan pemeriksaan mencatat kedua bagian tersebut secara terpisah. Untuk rute yang mendukung HTTP, pemeriksaan ini juga meminta jejak HTTPS Cloudflare melalui rute tersebut dan menampilkan IP keluar yang dilaporkan, negara, status WARP, dan waktu pemeriksaan. Persiapan WARP akan gagal kecuali jika jejak melaporkan bahwa WARP aktif. Pemeriksaan awal ini melaporkan konektivitas rute dan titik keluar yang teramati. Tinjau catatan yang ditangkap melalui hasil akuisisi dan verifikasi arsip. Proses lokal yang sedang berjalan saja tidak cukup untuk dianggap sebagai pemeriksaan titik keluar yang berhasil. Panel ini mencatat rata-rata bergerak dari lima pemeriksaan terakhir. Sebuah rute dianggap **lambat** jika rata-rata tersebut melebihi 5 detik atau tiga pemeriksaan berturut-turut melebihi batas tersebut, dan **tidak tersedia** setelah dua pemeriksaan gagal berturut-turut; `network.slow_route` dan `network.route_recovered` mencatat perubahannya. Untuk rute WARP yang lambat, **Re-roll WARP** memulai ulang terowongan akun tersebut ke titik akhir Cloudflare WARP lainnya, mempertahankan yang tercepat, dan mencatat `network.warp_rerolled` bersama waktu sebelum dan sesudahnya; **Identitas WARP baru** mendaftarkan perangkat WARP baru dan mempertahankannya hanya jika lebih cepat. Alamat proxy lokal, akun Telegram, dan sesinya tetap sama; koneksi Telegram terhubung kembali melalui terowongan yang telah dimulai ulang. Rute WARP yang lambat secara otomatis di-re-roll paling banyak sekali setiap 30 menit; jika hal itu tidak membantu, re-roll selanjutnya menunggu intervensi operator. ### WARP dan WireGuard yang portabel Ini adalah integrasi WARP tidak resmi **** menggunakan [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1) dan [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3). Administrator secara eksplisit menyetujui pengaturan sebelum unduhan pertama atau pendaftaran WARP. Koneksi pengaturan tersebut terhubung langsung ke GitHub dan Cloudflare serta mengungkapkan alamat IP mesin. Lalu lintas akun biasa tetap menggunakan rute yang ada hingga aplikasi. Cloudflare memilih alamat keluar dan negara; terowongan terpisah dapat berbagi alamat keluar yang sama. Pemilihan negara, rotasi IP berkala, dan kill switch VPN untuk seluruh host tidak disediakan oleh fitur ini. Unduhan helper yang didukung: Linux dan macOS x86-64/ARM64, serta Windows x86-64. Artefak diperiksa berdasarkan hash SHA-256 yang disertakan dalam sumber yang telah ditinjau, dan file eksekusi yang disimpan dalam cache diperiksa kembali sebelum dijalankan. Tidak ada program bantu yang ditambahkan ke PATH, diinstal sebagai layanan sistem, atau diberi pendengar publik. Semua berkas berada di bawah direktori `portable-routes/` ruang kerja dan entri brankas terenkripsi. Pendengar loopback SOCKS5 memerlukan kredensial yang dihasilkan secara independen. Profil pribadi dan kredensial akun WARP dienkripsi menggunakan brankas ruang kerja yang ada. Saat berjalan, helper memerlukan konfigurasi teks biasa yang hanya dapat diakses pemilik; konfigurasi ini dihapus saat penghentian normal. Kerusakan host dapat meninggalkan berkas ini di folder data khusus pemilik. Hal ini tidak mengenkripsi disk atau melindungi dari administratornya. Pengawas akan menutup terowongan jika pipa induk panel menghilang. Terowongan yang gagal tidak pernah mengaktifkan fallback langsung. Restart panel akan memulihkan terowongan yang dipilih; upaya awal yang gagal akan dicoba ulang dengan penundaan terbatas. **Hentikan terowongan** juga menghentikan sementara pemantauan dan mempertahankan status terhenti. **Mulai terowongan** memulai terowongan; lanjutkan pemantauan secara terpisah saat sudah siap. Profil WireGuard yang diunggah harus berisi satu Antarmuka dan satu Peer, rute IPv4 dan IPv6 lengkap, serta tidak boleh ada hook, include, substitusi lingkungan, atau listener tambahan. Alamat titik akhir publik diselesaikan dan ditetapkan sebelum startup. Gunakan VPN eksternal atau gerbang SOCKS5 untuk OpenVPN/IPsec dan titik akhir pribadi. ## Metode otentikasi **API ID dan API hash mengidentifikasi sebuah aplikasi; keduanya tidak menggantikan proses login akun.** Keduanya bersifat opsional di TgWitness. Urutan prioritas: pasangan yang dimasukkan melalui formulir, kemudian pasangan dari berkas JSON akun yang diimpor, lalu pasangan yang disimpan di ruang kerja, kemudian kumpulan bawaan berisi 50 pasangan publik, dicoba dalam urutan acak dengan rotasi otomatis saat Telegram menolak salah satunya. Hanya pasangan Telegram Desktop (2040) yang dikirim bersama deskripsi klien Telegram Desktop yang sesuai. Pasangan Anda sendiri dari Alat Pengembangan API di [my.telegram.org](https://my.telegram.org) dapat digunakan dengan semua akun Anda; setiap akun tetap memiliki otorisasi tersendiri. | Metode | Persyaratan | Dukungan TgWitness | | --- | --- | --- | | Nomor telepon, kode, 2FA (opsional) | Akses akun; pasangan API opsional | Panel masuk | | Kunci Otentikasi HEX + ID DC | Kunci lengkap 512 karakter dan DC 1–5 | Tab **Kunci Otorisasi** Langsung; ID Pengguna opsional diperiksa sebelum otorisasi disimpan | | Telethon StringSession | String sesi yang valid | Panel masuk | | Telethon SQLite `.session` | Teks yang tertutup dan konsisten | Impor skema langsung melalui panel 7/8; CLI offline opsional | | Pyrogram SQLite `.session` | Sesi pengguna produksi telah ditutup | Impor skema langsung melalui panel 2/3 | | Telegram Desktop TData ZIP | Satu akun modern; kode sandi lokal jika dilindungi | Konversi dalam memori dengan pemeriksaan checksum dan dekripsi | | JSON Akun | Bidang API/sesi/kunci yang didukung | Metadata saja sudah cukup untuk mengisi kredensial API; namun, login menggunakan sesi/kunci atau nomor telepon/QR code tetap diperlukan | | Masuk dengan QR | Konfirmasi dari aplikasi Telegram yang resmi | Pembuatan QR lokal, masa berlaku/percobaan ulang, 2FA opsional | | TDLib / Pyrogram StringSession | Format khusus perpustakaan lainnya | Tidak didukung | | Token bot | Sebuah bot dengan model akses/pembaruan tersendiri | Tidak digunakan oleh pengumpul ini | Telegram memilih metode pengiriman kode, termasuk apakah akan mengirim SMS. Hash API tidak dapat memulihkan sesi yang dicabut atau mengganti kata sandi 2FA yang terlupa. TgWitnesstidak menyimpan kode login atau kata sandi 2FA Telegram ke disk. Untuk sumber pribadi, akun tersebut harus sudah memiliki akses. Nama pengguna grup tidak diperlukan. Proksi atau impor sesi tidak memberikan hak keanggotaan maupun hak administrator. Pengaturan obrolan menentukan apakah anggota dapat melihat riwayat sebelum mereka bergabung. ## Impor berkas sesi Telethon Telethon SQLite, Pyrogram SQLite, dan Telegram Desktop TData menggunakan format yang berbeda-beda. Panel ini mendeteksi dan mengonversi struktur yang didukung; mengganti nama berkas bukanlah proses konversi. Pilih satu sesi dan berkas JSON yang menyertainya di bawah **menu Files**, tekan **Check files**, lalu **Connect account**. Maksimal empat berkas yang cocok dan total 8 MiB dapat diterima. Lihat [batasan format](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/) untuk detail TData/JSON. Tidak ada pemulihan kode sandi. Masuk melalui telepon/2FA atau QR akan membuat otorisasi terpisah. Jalur baris perintah opsional khusus Telethon tetap tersedia: 1. Hentikan klien yang menggunakan sesi asli dan buat salinan yang konsisten. Konverter akan menolak berkas dengan WAL/jurnal yang belum selesai. Tutup klien asli dengan benar, bukan dengan menghapus berkas-berkas tersebut untuk menghindari pemeriksaan. 2. Dari lingkungan TgWitness, jalankan: ``` python -m tgwitness.sessions account.session --out account.tgwitness-session ``` 1. Di bawah **Tambahkan akun → File**, unggah hasilnya atau tempelkan stringnya, lalu lanjutkan. 2. Periksa ID akun numerik yang ditampilkan, pilih sumber, dan mulailah pemantauan. **File yang dikonversi merupakan rahasia akses akun yang tidak terenkripsi.** Simpanlah di tempat penyimpanan yang terlindungi dan jangan pernah mengunggahnya atau mengirimkannya ke layanan konversi pihak ketiga. TgWitness menyimpan sesi otorisasi di brankas terenkripsinya. Menyalin sesi tidak akan menciptakan otorisasi terpisah: jangan jalankan klien secara bersamaan dengan kunci otorisasi yang dikloning dan mengasumsikan pengiriman pembaruan yang independen. Konversi mentransfer otorisasi, bukan pesan asli, cache entitas, atau kursor pembaruan yang tahan lama. Konversi ini tidak memastikan pemulihan pembaruan saat proses dimulai ulang. ## MTProto, Telethon, dan proxy MTProto adalah protokol Telegram. Telethon adalah pustaka klien Python yang digunakan oleh TgWitness. MTProxy adalah proxy transportasi Telegram; SOCKS5 dan HTTP CONNECT menyediakan terowongan umum. Tidak ada yang menggantikan otentikasi akun. Simpan rute untuk setiap ruang kerja di **Alat Lainnya → Akun → Pengaturan → Pengaturan koneksi → Ubah rute koneksi** sebelum masuk. Ruang kerja baru secara default menggunakan **MTProxy Otomatis · daftar publik** dengan **Sembunyikan alamat**. Ruang kerja yang sudah ada yang secara eksplisit menggunakan Langsung tetap mempertahankan mode yang mengizinkannya. File dibaca melalui koneksi terpisah dari koneksi yang digunakan untuk membaca pesan, seperti yang dilakukan oleh aplikasi resmi. Di pusat data milik akun tersebut, kunci otorisasi akun digunakan kembali dengan sesi MTProto baru; untuk pusat data lain, satu kunci dibuat dan diotorisasi saat akun terhubung, serta disimpan hanya di memori. Setiap koneksi file menggunakan rute yang sama dengan akun tersebut. Jumlahnya per pusat data dibatasi oleh **Parameter → Kinerja → Koneksi berkas per pusat data Telegram**; nilai 0 berarti berkas hanya dibaca melalui koneksi utama akun. Paling banyak lima koneksi Telegram dapat dibuat sekaligus di seluruh akun dalam satu instalasi. ## Mode IP Rute menentukan koneksi. Mode IP, yaitu pengaturan **perlindungan IP** di bagian Akun pada panel, menentukan kapan alamat server dapat terungkap. Kontrol ini tidak menginstal VPN atau mengalihkan seluruh lalu lintas perangkat. | Mode | Telegram | Permintaan eksternal | | --- | --- | --- | | Sembunyikan alamat (`hide`) | Gunakan proxy; tunggu jika tidak ada yang berfungsi. Tidak ada opsi cadangan langsung. | Memerlukan SOCKS5/HTTP; menolak permintaan tanpa proxy yang sesuai. | | Gunakan Direct sebagai pilihan terakhir (`fallback`) | MTProxy otomatis mungkin menggunakan Direct setelah penundaan yang dikonfigurasi, kemudian kembali ke proxy yang berfungsi. | Disarankan menggunakan proxy eksternal yang telah dikonfigurasi atau rute SOCKS5/HTTP akun; jika tidak, opsi Direct diperbolehkan. | | Server yang berada di balik terowongan atau VPN (`tunnel`) | Rute langsung dan pengalihan otomatis ke pool cadangan diperbolehkan. | Akses langsung diperbolehkan jika tidak ada proxy yang dikonfigurasi. | Mode terowongan atau VPN mengasumsikan Anda mengelola jaringan tersebut secara terpisah. Tanpa terowongan yang berfungsi, tujuan dapat melihat alamat server itu sendiri. Pilih mode sesuai dengan jaringan Anda yang sebenarnya, bukan berdasarkan nama opsi tersebut. ### Pilih jalur | Rute | Pengaturan | Batasan | | --- | --- | --- | | MTProxy Otomatis | Daftar bawaan atau katalog operator | Menjaga rute Telegram yang berfungsi; fallback langsung bergantung pada mode IP | | Langsung | Mode terowongan atau VPN | Telethon menggunakan rute jaringan tuan rumah | | SOCKS5 | Host, port, nama pengguna/kata sandi (opsional) | python-socks, DNS tujuan jarak jauh diaktifkan | | HTTP CONNECT | Host, port, nama pengguna/kata sandi (opsional) | HTTP CONNECT biasa; TLS ke proxy itu sendiri belum diimplementasikan | | MTProxy | Host, port, rahasia | Transportasi Telethon eksperimental; 32 digit heksadesimal atau `dd` + 32 digit heksadesimal | Rahasia TLS palsu `ee` ditolak. Normalisasi Telethon 1.45 dapat menghilangkan awalan dan domain, tetapi hal itu tidak mengimplementasikan TLS palsu. Tempelkan `tg://proxy?server=…&port=…&secret=…` atau `https://t.me/proxy?server=…&port=…&secret=…` dan pilih **"Isi bidang dari tautan**". Ini akan memvalidasi dan mengisi kolom tanpa terhubung atau menyimpan; tinjau dan simpan rute secara terpisah. Kolom manual tetap tersedia. Lihat [tautan proxy Telegram](https://core.telegram.org/api/links#proxy-links). ### Proksi publik yang disediakan oleh instalasi Anda Daftar bawaan ini menggabungkan tujuh sumber: [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto), [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro), [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector), [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector), [Therealwh/MTPproxyLIST](https://github.com/Therealwh/MTPproxyLIST), [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) dan [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list). Snapshot yang disertakan berisi informasi titik akhir, atribusi sumber, dan tanggal unduhan. Daftar tersebut merupakan masukan; pemeriksaan konektivitas di bawah ini menentukan proxy mana yang akan digunakan. **MTProxy otomatis** memeriksa konektivitas transportasi Telegram, mempertahankan proxy yang berfungsi dan beralih ke proxy lain saat proxy tersebut gagal. Ruang kerja lebih memilih proxy yang berbeda jika tersedia cukup entri yang berfungsi; proxy dapat berbagi alamat keluar. Proxy yang gagal beristirahat sebelum upaya berikutnya. Jika tidak ada yang berfungsi, mode IP menentukan apakah pengumpulan harus menunggu atau boleh menggunakan koneksi langsung. Mengganti proxy tidak mengubah akun atau menghapus jurnalnya. Pilihan dan perubahan rute dicatat dalam jurnal yang ditandatangani. Selama rute otomatis aktif, daftar diperbarui setiap jam dan pemeriksaan pengiriman dijalankan setiap sepuluh menit secara default. Interval-interval ini dapat dikonfigurasi. Permintaan **pembaruan daftar publik** memicu pembaruan; hanya melihat daftar saja tidak mengubah rute manual yang telah disimpan. **Lalu lintas Telegram dan permintaan HTTPS menggunakan rute yang berbeda.** Unduhan daftar menggunakan koneksi HTTPS terpisah dan rute permintaan eksternal yang disediakan. ``TGWITNESS_PROXY_FEED_PROXY`` secara eksplisit mengganti rute tersebut dengan proxy HTTP/SOCKS5; kedua varian pengumpul Compose meneruskannya. Kolam latar belakang mengikuti ruang kerja utama. Tidak ada sesi Telegram, kredensial API, token panel, atau token bot yang dikirim ke penyedia umpan. Nama penyedia, tanggal snapshot, dan rute unduhan tercantum di bagian **“Dari mana daftar ini berasal**”. Sebuah MTProxy hanya mengangkut lalu lintas Telegram. Operasi HTTP ruang kerja seperti cap waktu, pemberitahuan, salinan di luar situs, dan pemeriksaan sumber menggunakan proxy SOCKS5/HTTP terpisah saat dikonfigurasi, kemudian rute SOCKS5/HTTP akun tersebut. Tanpa keduanya, "Sembunyikan alamat" akan menolak permintaan; mode lainnya mengizinkan "Langsung". Permintaan eksternal dapat dinonaktifkan. Proxy unduhan umpan yang dikonfigurasi secara eksplisit tetap menjadi pengaturan operator terpisah. Layanan saksi independen mempertahankan rutenya sendiri. Untuk layanan pribadi yang dikelola operator, pengaturan lingkungan server yang ada `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1` mengizinkan tujuan pribadi dan mempertahankan resolusi nama host di sisi proxy. Pengaturan ini tidak dapat diaktifkan dari panel. Mode khusus publik menolak tujuan `.onion` sebelum melakukan kueri ke resolver publik; layanan onion Tor memerlukan pengaturan tujuan pribadi yang eksplisit dan proxy yang sesuai. Perilaku DNS ini berlaku untuk operasi HTTP eksternal, bukan transportasi Telegram. Cloudflare mendokumentasikan [titik akhir DNS JSON](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/). ****Parameter kolam otomatis**** Di bawah **More tools → Parameters → Automatic MTProxy**, konfigurasikan ambang batas kegagalan, waktu tunggu, rotasi terjadwal, berbagi proxy, dan penundaan fallback yang diizinkan. | Kontrol | Default | | --- | --- | | Terputus sebelum penggantian | 3 dalam 10 menit | | Proksi yang dicoba per upaya koneksi | 3 | | Istirahat pertama / maksimum setelah kegagalan | 10 menit / 6 jam | | Rotasi yang direncanakan | Dinonaktifkan; aktifkan jika terjadi kegagalan | | Akun per proxy | 0: utamakan entri terpisah, gabungkan jika diperlukan. Atur 1 untuk menunggu entri eksklusif. | | Penundaan sebelum fallback langsung diizinkan | 10 menit; Menyembunyikan alamat masih ditolak secara langsung | | Pemeriksaan penyegaran / pengiriman data | Notulen 60/10; nilai ruang kerja utama berlaku untuk kumpulan bersama | Proksi yang berbeda dapat berbagi alamat keluar. Batasan Telegram berlaku pada setiap rute. Untuk mengganti daftar publik dengan katalog operator Anda sendiri, konfigurasikan pengaturan penggantian di bawah ini. Pengaturan ini menonaktifkan langganan eksternal sepenuhnya, termasuk ketika array `proxies`-nya kosong. Salin [katalog kosong](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example) ke `proxy-config/proxies.json` dan tambahkan titik akhir publik yang telah Anda terapkan: ``` {"format": "tgwitness-proxy-catalog-v1", "proxies": [ {"id": "project-eu", "label": "Project EU", "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"} ]} ``` Nilai-nilai contoh harus diganti. Maksimal 32 entri berbeda dapat diterima. Daftar yang terotentikasi mengembalikan label/host/port tanpa rahasia bersama; memilih salah satunya akan menyimpan kredensialnya ke dalam brankas ruang kerja. Ketersediaan belum diuji hingga dilakukan uji transportasi secara eksplisit. Katalog yang tidak valid memungkinkan konfigurasi manual. Peluncuran lokal: atur `TGWITNESS_PROXY_CATALOG` ke jalur JSON lokal. Docker: ``` docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build ``` Overlay dipasang sebagai `proxy-config` read-only; berkas harus dapat dibaca oleh UID kontainer 10001. Direktori tersebut dikecualikan dari Git, konteks build Docker, dan arsip sumber. Katalog ini mengonfigurasi akun-akun pengumpul; [bot saksi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/) menggunakan rute HTTP/SOCKS5-nya sendiri, bukan MTProxy. Pengalihan langsung diatur oleh mode IP di atas. Jeda pengamatan sebelum mengubah rute. Penyimpanan akan memutuskan koneksi klien lama dan membatalkan proses login yang belum selesai; klien baru akan menggunakan rute yang disimpan. Pengikatan jurnal/sesi akun tetap berlaku. Pengaturan akan menggantikan rute sebelumnya: masukkan kembali kredensial proxy saat mengeditnya. Kredensial dienkripsi menggunakan `network.enc`. API tidak mengembalikan nama pengguna, kata sandi, atau rahasia. Catatan yang ditandatangani berisi jenis rute dan apakah kredensial terdapat di dalamnya, tanpa menyertakan titik akhir dan rahasia. Operator dapat melihat titik akhir di panel. Bidang rahasia akan dihapus setelah menyimpan, mengunci, atau beralih antar ruang kerja. **Uji koneksi Telegram**, juga tersedia sebelum masuk, membuka dan menutup koneksi Telegram sementara yang tidak sah melalui rute tersebut. Fitur ini tidak menghubungi situs web pemeriksaan IP. Keberhasilan uji ini menunjukkan terjalinnya konektivitas transportasi, bukan akses ke grup, pengiriman yang lengkap, atau anonimitas. Proksi ini berlaku untuk koneksi klien Telegram, termasuk unduhan media dari server distribusi (DC) Telegram. Alat-alat seperti browser, pip, SSH, dan TSA yang dijalankan secara manual memiliki rute terpisah. Nama host proksi dapat diresolusi secara lokal. `rdns` memengaruhi nama host tujuan; Telegram sering kali menyediakan alamat IP numerik dari server distribusi (DC). SOCKS5 dan HTTP CONNECT biasa tidak mengenkripsi kredensial proxy atau terowongan klien-ke-proxy itu sendiri. MTProto secara terpisah melindungi lalu lintas Telegram. Gunakan saluran aman yang sesuai ke proxy pada jaringan yang tidak tepercaya. Grup pribadi adalah obrolan cloud yang dilindungi oleh MTProto selama pengiriman; Obrolan Rahasia ujung-ke-ujung adalah jenis obrolan terpisah, yang direkam oleh [modul Obrolan Rahasia](https://phishdestroy.io/tgwitness/id/docs/reference/secret-chats/). ## Enkripsi dan tanda tangan | Lapisan | Telah diterapkan | Tanggung jawab operator | | --- | --- | --- | | Lalu lintas Telegram | Telethon MTProto | Kepercayaan, rute, dan ketersediaan platform | | Panel web | Token pembawa, pengaturan default loopback, batas permintaan | HTTPS atau terowongan SSH untuk akses jarak jauh | | Rahasia | Fernet untuk kredensial API, sesi, kredensial proxy, dan kunci pribadi penandatanganan | Lindungi kunci dekripsi dan host yang sedang berjalan | | Kunci brankas | Kunci lokal, atau kunci utama eksternal untuk instalasi baru | Penyimpanan terpisah yang dilindungi dan cadangan kunci | | Pesan dan lampiran | Penyimpanan aplikasi dalam bentuk teks biasa | Disk/volume terenkripsi | | ZIP/JSONL/CSV/HTML | Pemeriksaan integritas, tanpa enkripsi konten | Lindungi salinan yang diekspor dan transfer | | Asal-usul dan waktu | Jurnal yang ditandatangani, tanda terima proses, alat RFC 3161 | Kunci tepercaya, titik pemeriksaan independen/TSA, dan prosedur penyimpanan | **Perlindungan penyimpanan** di Akun menampilkan status-status ini. Token panel adalah kunci akses, bukan kata sandi enkripsi. Token ini memberikan akses administrator; [token yang diterbitkan](https://phishdestroy.io/tgwitness/id/docs/reference/access/) dapat dibatasi cakupannya ke akun dan obrolan. Ruang kerja berbagi proses host dan bukan penyewa yang terisolasi. BitLocker, LUKS, FileVault, atau volume terenkripsi yang dikelola dapat melindungi penyimpanan sesuai dengan model ancaman masing-masing. Seorang administrator pada mesin yang sedang berjalan dan tidak terkunci masih dapat membaca data. Sertakan SQLite WAL/SHM, media, ekspor sementara, swap, cadangan, dan unduhan browser dalam perencanaan penyimpanan. Volume Docker tidak otomatis terenkripsi hanya karena statusnya sebagai volume. ## Kunci utama eksternal Untuk instalasi **baru**, letakkan kunci utama di luar direktori data. Hal ini tidak secara otomatis memigrasikan brankas kunci lokal yang sudah ada. Siapkan direktori kunci yang hanya dapat diakses oleh identitas layanan, lalu jalankan: ``` python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key python -m tgwitness --data-dir /private/observations/new-case ``` PowerShell, menggunakan lingkungan proyek yang telah diinstal: ``` python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key $env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key' python -m tgwitness --data-dir E:\PrivateData\new-case ``` Di Docker, pasang berkas tersebut sebagai read-only di luar `/data`, misalnya di `/run/secrets/tgwitness-master.key`, dan atur variabel lingkungan ke jalur tersebut. UID layanan harus memiliki izin baca terhadap berkas tersebut. Sampaikan jalurnya, bukan byte kunci, melalui berkas lingkungan/konfigurasi. Setiap ruang kerja menerima salt publik acak dan kunci Fernet-nya sendiri yang diturunkan melalui HKDF-SHA256. `vault.external.json` menyimpan metadata derivasi, bukan kunci utama. Kunci yang hilang atau salah akan menyebabkan kegagalan saat memulai tanpa menggantinya secara diam-diam. Simpan baik metadata salt maupun kunci utama untuk pemulihan. Semua ruang kerja berasal dari kunci utama yang sama; jika kunci tersebut bocor, hal itu akan memengaruhi seluruh instalasi. Proses yang sedang berjalan dapat mendekripsi rahasia. Ini bukanlah HSM atau KDF kata sandi. Kata sandi buatan manusia yang sembarangan tidak diterima sebagai pengganti kunci acak. Simpan kunci yang ada untuk instalasi yang sudah ada hingga migrasi yang disengaja dilaksanakan dan diverifikasi. Menghapus `vault.key` atau mengganti kunci utama dapat menghancurkan akses ke sesi/kunci penandatanganan. Simpan cadangan terenkripsi dan kunci secara terpisah, serta uji pemulihan di instance yang terisolasi. --- # Telegram · Penerapan Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/deployment/ Jalankan TgWitness sebagai layanan di Windows, Linux, macOS, atau Docker, melalui HTTPS, dengan fitur pencadangan dan pembaruan. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Jalankan TgWitness sebagai layanan di Windows, Linux, macOS, atau Docker, melalui HTTPS, dengan fitur pencadangan dan pembaruan. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Penerapan & pemulihan](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **Bahasa Inggris** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [Ukraina](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [Português (Brasil)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [Bahasa Turki](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [العربية](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [Urdu](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [Hindi](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [Bahasa Indonesia](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [Bahasa Vietnam](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [Bahasa Mandarin (Sederhana)](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md) ## Pilih metode instalasi Untuk paket portabel, ekstrak `TgWitness--windows-amd64-portable.zip` dari GitHub Releases. Untuk metode lainnya, unduh dan ekstrak berkas ZIP sumber atau kloning repositori, lalu jalankan perintah berikut dari direktori proyek: | Instalasi | Mulai | Berjalan di latar belakang? | | --- | --- | --- | | Paket portabel untuk Windows | `TgWitness.cmd` | Tidak; biarkan jendela tetap terbuka. | | Aplikasi asli Windows | `Start.cmd` | Tidak; gunakan tugas masuk opsional untuk penggunaan di latar belakang. | | Dukungan asli untuk Linux/macOS | `sh start.sh` | Tidak; gunakan systemd/launchd untuk penggunaan di latar belakang. | | Docker di host apa pun yang didukung | `docker compose up -d --build --wait` | Ya, selama daemon Docker sedang berjalan. | | Pembantu Docker di Windows | `scripts\Docker.cmd` | Ya; program bantu tersebut menunggu status kesehatan server web. | | Pembantu Docker di Linux/macOS | `sh scripts/docker-start.sh` | Ya; program bantu tersebut menunggu status kesehatan server web. | Untuk server cloud yang dapat diperiksa oleh pihak ketiga — dibuat melalui API penyedia layanan, tanpa SSH, dan hanya dapat diakses melalui Cloudflare Tunnel — lihat [penerapan dengan jaminan tinggi](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/). Proses startup asli membuat `.venv` pribadi dan menginstal dependensi yang disematkan. Docker membangunnya di dalam gambar, tanpa memerlukan Python host. Pengaturan pertama kali memerlukan akses internet. Jika Python 3.11+ tidak ditemukan, `Start.cmd` akan meminta izin sebelum menginstal Python 3.12 untuk pengguna Windows saat ini (menggunakan winget, atau jika tidak, penginstal python.org setelah memeriksa tanda tangan Python Software Foundation-nya); alat ini tidak pernah meminta hak akses administrator. Docker dan layanan sistem operasi tetap menjadi prasyarat. Instalasi native dan portabel menggunakan `data/live` di dalam foldernya. Docker menggunakan volume bernama `tgwitness-data` di `/data`. Ini adalah instalasi terpisah hingga Anda secara sengaja memigrasikan direktori data secara keseluruhan. Jangan berharap kontainer Docker baru akan mendeteksi akun native secara otomatis. ## Persyaratan instalasi Instalasi asli memerlukan Python 3.11 atau yang lebih baru dengan `venv` dan `ensurepip`, akses internet untuk instalasi dependensi pertama, serta direktori proyek yang dapat ditulis untuk `.venv`. Panel yang disertakan tidak memerlukan Node.js atau build frontend. Jalankan peluncur dari akun OS biasa Anda; TgWitness tidak memerlukan hak akses administrator/root. - **Windows:** `Start.cmd` memeriksa `py -3`, lalu `python`, kemudian folder instalasi default per-pengguna dan Program Files, serta memerlukan versi 3.11 atau yang lebih baru. Jika tidak ada yang berhasil, maka akan ditawarkan instalasi otomatis per-pengguna seperti yang dijelaskan di atas. `py -3 start.py` juga berfungsi. Paket portabel sama sekali tidak memerlukan Python. - **Linux:** `start.sh` mencoba `python3.13`, `python3.12`, `python3.11`, `python3`, dan `python`, serta menampilkan perintah instalasi untuk apt, dnf, pacman, zypper, apk, atau Homebrew jika tidak ada yang memenuhi syarat. Instalasi Debian/Ubuntu mungkin memerlukan paket `python3-venv` yang sesuai dengan interpreter yang dipilih. Python bawaan versi lama pada suatu distribusi harus diganti atau dilengkapi dengan Python 3.11+. - **macOS:** instal distribusi Python 3.11+ terbaru; jangan berasumsi bahwa interpreter yang disediakan sistem operasi sudah memenuhi persyaratan. Gunakan `python3 start.py` dari direktori proyek. - **Docker:** gunakan Docker Engine/Desktop dengan Compose v2.20 atau yang lebih baru. Docker Desktop harus menggunakan kontainer Linux di Windows. Kontainer tersebut menginstal ketergantungan Python-nya sendiri; host tidak memerlukan instalasi Python terpisah. ## Komputer lokal Gunakan `Start.cmd` di Windows atau `sh start.sh` di Linux/macOS. `scripts\Setup.cmd` atau `sh start.sh --setup-only` mempersiapkan lingkungan. Peluncur akan menginstal dependensi pada penggunaan pertama; peluncuran selanjutnya akan menggunakan kembali lingkungan tersebut. Akses internet diperlukan untuk pengaturan dan pengumpulan pesan Telegram, namun penelusuran catatan yang ada dan pembuatan ekspor dapat dilakukan secara offline. Jalankan `python start.py --check` setelah pengaturan untuk memeriksa dependensi lokal, Ed25519, penyimpanan, konfigurasi kunci, dan alamat pendengar tanpa memulai pengumpul. Gunakan `--json` untuk keluaran terstruktur. Jalankan `--data-dir`, `--host`, dan `--port` sesuai kebutuhan. Pemeriksaan ini tidak menginstal paket, membuat jurnal, atau menghubungkan Telegram; ini bukan penilaian integritas atau cakupan. Proses startup memverifikasi secara terpisah jurnal yang sudah ada. `python start.py --help` juga menghindari instalasi. Setelah menjalankan start.py, jalankan perintah tambahan dengan `.venv\Scripts\python.exe` di Windows atau `.venv/bin/python` di Linux/macOS, atau aktifkan lingkungan tersebut terlebih dahulu. Contoh `python -m ...` di bawah ini mengasumsikan bahwa lingkungan tersebut sudah aktif. ``` python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787 ``` Variabel lingkungan: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE memilih mode kunci eksternal untuk instalasi baru; lihat [Kunci utama eksternal](https://phishdestroy.io/tgwitness/id/docs/reference/security/#external-master-key). TGWITNESS_TOKEN, jika disediakan, harus berisi setidaknya 24 karakter; gunakan nilai acak yang dihasilkan secara kriptografis. Tanpa variabel tersebut, aplikasi akan menghasilkan token acak 256-bit di file panel-token.txt. Penggantian variabel lingkungan tidak akan menimpa file tersebut. Mulai ulang untuk merotasi kredensial. Tepat satu proses saja yang boleh mengelola direktori data. Kunci file lintas platform OS mencegah penulisan bersamaan yang tidak disengaja. Gunakan satu pekerja Uvicorn. Panel dapat mengelola sejumlah ruang kerja, dengan direktori ruang kerja tambahan di bawah profiles//. Untuk instance layanan yang terpisah, gunakan direktori dan port yang terpisah. File WAL SQLite harus disimpan di penyimpanan lokal yang persisten, bukan di sistem berkas jaringan. Jangan berbagi satu volume di antara replika. ## Paket portabel untuk Windows Setiap Rilis GitHub menyertakan `TgWitness--windows-amd64-portable.zip` dan `.sha256`-nya. Rilis tersebut berisi runtime Python 3.12 resmi yang dapat disematkan dari python.org (checksum yang disematkan dalam `tools/build_portable.py`), TgWitness beserta dependensinya yang disematkan, serta tiga peluncur: | Berkas | Tujuan | | --- | --- | | `TgWitness.cmd` | Jalankan panel; opsi tambahan diteruskan, misalnya `TgWitness.cmd --port 8790` | | `TgWitness-Demo.cmd` | Jalankan demo sintetis di `data\demo` | | `TgWitness-Check.cmd` | Jalankan pemeriksaan kesiapan tanpa memulai | Kamus morfologi bahasa Rusia yang disematkan dan profil warna PDF disertakan untuk penggunaan offline. Pengemasan hanya mengizinkan jalur file yang diketahui di dalam direktori dependensi `data`; file yang tidak terduga di direktori tersebut akan menyebabkan proses build gagal. Ekstrak seluruh arsip ke folder yang dapat ditulis seperti `Documents\TgWitness`; jangan jalankan dari dalam ZIP atau dari Program Files. Runtime menggunakan jalur modul yang terisolasi, sehingga instalasi Python lain dan `PYTHONPATH` tidak memengaruhinya. Data tetap berada di folder `data` dalam paket tersebut. Untuk memperbarui, hentikan TgWitness, ekstrak versi baru ke folder baru, lalu salin folder `data` ke sana. Buat sendiri di Windows 64-bit dengan Python 3.12: ``` python tools/build_portable.py ``` ## Kontainer ``` docker compose up -d --build --wait ``` Ini membuat volume persisten bernama untuk /data. Port web dipetakan ke 127.0.0.1:8787. Proses berjalan sebagai UID 10001 dengan kemampuan yang dihapus, sistem berkas root hanya-baca, serta /data dan /tmp yang dapat ditulis. `--wait` memeriksa kesehatan server web sebelum mengembalikan hasil; otorisasi dan pengiriman Telegram muncul di panel. Pembantu yang disediakan menggunakan batas waktu kesiapan 180 detik setelah proses pembangunan. Pengunduhan dependensi awal mungkin memakan waktu lebih lama dari itu. Kedua berkas Compose dasar menggunakan nama proyek `tgwitness`, sehingga mengekstrak rilis baru ke direktori lain tidak secara otomatis memilih volume data baru. Pertahankan hanya satu penyebaran yang aktif untuk proyek tersebut. Untuk instalasi independen, gunakan `docker compose -p NAME ...` yang unik dan port host yang berbeda, serta pertahankan keduanya saat pembaruan. Untuk penyebaran yang lebih lama yang menggunakan nama proyek berbeda, lanjutkan menggunakan nama aslinya dengan `-p`; `docker compose ls` mencantumkan proyek-proyek yang ada. Salin `deploy/env.example` ke `.env` dan ubah `TGWITNESS_PORT` agar menggunakan port loopback yang berbeda. Misalnya, `TGWITNESS_PORT=8788` menampilkan panel di `http://127.0.0.1:8788`; kontainer tersebut tetap mendengarkan di port 8787. `.env` diabaikan oleh Git. Ambil token awal: ``` docker compose exec tgwitness cat /data/panel-token.txt ``` Perintah yang berguna: ``` docker compose ps docker compose logs --tail 100 -f docker compose stop docker compose up -d --wait ``` `restart: unless-stopped` akan memulai ulang pengumpul setelah terjadi crash atau daemon Docker dimulai ulang. Pada server Linux, aktifkan Docker saat boot menggunakan pengelola layanan distribusi Anda, umumnya `sudo systemctl enable --now docker`. Pada Windows/macOS, aktifkan pengaturan "start-at-sign-in" di Docker Desktop. Keluar dari desktop, mode tidur, atau Docker daemon yang dihentikan dapat mengganggu proses pengumpulan data. Kontainer yang dihentikan secara eksplisit akan tetap dihentikan hingga Anda menjalankannya kembali. Volume /tmp dibatasi hingga 512 MiB dalam konfigurasi contoh ini. Proses ekspor sebaliknya menggunakan direktori ``temporary-exports/`` di setiap ruang kerja pada partisi permanen /data. Sediakan ruang di sana untuk ekspor simultan, pertumbuhan jurnal/WAL, media, dan cadangan. Launcher menggunakan berkas `deploy/constraints.txt` untuk mengunci versi dependensi runtime yang memenuhi syarat. Server Docker dan server dengan jaminan tinggi melakukan instalasi berdasarkan deploy/requirements.lock dan deploy/build.lock dengan perintah pip --require-hashes: setiap berkas paket harus sesuai dengan nilai SHA-256 yang tercatat dalam commit, sehingga berkas yang diganti di PyPI atau cermin akan ditolak. Paket yang hanya menyediakan kode sumber (jieba, pyaes) dibangun dengan setuptools yang ditetapkan dalam deploy/build.lock (``--no-build-isolation``) oleh peluncur, pembangun portabel Windows, dan Dockerfile, sehingga pip tidak menyelesaikan lingkungan pembangunan terpisah yang tidak ditetapkan. Gambar dasar Python dan paket sistem operasi masih memerlukan kualifikasi rilis yang independen. Jangan gunakan perintah `docker compose down -v` kecuali Anda bermaksud menghancurkan jurnal dan kunci tersebut. Laporan kesehatan kontainer menunjukkan ketersediaan server web, bukan keberhasilan penangkapan pesan Telegram. Periksa status pengumpul, detak jantung, kesalahan, dan peristiwa cakupan pada panel. ### Profil saksi independen Layanan opsional `witness` menjalankan [saksi independen](https://phishdestroy.io/tgwitness/id/docs/reference/witness/) di kontainernya sendiri, dengan kunci dan jurnal tersendiri di volume `witness-data` serta hanya memiliki token saksi yang hanya dapat dibaca untuk pengumpul. Buat token tersebut di panel di bawah **More tools → Extras → Independent witness**, tambahkan dengan token bot dan saluran ke `.env`, lalu jalankan profil: ``` docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag docker compose logs witness # witness key fingerprint ``` Layanan ini terhubung ke pengumpul di dalam jaringan Compose di `http://tgwitness:8787` (`TGWITNESS_WITNESS_COLLECTOR` menggantikannya, misalnya `/profiles/` untuk ruang kerja lain). Untuk saksi di server terpisah yang dijalankan oleh pihak lain, gunakan `deploy/compose/compose.witness.yaml` di sana dengan `TGWITNESS_WITNESS_COLLECTOR` disetel ke alamat HTTPS pengumpul; berkas tersebut hanya berisi saksi. ## Instal gambar yang telah dipublikasikan Salin `deploy/env.example` ke `.env`. Atur `TGWITNESS_IMAGE` ke versi yang telah dipublikasikan, dengan menggunakan jalur repositori **huruf kecil**, misalnya: ``` TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3 TGWITNESS_PORT=8787 ``` Jalankan berkas ini secara mandiri, bukan `compose.yaml`: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt ``` Tidak diperlukan build sumber, Python, atau kompiler di host. Alur kerja rilis ditujukan untuk kontainer Linux AMD64 dan ARM64, termasuk VM Linux di Docker Desktop. Gunakan tag versi atau `ghcr.io/owner/repository@sha256:...` dari ringkasan alur kerja. Tidak ada konfigurasi untuk pemindahan tag `latest` atau pembaruan aplikasi tanpa pengawasan. Variasi gambar dan sumber menggunakan volume data yang sama jika nama proyeknya sama. ## HTTPS otomatis di server Gunakan server dengan Docker, domain yang Anda kendalikan, dan penyimpanan lokal yang persisten. Arahkan catatan A/AAAA domain ke server; publikasikan AAAA hanya jika IPv6 menjangkau server tersebut. Izinkan lalu lintas masuk TCP 80 dan 443 serta lalu lintas keluar DNS/HTTPS untuk penerbitan sertifikat. Layanan lain tidak boleh sudah menggunakan port-port ini. Salin `deploy/env.example` ke `.env` dan tetapkan nama host, tanpa skema atau jalur: ``` TGWITNESS_DOMAIN=watch.your-domain.org ``` Mulai proses kompilasi sumber dengan overlay HTTPS: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt ``` ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait ``` Untuk gambar yang dipublikasikan, gunakan `deploy/compose/compose.image.yaml` sebagai file pertama. Pertahankan kedua argumen `-f` untuk perintah status, log, pembaruan, dan hentikan di kemudian hari. Caddy memperoleh dan memperbarui sertifikat, mengalihkan HTTP ke HTTPS, serta meneruskan permintaan ke pengumpul di jaringan Compose pribadi. Status sertifikat memiliki volume persisten tersendiri. Port host langsung pengumpul tetap hanya untuk loopback. Konfigurasi Caddy yang disediakan tidak mengaktifkan pencatatan akses. Buka `https://watch.your-domain.org` dan masukkan token panel. Persiapan mencakup kontainer; penerbitan sertifikat dan jangkauan eksternal bergantung pada DNS dan firewall. Jika HTTPS belum siap, periksa DNS, aturan firewall, dan: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy ``` Gambar Caddy yang disediakan mengikuti tag `2-alpine`-nya. Melakukan pull akan memperbarui gambar tersebut; sematkan ringkasan yang telah diuji dalam deployment Anda jika Anda memerlukan versi infrastruktur yang tetap. ## Pembaruan dan pencadangan Pertahankan nama proyek Compose dan volume data di seluruh pembaruan. Pertama, hentikan pengumpul dan buat cadangan lengkap. Untuk penyebaran berbasis sumber default: ``` docker compose stop docker compose cp tgwitness:/data ../tgwitness-backup-before-update ``` Gunakan tujuan cadangan baru setiap kali, di luar repositori, dan lindungi sebagai materi yang memerlukan akses akun. Jalur contoh hanya sebagai ilustrasi; gunakan lokasi cadangan pribadi Anda. Salin seluruh direktori, termasuk file tersembunyi, semua ruang kerja, kunci, jurnal, dan media. Cadangkan kunci utama brankas eksternal secara terpisah jika telah dikonfigurasi. File ZIP bukti bukanlah cadangan aplikasi yang dapat dipulihkan. Untuk HTTPS, simpan juga volume Caddy jika Anda perlu mempertahankan status sertifikat/akunnya. Untuk penerapan sumber, unduh berkas rilis terbaru dan jalankan: ``` docker compose up -d --build --wait ``` Untuk penerapan gambar, ubah `TGWITNESS_IMAGE` menjadi versi yang diinginkan, lalu jalankan: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait ``` Gunakan berkas Compose pada instalasi Anda untuk perintah stop/copy di atas juga. Pertahankan `.env`, konfigurasi khusus, dan nama proyek yang sama. `down` mempertahankan volume yang diberi nama; **`down -v` menghapusnya**. Jangan menyalin `.venv` antar sistem operasi atau versi Python. Untuk pembaruan asli, hentikan TgWitness, buat cadangan direktori data lengkapnya , ganti berkas sumber, dan jalankan `python start.py --setup-only` sebelum meluncurkan. Periksa akses panel, identitas akun, status pengamatan, dan cakupan setelah pembaruan. Setelah dimulai ulang, TgWitness melanjutkan posisi pembaruan Telegram yang disimpan dan meminta pembaruan yang terlewatkan selama proses pembaruan. Pengembalian ke versi sebelumnya mungkin memerlukan cadangan sebelum pembaruan jika versi mendatang mengubah format penyimpanan. ## Server jarak jauh Jaga agar layanan tetap terikat pada loopback dan gunakan terowongan SSH, atau hentikan HTTPS di proksi terbalik. Berkas Compose dasar hanya berlaku secara lokal; overlay `deploy/compose/compose.https.yaml` opsional menyediakan Caddy untuk domain yang telah dikonfigurasi. Jaga agar token bearer tidak muncul di URL dan log proxy. Proksi terbalik harus membatasi ukuran permintaan dan laju koneksi. Jangan mengekspos HTTP biasa ke Internet. Contoh untuk systemd, tugas masuk Windows, agen pengguna macOS, dan Caddy disediakan di [folder deploy/.](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) Periksa/sesuaikan jalurnya sebelum instalasi. Ini adalah templat yang disediakan, bukan konfigurasi platform yang dijalankan secara lokal. Tidak ada layanan latar belakang atau tugas yang didaftarkan oleh peluncur standar. Di Windows, peluncuran `pythonw.exe` tanpa jendela menyimpan diagnostik startup/server di `logs/server.log` di bawah direktori data (5 MiB per file, dua cadangan yang digilir). Peluncuran konsol tetap menyimpan log konsol. Pencatatan akses HTTP dinonaktifkan di kedua mode tersebut. Lindungi log dengan direktori data dan tinjau terlebih dahulu sebelum membagikannya. ## Mulai ulang dan celah Status pengamatan terakhir yang diminta akan disimpan. Jika pengamatan sedang aktif, saat startup akan mencoba terhubung kembali dan melanjutkan sumber-sumber yang dipilih. Penundaan manual akan menghapus niat tersebut. Kegagalan restart akan dicatat dan ditampilkan di panel. TgWitness menyimpan posisi pembaruan Telegram untuk akun dan setiap saluran (pts, qts, seq, dan tanggal) di brankas ruang kerja dan memulihkannya saat dimulai kembali. Klien kemudian meminta pembaruan yang terlewat saat proses dihentikan, dan pemeriksaan berkala memulihkan pesan yang terlewat serta mencatat pesan yang telah disimpan yang tidak lagi dikembalikan oleh Telegram. Dialog dimuat ulang saat dimulai. Setiap kali dimulai, sistem mencatat kepala jurnal sebelumnya, batas offline, dan posisi pembaruan tempat proses dilanjutkan. Monitor memeriksa konektivitas setiap 10 detik dan menambahkan sinyal detak jantung setiap menit (**Alat Lainnya → Parameter → Catat Keaktifan setiap**). Pemutusan koneksi dan periode tanpa aktivitas dicatat sebagai celah cakupan beserta alasannya. Cuplikan riwayat disimpan sebagai pengamatan riwayat terkini terpisah di samping catatan langsung. Antrian media disimpan dalam basis data SQLite masing-masing ruang kerja. Sebuah pesan dan tugasnya dikomitmen secara atomik. Tugas yang sedang berjalan dan terputus akan dipulihkan untuk dicoba ulang saat dimulai. Setiap unduhan memiliki batas waktu dasar 120 detik ditambah waktu sesuai kecepatan 256 KiB/s berdasarkan ukurannya, serta 1–2,000 MiB per jenis lampiran; batas waktu, kecepatan, dan upaya ulang dapat diatur di **Alat Lainnya → Parameter**. Pengumpul akan melewati berkas yang ukurannya tidak diketahui. Menjeda akan mempertahankan pekerjaan yang sedang dalam antrian. Upaya ulang menggunakan deskriptor berkas asli yang teramati, bukan versi terbaru dari pesan yang telah diedit setelahnya. Kegagalan sementara memiliki batasan upaya ulang; jeda FloodWait media akan tetap berlaku setelah dimulainya ulang. Pemulihan media terpisah dari pemulihan pembaruan Telegram dan tidak dapat memulihkan berkas yang telah hilang. ## Pencadangan, pemulihan, dan kapasitas `tgwitness backup FOLDER` menyalin direktori data sementara panel tetap berjalan: pertama-tama checkpoint, lalu berkas SQLite melalui API pencadangan daring, kemudian kunci, media, dan profil, sehingga tidak ada checkpoint yang disalin yang lebih baru daripada jurnal yang disalin. `backup-manifest.json` mencantumkan nilai SHA-256 setiap berkas dan header jurnal. Untuk memulihkan, hentikan TgWitness dan ganti seluruh direktori data dengan folder tersebut. Saat dimulai kembali, sistem akan mencatat bahwa jurnal dipulihkan dari salinan yang lebih lama. Catatan tersebut membandingkan jurnal dengan header yang disimpan di `TGWITNESS_STATE_DIR` , sebuah folder di luar direktori data: volume `tgwitness-state` di Compose, `/var/lib/tgwitness-state` di unit systemd, dan folder status lokal pengguna jika tidak. Tanpa folder status yang dapat ditulis, pemulihan tidak akan terdeteksi dan log akan menampilkannya sekali. Tanpa perintah tersebut, hentikan proses sebelum menyalin **seluruh direktori data**, termasuk vault.key, signing.enc, credentials.enc, file basis data SQLite/WAL, media, token, titik pemeriksaan, dan semua subdirektori profiles/. Pulihkan salinan lengkap tersebut saat layanan tujuan dalam keadaan berhenti. Kunci vault yang hilang atau ketidaksesuaian kunci penandatanganan akan menyebabkan kegagalan saat memulai; jangan membuat ulang kunci untuk memaksa akses. Simpan cadangan rahasia dalam bentuk terenkripsi dan dengan kontrol akses. Berkas ZIP bukti bersifat portabel; tinjau artefak, bukan cadangan aplikasi atau cadangan sesi Telegram. Tidak ada penghapusan otomatis berdasarkan masa retensi. Rencanakan ruang disk untuk semua pesan, metadata mentah, media, ekspor sementara, dan cadangan. Lakukan verifikasi saat startup dan ekspor catatan aliran alih-alih memuat seluruh jurnal. Ekspor mengunci snapshot yang dibaca sementara penulisan WAL baru dapat berlanjut; ekspor yang berlangsung lama dapat mempertahankan halaman WAL, sehingga kapasitas disk tetap menjadi pertimbangan. Ukuran ZIP dibatasi hingga 4 GiB dalam bentuk tidak terkompresi agar sesuai dengan pengaturan default verifikator independen; **Alat Lainnya → Parameter → ZIP Bertanda Terbesar** meningkatkan batas tersebut, dan arsip semacam itu diverifikasi dengan `verify.py --max-gib N`. Format lain tidak memiliki batasan jumlah peristiwa. Browser yang didukung mengalirkan potongan respons ke berkas yang dipilih pengguna. Browser lain menyimpan dalam buffer maksimal 128 MiB dan mengalihkan transfer yang lebih besar ke CLI yang terotentikasi: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Gunakan `--profile ID` dari **Ekspor → ID Ruang Kerja** untuk ruang kerja lain, `--format zip|jsonl|csv|html`, `--url https://your-server` untuk server jarak jauh, atau `--max-mib` untuk mengubah batas transfer 5 GiB. HTTP biasa hanya diizinkan untuk loopback. Token dikirim melalui header, pengalihan ditolak, file yang sudah ada tidak ditimpa, dan unduhan yang belum selesai tidak dipublikasikan sebagai file yang sudah selesai. Jika TGWITNESS_TOKEN menggantikan token yang dihasilkan, gunakan berkas yang dilindungi secara terpisah yang berisi nilai aktif tersebut: panel-token.txt tidak akan ditimpa oleh penggantian tersebut. SHA-256 perintah ini hanyalah checksum transfer; verifikasi ZIP yang ditandatangani secara independen. Panel menampilkan media yang sedang dalam antrian/gagal, media tertunda tertua, ruang disk kosong, jeda permintaan Telegram, dan sumber yang aksesnya belum dikonfirmasi. Diagnostik ini bukanlah pemantau pengiriman end-to-end yang lengkap. Ruang kerja berbagi proses; akun yang aktif masih dapat memengaruhi yang lain. Proses pekerja terpisah, retensi/rotasi, pemulihan pembaruan yang tahan lama, serta kualifikasi penerapan penuh tetap berlaku. Akses panel yang dibatasi didokumentasikan dalam [bagian akses dan izin](https://phishdestroy.io/tgwitness/id/docs/reference/access/); titik pemeriksaan independen dijelaskan dalam [panduan saksi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/). Prosedur terperinci: [koneksi/keamanan](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) dan [mode operasi](https://phishdestroy.io/tgwitness/id/docs/reference/operations/). --- # Phala / Intel TDX · Penerapan dengan jaminan keamanan tinggi Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/ Server yang diamankan 24/7 di Hetzner atau Phala Cloud, Gateway DNS, serta pemeriksaan yang dapat diulang oleh pihak ketiga. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Server yang diamankan 24/7 di Hetzner atau Phala Cloud, Gateway DNS, serta pemeriksaan yang dapat diulang oleh pihak ketiga. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penerapan dan pemulihan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) ![Penerapan & pemulihan](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Penerapan dengan jaminan tinggi menambahkan pemeriksaan independen terhadap lingkungan pengumpulan ke dalam verifikasi arsip. Peninjau memeriksa catatan penerapan dan akses yang disimpan oleh penyedia layanan cloud dan Cloudflare, dan penerapan Intel TDX menambahkan pengesahan perangkat keras terhadap lingkungan pengumpul. Penggunaan lokal dan Docker biasa tetap tidak berubah. Tidak ada yang berjalan di sini kecuali Anda melakukan deployment dengan `python -m tgwitness.cloud`, dan pengumpul hanya membaca hostnya saat penyebaran tersebut ditetapkan `TGWITNESS_ASSURANCE`. Diagram alur · Operator → Server, firewall tanpa aturan masuk (API penyedia); Operator → Tunnel dan DNS (API Cloudflare); Server, firewall tanpa aturan masuk → Tunnel dan DNS (hanya keluar); Server, firewall tanpa aturan masuk → Kunci penandatanganan dibuat di server; Verifier, token yang hanya dapat dibaca → Log penyedia dan firewall; Verifier, token yang hanya dapat dibaca → Alamat konektor terowongan dan ingress; Verifier, token yang hanya dapat dibaca → Pernyataan /api/assurance yang ditandatangani; Verifier, token yang hanya dapat dibaca → Berkas ZIP Bukti · Operator · Verifier, token yang hanyadapat dibaca · Server, firewall tanpaaturan masuk · Log penyedia dan firewall · Alamat konektor terowongandan ingress · Pernyataan /api/assuranceyang ditandatangani · Berkas ZIP Bukti · Tunnel dan DNS · Kunci penandatanganandibuat di server · API penyedia · API Cloudflare · hanya keluar **Diagram dalam bentuk teks** 1. Operator → Server, firewall tanpa aturan masuk (API penyedia) 2. Operator → Tunnel dan DNS (API Cloudflare) 3. Server, firewall tanpa aturan masuk → Tunnel dan DNS (hanya keluar) 4. Server, firewall tanpa aturan masuk → Kunci penandatanganan dibuat di server 5. Verifier, token yang hanya dapat dibaca → Log penyedia dan firewall 6. Verifier, token yang hanya dapat dibaca → Alamat konektor terowongan dan ingress 7. Verifier, token yang hanya dapat dibaca → Pernyataan /api/assurance yang ditandatangani 8. Verifier, token yang hanya dapat dibaca → Berkas ZIP Bukti **Di halaman ini** - [Apa yang dapat diperiksa oleh verifikator](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#what-a-verifier-can-check) - [Penyedia](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#providers) - [VM Rahasia di Phala Cloud (Intel TDX)](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) - [Sebelum Anda memulai](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#before-you-start) - [Dari panel](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#from-the-panel) - [Terowongan cepat tanpa domain](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#quick-tunnel-without-a-domain) - [Deploy](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#deploy) - [Penerapan debug dan penguncian](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#debug-deployment-and-lock) - [Hapus penyebaran](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#remove-a-deployment) - [Server apa pun (diverifikasi sendiri)](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#any-server-self-attested) - [Verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#verify) - [Laporan untuk penyerahan bukti](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#report-for-evidence-handover) - [Cloudflare sebagai saksi eksternal](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#cloudflare-as-an-outside-witness) - [Membaca hasil penyebaran](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#reading-the-deployment-result) ## Apa yang dapat diperiksa oleh verifikator | Klaim | Bagaimana cara memeriksanya | Dikelola oleh | | --- | --- | --- | | Server tersebut dibuat melalui API penyedia pada waktu yang diketahui | Objek server dan pembuatannya dalam log milik penyedia | Penyedia | | Tidak ada yang menggunakan jalur akses penyedia tersebut | Log permintaan konsol, pemulihan, reset kata sandi, pembangunan ulang, ISO, gambar, dan cadangan | Penyedia | | Tidak ada yang dapat terhubung ke sana | Firewall penyedia tidak memiliki aturan masuk; SSH disembunyikan sejak boot pertama | Penyedia (firewall), host (SSH) | | Panel tersebut hanya dapat diakses melalui terowongan | Masukan terowongan diteruskan hanya ke panel; konektor berjalan dari alamat server | Cloudflare | | Perangkat lunak ini berjalan | Hash pohon sumber yang ditandatangani oleh pengumpul sama dengan hasil checkout dari commit yang telah diterapkan | Collector, disinkronkan dengan Git | | Kunci penandatanganan dibuat di server tersebut | Kunci tersebut menandatangani pernyataan yang mencantumkan ID server penyedia dan hash dari cloud-init yang diterimanya | Collector, telah diverifikasi oleh penyedia | | Jurnal tersebut terkait dengan kunci dan server tersebut | Setiap proses yang dimulai di bukti ZIP membawa pengukuran host untuk server tersebut | Bukti ZIP | | Kunci Telegram dibuat dalam proses yang terverifikasi | `account.authorized` mencatat `key_origin: "created"` | Bukti ZIP | Pengumpul mencatat status SSH, sesi, riwayat login, dan informasi boot dalam catatan process-start dan `host.state` yang telah ditandatangani. Pada VM biasa, ini merupakan catatan inventaris lokal, yang kemudian dibandingkan oleh peninjau dengan catatan independen dari penyedia layanan. Penerapan Intel TDX di bawah ini juga memverifikasi pengukuran yang didukung perangkat keras. Penerapan yang terverifikasi tidak mengumpulkan data berdasarkan kunci sesi yang diimpor. Masuk melalui telepon atau QR, atau gunakan berkas sesi untuk masuk secara independen: dalam kedua kasus tersebut, kunci otorisasi Telegram dibuat di dalam proses yang terverifikasi, jurnal mencatat `key_origin: "created"`, dan perintah `python -m tgwitness.cloud verify` berhasil melewati `account_key`. Jurnal dengan kunci yang diimpor akan gagal dalam pemeriksaan tersebut. ## Penyedia | `--provider` | Kredensial | Akses hanya baca bagi Verifier | Log penyedia untuk verifikator | Disimpan untuk | | --- | --- | --- | --- | --- | | `hetzner` | `HCLOUD_TOKEN` | Baca token dari proyek yang sama | Tindakan server dan firewall | Selama sumber daya tersebut tersedia | | `digitalocean` | `DIGITALOCEAN_TOKEN` | Token akses pribadi yang hanya dapat dibaca | Tindakan Droplet | Selama Droplet masih ada | | `linode` | `LINODE_TOKEN` | `linodes`, `firewall`, `events` ruang lingkup baca-saja | Peristiwa akun, versi aturan firewall | 90 hari | | `vultr` | `VULTR_API_KEY` | Pengguna dengan akses baca dan `activity_logs` izin | Log aktivitas akun (metode, jalur, pelaku) | 30 hari, lebih lama dengan langganan log audit | | `aws` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | `ec2:DescribeInstances`, `ec2:DescribeSecurityGroups`, `cloudtrail:LookupEvents` | Riwayat peristiwa CloudTrail | 90 hari | | `phala` | `PHALA_CLOUD_API_KEY` | Kunci API dari ruang kerja yang sama | Revisi aplikasi dan operasi CVM: perubahan konfigurasi dan lingkungan Docker Compose, restart, serta pembaruan sistem operasi | Selama aplikasi ini masih ada | | `generic` | tidak ada | tidak ada | none: **disertifikasi sendiri** | – | Gunakan proyek, tim, akun, atau sub-akun khusus untuk setiap kasus: akses hanya baca dari verifikator kemudian hanya menampilkan penyebaran ini. Kredensial dibaca dari `--provider-token-file` atau variabel di atas, bukan dari baris perintah. Untuk AWS, berkas tersebut berisi `ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]`; wilayahnya adalah `--location`. Setiap laporan menyatakan cakupan catatan masing-masing penyedia. Singkatnya: Hetzner mencatat permintaan konsol; Konsol Pemulihan DigitalOcean, Lish/Glish dari Linode, dan konsol web Vultr tidak dicatat sebagai such, sehingga akses root terkunci pada booting pertama dan login konsol akan memerlukan reset kata sandi atau perubahan pengaturan booting, yang keduanya dicatat. Vultr mengembalikan alamat konsol ke kunci apa pun yang dapat membaca instance; baik catatan maupun laporan tidak menyimpannya. ## VM Rahasia di Phala Cloud (Intel TDX) Dengan `--provider phala` pengumpul berjalan di mesin virtual rahasia Intel TDX di [Phala Cloud](https://phala.com/), yang dikelola oleh dstack. Host dan staf Phala tidak dapat membaca memori mesin tersebut, dan prosesor menandatangani pernyataan tentang apa yang dijalankan saat mesin dinyalakan. Verifikator tidak hanya mempercayai pernyataan Phala begitu saja: `tgwitness.tdx` memverifikasi setiap pernyataan tersebut secara mandiri, hingga ke Intel SGX Root CA yang disematkan, dengan membandingkannya terhadap daftar pencabutan Intel dan data platform yang ditandatangani Intel, serta menolak mesin yang dapat di-debug atau dimigrasikan. | Entri laporan | Apa yang ditampilkannya | | --- | --- | | `tdx_binding` | Pengesahan ini mencakup pernyataan yang ditandatangani oleh pengumpul serta nilai acak dari permintaan ini | | `tdx_quote` | Intel menjamin keabsahan sertifikasi tersebut; sertifikasi hanya akan disetujui jika Intel menilai platform tersebut telah diperbarui | | `tdx_compose_hash` | RTMR3, yang diambil dari log peristiwa dstack, mengukur laporan komposisi aplikasi yang dilaporkan oleh pengumpul | | `tdx_compose` | Kode tersebut, byte demi byte, sama persis dengan kode yang dihasilkan oleh commit yang telah di-deploy: berkas sumber diidentifikasi berdasarkan hash, kedua gambar berdasarkan digest, tanpa kode lain apa pun | | `tdx_identity` | Pengesahan berasal dari aplikasi dan instans yang telah diimplementasikan, dengan kunci dari KMS Phala dan disk terenkripsi | | `tdx_os` | MRTD dan RTMR0-2 sama dengan nilai yang dihitung oleh verifikator dari gambar OS dstack yang diterbitkan oleh Dstack-TEE, yang ditemukan berdasarkan hash gambar OS yang dilaporkan oleh CVM, serta dari tabel ACPI yang dibuat oleh QEMU untuk konfigurasi VM: firmware, kernel, initrd, baris perintah beserta hash sistem berkas root, memori, vCPU, dan perangkat. Gambar pengembangan gagal | Gambar sistem operasi (sekitar 180 MB, di mana 21 MB disimpan) diunduh sekali dari [Dstack-TEE/meta-dstack](https://github.com/Dstack-TEE/meta-dstack/releases) ke dalam `dstack-images` di samping catatan; `--tdx-image FOLDER` menggunakan folder lain atau gambar yang telah diekstrak, `--tdx-image none` melewatkan perbandingan. Pengukuran mengikuti `dstack-mr` dan kargo `qemu-acpi` dari Dstack-TEE/dstack. Regresi pengukuran pribadi membandingkan keluaran ACPI milik QEMU sendiri dengan kutipan Phala Cloud yang disimpan; kualifikasi langsung juga memerlukan gambar yang dipublikasikan. `--tdx-measurements` tetap membandingkan MRTD dan RTMR0-2 yang diberikan dalam format JSON. Setiap kali pengumpul dimulai dan dicatat dalam jurnal, hal tersebut disertai dengan pengesahan tersebut, sehingga `verify --evidence` memeriksa setiap kali pengumpul dimulai serta citra sistem operasi yang digunakan untuk mem-boot-nya. Revisi aplikasi Phala dan operasi CVM berfungsi sebagai log penyedia: konfigurasi Docker Compose yang diubah setelah penyebaran akan menyebabkan laporan gagal, dan proses restart dicantumkan untuk ditinjau. Di panel, pilih **Mesin virtual rahasia · Phala Cloud** di bawah **Alat lainnya → Ekstra → Server 24/7** , lalu tempelkan kunci API Phala Cloud; terowongan cepat berfungsi seperti di Hetzner. Dari baris perintah: ``` python -m tgwitness.cloud deploy --provider phala --name case-1 --server-type tdx.small \ --ref v0.8.0 --repository https://github.com/phishdestroy/TgWitness --quick-tunnel \ --provider-token-file phala-key.txt python -m tgwitness.cloud verify --record deployments/case-1/deployment.json \ --provider-token-file phala-key.txt --cloud-init deployments/case-1/docker-compose.yaml \ --source CHECKOUT_OF_COMMIT --fingerprint COLLECTOR_FINGERPRINT --report certificate.md python -m tgwitness.cloud check-report --report certificate.pdf --verifier-fingerprint VERIFIER_KEY ``` `--tdx-collateral` membaca sertifikat dan daftar pencabutan Intel dari sebuah berkas, bukan mengunduhnya dari Intel. Gateway DNS tidak tersedia di sini: Phala tidak memiliki firewall penyedia layanan untuk lalu lintas keluar. Perintah ``verify --source`` akan membangun penginstal referensi dari checkout Anda, yang akan menjalankan kode dari checkout tersebut di komputer ini. Untuk penerapan yang dilakukan dari repositori selain repositori resmi, perintah ``verify`` akan menolak kecuali Anda juga menambahkan opsi `--trust-source`; lakukan hal ini hanya untuk checkout yang sudah Anda baca. ### Pemeriksaan offline dengan verify.py Seorang penerima yang tidak memiliki akun Phala memeriksa kutipan tersebut dengan verifikator mandiri, secara offline: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_FINGERPRINT python verify.py phala-tdx-attestation.json ``` Untuk kutipan setiap catatan `process.started` dalam arsip bukti, dan untuk kutipan pernyataan pengumpul yang ditandatangani (juga di dalam catatan penyebaran atau catatan pengesahan yang dipublikasikan), `verify.py` memeriksa tanda tangan ECDSA P-256 kutipan tersebut dengan kunci pengesahannya, tanda tangan laporan enclave yang mengutip dengan sertifikat PCK, bahwa laporan ini menyebutkan kunci pengesahan (SHA-256 dari kunci dan data otentikasi QE), bahwa laporan tersebut berasal dari enclave penulisan kutipan TDX Intel dalam mode produksi, serta rantai sertifikat PCK → Intel SGX PCK Platform atau Processor CA → Intel SGX Root CA, yang SHA-256-nya telah ditetapkan di `verify.py`. Skrip ini menolak TD yang dapat di-debug atau dapat dimigrasikan, memeriksa apakah REPORTDATA adalah SHA-512 dari catatan awal (kunci jurnal, run, pohon sumber , host) atau dari pernyataan yang ditandatangani, dan mencetak MRTD, RTMR0-3, dan REPORTDATA. Pengumpul juga menyimpan jaminan Intel (Informasi TCB, Identitas QE, daftar pencabutan, dan rantai penerbitnya) bersama setiap kutipan saat layanan Intel merespons. Dengan itu, `verify.py` memeriksa tanda tangan dan daftar pencabutan Intel serta menghitung status TCB per waktu yang tercatat, atau per tanggal penerbitan jaminan jika tanggal tersebut lebih baru. Tanpa itu, hasilnya akan berbunyi "Status TCB tidak diverifikasi (tidak ada jaminan di arsip)". Kode apa yang dijalankan oleh VM (pengukuran RTMR3, gambar sistem operasi di balik MRTD dan RTMR0-2), log penyedia, dan peringkat Intel saat ini tetap diverifikasi oleh `python -m tgwitness.cloud verify`; oleh karena itu, pemeriksaan offline menandai proses pengumpulan yang telah diverifikasi sebagai parsial dan tidak secara otomatis mencapai tingkatan `sealed` atau profil `attested`. ### Sertifikat attestation Untuk penyebaran Phala, `verify --report certificate.md` juga menulis sertifikat: sebuah `certificate.html` yang berdiri sendiri dan `certificate.pdf` berukuran A4 yang berisi kesimpulan, rantai kepercayaan dari root Intel hingga kunci pengumpul, perbandingan dengan server biasa dan server dengan jaminan tinggi, pengukuran di samping nilai yang dihitung dari gambar yang dipublikasikan, pihak yang menjamin setiap bagian, rantai sertifikat Intel, setiap pemeriksaan, log penyedia, dan cara mengulangi verifikasi. Laporan JSON tetap menjadi catatan resmi; halaman-halaman ini menampilkannya. Laporan ini disegel secara digital dengan tanda tangan dan cap waktu, dalam berkas `certificate.seal.json` serta berkas `.tsq`/`.tsr` di sampingnya: | Segel | Fitur tambahan | | --- | --- | | Cap waktu elektronik yang terverifikasi, `http://tsa.belgium.be/connect` | Cap waktu RFC 3161 pada byte yang tepat dari `certificate.json` dari penyedia layanan kepercayaan yang memenuhi syarat pemerintah federal Belgia (FPS Policy and Support, BOSA). Unit tersebut terdaftar sebagai layanan penandaan waktu yang memenuhi syarat, dengan status "diberikan", dalam daftar tepercaya UE Belgia; akar (Belgium Root CA6) dan entri-entri dalam daftar tersebut, berdasarkan daftar yang diterbitkan pada 20 Oktober 2026, disematkan dalam `tgwitness/tsa_roots.py`. Berdasarkan Peraturan (UE) No. 910/2014, Pasal 41, cap waktu semacam itu dianggap akurat dalam hal tanggal dan waktu serta integritas data di setiap negara anggota UE | | Stempel waktu RFC 3161, FreeTSA | Stempel waktu kedua yang independen | | Tanda tangan verifikator | Ed25519 diterapkan pada pernyataan yang mencantumkan SHA-256 laporan dan setiap cap waktu, menggunakan kunci verifikator itu sendiri (`--sign-with FOLDER`, default `~/.tgwitness/verifier`); PDF tersebut memuat tanda tangan dengan kunci yang sama | `--timestamp URL` (dapat diulang) memilih otoritas lain, `--timestamp none` tidak memilih apa pun, `--sign-with none` membiarkan segel tidak ditandatangani. `check-report` memeriksa hash laporan, tanda tangan verifikator, setiap cap waktu ke akar tepercaya dan status kualifikasinya, serta tanda tangan PDF. Bobot hukum dari cap waktu yang memenuhi syarat di luar UE, serta dari laporan secara keseluruhan, ditentukan oleh pengadilan atau otoritas yang menerimanya; segel tersebut menunjukkan kapan laporan tersebut ada dan bahwa laporan tersebut tidak berubah. Pengesahan ini bergantung pada modul TDX dan mikrokode Intel serta integritas fisik bus memori. Siapa pun yang mengendalikan aplikasi di akun Phala dapat menerapkan komposisi lain; komposisi tersebut muncul sebagai revisi baru dengan hash komposisi baru. Host mengendalikan sumber waktu mesin dan jaringan. Proses penyebaran, verifikasi dengan `--evidence`, restart, perbandingan citra sistem operasi, sertifikat tersegel, dan penghancuran telah dijalankan di Phala Cloud itu sendiri; lihat [eksekusi tanggal 4 November 2026](https://phishdestroy.io/tgwitness/id/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026). Pada tanggal 9 November, sebuah penerapan mengumpulkan data dari akun Telegram aktif; satu eksekusi menggunakan kunci sesi yang dibuat di dalam VM. Lihat [eksekusi akun aktif](https://phishdestroy.io/tgwitness/id/docs/reference/verification/#phala-cloud-with-live-telegram-account--9-november-2026) dan [kunci yang dibuat di dalam VM](https://phishdestroy.io/tgwitness/id/docs/reference/verification/#session-key-created-inside-the-tdx-vm--9-november-2026). ## Sebelum Anda mulai 1. Sebuah zona Cloudflare, ID akunnya, dan token API dengan izin **Cloudflare Tunnel Edit**, **Zone Read**, dan **DNS Edit**, yang diberikan bersama `--cloudflare-token-file` atau `CLOUDFLARE_API_TOKEN`. Untuk verifikator: **Cloudflare Tunnel Read**, **DNS Read**, dan, untuk log audit, **Account Settings Read**. Tanpa domain, [quick tunnel](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#quick-tunnel-without-a-domain) tidak memerlukan semua ini. 2. Kredensial penyedia dengan akses tulis ke proyek khusus; `lock` menggunakan hal yang sama: - Hetzner: Token API dengan izin Baca & Tulis; - DigitalOcean: token akses pribadi dengan hak akses tulis; - Linode: token akses pribadi dengan `linodes`, `firewall` dan `events` ruang lingkup baca/tulis; - Vultr: Kunci API dari akun khusus atau sub-akun; - AWS: Kredensial IAM diizinkan `ec2:DescribeVpcs`, `ec2:DescribeImages`, `ec2:CreateSecurityGroup`, `ec2:AuthorizeSecurityGroupIngress`, `ec2:RunInstances`, `ec2:CreateTags`, `ec2:DescribeInstances`, `ec2:DescribeSecurityGroupRules` dan `ec2:RevokeSecurityGroupIngress`. 3. Komitmen yang akan dijalankan. Tag rilis diselesaikan sekali ke komitmennya dengan `git ls-remote`; server hanya menerima commit berpanjang 40 karakter. ## Dari panel Di komputer Anda sendiri, **More tools → Extras → Server 24/7** menjalankan perintah `deploy` yang sama untuk Hetzner dalam tiga langkah: pilih Eropa atau Amerika Serikat, tempelkan token Hetzner (Baca & Tulis), lalu periksa jenis server, harga bulanan, alamat, dan versi yang ditemukan panel dengan token tersebut. Tidak ada yang dibuat sebelum Anda mengonfirmasi. Panel menampilkan setiap langkah sesuai laporan `deploy` , lalu alamat, token panel, dan sidik jari kunci penandatanganan. Tanpa domain, server akan mendapatkan [tunnel cepat](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#quick-tunnel-without-a-domain) ; **Server Anda → Temukan alamat saat ini** akan mencarinya kembali setelah restart. Untuk alamat tetap di bawah domain Anda sendiri, buka **"Opsional · domain Anda sendiri** " dan tambahkan token Cloudflare (tautan yang telah disiapkan memilih Zone Read, DNS Edit, dan Cloudflare Tunnel Edit). Token-token tersebut dikirim bersama setiap permintaan dari tab browser ke TgWitness di komputer yang sama dan tidak disimpan di mana pun; catatan penyebaran, cloud-init yang disunting, token panel, dan, untuk terowongan cepat, kunci alamat disimpan di `deployments/NAME` di dalam direktori data. Panel ini hanya menawarkan fitur ini kepada administrator utama melalui koneksi loopback langsung (`127.0.0.1`, tanpa header proxy atau terowongan); panel yang diakses melalui jaringan akan menampilkan perintah-perintah sebagai gantinya. Versi secara default menggunakan tag rilis dari panel yang sedang berjalan, yang diselesaikan melalui API GitHub. Lokasi, jenis server, dan harga berasal dari API Hetzner: `cpx22` jika tersedia di sana, jika tidak, tipe x86 termurah dengan memori minimal 2 GB. ## Tunnel cepat tanpa domain `--quick-tunnel` menggantikan `--zone`, `--cloudflare-account` dan `--panel-host`; tidak ada akun atau token Cloudflare yang terlibat: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token ``` Di server, cloudflared membuka [terowongan cepat](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) ke panel: sebuah alamat acak `https://….trycloudflare.com` yang berubah setiap kali cloudflared atau server dimulai ulang. Sebuah layanan kecil di server memposting setiap alamat ke topik ntfy.sh yang acak, ditandatangani (HMAC-SHA256) dengan kunci yang hanya disimpan di direktori deployment (`address-key.txt`), dan mengulanginya setiap tiga jam karena ntfy.sh menyimpan postingan selama 12. `deploy` dan **Temukan alamat saat ini** hanya menerima posting yang ditandatangani, sehingga posting palsu tidak dapat mengalihkan Anda, beserta token panel Anda, ke alamat orang lain. Topik tersebut tercatat dan dipublikasikan melalui cloud-init: siapa pun yang memilikinya dapat membaca alamat saat ini, yang tetap meminta token panel. Server tidak membuka port masuk apa pun dalam kedua kasus tersebut. Seorang verifikator tidak memiliki kunci alamat, dan siapa pun yang membaca topik tersebut dapat memposting ke sana. Jadi, pengumpul juga memposting alamat itu sendiri, yang ditandatangani dengan kunci Ed25519 miliknya sendiri, dan `verify` mengambil posting terbaru yang ditandatangani oleh kunci pengumpul dalam catatan penyebaran; posting diurutkan berdasarkan waktu ntfy.sh menerimanya, bukan waktu yang mereka klaim. Seorang pengumpul dari sebelum perubahan ini tidak menandatangani apa pun, dan `verify` kemudian mengambil posting terbaru dan menyatakan hal itu dalam pemeriksaan `statement`; sebuah posting palsu hanya dapat membuat pemeriksaan tersebut gagal, karena alamat tersebut tetap harus merespons dengan kunci pengumpul. Biayanya: tidak ada akun Cloudflare yang menyimpan catatan terowongan cepat, sehingga `verify` melaporkan terowongan, konektor, dan pemeriksaan DNS sebagai tidak tersedia, dan hasilnya paling baik `incomplete` (di Phala Cloud, pemeriksaan justru lulus: konektor berjalan di dalam compose yang diukur); catatan penyedia, firewall, pernyataan yang ditandatangani, pengukuran host, dan perbandingan penginstal diperiksa seperti biasa. Perbandingan byte dengan penginstal referensi memerlukan commit yang telah diterapkan yang sudah mengenal `--quick-tunnel`; checkout versi 0.7.0 membangun penginstal domain dan melaporkan perbedaannya. Cloudflare menawarkan quick tunnels untuk uji coba, mengizinkan 200 permintaan yang sedang diproses, dan tidak mendukung Server-Sent Events, sehingga pembaruan langsung panel (versi setelah 0.7.0) mungkin tidak sampai melalui quick tunnel tersebut dan tampilan perlu dimuat ulang; bagian tersebut belum dicoba. Untuk kasus yang harus tetap berfungsi, gunakan domain Anda sendiri. ## Lakukan penyebaran Periksa terlebih dahulu semua yang akan dikirim. `plan` tidak melakukan permintaan ke penyedia layanan atau Cloudflare: ``` python -m tgwitness.cloud plan --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org ``` Kemudian lakukan deployment dengan opsi dan kredensial yang sama: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org \ --witness-host case-witness.example.org \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Jenis server yang dapat digunakan untuk memulai: `cpx22` (Hetzner), `s-1vcpu-2gb` (DigitalOcean), `g6-standard-1` (Linode), `vc2-1c-2gb` (Vultr), `t3.small` (AWS). `--location` dan `--image` secara default menggunakan Ubuntu 24.04 dari masing-masing penyedia di wilayah Eropa. `--repository` mengambil commit dari repositori Git https lain, tanpa kredensial dalam URL (secara default `https://github.com/phishdestroy/TgWitness.git`). `deploy` juga menerima `--out` untuk direktori penyebaran lain (default `deployments/NAME`; direktori yang sudah berisi penyebaran akan ditolak) dan `--wait`, waktu tunggu dalam menit untuk pernyataan yang ditandatangani oleh pengumpul: 1 hingga 240, default 20, atau 60 untuk `generic`. Perintahnya: 1. membuat terowongan Cloudflare yang mengarahkan lalu lintas masuk ke nama host panel dan, jika ditentukan, nama host saksi ke `/api/witness/head` dan `/api/assurance` saja; 2. membuat catatan CNAME yang diproksi untuk nama-nama host tersebut, dan menolak nama-nama yang sudah ada; 3. membuat firewall penyedia tanpa aturan masuk dan sebuah server di belakangnya tanpa kunci SSH, tanpa cadangan, tanpa agen konsol, serta cloud-init yang menyembunyikan SSH, mengunci akses root, menginstal `cloudflared`, mengambil commit yang tepat, memeriksanya, dan menjalankan TgWitness sebagai layanan systemd yang diperkuat; 4. menunggu pernyataan yang telah ditandatangani oleh pengumpul dan memeriksa apakah pernyataan tersebut menyebutkan server ini dan hash dari cloud-init ini. `deployments/case-2026-11/` kemudian berisi: | Berkas | Daftar Isi | Bagikan? | | --- | --- | --- | | `deployment.json` | ID, hash, panggilan API yang dilakukan (metode, jalur, status), dan pernyataan pertama yang ditandatangani | Ya, dengan verifikator | | `cloud-init.redacted.yaml` | Perintah cloud-init yang tepat dengan dua rahasianya diganti dengan `REDACTED` | Ya | | `panel-token.txt` | Token panel | Tidak | Kata sandi root penyedia, token terowongan, dan token panel tidak pernah ditulis ke `deployment.json`. Publikasikan sidik jari pengumpul yang tercantum di bagian akhir melalui saluran yang tidak Anda kendalikan sendiri, misalnya saluran saksi atau pesan kepada penerima. Masuk ke Telegram di `https://case.example.org` dengan token panel, seperti yang dijelaskan dalam [panduan akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/). Tindakan panel dicatat dalam jurnal yang ditandatangani; tindakan tersebut bukanlah sesi SSH. Seorang [saksi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/) dapat melakukan polling `https://case-witness.example.org`. Tidak ada SSH: jika proses bootstrap gagal, kolektor tidak akan pernah merespons. Hapus server dan lakukan deployment ulang, atau gunakan deployment debug untuk mencari penyebabnya. ### Rahasia dalam data pengguna Cloud-init menyimpan dua rahasia: token panel dan token terowongan Cloudflare. Kunci penandatanganan tidak termasuk di antaranya; kunci tersebut dibuat di server. Hetzner, DigitalOcean, dan Linode tidak mengembalikan data pengguna melalui API mereka. Vultr mengembalikannya ke kunci apa pun yang dapat membaca instans tersebut, sedangkan EC2 melalui `DescribeInstanceAttribute`. Untuk AWS, berikan verifikator hanya tiga tindakan dalam tabel, jangan pernah `ec2:Describe*`. Untuk Vultr, anggaplah kunci verifikator dapat membaca kedua token tersebut. Token terowongan memungkinkan seseorang menjalankan konektor kedua: `verify` melaporkan konektor apa pun yang tidak ada di server, dan pernyataan pengumpul tidak dapat dipalsukan dengan cara itu karena masing-masing menandatangani tantangan baru. Dengan `--quick-tunnel` rahasia kedua adalah kunci alamat: siapa pun yang membacanya dapat memposting alamat palsu yang akan diterima oleh panel. Pernyataan publik sang pengumpul tidak mencantumkan alamat server dan sumber-sumber login; keduanya tetap tersimpan dalam jurnal yang telah ditandatangani. ## Penyebaran debug dan penguncian `--debug-ssh-key KEY --debug-ssh-from 198.51.100.4` Menyimpan SSH untuk satu kunci dari satu alamat atau jaringan kecil, paling banyak /24 untuk IPv4 atau /48 untuk IPv6. `KEY` sudah terdaftar pada penyedia: nama atau ID kunci SSH dalam proyek Hetzner, ID atau sidik jari kunci SSH dalam tim DigitalOcean, nama pengguna Linode yang kunci SSH profilnya ditambahkan ke root, ID kunci SSH dalam akun Vultr, atau nama pasangan kunci EC2 di wilayah tersebut. Opsi-opsi ini tidak berlaku untuk `generic`. Penyebaran semacam itu dicatat sebagai `debug` dan **tidak pernah** dilaporkan sebagai jaminan tinggi. Setelah selesai, jalankan `sudo tgwitness-lock` sebagai perintah terakhir dari sesi SSH terakhir, lalu: ``` python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token ``` Firewall kehilangan semua aturan masuk. Laporan kemudian menunjukkan kapan SSH diizinkan dan kapan SSH ditutup; jendela tersebut tetap terlihat. ## Hapus penyebaran `destroy` menghapus server dan firewall-nya, yang ditemukan berdasarkan label deployment sehingga deployment yang gagal di tengah jalan juga dihapus, kemudian catatan DNS yang mengarah ke tunnel-nya, serta tunnel itu sendiri. Jurnal server dan kunci penandatanganan juga dihapus bersamanya: ekspor bukti terlebih dahulu. Catatan tetap tersimpan, ditandai `removed`, dengan panggilan API penghapusan tersebut. ``` python -m tgwitness.cloud destroy --record deployments/case-2026-11/deployment.json --confirm case-2026-11 \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Penghapusan melalui API telah diimplementasikan untuk Hetzner. Untuk penyedia lain `destroy` , hentikan proses sebelum menghapus apa pun dan tentukan label yang akan dihapus di konsol penyedia layanan. Server yang diinstal secara manual (`generic`) hanya kehilangan catatan terowongan dan DNS-nya. Penerapan terowongan cepat tidak memerlukan token Cloudflare: terowongannya berakhir di server, dan postingannya kedaluwarsa dari ntfy.sh dalam waktu 12 jam. ## Server apa pun (yang telah diverifikasi sendiri) `--provider generic` ditujukan untuk server yang dibeli atau diinstal secara manual. `deploy` membuat terowongan dan DNS, menulis `install.sh` (pribadi) dan `install.redacted.sh` (untuk dipublikasikan), lalu menunggu. Salin `install.sh` ke server Ubuntu 24.04 yang baru diinstal dan jalankan di sana: ``` sudo bash install.sh ``` Alat ini merekam kondisi host sebagaimana adanya (login, akun, `authorized_keys`, soket pendengar, layanan, tugas terjadwal, paket), menginstal commit, mengaktifkan firewall host, menghapus dirinya sendiri, menyamarkan SSH, dan mengakhiri sesi. Laporan untuk server semacam itu, paling banter, bersifat **SELF-ATTESTED**: siapa pun yang menjalankan penginstal telah memiliki akses root sebelumnya, dan tidak ada catatan penyedia yang tersedia bagi pihak yang memverifikasi. Hal ini tetap lebih baik daripada server yang tidak dapat dijelaskan: inventaris, hash penginstal, dan setiap login selanjutnya telah ditandatangani. ## Verifikasi Verifikator memerlukan `deployment.json`, penginstal yang telah dipublikasikan, kredensial baca-saja, dan, idealnya, salinan commit serta bukti ZIP: ``` git clone -c core.autocrlf=false https://github.com/phishdestroy/TgWitness.git checkout git -C checkout checkout 0123456789abcdef0123456789abcdef01234567 python -m tgwitness.cloud verify --record deployment.json \ --provider-token-file read-only.token --cloudflare-token-file cloudflare-read.token \ --fingerprint COLLECTOR_FINGERPRINT --cloud-init cloud-init.redacted.yaml \ --source checkout --evidence tgwitness-evidence.zip --report report.md ``` Setiap penyedia dan nilai Cloudflare diminta oleh verifikator pada saat itu; catatan hanya menyediakan ID yang akan ditanyakan. Kode keluar adalah 0 untuk **LULUS**, 1 untuk **GAGAL,** dan 2 untuk **TINJAUAN**, **BELUM LENGKAP,** atau **DISERTIFIKASI SENDIRI**. `--fingerprint` harus berasal dari saluran independen; tanpa itu, kunci hanya dibandingkan dengan catatan operator. `python verify.py` tetap memverifikasi bukti ZIP itu sendiri, seperti dalam [Evidence](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/). Tindakan penyedia diklasifikasikan: pembuatan dan pengaktifan dalam waktu 30 menit setelah pembuatan lolos; konsol, penyelamatan, reset kata sandi, pembangunan ulang, ISO, gambar, snapshot, cadangan, Systems Manager, EC2 Instance Connect, dan pembukaan firewall gagal; tindakan daya dan segala hal yang tidak terduga ditandai untuk ditinjau. Tindakan yang tidak dikenal tidak pernah lolos tanpa pemberitahuan. ## Laporan untuk penyerahan bukti `--report report.md` menulis laporan Markdown dan `report.json` di sebelahnya: 1. hasil, sidik jari kunci pengumpul, penyebaran, penyedia, komit, server, firewall, terowongan; 2. setiap pemeriksaan beserta status dan sumbernya (API penyedia, API Cloudflare, laporan pengumpul, jurnal bukti); 3. log penyedia yang berisi penilaian setiap tindakan dan, jika penyedia mencatatnya, pelaku tindakan tersebut; 4. titik akhir Cloudflare yang menyimpan koneksi terowongan, konfigurasi, dan log audit; 5. pernyataan kolektor yang telah ditandatangani; 6. apa yang dicakup oleh laporan ini dan apa yang berada di luar cakupannya; 7. perintah untuk mereproduksinya, serta SHA-256 dari setiap berkas yang diberikan kepadanya. Serahkan laporan, `report.json`, `deployment.json`, penginstal yang telah dipublikasikan, dan bukti ZIP. Buat laporan tersebut sedini mungkin: log penyedia disimpan hanya untuk jangka waktu terbatas. ## Cloudflare sebagai saksi eksternal Semua hal di sini bersifat opsional. Tanpa akun Cloudflare, server tetap berjalan, dan dua di antaranya saat ini berfungsi: | Apa | Apa yang ditampilkannya | Dalam TgWitness | | --- | --- | --- | | Tunnel cepat atau tunnel domain Anda | Panel tersebut hanya dapat diakses melalui terowongan | wizard server, lihat di atas | | drand relay `drand.cloudflare.com` | catatan setelah putaran drand lebih baru daripada itu: jurnal tersebut ditulis seiring berjalannya waktu | mode bukti, **lebih banyak saksi**, tanpa akun ([format](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) | | Pemberitahuan status terowongan | ketika terowongan tidak aktif, melalui email atau webhook dari Cloudflare | atur pengaturannya di dasbor Cloudflare | | Gateway DNS (`--gateway-dns`, atau **Cloudflare Gateway DNS** di wizard) | setiap nama yang dicari oleh server, dijawab oleh Cloudflare melalui TLS; firewall Hetzner mencegah DNS mengakses apa pun selain itu; apakah kebijakan Gateway dapat mengubah jawaban | Hetzner, paket Zero Trust gratis, tanpa domain; `verify` memeriksa firewall, lokasi, pencatatan, kebijakan, kueri server, dan log audit; mode bukti menyalin log ke dalam jurnal | | Gateway dengan Cloudflare Satu klien di server, sebuah firewall keluar yang hanya mengizinkan Cloudflare | setiap koneksi yang dibuat oleh server, bukan hanya DNS | belum dibuat | | Akses di bagian depan panel | siapa yang masuk ke panel dan kapan | belum tersedia: memerlukan domain Anda sendiri | | Pencatatan perintah SSH | setiap perintah dalam sesi debug | belum dibuat | Logpush, yang akan menyimpan salinan milik Cloudflare sendiri di R2, merupakan fitur Enterprise: pada paket gratis, Cloudflare merespons `logpush is not enabled for this account`. Log Gateway-nya bertahan selama 24 jam di sana, sehingga mode bukti menyalinnya ke dalam jurnal yang ditandatangani (**log Cloudflare Gateway mengenai permintaan DNS server ini**, sebuah token baca-saja dengan akses Account Analytics Read). `--gateway-location ID` (bersama dengan `--gateway-dns`) menggunakan lokasi DNS Gateway yang sudah ada, yang ditentukan oleh ID-nya yang terdiri dari 32 karakter, alih-alih membuatnya; perintah `destroy` membiarkannya tetap ada. Tanpa rencana Zero Trust, sebuah akun memiliki satu lokasi DNS. Ketika Cloudflare menolak yang lain, server membagikan lokasi yang ada dan kueri-kuerinya dibedakan berdasarkan alamatnya; filter tersebut juga memerlukan akses Zero Trust PII Read, dan `destroy` meninggalkan lokasi bersama. Satu kueri log mencakup paling lama tiga jam, sehingga salinan dan `verify` membaca data harian dalam jendela waktu tiga jam. Gateway DNS mencakup resolver sistem. DNS melalui HTTPS pada port 443 ke resolver lain, dan koneksi ke alamat yang tidak dicari di mana pun (misalnya, pusat data Telegram), tidak tercatat dalam lognya. Cloudflare tidak dapat melihat isi enkripsi Telegram, perangkat lain pada akun Telegram (daftar perangkat dalam mode bukti mencatatnya dari sisi Telegram) atau hypervisor penyedia layanan. ## Membaca hasil penyebaran Untuk VM biasa, penyedia mengontrol infrastruktur host, dan inventaris lokal diverifikasi bersamaan dengan catatan penyedia. Untuk Intel TDX, verifikator juga memeriksa spesifikasi perangkat keras, pengikatan pengumpul, komposisi, dan pengukuran sistem operasi. Baca hasil masing-masing untuk melihat pemeriksaan mana yang lulus atau tidak tersedia. Rincian firewall historis bergantung pada penyedia; Linode menyimpan versi aturan. Catatan validasi mencantumkan penerapan yang telah diuji dan pemeriksaan aktif yang tersisa, serta ruang lingkup verifikasi menghubungkan pemeriksaan lingkungan ini dengan akuisisi arsip dan integritasnya. --- # Telegram · Panduan panel Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/panel/ Setiap layar pada panel: obrolan, jurnal, sumber, ekspor, Ekstra, mode perlindungan, dan pemeriksaan kode. [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. Setiap layar pada panel: obrolan, jurnal, sumber, ekspor, Ekstra, mode perlindungan, dan pemeriksaan kode. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Memulai](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/) ![Memulai](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Pengaturan awal dan konfigurasi](https://phishdestroy.io/tgwitness/id/docs/reference/settings/) · [Akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/) · [Ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) · [Laporan kasus](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/) Apa fungsi setiap layar, apa yang ditulisnya ke jurnal yang ditandatangani, dan di mana panduan terperinci tersedia. Panel menampilkan satu ruang kerja pada satu waktu: satu akun Telegram dengan sumber, jurnal, dan kunci penandatanganan miliknya sendiri. Pemilih akun di bilah atas digunakan untuk berganti ruang kerja. Alamat tersebut menyertakan ruang kerja (`?ws=…`); selama alamat, pemilih, dan akun yang dimuat tidak sesuai, tindakan akan tetap diblokir. Gunakan metode pengumpulan [Compare](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) untuk memilih antara pengamatan langsung, riwayat lengkap, ekspor akun/obrolan terbaru, dan penyerahan catatan yang disimpan. Halaman Ekspor menampilkan perbandingan yang sama di atas kontrol unduhannya. **Di halaman ini** - [Temukan jalan Anda](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#find-your-way) - [Mulailah dari sini](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#start-here) - [Obrolan](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#chats) - [Jurnal](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#journal) - [Sumber](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#sources) - [Ekspor](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#exports) - [Pengaturan, akun, dan koneksi](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#settings-accounts-and-connection) - [Tambahan](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#extras) - [Mode perlindungan](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#protection-modes) - [Alat lainnya](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#more-tools) ## Temukan jalannya Bilah samping menyatukan enam bagian harian: **Beranda**, **Obrolan**, **Jurnal**, **Ekspor**, **Akun**, dan **Pengaturan**. Bagian yang tidak diizinkan untuk diakses akan dihilangkan. **Alat Lainnya** berisi alat investigasi dan administrasi. Buka **Tampilan** di bagian bawah bilah samping untuk mengubah bahasa, tema, zona waktu, atau tingkat antarmuka: | Tingkat | Bagian-bagian di bilah samping | | --- | --- | | Sederhana | Bagian harian | | Standar | Juga Case Board, Sumber, Akses, dan Dokumentasi di bawah Alat Lainnya | | Ahli | Juga Peta sistem, Topologi jaringan, Ekstra, Tanya arsip, Parameter, Akun, Log sistem, dan Integrasi di bawah Alat lainnya | Nama bagian tetap sama di setiap tingkat. Sebuah tingkat hanya menyembunyikan bagian-bagian. Fitur yang disembunyikan tetap berfungsi, dan server memeriksa setiap izin secara mandiri. Tingkat, bahasa, tema, dan zona waktu disimpan per operator dan ruang kerja; lihat [pengaturan](https://phishdestroy.io/tgwitness/id/docs/reference/settings/). Gunakan **Go to a section** di bagian atas bilah samping (Ctrl+K, atau ⌘K di Mac) untuk mencari obrolan, parameter, atau catatan jurnal berdasarkan `#number`. Tombol panah untuk berpindah, Enter untuk membuka, Esc untuk menutup. Bilah atas berisi: - **Pemberitahuan**: masalah dan perubahan obrolan diproses dari jurnal. Opsi **“Tandai Semua sebagai Telah Dibaca”** menghapus hitungan, sedangkan **“Aturan Pemberitahuan”** membuka pengaturan aturan. Pengiriman ke Telegram, Discord, atau email diatur di [Ekstra → Pemberitahuan](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#notifications). - Menu status koleksi dengan kontrol mulai/jeda, pengaturan koneksi, dan diagnostik kesehatan untuk Telegram, penerimaan peristiwa, sumber, dan antrian lampiran. Pada layar sempit, buka menu ini dengan ikon aktivitas. - **Kunci**: menutup panel di browser ini. Koleksi tetap berjalan di server. Versi dan mode perlindungan terdapat di bawah **menu Tampilan**; lihat [mode perlindungan](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#protection-modes). Instalasi akan membuka **Beranda** setelah masuk; tautan eksplisit akan membuka layar yang diminta. Peninjau dalam lingkup obrolan akan membuka **Obrolan**. Alamat-alamat `/home`, `/case-board`, `/pseudo-secret` dan `/network-topology` juga membuka layar yang sesuai. Alamat halaman yang tidak dikenal akan mengembalikan HTTP 404 dengan saran halaman terdekat. Ruang kerja demo berisi pesan fiktif dan tidak pernah terhubung ke Telegram. Tindakan yang dapat mengubah ruang kerja asli akan ditolak di sana. [Peta sistem](https://github.com/phishdestroy/TgWitness/blob/main/docs/SYSTEM-MAP.md) menampilkan rute akun, status proxy, titik akhir soket, brankas terenkripsi, layanan bukti, dan permintaan jaringan yang diamati pada instalasi ini. Pilih sebuah akun untuk memeriksa jalurnya. Layanan yang tersedia namun dinonaktifkan tetap terlihat. ## Mulailah dari sini Ikhtisar akan menghapus grafik dan ringkasan khusus akun tersebut saat Anda berpindah akun atau masuk kembali. Proses pemuatan, pembacaan yang gagal, dan periode tanpa catatan yang tersimpan memiliki status masing-masing. **Opsi Coba Lagi** akan mengulangi pembacaan yang gagal; jika server meminta penundaan, waktu upaya berikutnya akan ditampilkan. Penyegaran yang gagal akan mempertahankan data terakhir yang berhasil untuk ruang kerja yang sama dan menandainya dengan waktu pembaruan terakhirnya. Setiap akun yang terhubung menampilkan **"Collector heartbeat** " dan **Last event received** secara terpisah. Yang pertama menunjukkan aktivitas collector; yang kedua menunjukkan pembaruan Telegram terbaru yang diterima. Sumber yang tidak aktif dapat membuat waktu yang kedua tetap tidak berubah selama collector tetap berjalan. Buka menu "collection-status" untuk melihat diagnostik koneksi, pengambilan data, sumber, dan lampiran. Choose a task. **Export my account** downloads what the account can read now. **Follow an investigation** records new messages, observed edits and deletion notices from the chats you choose. While observation is paused, Chats, Journal and Sources show the setup card: connect the account, choose sources, start observation. With the goal **Evidence for a case**, or in the Witnessed, Case preparation, GitHub-verified or Maximum [protection mode](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#protection-modes), starting observation first reads Telegram's session list (not while **Strict: read only the chosen chats** is on). If other sessions are signed in, the panel names their number and offers **Start anyway** or **Open Sessions of this account**. Other goals and modes start without that question. The goal question stays on this page until you answer or skip it. A new workspace opens the [first setup](https://phishdestroy.io/tgwitness/id/docs/reference/settings/) instead. ## Obrolan Percakapan yang disimpan, secara default hanya dapat dibaca. Baris obrolan menampilkan status pengumpulan, unduhan berkas yang tertunda dan gagal, pemuatan riwayat awal, serta batasan yang tercantum dalam metadata dialog Telegram. Status akses yang hilang atau belum dikonfirmasi tidak menandakan adanya pemblokiran konten. Buka **Filter** untuk memilih status-status ini atau urutkan berdasarkan antrean berkas; pilihan tersebut tetap tersimpan dalam URL saat halaman dimuat ulang. Filter **Coba Lagi** menemukan pemuatan obrolan awal yang tertunda setelah terjadi kesalahan. Lencana pada filter tersebut menunjukkan jenis kesalahan dan, selama proses pengumpulan, waktu upaya berikutnya. Halaman Beranda merangkum berapa banyak pemuatan yang memerlukan upaya ulang. Pengumpulan yang dijeda akan menyimpan tugas-tugas tersebut hingga dilanjutkan kembali. In **Simple** mode Home also shows **Can be handed to a court: yes** or **no · missing: …**. Yes means timestamps are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does not check the signing key: the recipient confirms its fingerprint, received separately, and runs `verify.py` with `--tsa-ca` and the authority's root certificate. A Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here. Entri jurnal dengan lampiran yang dipertahankan menampilkan jenis, nama, dan ukuran byte yang teramati. Hasil unduhan baru juga mempertahankan jenis media dan durasinya jika Telegram menyediakannya. Catatan bertanda tangan yang lebih lama tetap tidak berubah; metadata yang hilang tidak direkonstruksi. - Cari daftar berdasarkan nama atau ID. Beberapa kata dapat cocok dalam urutan apa pun, termasuk kombinasi nama dan bagian dari ID. Tombol **+** membuka opsi **Tambahkan obrolan atau saluran** (menambahkan atau menghapus obrolan yang diawasi), **Buka tautan Telegram**, dan **Pseudo-secret · Mulai obrolan**. **Buka Tautan Telegram** menerima nama pengguna atau tautan undangan dan menyimpan pratinjau ke jurnal; pencarian terhadap @nama_pengguna atau tautan t.me yang tidak menemukan kecocokan akan menampilkan hal yang sama. **Bergabung / buka dan amati** kemudian akan bergabung ke obrolan dan menambahkannya ke sumber Anda; membuka bot akan mengirimkan perintah `/start` kepadanya. - Obrolan pseudo-rahasia muncul dalam daftar yang sama, berwarna hijau dengan ikon gembok, dan dibuka dalam mode Pseudo-rahasia. Saat pengamatan dinonaktifkan, daftar tersebut menampilkan satu **pesan "Pengamatan tidak** aktif" beserta opsi **Mulai pengamatan**. - Filter cepat berupa tab-tab dalam satu baris: **Semua**, **Pseudo-rahasia**, **Prioritas**, **Perubahan** (pengeditan yang disimpan atau pemberitahuan penghapusan), dan **Perlu Perhatian** (akses hilang atau belum dikonfirmasi, pesan tidak ditemukan saat diperiksa ulang, media gagal, upaya ulang riwayat, atau pembatasan Telegram). Tab yang kosong akan disembunyikan. Jumlah yang ditampilkan mengikuti filter pencarian dan jenis; filter cepat menggantikan filter status. Pilihan-pilihan ini tetap ada di URL saat halaman dimuat ulang dan saat navigasi Kembali/Maju. **Perlu Perhatian** tidak menandai pesan sebagai terhapus. Jenis, status, dan pengurutan khusus tetap terlihat sebagai chip yang dapat dilepas saat **Filter** ditutup. - Daftar besar menampilkan 80 hasil pencocokan sekaligus; **tombol Tampilkan lebih banyak** akan menampilkan 80 hasil berikutnya. Obrolan yang sedang terbuka dan baris yang sedang difokuskan tetap tersedia saat cocok, bahkan di luar kelompok hasil tersebut. Penghitung menunjukkan jumlah obrolan yang ditampilkan dari seluruh hasil pencocokan. Pencarian mencakup seluruh daftar, termasuk obrolan yang belum ditampilkan. - Dari halaman pencarian, **tombol ↓** berpindah ke hasil pertama, **↑** ke hasil terakhir yang ditampilkan, dan **tombol Enter** membuka hasil yang pertama. Di dalam daftar, **tombol ↑/↓** dan **Home/End** memindahkan fokus; **tombol Enter** membuka obrolan yang difokuskan. **Tombol Escape** kembali ke halaman pencarian, di mana menekannya lagi akan menghapus kueri. **Tombol Hapus filter** mengatur ulang daftar tanpa mengubah koleksi atau obrolan yang terbuka. - Header chat menghitung pesan **dihapus, teks dipertahankan**, **dihapus sebelum disimpan**, dan **tidak ditemukan saat diperiksa ulang**. Setiap hitungan adalah tombol yang hanya menampilkan pesan tersebut; tekan lagi untuk menampilkan semuanya. **Dihapus** dan **Tidak ditemukan saat diperiksa ulang** pada sebuah pesan membuka catatan berisi waktu dan apa yang teramati. Daftar chat dan notifikasi memakai definisi yang sama. Pesan yang dihapus berwarna merah dan menyimpan teks tersimpannya; pesan yang diedit menyimpan setiap versi yang tersimpan. - **Pencarian pesan yang disimpan** akan menelusuri seluruh riwayat obrolan yang disimpan, termasuk versi teks sebelumnya. Filter pesan yang dihapus, diedit, media, dan pengirim juga mencakup seluruh riwayat obrolan yang disimpan. **Pesan yang tidak ditemukan saat diperiksa ulang** merupakan hal yang terpisah dari pemberitahuan penghapusan yang diterima. Fitur pencarian tidak meminta pesan dari Telegram; gunakan **Muat Riwayat** untuk mendapatkan lebih banyak pesan. Jika ditemukan kecocokan dalam versi sebelumnya, versi yang disimpan akan dibuka beserta tautan jurnalnya. **Versi yang ditampilkan** mengidentifikasi catatan yang digunakan untuk pesan tersebut beserta penanda halamannya; tanggapan riwayat yang terlambat tidak dapat menggantikan pengeditan langsung yang lebih baru di layar. - Di antara pesan, chat menampilkan dua jenis penanda celah. **Nomor pesan tidak teramati** mencantumkan nomor yang tidak punya catatan di jurnal, hanya di kanal dan supergrup: chat lain berbagi satu penomoran untuk seluruh akun, sehingga lompatan di sana tidak mengatakan apa pun tentang chat itu. **Kesenjangan cakupan** menandai periode antara gangguan yang tercatat dan pemulihan tercatat berikutnya, beserta alasannya bila jurnal memilikinya. Penanda muncul saat semua pesan ditampilkan dan tersembunyi selama filter pesan aktif. - **Laporan pembangunan** Tombol di atas pesan akan membuka Report Studio dengan obrolan ini terpilih. Tombol yang sama pada kartu profil penulis akan memilih obrolan tersebut dan penulisnya. Kedua opsi tersebut hanya mengubah draf; simpan draf tersebut sebelum mengekspornya. - Menekan nama seorang penulis akan membuka kartu profil di samping pesan-pesan: profil yang disimpan, biografi, foto profil, hadiah, tautan, jumlah pesan, dan garis waktu aktivitas beserta catatan jurnalnya, ditambah opsi **Segarkan Profil** dan **Buat Laporan**. **Tombol Tutup**, Esc, atau obrolan lain akan menutup kartu tersebut; posisi obrolan tetap tidak berubah. **Ritme** dalam kartu menghitung pesan yang disimpan oleh penulis dalam obrolan ini dalam UTC: hari aktif, dimulai setelah 6 jam tidak ada aktivitas, waktu median untuk membalas orang lain dalam 24 jam, rentetan pesan berturut-turut terpanjang, bagian yang dikirim antara pukul 00:00 dan 06:00, serta peta panas hari kerja × jam. - **Pilih** di atas pesan menyalakan pemilihan pesan: ketuk pesan untuk menandainya, dengan Shift untuk menandai rentang, atau gunakan **Pilih yang ditampilkan**, lalu **Buat laporan**. Studio laporan terbuka dengan **Pesan terpilih** sudah terisi. Laporan mencakup catatan pesan tersebut (pengamatan, pengeditan, pemberitahuan penghapusan) yang lolos filter lain; filter penulis mengecualikan pemberitahuan penghapusan, yang tidak memiliki pengirim. Hingga 1.000 pesan dapat dipilih; sebuah chip di studio menghapus satu pesan, dan obrolan utuh dapat ditambahkan di sebelahnya. Nomor pesan yang hilang hanya dilaporkan untuk obrolan yang dipilih utuh. - **Riwayat pemuatan** menampilkan 100, 250, atau 500 pesan terakhir di tampilan ini dan di jurnal. Fitur ini dapat ditemukan di **menu Tindakan Obrolan**, bersama pengaturan perekaman, mode hanya baca, dan kontrol penyamaran rahasia. Menu ini dapat ditutup dengan menekan tombol Escape atau mengklik di luar menu. Memuat pesan-pesan sebelumnya akan mempertahankan posisi bacaan saat ini. Jika kueri atau halaman berubah saat Telegram merespons, proses pemuatan yang selesai akan memperbarui jurnal yang tersimpan tanpa menggantikan tampilan yang lebih baru. Jika pemuatan otomatis gagal, akan muncul opsi **Coba Lagi**. Untuk memuat semua sumber yang diaktifkan, gunakan [Sumber → Riwayat Lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#sources). - **Fitur Ekspor Obrolan** mengunduh seluruh riwayat yang terlihat sebagai file yang ditandatangani `chat.json` dan `chat.html`. Beberapa akun yang terhubung dapat berbagi pekerjaan: masing-masing mengunduh rentang nomor pesan miliknya sendiri dan menandatangani bagiannya, sedangkan akun yang memulai proses ekspor menandatangani arsip tersebut. Lihat [cara mengekspor satu obrolan](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md). - Daftar **Orang** menampilkan semua orang yang memiliki pesan tersimpan di obrolan ini. Profil Orang dinonaktifkan secara default karena berisi data pribadi pihak ketiga. Saat diaktifkan untuk suatu obrolan, profil menampilkan nama dan riwayat nama pengguna, bendera Telegram, hash avatar, aktivitas, siapa yang membalas siapa, obrolan lain yang diamati, serta dompet, nomor telepon, nama pengguna, dan tautan yang disebutkan. Setiap fakta mengarah ke catatannya. **Mengekspor profil** akan menyimpan berkas yang ditandatangani, secara opsional dalam ZIP yang dilindungi kata sandi; menonaktifkan profil akan menghapus berkas profil tersebut. Lihat [profil pengguna](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#people-profiles). - **Fitur "Kumpulkan Semua Penulis** di Tab yang Sama" meminta Telegram untuk menampilkan profil, bio, foto profil, hadiah, dan tautan bio dari setiap orang yang pesannya telah disimpan di obrolan. Di saluran atau supergrup, akun-akun lain yang terhubung dapat ikut serta dalam proses ini. Setiap akun yang dipilih disediakan khusus untuk koleksi ini, mencakup seluruh informasi pengguna, dan menghubungi penulis melalui salah satu pesan yang telah disimpan oleh penulis tersebut. Akun yang sedang sibuk dengan tugas lain tidak akan diganggu dan akan bergabung begitu sudah bebas. Jika penulis tidak dapat dihubungi, proses akan kembali ke akun obrolan itu sendiri. Kemajuan ditampilkan dalam bentuk persentase, waktu yang tersisa, dan kontribusi setiap akun; **tombol Jeda** akan melepaskan akun-akun tersebut. Setiap catatan yang disimpan mencantumkan nama akun yang membacanya, dan jurnal mencatat kapan setiap akun bergabung dan keluar. - **Fitur "Simpan Profil" kini** merekam cuplikan profil obrolan atau bot: deskripsi, anggota, tautan undangan, dan perintah bot. ### Hanya baca, pengiriman, dan rahasia Dua tombol di atas pesan berfungsi untuk melindungi akun dan pembaca: - Mode **hanya baca** aktif saat obrolan dibuka. Matikan mode ini untuk mengirim pesan atau menekan tombol bot . Setiap tindakan akan menanyakan **"Kirim sebagai @akun?**" atau **"Tekan tombol bot ini sebagai @akun?**", yang memberi tahu Anda bahwa anggota obrolan akan melihatnya dan bahwa tindakan tersebut akan masuk ke dalam jurnal yang telah ditandatangani. **Pilihan "Jangan tanyakan lagi selama 10 menit dalam obrolan ini"** akan melewatkan pertanyaan tersebut untuk sementara waktu. Fitur pengiriman dinonaktifkan untuk tujuan "**Bukti untuk suatu kasus**", baik di panel maupun di API. - **Fitur "Mask secrets"** menyembunyikan apa yang tampak seperti kata sandi, kode login, kunci API atau hash, token bot, string sesi, kunci pribadi, JWT, atau nomor kartu pembayaran (nomor kartu diperiksa dengan Luhn sum). **Fitur "Show"** menampilkan satu nilai; penampilan tersebut dicatat dalam jurnal. Menonaktifkan penyamaran untuk browser ini juga dicatat. Hanya tampilan yang berubah: catatan asli dan setiap ekspor tetap menyimpan teks lengkapnya. ### Simpan pesan yang dipilih sebagai gambar Dalam obrolan cloud, pilih **Pilih**, tandai pesan-pesan tersebut, lalu pilih **“Simpan sebagai gambar**”. Untuk menyimpan seluruh obrolan, pilih **Simpan obrolan sebagai gambar** di menu alat obrolan; fitur ini akan memuat hingga 2.000 pesan terakhir yang tersimpan dan memberi tahu jika pesan yang lebih lama tidak disertakan. Tampilan pratinjau menawarkan gaya **Terang**, **Gelap**, dan **Klasik**; gunakan tombol “Sebelumnya” dan “Berikutnya” untuk tangkapan layar yang lebih panjang. **Unduh ZIP yang telah ditandatangani** untuk menyimpan setiap halaman sebagai PNG bersama dengan `pages.sig.json` dan `README.txt` ([gambar obrolan yang ditandatangani](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#signed-chat-images)). Maksimal 50 pesan dapat dipilih, dan semuanya harus masih ada di jendela obrolan yang dimuat . Panel tersebut akan meminta Anda untuk mengurangi pilihan yang terlalu besar alih-alih secara diam-diam menghapus pesan. Setiap halaman diakhiri dengan blok keaslian: nomor catatan jurnal yang ditampilkannya, percakapan, waktu rendering, sidik jari kunci ruang kerja, `verify.py` perintah untuk halaman tersebut, serta kode QR yang berisi riwayat obrolan, kunci, dan waktu rendering. Proses penandatanganan memerlukan izin ekspor dan menambahkan sebuah `export.image_attested` catatan ke jurnal. Gambar tersebut mencakup teks yang disimpan, penulis, nomor pesan, waktu UTC, nomor balasan, label lampiran, serta status penyuntingan/penghapusan yang disimpan. Gambar ini menggunakan teks terbaru yang disimpan beserta jumlah versi yang disimpan; isi lampiran, tombol dalam teks, reaksi, dan versi teks sebelumnya tidak ditampilkan. Pesan yang panjang berlanjut ke halaman berikutnya dengan nomor pesan dan jumlah bagiannya. Setiap halaman mengidentifikasi dirinya sebagai hasil tampilan dari pesan yang disimpan. File PNG ini merupakan cuplikan visual; gunakan arsip dan verifikatornya saat menyerahkan catatan yang ditandatangani beserta lampirannya. Proses rendering dilakukan di browser tanpa mengirimkan permintaan ke Telegram; untuk proses penandatanganan, hanya nilai SHA-256 dan nomor rekaman dari setiap halaman yang dikirimkan ke panel. Fitur penyamaran rahasia yang ada melindungi teks, nama penulis, dan label lampiran. Pratinjau menyimpan tangkapan layar hingga ditutup dan akan dihapus saat panel dikunci atau saat terjadi perubahan ruang kerja/obrolan. Pilihan jurnal dan laporan yang telah ditandatangani tetap tidak berubah. Lihat [laporan kasus](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/) untuk ekspor laporan lengkap. ### Meneruskan pesan Nonaktifkan **mode Hanya Baca** pada obrolan, lalu pilih **Teruskan** di bawah sebuah pesan, atau **pilih** dan tandai hingga 100 pesan, lalu pilih **Teruskan**. Pilih tujuan berdasarkan nama: daftar tersebut berisi obrolan yang disimpan dan obrolan Telegram akun tersebut yang dapat digunakan untuk mengirim pesan (grup, obrolan pribadi, bot, dan saluran yang dikelolanya). Panel tersebut meminta konfirmasi, lalu meneruskan pesan secara langsung melalui Telegram sesuai dengan kecepatan pengiriman pesan akun tersebut. Permintaan dan hasilnya merupakan catatan jurnal yang ditandatangani, yang mencantumkan obrolan sumber, nomor pesan, dan tujuan. Salinan hanya disimpan di tujuan jika obrolan tersebut sedang dipantau. Obrolan yang melarang penerusan akan menolak permintaan tersebut dan tidak ada pesan yang dikirim. ### Meneruskan obrolan ke saluran atau grup Administrator utama dapat membuka obrolan cloud yang telah disimpan dan memilih **Teruskan obrolan** dari menu alatnya. Pilih **Saluran baru**, **Grup baru**, atau **Saluran atau grup yang sudah ada**. Tujuan baru bersifat pribadi. Untuk tujuan yang sudah ada, **opsi Pilih obrolan** menampilkan daftar grup akun tersebut dan saluran yang dikelolanya; cari berdasarkan nama. Tujuan tersebut harus mengizinkan akun ini untuk memposting. Tujuan forum tidak didukung. Jeda pengamatan atau tugas akun aktif lainnya, lalu aktifkan tindakan Telegram sebelum melakukan pratinjau. Akun hanya-baca dan tujuan **Bukti untuk suatu kasus** memblokir transfer. **Pratinjau** membaca batas riwayat Telegram yang dapat diakses dan memeriksa tujuan. Fitur ini tidak membuat tujuan baru atau mengirim pesan. **Tombol Mulai** akan memulai transfer; pratinjau akan kedaluwarsa setelah sepuluh menit. Hanya satu transfer yang dapat aktif per ruang kerja. Proses transfer ini membaca riwayat Telegram dari yang tertua hingga yang terbaru, hingga pesan terakhir yang terlihat di pratinjau. Proses ini tidak terbatas pada pesan yang sudah disimpan di TgWitness. Pesan yang masuk di atas batas tersebut tidak disertakan. Penerusan asli mempertahankan informasi pengirim dan media yang tersedia di Telegram tanpa mengunduh dan mengunggah salinan. Album yang berada dalam batas tersebut tetap utuh. Pemberitahuan tidak ditampilkan. Balasan, struktur topik, reaksi, pengeditan, serta pesan yang dihapus atau tidak dapat diakses tidak direkonstruksi. Obrolan Rahasia berada di luar alur kerja ini. Perlindungan konten Telegram dan pembatasan pengiriman tetap berlaku. Panel tersebut menampilkan pengiriman yang telah dikonfirmasi, pengiriman yang dilewati, status, dan waktu upaya berikutnya yang diizinkan. Pesan layanan dan pesan yang dilindungi secara individual dilewati dengan alasan yang tercatat. Jarak antar pesan akun dan batas per jam berlaku untuk setiap pesan; sebuah album akan menunggu hingga slot yang telah dialokasikan untuknya tiba waktunya. Jeda FloodWait dan mode lambat memperbarui backoff RPC bersama akun tersebut. Pengaturan default pacing yang sudah ada pada akun tersebut tetap tidak berubah. **Tombol Pause** menghentikan proses sementara antara permintaan; **tombol Cancel** menghentikan pekerjaan yang tersisa tanpa menghapus pesan yang sudah terkirim atau menghapus tujuan yang telah dibuat. Permintaan yang sedang diproses mungkin selesai sebelum salah satu tindakan tersebut berlaku. Menutup jendela dialog tidak akan membatalkan pekerjaan. Setelah proses dimulai ulang, pekerjaan yang belum selesai memerlukan perintah **Lanjutkan** secara eksplisit. Respons pengiriman yang hilang atau tidak lengkap akan menjeda pekerjaan untuk ditinjau: periksa tujuan sebelum melanjutkan. Upaya ulang mempertahankan ID acak Telegram yang tersimpan dan jumlah yang telah dikonfirmasi; ini bukan jaminan bahwa Telegram akan melakukan deduplikasi tanpa batas waktu. Hasil pembuatan yang tidak diketahui tidak dapat dilanjutkan secara otomatis: periksa Telegram dan batalkan pekerjaan lama sebelum memulai transfer baru ke tujuan yang telah dibuat, jika ada. Jika penyimpanan suatu pekerjaan atau entri jurnalnya gagal, pekerja akan mengembalikan ke keadaan terakhir yang tersimpan dan melepaskan akun tersebut. Pengiriman atau pembuatan yang mungkin sudah sampai ke Telegram tetap ditandai untuk ditinjau. Coba ulang proses yang gagal atau lanjutkan setelah penyimpanan tersedia kembali; kemajuan yang telah dikonfirmasi hanya akan berlanjut bersamaan dengan entri jurnalnya. Entri jurnal yang ditandatangani `interaction.forward.*` Entri jurnal mencatat batas, tujuan, ID pesan sumber/tujuan yang dikonfirmasi, dan lompatan. Entri ini mendokumentasikan transfer; entri ini tidak menggantikan pengamatan dan ekspor asli yang ditandatangani. ## Jurnal Setiap catatan yang telah ditandatangani oleh ruang kerja, ditampilkan mulai dari yang terbaru. - **Ikhtisar** menghitung pesan yang diamati, pengeditan yang direkam, pemberitahuan penghapusan, dan sumber yang dipilih. - **Garis waktu peristiwa** menyaring berdasarkan jenis peristiwa (semua, pengeditan, penghapusan, reaksi, keanggotaan, cakupan), berdasarkan teks, dan berdasarkan sumber. **Muat peristiwa sebelumnya** kembali ke halaman sebelumnya. - Buka sebuah catatan untuk melihat detail, hash, dan muatannya. **Tautan ke catatan ini** adalah alamat yang membuka catatan yang sama. Informasi rahasia yang mungkin ada disamarkan dalam pratinjau ini; ekspor tetap mempertahankan versi aslinya. - Jurnal ini bersifat hanya tambah: tidak ada yang di panel yang dapat mengedit atau menghapus catatan. Periksa dengan **Ekspor → Verifikasi jurnal** atau `python -m tgwitness.verify`; lihat [ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/). ## Sumber Percakapan mana saja yang direkam oleh ruang kerja ini, dan apa saja yang disimpan darinya. Perubahan berlaku untuk aktivitas di masa mendatang; catatan yang telah disimpan tetap ada. **Refresh daftar obrolan** membaca obrolan dan folder akun tersebut. Fitur ini tidak mengunduh pesan. ### Ruang Lingkup - **Apa yang dicatat oleh akun ini** : **Obrolan yang dipilih** (hanya obrolan yang Anda tambahkan), **Folder Telegram** (salah satu folder akun, termasuk obrolan yang ditambahkan ke dalamnya kemudian) atau **Seluruh akun** (setiap obrolan, serta setiap obrolan baru, grup, obrolan pribadi, atau bot begitu muncul). **Mode penyelidikan** diperuntukkan bagi akun khusus: alat ini merekam segala sesuatu yang dilihat akun tersebut, pesan dan penekanan tombolnya sendiri, serta langsung menyimpan profil setiap obrolan baru beserta pesan-pesan yang sebelumnya terlihat. Gambar [panduan akun khusus](https://phishdestroy.io/tgwitness/docs/dedicated-account/) menjelaskan mengapa Anda tidak boleh menggunakan akun utama Anda. - **Ketat: hanya membaca obrolan yang dipilih** (Hanya obrolan yang dipilih, dinonaktifkan secara default) menghentikan pembacaan pemberitahuan layanan Telegram, daftar sesi, dan pesan-pesan sebelumnya dari obrolan yang diaktifkan, tidak mengubah pengaturan konten sensitif, dan melewatkan pembaruan panggilan telepon. Lihat [obrolan yang dipilih secara ketat](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#strict-chosen-chats). - **Jenis sumber** membatasi mode folder dan seluruh akun hanya untuk saluran, grup, obrolan pribadi, dan bot. **Tindakan sendiri** menambahkan pesan, pengeditan, dan penekanan tombol balasan dari akun tersebut. - **Saat obrolan atau bot baru muncul**: simpan profilnya dan hingga sejumlah pesan terbarunya yang terlihat. - **Obrolan yang dipilih** ditandai sebagai rekomendasi. Opsi **Batalkan Perubahan** akan mengembalikan formulir ke ruang lingkup yang telah disimpan hingga Anda menekan tombol **Simpan Ruang Lingkup**. [Pseudo-secret](https://phishdestroy.io/tgwitness/id/docs/reference/secret-chats/) adalah antarmuka Obrolan Rahasia yang disertakan, yang diaktifkan per akun setelah menginstal modul protokolnya dengan satu tombol. Pemantauan cloud dan riwayat menggunakan pengaturan masing-masing. Tidak ada yang direkam saat TgWitness tidak berjalan; setelah di-restart, aplikasi ini hanya mencatat apa yang masih dikembalikan oleh Telegram, dan laporan menunjukkan selisihnya. Obrolan yang melebihi batas daftar obrolan (1.000 percakapan kecuali diubah di Parameter) akan ditambahkan saat obrolan tersebut aktif kembali. Tombol bot yang ditekan di dalam aplikasi lain tidak terlihat; balasan bot tetap direkam. ### Obrolan yang termasuk dalam cakupan Saring berdasarkan status (**Diaktifkan**, **Dijeda**, **Prioritas**, **Dikecualikan**, **Akses Belum Dikonfirmasi**, **Diabaikan**) dan jenis, lalu lakukan tindakan pada pilihan: aktifkan, jeda, tandai atau hapus prioritas, kecualikan dari cakupan, atau hapus. Lencana status hanya menunjukkan keadaan; tindakan terdapat di menu setiap baris dengan penjelasan singkat tentang fungsinya. Menjeda dan mengecualikan memerlukan konfirmasi, termasuk untuk tindakan massal. Menghapus sumber akan meminta nama sumber tersebut dan menghapus profil orang-orangnya ; catatan yang disimpan tetap ada di jurnal. Sumber yang tidak muncul dalam daftar obrolan akun sedang **menerima pembaruan, tidak ada dalam daftar obrolan**meskipun catatan terus masuk; jika tidak, **akses belum dikonfirmasi**. **Obrolan yang tersedia**menambahkan obrolan dengan **opsi “Tambahkan yang dipilih”** atau **“Tambahkan semua yang cocok**”. ### Riwayat lengkap Memuat riwayat yang tersedia dari setiap sumber yang diaktifkan ke dalam Obrolan dan jurnal. Kemajuan tetap tersimpan setelah restart; lampiran mengikuti pengaturan media Anda. Lihat [riwayat sumber](https://phishdestroy.io/tgwitness/id/docs/reference/history/). ### Perekaman - **Pilih perubahan mana yang ingin disimpan**: pesan baru, pengeditan, pemberitahuan penghapusan, reaksi yang terlihat, bergabung, dan keluar. Pengaturan awal mengubah formulir; **Simpan pengaturan rekaman** akan menerapkannya. Mengaktifkan kembali suatu kategori tidak akan memulihkan peristiwa yang terlewat. - **Simpan media jika tersedia**: unduh lampiran hingga ukuran tertentu per file, atur per jenis dari 1 hingga 2.000 MiB, dan batasi durasi video dalam detik (0 berarti tidak ada batasan). Setiap upaya pengunduhan akan mencatat hasilnya. - **Pemeriksaan ulang**: obrolan prioritas diperiksa setiap beberapa menit, obrolan lain jarang, sehingga akun tetap terhindar dari batas FloodWait Telegram. Nilai 0 menonaktifkan grup. Tandai obrolan prioritas dengan bintang di daftar; jumlah obrolan per putaran dan jeda antar obrolan terdapat di Parameter. Lihat [koleksi](https://phishdestroy.io/tgwitness/id/docs/reference/collection/). - Bilah penyimpanan menunjukkan apakah pengaturan ini sesuai dengan yang direkomendasikan. **Pilih Kembali ke yang direkomendasikan** untuk mengisi nilai-nilai yang direkomendasikan; pilih **Simpan pengaturan perekaman** untuk menerapkannya dan pilih **Batalkan perubahan** untuk mengembalikan pengaturan yang telah disimpan. ## Ekspor **Bagian Unduhan** menyiapkan berkas; **Laporan Pembuatan** menentukan tampilan laporan. | Apa | Gunakan untuk | Panduan | | --- | --- | --- | | Ekspor akun | Cuplikan terbaru mengenai apa yang dapat dibaca oleh akun tersebut saat ini | [Ekspor akun](https://phishdestroy.io/tgwitness/id/docs/reference/account-export/) | | Berbagi salinan | Versi ringkas dari ekspor akun yang sudah selesai | [Pengungkapan](https://phishdestroy.io/tgwitness/id/docs/reference/account-export/#prepare-a-disclosure-for-a-lawyer-or-another-recipient) | | Tertanda ZIP | Jurnal, laporan, lampiran, dan alat verifikasi dalam batas jurnal yang tetap | [Ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) | | Laporan dalam format HTML, PDF, dan JSON | Laporan yang dapat dibaca dan disegel | [Laporan kasus](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/) | | JSONL, CSV | Catatan asli yang telah ditandatangani; lembar kerja yang aman untuk rumus | [Ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) | | Cuplikan serah terima | Hanya obrolan, periode, dan orang-orang yang dibutuhkan oleh penerima | [Bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#investigation-handoff) | | Ekspor obrolan | Satu obrolan yang telah ditandatangani `chat.json` dan `chat.html` | [Ekspor satu obrolan](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md) | - **Mengenkripsi unduhan di atas dengan kata sandi** (12 karakter atau lebih) akan menyimpan berkas AES-256 ZIP yang dapat dibuka dengan 7-Zip atau WinRAR. Berkas yang ditandatangani di dalamnya tetap tidak berubah. Kata sandi tidak disimpan. - Saat kunci sesi ruang kerja ini diimpor, dialog ekspor akun dan obrolan menyebutkannya dalam satu baris: salinan kunci tersebut dapat ada di luar daftar sesi Telegram. Baris yang sama menawarkan **opsi Buat otorisasi independen**, yang membuka halaman masuk dengan opsi tersebut sudah dipilih. Lihat [akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#create-an-independent-authorization). - Ekspor obrolan yang gagal atau dibatalkan tetap mempertahankan rentang yang telah disimpan. **Menangkap atau mengekspor satu obrolan** kemudian menawarkan opsi **Lanjutkan ekspor** dan **Mulai dari awal**; lihat [ekspor satu obrolan](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md). - Saat mengekspor riwayat obrolan yang sudah dibaca, opsi **Unduh pesan yang sudah dibaca sejauh ini** akan menyimpan berkas ZIP yang setiap halamannya ditandatangani saat ditulis; baris di bawahnya menunjukkan jumlah pesan yang telah ditandatangani. - **Ekspor yang telah disiapkan** menyimpan hingga 20 berkas dengan total ukuran maksimal 2 GiB, ditambah berkas terbaru, untuk pengunduhan berulang, masing-masing dilengkapi dengan nilai SHA-256 agar penerima dapat membandingkannya. Setiap kartu mencantumkan isi berkas tersebut: **Arsip yang ditandatangani** (jurnal lengkap beserta jumlah catatannya), **Laporan**, **Catatan jurnal**, atau **Ekstrak serah terima**, judul dan ID kasus, serta pilihan laporan yang digunakan untuk menyusunnya (obrolan, pesan yang dipilih, tanggal). **Tombol Tampilkan** akan mempersempit daftar menjadi satu jenis jika terdapat lebih dari satu jenis. - Jika browser menolak dialog penyimpanan, panel akan beralih ke unduhan biasa. - **Identitas penandatanganan Anda** menampilkan sidik jari kunci. **Simpan titik pemeriksaan** dan Unduh **tanda terima eksekusi yang ditandatangani** memberi Anda catatan untuk disimpan di luar pengumpul. Siapkan **permintaan cap waktu** membuat permintaan RFC 3161 tanpa menghubungi layanan apa pun. ## Pengaturan, akun, dan koneksi - **Pengaturan**: tujuan, koneksi, apa yang akan direkam, dan antarmuka. Lihat [pengaturan awal dan pengaturan](https://phishdestroy.io/tgwitness/id/docs/reference/settings/). - **Akun**: setiap ruang kerja beserta status, sumber, peristiwa, dan antrian lampirannya. Saring berdasarkan **Perlu Perhatian**, **Sedang Dikumpulkan**, **Offline atau Ditangguhkan**, atau **Tidak Terhubung**; tunda atau lanjutkan pilihan; impor berkas akun secara massal dan kelola grup. Lihat [akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/). - **Akun**: masuk dan rute koneksi akun ini. Langsung, profil WireGuard , proxy Anda sendiri, kumpulan MTProto publik, atau WARP; siapkan dan periksa rute, lalu terapkan ke akun ini, grup, atau semua akun. Lihat [koneksi dan proxy](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) serta [proxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md). **Keamanan akun → Sesi akun ini** mencantumkan sesi Telegram, mengakhiri satu atau semua sesi tersebut, dan — untuk kunci yang dibuat di ruang kerja ini — menawarkan opsi **Jadikan ini satu-satunya sesi saat Telegram mengizinkannya**, yang mengulangi tindakan tersebut setelah 24 jam yang disyaratkan Telegram dan menampilkan kata sandi dua langkah yang ditetapkan sekali. Lihat [keamanan](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#create-an-independent-authorization) akun. **Keamanan akun → Uji saksi** menggunakan ruang kerja kedua untuk memeriksa apakah sesi ini menerima pembaruan secara langsung; lihat [uji saksi](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#witness-probe). Fitur jeda dan lanjutkan secara massal mempertahankan pilihan yang telah dikonfirmasi dalam sesi tempat pilihan tersebut dibuka. Kontrol tetap dinonaktifkan selama konfirmasi atau eksekusi masih tertunda; mengubah ruang kerja atau mengunci panel akan membatalkan perintah yang tersisa. Setelah eksekusi, panel akan memperbarui status akun. Permintaan yang gagal dilaporkan sebagai kegagalan permintaan, karena server mungkin telah menerapkan perintah tersebut. Perintah tidak diulangi secara otomatis. ## Fitur Tambahan Opsional: akun dan sumber saja sudah cukup untuk mulai mengumpulkan data. Hanya opsi yang Anda pilih yang akan membuka pengaturannya, dan tidak ada yang terhubung secara otomatis. Kartu **“Tingkat Perlindungan”** di bagian atas menunjukkan [mode perlindungan](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#protection-modes). | Kartu | Fitur tambahan | Panduan | | --- | --- | --- | | Penyimpanan & ruang disk | Pencadangan, memindahkan file lama ke cloud Anda, serta salinan bukti yang tidak dapat dihapus | [Penyimpanan](https://phishdestroy.io/tgwitness/id/docs/reference/storage/) | | Tujuan & tingkat perlindungan | Pengaturan yang disarankan untuk tujuan Anda dan dua skala | [di bawah ini](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#goal-and-protection-level) | | Pemberitahuan | Masalah, pesan yang diubah, dan ringkasan harian; bot kontrol milik Anda sendiri | [di bawah ini](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#notifications) | | Bukti & cadangan | Cap waktu, saksi tambahan, dan salinan terenkripsi di luar lokasi | [di bawah ini](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#evidence-and-backups) | | Server beroperasi 24/7 | Server cloud tanpa SSH, yang dibuat dan dihapus melalui panel | [Jaminan tinggi](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#from-the-panel) | | Saksi independen | Pemeriksaan yang telah ditandatangani diposting ke saluran Telegram atau Discord Anda | [Saksi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/) | | Pemeriksaan kode | Membandingkan program yang sedang berjalan dengan commit GitHub publik | [di bawah ini](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#code-check) | ### Tujuan dan tingkat perlindungan Empat pertanyaan: 1. **Untuk apa ini? Sebagai** catatan pribadi, penyelidikan, atau bukti untuk suatu kasus. 2. **Seberapa banyak yang akan Anda pantau?** Beberapa obrolan (hingga sekitar 50), banyak obrolan (hingga sekitar 500), atau seluruh akun. Ini menetapkan batas daftar obrolan menjadi 1.000, 3.000, atau 20.000. 3. **Foto dan berkas?** Hanya teks, foto dan media pendek (foto 20 MB, video 100 MB), atau semuanya (video dan dokumen masing-masing hingga 1 GB). Opsi “semuanya” dengan akun lengkap juga menyisakan ruang disk kosong sebesar 4 GiB. 4. **Di mana alat ini akan dijalankan?** Di komputer ini, atau di server yang selalu aktif. Saran tersebut mencantumkan cap waktu independen, drand, dan daftar perangkat Telegram, masing-masing dilengkapi dengan penjelasan singkat mengenai fungsinya. Cap waktu dimulai setiap 60, 30, atau 10 menit untuk catatan pribadi, penyelidikan, atau bukti; drand dan daftar perangkat memerlukan cap waktu. **Terapkan** perubahan hanya pada hal-hal ini, kebijakan lampiran, dan dua parameter di atas. Setiap perubahan merupakan catatan jurnal, ditambah `setup.applied`. Pemberitahuan, salinan di luar situs, server, Gateway DNS, pemeriksaan kode, dan saksi ditawarkan sebagai langkah selanjutnya dengan formulir masing-masing. Dua skala dihitung berdasarkan pengaturan yang ada, bukan berdasarkan tujuan: | Skala | Poin | | --- | --- | | Kredibilitas | Jurnal yang ditandatangani 1, cap waktu 3, drand 1, daftar perangkat 1, pemeriksaan kode yang cocok 1, polling saksi 1, server yang disertifikasi 2, log DNS Gateway 1 | | Keandalan | Server yang selalu aktif 3, salinan di luar lokasi 3, Object Lock 1, pemberitahuan masalah 1 | 80% atau lebih dianggap **maksimal**, 50% **tinggi**, 25% **sedang**, di bawah itu **dianggap dasar**. Keandalan saat ini dihitung berdasarkan server yang selalu aktif sesuai jawaban pertanyaan 4, sebelum server mana pun diperiksa. ### Pemberitahuan Pemberitahuan dikirim melalui Apprise ke Telegram, Discord, Slack, ntfy, email, Matrix, dan lebih dari 100 layanan lainnya. Pilih layanan, isi satu atau dua kolom, lalu kirim uji coba, atau tempelkan alamat Apprise secara langsung. - **Masalah**: disk hampir penuh, akun keluar, kesalahan pengumpulan, penyalinan, atau cap waktu , sesi baru yang masuk ke akun dengan perangkat, aplikasi, dan daftar negara Telegram, kode login atau masuk baru yang dilaporkan Telegram selama pengamatan, serta sesi lain setelah **opsi Jadikan ini satu-satunya sesi diaktifkan**. Pada server yang disegel , port SSH yang terbuka atau proses login juga merupakan masalah. - **Perubahan**: pesan yang dihapus, diedit, dan hilang dalam obrolan yang dipantau, dikelompokkan menjadi satu pemberitahuan per pemeriksaan (setiap menit kecuali diubah di Parameter). - **Tugas yang telah diselesaikan**: riwayat, ekspor, dan salinan penyimpanan. - **Kecocokan daftar pantauan**: kecocokan dari daftar pantauan yang diatur untuk mengirimkan peringatan. - **Ringkasan harian** pada jam yang dipilih, sesuai waktu server. Pemberitahuan menampilkan nama obrolan dan jumlah pesan. Kutipan pesan dinonaktifkan secara default; jika diaktifkan, teks pesan akan dikirimkan ke luar perangkat ini. **Bot operator Anda** adalah bot milik Anda sendiri yang dibuat melalui @BotFather yang menjawab `/status` dan `/stats`, serta secara opsional `/pause`, `/resume` dan `/copy`. Hanya obrolan dan ID pengguna Telegram yang tercantum yang dapat menggunakannya; teks percakapan tetap berada di ruang kerja. Gunakan bot terpisah jika aplikasi lain sudah menerima perintahnya. Lihat [notifikasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Notifications.md) dan [bot operator](https://phishdestroy.io/tgwitness/id/docs/reference/storage/#operator-bot-and-completion-notices). ### Bukti dan cadangan - **Cap waktu independen** hanya mengirimkan SHA-256 dari setiap titik pemeriksaan yang ditandatangani ke otoritas RFC 3161 dan kalender OpenTimestamps, setiap 5 hingga 1,440 menit. Penerima memerlukan waktu pihak ketiga tersebut sebagai syarat minimum untuk bukti. **Anchor kini** menjalankan satu putaran. Lihat [cap waktu](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/). - **Saksi-saksi lainnya**, masing-masing dinonaktifkan hingga dipilih: putaran drand terbaru, daftar perangkat yang masuk ke Telegram tanpa alamat IP, dan log Cloudflare Gateway mengenai kueri DNS server. Lihat [catatan opsional](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices). - **Pencadangan terenkripsi** menyalin jurnal, file, titik pemeriksaan, dan ekspor obrolan ke penyimpanan yang kompatibel dengan S3 (Wasabi, Amazon S3, Backblaze B2, Cloudflare R2, MinIO). Semua data dienkripsi terlebih dahulu di mesin ini. **Unduh kunci enkripsi** dan simpanlah terpisah: tanpa kunci tersebut, salinan tersebut tidak dapat dibaca. Object Lock dalam mode Governance atau Compliance mencegah objek dihapus selama jumlah hari yang ditentukan. Lihat [salinan di luar lokasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Off-site-Copy.md). ### Pemeriksaan kode Memeriksa apakah program yang terinstal sesuai dengan versi yang telah diterbitkan. 1. Masukkan repositori GitHub (yang resmi sudah terisi) serta tag, cabang, atau commit. 2. **Fitur "Check now"** meminta daftar berkas dari commit tersebut melalui API GitHub, melalui rute ruang kerja ini untuk permintaan eksternal. Fitur ini membandingkan ID blob Git dari setiap berkas program yang diukur dengan commit tersebut. Hasil checkout di Windows dengan akhir baris yang telah dikonversi tetap cocok. 3. Hasilnya mencantumkan file yang berubah, tambahan, dan yang hilang (masing-masing hingga 50) dan disimpan sebagai catatan `source.checked` catatan jurnal. Hasil ini hanya dianggap terkini selama berkas program yang sedang berjalan tidak diubah: periksa kembali setelah pembaruan. Tidak diperlukan token dan hanya repositori publik yang berfungsi; obrolan dan kredensial tidak diunggah. Pencocokan mengidentifikasi kode di disk. Ini bukan pengesahan perangkat keras; untuk itu, lihat [Phala Cloud](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx). ## Mode perlindungan Tombol pengalih di sebelah nomor versi menunjukkan mode yang dipilih dan berapa banyak dari 18 lapisan perlindungan yang aktif, misalnya `🟠 Witnessed 9/18`. Untuk **mengubah mode**, pilih **"Extras" → "Tingkat Perlindungan"** untuk membuka menu pilihan. Setiap mode menggambarkan target tertentu dan mencantumkan apa saja yang masih belum tercakup; proses perekaman, penandatanganan, dan pengaturan yang disimpan tetap sama di setiap mode. | Mode | Untuk | Menambahkan | | --- | --- | --- | | 🟢 Mudah | Memantau obrolan dan menyimpan salinannya | Obrolan, jurnal, dan ekspor obrolan; proses penandatanganan berjalan di latar belakang | | 🟡 Ditandatangani | Melaporkan ke platform, host, atau bagian penanganan pelanggaran | Arsip yang ditandatangani, pemeriksaan jurnal, titik pemeriksaan, ekstrak serah terima | | 🟠 Disaksikan | Kasus-kasus di mana seseorang mungkin mengklaim bahwa catatan tersebut telah diubah | Saksi independen yang memposting entri jurnal yang telah ditandatangani | | 🔴 Siap untuk persidangan | Bukti untuk pengacara, kepolisian, atau pengadilan | Cap waktu, salinan terenkripsi di luar lokasi, serta rincian kasus dalam laporan | | 🟣 Terverifikasi oleh GitHub | Catatan yang perangkat lunaknya harus dapat diperiksa oleh siapa pun | Pemeriksaan kode dan pencatatan GitHub Actions | | ⚫ Maksimum | Kasus-kasus berisiko tinggi melawan lawan yang memiliki dana besar | Server yang aman 24/7, alamat IP tersembunyi, serta seluruh 18 lapisan | Lapisan-lapisan: setiap catatan ditandatangani dan dirantai; tanda terima eksekusi yang ditandatangani; lampiran disimpan dengan SHA-256; titik pemeriksaan yang ditandatangani; pemeriksaan ulang; peringatan masalah; akses saksi hanya-baca; saksi yang memeriksa sesuai jadwal; cap waktu RFC 3161; bukti OpenTimestamps; cap waktu terbaru yang terverifikasi; salinan terenkripsi di luar lokasi; detail kasus dalam laporan; pemeriksaan kode kesesuaian; Telegram tidak pernah melihat IP mesin ini; permintaan dari luar melalui proxy; Object Lock pada salinan; server yang disegel dengan catatan penyedia. Lapisan yang dinonaktifkan memiliki opsi **"Set up**", yang membuka formulirnya. Memilih mode yang lebih rendah akan meminta konfirmasi dan tidak menghapus apa pun. ## Alat lainnya **Ekstra → Perekaman mandiri**: sambungkan browser terpisah atau perekam AyuGram, sematkan kunci penandatanganannya, pilih opsi perekaman, mulai/jeda, ambil tangkapan layar, dan unduh arsip yang telah diverifikasi dan ditandatangani. Setiap perekam memiliki login, rute, jurnal, dan kunci manualnya sendiri. Kedua koneksi tersebut awalnya dinonaktifkan. Lihat [panduan Perekaman Mandiri](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md) dalam bahasa Inggris. - **Tanyakan ke arsip**: cari pengamatan yang tersimpan, tinjau sumbernya, lalu putuskan apakah akan mengirimkannya ke model AI. Lihat [analisis arsip](https://phishdestroy.io/tgwitness/id/docs/reference/analysis/) serta [OCR dan transkripsi lokal](https://phishdestroy.io/tgwitness/id/docs/reference/media-analysis/). - **Parameter**: batasan dan kecepatan pengumpulan data, pemeriksaan ulang, unduhan, profil, pemberitahuan, dan ekspor. Cari berdasarkan nama, tampilkan nilai **Hanya yang berubah**, dan siapkan pengaturan default sebagai draf dengan **Pulihkan default…**. **Simpan parameter** menerapkan nilai-nilai tersebut mulai dari penggunaan berikutnya, dan setiap perubahan dicatat dalam jurnal. - **Akses**: token terpisah untuk peninjau, analis, dan operator, yang dibatasi pada ruang kerja, obrolan, dan hak akses tertentu. Lihat [bagian akses](https://phishdestroy.io/tgwitness/id/docs/reference/access/). - **Log sistem** : apa yang telah dilakukan proses ini sejak dimulai (koneksi, perubahan proxy, proses masuk, penolakan, perubahan pengaturan) dengan alamat IP disembunyikan. Fitur **“Ikuti Baris Baru”** menjaga baris terbaru tetap terlihat. Pesan hanya disimpan di jurnal. - **Integrasi**: penyedia AI, koneksi [MCP yang hanya dapat dibaca,](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/) dan [webhook yang ditandatangani](https://phishdestroy.io/tgwitness/id/docs/reference/webhooks/). - **Case Board**: catatan tim pribadi, bookmark, dan potongan di samping bukti. Lihat [Case Board](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/). - **Dokumentasi**: laci [mode investigasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md). Saat sesi yang didokumentasikan sedang merekam, sesi tersebut akan berpindah ke bilah samping utama. - **GitHub Actions menangkap data** dalam Ekspor: satu obrolan yang ditangkap dari fork Anda. Lihat [penangkapan yang disegel](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). --- # Telegram · Cara kerja pengumpulan data Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/collection/ Ruang lingkup pengamatan, pembaruan langsung, pemeriksaan ulang, lampiran, tindakan pengguna, dan arti dari "gap", per catatan. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Ruang lingkup pengamatan, pembaruan langsung, pemeriksaan ulang, lampiran, tindakan pengguna, dan arti dari "gap", per catatan. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Koleksi](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![Koleksi](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) TgWitness mencatat apa yang diamati oleh akun Telegram yang terhubung. Pemantauan langsung menyimpan pesan, suntingan yang terekam, pemberitahuan penghapusan, dan lampiran beserta waktu pengamatan serta konteks sumbernya. Riwayat pembacaan, pemeriksaan ulang, dan catatan log admin yang tersedia menambahkan pengamatan yang diidentifikasi secara terpisah ke catatan tersebut. **Di halaman ini** - [Dari login hingga jurnal](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#from-login-to-a-journal) - [Ruang lingkup pengamatan: obrolan yang dipilih, sebuah folder, atau seluruh akun](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account) - [Ruang lingkup dan pemilihan peristiwa](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#scope-and-event-selection) - [Tindakan sendiri](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#own-actions) - [Mode Investigasi: bergabung dengan tim dan berkomunikasi dengan bot](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots) - [Tingkat pemeriksaan ulang](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#recheck-tiers) - [Riwayat pesan dan atribusi](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#message-history-and-attribution) - [Cuplikan riwayat](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#history-snapshots) - [Penanganan lampiran](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#attachment-handling) - [Jeda, kunci, putuskan sambungan, dan mulai ulang](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#pause-lock-disconnect-and-restart) - [Isolasi dan verifikasi akun](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#account-isolation-and-verification) ## Dari proses login hingga jurnal Untuk foto dan berkas yang dapat menghancurkan diri sendiri, lihat [Media yang Dapat Menghancurkan Diri Sendiri](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md). Bagian ini menjelaskan pekerja prioritas, hasil yang tersimpan dan tidak tersedia, serta batasan pemblokiran tanda terima pembacaan di pengumpul API. Diagram alur · Otorisasi akun pengguna → Pilih grup dan saluran yang dapat diakses; Pilih grup dan saluran yang dapat diakses → Simpan pengaturan peristiwa dan lampiran; Simpan pengaturan peristiwa dan lampiran → Mulai pemantauan; Mulai pemantauan → Dapatkan pembaruan dari klien yang aktif; Dapatkan pembaruan dari klien yang aktif → Terapkan kebijakan sumber dan peristiwa; Terapkan kebijakan sumber dan peristiwa → Tambahkan pengamatan yang ditandatangani; Tambahkan pengamatan yang ditandatangani → Tinjau atau ekspor jurnal tersebut; Tambahkan pengamatan yang ditandatangani → Memproses lampiran yang ada dalam antrian; Memproses lampiran yang ada dalam antrian → Tambahkan hasil unduhan · Otorisasi akunpengguna · Pilih grup dan saluranyang dapat diakses · Simpan pengaturanperistiwa dan lampiran · Mulai pemantauan · Dapatkan pembaruandari klien yang aktif · Terapkan kebijakansumber dan peristiwa · Tambahkan pengamatanyang ditandatangani · Tinjau atau eksporjurnal tersebut · Memproses lampiranyang ada dalam antrian · Tambahkan hasilunduhan **Diagram dalam bentuk teks** 1. Otorisasi akun pengguna → Pilih grup dan saluran yang dapat diakses 2. Pilih grup dan saluran yang dapat diakses → Simpan pengaturan peristiwa dan lampiran 3. Simpan pengaturan peristiwa dan lampiran → Mulai pemantauan 4. Mulai pemantauan → Dapatkan pembaruan dari klien yang aktif 5. Dapatkan pembaruan dari klien yang aktif → Terapkan kebijakan sumber dan peristiwa 6. Terapkan kebijakan sumber dan peristiwa → Tambahkan pengamatan yang ditandatangani 7. Tambahkan pengamatan yang ditandatangani → Tinjau atau ekspor jurnal tersebut 8. Tambahkan pengamatan yang ditandatangani → Memproses lampiran yang ada dalam antrian 9. Memproses lampiran yang ada dalam antrian → Tambahkan hasil unduhan Otorisasi, akses ke sumber, pengumpul yang sedang berjalan, dan pengiriman lengkap adalah masalah yang berbeda. Login yang berhasil tidak memberikan akses ke setiap grup. Pengiriman dilacak secara terpisah: catatan cakupan, pemulihan celah pembaruan, dan pemeriksaan ulang menunjukkan apa yang telah diterima. ## Cakupan pemantauan: obrolan yang dipilih, sebuah folder, atau seluruh akun **Alat lainnya → Sumber → Ruang Lingkup** menentukan obrolan mana yang direkam oleh ruang kerja. Pengaturan baru dimulai dengan **opsi Pilih obrolan**. Pilihan yang sudah disimpan tetap dipertahankan. Jika memilih **Semua obrolan** dalam panduan pengaturan, sistem akan meminta konfirmasi jika daftar yang dimuat berisi lebih dari 50 obrolan; perkiraan ukuran tetap merupakan proses terpisah yang didasarkan pada sampel. | Mode | Merekam | Obrolan baru | | --- | --- | --- | | Obrolan yang dipilih (default) | Hanya obrolan yang Anda tambahkan secara manual | Tidak pernah ditambahkan secara otomatis | | Folder Telegram | Percakapan dalam salah satu folder akun: percakapan yang disertakan berdasarkan nama, ditambah kategori folder tersebut (kontak, bukan kontak, grup, saluran, bot), dikurangi percakapan yang dikecualikan, dan, jika folder tersebut mencantumkannya, percakapan yang diarsipkan | Obrolan yang sesuai akan ditambahkan segera setelah aktif; obrolan yang Anda tambahkan ke folder di Telegram akan terdeteksi dalam waktu satu jam | | Akun lengkap | Setiap obrolan yang dilihat oleh akun tersebut | Setiap obrolan baru, grup, obrolan pribadi, atau bot akan ditambahkan begitu pembaruan pertamanya tiba | - **Jenis sumber** (saluran, grup, obrolan pribadi, bot) membatasi mode folder dan mode seluruh akun. Obrolan yang dipilih dapat berupa jenis apa pun, termasuk obrolan pribadi dan bot; jenis sumber tidak akan pernah menghentikan obrolan yang Anda tambahkan secara manual. Jenis yang dinonaktifkan, pengecualian, atau peralihan ke obrolan yang dipilih akan menghentikan sumber yang ditambahkan secara otomatis segera setelah disimpan, sebelum daftar sumber dihitung ulang dan juga saat Telegram tidak dapat diakses: pesan baru mereka, riwayat yang telah berlalu, riwayat obrolan baru, pengaturan rekan, dan pengamatan profil. - **Obrolan yang Anda tambahkan secara manual** tetap terekam dalam mode folder dan mode seluruh akun, meskipun obrolan tersebut berada di luar folder; hanya *opsi Kecualikan*, *Hapus,* atau penundaan yang dapat menghentikannya. Obrolan yang ditambahkan secara *otomatis* mengikuti folder: obrolan yang keluar dari folder akan ditangguhkan pada perhitungan ulang berikutnya. - **Obrolan yang dikecualikan** tidak pernah direkam, dalam mode apa pun. Dalam mode folder dan seluruh akun, opsi *Kecualikan* dan *Hapus* pada sumber akan memasukkannya ke dalam daftar ini, sehingga sistem tidak akan menambahkannya lagi. Memilih obrolan tersebut kembali secara manual (di Sumber, dari Obrolan, atau di Pengaturan → **Obrolan mana?**) akan menghapusnya dari daftar. Daftar ini dapat menampung hingga 5.000 obrolan; jika melebihi batas tersebut, *perintah Hapus* akan ditolak dan obrolan tersebut dapat dijeda sebagai gantinya. - **Tindakan sendiri** (aktif secara default): pesan yang dikirim oleh akun ini, pengeditannya, dan penekanan tombol pada keyboard balasan. Jika dinonaktifkan, pesan keluar dan pengeditan akan dilewati. - Beralih ke sebuah folder atau seluruh akun akan meminta konfirmasi: mode-mode ini merekam obrolan pribadi dan pesan pihak ketiga, dan hanya boleh digunakan pada akun khusus. Konfirmasi dan setiap perubahan cakupan ditandai dengan catatan ``scope.changed``. Pada akun yang ditetapkan sebagai akun utama Anda, formulir cakupan dan fitur Investigasi menolak pemilihan folder atau seluruh akun, sama seperti saat memulai; hanya salinan satu kali tanpa perekaman yang dapat menggunakannya. - Obrolan yang ditambahkan oleh scope muncul sebagai sumber yang ditandai sebagai *auto*, direkam sebagai `scope.applied` (saat dimulai dan setiap jam) atau `source.discovered` (obrolan baru saat pemantauan berlangsung). Kembali ke obrolan yang dipilih akan menjeda semua sumber yang ditambahkan secara otomatis sekaligus, tanpa membaca daftar obrolan akun tersebut lagi. Obrolan yang dikecualikan akan berhenti direkam segera setelah ruang lingkup disimpan, dan sumbernya akan dihentikan sementara meskipun Telegram tidak mengembalikan daftar obrolan. Selama proses pemantauan, menyimpan ruang lingkup akan menerapkannya kembali, bahkan jika nilainya tidak berubah. Cakupan mode-mode ini: - **Obrolan Rahasia** menggunakan [integrasi Pseudo-secret](https://phishdestroy.io/tgwitness/id/docs/reference/secret-chats/) yang sudah disertakan, dengan modul protokol yang diinstal melalui panel dan tombol pengaktifan per akun. Riwayat cloud dan Takeout menggunakan jalur akuisisi terpisah. - **Periode offline.** Setelah dimulai ulang, TgWitness melanjutkan dari posisi pembaruan yang disimpan, meminta pembaruan yang terlewat dari Telegram, dan memeriksa ulang obrolan. Telegram menyimpan antrian yang dibatasi, sehingga setelah gangguan yang lama, laporan dan `verify.py` mencantumkan interval yang tersisa sebagai celah (lihat [cakupan](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)). - Hanya 1,000 percakapan pertama yang ditampilkan pada awalnya (batasnya ada di bagian **More tools → Parameters**); percakapan yang lebih lama ditambahkan saat kembali aktif. Riwayat awal dari percakapan yang ditambahkan tidak diambil — ambil snapshot riwayat atau ekspor percakapan lengkap saat Anda membutuhkannya. - Kondisi folder yang terus berubah (dibisukan, telah dibaca) tidak diterapkan: obrolan semacam itu tetap dipantau. - **Tombol bot inline (callback)** yang ditekan di aplikasi lain tidak terlihat oleh sesi kedua ; balasan atau pengeditan bot dicatat. Tekan tombol balasan pada keyboard tiba sebagai pesan keluar dan diberi label `button_press`. - Semakin banyak obrolan berarti semakin banyak permintaan. Telegram membatasi akun yang dianggap memiliki volume yang berlebihan, yang menjadi alasan tambahan untuk menggunakan akun khusus. ### Obrolan yang dipilih secara ketat **Ketat: Hanya obrolan yang dipilih yang** muncul di bawah **Obrolan yang Dipilih** dan secara default dalam keadaan nonaktif. Opsi ini dimaksudkan untuk izin yang hanya mencakup obrolan yang dipilih. Saat opsi ini diaktifkan: - Pemberitahuan layanan Telegram (777000) tidak terbaca: baik saat pengamatan dimulai maupun dihentikan, maupun setiap menit selama pengamatan berlangsung. Tidak ada catatan ``session.security_baseline`` atau ``account.security_event`` yang ditulis. - Daftar sesi akun tidak dibaca: baik saat pemantauan dimulai maupun dihentikan (pertanyaan panel mengenai sesi lain untuk **Bukti suatu kasus** dan mode perlindungan bukti juga dilewati), tidak setiap dua menit selama pemantauan, tidak saat koneksi dibuka, dan tidak oleh pemeriksaan koneksi, di mana *entri otorisasi*ditampilkan sebagai "dilewati". Status verifikasi dua langkah yang digunakan oleh pemeriksaan pengambilalihan juga tidak dibaca. Jadi, `account.sessions`, `session.concurrent_at_start`, dan `session.takeover_risk` tidak ditulis, dan sesi yang diakhiri dari perangkat lain tidak dilaporkan sebagai `session_revoked_externally`. - Meskipun ini adalah satu-satunya sesi pada akun tersebut (**Jadikan ini sebagai satu-satunya sesi** atau versi otomatisnya), daftar sesi tetap dibaca setiap dua menit selama pemantauan dan saat koneksi terbuka, sehingga ``session.exclusive_ended`` dicatat ketika sesi lain muncul. 777000 tetap tidak terbaca selama periode tersebut, meskipun catatan ``session.exclusive_from`` menunjukkan bahwa pemberitahuan masuk Telegram terus tercatat. - Pemberitahuan penghapusan hanya dibandingkan dengan pemeriksaan sesi jika pemeriksaan tersebut dijalankan dalam 10 menit terakhir (selama ini merupakan sesi satu-satunya, atau setelah membuka **Sesi akun ini**). Jika tidak, kecuali pemeriksaan hak akses terakhir menunjukkan bahwa akun ini tidak dapat menghapus pesan tersebut (hal ini tidak pernah terjadi dalam obrolan pribadi dan grup biasa), maka akan ditampilkan: *Tidak diketahui siapa yang menghapusnya: akun ini sendiri, dari sesi atau perangkat lain, juga mungkin telah menghapusnya.* - Dengan kunci sesi yang telah diimpor, tidak ada informasi dalam jurnal yang menunjukkan waktu masuk sesi ini hingga daftar sesi dibaca (misalnya di bagian **Sesi pada akun ini**). Sampai saat itu, ekspor obrolan dan ekspor akun **otomatis** akan menggunakan sesi reguler alih-alih Takeout, dengan alasan `session_age_unknown`. - Mengaktifkan obrolan tidak akan membaca pesan-pesan sebelumnya. Tanpa pengaturan ini, setiap obrolan yang diaktifkan (di bagian Sumber, di Obrolan, baik dengan bergabung dari panel maupun di wizard pengaturan) akan mendapatkan satu cuplikan pesan `baseline` dari pesan terbarunya, hingga batas yang ditentukan di**Alat Lainnya → Parameter → Cuplikan riwayat terbesar** (500 secara default), saat proses pengamatan berikutnya dijalankan. Cuplikan yang tertunda dan jatuh tempo saat tombol ini aktif akan diabaikan. Obrolan yang dimasuki dari panel juga tidak akan membaca pesan terbarunya sebagai obrolan baru (jumlah **Saat obrolan atau bot baru muncul**, 100 secara default), dan membuka obrolan yang dipilih tanpa pesan yang tersimpan di "Obrolan" tidak akan memuat 100 pesan terakhirnya secara otomatis. **Memuat riwayat** dan snapshot yang Anda mulai sendiri tetap akan menampilkan riwayat. - Pengaturan konten sensitif akun tersebut tidak dibaca maupun diubah. Tanpa tombol pengalih ini, proses masuk dan setiap koneksi baru akan mengaktifkannya jika sebelumnya dalam keadaan nonaktif, dan Telegram mengizinkan perubahan tersebut (`account.content_settings`); pengaturan tersebut merupakan bagian dari akun dan berlaku di setiap aplikasi Telegram. Konten yang ditandai sebagai sensitif oleh Telegram mungkin tetap tersembunyi. - Pembaruan panggilan telepon tidak dicatat sebagai ``account.phone_call``. - Fungsi "Stopping observation" hanya menulis sidik jari kunci sesi; fungsi ini tidak membaca daftar sesi atau 777000. Fitur ini tidak membatasi apa yang dikirimkan oleh Telegram: pembaruan dari setiap obrolan tetap masuk ke sesi ini, dan hanya obrolan yang dipilih yang direkam. Daftar obrolan akun (hingga **obrolan yang dibaca dari daftar akun**) dan foldernya tetap dibaca saat awal, dan sekali lagi saat cakupan disimpan selama pemantauan, untuk menemukan obrolan yang dipilih. Pemberitahuan penghapusan tanpa obrolan (`deletion.unscoped`) tetap direkam: pemberitahuan tersebut hanya berisi ID pesan dan mungkin berasal dari obrolan pribadi yang dipilih atau grup biasa. Pemeriksaan akun yang dibekukan (`help.getAppConfig`), pemeriksaan koneksi lainnya , dan fitur yang Anda aktifkan sendiri (mengakhiri sesi lain secara otomatis, probe saksi, obrolan pseudo-rahasia, **Sesi akun ini**, dan daftar perangkat yang masuk di Telegram di bawah **Lebih Banyak saksi**, yang membaca daftar sesi pada setiap lewatnya penanda waktu dan yang menandai pengaturan untuk tujuan **Ikuti obrolan** dan **Bukti untuk kasus**) tetap berfungsi. Aktifkan fitur ini sebelum masuk; jika tidak, proses masuk itu sendiri akan memeriksa otorisasi saat ini dan mengaktifkan konten sensitif. Setiap perubahan berupa catatan `scope.changed` yang telah ditandatangani, dan `observation.started` menyimpan nilai tersebut sebagai `scope.strict`. Beralih ke folder atau ke seluruh akun akan menonaktifkan fitur ini. ## Ruang lingkup dan pemilihan peristiwa Setiap ruang kerja memiliki sumbernya sendiri. TgWitness tidak bergabung dengan grup, menerima undangan, atau menghitung setiap anggota secara otomatis. Sumber harus sudah dapat diakses oleh akun tersebut. Saat dimulai, pengumpul memeriksa sumber yang dipilih terhadap dialog yang terlihat di akun; 1,000 dialog pertama diperiksa kecuali **Alat Lainnya → Parameter → Obrolan yang dibaca dari daftar akun** menyatakan sebaliknya. Sumber yang tidak ada ditandai sebagai **akses belum dikonfirmasi**, bukan dianggap telah menghapus Anda. | Pengaturan | Mengumpulkan | Dampak jika dinonaktifkan | | --- | --- | --- | | Pesan baru | Pesan yang dikirim secara biasa | Pengeditan atau penghapusan yang dilakukan kemudian mungkin tidak memiliki teks yang terekam sebelumnya untuk dibandingkan. | | Pengeditan | Menyajikan versi pesan yang telah diedit | Perubahan yang terjadi di antara proses tersebut tidak direkonstruksi kemudian. | | Penghapusan | Pemberitahuan penghapusan yang terbatas cakupannya dan pemberitahuan tingkat akun yang tidak terbatas cakupannya | Pemberitahuan penghapusan tidak ditambahkan ke jurnal. | | Reaksi | Cuplikan reaksi yang ditampilkan | Pembaruan reaksi terpisah tidak ditambahkan. | | Keanggotaan | Penyampaian pesan layanan keanggotaan dan pembaruan bagi peserta | Pengamatan keanggotaan tersebut tidak ditambahkan. | Pengaturan berlaku untuk semua sumber yang dipilih di ruang kerja. Simpan formulir untuk menerapkan perubahan; perubahan dicatat dengan nilai sebelum/sesudah yang ditandatangani. Menonaktifkan suatu kategori tidak akan menghapus catatan sebelumnya. Mengaktifkannya kembali tidak akan mengisi kembali pembaruan yang terlewat. Catatan operasional dan peristiwa layanan grup lainnya tetap terpisah dari pengaturan ini. Pesan layanan keanggotaan dapat membuat catatan pesan saat fitur keanggotaan diaktifkan, meskipun penangkapan pesan baru biasa dinonaktifkan. Objek Telegram yang ditangkap tetap mempertahankan metadata yang tertanam; pengaturan ini bukanlah aturan penyuntingan. **Penghapusan dalam obrolan pribadi dan grup biasa** tiba sebagai ID pesan tanpa obrolan. Obrolan-obrolan ini berbagi satu urutan ID pesan untuk seluruh akun, sehingga ketika pesan dengan ID tersebut telah disimpan sebelumnya, obrolannya diketahui: penghapusan dicatat dalam obrolan tersebut dengan `chat_resolution` yang menjelaskan caranya. ID yang tidak pernah disimpan tetap menjadi **penghapusan tanpa lingkup** dengan obrolan yang belum terpecahkan secara eksplisit. Ini adalah pemberitahuan penghapusan Telegram, yang dipertahankan bahkan ketika obrolannya belum dapat dikorelasikan. Skema pemberitahuan berisi ID; jurnal menambahkan waktu penerimaan dan konteks pesan yang disimpan, termasuk `deleted_message_was_outgoing`. Entri log admin yang tersedia menyediakan sumber terpisah untuk tindakan, pelaku, dan waktu sumber. ## Tindakan sendiri Pesan yang dikirim oleh akun yang diamati diberi label `outgoing`. Pengeditan pesan keluar mencatat bahwa dalam obrolan pribadi dan grup, hanya penulisnya yang dapat mengeditnya, sedangkan posting saluran dapat diedit oleh admin lain. Ketika sebuah pesan keluar mengulang teks tombol dari papan ketik balasan terbaru yang disimpan dalam obrolan tersebut, pesan tersebut diberi label `button_press` dengan tautan ke catatan papan ketik tersebut. Pengecualian terhadap tindakan pengguna sendiri juga berlaku untuk pemeriksaan ulang latar belakang dan riwayat obrolan baru otomatis. Pesan keluar yang dilewati akan memajukan posisi pemeriksaan ulang sehingga tidak dapat menghalangi pesan masuk selanjutnya. Tindakan panel yang eksplisit dan cuplikan riwayat yang diminta secara manual tetap terekam. ## Mode investigasi: bergabung dengan tim dan berkomunikasi dengan bot **Alat lainnya → Sumber → Cakupan → Mode investigasi** menyiapkan cakupan untuk akun khusus yang bergabung dengan obrolan tim, memulai bot, dan menulis ke dalamnya: seluruh akun, setiap jenis sumber, tindakan sendiri, serta untuk setiap obrolan atau bot yang muncul, profilnya dan 200 pesan terbaru yang terlihat. Periksa formulir dan tekan **Simpan cakupan**; peralihan ke seluruh akun akan meminta konfirmasi seperti biasa. - **Tombol.** Tombol di bawah pesan tetap menyertai pesan tersebut dan ditampilkan di **Obrolan**: tautan, aplikasi web , tautan masuk, teks untuk disalin, data panggilan balik, kueri sebaris, permintaan nomor telepon atau lokasi. Tautan ditampilkan sebagai teks dan tidak pernah dibuka oleh panel. Ketika bot hanya mengubah tombol-tombol tersebut (tautan pembayaran baru), hal itu dianggap sebagai versi baru dari pesan tersebut, baik dari pembaruan langsung maupun dari pemeriksaan ulang. - **Obrolan dan bot baru.** Dalam mode folder dan akun keseluruhan, **ketika obrolan atau bot baru muncul**, data akan disimpan segera setelah muncul: - profilnya sebagai catatan `source.profile`: deskripsi bot dan perintah, teks "Tentang" dari pengguna, grup, atau saluran, anggota, obrolan yang tertaut, dan tautan undangan jika Telegram menyediakannya; - pesan-pesan terbarunya yang terlihat (hingga 1.000) sebagai cuplikan riwayat yang ditandai dengan `new_chat`: pesan-pesan sebelumnya dari obrolan tim yang baru saja bergabung, atau apa yang dikatakan bot sebelum pengamatan memperhatikan obrolan tersebut. Pesan yang sudah disimpan secara langsung tidak diulang. Obrolan yang baru dipilih akan menggunakan pengaturan ini saat cakupan diterapkan, termasuk obrolan yang sudah ada dalam daftar dialog akun. Pemuatan awal profil dan riwayat dilakukan secara bersamaan untuk maksimal tiga obrolan; proses untuk obrolan yang sama tetap berjalan sesuai urutan. Setiap tahap riwayat/profil menggunakan batas waktu operasi yang telah dikonfigurasi, sehingga permintaan yang terhenti akan melepaskan pekerja yang mengolahnya. Riwayat disimpan sebelum pembacaan profil opsional; kegagalan profil tidak menghalangi pencatatan riwayat tersebut. Tahap yang gagal akan dicoba ulang setelah 5 detik, dengan waktu tunggu yang berlipat ganda hingga maksimum 5 menit tanpa menggunakan pekerja selama penundaan tersebut. ID yang tertunda, batas waktu percobaan ulang, dan tahap yang telah selesai disimpan secara lokal. Restart hanya melanjutkan tahap yang belum selesai; percobaan ulang profil tidak mengulangi pembacaan riwayat yang telah selesai. Sumber yang dinonaktifkan sebelum gilirannya akan dilewati. Ikhtisar menampilkan pemuatan obrolan yang aktif, tertunda, dan sedang dicoba ulang secara terpisah dari unduhan lampiran. FloodWait menghentikan sementara pekerjaan ini dan dilanjutkan setelahnya; kegagalan dicatat dan perekaman obrolan secara langsung berlanjut. Ini mencakup masa tunggu saat menyelesaikan identitas obrolan baru: tugas profil/riwayat yang tertunda dipertahankan untuk dicoba ulang, dan masa tunggu yang lebih lama di seluruh akun tidak dipersingkat. Pekerja berbagi masa tunggu ini; konkurensi tidak melewati batas permintaan Telegram. - **Profil berdasarkan permintaan.** **Obrolan → Profil → Simpan profil kini** menyimpan profil terkini dari sumber mana pun; profil terbaru ditampilkan di atas pesan. - **Cuplikan status obrolan (pratinjau).** Status di luar aliran pesan berubah tanpa pesan: melepas penandaan setiap pesan tidak meninggalkan jejak di tingkat pesan, seorang administrator kehilangan haknya, hadiah disembunyikan, dikonversi, ditingkatkan, atau dikembalikan. Selama pemantauan, setiap sumber yang diaktifkan dibaca secara berkala dan disimpan sebagai `chat.state` : judul, nama pengguna, deskripsi, jumlah anggota dan administrator, obrolan yang ditautkan, mode lambat, ID pesan yang disematkan (hingga 100), administrator beserta hak akses dan gelarnya, serta hadiah yang ditampilkan di saluran dan profil pengguna (hingga 100). Setiap catatan mencantumkan perbedaan dari snapshot sebelumnya: bidang yang berubah beserta kondisi sebelum dan sesudahnya, pesan yang disematkan yang ditambahkan atau dihapus, serta administrator dan hadiah yang ditambahkan, diubah, atau tidak lagi terdaftar. - Bagian yang ditolak oleh Telegram (misalnya daftar administrator saluran untuk seorang anggota yang bukan administrator) disebutkan dalam `errors`; nilai sebelumnya tetap disimpan dan tercantum dalam `carried_forward`, tidak pernah dilaporkan sebagai dihapus. - Catatan yang perubahannya hanya berupa jumlah, serta pemeriksaan yang tidak menemukan perubahan, merujuk pada keadaan lengkap terakhir dengan `state_seq` dan kumulatif `state_overrides`. Status lengkap ditulis setidaknya setiap tujuh hari dan setiap kali ada perubahan selain jumlah. - `parts_complete` menandai daftar yang dibatasi. Penambahan memerlukan daftar sebelumnya yang lengkap, penghapusan memerlukan daftar saat ini yang lengkap, dan nilai kosong yang eksplisit menandai pembersihan catatan. - **Alat Lainnya → Parameter → Status Obrolan** mengatur interval (12 jam secara default, 0 menonaktifkan snapshot), jeda antar sumber, bagian mana yang dibaca, dan apakah pemeriksaan yang tidak menemukan perubahan dicatat. `FLOOD_WAIT` dan `FLOOD_PREMIUM_WAIT` menghentikan sisa permintaan snapshot, mempertahankan batas waktu akun yang lebih lama, dan membiarkan obrolan yang terputus memenuhi syarat untuk dicoba lagi setelah masa tunggu tersebut. - **Tidak terlihat.** Tombol inline (callback) yang ditekan di aplikasi Telegram lain, popup atau tautan yang digunakan bot sebagai respons atas penekanan tersebut, serta tautan undangan yang digunakan di aplikasi lain tidak sampai ke TgWitness. Apa yang dikirim atau diedit oleh bot setelahnya akan dicatat. ### Tindakan dari panel **Obrolan** kini mencakup klien mini yang menggunakan akun Telegram dari ruang kerja yang dipilih: - Tulis pesan teks biasa atau pilih **"Balas"** di bawah pesan yang telah disimpan. Pesan keluar yang dikirimkan akan terekam meskipun cakupan pengaturan tidak mencakup pembaruan pesan keluar. - Tekan **tombol "Press"** di bawah tombol callback atau teks yang sedang aktif. Server akan mengambil pesan tersebut kembali dan menolak tindakan tersebut jika teks yang dimasukkan berbeda dari versi yang tersimpan. Tanda terima callback mempertahankan teks popup Telegram, bendera peringatan, dan URL; jawabannya juga ditampilkan di bawah percakapan. URL tetap berupa teks yang dapat dipilih dan tidak dibuka secara otomatis. - Tekan **+** → **Buka tautan Telegram**, masukkan `@username`, tautan publik `https://t.me/name`, `https://t.me/+invite` / `joinchat/invite`, atau tautan bot dengan `?start=parameter`, lalu tekan **Simpan pratinjau**. Tautan asli dan pratinjau Telegram akan ditandatangani sebelum bergabung. **Bergabung / buka dan amati**, kemudian bergabung dengan grup/saluran atau membuka pengguna/bot, tambahkan obrolan sebagai sumber yang diaktifkan, dan kirimkan `/start` ke bot, termasuk parameter awalnya. Permintaan bergabung yang menunggu persetujuan administrator dicatat sebagai tertunda, bukan sebagai keanggotaan. Aktifkan **Mulai pengamatan** untuk merekam balasan yang masuk secara langsung. Tindakan panel berfungsi saat pengamatan dijeda; panel kemudian menyimpan respons langsungnya, dan pengamatan langsung merekam sisa percakapan. Sumber yang baru ditambahkan menggunakan profil/riwayat yang telah dikonfigurasi saat pengamatan sedang berjalan. Saat sumber dijeda, aktifkan sumber tersebut di **Alat Lainnya → Sumber** sebelum mengirim atau menekan tombolnya. `interaction.preview`, `interaction.requested`, dan `interaction.result` adalah peristiwa jurnal bertanda tangan biasa yang disertakan dalam ekspor bukti. Permintaan mengidentifikasi akun, pesan/tombol atau catatan pratinjau, serta apakah pengamatan sedang berjalan. Tanda terima membedakan antara keberhasilan, penolakan, persetujuan tertunda, dan hasil yang tidak diketahui. Permintaan yang terputus mungkin telah sampai ke Telegram: periksa obrolan sebelum memulai tindakan baru. Menggunakan kembali ID permintaan akan mengambil tanda terima yang tersimpan tanpa mengulangi tindakan, termasuk setelah restart. Panel mempertahankan ID tersebut setelah respons ambigu untuk tindakan yang sama selama sesi halaman saat ini. Panel juga mempertahankan ID tersebut ketika penyegaran tampilan gagal setelah tindakan berhasil: tanda terima tetap terlihat, dan mengklik lagi akan mengambilnya kembali. RPC callback dan join memiliki satu upaya aplikasi; pembacaan yang dapat dicoba ulang mempertahankan kebijakan percobaan ulang yang telah dikonfigurasi. Beralih obrolan secara langsung akan menghapus draf dan target balasan serta menonaktifkan pengiriman hingga percakapan baru dimuat. Mini-klien ini menangani teks dan tombol callback. Tombol aplikasi mini menampilkan opsi **Buka aplikasi mini**, yang menjalankan aplikasi tersebut di browser terisolasi ([Aplikasi mini](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)). Permintaan login, nomor telepon, dan lokasi, pembayaran, kueri inline, serta lampiran tetap memerlukan klien Telegram; metadata tombol yang telah disimpan tetap terlihat. Kontrol baru ini menggunakan teks dalam bahasa Inggris. ## Tingkat verifikasi ulang Pemeriksaan ulang meminta Telegram kembali untuk pesan yang terlewat, suntingan, dan pesan yang tidak lagi dikembalikan. Sumber yang ditandai dengan bintang adalah sumber **prioritas**, diperiksa ulang setiap 15 menit secara default; semua sumber lainnya setiap 6 jam. Obrolan yang dipilih dimulai sebagai sumber prioritas, sedangkan obrolan yang ditambahkan melalui folder atau seluruh akun sebagai sumber biasa. Paling banyak 30 sumber diperiksa ulang per putaran dan sisanya menunggu hingga menit berikutnya; setelah koneksi terhubung kembali, sumber prioritas diproses terlebih dahulu. Kedua interval tersebut diatur di bawah **More tools → Sources → Recording → Recheck** (0 menonaktifkan tingkatan) dan dicatat sebagai `recheck.changed`. Pesan yang terlewat diambil mulai dari titik di mana proses sebelumnya berhenti, dengan batas maksimal yang ditentukan di **More tools → Parameters → Missed messages recovered per chat and pass** (secara default 1,000). Setelah jeda yang lama, proses pemeriksaan ulang akan mengisi seluruh celah tersebut, bahkan jika pesan langsung yang lebih baru daripada celah tersebut telah disimpan terlebih dahulu. Obrolan yang masih dalam proses mengejar ketinggalan akan diperiksa ulang pada menit berikutnya alih-alih menunggu interval tier-nya; `recheck.completed` menampilkan `continues_after` hingga proses selesai. Perbandingan mencakup teks pesan, entitas, papan ketik (termasuk penghapusan), serta konten/identitas lampiran. Mengubah hash akses berkas atau referensi berkas saja tidak dianggap sebagai pengeditan, begitu pula hal-hal yang diisi secara otomatis oleh Telegram: pemuatan pratinjau tautan, tampilan cerita, media berbayar yang dibuka oleh akun ini, serta tanda terima faktur. Setiap versi yang disimpan di Obrolan tertaut ke catatan jurnal lengkapnya, termasuk metadata media. ## Riwayat pesan dan atribusi Misalkan pengumpul mengamati “Pertemuan pukul 10:00,” kemudian melihat “Pertemuan pukul 11:00,” dan kemudian menerima pemberitahuan penghapusan. Alat ini menambahkan tiga catatan terpisah. Teks asli tetap ada, suntingan menjadi versi terpisah, dan pemberitahuan tersebut mencatat bahwa telah terdeteksi adanya penghapusan. Jika pengumpulan dimulai setelah versi pertama menghilang, teks tersebut tidak tersedia. Jika terjadi beberapa pengeditan saat proses dalam keadaan offline, hanya versi yang diamati setelahnya yang dapat disimpan. Pemberitahuan penghapusan tidak dapat memulihkan konten yang tidak pernah terekam. Catatan tersebut menggabungkan beberapa sumber: | Sumber | Informasi yang dipertahankan | | --- | --- | | Pesan langsung atau pembaruan suntingan | ID pesan, metadata pengirim, versi yang direkam, waktu penerimaan, serta tanggal pesan/pengeditan Telegram yang disediakan. | | Pemberitahuan penghapusan secara langsung | ID pesan yang dilaporkan, waktu penerimaan, notifikasi mentah, dan tautan ke konten yang telah disimpan sebelumnya. | | Log admin yang tersedia | Tindakan, pelaku, tanggal sumber, dan isi pesan yang disediakan, dibaca oleh akun dengan hak akses yang diperlukan. | | Interaksi panel | Tindakan yang diminta dan hasilnya yang tercatat di bawah akun yang dipilih. | | Periksa ulang | Respons Telegram saat ini dibandingkan dengan pesan yang disimpan sebelumnya. | `observed_at` adalah waktu ketika catatan tersebut ditulis pada jam kolektor dan bertambah seiring dengan `seq`. Catatan yang ditulis saat menangani pembaruan langsung juga menyertakan `received_at`, yaitu waktu ketika pembaruan tersebut sampai di pengumpul, dan `processing_delay_ms`, waktu dari penerimaan hingga penulisan; pembaruan yang ditahan saat pengamatan dimulai diproses sesuai urutan kedatangan sebelum yang lebih baru. `source_at` menyimpan tanggal sumber jika peristiwa tersebut menyertakannya. Pengamatan offset jam telegram, catatan diskontinuitas jam, dan [pemeriksaan waktu eksternal](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/) menyediakan konteks waktu yang terkait. Bidang-bidang dalam pemberitahuan pesan biasa mendeskripsikan pemberitahuan tersebut; catatan log admin dan interaksi menyimpan atribusi masing-masing. ## Cuplikan riwayat Snapshot meminta pesan-pesan terbaru yang terlihat dari sumber yang diaktifkan, hingga 500 pesan per permintaan. Hasilnya diberi label sebagai pengamatan riwayat. Snapshot manual dijalankan bersamaan dengan pengamatan. Pengamatan yang berulang disimpan sebagai catatan terpisah. Mengaktifkan suatu sumber juga akan mengambil satu snapshot `baseline`-nya, kecuali opsi [obrolan terpilih secara ketat](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#strict-chosen-chats) diaktifkan. Pembuatan snapshot akan dihentikan jika sumber dinonaktifkan selama proses pembacaan. Balasan harus berasal dari obrolan yang diminta dan berisi ID pesan positif yang secara ketat menurun di bawah batas yang diminta. Balasan yang tidak valid akan menghentikan proses pembuatan snapshot sebelum pesan tersebut disimpan; pesan yang telah disimpan tetap berada di jurnal yang ditandatangani bersama dengan catatan penghentian tersebut. Cuplikan mengikuti kebijakan lampiran tetapi tetap terpisah dari peralihan peristiwa langsung. Cuplikan tersebut tidak merekonstruksi pesan yang dihapus atau versi perantara yang terlewat. Anda dapat meminta cuplikan saat proses dijeda; lampiran apa pun yang masuk ke antrian akan menunggu hingga pengamatan dimulai dan proses pengunduhan berjalan. Proses **Riwayat** adalah tugas eksklusif tersendiri: membaca sumber terpilih dan mengunduh antrean lampirannya secara berurutan tanpa memulai pemantauan. Jeda membebaskan akun; melanjutkan meneruskan proses yang disimpan. Untuk filter tanggal, bahasa, dan balasan pada beberapa akun menganggur, lihat [Ekspor percakapan terdistribusi](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md). ## Penanganan lampiran Pengunduhan lampiran diaktifkan secara default dan akan dihentikan sementara jika ruang disk kosong kurang dari 1 GiB. Pengumpul melakukan pengamatan pesan dan tugas pengunduhan secara bersamaan. Tugas tersebut mempertahankan deskriptor media asli dan kebijakan ukuran, sehingga lampiran yang diedit kemudian tidak akan diganti tanpa pemberitahuan. Proses unduhan dijalankan setelah penangkapan pesan. Unduhan yang selesai akan membuat catatan `media.saved` beserta SHA-256 dan jumlah byte-nya. Proses yang dilewati, gagal, dicoba ulang, dan terputus memiliki hasil yang terpisah; sebuah berkas dianggap tersimpan jika catatan `media.saved` -nya ada. Berkas yang telah selesai juga harus sesuai dengan jumlah byte dalam deskriptor lampiran asli yang diamati. Respons yang pendek atau lebih panjang dari yang diharapkan tidak dicatat sebagai media yang tersimpan. File dan entri foldernya disimpan ke disk sebelum ``media.saved`` ditulis. Ketika proses pengumpul sebelumnya berakhir tanpa penghentian yang teratur, proses berikutnya akan membaca setiap file yang tercatat sebagai tersimpan selama proses tersebut. File yang hilang atau byte-nya berbeda dari SHA-256 yang tercatat akan diberi catatan ``media.missing_after_restart``, pengunduhannya dimasukkan ke antrian lagi, dan byte yang berbeda dipindahkan ke folder ``media-damaged/``. File yang dipindahkan ke penyimpanan di luar lokasi tidak dibaca. Dalam satu ruang kerja, pekerjaan yang mengantri secara bersamaan untuk representasi lampiran yang sama menunggu proses transfer yang sedang berlangsung, lalu memeriksa kembali byte yang telah disimpan sebelum digunakan kembali. Setiap pekerjaan menyimpan hasil bertanda (signed) miliknya sendiri serta referensi ke catatan file yang disimpan sebelumnya. Membatalkan pekerjaan yang sedang menunggu tidak akan membatalkan proses transfer yang sedang berlangsung; jika transfer tersebut gagal atau dibatalkan, pekerjaan berikutnya dapat mencoba lagi. Lampiran yang berbeda dapat diunduh secara bersamaan. Pekerjaan dengan akun, representasi, ukuran yang diharapkan, dan tindakan penangkapan yang sama akan tetap terdapat dalam antrian selama satu pekerjaan yang cocok sedang berjalan. Pekerjaan-pekerjaan tersebut tidak menempati slot unduhan, sehingga file lain dapat dimulai meskipun antrian diawali dengan banyak salinan dari satu file yang lambat. Penyelesaian suatu upaya akan mengaktifkan kembali antrian. Jalur prioritas, penundaan percobaan ulang yang disimpan, dan riwayat kepemilikan tetap berlaku; setiap pengamatan akan mendapatkan hasilnya masing-masing. Ekspor obrolan juga menerapkan transfer aktif untuk representasi berkas yang berulang di dalam direktori ekspor yang sama. Setiap pesan mempertahankan referensi lampirannya, dan penggunaan ulang memerlukan pemeriksaan ukuran dan SHA-256 yang baru. Berkas-berkas yang berbeda dapat diperiksa secara paralel tanpa mengunci transfer bersama. Jalur unduhan dan penyalinan sementara bersifat unik untuk setiap operasi; pembatalan akan menunggu hingga semua pembaca berkas lokal yang aktif selesai sebelum melakukan pembersihan. Indeks berkas ekspor hanya menserialisasikan akses metadata, bukan proses hashing berkas atau unduhan. Pembacaan hash server untuk lampiran yang berbeda juga berjalan secara bersamaan, berbagi tiga slot permintaan file klien dengan pengunduhan byte. Pembacaan berulang terhadap representasi yang sama hanya memanfaatkan kembali hasil cache yang sudah lengkap. Pembacaan file tidak membebani antrian permintaan biasa; batas waktu FloodWait yang tersimpan diperiksa kembali saat sebuah permintaan mendapatkan slot. Batas disetel **per jenis**: foto, video, GIF dan animasi, pesan video bulat, pesan suara, musik dan audio, stiker, serta file. Setiap jenis dapat dinonaktifkan dan memiliki batas ukuran tersendiri mulai dari 1 hingga 2.000 MiB; ruang kerja baru dimulai dengan 20 MiB untuk foto, 100 MiB untuk video, 50 MiB untuk file, audio, dan video bulat, 20 MiB untuk pesan suara dan GIF, serta 5 MiB untuk stiker. Ruang kerja baru menonaktifkan GIF dan stiker hingga diaktifkan. Ruang kerja dengan kebijakan yang disimpan sebelum batasan per jenis akan mengaktifkan semua jenis dan mempertahankan batasan tunggal untuk setiap jenis. *Ukuran file maksimum* menentukan semua jenis sekaligus. Jenis yang dinonaktifkan menghasilkan catatan `media.skipped`; file dengan ukuran tidak diketahui atau berukuran melebihi batas tidak akan diunduh. File besar mendapatkan waktu unduh tambahan berdasarkan ukurannya dan kecepatan dasar 256 KiB/s. Tugas tetap ada setelah restart, tetapi referensi yang kedaluwarsa, akses yang hilang, atau file yang dihapus tetap dapat menghalangi pemulihan. Pekerjaan yang sedang menunggu mempertahankan batas yang tersimpan bersamanya, sehingga peningkatan batas hanya berlaku untuk file baru. Menonaktifkan suatu jenis atau menurunkan batasnya juga akan melewatkan file-file yang sedang menunggu yang dikecualikan, masing-masing dengan catatan `media.skipped`; menonaktifkan unduhan akan menjeda antrian hingga diaktifkan kembali. ## Jeda, kunci, putuskan sambungan, dan mulai ulang | Tindakan atau kondisi | Efek | | --- | --- | | Beralih ke ruang kerja | Mengubah tampilan panel; pengumpul lainnya tetap mempertahankan statusnya. | | Kunci panel atau tutup tab | Membiarkan server dan pemantauan tetap berjalan. | | Jeda pengamatan | Menghentikan pengumpul tersebut dan mempertahankan pekerjaan lampiran yang sedang dalam antrian. | | Nonaktifkan sumber | Menghentikan penangkapan berkala di masa mendatang; tugas media yang sedang dalam antrian akan ditunda selama fitur ini dinonaktifkan. | | Hapus sumber | Mencatatnya sebagai sumber dan menghapus profil penggunanya; catatan yang sudah disimpan tetap berada di jurnal yang hanya dapat ditambahkan. Lampiran yang masih menunggu dicatat sebagai gagal (`source_removed`). Dalam mode folder dan akun keseluruhan, hal ini juga dikecualikan. | | Ubah rute koneksi | Membutuhkan jeda, menutup klien lama, dan membatalkan proses login yang belum selesai. | | Hentikan proses Python | Menghentikan semua ruang kerja; tidak ada pengamatan yang dilakukan saat alat ini dalam keadaan offline. | | Mulai ulang setelah pengamatan aktif | Upaya untuk melanjutkan cakupan yang disimpan menggunakan sesi yang disimpan. Penundaan manual akan menghapus niat tersebut. | Pengumpul mencatat pemutusan koneksi yang terdeteksi, upaya ulang, kesalahan, mulai/berhenti, dan detak jantung. Gangguan singkat dapat terlewatkan oleh pemeriksaan konektivitas berkala. Setelah dimulai ulang, pembaruan yang terlewat diminta dari posisi pembaruan yang disimpan dan obrolan yang diamati diperiksa ulang secara berkala; lihat [format bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#durable-collection-and-process-receipts-02). Sebuah snapshot menambahkan keadaan saat ini sebagai konteks, dan selisih waktu tetap tercatat. ## Isolasi dan verifikasi akun Setiap ruang kerja memiliki jurnal, otorisasi, kunci penandatanganan, kebijakan, dan antrian tersendiri. Hanya klien yang aktif yang dapat menyumbangkan pengamatan secara langsung. Klien yang ditolak, dalam antrian, digantikan, dan sedang melakukan uji koneksi tidak dapat menulis pembaruan langsung ke dalam jurnalnya. Akun yang berbeda dapat mengamati grup yang sama, tetapi jurnal masing-masing tetap terpisah. Setiap peristiwa mencakup hash sebelumnya dan tanda tangan Ed25519. Ekspor mencakup seluruh jurnal ruang kerja melalui nomor urut tetap. Filter panel tidak menyaring ekspor; pengumpulan data mungkin berlanjut melampaui batasnya saat ekspor sedang disiapkan. **Jurnal verifikasi** memeriksa rantai peristiwa dan tanda tangan melalui batas yang ditampilkan. Hasilnya akan dihapus saat ruang kerja berubah, dan panel akan mengidentifikasi catatan baru yang ditambahkan setelah pemeriksaan. Ekspor ZIP juga memverifikasi media yang dikumpulkan. Pertahankan sidik jari dan titik pemeriksaan secara terpisah. Lihat [ruang lingkup verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope) untuk pemeriksaan akuisisi di setiap mode, dan [operasi harian](https://phishdestroy.io/tgwitness/id/docs/reference/operations/) untuk pengumpulan rutin. --- # Telegram · Obrolan Rahasia: penyiapan dan perekaman Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/secret-chats/ Pasang ekstra protokol Obrolan Rahasia, aktifkan per akun, dan rekam obrolan yang dibuat atau diterima TgWitness. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Pasang ekstra protokol Obrolan Rahasia, aktifkan per akun, dan rekam obrolan yang dibuat atau diterima TgWitness. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) Aplikasi yang telah dipublikasikan mencakup backend Secret Chat, integrasi kolektor, rute API, dan antarmuka **Pseudo-secret**. Pustaka protokol merupakan modul terpisah: buka **Pseudo-secret**, lalu tekan **Instal dan aktifkan**. Fitur penerimaan otomatis pesan masuk akan tetap nonaktif sampai Anda mengaktifkannya. ## Modul protokol | | | | --- | --- | | Modul | `kiaro-telethon-secret-chat` 0.2.0 | | Penulis | KiaroSama | | Lisensi | GPL-3.0-atau-yang-lebih-baru; lisensinya `LICENSE` dan `NOTICE` tetap berada di dalam arsip yang disimpan | | Sumber | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) pada commit `d87bf037b90060383c7b704d8a06ebb98c621c6f` | | Periksa | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` pada daftar berkas paket dan nilai SHA-256 masing-masing | Fitur **Instal dan Aktifkan** tersedia bagi administrator utama. TgWitness mengunduh arsip sumber dari commit tersebut dari GitHub melalui jalur workspace untuk permintaan di luar Telegram, membandingkan setiap berkas dalam paket tersebut dengan nilai yang ditetapkan dalam rilis TgWitness, menyimpan arsip tersebut sebagai `modules/telethon-secret-chat-.zip` di direktori data, dan memuat kode tersebut dari memori. Tidak diperlukan restart. Pemeriksaan ini berjalan lagi setiap kali aplikasi dimulai; arsip yang berbeda tidak akan dimuat dan halaman akan menampilkannya. File paket yang berubah, hilang, atau ditambahkan akan gagal dalam pemeriksaan. Modul ini merupakan karya terpisah yang memiliki lisensi sendiri. TgWitness tidak menyertakannya: setiap instalasi mengunduhnya dari repositori pembuatnya. **Rincian** pada halaman tersebut menampilkan modul yang dimuat, pembuatnya, lisensi, commit, dan SHA-256. Seorang pengelola yang tidak memiliki akses ke GitHub dapat menginstal commit yang sama ke dalam lingkungan Python; panel tersebut kemudian akan menggunakan salinan tersebut: ``` python -m pip install ".[secret-chats]" ``` TgWitness menjadi titik akhir (endpoint) untuk obrolan yang dibuat atau diterimanya. Layanan ini mencatat pesan, lampiran yang tersedia, perubahan pengatur waktu, dan pemberitahuan penghapusan dalam jurnal yang ditandatangani. Konten yang telah disimpan sebelumnya tetap tersedia setelah adanya pemberitahuan penghapusan di kemudian hari. ## Ketersediaan paket Pada tanggal 8 November 2026 , paket penginstal yang diterbitkan telah diverifikasi pada sumber [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) , rilis `b35f8e18f3d1-1ff85ec98bb2` , versi 0.9.1 pratinjau. [Wheel yang tidak dapat diubah](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) dan kunci ketergantungannya telah lulus verifikasi tanda tangan rilis SHA-256 dan RSA. Backend dan antarmuka yang dikemas sesuai dengan revisi sumber tersebut byte demi byte. Paket tersebut juga berisi pendaftaran API dan hook pengumpul. Paket tersebut tidak berisi pustaka protokol, dan pustaka tersebut tidak tercantum dalam lock dependensi. Bagian `secret-chats` bagian "extra" dalam [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) mengunci komit yang sama seperti tombol panel. Pemeriksaan paket ini menentukan file dan deklarasi dependensi mana yang disertakan. [Catatan validasi](https://phishdestroy.io/tgwitness/id/docs/reference/verification/) mengidentifikasi pemeriksaan runtime yang terpisah. Panduan tanggal 6 November sebelumnya menjelaskan snapshot pengembangan; panduan tersebut tidak lagi menjelaskan paket di atas. ## Gunakan antarmuka Buka **Pseudo-secret**, pasang modulnya jika halaman tersebut menyediakannya, aktifkan untuk akun tersebut, dan hubungkan. Permintaan yang masuk akan menunggu persetujuan kecuali jika fitur persetujuan otomatis diaktifkan. Proses memulai, menerima, mengirim, dan menutup menggunakan izin interaksi akun serta perlindungan baca-saja. | Tindakan | Hasil yang dipertahankan | | --- | --- | | Mulai obrolan berdasarkan nama pengguna atau ID pengguna | Permintaan keluar; rekan menerima permintaan tersebut di perangkatnya. | | Terima permintaan | TgWitness menjadi titik akhir penerima. | | Mengirim atau menerima pesan | `secret_chat.message` beserta arah, isinya, dan timer yang disertakan. | | Terima berkas | Byte yang telah didekripsi disimpan menggunakan SHA-256 dan tanda terima `secret_chat.file`; disertakan dalam ekspor bukti. | | Menerima pemberitahuan timer atau penghapusan | Catatan tindakan terpisah bersama dengan pesan dan berkas yang disimpan. | | Tinjau obrolan | Percakapan, tanda terima file, pemberitahuan, dan visualisasi kunci. | Obrolan Rahasia yang sudah ada di perangkat lain tetap mempertahankan kunci khusus perangkatnya. Sesi cloud yang diimpor tidak mentransfer kunci-kunci tersebut. Materi kunci dan penghitung obrolan rahasia menggunakan brankas ruang kerja; pesan yang disimpan dan file yang telah didekripsi menggunakan perlindungan penyimpanan ruang kerja biasa. ## Temukan pesan yang telah disimpan Gunakan **fitur Pencarian pesan** di dalam obrolan yang terbuka untuk menemukan frasa tertentu, tanpa memperhitungkan huruf besar/kecil. **Tombol Sebelumnya** dan **Berikutnya**, atau tombol Enter dan Shift+Enter di kolom pencarian, digunakan untuk berpindah antar pesan yang cocok. Penghitung menampilkan jumlah pesan; frasa pertama yang cocok dalam setiap pesan akan disorot. Tombol Escape akan menghapus pencarian. Fitur Pencarian menampilkan percakapan di sekitarnya, berkas yang disimpan, dan pemberitahuan penghapusan secara tetap. Fitur ini mencari catatan yang sudah dimuat di panel. Jika masih ada catatan sebelumnya, panel akan menampilkannya; opsi **Muat Catatan Lama** akan memperluas riwayat dan memperbarui hasil pencarian sambil tetap mempertahankan pesan saat ini di tempatnya. Setiap obrolan tetap menyimpan riwayat pencariannya saat Anda berpindah di dalam ruang kerja yang sama. Mengunci panel atau berpindah ruang kerja akan menghapus riwayat pencarian tersebut. Istilah pencarian tetap tersimpan di memori halaman dan tidak disimpan di penyimpanan browser atau dikirim sebagai permintaan API. Pencarian tidak mengirim pesan Telegram atau pemberitahuan mengetik/telah dibaca. Pengaturan visibilitas yang ada tetap berlaku untuk membuka obrolan dan tindakan lainnya. **Laporan build** mempertahankan cakupan laporan obrolan yang dipilih; pencarian di tampilan tidak secara diam-diam membatasi catatan yang diekspor. Lihat pratinjau pilihan laporan sebelum mengunduhnya. ## Kontrol persistensi dan interaksi Implementasi terintegrasi ini menggunakan pencarian jurnal yang tahan lama untuk mendeteksi duplikat, menahan pekerjaan lampiran dalam status tertunda setelah unduhan gagal, dan mengarahkan penutupan melalui penjaga interaksi yang sama seperti tindakan jarak jauh lainnya. Hal ini menggantikan tiga jalur yang dilaporkan dalam audit snapshot pengembangan historis tanggal 6 November. Pesan yang telah didekripsi namun gagal ditulis ke jurnal akan disimpan di vault untuk dicoba kembali. Pemeriksaan ukuran lampiran dan ruang kosong pada disk akan menunda pengunduhan sambil tetap mempertahankan tugas-tugasnya. Modul ini menggunakan kembali koneksi yang sudah ada dari akun tersebut. Pemberitahuan telah dibaca dan sedang mengetik dikirim hanya sesuai pilihan di bagian " [Apa yang dilihat pihak lain](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees)"; pemberitahuan tangkapan layar tidak pernah dikirim. Lihat [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [rute API](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py), dan [kebijakan akses](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py). [Audit historis](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) mempertahankan temuan snapshot aslinya. Ketersediaan dan implementasi saat ini harus dibaca dari revisi paket di atas dan [kapabilitas terkini](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md). ## Demonstrasi antarmuka Skenario situs web ini menggunakan permintaan, pesan, dan berkas fiktif untuk mendemonstrasikan alur kerja panel. Ini hanyalah contoh antarmuka; pemeriksaan protokol dan akuisisi memiliki hasil terperinci tersendiri dalam catatan validasi. --- # Telegram · Muat riwayat sumber Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/history/ Muat pesan-pesan sebelumnya dari sumber yang diaktifkan, jeda dan lanjutkan, serta verifikasi laporan kemajuan yang telah ditandatangani. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Muat pesan-pesan sebelumnya dari sumber yang diaktifkan, jeda dan lanjutkan, serta verifikasi laporan kemajuan yang telah ditandatangani. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Koleksi](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![Koleksi](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) Di **More tools → Sources → Chats in scope**, periksa obrolan yang diaktifkan, pilih Standard API atau Takeout export, lalu pilih **Load full history**. Proses ini akan memperbaiki daftar sumber tersebut dan membaca pesan-pesan lama yang tersedia ke dalam Chats dan jurnal pengamatan yang ditandatangani. Media menggunakan pengaturan lampiran yang sudah ada dan antrian unduhan permanen. Hal ini terpisah dari ekspor JSON/HTML yang ditandatangani per obrolan. Untuk pengumpulan di seluruh akun, pilih **"Seluruh akun** " dan simpan cakupannya. Riwayat akan memperbarui semua jendela dialog yang dapat diakses, termasuk obrolan yang diarsipkan, sebelum menandatangani daftar sumbernya. Proses penemuan ini tidak menggunakan batasan daftar pada pemilih obrolan yang dipilih. Obrolan yang ditemukan kemudian akan dipantau dan menerima snapshot awal yang telah dikonfigurasi; proses penuh lainnya dapat memuat riwayat sebelumnya. Pastikan **opsi Pertahankan pemantauan selama dan setelah pemuatan riwayat tetap** diaktifkan untuk merekam pesan baru, pengeditan, dan pemberitahuan penghapusan saat riwayat dimuat. Satu proses riwayat atau ekspor menggunakan slot akuisisi; pengamatan langsung berjalan bersamaan dengannya. Pilih satu hingga tiga obrolan yang berlangsung bersamaan, satu hingga lima pekerja lampiran, serta apakah akan menyimpan Tindakan Terbaru yang tersedia dan membandingkan versi yang telah disimpan sebelumnya. Proses pengambilan data mungkin memerlukan persetujuan di Telegram dan waktu tunggu yang ditentukan oleh server. Opsi-opsi ini tetap berlaku saat proses dilanjutkan. Lihat [perilaku Backfill dan kontrak bukti](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md) untuk detail mengenai pengiriman, upaya ulang, dan kepercayaan. ## Jeda, mulai ulang, dan hasil parsial - **Jeda riwayat** menghentikan pembacaan. **Lanjutkan riwayat** melanjutkan dari pesan terakhir yang telah disimpan di setiap sumber; memulai ulang aplikasi juga akan membuat proses tetap dalam keadaan dijeda hingga dilanjutkan kembali. Untuk melanjutkan, diperlukan akun Telegram yang sama yang tidak aktif. - Pengamatan pesan, pemrosesan lampiran, dan pencatatan posisi kursor dilakukan dalam satu transaksi. Proses yang dilanjutkan tidak akan mengulangi pengamatan yang telah dicatat sebelumnya. Penangkapan langsung atau proses terpisah yang dimulai secara eksplisit dapat mengamati pesan yang sama secara independen. - Setiap sumber (setiap rentang Telegram yang dipisahkan di Takeout) menetapkan ID pesan tertinggi pada pembacaan pertamanya. Pesan-pesan yang lebih baru termasuk dalam pengamatan langsung, bukan pada halaman historis yang tersisa dari sumber tersebut. - Sumber yang tidak dapat diakses dan sumber yang dinonaktifkan selama proses pengumpulan tetap terlihat sebagai gagal atau dilewati. Sumber lainnya tetap berlanjut; hasil keseluruhan tidak lengkap. - Telegram hanya menampilkan log admin obrolan kepada para administratornya. Bagi anggota biasa, akses ke log admin dicatat sebagai ``history.admin_log.unavailable`` dengan `reason: not_admin`, dan hal ini tidak menyebabkan riwayat menjadi tidak lengkap; sedangkan akses ke log admin yang gagal bagi seorang administrator justru menyebabkan riwayat menjadi tidak lengkap. - Penundaan FloodWait menghormati pengaturan backoff akun yang disimpan. Kegagalan sementara akan dicoba ulang hingga lima kali; kehabisan kuota dan ruang disk rendah akan menghentikan sementara proses dengan kursor tetap utuh. - **Akhiri proses riwayat ini** mempertahankan pengamatan yang telah disimpan. Perintah ini tidak menghapusnya atau membatalkan tugas lampiran API standar. Mengakhiri Takeout menandai file Takeout yang tersisa sebagai terlewati; menjeda membuatnya tetap dapat dilanjutkan. Proses baru membaca kembali sumber yang diaktifkan. Penyelesaian riwayat hanya menggambarkan pembacaan riwayat. Lampiran mungkin tetap dalam status tertunda, gagal, atau dikecualikan oleh kebijakan yang dikonfigurasi. Periksa tanda terima media di jurnal dan antrian lampiran; hanya tanda terima yang telah selesai dengan byte yang terpelihara yang dianggap sebagai lampiran yang tersimpan. Operasi riwayat merupakan permintaan snapshot eksplisit dan terpisah dari opsi yang memilih kategori peristiwa langsung di masa mendatang. ## Transfer dan verifikasi Simpan **laporan kemajuan** yang **telah ditandatangani**, lalu gunakan **"Ekspor Bukti"** untuk mengunduh jurnal dan lampiran yang disimpan. Ekspor bukti di kemudian hari mungkin mencakup catatan tambahan; laporan tersebut mengikat penghitungnya ke awalan jurnal pada saat dibuat. Jalankan verifikator dari salinan tepercaya versi ini: ``` python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT ``` Simpan sidik jari kunci penandatanganan yang diharapkan secara terpisah. Verifikator memeriksa tanda tangan laporan, arsip bukti, titik pemeriksaan laporan, rencana sumber, akun, dan jumlah pesan yang tersimpan/tidak tersedia. Proses baru juga mengaitkan kemajuan sumber dan opsi ke peristiwa kursor yang ditandatangani. Tanpa `--evidence`, alat ini hanya memeriksa laporan yang ditandatangani dan konsistensi internalnya. Bidang kemajuan lama dan ringkasan lampiran tetap menjadi pernyataan pengumpul yang ditandatangani. Verifikator bukti memeriksa byte media yang diarsipkan. Baca riwayat yang telah diverifikasi beserta interval perolehannya, cakupan, dan Tindakan Terbaru yang tersedia. Alur kerja ini membaca riwayat yang saat ini dapat diakses; [pemantauan langsung](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#message-history-and-attribution) menyimpan versi dan pemberitahuan saat diterima, sedangkan [Obrolan Rahasia](https://phishdestroy.io/tgwitness/id/docs/reference/secret-chats/) menggunakan integrasi titik akhir yang diaktifkan. Untuk verifikasi, gunakan titik pemeriksaan yang disimpan, catatan saksi, dan pernyataan perolehan yang berlaku sebagaimana dijelaskan dalam [mode verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope). Kursor akuisisi menunjukkan status ruang kerja lokal. Memulihkan berkas ZIP bukti saja tidak akan memulihkan tugas akuisisi yang tertunda atau sesi Telegram. Simpan cadangan ruang kerja jika Anda perlu melanjutkan tugas asli. --- # Telegram · Alur kerja dan operasi Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/operations/ Pengoperasian harian panel: mode, kategori pemantauan, parameter, pemberitahuan, ekspor, pencadangan, dan kapasitas. [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. Pengoperasian harian panel: mode, kategori pemantauan, parameter, pemberitahuan, ekspor, pencadangan, dan kapasitas. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penerapan dan pemulihan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) ![Penerapan & pemulihan](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Untuk koneksi pertama Anda, gunakan [akun dan format sesi](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/). Untuk penjelasan mengenai versi yang disimpan, kebijakan peristiwa, dan celah, lihat [cara kerja pengumpulan data](https://phishdestroy.io/tgwitness/id/docs/reference/collection/). Panduan ini mencakup operasi harian dan pemulihan. Instalasi yang dikelola mencakup **, START-HERE.html,**, dan **, START-HERE.txt, serta** di samping peluncurnya, dengan tautan repositori dan perintah yang disesuaikan dengan jalur instalasinya. Jalankan `tgwitness guide --print` melalui SSH, atau `tgwitness paths` untuk menemukan direktori data yang sebenarnya. Instalasi systemd dengan hak akses root menyimpan status pribadi di bawah `/var/lib/tgwitness-…`; `/opt/tgwitness` menyimpan programnya. Untuk terowongan Cloudflare sementara yang dikelola, `tgwitness tunnel off` menutup akses publik sementara panel lokal dan pengumpulan data tetap berjalan. `tgwitness tunnel on` mengaktifkannya; `tgwitness tunnel restart` membuat koneksi terowongan baru. Gunakan `tgwitness open` untuk melihat alamatnya saat ini. Pengaturan penonaktifan eksplisit tetap berlaku meskipun layanan dimulai ulang. `tgwitness stop` menghentikan panel dan pengumpulan data. **Di halaman ini** - [Alur kerja operator](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#operator-workflow) - [Bagikan hasil kerja tanpa membagikan kunci utama](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#share-work-without-sharing-the-main-key) - [Mode runtime](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#runtime-modes) - [Kategori pemantauan](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#monitoring-categories) - [Pemberitahuan](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#notifications) - [Tata letak panel](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#panel-layout) - [Lingkungan penerapan](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#deployment-environments) - [Pemeriksaan saat startup dan ekspor](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#startup-checks-and-exports) - [Pencadangan, pemulihan, dan gangguan](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#backup-restore-and-interruptions) - [Kapasitas dan penyimpanan](https://phishdestroy.io/tgwitness/id/docs/reference/operations/#capacity-and-retention) ## Alur kerja operator Diagram alur · Pilih penyimpanan dan perlindungan kunci → Buka panel dengan tokennya; Buka panel dengan tokennya → Pilih ruang kerja; Pilih ruang kerja → Konfigurasikan rute langsung atau melalui proxy; Konfigurasikan rute langsung atau melalui proxy → Masukkan nomor telepon atau pilih berkas / QR; Masukkan nomor telepon atau pilih berkas / QR → Periksa identitas akun dan pilih grup yang dapat diakses; Periksa identitas akun dan pilih grup yang dapat diakses → Simpan kebijakan peristiwa dan lampiran, lalu mulailah pemantauan; Simpan kebijakan peristiwa dan lampiran, lalu mulailah pemantauan → Memantau kesalahan, akses, antrian, dan disk; Memantau kesalahan, akses, antrian, dan disk → Pertahankan titik pemeriksaan independen; Pertahankan titik pemeriksaan independen → Ekspor dan verifikasi materi · Pilih penyimpanan danperlindungan kunci · Buka panel dengantokennya · Pilih ruang kerja · Konfigurasikan rutelangsung atau melaluiproxy · Masukkan nomor teleponatau pilih berkas / QR · Periksa identitas akundan pilih grup yangdapat diakses · Simpan kebijakanperistiwa danlampiran, lalumulailah pemantauan · Memantau kesalahan,akses, antrian, dandisk · Pertahankan titikpemeriksaan independen · Ekspor dan verifikasimateri **Diagram dalam bentuk teks** 1. Pilih penyimpanan dan perlindungan kunci → Buka panel dengan tokennya 2. Buka panel dengan tokennya → Pilih ruang kerja 3. Pilih ruang kerja → Konfigurasikan rute langsung atau melalui proxy 4. Konfigurasikan rute langsung atau melalui proxy → Masukkan nomor telepon atau pilih berkas / QR 5. Masukkan nomor telepon atau pilih berkas / QR → Periksa identitas akun dan pilih grup yang dapat diakses 6. Periksa identitas akun dan pilih grup yang dapat diakses → Simpan kebijakan peristiwa dan lampiran, lalu mulailah pemantauan 7. Simpan kebijakan peristiwa dan lampiran, lalu mulailah pemantauan → Memantau kesalahan, akses, antrian, dan disk 8. Memantau kesalahan, akses, antrian, dan disk → Pertahankan titik pemeriksaan independen 9. Pertahankan titik pemeriksaan independen → Ekspor dan verifikasi materi Otorisasi, konektivitas jaringan, akses ke grup, dan kelengkapan pengiriman merupakan properti yang berbeda. Status koneksi berwarna hijau tidak berarti semua peristiwa telah terekam. ## Bagikan hasil kerja tanpa membagikan kunci utama Buka **Alat Lainnya → Akses** untuk memberikan token tersendiri kepada peninjau atau analis. Pilih akun dan obrolan yang dapat mereka buka, lalu izinkan tindakan melihat, mengekspor, atau tindakan operasional. Seorang operator yang memulai/menghentikan pengumpulan memerlukan akses ke seluruh ruang kerja; seorang peninjau dapat dibatasi hanya pada satu obrolan. Batas sesi, masa berlaku, dan aturan IP terpisah dari otorisasi akun Telegram. Lihat [akses dan izin](https://phishdestroy.io/tgwitness/id/docs/reference/access/). Gunakan **"Open sessions"** untuk mengakhiri koneksi atau mencabut akses guna mengakhiri semua sesinya. Konsol administrator menggabungkan aktivitas proses saat ini di seluruh ruang kerja. Penutupan sesi tidak menghentikan proses pengumpulan data. ## Mode runtime | Mode | Tindakan | Perilaku | | --- | --- | --- | | Demo | scripts\Demo.cmd atau `--demo` | Data sintetis; koneksi akun asli dinonaktifkan | | Pengamatan | Mulai pemantauan | Mencatat pembaruan yang telah dikirimkan untuk sumber-sumber yang dipilih | | Cuplikan riwayat | Obrolan → Tindakan obrolan → Muat riwayat | Maksimal 500 pesan terkini; tidak ada rekonstruksi atas semua perubahan di masa lalu | | Jeda | Jeda pengamatan | Hentikan pengumpulan data sambil tetap menyimpan data dan pekerjaan yang sedang dalam antrian | | Tinjauan/serah terima | Ekspor | ZIP, JSONL/CSV/HTML, titik pemeriksaan, tanda terima proses, dan permintaan cap waktu | | Beberapa akun | Ruang kerja atau tombol **+** di bagian atas | Jumlah ruang kerja terpisah yang tidak terbatas dalam satu proses | Akses demo lokal terbuka secara otomatis tanpa perlu memasukkan token secara manual. Fitur ini menggunakan kemampuan seumur proses yang hanya berlaku untuk akses loopback langsung ke demo sintetis yang terisolasi; token panel utama tidak diungkapkan. Ruang kerja nyata serta akses demo jarak jauh atau melalui proxy tetap memerlukan otentikasi token. Akses demo tidak memberikan otorisasi apa pun di Telegram. ## Kategori pemantauan ![Pengaturan pemantauan per akun dengan data sumber sintetis](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c) Di **More tools → Sources → Recording → Choose which changes to preserve**, pilih pesan baru, pengeditan, pemberitahuan penghapusan, pembaruan reaksi, dan peristiwa keanggotaan secara terpisah. Pengaturan default menyimpan semua kategori. **Pilihan Messages, edits & deletions** mempertahankan konteks asli sambil menonaktifkan pembaruan reaksi/keanggotaan terpisah. **Pilihan All visible activity** mengembalikan kelima kategori tersebut. Preset mengubah format; tekan **Save recording settings** untuk menerapkan. Kebijakan yang disimpan berlaku untuk semua sumber yang dipilih di ruang kerja tersebut. Ruang kerja lainnya mempertahankan pengaturannya masing-masing. Setiap perubahan aktual mencatat nilai sebelum/sesudah yang telah ditandatangani; kebijakan saat ini juga disertakan dalam tanda terima proses dan catatan awal pengamatan. Menonaktifkan suatu kategori tidak menghapus pengamatan sebelumnya. Mengaktifkan kembali tidak akan memulihkan perubahan yang terlewatkan. Tidak ada penggantian kategori per-kelompok dalam versi ini. Biarkan opsi "pesan baru" tetap aktif jika konten sebelumnya penting: pemberitahuan penghapusan tidak dapat memulihkan teks yang tidak pernah direkam. Catatan operasional/cakupan dan peristiwa layanan grup lainnya selalu disimpan. Cuplikan riwayat eksplisit terpisah dari pemilihan kategori langsung dan mungkin mencakup pesan layanan. Opsi-opsi ini tidak menyensor metadata reaksi/anggota yang tertanam dalam objek Telegram yang telah direkam. Cuplikan riwayat mungkin mengantrekan lampiran saat dalam keadaan dijeda. Mulailah pemantauan untuk memproses lampiran tersebut. Berada dalam antrean tidak berarti telah diunduh. File asli yang tidak tersedia tidak diganti dengan versi yang lebih baru yang telah diedit; hasilnya dicatat secara terpisah. **Mengunci** akan menghapus akses browser dan bidang rahasia, tetapi tetap membiarkan proses pengumpulan data berjalan. Menutup tab juga akan membiarkan proses tetap berjalan. Menghentikan proses Python atau layanan akan menghentikan pengumpulan data terlepas dari status browser. Ruang kerja tambahan dapat dihapus setelah berkas ZIP atau wadah ASiC-E yang telah ditandatangani—yang mencakup jurnalnya serta catatan Case Board-nya—telah diunduh secara lengkap. Menyiapkan arsip saja tidak cukup: adanya catatan di luar peristiwa penyiapan atau catatan yang ditambahkan setelah pengunduhan akan membuat **opsi Hapus** tetap tidak tersedia. Saat panel menerima berkas itu sendiri, panel tersebut baru menghitung ekspor setelah menerima setiap byte, lalu melaporkan ukurannya ke `POST /api/exports/{id}/received`; unduhan yang terputus tidak dihitung. Dengan pemilih penyimpanan browser (Akses Sistem Berkas), panel melaporkannya setelah berkas ditulis dan ditutup. Tanpa fitur tersebut, panel menyerahkan file yang diterima ke daftar unduhan browser dan tidak dapat mengetahui apakah browser menyimpannya, misalnya ketika dialog penyimpanannya dibatalkan; panel kemudian melaporkan bahwa unduhan telah dimulai, bukan bahwa file tersebut telah disimpan. Sebuah file yang diunduh oleh browser secara mandiri (ekspor yang ukurannya melebihi buffer browser panel) dan unduhan oleh klien HTTP lain dihitung ketika server telah mengirimkan seluruh respons. Sistem operasi dan proxy terbalik menyimpan beberapa megabyte respons dalam buffer, sehingga untuk unduhan ini, server tidak dapat mendeteksi gangguan di dekat akhir. Kecuali panel menyatakan bahwa file telah disimpan, periksa file yang diunduh sebelum menghapusnya. Ekspor grup dihitung untuk akun-akunnya ketika diunduh segera setelah disiapkan; mengunduhnya kembali dari **bagian Ekspor yang Telah Disiapkan** tidak dihitung. Sebelum menghapus, panel menampilkan format, ukuran, waktu persiapan, dan SHA-256 dari arsip bertanda tangan yang terakhir diunduh serta meminta konfirmasi bahwa arsip ini disimpan di luar ruang kerja. Server akan menolak perintah ` `DELETE /api/profiles/{id}`` jika parameter ``kept_copy`` tidak disetel ke nilai SHA-256 tersebut (atau ke ``confirmed`` untuk arsip yang diunduh sebelum sidik jari tersebut tercatat). Menghapus ruang kerja tambahan akan menghentikan pengumpulnya dan menghapus data lokalnya. Jika file terkunci atau kesalahan sistem berkas mengganggu proses penghapusan, panel akan melaporkan kegagalan tersebut dan tetap mencantumkan ruang kerja tersebut sebagai tidak tersedia (`DeletionPending`). Tutup program yang menyimpan file-file tersebut dan coba lagi dengan opsi **Hapus**. Memulai ulang TgWitness akan membuat ruang kerja tersebut tetap dalam status terhenti dan tidak akan membuat ulang jurnal atau kunci yang telah dihapus sebagian. Penghapusan yang berhasil dicatat hanya setelah direktori tersebut dihapus; salinan yang diekspor atau dicadangkan secara terpisah tetap berlaku sesuai kebijakan penyimpanan masing-masing. ## Pemberitahuan Buka **Pengaturan → Pemberitahuan dan salinan di luar situs → Tujuan pemberitahuan**, atau **Alat lainnya → Ekstra → Pemberitahuan → Konfigurasi**. TgWitness menggunakan Apprise untuk mengirim peringatan ke Matrix, Telegram, Discord, Slack, ntfy, email, dan layanan lain yang didukung. Anda dapat menambahkan beberapa tujuan ke satu ruang kerja. 1. Masukkan satu URL tujuan Apprise per baris. Gunakan [katalog layanan dan format URL](https://appriseit.com/services/) yang sesuai untuk layanan Anda. 2. Aktifkan "**Kirim pemberitahuan**", lalu pilih peringatan masalah, perubahan dalam obrolan yang dipantau, dan ringkasan harian. Jam dalam ringkasan menggunakan waktu server. 3. Aktifkan "**Sertakan kutipan singkat"** jika Anda ingin teks yang disimpan dari pesan yang dihapus dan diedit muncul dalam pemberitahuan. 4. Tekan **Simpan pemberitahuan**, lalu **Kirim uji coba** untuk memeriksa pengiriman. Untuk penerima Anda sendiri, gunakan [webhook JSON](https://appriseit.com/services/json/) Apprise. Misalnya, `jsons://notify.example.org/tgwitness` mengirim JSON melalui HTTPS ke titik akhir tersebut. Ini adalah contoh fiktif; gantilah dengan tujuan Anda sendiri. Tujuan dan pengaturan merupakan bagian dari ruang kerja yang dipilih. Pemberitahuan perubahan mencakup sumber-sumber yang dipantau, termasuk obrolan yang baru ditambahkan. Lonceng di bilah atas juga mencantumkan masalah terbaru dan perubahan obrolan. Dalam demo, kontrol notifikasi terlihat tetapi pengiriman dinonaktifkan. Konfigurasikan pengiriman di ruang kerja yang sebenarnya. Notifikasi menggunakan rute Direct, SOCKS5, atau HTTP dari ruang kerja tersebut; MTProxy tidak dapat mengantarkannya. Tujuan non-HTTP seperti SMTP memerlukan rute langsung. ## Tata letak panel ![Ruang kerja koneksi menggunakan data sintetis](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29) **Jurnal** menampilkan pengamatan, pencarian, dan filter. Pengeditan akan menampilkan versi yang terekam; penghapusan akan menampilkan konten sebelumnya jika tersedia. Sumber yang tidak diketahui tetap disebutkan secara eksplisit. Jumlah tersedia di bagian **Ikhtisar**; rincian akuisisi tetap ada di panduan lokal. Buka pesan yang diedit untuk membandingkan versinya dengan **Perubahan dalam teks** atau **Berdampingan**; **Data mentah** menampilkan kolom yang disimpan. Perubahan pada tautan tersembunyi dan tombol bot muncul secara terpisah. Buka pratinjau lampiran untuk memeriksa gambar, audio, atau video yang disimpan; tombol unduh menjaga agar file asli yang disimpan tetap tersedia. **Live** memperbarui jurnal dan obrolan saat catatan masuk. Jeda fitur ini saat meninjau, atau gunakan tombol peristiwa baru saat siap; pengumpulan data tetap berjalan. **Ctrl/Cmd+K** menemukan tindakan panel dan mencari di dalam jurnal. **Alat lainnya → Sumber** berisi cakupan pengamatan (obrolan yang dipilih, folder Telegram, atau seluruh akun), obrolan yang dapat diakses dari semua jenis, sumber terpilih dengan bintang prioritas, pengaturan lampiran dan pemeriksaan ulang, serta cuplikan riwayat. Sumber pribadi dipilih berdasarkan dialog/ID tanpa tautan publik. Status akses menggambarkan pemeriksaan terbaru, bukan izin permanen. Filter sumber, centang kotaknya, lalu aktifkan, jeda, atau tandai sebagai prioritas secara bersamaan. Dalam daftar obrolan yang tersedia, **Tambahkan yang dipilih** menggunakan pilihan Anda; **Tambahkan semua hasil** menggunakan filter pencarian dan jenis saat ini. **Obrolan → Daftar Kontak** menampilkan semua orang yang pesannya telah disimpan; jika profil kontak diaktifkan untuk obrolan tersebut, satu klik akan membuka profil orang tersebut beserta tautan ke catatan jurnal. **Alat lainnya → Ekstra → Saksi independen** membuat token saksi yang hanya dapat dibaca, menampilkan kapan terakhir kali setiap saksi melakukan pemeriksaan, dan menyediakan perintah serta opsi untuk menjalankan [saksi independen](https://phishdestroy.io/tgwitness/id/docs/reference/witness/). **Alat lainnya → Parameter** mencakup setiap batasan dan laju ruang kerja yang tidak tercantum di halaman lain: berapa banyak percakapan yang dibaca, seberapa sering daftar obrolan dibaca ulang, interval detak jantung dan titik pemeriksaan , buffer awal, bagaimana pemeriksaan ulang mendistribusikan permintaannya (penundaan awal, jumlah obrolan per laluan, jeda antar obrolan, pesan yang dipulihkan dan diminta ulang), cadangan disk, batas waktu dan upaya ulang unduhan, apa yang dicari profil pengguna (termasuk ekspresi reguler Anda sendiri), ukuran dan frekuensi notifikasi, batas snapshot, ZIP, dan unduhan browser, serta batas waktu dan upaya ulang klien Telegram. Setiap bidang menampilkan rentang dan nilainya default; bidang yang diubah ditandai dan dapat dikembalikan satu per satu atau sekaligus. Setiap perubahan dicatat sebagai ``parameters.changed`` beserta nilai sebelum dan sesudahnya, dan catatan awal pemantauan mencantumkan nilai yang berlaku. Nilai-nilai tersebut berlaku mulai dari penggunaan berikutnya; batas waktu klien dan upaya ulang berlaku mulai dari koneksi berikutnya. Interval pemeriksaan ulang, jenis dan ukuran lampiran, bukti, serta interval salinan di luar situs tetap berada di halaman masing-masing dan dapat mengambil nilai apa pun dalam rentangnya, tidak hanya pengaturan bawaan. Lonceng di bilah atas mencantumkan masalah dan perubahan terbaru dalam obrolan yang dipantau; pesan yang belum dibaca akan dihitung hingga ditandai sebagai telah dibaca. Perubahan dikelompokkan per obrolan dan per jam ("12 dihapus, 1 diedit, 0 tidak ditemukan"), dan masalah seperti logout atau disk penuh tetap ada dalam daftar terlepas seberapa sibuknya obrolan tersebut. **Alat lainnya → Pembuatan akun** dimulai dari kolom nomor telepon. **Lanjutkan** akan langsung mengarah ke pemasukan kode, dan hanya meminta kredensial API jika belum ada. QR dan impor berkas adalah tab alternatif. Kredensial API yang disimpan hanya digunakan kembali di dalam ruang kerja masing-masing. Layar entri tidak memiliki bilah samping, statistik, atau paragraf pengaturan. Ikon **Pengaturan** membuka kontrol API, proxy, penyimpanan, dan akun tambahan. Ruang kerja baru membuka [pengaturan awal](https://phishdestroy.io/tgwitness/id/docs/reference/settings/) ; setelah masuk, ruang kerja dengan sumber dan catatan yang tersimpan akan membuka **Obrolan** . Mengubah rute memerlukan penghentian sementara pengamatan dan membatalkan proses masuk yang belum selesai. Jurnal yang sudah ada tidak dapat diikat ulang secara diam-diam ke akun Telegram yang berbeda. **Fitur ekspor** memeriksa integritas jurnal dan menghasilkan berkas yang portabel. ID ruang kerjanya dapat diteruskan ke CLI unduhan. Setiap ekspor mengunci awalan jurnal lengkap; peristiwa selanjutnya akan dimasukkan ke dalam ekspor berikutnya. Filter pencarian tidak mengubah cakupan paket. Informasi terperinci mengenai penandatanganan dan cakupan terdapat di bagian **Verifikasi dan Bukti**. Panel ini melaporkan status pengumpul, media yang antri/gagal, media tertunda tertua, ruang disk kosong, jeda permintaan, dan sumber yang aksesnya belum dikonfirmasi di bawah **kesehatan Pengumpul**. Detail-detail ini awalnya ditutup dan disembunyikan di halaman Akun. Kartu pengaturan menunjukkan langkah selanjutnya: hubungkan akun, pilih sumber, atau mulai pemantauan. Daftar akun merupakan cuplikan pada saat dimuat; ruang kerja yang dipilih diperbarui secara berkala. Ini bukanlah pemantau SLA multiproses. Antarmuka menggunakan aset lokal dan perenderan teks untuk konten sumber. Tata letak desktop dan sempit di Chromium telah diuji. ## Lingkungan penerapan | Lingkungan | Instalasi | Status verifikasi | | --- | --- | --- | | PC/server Windows | Python 3.11+, scripts\Setup.cmd/Start.cmd, direktori data pribadi | Telah diuji secara lokal pada Windows/Python 3.12 | | Server Linux/VPS | Python venv, pengguna layanan khusus, HTTPS/SSH | Contoh kode, CI, dan systemd disertakan; tidak dijalankan di host ini | | macOS | Python venv, proses latar depan, atau agen pengguna | Contoh launchd disertakan; diperlukan pemeriksaan instalasi terpisah | | Docker/Compose | Volume yang konsisten, satu pekerja | Definisi dan pemeriksaan runtime CI disediakan; Docker tidak tersedia secara lokal | | Browser ponsel | Masuk ke panel yang dilindungi pada server yang sedang berjalan | Tata letak Chromium yang disempurnakan telah diuji; pengumpul data tidak berjalan di iOS/Android | Portabilitas berarti tidak ada layanan cloud atau pembangunan frontend yang wajib. Setiap target tetap memerlukan dependensi Python/kripto yang kompatibel, disk lokal, dan akses jaringan. Lihat [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) dan [templat layanan](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Ruang kerja berbagi CPU, memori, dan loop peristiwa. Untuk isolasi proses, gunakan instansi, port, direktori data, dan otorisasi akun yang berbeda. Tidak ada panel terpadu di antara instansi yang terpisah. Jangan pernah mengarahkan beberapa pekerja ke satu basis data. ## Pemeriksaan awal dan ekspor Jalankan `python start.py --check` sebelum memulai lingkungan yang telah disiapkan. Tambahkan `--json` untuk pemeriksaan yang dapat dibaca mesin atau berikan nilai yang diinginkan untuk `--data-dir`, `--host`, dan `--port`. Perintah ini memeriksa prasyarat tanpa perlu login ke Telegram atau membuat jurnal. Verifikasi jurnal berjalan saat aplikasi dimulai, dan status kesiapan penangkapan ditampilkan di panel. Port yang sudah terpakai mungkin hanya merupakan instance yang sudah ada. Browser yang mendukung File System Access API menyimpan ekspor melalui aliran yang dapat ditulis (writable stream). Browser lain menyimpan data dalam buffer maksimal 128 MiB. Gunakan CLI streaming untuk ekspor berukuran lebih besar atau browser yang tidak mendukung streaming file: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Tambahkan `--profile ID` dari Ekspor untuk ruang kerja anak. Gunakan `--url https://server` untuk akses jarak jauh. HTTP biasa hanya diterima untuk tujuan loopback. Token dibaca dari file dan dikirim dalam header, tidak dicetak atau dimasukkan ke dalam URL. Pengalihan ditolak. Tujuan yang sudah ada tidak akan ditimpa. Transfer yang gagal akan menghapus file bagian sementara mereka. SHA-256 yang dilaporkan adalah checksum transfer; verifikasi ZIP yang ditandatangani secara terpisah dengan sidik jari/titik pemeriksaan tepercaya. ## Pencadangan, pemulihan, dan gangguan 1. Jeda pengamatan dan hentikan proses dengan rapi. 2. Salin seluruh direktori data: database, WAL/SHM jika ada, media, `credentials.enc`, `signing.enc`, `network.enc`, kunci/metadata vault, token, titik pemeriksaan, dan setiap direktori `profiles/`. 3. Untuk mode kunci eksternal, simpan kunci utama secara terpisah dan pertahankan setiap `vault.external.json`. Pembuatan kunci baru tidak dapat memulihkan rahasia lama. 4. Pulihkan saat tujuan sedang dihentikan; konfigurasikan kunci asli, batasi akses, dan verifikasi integritas sebelum melanjutkan. 5. Catat waktu henti dan hasil verifikasi. Waktu henti tetap menjadi celah yang tercatat; snapshot riwayat menambahkan status setelahnya. Evidence ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/#updates-and-backups). Four things are protected differently: | Apa | Perlindungan | | --- | --- | | Berkas ekspor tanpa kata sandi (bawaan) | Ditandatangani, sehingga perubahan dapat dideteksi; tetapkan kata sandi untuk mengenkripsi ekspor | | Berkas ekspor dengan kata sandi | Jika Anda menetapkan kata sandi, hasil ekspor yang sudah jadi akan disimpan tanpa perubahan ke dalam berkas ZIP WinZip yang dienkripsi dengan AES-256 dan dapat dibuka dengan 7-Zip serta WinRAR; kata sandi tersebut tidak disimpan ([penanganan bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/)) | | Basis data jurnal dan lampiran yang disimpan di disk | Disk atau volume terenkripsi dan izin folder | | Sesi Telegram dan kunci penandatanganan | Terenkripsi di direktori data (`credentials.enc`, `signing.enc`, `network.enc`) | Cadangan layanan penuh adalah direktori data yang dihentikan seperti yang dijelaskan di atas, bukan ekspor. Gunakan penyimpanan yang dilindungi dan mekanisme transfer yang terencana untuk keduanya. Ekspor server sementara disimpan di `temporary-exports/` masing-masing ruang kerja; respons yang telah selesai dibersihkan, dan file ekspor yang terputus dihapus pada saat startup berikutnya saat kunci instance ruang kerja tersebut masih berlaku. Setelah peristiwa pemulihan koneksi, pengumpul meminta pembaruan yang terlewat dari posisi pembaruan yang disimpan. Tugas media persisten dan posisi pembaruan Telegram tetap ada setelah restart; lihat [format bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#durable-collection-and-process-receipts-02). ## Kapasitas dan masa penyimpanan Batas default, semuanya dapat diubah di **More tools → Parameters**: 1,000 dialog pertama, 500 pesan per snapshot, 4 GiB konten ZIP yang ditandatangani dan tidak terkompresi (arsip yang lebih besar memerlukan `verify.py --max-gib N`) dan cadangan browser sebesar 128 MiB. Lampiran memakan ruang 1–2,000 MiB per jenis di **More tools → Sources → Recording → Attachments**. CLI unduhan secara default mentransfer 5 GiB. Ruang disk yang tersedia dapat menjadi batas bawah. Sisihkan ruang untuk jurnal, media, WAL, ekspor sementara, dan cadangan. Ekspor menggunakan volume data, bukan direktori 512 MiB `/tmp` di Compose. Ukur peristiwa per detik, usia antrian, byte media, dan latensi disk, bukan hanya menghitung jumlah grup. Pengiriman langsung diukur pada pengumpul yang sedang berjalan. Tidak ada penghapusan retensi otomatis. Menghapus bagian akhir jurnal akan membatalkan hubungan jurnal tersebut dengan titik pemeriksaan yang disimpan. Pemeriksaan ulang prioritas sudah tersedia: sumber berbintang diperiksa ulang setiap 15 menit secara default, sumber lain setiap 6 jam (lihat [tingkat pemeriksaan ulang](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#recheck-tiers)). Ekspor yang dilindungi kata sandi berfungsi seperti dijelaskan di atas. Akses terbatas didokumentasikan dalam [akses dan izin](https://phishdestroy.io/tgwitness/id/docs/reference/access/). Lihat [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md), [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md), dan [VERIFICATION.md](https://phishdestroy.io/tgwitness/id/docs/reference/verification/). --- # Telegram · Mode penyelidikan Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/investigation/ Penyelidikan menyeluruh terhadap akun, mencakup saluran, grup, obrolan pribadi, dan bot, mulai dari lingkup penyelidikan hingga paket kasus yang terverifikasi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Penyelidikan menyeluruh terhadap akun, mencakup saluran, grup, obrolan pribadi, dan bot, mulai dari lingkup penyelidikan hingga paket kasus yang terverifikasi. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Penyelidikan](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Lacak sebuah kasus melintasi saluran, grup, obrolan pribadi, dan bot, mulai dari pengumpulan awal hingga garis waktu yang dirujuk dan penyerahan yang dapat diverifikasi. Versi situs web interaktif tersedia di `/docs/cases/`; [petunjuk pratinjau](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally). **Di halaman ini** - [Kasus yang berhasil: tujuan berubah di empat percakapan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#worked-case-a-destination-changes-across-four-conversations) - [1. Tentukan kasus dan kumpulkan seluruh keterangan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#1-define-the-case-and-collect-the-whole-account) - [2. Buat daftar semua sumber dan kumpulkan konteks historis](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#2-inventory-every-source-and-acquire-historical-context) - [3. Pertahankan perkembangan kasus dan interaksi yang disengaja](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#3-preserve-the-evolving-case-and-deliberate-interactions) - [4. Hubungkan pengamatan antar obrolan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#4-connect-observations-across-chats) - [5. Membuat garis waktu lintas obrolan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#5-build-the-cross-chat-timeline) - [6. Tambahkan perspektif akun tanpa menghilangkan asal-usulnya](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#6-add-account-perspectives-without-losing-their-origin) - [7. Susun dan verifikasi penyerahan kasus](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#7-assemble-and-verify-the-case-handoff) - [Sesuaikan penyelidikan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/#adapt-the-investigation) ## Contoh kasus: perubahan tujuan dalam empat percakapan Sebuah pengumuman mengarah ke sebuah bot. Sebuah grup operasional mendiskusikan tujuan pembayaran baru, dan keyboard bot menampilkannya. Pengumuman tersebut diedit, sebuah pesan tindak lanjut pribadi mengulangi tujuan tersebut, dan pesan grup menghilang. Pertanyaannya adalah: apa yang diamati sebelum dan sesudah perubahan, akun Telegram mana yang memposting setiap item, di mana tujuan tersebut muncul, byte lampiran mana yang dipertahankan, dan interval apa saja yang masih belum diketahui? Semua nama, ID, waktu, dan referensi jurnal dalam contoh ini adalah fiktif. Alur kerja ini menggunakan fitur-fitur terkini; peta kasus hanyalah ilustrasi, bukan grafik otomatis yang dihasilkan oleh aplikasi. Diagram alur · Saluran → Jurnal ruang kerja; Grup → Jurnal ruang kerja; Obrolan pribadi → Jurnal ruang kerja; Bot → Jurnal ruang kerja; Jurnal ruang kerja → Cari di semua sumber; Jurnal ruang kerja → Profil orang dengan referensi catatan; Jurnal ruang kerja → Versi yang disimpan dan tanda terima lampiran; Cari di semua sumber → Lini waktu analis dan daftar sumber; Profil orang dengan referensi catatan → Lini waktu analis dan daftar sumber; Versi yang disimpan dan tanda terima lampiran → Lini waktu analis dan daftar sumber; Jurnal ruang kerja → ZIP bukti yang ditandatangani; Lini waktu analis dan daftar sumber → Penyerahan kasus dengan bukti-bukti yang diverifikasi secara terpisah; ZIP bukti yang ditandatangani → Penyerahan kasus dengan bukti-bukti yang diverifikasi secara terpisah · Saluran · Grup · Obrolan pribadi · Bot · Jurnal ruang kerja · Cari di semua sumber · Profil orang denganreferensi catatan · Versi yang disimpan dantanda terima lampiran · ZIP bukti yangditandatangani · Lini waktu analis dandaftar sumber · Penyerahan kasus denganbukti-bukti yangdiverifikasi secaraterpisah **Diagram dalam bentuk teks** 1. Saluran → Jurnal ruang kerja 2. Grup → Jurnal ruang kerja 3. Obrolan pribadi → Jurnal ruang kerja 4. Bot → Jurnal ruang kerja 5. Jurnal ruang kerja → Cari di semua sumber 6. Jurnal ruang kerja → Profil orang dengan referensi catatan 7. Jurnal ruang kerja → Versi yang disimpan dan tanda terima lampiran 8. Cari di semua sumber → Lini waktu analis dan daftar sumber 9. Profil orang dengan referensi catatan → Lini waktu analis dan daftar sumber 10. Versi yang disimpan dan tanda terima lampiran → Lini waktu analis dan daftar sumber 11. Jurnal ruang kerja → ZIP bukti yang ditandatangani 12. Lini waktu analis dan daftar sumber → Penyerahan kasus dengan bukti-bukti yang diverifikasi secara terpisah 13. ZIP bukti yang ditandatangani → Penyerahan kasus dengan bukti-bukti yang diverifikasi secara terpisah ## 1. Menjelaskan kasus dan mengumpulkan seluruh kronologi peristiwa 1. Hubungkan akun pengumpul ke ruang kerjanya sendiri. Di [Case Board](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/) atau daftar kasus Anda, catat referensi kasus, ID akun, ruang kerja, dan waktu mulai pengamatan. Simpan sidik jari kunci penandatanganan tepercaya secara terpisah. 2. Untuk akun pengumpulan khusus, buka **Alat Lainnya → Sumber → Cakupan → Mode Investigasi**. Pengaturan default memilih " **Seluruh akun**", saluran/grup/obrolan pribadi/bot, tindakan sendiri, profil sumber, serta 200 pesan terbaru yang terlihat untuk sumber yang baru ditemukan. Tinjau pengaturan tersebut, tekan **Simpan Cakupan**, dan selesaikan konfirmasi cakupan. Akun utama menggunakan obrolan terpilih atau folder; pengumpulan seluruh akun tersedia untuk akun yang ditandai untuk investigasi. 3. **Muat obrolan** dan bandingkan sumber-sumber tersebut dengan daftar percakapan akun. Periksa pengecualian. **Alat lainnya → Parameter → Jumlah obrolan yang dibaca dari daftar akun** secara default adalah 1,000 dan memungkinkan hingga 20,000. Sumber di luar batas daftar akan ditambahkan saat mereka menjadi aktif. Catat apa yang sebenarnya telah dihitung. 4. Di **More tools → Sources → Recording**, pilih **All visible activity** dan simpan pengaturan pemantauan. Periksa jenis lampiran/batasannya serta ruang disk yang tersedia. 5. Mulai pengamatan. Validasi pesan baru yang dikendalikan, pengeditan, dan penghapusan, kemudian simpan referensi pengujian dan segala kegagalan yang terjadi. Cakupan seluruh akun mencatat aktivitas yang terlihat oleh akun dalam pengaturan yang disimpan, di obrolan yang telah diikuti oleh akun tersebut. Obrolan Rahasia dicatat oleh [modul Obrolan Rahasia](https://phishdestroy.io/tgwitness/id/docs/reference/secret-chats/), dan percakapan yang ada diisi ulang melalui [Riwayat](https://phishdestroy.io/tgwitness/id/docs/reference/history/). Lihat [cakupan pengumpulan](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account). ## 2. Inventarisasi setiap sumber dan peroleh konteks historisnya Buatlah daftar sumber dengan satu baris per obrolan: | Bidang | Merekam | | --- | --- | | Identitas | Ruang kerja, ID akun, ID obrolan numerik, judul, dan jenis | | Visibilitas | Keanggotaan/peran, akses yang telah dikonfirmasi atau belum dikonfirmasi, pengecualian | | Perekaman langsung | Waktu mulai, jenis peristiwa yang dipilih, dan perubahan kebijakan selanjutnya | | Riwayat jurnal | Permohonan/penyelesaian snapshot, batas, waktu, dan referensi catatan | | Riwayat lengkap | Nama file ekspor per obrolan yang ditandatangani, batas, dan status keberhasilan/kegagalan | | Lampiran | Tangkapan layar media yang telah diselesaikan, hash, ukuran, serta hasil yang dilewati/gagal | | Cakupan | Gangguan layanan, pengambilan data yang tidak lengkap, FloodWait, pesan yang tidak tersedia, dan celah lainnya | Gunakan metode pengumpulan data yang tepat untuk setiap sumber: - **Memuat riwayat lengkap** di **Alat Lainnya → Sumber → Obrolan dalam cakupan** akan memuat pesan-pesan masa lalu yang tersedia dari sumber yang diaktifkan ke dalam jurnal ruang kerja. Fitur ini mendukung jeda/lanjutkan serta laporan kemajuan yang ditandatangani. Lihat [perolehan riwayat](https://phishdestroy.io/tgwitness/id/docs/reference/history/). - **Snapshot riwayat** menyimpan pesan-pesan terbaru yang terlihat ke dalam jurnal pengamatan. Nilai maksimum defaultnya adalah 500; **melalui menu Alat Lainnya → Parameter → Snapshot Riwayat Terbesar,** nilai tersebut dapat ditingkatkan menjadi 10,000. Ini adalah pengamatan riwayat terkini, bukan suntingan yang direkonstruksi. - **Ekspor → Tangkap atau ekspor satu obrolan → Ekspor obrolan lengkap**, atau **Obrolan → Ekspor obrolan**, mengambil riwayat yang saat ini terlihat dari satu obrolan ke dalam bundel terpisah yang ditandatangani `chat.json` / `chat.html`. Ulangi untuk sumber-sumber kasus tersebut dan simpan setiap hasilnya. - **Ketika obrolan atau bot baru muncul**, profilnya serta hingga 1.000 pesan terbaru dapat disimpan; mode penyelidikan memilih 200 pesan. Obrolan yang sudah ada tidak menerima pencatatan tersebut secara retroaktif saat mode tersebut diaktifkan. - **Pengunduhan lampiran yang terlihat** akan menyimpan byte sesuai dengan kebijakan yang dikonfigurasi. Diperlukan tanda terima `media.saved` yang lengkap dengan SHA-256 dan jumlah byte. Pekerjaan yang sedang dalam antrian, gambar mini, atau nama file bukanlah lampiran yang disimpan. Ekspor obrolan lengkap **tidak** akan mengisi jurnal atau profil pengguna dengan semua pesan yang ada. Gunakan opsi **"Muat riwayat lengkap"** atau "cuplikan jurnal terbatas" untuk riwayat yang perlu Anda analisis di dalam TgWitness. Periksa daftar sumber yang diaktifkan sebelum memulai proses pemuatan riwayat. Kedua metode tersebut tidak dapat memulihkan materi yang tidak lagi tersedia di Telegram. ## 3. Melestarikan perkembangan kasus dan interaksi yang disengaja Tandai obrolan kasus aktif sebagai sumber prioritas. Tinjau interval pemeriksaan ulang, penyelesaian tunggakan, dan hasil media. Pastikan pengumpul data tetap aktif saat menggunakan akun. Gunakan **Obrolan → Profil → Simpan profil sekarang** untuk mempertahankan metadata sumber seperti deskripsi dan perintah bot. Hal ini terpisah dari profil pengguna yang dihasilkan dari pesan yang disimpan. Jika kasus tersebut melibatkan pelacakan sumber atau interaksi dengan bot: 1. **Buka tautan Telegram → Simpan pratinjau** akan merekam tautan yang diberikan dan pratinjau yang ditampilkan sebelum tindakan dilakukan. 2. **Perintah "Join / open and observe"** melakukan tindakan join/open, dan mengirimkan parameter start bot jika disediakan. Permintaan join yang sedang menunggu persetujuan dicatat sebagai pending. 3. Balasan teks yang dikeluarkan panel dan penekanan tombol yang didukung mempertahankan `interaction.requested` dan `interaction.result`. Tanda terima callback dapat mempertahankan teks popup yang dikembalikan, status peringatan, dan URL. Itu adalah tindakan akun yang sebenarnya. Penekanan tombol callback di aplikasi Telegram lain tidak terlihat oleh pengumpul, meskipun pesan atau pengeditan yang dihasilkan mungkin terlihat. Mini-client tidak menjalankan alur kerja aplikasi web, pembayaran, telepon, atau lokasi. Untuk perilaku yang tepat, lihat [interaksi panel](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#act-from-the-panel). ## 4. Menghubungkan pengamatan di berbagai obrolan Di **Jurnal**, pilih **Semua sumber** dan cari konten yang terekam. Buka catatan yang sesuai dan catat ruang kerja, obrolan, ID pesan, urutan, serta hash catatan. Dalam obrolan yang relevan, buka **People → Aktifkan profil**, lalu periksa profil seseorang: - Nama/nama pengguna yang teramati dari waktu ke waktu serta ID Telegram numerik. - Hubungan balasan dengan referensi catatan sumber. - **Juga terdapat di…** obrolan lain dalam jurnal ruang kerja ini di mana ID tersebut pernah menulis. - Aktivitas, pengeditan/penghapusan, serta dompet, nomor telepon, nama pengguna, dan tautan yang disebutkan. - Metadata avatar yang disimpan dan avatar serupa yang disimpan dalam cache, beserta asal masing-masing. Buka catatan yang dikutip sebelum menggunakan profil turunan dalam sebuah temuan. Profil mencakup orang-orang dengan pesan yang disimpan, bukan setiap anggota grup. **Alat lainnya → Parameter → Catatan yang dikutip per fakta** membatasi daftar referensi, bukan jumlah aktivitas yang mendasarinya. Sebutan dan kemiripan avatar merupakan petunjuk; kepemilikan dan identitas didasarkan pada ID numerik dan pengirim yang teridentifikasi. Dokumen yang ditandatangani ini memisahkan petunjuk pengkode dari berkas yang diteruskan dan digunakan kembali ke dalam kategori ` `clients.forwarded`` dan ``clients.reused``. Berkas-berkas tersebut tidak termasuk dalam daftar ` `clients.observed`` maupun ``media_timing.pre_existing``. File yang digunakan kembali berarti ID dokumen Telegram yang sama telah terdeteksi dalam pesan yang berbeda sebelumnya di jurnal ini, di dalam obrolan yang diizinkan bagi pembaca. Catatan pertama yang terdeteksi disebutkan; pengamatan atau pengeditan lain dari pesan yang sama tidak dianggap sebagai penggunaan kembali. Bagian `paid_reactions` dalam berkas ini menyimpan papan peringkat Stars terbaru yang tersedia untuk setiap pesan yang tercantum, beserta catatan sumber dan tanda anonim. Angka-angka ini merupakan jumlah pada saat penangkapan data, bukan akumulasi pembayaran tambahan atau daftar lengkap orang yang memberikan reaksi. Penangkapan data tanpa papan peringkat tidak menyediakan daftar pengganti. Bagian ini melaporkan pesan-pesan yang diabaikan ketika batas tampilan telah tercapai. Daftar pantauan dan ekspor indikator memeriksa label tombol, URL, teks salinan, kueri inline, dan byte callback yang dapat didekode sebagai UTF-8 yang valid. Pengkodean callback yang tidak valid atau berukuran terlalu besar dilewati oleh proses ekstraksi teks; byte aslinya tetap terdapat dalam catatan yang disimpan. Daftar pantauan yang sudah ada memerlukan pemindaian ulang untuk memeriksa catatan lama dengan bidang-bidang tambahan ini. Pemeriksaan tidak menekan tombol. Dalam contoh yang telah disusun: | Tautan | Merekam | Pengamatan yang didukung | | --- | --- | --- | | Akun pengirim yang sama | Grup #146 dan tindak lanjut pribadi #205 | Keduanya menyediakan ID pengirim Telegram 71001 | | Tujuan yang sama | #146, bot keyboard #173, pengeditan saluran #188, pesan pribadi #205 | Semua berisi `pay.example.invalid/new`; tujuan yang berulang menghubungkan materi tersebut | | File yang disimpan sama | Telah diselesaikan: tanda terima media #151 dan #209 | Nilai SHA-256 lengkapnya cocok dengan byte yang disimpan | | Sumber saluran | #101 dan #188 | Jangan mengaitkan postingan saluran kepada pengguna 71001 tanpa menyebutkan pengirimnya | Bandingkan hash lampiran dan referensi pesan yang terkait, serta jaga agar garis waktu akun dikelompokkan berdasarkan ID Telegram yang tercantum dalam catatan tersebut. Simpan catatan kerja tim di [Case Board](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/): tandai catatan yang Anda andalkan, seperti #146, #188, dan #205, sorot string tujuan yang tepat, dan simpan potongan dari setiap tindakan yang terekam di antara dua catatan atau dalam rentang waktu tertentu. Catatan dan status menyimpan tinjauan tim dalam riwayat bertanda tangan tersendiri, yang dapat diidentifikasi secara terpisah dari pengamatan sumber. ## 5. Membuat garis waktu lintas obrolan Gunakan versi yang disimpan di **Obrolan** beserta tautan **catatan Jurnal #…**-nya. Di **Jurnal**, gabungkan **Semua sumber** dengan **Pengeditan**, **Penghapusan,** dan **Cakupan**. Simpan baik `source_at` (jika tersedia) maupun `observed_at`. | Waktu pengamatan ilustratif | Referensi | Pengamatan | | --- | --- | --- | | 09:00 | Saluran #101 | Tujuan asli telah direkam | | 09:12 | Grup #146; media #151 | Tujuan baru telah diposting; pengunduhan berkas telah selesai | | 09:16 | Bot #173 | Tombol panah mengarah ke tujuan baru | | 09:20 | Saluran #188 | Pengumuman telah diedit; kedua versi yang disimpan tetap ada | | 09:24 | Pribadi #205; media #209 | ID pengirim yang sama mengulang alamat tujuan; byte file yang sama dipertahankan | | 09:28 | Grup #231 | Pemberitahuan penghapusan telah diterima; pengirim penghapusan dan waktu penghapusan yang tepat tidak diketahui | Catatan lain terjadi di antara referensi contoh ini. Nomor urut mengatur pengamatan; cuplikan riwayat dapat berisi tanggal sumber yang lebih lama dan tiba lebih lambat daripada peristiwa langsung. Bedakan antara cuplikan, pesan yang dipulihkan, pemberitahuan penghapusan, dan hasil "hilang saat diperiksa ulang". Tandai celah cakupan sebagai interval yang tidak diketahui. Akuisisi riwayat yang dilakukan kemudian tidak secara retroaktif menjamin pengamatan yang tidak terputus. ## 6. Tambahkan perspektif akun tanpa menghilangkan asal-usulnya Gunakan ruang kerja terpisah untuk setiap akun yang berbeda dan ulangi inventarisasinya. Simpan ID akun, peran, sidik jari kunci penandatanganan, dan referensi sumber pada setiap perbandingan. Nomor pesan bukanlah pengenal global yang berlaku di seluruh obrolan/akun. Case Board menyimpan catatan dan koleksi yang tertaut ke sumber di dalam setiap ruang kerja. Layar grup meninjau status akun secara bersama-sama dan dapat menggabungkan ekspor dari ruang kerja yang terpisah. Korelasikan sumber-sumber tersebut dalam catatan kasus atau alat analisis Anda; setiap jurnal mempertahankan asal dan kunci penandatanganannya sendiri. Pencarian global atau garis waktu lintas ruang kerja yang digabungkan tidak dihasilkan. Ekspor multi-akun dari satu saluran/supergrup mengambil riwayat obrolan tersebut menggunakan akun-akun yang memenuhi syarat. Untuk pekerjaan yang lebih panjang, pertahankan batasan dengan [saksi independen](https://phishdestroy.io/tgwitness/id/docs/reference/witness/). Gunakan pemeriksaan pengiriman terkontrol untuk memverifikasi jalur penangkapan dan visibilitas setiap akun. ## Sumber-sumber penyebaran ulang dan penerusan konten media Laporan bukti membandingkan ID dokumen Telegram dan nilai hash SHA-256 dari catatan file yang disimpan secara terpisah. Laporan tersebut menampilkan pesan dan obrolan yang berbeda, serta kemunculan pertama dan terakhir yang disimpan, dengan garis waktu pengamatan yang dapat diperluas dalam format HTML. Penangkapan layar berulang atau pengeditan pada pesan yang sama tidak menambah jumlah kemunculan untuk kunci yang sama. File yang berbeda dalam pesan yang diedit tetap mempertahankan kemunculannya sendiri. "Pertama kali diamati" mengikuti urutan jurnal dalam pemilihan laporan. Hal ini tidak mengklaim sebagai publikasi paling awal mengenai Telegram. ID dokumen mengidentifikasi dokumen-dokumen Telegram; SHA-256 membandingkan byte yang disimpan. dHash 64-bit yang cocok dari berbagai gambar yang disimpan ditampilkan sebagai petunjuk visual; perbandingan ini menggunakan hash yang sama, bukan pencarian tetangga terdekat. Byte gambar harus cocok dengan SHA-256 yang tersimpan sebelum analisis dHash; file berukuran lebih dari 64 MiB dan gambar dengan resolusi lebih dari 40 juta piksel dilewati. Ringkasan sumber-ke-tujuan menghitung pesan tujuan yang berbeda. ID rekan di header, nama tersembunyi, tanda tangan penulis posting, dan konteks Pesan Tersimpan tetap terpisah. JSON profil pengguna mencakup sumber dari setiap pengirim; posting saluran juga muncul dalam ringkasan tingkat obrolan. Sumber yang diberi nama tanpa ID rekan adalah pengelompokan teks, bukan orang yang teridentifikasi. Header obrolan yang diimpor tetap ditandai sebagai diimpor. Berkas ZIP bukti non-kompak mencakup `media-repeats.json`, `forward-sources.json`, dan `observed-sources.gexf`, yang dilindungi oleh manifes arsip. Grafik GEXF 1.3 memiliki tepi `forwarded_from` dan `recommended` yang bertipe. Panah mengarah dari obrolan yang diamati ke rekan yang dirujuk. Bobot rekomendasi menghitung pengamatan rekomendasi yang disimpan; bobot penerusan menghitung pesan yang berbeda. Nama tersembunyi dan header yang diimpor tidak menciptakan tepi identitas. Tidak ada operasi graf yang memecahkan profil atau memanggil Telegram. Metadata tepi mencakup urutan sumber dan hash. Ringkasan-ringkasan tersebut mengikuti pilihan dalam laporan; berkas ZIP bukti masih berisi jurnal lengkap yang telah ditandatangani. Sebuah pilihan yang hanya berisi peristiwa pesan membandingkan ID dokumen; perbandingan byte yang disimpan dan gambar memerlukan peristiwa berkas yang disimpan dalam aliran yang dipilih. Pilihan pesan cloud saat ini tidak mencakup `media.saved`. Batasannya jelas: 200.000 kemunculan kunci/pesan yang disimpan per analisis, 100.000 kunci media, 20 kelompok laporan, 100 referensi kronologi per kelompok, dan 1.000 tepi grafik yang diekspor. Ketika batas perbandingan tercapai, hasil akan menampilkan kejadian yang diabaikan dan jumlahnya menjadi batas bawah. Batas tampilan kronologi dan grafik dilaporkan secara terpisah. File ZIP ringkas mengabaikan ringkasan turunan ini. Catatan sumber yang ditandatangani tetap tidak berubah. ## 7. Mengumpulkan dan memverifikasi serah terima kasus Simpan semua ini dalam direktori kasus yang disusun oleh analis: | Materi | Tujuan | | --- | --- | | Catatan kasus dan daftar sumber | Pertanyaan, kebijakan pengumpulan data, akses/peran, temuan, penjelasan alternatif, dan celah | | Garis Waktu | Referensi waktu serta ruang kerja/obrolan/pesan/urutan untuk setiap entri | | Case Board ekspor dan potongan, jika digunakan | Penanda yang tertaut ke sumber, kutipan, catatan tim, koleksi, riwayat revisi, dan catatan terpilih yang telah diverifikasi berdasarkan berkas ZIP bukti | | Berkas ZIP bukti yang ditandatangani per ruang kerja | Jurnal yang direkam secara lengkap, manifes, dan media yang disimpan; filter panel tidak membatasi ekspor jurnal | | Berkas profil orang yang ditandatangani secara terpisah | Referensi yang diperoleh telah diverifikasi berdasarkan bukti di ruang kerja yang sesuai | | Ekspor obrolan lengkap yang ditandatangani | Pengambilan riwayat yang terlihat saat ini, terpisah dari jurnal pengamatan | | Sidik jari tepercaya, sertifikat akar TSA, dan titik pemeriksaan sebelumnya | Identitas kunci, waktu eksternal dari catatan terakhir, dan batas jurnal yang disimpan | | Artefak Witness, jika dikonfigurasi | Jurnal terpisah, posting yang ditandatangani, dan sidik jari saksi | | Hasil verifikasi dan hash berkas yang dikirimkan | Apa yang diperiksa, byte mana yang ditransfer, dan kepada siapa | Dari instalasi tepercaya, dengan nama file dan sidik jari aktual setiap ruang kerja: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` `--require evidence` akan keluar dengan kode 2 kecuali sidik jari cocok dan waktu eksternal dari pihak ketiga mencakup catatan terakhir; titik pemeriksaan berfungsi sebagai pemeriksaan pendukung. Pertahankan hasil verifikasi yang sebenarnya dan artefak asli. Ekspor catatan ruang kerja dari Case Board bersama dengan materi sumber yang dikutip. Kumpulkan temuan lintas ruang kerja di direktori kasus tingkat atas; setiap artefak TgWitness memiliki tanda tangan dan prosedur verifikasi tersendiri. ## Sesuaikan penyelidikan | Kasus | Lacak | Sampaikan | | --- | --- | --- | | Sengketa pesanan/pembayaran yang ditangani oleh bot | Pengumuman entri → pratinjau tautan yang disimpan → parameter awal bot → versi pesan dan keyboard → tanda terima panggilan balik panel → tindak lanjut pribadi/grup | Garis waktu penawaran/respons yang diamati dan sumber yang terverifikasi; konfirmasi pembayaran berasal dari catatan pembayaran | | Pesan yang dihapus setelah terjadinya insiden | Semua obrolan yang terpengaruh → salinan asli/suntingan yang disimpan → hasil penghapusan atau tidak ditemukan saat diperiksa ulang → media yang disimpan → cakupan dan perspektif akun lainnya | Versi yang disimpan dan interval yang tidak diketahui secara eksplisit; tidak ada aktor penghapusan yang dibuat-buat | | Seorang peserta mengganti nama di berbagai obrolan | ID pengirim numerik → riwayat nama/nama pengguna → balasan → obrolan lain yang diamati → tujuan/file yang disebutkan | Garis waktu aktivitas akun Telegram dengan tautan ke catatan sumbernya | [Referensi koleksi](https://phishdestroy.io/tgwitness/id/docs/reference/collection/) · [Verifikasi profil orang](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#people-profiles) · [Penyerahan bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#investigation-handoff) · [Validasi telah selesai](https://phishdestroy.io/tgwitness/id/docs/reference/verification/) --- # Telegram · Fitur dan cakupan Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/features/ Model pengumpulan saat ini, alur kerja multi-akun, ekspor, dan batasan operasional TgWitness. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Model pengumpulan saat ini, alur kerja multi-akun, ekspor, dan batasan operasional TgWitness. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Referensi proyek](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Referensi proyek](https://phishdestroy.io/tgwitness/assets/chapter-project.svg?v=f8e31208f561) TgWitness melestarikan percakapan Telegram yang dapat diakses oleh akun yang terhubung, mencatat perubahan yang teramati, dan menyiapkan ekspor yang dapat diverifikasi. Referensi ini menjelaskan model pengumpulan, alur kerja saat ini, dan batas-batasnya. **Di halaman ini** - [Aplikasi mandiri](https://phishdestroy.io/tgwitness/id/docs/reference/features/#standalone-application) - [Penyelidikan bersama](https://phishdestroy.io/tgwitness/id/docs/reference/features/#shared-investigations) - [Alat arsip](https://phishdestroy.io/tgwitness/id/docs/reference/features/#archive-tools) - [Fitur tambahan opsional](https://phishdestroy.io/tgwitness/id/docs/reference/features/#optional-extras) - [Protokol dan sumber pribadi](https://phishdestroy.io/tgwitness/id/docs/reference/features/#protocol-and-private-sources) - [Akun ganda](https://phishdestroy.io/tgwitness/id/docs/reference/features/#multiple-accounts) - [Penangkapan dan atribusi](https://phishdestroy.io/tgwitness/id/docs/reference/features/#capture-and-attribution) - [Kapasitas dan batasan Telegram](https://phishdestroy.io/tgwitness/id/docs/reference/features/#capacity-and-telegram-limits) - [Keandalan dan pemulihan](https://phishdestroy.io/tgwitness/id/docs/reference/features/#reliability-and-recovery) - [Model bukti](https://phishdestroy.io/tgwitness/id/docs/reference/features/#evidence-model) - [Ekspor, penerapan, dan serah terima](https://phishdestroy.io/tgwitness/id/docs/reference/features/#export-deployment-and-handoff) - [Kriteria rilis stabil](https://phishdestroy.io/tgwitness/id/docs/reference/features/#stable-release-criteria) ## Aplikasi mandiri TgWitness memiliki proses instalasi, direktori data, dan siklus rilisnya sendiri. Antarmuka web yang disertakan menangani pengaturan dan peninjauan; catatan yang diekspor dapat digunakan secara mandiri. Operator menghubungkan akun-akun mereka, memilih sumber yang dapat dilihat oleh masing-masing, dan memperoleh jurnal pengamatan yang tersimpan. Panel tersebut menampilkan konten, perubahan yang tersimpan, asal-usul pengamatan, dan celah yang diketahui. Penyelidik lain dapat memverifikasi materi yang diekspor. Panel ini membedakan antara otorisasi akun, akses ke sumber, aktivitas pengumpul, dan cakupan yang terekam. Tinjau status-status tersebut secara bersamaan saat mengevaluasi interval dengan sedikit pesan atau masalah koneksi. ## Penyelidikan bersama Seorang administrator dapat menerbitkan [token akses](https://phishdestroy.io/tgwitness/id/docs/reference/access/) yang dibatasi pada ruang kerja dan obrolan individu, dengan izin per tindakan, pembatasan IP, masa berlaku, batas masuk serta kontrol sesi. Seorang peninjau dengan akses baca-saja dapat memeriksa suatu kasus tanpa perlu mendapatkan otorisasi Telegram atau kunci panel utama. Akses yang dibatasi pada obrolan tetap terpisah dari pengaturan tingkat akun dan ekspor jurnal lengkap. MTProxy otomatis menjaga rute Telegram yang berfungsi dari empat sumber publik atau katalog operator. [Mode IP](https://phishdestroy.io/tgwitness/id/docs/reference/connection/#ip-modes) menentukan apakah kegagalan harus menunggu proxy lain atau dapat menggunakan rute langsung yang secara eksplisit diizinkan. Permintaan HTTP eksternal memiliki rute terpisah dan tombol nonaktif. ## Alat arsip [Pengambilan riwayat](https://phishdestroy.io/tgwitness/id/docs/reference/history/), [pencarian dan analisis arsip](https://phishdestroy.io/tgwitness/id/docs/reference/analysis/), [MCP baca-saja](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/), [OCR/transkripsi lokal](https://phishdestroy.io/tgwitness/id/docs/reference/media-analysis/), dan [webhook keluar](https://phishdestroy.io/tgwitness/id/docs/reference/webhooks/) telah disertakan sejak versi 0.7.1. Laporan analitis dan teks yang dikenali tetap terpisah dari peristiwa yang ditangkap. [Case Board](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/) menambahkan penanda yang tertaut ke sumber, kutipan, catatan, dan koleksi di dalam ruang kerja. [Pembuat](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/) [laporan](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/) memilih materi, bagian, dan salah satu dari delapan desain untuk ekspor HTML/PDF yang didukung. ## Fitur tambahan opsional Pengaturan harian adalah akun → sumber → pengamatan. **Alat Lainnya → Ekstra** adalah tujuan terpisah untuk penangkapan independen, penyimpanan, tujuan dan tingkat perlindungan, pemberitahuan, bukti dan cadangan, server yang selalu aktif, bot saksi Telegram, dan pemeriksaan kode. Masing-masing menyebutkan ketersediaan dan persyaratannya sebelum menampilkan pengaturan. Memilih kartu akan membuka petunjuk; hal ini tidak mendaftarkan atau memulai layanan. Pengaturan bot terdiri dari tiga langkah: buat akses baca-saja, pilih pengaturan publikasi, dan jalankan di host saksi. Opsi jaringan dan publikasi, koneksi yang ada, serta perintah verifikasi diungkapkan sesuai permintaan. Konfigurasi yang diunduh berbeda dari saksi yang sedang berjalan. Mengganti fitur tambahan akan mempertahankan draf; perubahan akun dan penguncian akan menghapus token sementara dan formulir. Panduan bawaan mencakup petunjuk peluncuran. [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md), yang dibuka dari Exports, meluncurkan pengumpul yang disematkan dari fork Anda, merekam satu obrolan, dan menghasilkan serah terima terenkripsi dengan riwayat alur kerja. ## Protokol dan sumber-sumber rahasia **MTProto adalah protokol Telegram; Telethon adalah pustaka Python yang digunakan TgWitness untuk berkomunikasi menggunakan MTProto.** Keduanya bukanlah metode koneksi alternatif. Proses pengumpulan data menggunakan MTProto; saksi opsional menerbitkan pemeriksaan yang ditandatangani melalui Bot API. Setiap ruang kerja memiliki klien yang berwenang dan aliran pembaruan akunnya sendiri. TgWitness memilih pengamatan dari sumber-sumber yang telah dikonfigurasi dan mengajukan permintaan terpisah secara eksplisit untuk fungsi-fungsi seperti penangkapan riwayat dan pengunduhan media. Sumber pribadi tidak memerlukan nama pengguna publik. Jenis rekan Telegram dan ID numerik adalah pengidentifikasi; judul dan nama pengguna dapat berubah. Akses bergantung pada keanggotaan dan izin yang ada. TgWitness tidak secara otomatis bergabung dengan sumber atau melewati persetujuan bergabung. Hash akses dari akun lain bukanlah token akses universal. Model pengumpulan data harus memperhitungkan riwayat tersembunyi sebelum bergabung, peran peserta/admin, pencabutan sesi, penghapusan atau perubahan izin, migrasi dari grup ke supergrup, topik/forum, diskusi yang tertaut, identitas saluran, dan lampiran yang tidak tersedia. Tidak semua kombinasi telah diuji secara langsung. Visibilitas sumber diperiksa saat pengumpul dimulai. Jika ada sumber yang hilang dari hasil dialog yang dibatasi, hal itu berarti **akses belum dikonfirmasi**, bukan penghapusan yang terbukti. Satu sumber yang tidak tersedia tidak menghalangi pengamatan terhadap sumber lain yang dapat diakses. Jangan pernah menempatkan tautan undangan atau sesi asli di fixture publik. ## Beberapa akun Panel ini mendukung sejumlah **ruang kerja**, masing-masing dengan: - Otorisasi, brankas terenkripsi, dan rute koneksi. - Jurnal SQLite dan identitas penandatanganan Ed25519. - Sumber terpilih, antrian media, dan pengaturan penangkapan. - Status pemantauan, kesalahan, titik pemeriksaan, dan ekspor. Mengganti ruang kerja yang ditampilkan tidak akan menghentikan pengumpul lainnya. Otorisasi akun ganda di seluruh ruang kerja akan ditolak. Jurnal yang sudah terikat pada satu akun Telegram tidak dapat dialihkan ke akun lain; namun, menghubungkan kembali akun yang sama diperbolehkan. Hal ini menjaga identitas akun dan cakupan ID pesan yang relevan. Aplikasi ini tidak menetapkan jumlah ruang kerja yang tetap. Setiap ruang kerja menjalankan tugas-tugas pengumpulnya sendiri untuk pemantauan koneksi, pengunduhan media, pemeriksaan ulang, dan penerimaan obrolan baru di dalam proses Python dan loop peristiwa yang dibagikan. Laju pemrosesan bergantung pada beban kerja. Untuk isolasi proses, gunakan instalasi, port, dan direktori data yang terpisah. Tetapkan sumber yang dapat diakses oleh setiap akun. Akun yang berbeda mungkin mengamati grup yang sama, tetapi pengamatan mereka tetap terpisah dan mempertahankan asal-usulnya. Dua akun pada satu mesin yang dikendalikan oleh operator bukanlah dua saksi independen. **Ekspor grup** menggabungkan ZIP ruang kerja yang ditandatangani secara terpisah dengan daftar file yang ditandatangani yang berisi ID ruang kerja, hash, dan sidik jari kunci penandatanganan mereka. Setiap jurnal mempertahankan batasannya sendiri. Bangun garis waktu gabungan lintas ruang kerja dalam catatan kasus atau alat analisis, dengan tetap mempertahankan referensi sumber tersebut. ## Perekaman dan atribusi Sumber menyediakan pengaturan per akun untuk pesan baru, pengeditan, penghapusan, reaksi, dan keanggotaan. Pengaturan default menyimpan semua kategori atau pesan/pengeditan/penghapusan. Kebijakan ini berlaku untuk grup yang dipilih di ruang kerja, tetap berlaku setelah restart, dan ditandatangani dengan perubahan sebelum/sesudah. Pengaturan default menyimpan semua kategori. Menonaktifkan suatu kategori tidak menghapus catatan lama; mengaktifkannya kembali tidak memulihkan peristiwa yang terlewat. Catatan operasional, peristiwa layanan grup lainnya, dan cuplikan riwayat eksplisit bersifat terpisah. Objek Telegram yang ditangkap mungkin tetap menyimpan metadata yang tertanam terlepas dari pengaturan pembaruan terpisah. Belum ada penggantian kategori per grup. | Materi | Tercatat saat ini | Batasan | | --- | --- | --- | | Pesan | Teks, ID rekan/pesan, metadata pengirim, balasan, dan amplop pembaruan asli | Disimpan sebagai pengamatan yang terlihat di akun dan ditandatangani oleh pengumpul | | Edit | Versi yang baru diamati, versi yang direkam sebelumnya, waktu penerimaan, dan tanggal pengeditan yang diberikan | Pembaruan pesan dan entri log admin yang tersedia mempertahankan bidang atribusi masing-masing | | Penghapusan | Pemberitahuan Telegram, waktu penerimaan, dan konten yang telah direkam sebelumnya | Waktu aktor dan waktu tindakan sumber dipertahankan jika disediakan oleh catatan log admin terpisah | | Pemberitahuan penghapusan di tingkat akun | Pemberitahuan asli; catatan yang telah diselesaikan mencakup obrolan yang disimpan dan metode korelasi | Diperlukan tepat satu kecocokan obrolan pribadi atau grup biasa yang telah disimpan sebelumnya dalam cakupan; ID lainnya tetap berada di `deletion.unscoped`. ID saluran dan supergrup dikecualikan dari korelasi ini | | Reaksi | Jumlah hitungan yang ditampilkan dan identitas terbaru yang terlihat | Daftar reaktor yang lengkap memerlukan kueri terpisah; saluran mungkin menyembunyikan identitas | | Keanggotaan | Pesan layanan dan pembaruan yang dikirimkan kepada peserta | Visibilitas bergantung pada peran dan jenis obrolan; keanggotaan dilaporkan berdasarkan peristiwa yang telah dikirimkan | | Tindakan admin | Pembaruan yang relevan dan cuplikan log admin dalam ekspor obrolan saluran/supergrup | Proses ekspor membaca log jika tersedia untuk akun admin yang melakukan ekspor | | Lampiran | Deskripsi versi asli, jumlah byte yang diunduh/SHA-256, dan hasil upaya | Versi asli tetap disimpan; versi yang lebih baru tidak pernah menggantikannya | | Sejarah | Cuplikan eksplisit dari pesan-pesan yang saat ini terlihat | Perekaman langsung menyimpan versi sebelumnya dan pemberitahuan penghapusan | | Proses pengumpulan | Mulai/berhenti, detak jantung, kesalahan, pengaturan, cakupan, dan tanda terima eksekusi yang ditandatangani | Inventaris lokal; GitHub dan TDX menambahkan [pemeriksaan lingkungan yang independen](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope) | Antarmuka tersebut mencantumkan nama akun yang tercantum dalam peristiwa sumber dan mempertahankan nama serta nama pengguna yang diamati. Jika peristiwa tersebut tidak mencantumkan pelakunya, laporan akan membiarkan kolom tersebut kosong. ## Kapasitas dan batasan Telegram Kapasitas ditentukan per penerapan. Hal ini bergantung pada puncak peristiwa per detik, volume dan ukuran lampiran, tambahan RPC, akun aktif, latensi disk/ruang kosong, kondisi jaringan, batasan Telegram, kelambatan yang dapat diterima, dan kedalaman antrian. Telegram membedakan pengiriman pasif dari polling singkat aktif. Dokumentasi pembaruannya menjelaskan panggilan tambahan `updates.getChannelDifference` untuk saluran terbuka dan supergrup, serta merekomendasikan maksimal **sepuluh sumber yang dipolling secara singkat secara bersamaan**. Hal ini berlaku untuk polling singkat; jumlah grup yang dipilih ditetapkan secara terpisah. | Mode | Tujuan | Status | | --- | --- | --- | | Pengamatan standar | Mencatat pembaruan yang dikirimkan dari sumber-sumber terpilih | Telah diterapkan | | Pemeriksaan ulang prioritas | Sumber yang diberi tanda bintang menggunakan interval yang dapat dikonfigurasi sendiri dan memiliki prioritas dalam setiap proses pemeriksaan ulang yang dibatasi | Diimplementasikan dengan fitur pencarian riwayat dan pesan | Bintang prioritas mengontrol pemeriksaan ulang ini. Pemeriksaan singkat tambahan melalui ``updates.getChannelDifference` ` tidak ditampilkan sebagai mode pengguna terpisah. Polling frekuensi tinggi yang sewenang-wenang, mengabaikan FloodWait, atau mengasumsikan kapasitas linier dari akun tambahan bukanlah model penentuan ukuran yang valid. Batas default adalah 1,000 dialog pertama yang terdaftar, hingga 500 pesan per snapshot riwayat, 1–2,000 MiB per berkas yang dikumpulkan berdasarkan jenis, dan 4 GiB konten ZIP yang ditandatangani dan tidak terkompresi; masing-masing dapat diubah per ruang kerja, ukuran berkas di bawah **More tools → Sources → Recording**, dan yang lainnya di bawah **More tools → Parameters**. Ekspor tidak memiliki batasan jumlah peristiwa yang tetap. Fitur fallback browser dibatasi hingga 128 MiB secara default; CLI streaming memiliki batas transfer yang dapat dikonfigurasi, 5 GiB secara default. ## Keandalan dan pemulihan Perilaku yang diimplementasikan meliputi WAL SQLite/transaksi sinkron; penulisan pesan dan tugas media secara atomik; tugas yang persisten dan penundaan percobaan ulang; deskriptor versi asli; upaya ulang terbatas; FloodWait media yang disimpan; unduhan media di luar penantian jaringan peristiwa teks; ekspor awalan stabil sementara penulisan selanjutnya berlanjut; pengaturan atomik dan catatan audit; pelestarian otorisasi yang berfungsi setelah kegagalan login pengganti; isolasi ruang kerja tambahan yang rusak; upaya koneksi ulang eksplisit; pelaporan kehilangan otorisasi yang terpisah; serta deteksi perubahan waktu jam dinding menggunakan jam monotonik. Posisi (pts/qts/seq) akun dan saluran disimpan dan dilanjutkan setelah restart, dan obrolan yang dipantau diverifikasi ulang secara berkala; lihat [format bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#durable-collection-and-process-receipts-02). Penyimpanan posisi secara berkala bukanlah konfirmasi penerimaan jurnal yang bersifat atomik dan tanpa kehilangan data. Setiap awal proses mencatat posisi awal (head) sebelumnya dan batas offline. Riwayat saat ini tidak dianggap sebagai perbaikan celah. Kapasitas penyimpanan perbedaan Telegram terbatas; `differenceTooLong` tidak dapat merekonstruksi seluruh konten yang hilang. Celah yang tidak dapat dipulihkan harus tetap dinyatakan secara eksplisit meskipun snapshot riwayat berikutnya berhasil. ## Model bukti Setiap peristiwa mencatat urutan, waktu pengamatan UTC lokal, waktu sumber (jika tersedia), jenis, sumber, pelaku (jika tersedia), muatan asli, hash sebelumnya, dan tanda tangan. Pengamatan pesan juga menyimpan informasi akun pengumpul dan konteks eksekusi. Tanda terima proses yang ditandatangani berisi ID eksekusi acak; versi dependensi TgWitness/Python/OS; nilai SHA-256 berkas sumber dan sidik jari agregat; akun awal, ruang lingkup, dan pengaturan; pembacaan UTC/monotonik; serta bagian awal jurnal sebelumnya. Perubahan pengaturan, mulai/berhenti, dan kesalahan dicatat dalam jurnal yang sama. Titik pemeriksaan disimpan saat startup, setiap lima menit selama pemantauan (dapat diubah), dan saat penghentian teratur. Titik pemeriksaan lokal yang disimpan dapat mendeteksi rollback ke awalan jurnal yang lebih awal. | Mekanisme | Apa yang ditetapkan | | --- | --- | | SHA-256 berkas | Byte-byte tersebut cocok dengan ringkasan yang diketahui | | Rantai hash peristiwa | Mencatat urutan/hubungan relatif terhadap batas yang diketahui | | Ed25519 | Tanda tangan menggunakan kunci tertentu | | Titik pemeriksaan yang disimpan secara independen | Materi selanjutnya sesuai dengan batasan yang dipertahankan | | Pengukuran berkas program | Laporan mandiri pengumpul mengenai berkas yang diukur | | Tanggapan TSA independen yang valid | Keberadaan byte tertentu pada waktu TSA berdasarkan asumsi kepercayaan eksplisit | Penyiapan permintaan RFC 3161 dan verifikasi respons diterapkan tanpa OpenSSL. Mode bukti juga mengirim hash checkpoint ke layanan stempel waktu yang dikonfigurasi. Simpan dan verifikasi respons otoritas untuk menetapkan jangkar waktu yang independen. Lihat [TIMESTAMP.md](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/). Pertahankan titik pemeriksaan secara independen, kendalikan akses ke kunci penandatanganan, simpan catatan transfer, dan verifikasi ekspor menggunakan perangkat lunak tepercaya. [Ruang lingkup](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope) [verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope) menjelaskan bagaimana pemeriksaan-pemeriksaan tersebut saling melengkapi dan asumsi kepercayaan mana yang berlaku. ## Ekspor, penerapan, dan serah terima Sebuah berkas ZIP yang ditandatangani berisi JSONL, CSV, HTML asli, lampiran yang disimpan, hash, manifest yang ditandatangani, dan alat verifikasi praktis. Berkas ini mencakup satu ruang kerja dan awalan jurnal lengkap yang tetap. Filter pencarian panel tidak menghapus catatan secara diam-diam. Kunci rahasia, token, dan sesi Telegram tidak disertakan; pengamatan asli mungkin masih berisi informasi pribadi dan metadata Telegram. Simpan ringkasan ZIP, sidik jari tepercaya, titik pemeriksaan, tanda terima proses, dan catatan serah terima secara terpisah. Gunakan verifikator dari instalasi tepercaya, daripada hanya mempercayai kode yang dapat dieksekusi semata-mata karena muncul dalam ZIP yang diperiksa. Antarmuka browser disertakan secara lokal tanpa Node.js, CDN, atau font eksternal. Satu token operator mengontrol instalasi. Akses jarak jauh memerlukan HTTPS atau terowongan SSH. Definisi Python asli dan kontainer disertakan, dengan contoh layanan di bawah [folder deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md); pemeriksaan platform yang dijalankan tercantum secara terpisah. Ruang kerja default menggunakan direktori data root; ruang kerja tambahan menggunakan `profiles//`. Pencadangan memerlukan proses yang dihentikan dan kumpulan data/kunci yang lengkap. Berkas ZIP bukti bukanlah cadangan aplikasi. Rahasia dapat menggunakan kunci utama eksternal untuk direktori data baru; enkripsi jurnal/media disediakan oleh disk/volume operator. Lihat [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) dan [OPERATIONS.md](https://phishdestroy.io/tgwitness/id/docs/reference/operations/). ## Kriteria rilis stabil Sebelum rilis stabil, jelaskan: 1. Grup pribadi, supergrup, forum, dan saluran yang sebenarnya dengan peran anggota/admin serta riwayat yang tersembunyi/terlihat, termasuk login/2FA, pencabutan, dan kehilangan akses. 2. Pengeditan, penghapusan, reaksi, keanggotaan, dan media yang dikendalikan terhadap tindakan yang diketahui. 3. Kegagalan proses/host, kegagalan disk/disk penuh, referensi berkas yang kedaluwarsa, FloodWait, kehilangan koneksi jaringan, berkas yang rusak, dan rollback basis data. 4. Penggunaan multi-akun secara berkelanjutan dengan latensi terukur, antrian, memori, dan ruang disk, termasuk sumber yang tenang dan berisik secara bersamaan. 5. Terjadinya gangguan antara kemajuan status MTProto dan penerimaan jurnal. 6. Instalasi bersih pada matriks sistem operasi/kontainer yang dituju serta pemulihan cadangan yang terverifikasi. 7. Tinjauan independen mengenai keamanan, tanda tangan, serta klaim atribusi dan bukti. Akses panel yang dibatasi ruang lingkup dijelaskan dalam [bagian akses dan izin](https://phishdestroy.io/tgwitness/id/docs/reference/access/). Sejak versi 0.6, TgWitness mendukung impor TData akun tunggal yang dibatasi dan file akun sebagaimana dijelaskan dalam [ACCOUNTS.md](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/). Tinjau ketentuan API Telegram sebelum publikasi. Referensi penelitian dan temuan platform terdapat dalam [RESEARCH.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md). --- # Telegram · Referensi Case Board Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/case-board/ Bookmark, sorotan tepat, potongan tindakan, diskusi, akses terbatas, dan riwayat anotasi yang ditandatangani yang digunakan oleh Case Board. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Bookmark, sorotan tepat, potongan tindakan, diskusi, akses terbatas, dan riwayat anotasi yang ditandatangani yang digunakan oleh Case Board. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penyelidikan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/) ![Penyelidikan](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Case Board memberikan tim investigasi tampilan kerja bersama atas materi yang disimpan. Tandai sebuah pengamatan, sorot bagian tertentu, simpan serangkaian tindakan, dan diskusikan dengan rekan kerja. Kartu-kartu tersebut mempertahankan referensi sumber dan riwayat revisi yang ditandatangani. Anotasi tim tetap berada di ruang kerja, dan dapat dibedakan secara terpisah dari pengamatan Telegram asli. [Model bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) · [Akses](https://phishdestroy.io/tgwitness/id/docs/reference/access/) · [Laporan](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/) ![Umpan investigasi sintetis](https://phishdestroy.io/tgwitness/assets/case-board.png?v=da27ef9c5b51) **Di halaman ini** - [Bekerja dengan suatu kasus](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/#work-with-a-case) - [Izin](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/#permissions) - [Kontrak yang disimpan](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/#stored-contracts) - [API dan ekspor](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/#api-and-exports) - [Batas pengoperasian](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/#operating-limits) ## Bekerja dengan suatu kasus Buka **Lebih Banyak alat → Papan Kasus** dalam mode Standar atau Ahli. Bahasa yang digunakan mengikuti panel. Gunakan **tombol Ke papan** di samping catatan jurnal atau pesan obrolan yang disimpan, atau sorot catatan tersebut dan tekan **B**. Penanda ditambahkan ke Kotak Masuk dengan satu klik. Edit judul, label, dan catatannya, atau pindahkan ke koleksi. Kartu yang diubah akan menambahkan revisi yang ditandatangani; menghapusnya akan mempertahankan riwayatnya. Untuk kasus pertama, pilih pengumpulan data dan tambahkan catatan yang menjawab satu pertanyaan. Gunakan komentar untuk meninjau interpretasi, lalu gunakan **Presentation** untuk menelusuri kartu dan konteks sumber. Pilih materi Case Board secara terpisah di [Report Studio](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/) saat menyiapkan hasil akhir. Menyimpan potongan data tidak secara otomatis mengonfigurasi filter data laporan. Pilih teks di dalam pesan obrolan yang disimpan untuk menampilkan **Highlight → board**. Pilih warnanya dan tambahkan catatan. Server memeriksa kutipan yang tepat dan versi yang disimpan, termasuk emoji, teks RTL, dan tanda penggabungan. Antarmuka tidak memetakan pilihan melalui teks yang disamarkan atau diubah. Tekan Shift sambil mengklik dua catatan dalam satu obrolan untuk **memotong (Slice) di antara keduanya**, gunakan **Slice berdasarkan waktu**, atau simpan filter obrolan saat ini, periode, dan jenis peristiwa di Journal. Potongan yang disimpan memiliki predikat otoritatif sendiri: membukanya di Journal juga menerapkan filter obrolan ganda, batas jumlah pesan, dan filter aktor. **Tampilkan catatan yang ditambahkan sejak penanda** mengisolasi penambahan-penambahan selanjutnya. Mengubah filter Journal akan keluar dari potongan tersebut. Dari People, **Potong tindakan orang ini** menggunakan ID pelaku yang tercatat; fitur ini tidak mengasumsikan bahwa penulis pesan telah mengedit, menghapus, atau bereaksi terhadap sebuah pesan. Kotak dialog "slice" menampilkan pratinjau jumlah sebelum mengizinkan pembuatan. "`all`" mencakup semua jenis data yang direkam, termasuk tangkapan layar, pengeditan, penghapusan, reaksi, pembaruan keanggotaan/layanan, tindakan sendiri, tombol, hasil media, pesan yang dipulihkan, dan jenis peristiwa di masa depan. Pilihan ini menggambarkan pengamatan yang disimpan. Pemberitahuan penghapusan obrolan yang tidak dikenal merupakan konteks terpisah, hanya tersedia bagi pengguna dengan akses ke seluruh ruang kerja, dan tidak pernah dikaitkan dengan salah satu obrolan yang dipilih. Koleksi memiliki cakupan obrolan yang ditentukan. Cakupan kosong berarti seluruh ruang kerja. Sebuah koleksi tidak dapat berisi kartu di luar cakupannya; peserta yang dibatasi obrolan tidak dapat membaca koleksi yang lebih luas. Kotak masuk adalah koleksi virtual untuk kartu yang belum ditugaskan. Pencarian dan filter hanya mencakup kartu yang terlihat; utas dan sebutan mewarisi akses dari kartu induknya. Komentar yang dihapus memiliki tanda penghapusan dalam diskusi. Riwayat penampil tidak dicatat. **Presentasi** membuka semua kartu dalam koleksi yang dipilih, dengan tampilan Kartu, Konteks Sumber, dan Komentar Tim, serta kontrol keyboard Sebelumnya/Berikutnya. Fitur ini tidak menyediakan kontrol pengeditan. Umpan biasa dibagi menjadi beberapa halaman; presentasi memuat daftarnya per halaman dan menampilkan detail satu kartu pada satu waktu. ## Izin Semua operasi memerlukan akses ke `view`, ruang kerja/ruang obrolan, dan `board.read`. `board.write` menambahkan kartu, komentar, memindahkan, serta mengubah status menjadi "terbuka" atau "telah ditinjau". `board.manage` memungkinkan pengelolaan koleksi, status "dikonfirmasi" atau "ditolak", serta revisi atau penghapusan kartu milik orang lain. Status merupakan keputusan tim, bukan hasil verifikasi kriptografis. Akses preset formulir: Peninjau = baca; Analis = baca/tulis; Operator = baca/tulis/kelola, selain izin yang sudah ada. Pemberian izin yang sudah ada tidak secara otomatis memperoleh hak baru. Administrator utama memiliki semua hak akses, dan memposting sebagai **Administrator Utama**. Gunakan pemberian hak akses berlabel untuk atribusi. Daftar penyebutan hanya mencakup akses saat ini yang dapat membaca kartu induk secara lengkap. Sebuah izin untuk obrolan A tidak dapat memperoleh kartu atau potongan untuk A+B, bahkan dengan menebak ID-nya atau memberikan `target.chat_id` palsu. Metadata target diselesaikan dari hash peristiwa yang ditandatangani di server. Koleksi, jumlah diskusi, kartu terkait, dan pemberitahuan langsung disaring sebelum respons. exportasi memerlukan izin `export` serta `board.read`; eksportir yang sudah ada tanpa akses ke papan akan mendapatkan arsip bukti biasa tanpa catatan tim. SSE memeriksa kembali izin yang berlaku sebelum setiap batch. ## Kontrak yang disimpan Seperti pengamatan, anotasi ditulis secara transaksional ke tabel SQLite yang hanya dapat ditambahkan (append-only) di ruang kerja. `annotations.jsonl` adalah ekspor kanonik persisnya dari snapshot baca yang sama dengan `events.jsonl`. Tidak ada penyimpanan anotasi lain yang bersaing dan tidak ada peristiwa jurnal `board.activity`. Setiap baris harus berisi tepat: ``` { "seq": 1, "at": "2026-11-02T14:00:00.000+00:00", "access_id": "admin", "access_label": "Main administrator", "kind": "board.bookmark", "payload": {"id": "32 lowercase hex digits", "target": {"event_hash": "64 lowercase hex digits"}}, "previous_hash": "64 zeroes for the first record", "hash": "SHA-256 described below", "signature": "base64 Ed25519 signature" } ``` Contoh singkat di atas menggambarkan "envelope"; muatan sebenarnya mencakup nilai default model mereka dan bidang target yang diselesaikan oleh server. Skema permintaan API terdapat di [`tgwitness/schemas`](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/schemas/board-bookmark.json), dihasilkan dari model Pydantic waktu berjalan oleh skrip `python tools/build_board_schemas.py`. Bidang permintaan tambahan akan ditolak. ID dihasilkan di sisi server jika diabaikan. Keterangan penulis, waktu, snapshot, dan tanda tangan tidak dapat disediakan oleh pemanggil. ID pemberian yang diberi nama mengikuti format 16-heksadesimal yang sudah ada di Access; ID kartu berformat 32-heksadesimal. JSON kanonik menggunakan UTF-8, kunci objek diurutkan, tanpa spasi di antara token, Unicode tanpa escaping, dan tanpa NaN/tak terhingga. Hash anotasi adalah SHA-256 dari objek kanonik yang berisi `format: "tgwitness-annotations-v1"` dan ketujuh bidang envelope hingga `previous_hash`. Tag format ini memisahkan domain hash-nya dari pengamatan. Tanda tangan menggunakan Ed25519 atas 32 byte hash mentah. Urutan dimulai dari 1. Revisi mempertahankan ID kartu dan menyebutkan hash anotasi sebelumnya dalam "`supersedes`"; revisi tidak dapat mengubah cakupan obrolan. Pemindahan, status, dan penghapusan merupakan catatan terpisah. Tabel SQLite menolak perintah UPDATE dan DELETE. `case-board.json` berisi `{statement, signature}`. Pernyataan kanonik ditandatangani oleh kunci ruang kerja dan berisi `format: "tgwitness-case-board-v1"`, `public_key`, `created_at`, `journal_head`, `meaning`, dan `state`. State adalah replay deterministik: `annotations_head`, sebuah array `items` yang terurut (koleksi, kartu, komentar termasuk tombstone), dan `status_history`. Item-item mempertahankan hash anotasi terakhir, urutan, penulis, dan waktunya, serta pencipta asli dan waktu pembuatan di seluruh revisi. Pemutaran ulang memeriksa revisi, induk, referensi koleksi, dan ID tindakan duplikat. ``manifest.json`` dan titik pemeriksaan baru juga mengikat ``annotations_head``. Simpan titik pemeriksaan secara terpisah untuk mendeteksi pemotongan atau penulisan ulang dengan kunci penandatanganan yang disalin. ### Versi teks `range.start` adalah offset titik kode Unicode berbasis nol, `length` adalah jumlah titik kode positif, dan `quote` harus sama persis dengan substring dari `payload.text` atau `payload.caption` pada peristiwa target. Tidak diterapkan NFC/NFKC, case folding, atau normalisasi grafem. Potongan string Python dan `Array.from(text)` JavaScript menerapkan pengindeksan yang sama. Kombinasi tanda dan emoji ZWJ mungkin menempati beberapa titik kode. ``range.version`` adalah hash peristiwa target, bukan versi pesan saat ini atau offset entitas UTF-16 Telegram. Pengeditan selanjutnya tidak pernah memindahkan sorotan secara otomatis. ### Identitas dan waktu potongan `query` menerima tepat satu `chat_id` atau `chat_ids` yang tidak kosong, rentang `from`/`to` inklusif opsional, batas ID pesan inklusif (hanya satu obrolan), `kinds: "all"` atau jenis wildcard eksak/awalan, `actors` eksplisit, `search`, `hide_system`, dan `include_unscoped`. Kelompok jenis jurnal diperluas menjadi predikatnya yang tepat. Pencarian menggunakan pencarian muatan jurnal yang di-NFC/case-folded tanpa mengubah teks sumber yang ditandatangani. Tanggal memerlukan zona waktu dan dinormalisasi ke UTC. Tanggal menyaring **`observed_at`**. ``source_at`` dari Telegram ditampilkan secara terpisah. Penghapusan tanpa cap waktu sumber tidak memiliki waktu penghapusan yang dibuat-buat. Catatan terlambat yang diamati di luar interval waktu tidak dimasukkan ke dalamnya; potongan `message-ID` dapat mencakup penghapusan yang lebih baru untuk `message-ID` tersebut. `snapshot` menetapkan waktu pembuatan, batas urutan/hash jurnal, jumlah kecocokan, urutan pertama/terakhir, dan `result_hash`. Yang terakhir ini adalah SHA-256 dari array JSON kanonik UTF-8 dari hash peristiwa yang cocok yang diurutkan secara leksikografis, termasuk `[]` untuk potongan kosong. Snapshot ini juga memuat jumlah jenis yang tepat dan miniatur waktu pengamatan dengan 24 bin. Sebuah potongan (slice) menyimpan kueri, bukan catatan sumber duplikat. Saat diekspor, `board/slices/.json` mencantumkan hash saat ini serta urutan yang ditambahkan/dihapus. Verifikator merekonstruksi hasil asli pada batas pembuatan, kemudian hasil saat ini. Catatan yang ditambahkan dilaporkan sebagai fakta perubahan. Menghapus peristiwa asli akan memutus rantai bukti yang tidak dapat diubah; hal ini tidak diterima secara diam-diam sebagai penghapusan biasa dari sebuah slice. Cuplikan reaksi memiliki daftar aktor terbaru yang tidak lengkap. Penjelajah membandingkan cuplikan yang berdekatan dari obrolan/pesan yang sama, termasuk pendahulu di luar potongan, dan melaporkan selisih jumlah agregat **antara pengamatan**. Aktor terbaru yang hilang tidak dianggap telah menghapus reaksi. Cuplikan pertama tidak memiliki status sebelumnya yang disimpulkan. Pengamatan aktor tetap dikaitkan dengan cuplikan tempat pengamatan tersebut disediakan, bukan dengan waktu tindakan yang dibuat-buat. ## API dan ekspor `GET /api/board`menerima collection/chat/author/label/state/from/to/q/kind/comments, offset/limit dan urutan terbaru/terlama. `GET /api/board/card/{id}`mengembalikan kartu, pratinjau sumber, utas, riwayat status, dan kartu terkait. Subrute peserta mengembalikan pilihan sebutan yang memenuhi syarat. `POST /api/board/{bookmark|highlight|slice|collection|comment|status|move|remove}` menambahkan catatan. `POST /api/board/slice-preview` menghitung kueri. Catatan slice dipaginasikan di `GET /api/board/slice/{id}/records`; perhitungan ulang selalu menggunakan snapshot baca stabil terkini. `/api/stream` yang aktif mengirimkan pemberitahuan `board` tanpa muatan, terpisah dari kursor jurnal. `GET /api/board/export` mengembalikan dokumen yang ditandatangani. Akses terbatas obrolan menerima **pengungkapan** yang ditandatangani dan diberi label dengan jelas, bukan anotasi obrolan lain atau rantai lengkap. File ZIP bukti lengkap berisi `annotations.jsonl`, `case-board.json` yang ditandatangani, dan lampiran JSON potongan. Pengaturan laporan HTML/PDF/JSON memungkinkan pemilihan tanpa papan, penanda/potongan tanpa diskusi, atau kartu dengan komentar. Bagian tersebut secara eksplisit memisahkan pendapat tim dari pengamatan. Filter data laporan juga membatasi catatan yang dapat dibaca; file sumber lengkap yang ditandatangani dalam ZIP bukti tetap utuh. `GET /api/board/slice/{id}/export` menghasilkan cuplikan JSON `tgwitness-board-selection-v1` yang telah ditandatangani; `?format=csv` menghasilkan tabel yang praktis tanpa tanda tangan terpisah. Pertahankan format JSON dan ZIP: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_KEY_SHA256 --board python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 python -m tgwitness.verify case-board.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 ``` Pemeriksaan seleksi mengautentikasi pernyataan yang ditandatangani, catatan sumber yang tepat, dan kelengkapan kueri pada batas yang ditentukan. File ZIP bukti mungkin lebih baru tetapi harus mengandung awalan tersebut. Target yang terputus dilaporkan secara eksplisit. Snapshot potongan asli yang berbeda, anotasi yang diubah, status pemutaran ulang yang tidak cocok, atau sumber yang diubah akan gagal. Arsip lama tanpa anotasi tetap mempertahankan perilaku verifikasi yang ada. Pengalihan secara default diatur ke **Jangan sertakan**. Penyertakan eksplisit menampilkan kartu proyek melalui catatan yang sudah diminimalkan, mengabaikan target yang tidak dapat diakses/dilewati, menyembunyikan sorotan yang teks aslinya telah diminimalkan, membersihkan teks tim dengan aturan penyebutan/kontak yang sama, dan secara opsional mengganti label penyelidik dengan R01, R02… dalam metadata dan kemunculan yang diketahui dalam catatan. `annotations.jsonl` asli tidak diungkapkan. Sidecar dan laporan `tgwitness-case-board-handover-v1` yang ditandatangani berisi materi yang telah diminimalkan yang sama. Jumlah potongan hanya menggambarkan catatan yang diungkapkan, dengan detail aktor snapshot/kueri asli yang disembunyikan. Nama teks bebas yang tidak dikenal oleh alat minimisasi masih memerlukan peninjauan, seperti halnya dalam serah terima biasa. Turunan tersebut memiliki tanda tangannya sendiri; anotasi asli mempertahankan tanda tangannya di arsip lengkap. ## Batasan operasional Parameter mencakup batas lunak sebanyak 10.000 kartu dan 50.000 komentar, halaman potongan hingga 5.000 catatan, serta kontrol pratinjau media. Batas lunak memberikan peringatan tanpa menghapus riwayat. Halaman umpan memuat maksimal 200 kartu. Kutipan potongan JSON mandiri dibatasi hingga 64 MiB; persempit kueri atau gunakan ZIP yang ditandatangani untuk materi yang lebih besar. Verifikator mandiri membatasi pemutaran ulang anotasi hingga 256 MiB. Pemberitahuan komentar eksternal tidak diaktifkan atau diimplementasikan oleh Case Board. Proses penerimaan otomatis fitur ini menggunakan data fiktif dan transportasi Telegram yang disimulasikan untuk memverifikasi penyimpanan, akses, penayangan, dan ekspor. Lihat [ruang lingkup verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope) untuk mengetahui cakupan pemeriksaan bukti. --- # Telegram · Analisis arsip Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/analysis/ Cari pesan yang disimpan, tinjau masukan AI, dan simpan laporan analitis beserta referensi sumbernya. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Cari pesan yang disimpan, tinjau masukan AI, dan simpan laporan analitis beserta referensi sumbernya. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penyelidikan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/) ![Penyelidikan](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Panduan alur kerja](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Gunakan **Jurnal** untuk pencarian lokal tanpa AI; [pencarian teks lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/search/) (pratinjau) mencocokkan bentuk kata, frasa, domain, dan @nama pengguna. Untuk **Alat Lainnya → Tanyakan ke arsip**, aktifkan terlebih dahulu dan konfigurasikan penyedia di **Alat Lainnya → Integrasi**. Pemilih ruang kerja memilih akun; formulir memilih obrolan dan periode pengamatan. Proses pencarian dilakukan secara lokal. Frasa atau domain yang tepat mempersempit hasil pencarian; ID pesan meminta versi yang disimpan. Tinjau kutipan dan buka catatan jurnal atau konteksnya. Tidak ada basis data vektor atau tindakan Telegram otomatis. ## Penyedia layanan dan persetujuan AI dinonaktifkan secara default di setiap ruang kerja. Hanya administrator utama yang dapat mengonfigurasi model, titik akhir (endpoint), kunci API terenkripsi, batas konteks/keluaran, batas waktu, dan kuota permintaan harian. Kunci tersebut tidak pernah dikembalikan ke browser. Biarkan kolom kunci kosong untuk mempertahankan kunci saat ini, atau hapus secara eksplisit. Ollama menggunakan [titik akhir `/api/chat`](https://docs.ollama.com/api/chat) yang terdokumentasi dengan keluaran JSON non-streaming. Alamat defaultnya adalah `http://127.0.0.1:11434` di server TgWitness. Operator dapat mengubahnya menggunakan `TGWITNESS_AI_LOCAL_ENDPOINT`; ini bukanlah alamat yang dikendalikan oleh model. Pasang model yang dipilih sendiri. TgWitness tidak mengunduhnya secara otomatis. Penyedia yang kompatibel mengharuskan URL dasar yang berakhiran `/v1` serta [protokol Chat Completions](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create): `messages`, mode respons JSON, `max_completion_tokens`, dan `choices[0].message.content`. Layanan yang tidak memiliki bidang-bidang ini tidak didukung. Pengujian koneksi mengirimkan teks sintetis dan dihitung dalam kuota permintaan. Setiap permintaan menggunakan rute luar yang dikonfigurasi di ruang kerja. Rute yang diblokir atau MTProxy khusus Telegram merupakan kesalahan; tidak ada upaya ulang langsung. Alamat Ollama lokal yang dikonfigurasi secara sengaja memungkinkan tujuan pribadi. Titik akhir AI loopback memerlukan rute luar “Direct” dari ruang kerja; rute proxy akan ditolak sebelum transmisi. Untuk layanan pribadi lainnya, opsi tujuan pribadi tingkat server yang sudah ada berlaku. Pratinjau menampilkan titik akhir dan rute luar, termasuk host proxy jika berlaku. Mengubah rute tersebut memerlukan pratinjau baru. Sebelum pembangkitan, **data yang dikirim ke model** mencakup permintaan: pertanyaan, kutipan yang diperiksa, jenis peristiwa, waktu pengamatan, dan penanda cakupan. Sesi Telegram, bidang mentah, kunci penyedia, byte lampiran, dan jurnal lengkap bukan bagian dari konteks tersebut. Hapus centang pada sumber yang tidak diinginkan, lalu setujui secara eksplisit pemrosesan. Penyedia eksternal dapat menyimpan konten yang dikirimkan sesuai dengan kebijakan mereka sendiri. Eksekusi lokal berarti titik akhir berada di lokal; layanan yang dikonfigurasi secara terpisah mengikuti konfigurasinya sendiri. Secara global, terdapat paling banyak dua permintaan penyedia yang berjalan bersamaan dan satu per ruang kerja. Pratinjau akan kedaluwarsa setelah sepuluh menit dan dapat menghasilkan satu jawaban. Jumlah token yang dilaporkan oleh penyedia ditampilkan; perkiraan biaya hanya muncul jika tarif input dan output telah dikonfigurasi. Upaya yang gagal juga menghabiskan anggaran permintaan harian. Tidak ada upaya ulang otomatis yang menghabiskan anggaran tambahan. ## Sumber dan batasan Pencarian menggunakan [indeks](https://phishdestroy.io/tgwitness/id/docs/reference/search/#ask-the-archive-and-mcp) [teks](https://phishdestroy.io/tgwitness/id/docs/reference/search/#ask-the-archive-and-mcp) [lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/search/#ask-the-archive-and-mcp) saat sudah selesai: hasil yang paling cocok di seluruh obrolan yang dipilih, termasuk bentuk kata. Pertanyaan tentang perubahan terbaru atau versi suatu pesan, serta pencarian saat indeks sedang dibangun, menggunakan pencarian leksikal terbatas pada catatan terbaru. Pratinjau mencantumkan metode yang digunakan. Pencarian mengembalikan hingga 24 sumber; teks panjang dipotong di sekitar hasil pencocokan. Kutipan yang dipotong dan kumpulan hasil yang tidak lengkap ditandai. Periode tersebut mengacu pada **waktu pengamatan**, bukan klaim bahwa riwayat Telegram sudah lengkap. Peristiwa yang mencakup seluruh ruang kerja tidak disertakan dalam akses yang terbatas pada obrolan. Data yang hilang dijelaskan sebagai tidak ditemukan dalam arsip yang tersedia. Model ini tidak menerima alat apa pun. ID sumbernya diverifikasi berdasarkan catatan yang dipilih, hash diperiksa ulang, dan string yang dikutip harus terdapat dalam catatan tersebut. ID yang tidak dikenal, kutipan yang diubah, dan klaim yang tidak dikutip akan menolak jawaban tersebut. Aplikasi ini membuat tautan; URL yang dihasilkan model tidak digunakan sebagai kutipan. Pemeriksaan ini memastikan keberadaan sumber dan keakuratan kutipan. Tinjau kesimpulan berdasarkan catatan sebelum mengandalkannya. ## Laporan Simpan jawaban yang telah ditinjau sebagai laporan analitis terpisah. Laporan ini mencakup ringkasan model, urutan kronologis yang diamati, tautan dan handle yang diekstraksi, catatan pengeditan/penghapusan, batasan cakupan, serta hash peristiwa sumber. Penyedia, model, titik akhir, waktu, dan versi templat prompt juga disertakan. Identitas apa pun tidak digabungkan secara otomatis. Revisi dan catatan analis disimpan terpisah dari ringkasan model. Laporan disimpan dalam berkas turunan yang terenkripsi, dengan indeks di luar aliran peristiwa yang ditandatangani; peristiwa dan media asli tidak berubah. Hanya pemilik atau administrator yang dapat membuka laporan, dan akses sumber diperiksa kembali. Pengunduhan juga memerlukan izin ekspor. Versi 1 tidak menandatangani laporan atau menyiratkan bahwa kesimpulan model merupakan bukti yang terverifikasi. Batasan: 100 laporan per ruang kerja dan 100 revisi analis per laporan. Untuk OCR manual dan transkrip, lihat [pemrosesan media](https://phishdestroy.io/tgwitness/id/docs/reference/media-analysis/). Untuk akses klien, lihat [MCP](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/). --- # Telegram · Pencarian teks lengkap Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/search/ Temukan pesan yang disimpan berdasarkan bentuk kata, frasa persis, domain, dan @nama pengguna, dengan hasil yang paling sesuai ditampilkan terlebih dahulu, serta indeks yang terikat pada jurnal yang ditandatangani. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Temukan pesan yang disimpan berdasarkan bentuk kata, frasa persis, domain, dan @nama pengguna, dengan hasil yang paling sesuai ditampilkan terlebih dahulu, serta indeks yang terikat pada jurnal yang ditandatangani. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penyelidikan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/) ![Penyelidikan](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Analisis arsip](https://phishdestroy.io/tgwitness/id/docs/reference/analysis/) · [OCR dan transkripsi lokal](https://phishdestroy.io/tgwitness/id/docs/reference/media-analysis/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Pratinjau.** Di **Jurnal**, pilih **"Kecocokan terbaik · bentuk kata"** di sebelah bidang pencarian. Hasil diurutkan menggunakan algoritma BM25 dan mencakup bentuk lain dari kata yang sama: *"перевод"* menemukan *"переводом"* dan *"переводы"*, *"transfer"* menemukan *"transfers"*, frasa dalam bahasa Mandarin ditemukan tanpa spasi. Opsi **"Terbaru terlebih dahulu · teks persis"** mempertahankan pencarian substring sebelumnya di seluruh catatan. Indeks merupakan data turunan. Indeks ini dibangun ulang dari jurnal yang ditandatangani, tidak pernah ditandatangani sendiri, dan tidak pernah dimasukkan ke dalam ekspor. Catatan asli tidak berubah. **Di halaman ini** - [Sintaks pencarian](https://phishdestroy.io/tgwitness/id/docs/reference/search/#search-syntax) - [Bahasa](https://phishdestroy.io/tgwitness/id/docs/reference/search/#languages) - [Di mana indeks berada](https://phishdestroy.io/tgwitness/id/docs/reference/search/#where-the-index-lives) - [Hasil dan jurnal yang ditandatangani](https://phishdestroy.io/tgwitness/id/docs/reference/search/#results-and-the-signed-journal) - [Teks yang dikenali](https://phishdestroy.io/tgwitness/id/docs/reference/search/#recognized-text) - [Akses](https://phishdestroy.io/tgwitness/id/docs/reference/search/#access) - [Tanyakan ke arsip dan MCP](https://phishdestroy.io/tgwitness/id/docs/reference/search/#ask-the-archive-and-mcp) - [Ketergantungan](https://phishdestroy.io/tgwitness/id/docs/reference/search/#dependencies) - [Uji Kinerja](https://phishdestroy.io/tgwitness/id/docs/reference/search/#benchmark) ## Sintaks pencarian | Tulis | Menemukan | | --- | --- | | `перевод карта` | Catatan yang mengandung kedua kata tersebut, dalam bentuk apa pun | | `"переводом на карту"` | Frasa persis ini, dalam urutan ini | | `бонус OR подарок` | Salah satu kata | | `перевод -казино` | Catatan tanpa kata yang dikecualikan | | `example.com` | Domain dan subdomainnya, termasuk dalam tautan tersembunyi dan URL tombol | | `@username`, `t.me/username` | Penyebutan dan tautan akun tersebut, serta pesan yang dikirimkannya | | `#tag` | Tagar | | `+79991234567`, alamat dompet, alamat email | Nilai yang sama dalam bentuk teks atau tautan | | `from:@username`, `from:123456` | Pesan dari pengirim tersebut | | `chat:-1001234567890` | Satu obrolan; hal ini hanya dapat membatasi akses Anda sendiri | | `id:42` | Versi pesan 42 yang disimpan | | `since:2026-01-01 until:2026-01-31` | Periode pengamatan; tanggal tanpa waktu mencakup sepanjang hari | | `kind:edited` | Hanya pengeditan (`new`, `snapshot`, `edited`, `recovered`) | | `source:ocr`, `source:transcription`, `source:all` | Teks yang dikenali sebagai pengganti, atau bersama dengan, pesan | Kata depan dan kata fungsi lainnya diabaikan jika terdapat kata lain di sekitarnya. Huruf yang mirip yang tercampur dalam sebuah kata (misalnya huruf Latin *"a"* di dalam kata Cyrillic), huruf Unicode lebar penuh dan dekoratif, serta karakter tak terlihat, dinormalisasi. ## Bahasa Bahasa ditentukan per catatan berdasarkan skrip dan huruf-hurufnya: | Skrip | Pencocokan | | --- | --- | | Huruf Sirilik | Lema bahasa Rusia dan Ukraina dengan [pymorphy3](https://github.com/no-plagiarism/pymorphy3). Tanpa kamus Ukraina opsional, digunakan stemmer Ukraina yang ringan | | Latin | Stemmer Snowball bahasa Inggris; tanda diakritik diabaikan | | Bahasa Mandarin, Jepang, Korea, Thailand, Laos, Khmer, Myanmar | Pasangan karakter yang tumpang tindih: frasa apa pun ditemukan tanpa spasi. Kueri dalam bahasa Mandarin dipisahkan menjadi kata-kata menggunakan Jieba | | Skrip lainnya | Kata-kata yang tepat | Kamus Ukraina (`pymorphy3-dicts-uk`) didistribusikan di bawah lisensi GPL-3.0, sehingga tidak diinstal secara default. Instal dengan `pip install "tgwitness[uk-dictionary]"`; indeks akan mendeteksi penganalisis baru dan membangun ulang dirinya sendiri. ## Di mana indeks tersebut berada | Mode | Penyimpanan | Penggunaan | | --- | --- | --- | | Di disk (default) | `search/fulltext.sqlite3` di direktori workspace | Arsip berukuran besar; tetap utuh meskipun sistem di-restart | | Hanya di memori | Tidak ada data yang disimpan di disk; dibangun ulang setiap kali dijalankan | Tidak ada salinan turunan dari teks pesan di disk | | Mati | Tanpa indeks; **Yang terbaru terlebih dahulu · teks yang tepat** tetap dipertahankan | Instalasi minimal | Administrator utama memilih mode di bawah **Jurnal → Filter → Indeks pencarian** untuk setiap ruang kerja. `TGWITNESS_FULLTEXT=disk|memory|off` menetapkan pengaturan default untuk ruang kerja yang tidak memiliki pilihan sendiri. Beralih ke "memori" atau "mati" akan menghapus berkas tersebut. Berkas indeks memiliki perlindungan yang sama dengan jurnal: berkas tersebut disimpan di direktori data pribadi. Cadangan dan salinan di luar lokasi tidak menyertakannya. Catatan baru diindeks di latar belakang dalam hitungan detik; pencarian juga mengindeks backlog singkat terlebih dahulu, sehingga catatan yang baru saja disimpan dapat ditemukan. Jurnal yang sudah ada diindeks setelah pembaruan tanpa memblokir panel; hingga saat itu, hasil pencarian mencakup catatan yang telah diindeks dan jurnal menampilkan kemajuan proses. **Pembuatan ulang indeks** dimulai kembali dari catatan pertama. ``` python -m tgwitness index status --data-dir data/live python -m tgwitness index rebuild --data-dir data/live --json ``` `rebuild` panel harus dihentikan (kode keluar 3 jika tidak). Dengan `--json`, keluaran standar hanya menampilkan hasilnya; kemajuan ditampilkan di kesalahan standar. ## Hasil dan jurnal yang ditandatangani Indeks menyimpan nomor urut dan hash dari catatan jurnal terakhir yang dicakupnya serta memeriksa keduanya dengan jurnal saat dibuka. Jurnal yang diganti, dipulihkan, atau diedit akan memicu proses pembaruan indeks. Setiap respons melaporkan posisi ini, dan setiap pencocokan dibaca kembali dari jurnal yang ditandatangani berdasarkan nomor urutnya: indeks menentukan catatan mana yang akan ditampilkan dan urutannya, bukan isinya. Akses obrolan diterapkan pada bidang obrolan jurnal itu sendiri, bukan pada konten indeks. ## Teks yang dikenali OCR dan transkrip tetap berada dalam artefak terenkripsinya. Indeksnya hanya ada di memori dan dibangun kembali saat pekerjaan pengenalan selesai. Hasil yang cocok muncul dalam `media.saved` catatannya, diberi label sebagai pengenalan mesin beserta mesin, model, dan kutipan; hasil tersebut tidak pernah ditampilkan sebagai teks yang dikirim di Telegram. Indeks yang sama digunakan untuk **Pencarian Teks yang Telah Dikenali**, yang juga tetap mencocokkan substring biasa. ## Akses Akses yang dibatasi pada obrolan hanya menemukan catatan dari obrolan tersebut, termasuk teks yang dikenali dari lampirannya. `chat:` dan filter lainnya hanya dapat mempersempit kumpulan tersebut. Status indeks yang ditampilkan pada akses terbatas tidak mencakup total jurnal. Hanya administrator utama yang dapat mengubah mode atau membangun ulang indeks. ## Tanyakan kepada arsip dan MCP **Alat lainnya → Ask the archive** mengambil sumbernya dari indeks ini setelah indeks selesai: hasil pencocokan terbaik di seluruh obrolan yang dipilih, dengan teks yang disimpan dihitung satu kali. Hingga 24 sumber dikirim; teks panjang dipotong di sekitar bagian yang cocok dan ditandai sebagai terpotong. Pertanyaan tentang perubahan terbaru, versi pesan yang disimpan, dan pencarian saat indeks masih dalam proses pembuatan menggunakan pengambilan kronologis sebelumnya. Pratinjau menunjukkan metode mana yang digunakan. Klien MCP dapat memanggil `search_messages` dengan `ranked=true` dan halaman dengan `next_offset`. Koneksi yang dibatasi cakupannya hanya menerima obrolan mereka sendiri. Pagination berurutan mencakup paling banyak hasil 1,000, terlepas dari ukuran halaman. Persempit kueri, obrolan, atau periode untuk memeriksa kecocokan lebih lanjut. Pencarian terbaru terlebih dahulu mengurutkan pesan, hasil OCR, dan transkripsi sebelum memilih setiap halaman. ## Ketergantungan | Paket | Lisensi | Mengapa | | --- | --- | --- | | pymorphy3, pymorphy3-dicts-ru, DAWG2-Python | MIT | Lema bahasa Rusia dan Ukraina; kamus dimuat secara lokal | | snowballstemmer | BSD-3-Klausul | Bentuk dasar kata dalam bahasa Inggris, Python murni | | jieba | MIT | Segmentasi kueri bahasa Mandarin, Python murni (hanya distribusi sumber) | | pymorphy3-dicts-uk (opsional) | GPL-3.0 | Kamus bahasa Ukraina lengkap | SQLite FTS5 dengan `unicode61` tokenizer; ini merupakan bagian dari SQLite dalam build Python saat ini. Tanpa itu, pencarian kecocokan terbaik akan melaporkan bahwa fitur tersebut tidak tersedia. ## Tolok ukur `python tools/bench_fulltext.py --messages 1000000 --work `membuat jurnal terverifikasi yang deterministik berisi campuran pesan dalam bahasa Rusia, Ukraina, Inggris, Mandarin, dan Jepang beserta tautan dan handle di 200 obrolan, membangun indeks, serta mengukur waktu pencarian tipikal (50 hasil, median dari 7 kali eksekusi). Diuji pada Windows 11, Intel Core i9-13900K, 128 GB RAM, Python 3.12.10, SQLite 3.49.1, data pada drive exFAT, alat analisis `fulltext-v1+pymorphy3-ru+light-uk+snowball-en`: | Ukuran | Hasil | | --- | --- | | Jurnal yang ditandatangani | 1.000.000 pesan, 1,50 GiB, ditulis dalam 19 menit | | Pembuatan indeks dari jurnal | 71 detik, sekitar 14.141 pesan per detik | | Berkas indeks | 58 MiB, 3,8% dari jurnal | | Cari segera setelah catatan baru | Median 8 ms, p95 9 ms | | Pencarian substring sebelumnya, jurnal yang sama | `перевод` 3,2 detik, `银行转账` 2,6 detik, `verify-account.example` 2,6 detik | | Cari | Catatan yang cocok | Kecocokan terbaik, median | hal. 95 | Yang terbaru terlebih dahulu, median | | --- | --- | --- | --- | --- | | Kata umum, bentuk kata: `перевод` | 134,403 | 82 ms | 85 ms | 7 ms | | Dua kata: `оплата карта` | 28,996 | 43 ms | 43 ms | 14 ms | | Kata langka: `розыгрыш подарок` | 28,881 | 42 ms | 47 ms | 13 ms | | Frasa yang tepat: `"переказ коштів на картку"` | tidak dihitung | 35 ms | 36 ms | 6 ms | | Domain beserta subdomainnya: `verify-account.example` | 12,435 | 17 ms | 17 ms | 3 ms | | @username: `@support_desk_bot` | 10,331 | 15 ms | 16 ms | 3 ms | | Bahasa Mandarin tanpa spasi: `银行转账` | 17,691 | 23 ms | 24 ms | 3 ms | | Bahasa Jepang: `リンク` | 16,603 | 23 ms | 25 ms | 3 ms | | Bentuk dasar dalam bahasa Inggris: `withdrawal` | 27,775 | 26 ms | 26 ms | 2 ms | | ATAU dan pengecualian: `бонус OR подарок -казино` | 268,034 | 190 ms | 193 ms | 19 ms | | Filter obrolan: `chat:-1000000000007 перевод` | 652 | 9 ms | 9 ms | 6 ms | | Filter periode: `since:2026-01-01 until:2026-01-31 выплата` | 115,732 | 155 ms | 156 ms | 81 ms | Sebuah frasa yang tepat diperiksa secara harfiah pada kandidat berdasarkan urutan peringkat hingga halaman penuh, sehingga jumlahnya tidak dihitung. Waktu yang dibutuhkan bertambah seiring dengan jumlah catatan yang cocok; mempersempit obrolan atau periode akan mempercepat pencarian yang luas. Korpus sintetis ini mengulang kosakata yang terbatas, sehingga kata-kata umum cocok dengan jauh lebih banyak catatan daripada dalam obrolan nyata. --- # Telegram · MCP hanya baca Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/mcp/ Hubungkan klien MCP ke ruang kerja dan obrolan yang dipilih dengan akses yang memiliki batas waktu dan dapat dicabut. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Hubungkan klien MCP ke ruang kerja dan obrolan yang dipilih dengan akses yang memiliki batas waktu dan dapat dicabut. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Integrasi arsip](https://phishdestroy.io/tgwitness/id/docs/reference/cli/) ![Integrasi arsip](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) Hubungkan klien analis ke ruang kerja dan obrolan yang dipilih. TgWitness menyediakan layanan **Streamable HTTP di `/mcp` dalam proses panel**. Setiap koneksi memiliki token, masa berlaku, dan alat yang diizinkan masing-masing. MCP tidak dapat mengirim pesan Telegram, mengubah pengaturan, atau memodifikasi jurnal yang ditandatangani. Koneksi yang sama juga berfungsi melalui [baris perintah](https://phishdestroy.io/tgwitness/id/docs/reference/cli/). [Panduan alur kerja](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Di halaman ini** - [Instal dan periksa](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/#install-and-check) - [Membuat koneksi](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/#issue-a-connection) - [Hubungkan klien Anda](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/#connect-your-client) - [Terowongan Cloudflare](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/#cloudflare-tunnel) - [Alat dan batasan](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/#tools-and-boundaries) ## Instal dan periksa Gunakan lingkungan Python yang menjalankan panel. Dari checkout sumber: ``` # Windows PowerShell & .\.venv\Scripts\python.exe -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' & .\.venv\Scripts\python.exe start.py --check ``` ``` # Linux / macOS .venv/bin/python -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' .venv/bin/python start.py --check ``` Mulai ulang panel dengan direktori data dan argumen peluncuran seperti biasa setelah instalasi. Status kesiapan harus mencakup `[PASS] mcp: streamable-http available`. **Alat lainnya → Integrasi → MCP** menampilkan status runtime dan perintah instalasi menggunakan eksekutabel Python aktual dari server tersebut. **Periksa ulang** akan memperbarui status ini tanpa memuat ulang halaman; tindakan ini tidak menginstal paket atau memulai ulang server. MCP extra menggunakan [SDK Python resmi MCP](https://github.com/modelcontextprotocol/python-sdk).`deploy/constraints-mcp.txt` mengunci versi SDK dan dependensi yang telah diuji. ## Terbitkan koneksi 1. Masukkan label dan pilih ruang kerja serta obrolan yang boleh dibaca oleh klien. 2. Pilih alat satu per satu atau gunakan preset. Hanya alat yang telah diimplementasikan yang ditawarkan. 3. Pilih 1, 7, 30, atau 90 hari, atau masa berlaku khusus antara satu menit hingga 90 hari. 4. Tekan **Create connection**. Token muncul satu kali di samping konfigurasi klien. 5. Salin token dan konfigurasi, lalu jalankan **Check connection**. Tindakan ini menginisialisasi MCP dan mencantumkan alat yang diizinkan; **tidak ada pesan yang dibaca**. Hasilnya menampilkan versi protokol, nama alat, jumlah, dan waktu yang berlalu. 6. Tekan **Done** setelah kredensial disimpan. Polling mempertahankan formulir dan kartu yang hanya ditampilkan sekali. Mengunci panel akan menghapus rahasia yang ditampilkan. Daftar tersebut menampilkan penggunaan terkini, alat terakhir, alamat, dan permintaan dalam satu menit terakhir. **Revoke** mengakhiri akses. **Rotate token** mencabut kredensial lama dan menerbitkan pengganti dengan cakupan, alat, dan masa berlaku yang sama; salin pengganti tersebut satu kali. Token login panel dan kredensial Telegram tidak berfungsi sebagai token MCP. ## Hubungkan klien Anda Pilih klien di panel dan salin konfigurasi yang dihasilkan. Konfigurasi menggunakan referensi rahasia atau placeholder eksplisit; token disalin secara terpisah. | Klien | Konfigurasi | Koneksi | | --- | --- | --- | | Kode Claude | `.mcp.json` | HTTP, `type: "http"`, header bearer | | Claude Desktop | `claude_desktop_config.json` | Jembatan stdio lokal | | Cursor | `.cursor/mcp.json` | HTTP dengan header variabel lingkungan | | VS Code Lokal | `.vscode/mcp.json` | HTTP dengan input kata sandi `promptString` | | Windsurf | `mcp_config.json` | HTTP dengan placeholder header bearer | | Klien lainnya | URL dan header Authorization | HTTP yang dapat dialirkan | TgWitness menggunakan token bearer, tanpa penemuan OAuth. Gunakan jembatan stdio lokal untuk klien yang konektor jarak jauhnya memerlukan OAuth. Untuk VS Code, variabel input berlaku pada harness **Local** dan tidak diteruskan ke sesi Copilot. Referensi konfigurasi: [Claude Code](https://code.claude.com/docs/en/mcp), [Cursor](https://prod.cursor.com/docs/mcp), [VS Code](https://code.visualstudio.com/docs/agents/reference/mcp-configuration). Titik masuk kanonis untuk jembatan lokal adalah: ``` python -m tgwitness.mcp_server --url https://your-panel.example/mcp ``` Gunakan Python lokal klien yang sudah terinstal ekstra MCP. Atur `TGWITNESS_MCP_TOKEN` di lingkungan yang dilindunginya. Jauhkan kredensial dari argumen perintah dan URL. `tgwitness-mcp` adalah titik masuk yang sama. Modul lama `tgwitness.mcp_bridge` dan nama `TGWITNESS_ARCHIVE_TOKEN` tetap menjadi jalur kompatibilitas dengan peringatan; konfigurasi baru menggunakan `mcp_server` dan `TGWITNESS_MCP_TOKEN`. ## Cloudflare Tunnel Teruskan rute `/mcp` panel dan pertahankan header bearer. Membuka pengaturan MCP sebagai administrator akan mendaftarkan origin panel saat ini untuk proses yang sedang berjalan ini. Untuk alamat stabil yang langsung tersedia setelah mulai ulang, konfigurasikan `TGWITNESS_PUBLIC_URL` dengan origin HTTPS panel sebelum memulai panel. Header Host dan forwarded yang sembarang tidak akan mendaftarkan alamat tepercaya. Pemeriksaan Host dan Origin menolak origin browser yang tidak terkait. Respons menggunakan `Cache-Control: no-store`; nilai otorisasi tidak pernah dicatat ke dalam log. Alamat `*.trycloudflare.com` bersifat sementara. Ketika mulai ulang tunnel mengubah nama host, perbarui URL publik yang dikonfigurasi dan URL MCP setiap klien. Gunakan nama host yang stabil untuk konfigurasi klien yang disimpan. ## Alat dan batasan | Alat | Yang dibaca | | --- | --- | | `list_workspaces` | Ruang kerja yang diizinkan | | `list_chats` | Obrolan yang diizinkan | | `search_messages` | Teks pesan yang disimpan dalam periode yang dipilih; `ranked=true` menggunakan [pencarian teks lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/search/) (bentuk kata, hasil yang paling cocok ditampilkan terlebih dahulu, `next_offset` paginasi) | | `get_message_versions` | Versi yang tertangkap dan pengamatan penghapusan | | `get_message_context` | ID pesan sekitar yang tertangkap | | `get_journal_event` | Satu catatan yang telah disanitasi beserta referensi sumbernya | | `get_capture_status` | Status pengumpulan, catatan cakupan yang diizinkan, dan `gap_summary`: nomor pesan yang tidak pernah teramati, per saluran atau supergrup dan untuk urutan seluruh akun ([detail](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#missing-message-numbers-gap_summary)); pilih obrolan untuk melihat celah yang terdaftar di dalamnya | | `get_activity_stats` | Pesan berdasarkan jam UTC dan hari kerja, hari-hari puncak, persentase pengeditan dan penghapusan, pengirim, domain, dan `@handles`, beserta cakupan ([detail](https://phishdestroy.io/tgwitness/id/docs/reference/cli/#activity-statistics)) | | `get_messages_by_date` | Pesan yang disimpan selama satu hari kalender dalam zona waktu IANA yang ditentukan (`Europe/Kyiv`, `UTC`), sesuai waktu yang dilaporkan oleh Telegram; `from_utc` dan `until_utc` cantumkan hari yang dihitung, termasuk waktu musim panas | | `get_pinned_messages` | Pesan yang disematkan dalam snapshot status obrolan terbaru beserta versi yang disimpan, serta pemberitahuan penyematan dan pelepasan yang diamati secara langsung | | `get_chat_stats` | Jumlah catatan yang disimpan untuk satu obrolan atau setiap obrolan dalam cakupan, pengamatan pertama dan terakhir, serta `gap_summary`; gunakan sebelum melakukan pembacaan data dalam jumlah besar | | `get_topics` | Topik forum dari pesan layanan topik yang disimpan: riwayat judul, topik yang ditutup atau disembunyikan, jumlah pesan yang disimpan | | `get_media` | Gambar yang disimpan sebagai pratinjau JPEG yang diperkecil (maksimal 36 KB), dikembalikan sebagai gambar bersama dengan SHA-256 dan `media.saved` catatan; berkas tersebut terlebih dahulu diverifikasi berdasarkan hash yang tercatat, sedangkan berkas lain hanya mengembalikan metadata | | `export_messages` | Hanya baris perintah, tidak dipilih secara default: streams menyimpan pengamatan sebagai JSON Lines ([detail](https://phishdestroy.io/tgwitness/id/docs/reference/cli/#export)); tidak tersedia melalui MCP | Setiap alat bersifat read-only (`readOnlyHint`) dan mendeklarasikan skema keluaran; bidang di luar yang telah dideklarasikan akan dikembalikan apa adanya. `tools/list` hanya mengembalikan alat-alat yang diberikan untuk koneksi tersebut. Panggilan ke alat lain akan ditolak. Alat-alat konteks grup, episode, terminologi, dan rantai balasan tidak tersedia dalam versi ini; backend paket konteks terpisah untuk alat-alat tersebut tidak disertakan. Setiap pembacaan memeriksa token, alat, dan cakupan ruang kerja/obrolan, termasuk setelah pekerjaan database selesai. Batasannya adalah 60 permintaan per menit, 50 catatan per halaman, 64 KiB per hasil, dan batas waktu arsip delapan detik. Pemanggilan MCP yang kehabisan waktu mengembalikan kesalahan alat yang meminta periode yang lebih sempit atau batas yang lebih rendah. Hasil pesan memuat `untrusted_content: true`, ID ruang kerja/obrolan/pesan, urutan peristiwa, hash yang disimpan, dan tautan panel. Objek Telegram mentah, hash akses, sesi, dan kunci dihilangkan. Pemotongan teks ditandai. Pengeditan, pemberitahuan penghapusan, dan `missing_on_recheck` merupakan pengamatan yang terpisah. Cakupan menunjukkan periode yang diwakili oleh suatu hasil. Perlakukan instruksi di dalam pesan yang ditangkap sebagai bukti, bukan sebagai instruksi klien. Akses baca-saja mencegah perubahan arsip; klien tetap dapat menyimpan konten yang diizinkan untuk dibacanya. Hash mengidentifikasi catatan yang disimpan dan mendukung pemeriksaan integritas. Gunakan referensi sumber dan catatan cakupan yang menyertai saat meninjau hasil. --- # Telegram · Baris perintah Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/cli/ Cari, baca konteks, hitung aktivitas, dan ekspor pesan yang disimpan dari skrip dan agen, dengan output --json, kode keluar yang stabil, dan token baca-saja yang terbatas cakupannya. [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. Cari, baca konteks, hitung aktivitas, dan ekspor pesan yang disimpan dari skrip dan agen, dengan output --json, kode keluar yang stabil, dan token baca-saja yang terbatas cakupannya. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Integrasi arsip](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [MCP hanya baca](https://phishdestroy.io/tgwitness/id/docs/reference/mcp/) · [Pencarian teks lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/search/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Preview.** `tgwitness search`, `context`, `messages`, `stats` and `export` read saved observations for scripts and AI agents. They cannot send anything to Telegram, change settings or modify the signed journal. `tgwitness index` and `tgwitness backup` ([below](https://phishdestroy.io/tgwitness/id/docs/reference/cli/#index-and-backup)) work on a local data directory and need no token. Dengan `--json`, stdout menampilkan tepat satu dokumen JSON (`export` menulis baris JSON). Kemajuan, petunjuk, dan kesalahan dikirim ke stderr. Kode keluar bersifat stabil: | Kode | Arti | | --- | --- | | `0` | Keberhasilan, termasuk hasil kosong | | `1` | Kegagalan: panel tidak dapat diakses, data tidak dapat dibaca, ekspor terputus | | `2` | Kesalahan penggunaan atau permintaan tidak valid: tanggal salah, opsi tidak dikenal, indeks pencarian tidak aktif | | `3` | Saat ini tidak tersedia: ruang kerja sedang terbuka di panel yang sedang berjalan, atau panel meminta untuk mencoba lagi nanti (batasan frekuensi, waktu habis) | | `4` | Akses ditolak: token hilang, kedaluwarsa, atau dicabut; obrolan di luar cakupan; atau alat yang tidak mengizinkannya | ## Dua cara untuk membacanya **Melalui panel (`--url`).** Perintah ini menggunakan API arsip berskala yang sama dengan MCP. Buat koneksi di **More tools → Integrations → MCP**: pilih ruang kerja dan obrolan, alat, serta masa berlaku, lalu salin token sekali saja. Koneksi ini bersifat baca-saja, terbatas pada obrolan-obrolan tersebut, dibatasi laju hingga 60 permintaan per menit, dan dapat dicabut atau diganti kapan saja. Token login panel dan kredensial Telegram tidak berfungsi di sini. ``` export TGWITNESS_URL=https://panel.example.org # default http://127.0.0.1:8787 export TGWITNESS_MCP_TOKEN=tgw_mcp_... # or --token-file path tgwitness search 'перевод карта' --json ``` Panel jarak jauh memerlukan HTTPS; HTTP biasa hanya diterima untuk `127.0.0.1`, `localhost` dan `::1`. Variabel lingkungan proxy diabaikan dan pengalihan ditolak, sehingga token hanya akan sampai ke alamat yang Anda tentukan. **Langsung dari ruang kerja yang dihentikan (`--data-dir`).** Membaca direktori data dengan akses lokal penuh, tanpa token. Gunakan pada salinan direktori data atau saat proses pengumpulan data dihentikan. Catatan yang ditandatangani tidak pernah diubah; seperti pada panel, membuka ruang kerja dapat memperbarui indeks yang diturunkan darinya. Saat panel membuka ruang kerja, perintah akan keluar dengan kode `3`; bacalah melalui panel sebagai gantinya. Tanpa `--data-dir`, `TGWITNESS_DATA`, `./data/live` atau direktori data dari instalasi yang menjalankan perintah tersebut. `--workspace ID` memilih ruang kerja (daftar default `default`). `tgwitness messages --workspaces` menampilkan daftar ruang kerja yang dapat Anda baca. ## Perintah | Perintah | Hasil | | --- | --- | | `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | Hasil yang paling sesuai ditampilkan terlebih dahulu, termasuk bentuk kata, frasa persis dalam tanda kutip, domain, dan `@username` ([sintaksis](https://phishdestroy.io/tgwitness/id/docs/reference/search/#search-syntax)) | | `tgwitness search QUERY --exact [--before SEQ]` | Teks persis, yang terbaru terlebih dahulu, tanpa indeks | | `tgwitness context CHAT_ID MESSAGE_ID [--limit N] [--before SEQ]` | Pesan yang disimpan dalam rentang sepuluh ID pesan di kedua sisi | | `tgwitness messages [--limit N] [--offset N]` | Obrolan yang dapat Anda baca | | `tgwitness messages CHAT_ID [--since] [--until] [--limit N] [--before SEQ]` | Pesan obrolan yang disimpan, dimulai dari yang terbaru | | `tgwitness messages CHAT_ID --message ID` | Setiap versi yang disimpan dan catatan penghapusan dari satu pesan | | `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | Statistik aktivitas, di bawah ini | | `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | Pengamatan yang disimpan sebagai baris JSON sesuai urutan jurnal | Tanggalnya adalah `2026-10-01` (pukul 00.00 UTC) atau waktu ISO dengan zona waktu, `2026-10-01T09:00+03:00`. Untuk `search`, `messages` dan `export` mereka memilih waktu pengamatan. Setiap halaman menampung hingga 50 catatan: ikuti `next_offset` (`--offset`) untuk pencarian berdasarkan peringkat dan `next_before` (`--before`) di tempat lain. Ranked search stops at 1,000 results. The final page may be shorter than `--limit`. When more observations match, the last page says so (`truncated: true` with `--json`); narrow the query, chat or period. Setiap hasil pesan membawa `untrusted_content: true` , ID ruang kerja, obrolan, dan pesan, urutan jurnal, hash catatan yang disimpan, serta tautan panel. Pengeditan, pemberitahuan penghapusan, dan `missing_on_recheck` merupakan catatan terpisah. Cakupan dalam `stats` menunjukkan periode yang diwakili oleh hasil pencarian. ### Statistik aktivitas `stats` menghitung pengamatan yang disimpan untuk satu obrolan, satu pengirim, atau semua obrolan dalam cakupan: - pesan berdasarkan jam UTC dan hari dalam seminggu (dimulai dari Senin), jam dan hari tersibuk; - yang telah diedit, dihapus, dan `missing_on_recheck` berbagi; - pengirim beserta jumlah pesan serta waktu pesan pertama dan terakhir; - domain yang paling sering muncul dan `@handles`, dihitung satu kali per pesan di seluruh versi yang disimpan; - cakupan: `coverage.gap` catatan dan, untuk mengakses seluruh ruang kerja, periode tanpa detak jantung pengumpul yang terhubung (`collector_liveness`). Periode ini memilih **waktu pesan yang dilaporkan oleh Telegram**. Jumlah jam dan hari kerja membantu memperkirakan zona waktu pengirim. Angka-angka dihitung berdasarkan permintaan dari jurnal dan tidak disimpan. Setiap hasil menyebutkan kepala jurnal yang dicakupnya saat akses Anda mencakup ruang kerja. Pembacaan berhenti setelah lima detik melalui panel, atau `--timeout` detik secara lokal (default 30); kemudian `complete` bernilai false dan `partial` menyebutkan catatan pertama yang tidak terbaca. Hanya catatan terbaru yang dihitung dalam kasus tersebut. ### Ekspor `export` Menulis satu objek JSON per pengamatan yang disimpan (pesan baru, tangkapan layar, pengeditan, pesan yang dipulihkan, pemberitahuan penghapusan, `missing_on_recheck` dan rekaman media yang disimpan) sesuai urutan jurnal. Setiap baris memiliki bidang yang sama dengan hasil lainnya, beserta teks lengkapnya. Dengan `--output`, berkas ditulis dengan `.partial` nama dan hanya diganti namanya setelah catatan penyelesaian panel; ekspor yang terputus tidak meninggalkan file apa pun dan keluar dengan kode `1`. `--output` tidak akan pernah menimpa berkas yang sudah ada. Dengan `--output` dan `--json`, stdout menampilkan ringkasan: jumlah catatan, urutan jurnal terakhir, dan, untuk akses seluruh ruang kerja, kepala jurnal. Ekspor melalui panel memerlukan koneksi yang mengizinkan **pesan Ekspor (hanya baris perintah)** ; opsi ini tidak dipilih secara default. Berkas ini adalah salinan kerja; untuk penyerahan yang dapat diverifikasi, gunakan ekspor yang ditandatangani di **bagian Ekspor** , yang diverifikasi oleh perintah `python -m tgwitness.verify` . Panel memeriksa kembali akses sebelum mengeluarkan setiap catatan, termasuk catatan penyelesaian. Akses yang dicabut atau kedaluwarsa akan menghasilkan ekspor yang tidak lengkap. Pembacaan halaman secara bertahap berbagi batas pekerja arsip dengan kueri lain dan memiliki batas waktu tunggu. ### Index and backup These two commands read the data directory directly and take no token or `--url`. | Perintah | Hasil | | --- | --- | | `tgwitness index status [--workspace ID] [--data-dir DIR] [--json]` | Search index state of one workspace or, by default, every workspace: mode, `ready`, `building` or `not built`, indexed and journal head sequence. Works while the panel runs | | `tgwitness index rebuild [--workspace ID] [--data-dir DIR] [--json]` | Rebuilds the index from the first journal record. Rewrites only the derived index, never the signed journal. Exits with code `3` while the panel has the workspace open. Nothing is built when the workspace keeps its index in memory or has search off | | `tgwitness backup FOLDER [--data-dir DIR] [--json]` | Copies the whole data directory into a new or empty folder outside it while the panel keeps running, and writes `backup-manifest.json` with every file's SHA-256 and the journal heads | `index` accepts `--workspace default` or a workspace ID; the default is `all`. The backup skips temporary exports, SQLite sidecar files and lock files. The folder holds the Telegram session and signing keys, so keep it as private as the data directory. [Backup, restore, and capacity](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/#backup-restore-and-capacity) describes restoring and what the next start records. ## Keterampilan agen [`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) menjelaskan kepada agen cara menggunakan perintah-perintah ini, cara mengutip catatan, dan cara menangani teks yang ditangkap. Agen yang membaca `.agents/skills` memuatnya dari hasil checkout repositori . Untuk Claude Code, salin `tgwitness-cli` folder tersebut ke `.claude/skills/` di proyek Anda atau `~/.claude/skills/`. ## MCP dan baris perintah Keduanya menggunakan koneksi, pemeriksaan cakupan, dan batasan yang sama. Hasil MCP dibatasi hingga satu halaman berukuran 64 KiB, sehingga MCP tidak menawarkan ekspor massal; baris perintah mengalirkannya. `get_activity_stats` tersedia untuk keduanya. --- # Telegram · OCR dan transkripsi lokal Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/media-analysis/ Kenali gambar dan audio yang direkam menggunakan worker lokal; jaga agar teks yang dihasilkan tetap tertaut ke berkas asalnya. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Kenali gambar dan audio yang direkam menggunakan worker lokal; jaga agar teks yang dihasilkan tetap tertaut ke berkas asalnya. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penyelidikan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/) ![Penyelidikan](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Panduan alur kerja](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Buka catatan jurnal `media.saved` , pilih **"Kenali lampiran** ", lalu pilih OCR atau transkripsi di bawah **Alat Lainnya → "Tanyakan ke arsip** " (bernama **Pengenalan Mesin** saat AI arsip dinonaktifkan). Pemrosesan dilakukan secara manual dan lokal. Tidak ada mode media berbasis cloud atau unggahan otomatis. Byte lampiran asli dan `media_sha256` tetap tidak berubah; teks yang dikenali ditandai secara eksplisit sebagai pengenalan mesin dan disimpan terpisah bersama hash sumber, versi mesin/model, bahasa, parameter, dan waktu penyelesaian. Transkrip mempertahankan cap waktu yang dikembalikan. Cari hasil ini menggunakan **fitur "Cari Teks yang Dikenali"** dan filter OCR/transkrip, atau pilih teks yang dikenali sebagai sumber pencarian "Kecocokan Terbaik" dalam **Jurnal**. Keduanya mencocokkan bentuk kata melalui [indeks](https://phishdestroy.io/tgwitness/id/docs/reference/search/#recognized-text) [dalam memori](https://phishdestroy.io/tgwitness/id/docs/reference/search/#recognized-text). Ini adalah pencarian data turunan yang terpisah; pencarian ini tidak secara diam-diam mengubah hasil pengenalan mesin menjadi teks Telegram asli atau menambahkannya ke peristiwa yang ditandatangani. ## Siapkan worker opsional Versi 1 memerlukan host Linux dengan daemon Docker lokal. Instalasi Windows dapat menjalankan TgWitness di dalam lingkungan VM Linux/WSL dengan daemon lokalnya sendiri. Panel ini tidak pernah mendekode lampiran yang tidak tepercaya secara langsung. ``` docker build -f deploy/media-worker/Dockerfile -t tgwitness-media:local . export TGWITNESS_MEDIA_IMAGE=tgwitness-media:local ``` Atur variabel-variabel ini di lingkungan layanan TgWitness dan mulai ulang layanannya. Soket daemon secara default adalah `/var/run/docker.sock`; untuk penerapan tanpa hak root, dapat diatur menjadi `TGWITNESS_DOCKER_SOCKET`. Worker secara eksplisit menggunakan soket Unix tersebut, bukan konteks Docker jarak jauh. Jangan mengekspos API Docker kepada pengguna panel atau memasang soketnya di dalam kontainer pengenalan. Untuk transkripsi, instal secara terpisah model Whisper yang kompatibel dengan CTranslate2, lalu atur `TGWITNESS_WHISPER_MODEL_DIR` ke direktori model tersebut. Worker memuatnya dengan `local_files_only=True`; model yang dipilih dan input dipasang dalam mode baca-saja. Lihat [dokumentasi pemuatan model](https://github.com/SYSTRAN/faster-whisper) pada mesin tersebut. Gambar OCR yang disediakan mencakup data pelatihan dalam bahasa Inggris dan Rusia. Tambahkan bahasa lain ke dalam gambar Anda jika diperlukan; kode bahasa mengikuti [CLI Tesseract](https://tesseract-ocr.github.io/tessdoc/Command-Line-Usage.html). Tidak ada model yang diambil selama pemrosesan. Proses pembuatan/pengunduhan pengaturan mungkin menggunakan jaringan; setiap wadah pengenalan yang sebenarnya memiliki jaringan yang dinonaktifkan. Instal gambar sebelum mengaktifkannya; runtime menggunakan `--pull=never`. ## Batasan dan pemulihan Kontainer ini berjalan sebagai pengguna tanpa hak istimewa dengan root hanya baca, kemampuan yang dibatasi, `no-new-privileges` , satu CPU, memori 2 GiB, batas PID, dan sistem berkas sementara yang dibatasi. Hanya salinan terverifikasi dari berkas yang dipilih dan direktori model opsional yang dipasang. Basis data, vault, dan sesi pengumpul tidak dipasang. [Bendera runtime Docker](https://docs.docker.com/reference/cli/docker/container/run/) memberlakukan batasan-batasan ini; ini tetap merupakan batas kontainer, bukan enklave perangkat keras. Ukuran file dibatasi hingga 50 MiB, gambar hingga 20 juta piksel, audio hingga 30 menit dengan durasi yang diketahui, dan pemrosesan hingga lima menit. Hanya satu pekerja yang berjalan pada satu waktu, dengan maksimal 20 pekerjaan yang mengantri/sedang berjalan dan 100 pekerjaan yang disimpan per ruang kerja. Perintah "Cancel" menghentikan kontainer; perintah "retry" membuat pekerjaan baru yang terhubung dengan upaya sebelumnya. Pekerjaan yang terputus akan ditandai setelah dimulai ulang. Pemrosesan dapat gagal jika model tidak dapat memenuhi batas yang dikonfigurasi; model tidak akan berjalan secara diam-diam tanpa isolasi. --- # Telegram · Webhook keluar Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/webhooks/ Mengirimkan peristiwa yang telah difilter ke penerima HTTPS dengan tanda tangan HMAC, upaya pengiriman ulang, dan status pengiriman. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Mengirimkan peristiwa yang telah difilter ke penerima HTTPS dengan tanda tangan HMAC, upaya pengiriman ulang, dan status pengiriman. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Integrasi arsip](https://phishdestroy.io/tgwitness/id/docs/reference/cli/) ![Integrasi arsip](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [Panduan alur kerja](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Buka **Lebih Banyak alat → Integrasi → Webhook keluar** di ruang kerja yang dipilih. Tambahkan penerima HTTPS, pilih peristiwa collector/media/export, dan secara opsional pilih obrolan untuk pengamatan baru dan perubahan. Teks pesan dinonaktifkan secara default. Mengaktifkan kutipan akan menambahkan maksimal 1,000 karakter ke peristiwa perubahan pesan; bidang Telegram mentah dan kredensial tidak pernah dikirim. Salin rahasia HMAC satu kali ke konfigurasi terlindungi penerima. Rahasia ini dienkripsi di brankas TgWitness dan tidak dapat diambil dari panel. Hapus dan buat ulang tujuan untuk merotasi kunci. **Kirim** antrian **uji sintetis** sebuah uji tanpa konten obrolan; segarkan status pengiriman untuk melihat hasilnya. Pengiriman ini memperluas siklus pemberitahuan yang sudah ada bersama Apprise. Fitur ini menggunakan rute luar ruang kerja dan batasan tujuan pribadi yang sudah ada. Tidak ada fallback atau pengalihan langsung setelahnya. URL tidak boleh berisi kredensial, string kueri, atau fragmen; alamat pribadi memerlukan persetujuan jaringan tingkat server, bukan pengaturan yang dapat dilewati oleh pengguna panel. ## Payload dan tanda tangan Skema: [`tgwitness.webhook/1`](https://github.com/phishdestroy/TgWitness/blob/main/integrations/webhook.schema.json). Setiap muatan berisi `event_id`, `timestamp`, `workspace`, `type`, `synthetic`, dan penghitung. Peristiwa berbasis jurnal mencakup urutan dan hash-nya. Penyelesaian ekspor penuh dan uji sintetis merupakan peristiwa pengiriman, tanpa referensi jurnal yang ditandatangani yang dibuat-buat. Pemberitahuan penghapusan Telegram dan `missing_on_recheck` tetap merupakan jenis yang berbeda. Header `X-TgWitness-Signature` adalah `t=UNIX_SECONDS,v1=HEX_HMAC_SHA256`. Hitung HMAC atas byte yang tepat `timestamp + "." + raw_request_body`, menggunakan rahasia yang ditampilkan sebagai byte UTF-8. Bandingkan tanda tangan dalam waktu konstan sebelum menganalisis atau memproses isi pesan. Tolak cap waktu yang selisihnya lebih dari lima menit dari jam Anda. Cap waktu diperbarui pada setiap upaya pengiriman. Gunakan `event_id` sebagai kunci idempotensi dalam penyimpanan tahan lama, dengan batasan unik atomik sebelum efek samping. Tanda tangan yang valid saja tidak mencegah permintaan terbaru diputar ulang. Simpan ID yang telah diproses setidaknya selama seluruh jendela percobaan ulang; simpan lebih lama jika penerima dapat memproses ulang peristiwa yang tersimpan. ## Mencoba lagi Pengiriman diantrekan secara tahan lama sebelum permintaan HTTP. Pengiriman ini menggunakan semantik setidaknya sekali : pengakuan yang hilang atau restart dapat mengirimkan peristiwa yang sama lagi dengan ID yang sama. Terdapat delapan upaya dengan penundaan eksponensial, dimulai dari 15 detik dan dibatasi hingga satu jam. Keberhasilan memerlukan respons 2xx. Sebuah pekerjaan yang telah menghabiskan upaya ulangnya tetap terlihat bersama kesalahannya untuk ditinjau. Antrian menampung 1.000 pengiriman. Saat penuh, pemindaian peristiwa jurnal akan berhenti sementara dan dilanjutkan kembali setelah ada ruang yang tersedia. Penyelesaian ekspor penuh yang tidak dapat dimasukkan ke antrian akan memicu kesalahan antrian yang terlihat. Hingga lima upaya pengiriman dicoba per siklus notifikasi, dan 100 catatan upaya terbaru disimpan. Menghapus tujuan juga akan menghapus pengiriman yang tertunda. ## Contoh n8n Impor [alur kerja contoh](https://github.com/phishdestroy/TgWitness/blob/main/integrations/n8n-tgwitness.json). Alur kerja ini tidak aktif dan tidak mengandung rahasia atau tindakan lanjutan. Tetapkan `TGWITNESS_WEBHOOK_SECRET` di lingkungan pekerja n8n, izinkan akses ke lingkungan tersebut, dan izinkan fungsi bawaan `crypto` untuk node Code. Contoh ini menggunakan opsi raw-body pada node Webhook, memverifikasi tanda tangan/keabsahan, dan mengonfirmasi peristiwa yang telah diverifikasi. Hal ini sesuai dengan [implementasi yang didokumentasikan](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/Webhook/Webhook.node.ts) pada node tersebut. Sebelum menambahkan penulisan atau pemberitahuan SIEM, tambahkan penyimpanan idempotensi yang tahan lama yang diindeks menggunakan `event_id`. Batasi pengeditan alur kerja n8n dan penyimpanan log eksekusi sesuai dengan data yang Anda pilih untuk dikirim. TgWitness tidak menambahkan perintah masuk apa pun. --- # Telegram · Galeri publik Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/showcase/ Publikasikan pesan yang disimpan dari saluran publik yang dipilih serta snapshot yang ditandatangani melalui tautan yang kedaluwarsa dan dapat dicabut. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Publikasikan pesan yang disimpan dari saluran publik yang dipilih serta snapshot yang ditandatangani melalui tautan yang kedaluwarsa dan dapat dicabut. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penerapan dan pemulihan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) ![Penerapan & pemulihan](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **Alat lainnya → Akses → Pameran publik** membuat halaman terpisah yang hanya dapat dibaca menggunakan sistem token akses yang ada. Fitur ini membaca pengamatan yang disimpan oleh instalasi. Fitur ini tidak menjalankan pengumpul, masuk ke Telegram, atau memperoleh saluran untuk pengunjung. ## Publikasikan halaman 1. Simpan profil sumber untuk setiap saluran publik yang ingin Anda tampilkan. Sebuah saluran harus memiliki nama pengguna publik dalam profil terbarunya yang tersimpan; grup dan obrolan pribadi tidak memenuhi syarat. 2. Buka **Alat Lainnya → Akses → Pameran Publik** (atau `/showcase-manage.html`) sebagai administrator. 3. Pilih saluran dari maksimal 16 ruang kerja, masukkan judul halaman publik, dan pilih masa berlaku tautan selama 1, 7, atau 30 hari. Label ruang kerja internal tidak dipublikasikan. Maksimal 64 saluran dapat disertakan. 4. Tinjau teks dari saluran yang dipilih untuk dipublikasikan, lalu klik **Pratinjau catatan yang dipilih**. Pratinjau ini menggunakan proyeksi sisi server yang sama dengan halaman pengunjung. 5. Klik **"Buat tautan showcase**". Salin tautan tersebut selagi masih terlihat. Buka tautan tersebut di peramban terpisah untuk meninjau halaman penerima sebelum membagikannya. Tautan tersebut berisi token akses dalam fragmen URL-nya. Halaman ini menghapus fragmen tersebut sebelum melakukan permintaan API dan menukarnya dengan sesi browser. Siapa pun yang memiliki tautan tersebut dapat membuka materi yang dipilih hingga masa berlakunya habis atau dicabut. Tautan baru memungkinkan 100 sesi bersamaan, masing-masing berdurasi maksimal satu jam. Kontrol akses yang ada juga dapat memberlakukan pembatasan alamat dan batas masuk melalui API grant. Akses peninjau biasa merupakan mode yang berbeda dan tetap mencakup pesan serta berkas yang diizinkan semula. ## Apa yang dilihat pengunjung | Terlihat | Dijaga kerahasiaannya | | --- | --- | | Judul saluran publik terpilih, nama pengguna, dan tanggal pengamatan profil | Identitas akun, label ruang kerja internal, dan sumber yang tidak dipilih | | Teks yang ditangkap dan setiap pengeditan yang disimpan | ID pengirim terstruktur, nama, nama pengguna, nomor telepon, dan nilai profil | | Penghapusan catatan beserta teks yang telah disimpan sebelumnya, jika tersedia | Lampiran, avatar, gambar mini, nama file, dan muatan asli | | Penanda yang menunjukkan bahwa seorang penulis/profil atau lampiran telah direkam | Metadata penerusan dan balasan, rute jaringan, alamat IP, dan kredensial | | Jumlah peristiwa saluran terpilih, pengaturan koleksi saat ini, interval heartbeat, dan interval checkpoint | Kontrol koleksi dan API ekspor bukti standar | | Jejak penandatanganan, titik pemeriksaan jurnal, dan bukti konsistensi | Kunci penandatanganan dan sesi Telegram | **Teks pesan publik tidak dianonimkan secara otomatis.** Nama, sebutan, nomor telepon, atau tautan yang ditulis dalam pesan tetap menjadi bagian dari teks tersebut. `Redacted`Berlaku untuk bidang penulis/profil yang terstruktur. Periksa kembali konten yang sebenarnya dipilih sebelum mempublikasikannya, termasuk suntingan dan penghapusan yang dipertahankan. Kelayakan mencerminkan **profil sumber terbaru yang disimpan**, bukan pencarian Telegram secara langsung. Jika profil berikutnya tidak lagi memiliki nama pengguna saluran publik, permintaan baru tidak akan menyertakan saluran tersebut. Segarkan profil sumber saat visibilitas publik berubah. Pembaca mungkin sudah menyimpan materi yang sebelumnya mereka terima. Catatan asli yang ditandatangani tetap tidak berubah. Proyeksi yang ditampilkan ditandatangani secara terpisah dan membawa hash yang merujuk pada catatan aslinya. Tanda tangan proyeksi mengautentikasi pernyataan yang ditampilkan, dan catatan asli yang dirujuk tetap mempertahankan tanda tangan masing-masing. ## Periksa tanda tangan dan kesinambungan Perluas **"Fingerprint & signed checkpoint"** dan unduh snapshot. Setelah halaman diperbarui, unduhan tersebut mencakup snapshot browser sebelumnya dan bukti konsistensi Merkle antara batas-batas jurnal mereka. Pembaruan otomatis dilakukan sekali setiap menit selama halaman tersebut terlihat dan menampilkan halaman pertama pengamatannya. Setelah menginstal TgWitness, verifikasi berkas yang diunduh secara offline: ``` python -m tgwitness.showcase_verify showcase.json --fingerprint TRUSTED_COLLECTOR_SHA256 ``` Sidik jari harus berasal dari referensi tepercaya yang terpisah. Untuk membandingkannya dengan snapshot yang Anda simpan sendiri, gunakan `--previous earlier.json`; ini akan menggantikan snapshot sebelumnya yang terdapat dalam unduhan. Bukti saat ini harus dimulai pada batas yang telah disimpan tersebut. Klien yang terotentikasi dapat meminta bukti tersebut menggunakan `GET /api/showcase/{workspace_id}?challenge=<32-hex-random>&from_count=`. Jurnal yang lebih pendek akan mengembalikan HTTP 409 alih-alih secara diam-diam mengatur ulang batas tersebut. Titik pemeriksaan yang ditandatangani mencakup **seluruh jurnal pengumpul**, termasuk jumlah catatannya dan hash kepala yang tidak transparan. Jumlah pesan yang ditampilkan hanya berlaku untuk saluran publik yang dipilih. Halaman ini tidak pernah mencantumkan isi jurnal lainnya. Ini adalah jumlah peristiwa, bukan jumlah pesan unik. Pengaturan tersebut menggambarkan konfigurasi saat ini, bukan setiap interval perekaman sebelumnya. Verifikasi tanda tangan dan konsistensi dapat mendeteksi perubahan relatif terhadap batas yang disimpan. Hitung ulang peristiwa yang dilaporkan dari arsip yang sesuai dan tinjau interval akuisisi serta titik pemeriksaan saksi yang disimpan secara bersamaan. Gunakan [verifikator bukti](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md), [saksi independen](https://phishdestroy.io/tgwitness/id/docs/reference/witness/), dan [catatan skala yang telah diuji](https://phishdestroy.io/tgwitness/id/docs/reference/verification/). Instalasi sintetis diberi label secara jelas sebagai sintetis. ## Batalkan atau host halaman ini Gunakan **Revoke** di manajer showcase atau bagian **Akses** yang ada untuk menutup tautan dan mengakhiri semua sesinya. Pengunjung akan menghapus catatan yang ditampilkan ketika permintaan mendeteksi bahwa akses telah berakhir. Masa berlaku dan izin diperiksa pada setiap permintaan. Izin showcase tidak dapat dikonversi menjadi akses panel biasa di tempat; buat izin baru untuk mengubah mode. Sajikan halaman ini melalui alamat HTTPS yang sudah ada pada instalasi. Mempublikasikan tautan tidak akan membuka port baru, membuat terowongan, atau mengubah DNS. Kode HTML dan API tetap berada di instalasi pengguna. Pengunjung showcase tidak dapat menggunakan API pesan, profil, media, ekspor, atau manajemen biasa dengan akses ini. --- # Telegram · Cara kerja bukti tersebut Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/how-it-works/ Penjelasan mengenai rantai hash, tanda tangan, titik pemeriksaan, dan saksi, disertai rumus-rumus tepat yang digunakan oleh verifikator. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Penjelasan mengenai rantai hash, tanda tangan, titik pemeriksaan, dan saksi, disertai rumus-rumus tepat yang digunakan oleh verifikator. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bukti dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) ![Bukti & verifikasi](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness menyimpan apa yang diamati oleh akun pengumpul, menghubungkan pengamatan tersebut ke dalam jurnal yang ditandatangani, dan memungkinkan orang lain memverifikasi ekspor tersebut berdasarkan kunci tepercaya, waktu eksternal dari pihak ketiga, dan titik pemeriksaan yang disimpan sebelumnya. [Situs web dokumentasi lokal](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally) menambahkan contoh interaktif di `/docs/concepts/`, penjelajah keputusan titik pemeriksaan di `/docs/witness/`, serta panduan langkah demi langkah untuk [Case Board](https://phishdestroy.io/tgwitness/id/docs/reference/case-board/), [desain laporan](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/), dan [cuplikan serah terima](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#handover-extract). Semua pesan contoh, jumlah, dan penundaan bersifat fiktif. Hash di sandbox rantai dihitung dengan SHA-256 di browser. Tidak ada data yang dikirim ke Telegram. **Di halaman ini** - [Pesan berubah; pengamatan terus bertambah](https://phishdestroy.io/tgwitness/id/docs/reference/how-it-works/#a-message-changes-observations-accumulate) - [Apa yang dicakup oleh hash](https://phishdestroy.io/tgwitness/id/docs/reference/how-it-works/#what-a-hash-covers) - [Apa yang ditambahkan oleh titik pemeriksaan sebelumnya](https://phishdestroy.io/tgwitness/id/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds) - [Di mana seorang saksi berada](https://phishdestroy.io/tgwitness/id/docs/reference/how-it-works/#where-a-witness-belongs) - [Pengiriman uji terhadap tindakan yang diketahui](https://phishdestroy.io/tgwitness/id/docs/reference/how-it-works/#test-delivery-against-known-actions) - [Pilih alur kerja](https://phishdestroy.io/tgwitness/id/docs/reference/how-it-works/#pick-a-workflow) ## Sebuah pesan berubah; pengamatan terus bertambah Diagram urutan · Telegram → Pengumpul: Pesan baru: Bertemu pukul 10:00; Pengumpul → Jurnal yang ditandatangani: Tambahkan pesan.baru; Telegram → Pengumpul: Edit: Bertemu pukul 11:00; Pengumpul → Jurnal yang ditandatangani: Tambahkan pesan.edited; Telegram → Pengumpul: Pemberitahuan penghapusan; Pengumpul → Jurnal yang ditandatangani: Tambahkan pesan.dihapus; Catatan tentang Jurnal yang ditandatangani: Pengamatan terhadap pesan asli, yang diedit, dan yang dihapus tetap dipertahankan · Telegram · Pengumpul · Jurnal yang ditandatangani · Pesan baru: Bertemu pukul 10:00 · Tambahkan pesan.baru · Edit: Bertemu pukul 11:00 · Tambahkan pesan.edited · Pemberitahuan penghapusan · Tambahkan pesan.dihapus · Pengamatan terhadap pesan asli, yang diedit, danyang dihapus tetap dipertahankan **Diagram dalam bentuk teks** 1. Telegram → Pengumpul: Pesan baru: Bertemu pukul 10:00 2. Pengumpul → Jurnal yang ditandatangani: Tambahkan pesan.baru 3. Telegram → Pengumpul: Edit: Bertemu pukul 11:00 4. Pengumpul → Jurnal yang ditandatangani: Tambahkan pesan.edited 5. Telegram → Pengumpul: Pemberitahuan penghapusan 6. Pengumpul → Jurnal yang ditandatangani: Tambahkan pesan.dihapus 7. Catatan tentang Jurnal yang ditandatangani: Pengamatan terhadap pesan asli, yang diedit, dan yang dihapus tetap dipertahankan Urutan yang disederhanakan ini mengasumsikan bahwa Telegram telah mengirimkan setiap pembaruan dan akun yang dipilih dapat melihatnya. Peristiwa operasional juga tercatat dalam jurnal. Pemberitahuan penghapusan tidak mencantumkan pengirim penghapusan atau waktu penghapusan yang tepat. Pengiriman berulang merupakan pengamatan terpisah; tidak ada penindasan duplikat secara menyeluruh di jurnal. ## Apa yang dicakup oleh hash ![Amati, enkripsi, hash, dan tandatangani: setiap peristiwa baru menyertakan hash dari peristiwa sebelumnya.](https://phishdestroy.io/tgwitness/assets/evidence-chain-animated.svg?v=368c25a3be9c) Baca rumusnya dari dalam ke luar: **C** mengubah sembilan bidang menjadi byte yang tepat; **SHA-256** menghasilkan ringkasannya; **hex** adalah cara penyimpanan ringkasan tersebut. Hash sebelumnya sudah ada di dalam peristiwa. **unhex** mengubah hash yang disimpan kembali menjadi 32 byte yang ditandatangani oleh Ed25519. [Diagram rantai statis](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg) Misalkan C(ei) adalah JSON UTF-8 kanonik dari sembilan bidang peristiwa. Yang pertama, `previous_hash`, terdiri dari 64 karakter nol. Setiap catatan berikutnya menyertakan hash heksadesimal dari catatan sebelumnya: hi = hex(SHA256(C(ei))) σi = Ed25519.Sign(sk,unhex(hi)) Tanda tangan mencakup 32 byte digest mentah. Masukan hash berisi tepat `seq`, `observed_at`, `source_at`, `kind`, `chat_id`, `message_id`, `actor_id`, `payload`, dan `previous_hash`. Kunci objek diurutkan; spasi kosong dan kode pelarian ASCII dihilangkan; NaN dan tak terhingga ditolak. Lihat [pengkodean yang tepat](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#event-canonicalization). Diagram alur · 64 karakter nol → Catatan 1 / hash h1; Catatan 1 / hash h1 → Catatan 2 mencakup h1 / hash h2; Catatan 2 mencakup h1 / hash h2 → Catatan 3 mencakup h2 / hash h3; Catatan 3 mencakup h2 / hash h3 → Titik pemeriksaan yang ditandatangani: hitungan 3, judul h3 (simpan di tempat lain) · 64 karakter nol · Catatan 1 / hash h1 · Catatan 2 mencakup h1/ hash h2 · Catatan 3 mencakup h2/ hash h3 · Titik pemeriksaan yangditandatangani:hitungan 3, judul h3 · simpan di tempat lain **Diagram dalam bentuk teks** 1. 64 karakter nol → Catatan 1 / hash h1 2. Catatan 1 / hash h1 → Catatan 2 mencakup h1 / hash h2 3. Catatan 2 mencakup h1 / hash h2 → Catatan 3 mencakup h2 / hash h3 4. Catatan 3 mencakup h2 / hash h3 → Titik pemeriksaan yang ditandatangani: hitungan 3, judul h3 (simpan di tempat lain) | Ubah menjadi jurnal yang disediakan | Apa yang mendeteksinya | | --- | --- | | Ubah catatan 2 sambil mempertahankan hash yang telah disimpan | Hash peristiwa yang dihitung ulang berbeda; tanda tangannya tidak lagi mencakup peristiwa yang telah diubah | | Merekonstruksi catatan yang telah diubah dan setiap hash berikutnya | Tanda tangan asli gagal; titik pemeriksaan yang disimpan di batas yang terpengaruh juga tidak sesuai | | Hapus bagian akhir tetapi pertahankan awalan yang tersisa tetap utuh | Titik pemeriksaan yang disimpan sebelumnya di luar awalan yang diberikan menunjukkan bahwa ekspor tersebut terlalu pendek | | Menandatangani ulang jurnal pengganti dengan kunci lain | Jejak kunci tepercaya yang terpisah menolak identitas pengganti | ![Mengubah bidang yang telah disimpan akan mengubah ringkasannya; menghitung ulang hash tidak akan memulihkan tanda tangan asli.](https://phishdestroy.io/tgwitness/assets/evidence-tamper-animated.svg?v=5ca92399bea5) **Coba logika pada catatan 2:** ubah `Meet at 11:00` menjadi `Meet at 12:00` dalam peristiwa yang disimpan. Hash yang dihitung ulang tidak lagi cocok. Menghitung ulang rantai selanjutnya dapat memperbaiki tautannya, tetapi tidak dapat membuat tanda tangan asli mencakup ringkasan baru. Sebaliknya, pengeditan Telegram yang teramati akan menjadi catatan jurnal baru. [Diagram perubahan statis](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg) Tautan hash saja tidak mencegah seseorang menghitung ulang rantai pengganti. Kepercayaan berasal dari pemeriksaan tanda tangan di bawah kunci yang dipercaya secara independen, waktu eksternal dari pihak ketiga yang mengunci kepala jurnal, dan referensi yang disimpan di luar pengumpul. ## Apa yang ditambahkan oleh titik pemeriksaan sebelumnya ![Pertahankan jumlah 3 dan judul h3; ekspor selanjutnya yang berisi 4 catatan diperiksa pada posisi 3.](https://phishdestroy.io/tgwitness/assets/evidence-checkpoint-animated.svg?v=e68f4e7be4b9) **Referensi tetap tidak berubah meskipun jurnal terus bertambah.** Jika titik pemeriksaan menyatakan “3 catatan, header h3”, ekspor empat catatan dapat lolos dengan mencocokkan h3 pada posisi ke-3. Header terbarunya adalah h4, yang diperkirakan akan berbeda. Ekspor yang hanya berisi dua catatan akan gagal. [Diagram titik pemeriksaan statis](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg) Setelah memverifikasi tanda tangan titik pemeriksaan, wajibkan: Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint Sebuah ekspor mungkin melampaui batas checkpoint. Ekspor tersebut harus sesuai pada batas yang dipertahankan. Kunci pengumpul menandatangani checkpoint, sehingga pengumpul dapat menandatangani checkpoint lainnya. Kunci tersebut mengikat catatan hanya jika penerima memperolehnya sebelum arsip, melalui saluran lain; bukti minimal juga memerlukan waktu eksternal dari pihak ketiga. Verifikator yang sebenarnya juga memeriksa urutan setiap peristiwa, tautan sebelumnya, hash, dan tanda tangan. Membandingkan hanya bagian akhir yang disimpan akan melewatkan catatan bagian dalam yang diubah yang hash-nya tidak diperbarui. ## Tempat yang tepat bagi seorang saksi Diagram alur · Pengumpul / sesi akun / kunci A → Titik akhir checkpoint yang hanya dapat dibaca; Witness / kunci pengumpul yang disematkan / kunci sendiri B → Jurnal saksi terverifikasi yang terpisah; Witness / kunci pengumpul yang disematkan / kunci sendiri B → Titik akhir checkpoint yang hanya dapat dibaca (Ajukan permintaan pemeriksaan); Titik akhir checkpoint yang hanya dapat dibaca → Witness / kunci pengumpul yang disematkan / kunci sendiri B (Jawaban yang ditandatangani); Witness / kunci pengumpul yang disematkan / kunci sendiri B → Saluran dengan postingan TGW1 yang ditandatangani (API Bot / token sendiri) · Host A · Host B · Pengumpul / sesi akun /kunci A · Titik akhir checkpointyang hanya dapat dibaca · Witness / kunci pengumpulyang disematkan / kuncisendiri B · Jurnal saksi terverifikasiyang terpisah · Saluran dengan postinganTGW1 yang ditandatangani · Ajukan permintaan · pemeriksaan · Jawaban yang ditandatangani · API Bot / token sendiri **Diagram dalam bentuk teks** 1. Pengumpul / sesi akun / kunci A → Titik akhir checkpoint yang hanya dapat dibaca 2. Witness / kunci pengumpul yang disematkan / kunci sendiri B → Jurnal saksi terverifikasi yang terpisah 3. Witness / kunci pengumpul yang disematkan / kunci sendiri B → Titik akhir checkpoint yang hanya dapat dibaca (Ajukan permintaan pemeriksaan) 4. Titik akhir checkpoint yang hanya dapat dibaca → Witness / kunci pengumpul yang disematkan / kunci sendiri B (Jawaban yang ditandatangani) 5. Witness / kunci pengumpul yang disematkan / kunci sendiri B → Saluran dengan postingan TGW1 yang ditandatangani (API Bot / token sendiri) Saksi mencatat rollback, head berbeda pada hitungan yang sama, kunci yang berubah, jawaban tidak valid, dan respons yang hilang. Untuk memastikan setiap catatan sebelumnya tidak berubah, bandingkan ekspor dengan checkpoint yang disimpan. Saksi di host lain tidak ikut terdampak gangguan host kolektor; operator terpisah memberikan independensi tambahan. Verifikator memeriksa bahwa kunci saksi berbeda dari kunci kolektor; catatan kontrol kunci milik kustodian menunjukkan siapa yang memegangnya. Telegram memberi tanggal pada setiap postingan di kanal publik, dan `verify.py --channel https://t.me/s/…` membaca tanggal tersebut sebagai waktu eksternal. Saksi membuktikan status jurnal yang dilaporkan oleh pengumpul. Gunakan uji pengiriman terkontrol untuk mengukur tindakan Telegram mana yang sampai ke akun pengumpul. Lihat [pengaturan saksi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/). ## Pengujian pengiriman terhadap tindakan yang diketahui Gunakan kelompok terkontrol, akun pengumpul yang terpisah, dan penanda baru. Kirim, edit, dan hapus secara sengaja, sambil memeriksa hasil pencatatan di antara setiap tahap. Tentukan tindakan yang diharapkan serta batas waktu sebelum memeriksa hasilnya. R = |observed∩expected| / |expected| Δ t = treceipt - taction Hanya tindakan yang sesuai dengan yang diharapkan yang dihitung; tanda terima ganda tidak menambah pembilang. Penyebut harus bukan nol. Tanda terima yang hilang tidak memiliki penundaan yang terukur. Dokumentasikan ketidakpastian waktu; gunakan waktu tindakan penghapusan terkontrol Anda sendiri, karena Telegram tidak menyediakan waktu penghapusan yang tepat. Hasil seperti 5/6 (83,3%) menggambarkan tindakan pengujian, bukan kelengkapan seluruh lalu lintas Telegram. ## Pilih alur kerja [Panduan penyelidikan lengkap](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/) berikut ini menguraikan alur kejadian yang terjadi di saluran, grup, bot, dan obrolan pribadi: 1. Pada akun pengumpulan khusus, aktifkan mode Investigasi seluruh akun dan buat inventaris obrolan yang dapat diakses. Gunakan obrolan yang dipilih atau folder untuk akun utama. 2. Peroleh cuplikan jurnal, riwayat lengkap per obrolan, dan lampiran yang disimpan. 3. Simpan perubahan secara real-time dan setiap interaksi panel yang disengaja beserta bukti transaksinya. 4. Lacak ID pengirim numerik, hubungan balasan, tujuan yang berulang, dan hash file melalui catatan yang dikutip serta profil pengguna. 5. Tambahkan catatan dan koleksi yang tertaut ke sumber di Case Board. Rekonstruksi garis waktu lintas obrolan dengan cap waktu dan celah yang jelas. 6. Bandingkan ruang kerja akun lain sambil tetap memisahkan asal-usul dan kuncinya. 7. Kumpulkan dan verifikasi jurnal yang telah ditandatangani, profil, serta ekspor riwayat bersama dengan catatan kasus. Panduan di situs web pada bagian `/docs/cases/` mencakup peta kasus interaktif dan varian untuk sengketa bot, pesan yang dihapus, dan peserta yang mengganti nama. Case Board menyimpan catatan dan koleksi di dalam ruang kerja. Ekspor grup mengumpulkan paket ruang kerja terpisah; korelasi lintas ruang kerja dan garis waktu gabungan tetap menjadi tugas analis. [Validasi yang telah diselesaikan dan pekerjaan yang masih harus dilakukan](https://phishdestroy.io/tgwitness/id/docs/reference/verification/) · [Ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#investigation-handoff) · [Mulailah dengan satu akun](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/) --- # Telegram · Konfigurasi dan verifikasi laporan Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/ Filter laporan, delapan desain, preset konten, riwayat perubahan yang disimpan, dan penilaian yang disertakan dalam ekspor yang telah ditandatangani. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Filter laporan, delapan desain, preset konten, riwayat perubahan yang disimpan, dan penilaian yang disertakan dalam ekspor yang telah ditandatangani. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penyelidikan](https://phishdestroy.io/tgwitness/id/docs/reference/investigation/) ![Penyelidikan](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Ubah pengamatan yang dipilih menjadi laporan kasus yang mudah dibaca: pertanyaannya, ruang lingkupnya, perubahan yang disimpan, bagan, temuan, dan referensi sumber. Setiap laporan memberikan penerima cara untuk memeriksa materi yang dikirimkan dan meninjau cakupan pengumpulannya. Bagian **Dasar kepercayaan** muncul dalam laporan jurnal, serah terima, obrolan, akun, dan berbagi. PDF jurnal dan serah terima menggunakan penilaian yang sama dengan `report.json` yang ditandatangani. Manifest ZIP menyertakan `case_assessment` dalam manifest yang ditandatangani. Penilaian ini menyertai materi yang diekspor. Pengamatan asli tetap mempertahankan tanda tangan yang ada. ## Format dokumen dan urutan pembacaan ### Studio Laporan Buka **Ekspor → Konfigurasi dan pratinjau**. Lanjutkan ke **Data → Desain & konten → Pratinjau**: 1. Gunakan seluruh ruang kerja atau pilih obrolan, penulis, termasuk tanggal pengamatan UTC dan jenis peristiwa. Muat katalog untuk mencari obrolan dan penulis, atau masukkan ID Telegram mereka. Filter penulis mencocokkan ID pengirim yang terekam; pemberitahuan penghapusan tanpa pengirim tidak cocok dengan filter penulis. 2. Pilih desain halaman, lalu pilih bagan, label peserta, transkrip, dan temuan tertulis Anda. Mengubah desain akan mempertahankan pilihan-pilihan ini. 3. Buat pratinjau. Pratinjau ini menampilkan jumlah aktual, aktivitas, peserta, contoh catatan, perubahan yang disimpan, dan rentang nomor pesan yang hilang. Mengubah pilihan akan membuat pratinjau menjadi kedaluwarsa. Simpan sebelum mengunduh HTML, PDF yang ditandatangani, JSON yang ditandatangani, atau ZIP bukti. Pratinjau data menghitung prefiks jurnal stabil secara lengkap, bukan sampel awal. Hanya baris sampel yang ditampilkan dan daftar panjang yang dibatasi; jumlah yang dihilangkan ditampilkan. Ekspor selanjutnya akan mengambil snapshot stabil yang baru, sehingga pengumpulan yang sedang berlangsung dapat meningkatkan angka-angka tersebut. Cakupan, jumlah, dan identitas sumber disertakan dalam laporan yang ditandatangani. Membuka atau melihat pratinjau formulir tidak akan menyimpannya. **Panduan yurisdiksi.** Di bawah Detail dokumen, buka **Panduan yurisdiksi · opsional** untuk memilih yurisdiksi serta prosedur perdata/komersial atau pidana. Lampiran berisi dasar hukum, tautan sumber, catatan persiapan, dan status penelitian. Ringkasan dan penjelasan dalam bahasa lokal tentang pengamanan pengumpulan bersifat opsional. Tidak ada yurisdiksi yang dipilih secara default. Pilihan-pilihan ini merupakan bagian dari ruang kerja, dan dikecualikan dari konfigurasi tata letak yang disimpan serta pengaturan default implisit untuk berbagi dan menyalin. Lihat [pengaturan default, laporan yang didukung, dan batasan penelitian](https://github.com/phishdestroy/TgWitness/blob/main/docs/JURISDICTION_GUIDANCE.md) . **Pilih salinan untuk penerima.** Bagan dan transkrip menggunakan catatan yang dipilih. Integritas, penyimpanan, dan cakupan menggambarkan jurnal sumber secara lengkap. File ZIP bukti berisi catatan asli dan lampirannya. Gunakan [serah terima yang dipersempit](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#handover-extract) jika penerima hanya perlu menerima data yang dipilih dan diizinkan. ### Baca perubahan, penghapusan, dan ID yang hilang Pengeditan menampilkan teks **Sebelum** dan **Sesudah** yang disimpan serta menyoroti kata-kata yang diubah. Penghapusan menampilkan versi terakhir yang disimpan sebelum pemberitahuan. Jika tidak ada konten sebelumnya yang terekam, laporan akan mencantumkannya. Saat Anda memilih hanya pengeditan atau penghapusan, versi sebelumnya tetap tersedia sebagai konteks yang diberi label secara eksplisit di luar filter. Pesan yang tidak terkait tidak ditambahkan ke riwayat ini. **ID pesan yang tidak teramati** adalah celah antara angka-angka yang diketahui dalam obrolan yang dipilih dan rentang ID yang diturunkan dari tanggal. Setiap catatan sumber yang diketahui diperiksa sebelum menyatakan suatu angka sebagai tidak teramati: menyaring penulis lain, jenis peristiwa, atau tanggal tidak dapat menciptakan celah palsu. Pesan-pesan yang disimpan di sekitarnya diberi label sebagai konteks. Angka yang hilang menandai posisi yang tidak teramati; pemberitahuan penghapusan dan pemeriksaan ulang yang gagal dilaporkan sebagai jenis peristiwa tersendiri. ### Pilih desain Sembilan desain halaman tersedia untuk laporan HTML jurnal dan obrolan tunggal serta laporan PDF bertanda tangan. Semuanya memakai catatan dan perhitungan yang sama, dengan sampul, tipografi, judul bab, tabel, dan spasi yang berbeda. | Desain | Gaya penulisan | | --- | --- | | Klasik | Sebuah berkas tradisional dengan sampul berwarna gelap dan bagian-bagian yang diberi nomor. | | Editorial | Halaman judul berbingkai dengan huruf serif, margin lebar, dan daftar isi bab yang ramping. | | Pengarahan | Sampul ringkas dengan punggung berwarna biru tua, judul-judul singkat, dan tabel dengan spasi yang rapat. | | Analisis | Sampul bergaya survei, lembar bagan modular, dan gambar dengan spasi monospaced. | | Teknis | Buku catatan bergaris, daftar referensi bernomor, dan tabel perbandingan yang akurat. | | Gambaran Umum | Sampul panorama, spasi yang lapang, dan gambar ringkasan yang menonjol. | | Seri bacaan | Sebuah bilah bagian dan bab-bab yang dikelompokkan untuk temuan, ruang lingkup, perubahan, dan jurnal pengamatan. | | Buku besar & margin | Bab-bab bernomor dengan margin lebar, tabel dan bagan yang tepat, serta transkrip pesan terpisah. | | Ringkasan profil | Angka utama, profil yang diamati, dan bagian yang dapat dicari dengan tautan ke catatan chat. | Desain disimpan per ruang kerja dan dicatat dalam manifes ekspor yang ditandatangani. HTML dapat berfungsi secara offline, mendukung tema terang dan gelap, serta beradaptasi dengan layar sempit dan bahasa yang ditulis dari kanan ke kiri. PDF asli menggunakan font yang disertakan; desain Editorial mencakup Noto Serif di bawah Lisensi Font Terbuka SIL yang disertakan. Seri bacaan serta Ledger & margin juga berlaku untuk ikhtisar akun, obrolan akun, dan salinan yang dibagikan. PDF dalam bahasa Mandarin, Jepang, dan Korea juga memerlukan font yang sesuai di server, seperti Noto Sans CJK, yang diinstal secara sistem atau ditempatkan di `TGWITNESS_FONT_DIR`. Jika font tersebut tidak tersedia, berkas ZIP akan menyimpan laporan HTML dan JSON. Kedua desain ini mencakup jurnal yang dapat dibaca tanpa JavaScript. Untuk ekspor berukuran besar, tampilan ini menampung hingga 500 catatan lengkap dalam batas input 8 MiB; laporan tersebut mencantumkan batas tersebut dan menautkan ke penampil lengkap serta catatan sumber. Direktori akun dan indeks hubungan menggambarkan sampel bacaan yang sama, bukan semua peserta. Bagan jurnal lengkap mempertahankan cakupan yang dinyatakan secara terpisah. ### Pilih kontennya | Daftar isi yang telah ditentukan | Disertakan secara default | | --- | --- | | Berkas kasus (disarankan) | Aktivitas, waktu pengamatan, peserta, obrolan, dan transkrip rekaman. | | Pengarahan | Gambaran umum aktivitas tanpa peringkat peserta atau transkrip. | | Tinjauan aktivitas | Aktivitas, waktu pengamatan, peserta, obrolan, dan komposisinya, beserta referensi sumber dan angka yang tepat. | | Laporan khusus | Kombinasi diagram, transkrip, dan pratinjau sesuai keinginan Anda. | Mengubah preset akan mempertahankan desain, detail kasus, dan analisis tertulis Anda. Pemeriksaan integritas, cakupan, catatan pembacaan, dan petunjuk verifikasi tetap ada di setiap desain. Catatan sumber dalam ZIP tetap tidak berubah saat bagan atau transkrip disembunyikan. **Catatan Pemeriksaan** opsional berisi pertanyaan, metode, temuan, dan kesimpulan yang ditulis oleh penulis laporan. Cantumkan file sumber dan nomor catatan dalam temuan. Tanda tangan melestarikan pernyataan yang ditulis ini bersama dengan laporan; pengamatan sumber dan interpretasi penulis tetap dapat diidentifikasi. Serah terima yang dipersingkat menghilangkan catatan pribadi ini dan grafik jurnal lengkap. Pilihan grafik dan pemeriksaan berlaku untuk laporan jurnal. Pilih aktivitas berdasarkan waktu, peta panas hari kerja/jam UTC, peringkat peserta, peringkat obrolan, dan komposisi catatan. Pilih 5–30 grup yang diurutkan dan alias peserta netral atau ID akun. Pengirim yang tidak dikenal dan peserta lainnya ditampilkan dalam baris terpisah. Alias hanya memengaruhi grafik; catatan sumber tetap berisi identitas asli mereka. Pratinjau desain diperbarui dari draf yang belum disimpan menggunakan sampul produksi, pemeriksaan, dan komponen bagan, terbatas pada kecocokan dalam 50.000 catatan sumber pertama. Pratinjau data di bawah ini menghitung seluruh pilihan. Pratinjau ini secara eksplisit belum ditandatangani dan tidak menyimpan hasil pengeditan. Tombol Sampul dan Bagan berfungsi untuk mengganti bagiannya. Ini bukan pratinjau PDF yang lengkap. **Menyimpan pengaturan laporan** akan menerapkan pilihan tersebut ke ekspor di masa mendatang; file yang sudah ditandatangani tidak dapat diubah. PDF menggunakan sampul yang dipilih, tipografi, tata letak bab, dan agregat yang sama seperti yang dipilih untuk HTML dan JSON yang ditandatangani. Penilaian kepercayaan, cakupan, dan petunjuk verifikasi tetap ada. Menyembunyikan grafik atau transkrip yang dapat dibaca tidak menghapus baris sumber otoritatif dari ZIP. Seri grafik yang dinonaktifkan dihilangkan dari JSON analitis; gunakan ekspor yang diminimalkan untuk membatasi pengungkapan catatan sumber. Filter pemilihan data berlaku untuk laporan jurnal; ekspor akun dan ekspor untuk dibagikan tetap memakai cakupan perolehan dan pengungkapannya sendiri. Pilihan dapat mencakup obrolan utuh, penulis, tanggal UTC, jenis catatan, dan pesan tertentu. Pesan yang ditandai di obrolan dengan **Pilih** masuk sebagai **Pesan terpilih**; laporan lalu mencakup catatan pesan tersebut dan obrolan yang dipilih utuh, serta mencantumkan nomor pesan yang dipilih di bawah **Data yang dipilih**. Nomor pesan yang hilang dan catatan di sekitarnya hanya dilaporkan untuk obrolan yang dipilih utuh. **Tambahkan nomor pesan** di bawah daftar obrolan menambahkan pesan tanpa membuka obrolan: satu baris per obrolan berisi ID obrolan, titik dua, dan nomor pesan, atau tautan `t.me/c/…` ke pesan tertentu. Preferensi desain/bagan yang dibagikan dibekukan ke dalam ekspor obrolan/akun baru dan pratinjau pembagian akun. Pengaturan bahasa dan privasi akun/pembagian tetap independen; catatan kasus dan pemeriksaan pribadi tidak disalin ke dalam ekspor ini. Laporan akun dan pembagian tetap dalam format HTML yang dilindungi oleh manifes arsip yang telah ditandatangani. Jurnal, serah terima jurnal yang dipersingkat, dan paket obrolan tunggal juga menyediakan PDF yang ditandatangani. ### Apa yang dihitung oleh bagan-bagan tersebut Aktivitas jurnal dan peta panas menghitung **pengamatan** baru, historis, yang dipulihkan, diedit, dihapus, dan yang hilang saat diperiksa ulang, berdasarkan waktu pengamatan pengumpul dalam UTC. Heartbeat dan tanda terima lampiran tidak termasuk. Peringkat peserta hanya menghitung pengamatan pesan baru, historis, dan yang dipulihkan: pengirim tidak dinyatakan sebagai pengedit atau penghapus. Pengamatan berulang dapat menggambarkan pesan Telegram yang sama. Analisis jurnal menyimpan jumlah berdasarkan jenis, referensi catatan pertama/terakhir, dan SHA-256 sumber `events.jsonl`. Angka-angka mencakup nilai pasti dalam HTML dan PDF. Kelompok harian beralih ke bulan setelah 366 hari yang tercatat; grafik menggabungkannya menjadi maksimal 36 interval dengan lebar yang sama. Lebih dari 100.000 pengenal unik atau 1.200 tanda bulan menyebabkan grafik yang bersangkutan tidak tersedia, sementara jumlah keseluruhan yang tepat tetap tersedia. Bagan snapshot dan berbagi akun hanya menghitung baris pesan non-layanan yang disertakan, dengan menggunakan waktu pesan yang tercatat. Agregat berbagi dihitung setelah penyuntingan dan penyaringan. Bagan-bagan ini menggunakan paling banyak 90 interval tanggal UTC dengan lebar yang sama dan menyimpan hingga 10.000 nilai pengelompokan; jumlah yang melebihi batas tersebut dinyatakan secara eksplisit dan direkonsiliasi. Interval terakhir mungkin lebih pendek. Tanggal yang tidak diketahui atau tidak valid tidak dimasukkan ke dalam grafik waktu. Interval kosong berarti tidak ada pengamatan yang disertakan; periksa cakupan untuk mengetahui celah. Bagan-bagan ini menggambarkan aktivitas yang disimpan. Pengirim yang tidak dikenal tetap menjadi kategori terpisah, dan setiap pemeriksaan dilaporkan secara terpisah. Jika disertakan, `analytics.json` dilindungi oleh hash file yang ditandatangani dari arsip. `report.json` jurnal menyematkan agregat terpilih yang sama. Verifikasi tanda tangan mendeteksi byte yang berubah. Untuk memeriksa angka-angka tersebut, hitung ulang agregat jurnal dengan `report_analytics.Analytics` dan `selected`, atau agregat snapshot dengan `snapshot_analytics.collect` dan `project`. ### Indikator anomali **Pratinjau.** Laporan bukti menambahkan bagian **Indikator anomali** yang dihitung oleh prosesor terdaftar (`tgwitness/metrics/`, satu berkas per metrik). Laporan tersebut mencantumkan setiap prosesor yang dijalankan beserta versinya, dan mencantumkan metodenya di bawah tabelnya, sehingga perhitungan dapat diulang dari `events.jsonl` dengan `tgwitness.metrics.run`. | Prosesor | Apa yang ditampilkannya | | --- | --- | | `first_time_posters_over_time` v1 | Pengguna baru dan pesan per hari UTC. Sebuah bendera memerlukan setidaknya lima pengguna baru dan tiga kali mediannya, dengan volume pesan paling banyak 1.5 kali mediannya. Garis dasar menggunakan setidaknya tujuh hari yang diamati dalam 14 hari kalender sebelumnya, setelah tujuh hari pemanasan. | | `service_vs_message_ratio` v1 | Nomor pesan yang disimpan berbeda-beda untuk setiap obrolan, serta bagian yang digunakan oleh pesan layanan. Dokumen ini menjelaskan sistem penomoran; bukan menjelaskan nomor tertentu yang hilang. | | `join_leave_per_month` v1 | Jumlah pengguna yang bergabung, keluar, dihapus, atau diblokir per bulan, satu per orang, obrolan, perubahan, dan hari. | | `pinned_per_month` v1 | Pesan layanan yang disematkan, pemberitahuan yang dilepas dari penyematan, serta pesan yang disematkan yang ditambahkan atau dihapus di antara snapshot status obrolan, per bulan. | **Alat lainnya → Parameter → Metrik laporan** memilih prosesor dan jumlah baris yang ditampilkan, termasuk dalam laporan yang difilter. Tabel harian dan bulanan menampilkan baris terbaru, sedangkan tabel pembagian layanan mengurutkan obrolan berdasarkan jumlah pesan yang disimpan. Total mencakup setiap baris. Dari checkout sumber, buat kesembilan desain yang tercantum di atas dari jurnal fiktif yang sama: ``` python tools/build_report_styles.py --output test-results/report-styles ``` Buka berkas `index.html` yang dihasilkan untuk membandingkan laporan HTML lengkap, PDF yang telah ditandatangani, dan berkas ZIP. Setiap desain menggunakan jurnal sumber yang sama. Gunakan direktori keluaran baru untuk setiap proses agar contoh yang telah ditandatangani sebelumnya tetap terjaga. ![Dokumen HTML fiktif](https://phishdestroy.io/tgwitness/assets/dossier-en.png?v=62db26820986) Halaman HTML dibuka dengan sampul kasus dan angka-angka kunci. Peta bukti bernomor tertaut ke setiap temuan, fakta pendukungnya, batasan, dan tinjauan independen. Catatan yang dapat dicari serta referensi catatan yang stabil tetap tersedia di penampil offline. Desainnya dapat beradaptasi dengan layar sempit, baik tema maupun browser tanpa JavaScript. PDF yang telah ditandatangani memiliki sampul A4 khusus, referensi laporan dan QR, ringkasan eksekutif, peta bukti, temuan bernomor, dan penanda dokumen. Header dan footer halamannya mengidentifikasi laporan tersebut. QR mengidentifikasi materi; ini bukan hasil verifikasi independen. Cetakan dari browser terpisah dari PDF yang ditandatangani secara kriptografis ini. Garis waktu pengamatan menempatkan periode pengamatan yang terekam dan gangguan pada sumbu UTC yang sama. Ruang kosong tidak berarti cakupan yang disimpulkan; tabel terperinci mempertahankan interval yang tepat. File ZIP berisi laporan yang dapat dibaca, JSON yang ditandatangani, catatan sumber, dan petunjuk verifikasi. Buatlah berkas baru yang fiktif dalam bahasa Inggris/Rusia/Jerman dengan lingkungan pengembangan yang telah terinstal: ``` python tools/build_dossier_example.py --output test-results/my-new-dossier ``` Setiap direktori bahasa berisi `report.html`, `report.pdf`, `report.json`, dan `dossier.zip`. Direktori contoh yang sudah ada tidak akan pernah ditimpa. Tidak ada akun Telegram, layanan penanda waktu eksternal, atau koneksi jaringan yang digunakan untuk membuatnya. ![Tiga halaman pertama dari PDF fiktif yang telah ditandatangani](https://phishdestroy.io/tgwitness/assets/dossier-pdf.png?v=30a8d283dcc2) ## Membaca kasus konkret Untuk jurnal dengan 1,200 entri yang memiliki cap waktu tervalidasi pada entri ke-1,000, laporan tersebut mengidentifikasi 200 entri selanjutnya yang berada di luar batas cap waktu tersebut. Cap waktu menentukan batas atas kapan titik pemeriksaan tersebut ada; setiap pesan mempertahankan waktu pengirimannya sendiri dari Telegram. Jika tiga berkas cap waktu lainnya gagal validasi atau tidak dapat divalidasi, mereka dihitung secara terpisah dan tidak dapat memberikan kesimpulan positif. Stempel waktu yang dapat digunakan harus memenuhi semua pemeriksaan berikut: jejaknya cocok dengan titik pemeriksaan, tanda tangannya terhubung ke akar TSA tepercaya pada waktu yang dicap, dan tanda tangan, kunci, hitungan, serta kepala titik pemeriksaan tersebut cocok dengan awalan jurnal yang tepat. Hanya mengurai cap waktu atau memiliki tanda terima OTS saja tidak cukup. Pembaca harus secara mandiri memilih akar TSA tepercaya dan mengulangi verifikasi. OTS memerlukan pemeriksaan konfirmasi Bitcoin-nya sendiri. | Status laporan | Arti | | --- | --- | | Telah diperiksa selama proses ekspor | Eksportir telah melakukan pemeriksaan yang disebutkan; pengulangan secara independen masih diperlukan. | | Telah direkam; perlu ditinjau | Pengamatan atau pernyataan operator yang mendasari dicatat; hal ini bukanlah konfirmasi independen. | | Tidak termasuk dalam salinan ini | Teks tersebut tidak memiliki bukti pendukung untuk klaim ini. Teks tersebut juga tidak menyatakan bahwa tidak ada bukti serupa di tempat lain. | | Belum diverifikasi secara independen | Laporan ini tidak memberikan hasil verifikasi independen. | | Tidak lengkap atau tidak tersedia | Ada materi atau pemeriksaan yang diperlukan yang hilang, tidak lengkap, atau tidak berhasil. | Tinjau setiap pemeriksaan secara terpisah, bersamaan dengan cakupan pengumpulan yang tercatat. ## Apa saja yang harus dipertahankan dalam konfigurasi yang kuat 1. Sebelum mengandalkan proses pengumpulan, simpan sidik jari kunci pengumpul melalui saluran tepercaya yang terpisah. Bandingkan referensi tersebut dengan kunci penandatanganan ekspor. 2. Pertahankan titik pemeriksaan yang diberi cap waktu secara independen dan, jika digunakan, jurnal saksi di luar kendali administratif pengumpul. Bandingkan dengan jurnal yang diekspor untuk memeriksa batas-batas sebelumnya. 3. Cakupan akuisisi catatan, celah, filter, batasan, dan perubahan dalam pengumpulan. Jelaskan periode yang hilang yang relevan dengan klaim yang sebenarnya, dengan tetap membedakan ID pesan yang tidak teramati, pemberitahuan penghapusan, dan pemeriksaan ulang yang gagal. 4. Pertahankan file ZIP asli beserta hash-nya. Catat setiap pemegang, transfer, tanggal, dan tujuan. Pertahankan pernyataan operator yang dikaitkan serta catatan kasus bersama dengan data tersebut. 5. Untuk VM rahasia, pertahankan dan verifikasi secara independen kutipan, tantangan, rantai sertifikat Intel, pengukuran, sumber yang tepat, dan kondisi penanganan kunci. Simpan hasil verifikasi attestation bersama artefak yang telah ditinjau. Lihat [ruang lingkup verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#verification-scope) untuk pemeriksaan akuisisi, integritas arsip, waktu, dan cakupan pengumpulan dalam setiap mode. ## Tinjauan penerima Gunakan instalasi TgWitness yang tepercaya dan sidik jari yang diperoleh secara independen: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca tsa-root.pem python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL --require-witness python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --check-drand ``` Perintah kedua dan ketiga dapat memenuhi syarat minimum untuk bukti: cap waktu yang diverifikasi, atau tanggal yang ditetapkan Telegram pada postingan saksi, memberikan waktu eksternal untuk catatan terakhir. File ZIP saksi harus berasal dari sumber tepercaya yang independen; jaga juga kunci dan asal-usulnya. Simpan perintah, versi alat, keluaran, hash masukan yang telah ditinjau, serta pertanyaan yang belum terjawab. Verifikasi beacon adalah pemeriksaan daring terpisah; pembuat laporan tidak pernah menghubungi layanan hanya untuk menampilkan laporan. Untuk sengketa terkait pesan tertentu, cantumkan referensi arsip, referensi berkas dan catatan yang sah, lalu jelaskan rentang waktu yang relevan, celah cakupan, pemilihan, dan bahan pendukung. Untuk salinan yang dibagikan, tinjau juga transformasi yang tercatat beserta referensinya ke arsip sumber. Filter pribadi dan pemetaan identitas tidak termasuk dalam penilaian publik. Verifikasi PDF yang ditandatangani mendeteksi perubahan pada byte yang tercakup. Simpan file digital asli dan hasil verifikasi bersama dengan tangkapan layar atau salinan cetak untuk dibaca. --- # Telegram · Ekspor akun Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/account-export/ Ekspor apa yang dapat dibaca oleh suatu akun saat ini: cakupan, tugas yang dapat dilanjutkan, arsip yang telah ditandatangani, dan salinan berbagi yang telah diminimalkan. [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. Ekspor apa yang dapat dibaca oleh suatu akun saat ini: cakupan, tugas yang dapat dilanjutkan, arsip yang telah ditandatangani, dan salinan berbagi yang telah diminimalkan. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bukti dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) ![Bukti & verifikasi](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) Ekspor akun akan mengamankan slot akuisisi akun tersebut. Pengamatan langsung dapat berlanjut sementara arsip sedang dicari, diunduh, diverifikasi, dan dikemas. Jeda tugas riwayat atau ekspor lainnya sebelum memulai akuisisi yang bersaing. Menjeda arsip akan membuat pengamatan tetap berjalan, sedangkan menjeda pengamatan akan mempertahankan tugas arsip. Ekspor pada akun yang berbeda dapat dijalankan secara bersamaan. Pekerjaan yang hanya berupa pengambilan data (Takeout) yang sedang menunggu persetujuan akan melepaskan akunnya, sehingga ekspor sesi reguler terpisah dapat dimulai selagi persetujuan masih dalam proses. Proses akuisisi yang masih aktif tetap mengunci akun tersebut. Sebagai administrator instalasi, pilih **Beranda → Ekspor akun saya**, atau **Ekspor → Akun Telegram → Konfigurasi ekspor akun**. Masuk jika diperlukan, tinjau cakupannya, dan mulai ekspor secara eksplisit. Pengamatan berkelanjutan tidak diperlukan. **Pengamatan yang disimpan** adalah ekspor terpisah dari jurnal yang ada; ZIP-nya mencakup semua sumber terlepas dari filter jurnal. Setiap ruang kerja memiliki tugas, identitas penandatanganan, dan penyimpanan sendiri. Akses panel yang diberikan, termasuk izin ekspor biasa tanpa batasan, tidak dapat membuka rute-rute yang mencakup seluruh akun ini. Filter pengirim dan teks dapat diperluas di bawah **"Filter berdasarkan pengirim atau teks pesan**". Bagian "**Data akun & metode koneksi"** berisi kategori akun opsional dan pilihan "Takeout" atau "sesi reguler"; ringkasannya menampilkan pilihan yang aktif meskipun panel tersebut ditutup. Menutup bagian-bagian ini akan mempertahankan pengaturannya. Draf ekspor dan laporan tetap ada di sesi panel saat ini saat berpindah tampilan; draf tersebut tidak disimpan saat browser dimuat ulang. Pekerjaan yang sudah ada tetap dapat diakses dari kedua pilihan ekspor tersebut. Alur kerja ini mengekspor data yang saat ini dapat diakses oleh akun yang terhubung. Metode **Otomatis** default dimulai dengan [Telegram Takeout](https://core.telegram.org/api/takeout), yang mengembalikan riwayat yang dapat diakses dalam keadaan saat ini, termasuk saluran yang ditinggalkan, kontak yang disimpan, dan data akun lainnya. Jika Telegram memberlakukan periode tunggu sebelum Takeout dimulai, Otomatis langsung melanjutkan dengan sesi reguler; jurnal mencatat `account_export.transport` dan inventaris yang ditandatangani menyebutkan metode yang digunakan serta mencantumkan perubahan tersebut sebagai penghilangan. **Sesi Telegram Takeout hanya** menunggu persetujuan, sedangkan **sesi Reguler tidak** pernah meminta Takeout. Obrolan Rahasia direkam secara langsung oleh [modul Obrolan Rahasia](https://phishdestroy.io/tgwitness/id/docs/reference/secret-chats/), dan pengeditan dilakukan melalui pengamatan langsung. Sesi reguler memiliki cakupan yang berbeda dan mencatat kategori yang tidak didukung. **Beranda → Ekspor semuanya** akan memulai proses ekspor yang mencakup semua jenis obrolan, semua jenis lampiran, profil, kontak, foto profil, cerita, metadata sesi, dan data akun lainnya, dalam semua format: arsip TgWitness yang ditandatangani dengan tampilan JSON dan HTML Telegram Desktop. **Pilih apa yang akan diekspor** akan membuka formulir di bawah ini dengan pengaturan default yang sama. Takeout adalah API ekspor resmi yang juga digunakan oleh Telegram Desktop. TgWitnessdapat menulis JSON yang kompatibel dengan Desktop langsung dari akuisisi sendiri; mengimpor arsip milik orang lain tidak diperlukan. ID obrolan dan pesan tersedia melalui kedua saluran tersebut. Kecepatan ekspor dan penundaan persetujuan Takeout bergantung pada batasan Telegram untuk akun tersebut, serta apakah obrolan bersifat publik atau dapat diteruskan. Ukur cakupan dan pengaturan media yang sama sebelum membandingkan kecepatan. Untuk hingga 20 ID obrolan yang dipilih secara eksplisit, ekspor API reguler menyelesaikan rekan-rekan tersebut secara langsung sebelum mempertimbangkan inventaris dialog lengkap akun tersebut. Saluran publik yang dapat dibaca karenanya dapat diekspor tanpa harus bergabung dengannya, bahkan ketika saluran tersebut tidak ada dalam daftar dialog. Mitra yang tidak tersimpan dalam cache akan kembali ke inventaris biasa. Filter arsip tetap diberlakukan: jika Telegram tidak mengembalikan dialog dan obrolan yang diarsipkan dikecualikan, status arsip yang tidak diketahui dicatat sebagai kelalaian. Takeout mempertahankan prosedur inventaris rentang terpisah. Kedua jalur tersebut tidak bergabung dengan obrolan atau mengubah izin penerusan. Dalam format JSON yang kompatibel dengan Desktop, saluran yang ditandai Telegram sebagai `left` muncul di bawah `left_chats`, termasuk saluran publik yang dapat dibaca yang belum diikuti oleh akun tersebut. Baik permintaan jeda `FLOOD_WAIT` maupun `FLOOD_PREMIUM_WAIT` berlaku selama seluruh periode yang diminta server. Batas waktu akun tetap berlaku meskipun terjadi koneksi ulang dan restart; waktu tunggu yang lebih singkat di kemudian hari tidak dapat memperpendeknya. Upaya ulang dibatasi, pembatalan mempertahankan halaman yang disegel, dan kredensial API tidak diganti untuk menghindari batasan laju. Tidak ada pembelian Premium yang dilakukan. ## Pilih apa yang akan dikumpulkan | Pengaturan | Arti | | --- | --- | | Tujuan | Catat alasan mengapa akuisisi ini diperlukan. Jangan cantumkan nama yang tidak perlu atau detail kasus yang sensitif di sini. | | Bahasa laporan | Pilih bahasa untuk label pada laporan yang dapat dibaca. Teks pesan asli tetap tidak berubah; label templat yang belum diterjemahkan menggunakan bahasa Inggris. Bahasa tersebut ditetapkan melalui opsi pekerjaan yang telah ditandatangani. | | Jenis obrolan / ID obrolan | Semua jenis yang dipilih, atau hanya obrolan yang tercantum; Pesan yang Disimpan termasuk dalam obrolan pribadi. Obrolan yang diarsipkan dapat dipilih secara terpisah. | | Tanggal | UTC. Tanggal kalender "Dari" dan "Sampai" pada panel tersebut keduanya disertakan. API ini menggunakan rentang waktu inklusif `from_utc` dan eksklusif `to_utc`; panel ini mengirimkan awal hari setelah tanggal "Through". Batas yang kosong berarti sisi tersebut tidak dibatasi. | | ID Pengirim | Hanya pesan dari pengirim yang tercantum; daftar kosong mencakup semua pengirim. | | Teks berisi | Frasa literal yang tidak membedakan huruf besar-kecil, dicocokkan dengan operator OR. Kondisi pengirim/tanggal/pesan sendiri digabungkan dengan operator AND. | | Pesan sendiri | Simpan hanya pesan yang dikirim. | | Jenis media | Pilih kategori lampiran, atau hapus semuanya untuk menghindari pengunduhan berkas pesan. | | Batas file / total media | Ukuran per file dalam MiB dan total media yang diunduh dalam GiB. Teks, tanda terima, laporan yang dapat dibaca, dan overhead ZIP memerlukan ruang disk tambahan. | | Kategori akun | Profil, kontak, foto profil, cerita, metadata sesi, dan data Takeout lainnya memiliki pengaturan terpisah. | Preset **koleksi "Minimize**" menonaktifkan file dan metadata akun. Filter pengirim/konten diterapkan sebelum halaman pesan yang disimpan dan unduhan media. Telegram tetap mengirimkan halaman riwayat API yang berisi pesan yang diperlukan untuk mengevaluasi filter tersebut: penyaringan bukanlah jaminan bahwa pesan yang tidak dipilih tidak akan pernah masuk ke memori proses. Pengamatan lain yang sedang berlangsung di ruang kerja memiliki cakupan dan pengaturan penyimpanan tersendiri. Riwayat foto profil, cerita, metadata sesi, dan data akun lainnya dipilih secara default. Nonaktifkan opsi tersebut, serta profil dan kontak, jika kasus hanya memerlukan pesan. Jika lampiran atau metadata tidak diperlukan, mengesampingkannya selama proses pengambilan data akan mencegah penyimpanan salinan pribadi tambahan dalam ekspor ini. Payload foto menggunakan varian gambar diam yang diidentifikasi dalam metadata dan manifest hash-nya, termasuk foto dengan varian avatar animasi. Animasi tersebut tidak digantikan oleh gambar diam yang dipilih. Payload yang lebih pendek atau lebih panjang dari ukuran yang diamati akan dicatat sebagai lampiran yang gagal, dan representasi yang berubah selama pembaruan referensi file akan ditolak. Kegagalan ini membuat arsip menjadi tidak lengkap namun tetap mempertahankan catatan pesan. Verifikasi independen juga menolak lampiran yang disimpan yang panjang tanda tangannya bertentangan dengan ukuran atau representasi yang diamati, termasuk dalam arsip yang lebih lama. Jika koneksi media khusus mengalami gangguan sementara, proses pembacaan lampiran akan menggunakan koneksi file standar. Setelah satu menit, rute khusus akan dicoba kembali di latar belakang sementara proses pengunduhan tetap berlanjut. Pemulihan ini tetap mempertahankan batas koneksi yang telah dikonfigurasi dan berlaku secara terpisah untuk setiap pusat data. Masalah banjir pesan Telegram dan kegagalan otorisasi tetap tersebar. ## Nomor pesan dan peta aktivitas Setiap arsip akun berisi `message-gaps.json` dan `map.html`. Saluran dan supergrup menomori pesan mereka per obrolan, sehingga setiap nomor yang tidak ada di antara pesan pertama dan terakhir yang diekspor merupakan pesan dari obrolan tersebut. Obrolan pribadi, bot, dan grup dasar menggunakan satu urutan nomor untuk seluruh akun: nomor yang tidak tercantum di sana berasal dari obrolan tertentu. Obrolan tersebut dapat dipastikan ketika balasan yang diekspor atau penanda mengacu pada nomor tersebut; jika tidak, obrolan tersebut diperkirakan berdasarkan obrolan mana yang aktif pada waktu antara pesan-pesan yang berdekatan, dan sisanya dikaitkan dengan obrolan yang tidak termasuk dalam ekspor. Setiap proses memiliki jendela waktu, pesan-pesan yang berdekatan, jumlah pesan per obrolan, dan label tingkat keyakinan. Ruang lingkup yang terbatas (filter, obrolan yang tidak dipilih) dinyatakan, karena nomor yang tidak tercantum kemudian mencakup pesan di luar pilihan tersebut. `map.html` menampilkan kalender, riwayat obrolan berdasarkan waktu, serta kisi-kisi per jam berdasarkan hari kerja untuk pesan dan nomor yang tidak tercatat, disertai tabel setiap obrolan dan rangkaian pesan terpanjang. Halaman obrolan menampilkan kalendernya sendiri, daftar peserta berdasarkan waktu untuk grup, serta tanda pada transkrip di mana pesan tidak tercatat. `verify.py` menghitung ulang `message-gaps.json` dari halaman yang telah ditandatangani dan menolak berkas yang telah diubah. Peta aktivitas mencantumkan celah saluran dan supergrup terbesar, termasuk rentang nomor serta waktu pesan yang berdekatan. Buka suatu rentang untuk melompat ke posisi yang ditandai dalam transkrip yang dibagi halaman. Penanda ini mencatat nomor yang tidak ada di antara nomor-nomor yang tersimpan; peristiwa penghapusan, waktunya, dan teks pesannya hanya berasal dari catatan yang tersimpan. Tabel yang lebar dapat digulir di dalam kartunya pada layar berukuran kecil. Transkrip yang panjang dilengkapi dengan indeks halaman yang mencakup rentang tanggal pesan dan kalender. Pilih sebuah bulan untuk membuka catatan pertamanya sesuai urutan halaman yang direkam. Penomoran bulan menggunakan tanggal pesan yang tercatat dalam UTC; catatan tanpa tanggal tetap ada dalam transkrip. Navigasi halaman mencakup halaman pertama, terakhir, dan halaman terdekat, serta membuka bagian pesan secara langsung. Indeks ini dapat berfungsi secara offline tanpa JavaScript. ## Ringkasan, cakupan, dan verifikasi Setiap tugas membekukan opsi dan identitas akunnya. Inventaris dan halaman yang ditangkap ditandatangani; catatan tanda terima halaman mencatat hash, kursor, waktu, hasil lampiran, dan tanda terima sebelumnya. Hanya halaman yang telah dikonfirmasi yang meningkatkan kemajuan. Fitur restart/resume memeriksa catatan-catatan tersebut sebelum melanjutkan. Akun yang diubah, halaman yang ditandatangani yang diubah, atau rantai tanda terima yang tidak konsisten akan ditolak. Opsi tidak dapat diedit di tengah proses akuisisi: mulailah tugas lain untuk cakupan yang berbeda. Tombol "Pause" menghentikan operasi akun yang sedang berjalan. Memulai ulang aplikasi akan membuat pekerjaan yang belum selesai tetap tersedia untuk dilanjutkan secara eksplisit. Sesi Takeout yang telah kedaluwarsa memerlukan dilanjutkan secara eksplisit; mengubah rentang pemotongan Telegram mungkin memerlukan akuisisi baru. Fitur "Resume" mempertahankan pengamatan sebelumnya, sehingga ekspor yang berjalan lama bukanlah satu snapshot atomik. Operasi perubahan akun lainnya dan ekspor yang bertentangan diblokir selama proses akuisisi. Tunggu hingga pengemasan selesai sebelum menghapus ruang kerja. Fitur "Lanjutkan" langsung menampilkan pesan **Memverifikasi data ekspor yang tersimpan…** dan memeriksa konten yang tersimpan di latar belakang sebelum terhubung ke Telegram. Panel tetap dapat diakses selama proses verifikasi berlangsung. Fitur "Jeda" menunggu hingga proses verifikasi selesai dengan aman sebelum melepaskan akun; fitur ini juga berfungsi jika ditekan segera setelah memulai atau melanjutkan proses. Pada penyimpanan yang lambat, waktu tunggu tersebut bisa cukup lama. Jika pemeriksaan integritas gagal, akan muncul status pekerjaan gagal beserta penjelasannya, dan berkas-berkasnya tetap disimpan. Jika Telegram menghentikan otorisasi akun selama proses pengambilan data inventaris, riwayat, atau lampiran, tugas akan ditangguhkan tanpa menandai halaman yang belum selesai sebagai selesai. Sambungkan kembali akun yang sama dan lanjutkan untuk melanjutkan dari halaman terakhir yang disimpan. Penanda pesan yang tidak tersedia akan memajukan kursor riwayat, tetapi tidak mengakhiri proses pembacaan: pesan-pesan lama yang tersedia masih akan diminta, dan penanda tersebut tidak ditampilkan sebagai pesan yang telah diambil atau penghapusan yang telah dikonfirmasi. The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed. File ZIP yang sudah selesai tetap tersedia untuk diunduh berulang kali maupun melalui HTTP-range. Arsip akun berisi `manifest.json`, `manifest.sig`, `job.json` yang telah ditandatangani, `inventory.json`, `receipts/`, `data/*.jsonl` yang otoritatif, `media/` yang dipilih, HTML yang dapat dibaca, dan verifikator. Simpan sidik jari pengumpul melalui saluran independen, lalu verifikasi menggunakan instalasi tepercaya. Panel menyimpan arsip tersebut sebagai `tgwitness-account-export-EXPORT_ID.zip`; penangkapan yang disegel menyertakannya di dalam arsip buktinya sebagai `account-export.zip`. Gunakan nama berkas yang Anda miliki: ``` python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256 ``` Untuk arsip yang isi terperluasnya melebihi 4 GiB, tetapkan ukuran yang memadai secara eksplisit `--max-gib`. Panel ini memverifikasi arsip lokalnya yang telah diautentikasi dan selesai menggunakan ukuran yang dinyatakan setelah diekspansi serta ringkasan (ZIP) yang dipublikasikan; CLI eksternal mempertahankan batas ukurannya sendiri. Lakukan verifikasi sebelum membuka HTML yang dapat dibaca. Verifikator bawaan arsip memang praktis, tetapi verifikator yang diperoleh secara independen menghindari ketergantungan pada kode yang dapat dieksekusi yang disertakan bersama bukti tersebut. Tanda tangan Ed25519 dan hash SHA-256 mendeteksi perubahan setelah pengumpul (collector) menyimpan byte yang relevan. Tinjau hasil tersebut bersama dengan cakupan pengumpulan yang tercatat, interval akuisisi, tanda waktu eksternal, dan pemeriksaan asal-usul yang tersedia untuk penyebaran yang dipilih. Pengamatan selanjutnya dicatat secara terpisah, dengan tetap mempertahankan versi yang telah ditangkap sebelumnya. ## Siapkan pengungkapan informasi untuk pengacara atau penerima lainnya Setelah mengunduh ekspor yang sudah selesai, simpan gambar asli ZIP dan buka `index.html` dari salinan yang telah diekstrak. Laporan ini menjelaskan cakupan, jangkauan yang tersedia, dan batasannya. Referensi catatannya menggabungkan referensi arsip, jalur dokumen, dan nomor catatan, sehingga penerima dapat menemukan entri yang sama dalam HTML atau hasil cetakan. Untuk contoh yang sudah diterapkan, lihat [buka laporan fiktif](https://phishdestroy.github.io/TgWitness/demo/report/). Dari ekspor akun yang sudah selesai, pilih **"Siapkan salinan untuk dibagikan**". Ini akan membuat turunan terpisah yang telah ditandatangani. Sumber ZIP tetap tidak berubah dan bersifat pribadi; jangan mengirimkannya bersama dengan turunan yang telah dipersingkat kecuali penerima berwenang untuk menerima seluruh isinya. Pilih bahasa laporannya secara terpisah. Mengubah bahasa atau pengaturan pilihan apa pun memerlukan pratinjau lain sebelum pembuatan. 1. Masukkan tujuan pengungkapan dan pilih tanggal, ID pengirim, serta kriteria teks literal. 2. Pilih apakah akan mempertahankan identitas asli, hanya menampilkan peserta yang terdaftar, atau menyamarkan identitas semua orang. Dalam mode penyamaran apa pun, ID/judul obrolan dan ID pesan juga diganti. Nama samaran tetap konsisten di dalam satu pengungkapan dan berubah antar pengungkapan yang disiapkan secara terpisah. 3. Simpan teks pesan, hilangkan seluruhnya, atau tambahkan nama/frasa literal untuk disamarkan. Dalam mode pribadi, alat ini juga menyamarkan nama pengirim tersembunyi yang diketahui dan nama pengguna alternatif, ID pengirim token lengkap, nama obrolan langsung, tautan, alamat email, dan string yang menyerupai nomor telepon. Pencocokan nama yang diketahui menangani konversi huruf besar-kecil Unicode, termasuk `Straße`/`STRASSE`. Judul grup/saluran umum tidak secara otomatis dihapus dari teks pesan. Jika batas penyamaran identitas yang diketahui terlampaui, persempit ekspor sumber atau hilangkan teks; alat ini menolak untuk secara diam-diam melewati nama-nama berikutnya. Ini adalah aturan yang dilakukan semaksimal mungkin, bukan anonimisasi umum. 4. Jangan sertakan berkas kecuali jika penerima membutuhkannya. Berkas asli yang disertakan tetap mempertahankan piksel, audio, teks, dan metadatanya. Berkas-berkas tersebut **tidak** dianonimkan oleh alat ini. 5. Lihat pratinjau jumlah, peringatan, dan contoh pesan yang telah diubah, lalu konfirmasikan pembuatan secara eksplisit. Contoh dibatasi hingga 12 pesan dan masing-masing 2.000 karakter teks. Ini hanyalah contoh, bukan tinjauan lengkap atas hasilnya. Mengubah pengaturan memerlukan pratinjau baru. Pratinjau kedaluwarsa setelah 15 menit dan terikat pada sesi administrator tersebut serta ZIP asli yang tepat; pratinjau tidak dapat digunakan kembali setelah dibuat. Pratinjau baru akan membatalkan pratinjau sebelumnya untuk pekerjaan dan sesi yang sama. 6. Periksa hasil lengkapnya `index.html` dan `messages.jsonl` secara lokal sebelum menyerahkannya. Jika ternyata terdapat informasi yang tidak perlu, buat pengungkapan baru dengan pengecualian yang lebih ketat. Jangan mengedit ZIP yang telah ditandatangani di tempat. ### Pesan yang tidak termasuk dalam pemilihan **Pratinjau.** Sebuah pengungkapan tidak terlihat lengkap jika memang belum lengkap. Di dalam setiap obrolan yang menyimpan setidaknya satu pesan yang telah diungkapkan, pesan-pesan yang tidak termasuk dalam pilihan akan muncul sebagai penanda, `[withheld by selection — rule: sender]` (atau `text`, `period`). Pilih **"Pesan yang tidak termasuk dalam pilihan**": satu penanda untuk setiap rangkaian pesan yang ditahan secara berurutan (default) atau satu penanda untuk setiap pesan. Penanda hanya menampilkan aturan dan jumlah, tidak pernah menampilkan teks, pengirim, tanggal, atau file. Obrolan yang tidak memiliki pesan yang diungkapkan akan diabaikan sepenuhnya, sehingga paket ini tidak mengungkapkan keberadaan obrolan tersebut. Balasan yang diungkapkan menunjukkan apa yang dijawabnya: pesan yang termasuk dalam salinan ini, pesan yang ditahan oleh seleksi, atau pesan yang tidak ada dalam ekspor sumber (dihapus sebelum ekspor atau tidak pernah diekspor; ekspor tidak dapat membedakan mana yang mana). Pesan yang ditahan yang dijawab oleh balasan yang diungkapkan selalu diberi penanda tersendiri, sehingga balasan tersebut mengarah ke catatan yang menjelaskan mengapa pesan tersebut kosong. Ketiga status ini berbeda dari penghapusan dan celah koleksi, yang merupakan bagian dari ekspor sumber. Dalam `messages.jsonl` (format `tgwitness-account-disclosure-v2`) setiap pesan memiliki `state`: `disclosed`, atau `withheld` dengan `rules` dan `count`. Balasan yang diungkapkan memiliki `reply_to` bersama dengan target `id` dan `state` (`disclosed`, `withheld`, `not_in_source`). Manifest tersebut menghitung pesan, obrolan, media, dan `withheld` pesan. `verify.py` menolak penanda yang membawa konten dan balasan yang mengarah ke catatan yang tidak terdapat dalam paket; paket versi 1 diverifikasi seperti sebelumnya. Format yang dipersingkat ini mengabaikan profil akun terstruktur, kontak, avatar, sesi, cerita, objek Telegram mentah, header penerusan, kutipan balasan, kartu kontak, dan metadata lokasi. Format ini juga tidak menyertakan berkas JSONL asli, pengaturan filter pribadi, kunci pseudonim, dan peta identitas. Teks yang dipilih, identitas yang secara eksplisit dipertahankan, dan berkas yang disertakan masih dapat mengandung nama, ID, atau frasa yang sama dengan yang digunakan dalam filter tersebut; hal-hal tersebut memerlukan tinjauan terpisah. Kebijakan pribadi dan kunci pseudonim disimpan dalam bentuk terenkripsi di brankas lokal untuk pekerjaan tersebut; menghapus pekerjaan akan menghapus catatan pengungkapan pribadi yang terkait. Catatan kebijakan publik mencatat jumlah filter, bukan nilai filter. Tujuan yang dinyatakan bersifat publik dalam manifest dan HTML: kriteria pribadi yang eksplisit dan, dalam mode pseudonim, identitas tersembunyi yang diketahui juga disamarkan di sana, termasuk saat teks pesan dihilangkan. Jaga agar tujuan tetap bebas dari detail pribadi yang tidak perlu; konteks identifikasi yang tidak diketahui dapat tetap ada. Manifestnya mengikat berkas-berkas turunan, kebijakan publik, dan nilai hash ZIP asli. Verifikasi dapat memastikan integritas dan, jika sumbernya disediakan secara lokal, kesesuaian tautan sumber. Panel tersebut menyimpan salinan yang dibagikan dengan nama `tgwitness-disclosure-DISCLOSURE_ID.zip`: ``` python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip ``` Tautan sumber menunjukkan dari arsip dan kunci kolektor mana pengungkapan berasal. Pengungkapan hanya memuat konten yang dipilih; tinjau pemilihan dan penghapusan detail pengenal dengan membandingkannya dengan ekspor asli. ## Berbagi dan penangkapan yang dihosting Pilih pesan dan berkas yang dibutuhkan penerima, tinjau salinan lengkap yang dibagikan, dan simpan sumbernya secara terpisah. Catat hash ZIP yang telah dikirim agar penerima dapat mengidentifikasi dan memverifikasi salinan yang tepat tersebut. Pseudonimisasi menggantikan pengenal yang dipilih; teks yang disertakan dan berkas asli tetap menjadi bagian dari tinjauan. GitHub Actions mendukung ekspor seluruh akun dan obrolan terpilih melalui Takeout atau API biasa, serta jurnal peristiwa satu obrolan. Panduan penangkapan yang dihosting menjelaskan verifikasi pengaturan dan batas waktu 120 menit. Untuk memverifikasi salinan berbagi yang berasal dari penangkapan yang dihosting, bandingkan hash sumbernya dengan arsip asli dan verifikasi pengesahan arsip tersebut dengan pemeriksaan khusus mode . [Format bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) · [Laporan kasus](https://phishdestroy.io/tgwitness/id/docs/reference/case-reports/) --- # 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. --- # Telegram · Menerjemahkan laporan untuk pengadilan Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/translation/ Berkas mana yang asli, apa yang diajukan bersama terjemahan tersumpah, dan istilah yang dipertahankan penerjemah. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Berkas mana yang asli, apa yang diajukan bersama terjemahan tersumpah, dan istilah yang dipertahankan penerjemah. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bukti dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) ![Bukti & verifikasi](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness menyusun laporan dalam 25 bahasa. Bahasa Inggris adalah bahasa aslinya. Bahasa-bahasa lainnya merupakan terjemahan mesin yang sebagian di antaranya telah melalui proses peninjauan terminologi; terjemahan-terjemahan ini membantu operator membaca laporan tersebut dan bukan merupakan terjemahan bersertifikat. ## Dokumen apa saja yang harus diajukan Serahkan salinan asli dalam bahasa Inggris beserta terjemahan tersumpah atau terakreditasi ke dalam bahasa pengadilan. Seorang penerjemah tersumpah memahami terminologi lokal serta persyaratan formal untuk dokumen pengadilan. Apabila bahasa laporan bukan bahasa Inggris, berkas ZIP yang berisi bukti, riwayat obrolan, dan serah terima juga memuat salinan asli dalam bahasa Inggris dari laporan yang sama: `report.en.html` dan `report.en.pdf`, atau `chat.en.html` dan `chat.en.pdf` untuk ekspor obrolan. Berkas-berkas tersebut disegel dan ditandatangani dengan kunci yang sama seperti laporan dalam bahasa yang dipilih serta dicantumkan beserta nilai SHA-256-nya dalam manifes yang ditandatangani, yang mencantumkan nama berkas-berkas tersebut di bawah `report.original`. Laporan yang diekspor dalam bahasa Inggris itu sendiri merupakan salinan aslinya. Laporan dalam bahasa yang dipilih akan terbuka dengan rekomendasi yang sama dan mencantumkan nama berkas bahasa Inggris tersebut. Sebelum menerjemahkan, periksa teks aslinya dengan membandingkannya dengan arsip: ``` python -m tgwitness.verify report.en.html --fingerprint KEY --evidence tgwitness-evidence.zip ``` `README.txt` Di setiap arsip, bagian tersebut diakhiri dengan bagian **Untuk Penerjemah** yang mencantumkan nama berkas asli dan mengulangi istilah-istilah di bawah ini. [Narasi dan protokol ahli](https://github.com/phishdestroy/TgWitness/blob/main/docs/NARRATIVE.md) mencantumkan rekomendasi yang sama. ## Apa yang tetap harfiah - Nama file, perintah, hash, sidik jari kunci, ID Telegram, nomor pesan, dan URL. - Waktu: UTC dalam format ISO 8601, sebagaimana tertulis. Jangan mengonversinya ke zona waktu lokal. - Pesan yang ditangkap: kutiplah dalam bahasa aslinya dan cantumkan terjemahannya secara terpisah, dengan menandainya sebagai terjemahan. ## Ketentuan | Istilah | Arti | Tidak boleh diterjemahkan sebagai | | --- | --- | --- | | jurnal | Urutan catatan yang telah ditandatangani dan dirantai dengan hash yang disimpan oleh pengumpul | Buku harian, terbitan berkala, majalah | | catatan | Satu entri yang telah ditandatangani dalam jurnal; gunakan satu kata untuk menyebutnya di seluruh teks | Catatan, artikel | | pengamatan | Apa yang diterima oleh kolektor pada waktu yang tercatat | Kesimpulan mengenai kebenaran isi | | kolektor | Proses TgWitness yang memantau melalui akun Telegram milik operator itu sendiri | Koleksi barang-barang | | pengumpulan data | Menerima dan mencatat pembaruan dari Telegram | Koleksi, kumpulan, kompilasi | | pemberitahuan penghapusan | Pemberitahuan dari Telegram bahwa sebuah pesan telah dihapus; pemberitahuan tersebut tidak menunjukkan siapa yang menghapusnya | Penghapusan yang telah terbukti dilakukan oleh seseorang yang disebutkan namanya | | tidak ditemukan saat diperiksa ulang | Telegram tidak lagi menampilkan pesan tersebut saat diperiksa kembali: telah dihapus, atau tidak lagi terlihat oleh akun ini | Dihapus | | nomor pesan yang tidak ada | Nomor yang tidak tercantum dalam ekspor: telah dihapus sebelumnya atau tidak pernah terlihat oleh akun ini | Pesan yang hilang, pesan yang tercecer | | celah | Periode tanpa pemantauan | Bukti bahwa tidak terjadi apa-apa | | versi sebelumnya | Teks sebelum diedit; kedua versi disimpan | Koreksi, pemalsuan | | titik pemeriksaan | Ringkasan jurnal yang telah ditandatangani hingga jumlah edisi yang memecahkan rekor | Titik kendali dalam arti fisik | | layanan penanda waktu (TSA) | Layanan penandaan waktu RFC 3161 yang independen | Otoritas, lembaga pemerintah, otoritas sertifikat | | tanda waktu pada tanda terima | Respons dari layanan penanda waktu, atau tanda terima OpenTimestamps, yang menunjukkan bahwa suatu titik pemeriksaan telah ada pada suatu waktu | Bukti, pembuktian atas fakta-fakta | | segel | Tanda tangan Ed25519 yang tertanam dalam berkas laporan | Cap pejabat | | sidik jari kunci penandatanganan | Hasil SHA-256 dari kunci publik, yang diperoleh melalui saluran tepercaya terpisah | Sidik jari biometrik | | saksi | Pihak atau layanan independen yang mengelola atau memverifikasi titik pemeriksaan | Seseorang yang memberikan kesaksian di pengadilan | | ringkasan serah terima | Bagian dari jurnal yang disusun untuk pihak lain, dengan data orang lain dihilangkan sebisa mungkin | Ekspor lengkap | | catatan yang dipersingkat | Sebuah catatan yang kolom-kolomnya yang disembunyikan diberi nama dan diganti dengan nilai hash-nya | Catatan yang dihapus atau disunting | --- # Telegram · Saksi independen Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/witness/ Jalankan TgWitness dengan kunci dan botnya sendiri, publikasikan titik pemeriksaan yang ditandatangani ke saluran, dan periksa ekspor data berdasarkan titik pemeriksaan tersebut. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Jalankan TgWitness dengan kunci dan botnya sendiri, publikasikan titik pemeriksaan yang ditandatangani ke saluran, dan periksa ekspor data berdasarkan titik pemeriksaan tersebut. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bukti dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) ![Bukti & verifikasi](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) [Ekspor dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) · [Jaminan tinggi](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/) · [Panduan panel](https://phishdestroy.io/tgwitness/id/docs/reference/panel/#extras) Seorang saksi menyimpan titik pemeriksaan yang telah ditandatangani secara terpisah dari pengumpul. Ia memeriksa tanda tangan pengumpul dan kesinambungan jurnal, menandatangani hasilnya dengan kuncinya sendiri, dan mempublikasikannya ke saluran Telegram. Jalankan alat ini di server terpisah dengan akses baca-saja ke titik akhir saksi pengumpul. Hasil teknis mencakup prefiks jurnal yang disimpan, respons tantangan, pemeriksaan tanda tangan, pemeriksaan inklusi/konsistensi Merkle, dan hasil kontinuitas yang ditandatangani. Untuk saksi yang dioperasikan oleh kustodian lain, simpan identitas kustodian dan catatan kontrol kunci beserta sidik jarinya. Kunci terpisah dan kustodi terpisah menggambarkan bagian yang berbeda dari penyiapan. Verifikator melaporkan bahwa kunci kedua menyimpan head jurnal dan sampai catatan mana; catatan kontrol kunci milik kustodian menunjukkan siapa yang memegang kunci itu. Jurnal saksi adalah pemeriksaan pendukung; syarat minimum untuk bukti adalah waktu pihak ketiga. Postingan kanal menambahkan waktu eksternal: Telegram memberi tanggal pada setiap postingan publik, dan verifikator membaca tanggal tersebut sendiri. Diagram alur · Pengumpul → Saksi (titik pemeriksaan yang ditandatangani: jumlah catatan + hash header); Saksi → Jurnal saksi, kunci sendiri; Saksi → Saluran Telegram (postingan yang ditandatangani melalui botnya sendiri); Berkas ZIP Bukti → verify.py; Jurnal saksi, kunci sendiri → verify.py; Saluran Telegram → verify.py (t.me/s halaman dibaca secara langsung, atau ekspor ke Desktop) · Pengumpul · Saksi · Jurnal saksi, kuncisendiri · Saluran Telegram · Berkas ZIP Bukti · verify.py · titik pemeriksaan yang · ditandatangani: jumlah · catatan + hash header · postingan yang · ditandatangani melalui · botnya sendiri · t.me/s halaman dibaca secara · langsung, atau ekspor ke · Desktop **Diagram dalam bentuk teks** 1. Pengumpul → Saksi (titik pemeriksaan yang ditandatangani: jumlah catatan + hash header) 2. Saksi → Jurnal saksi, kunci sendiri 3. Saksi → Saluran Telegram (postingan yang ditandatangani melalui botnya sendiri) 4. Berkas ZIP Bukti → verify.py 5. Jurnal saksi, kunci sendiri → verify.py 6. Saluran Telegram → verify.py (t.me/s halaman dibaca secara langsung, atau ekspor ke Desktop) **Di halaman ini** - [Apa yang disimpan saksi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/#what-the-witness-holds) - [Apa yang diperiksa dan dicatat](https://phishdestroy.io/tgwitness/id/docs/reference/witness/#what-it-checks-and-records) - [Jalankan saksi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/#run-a-witness) - [Halaman bukti publik untuk beberapa ruang kerja](https://phishdestroy.io/tgwitness/id/docs/reference/witness/#public-proof-page-for-several-workspaces) - [Verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/#verify) ## Apa yang disimpan saksi | Saksi tersebut memiliki | Saksi tersebut tidak pernah memiliki | | --- | --- | | **Token saksi** yang hanya dapat dibaca untuk satu ruang kerja | Sesi Telegram atau kredensial API pengumpul | | Kunci Ed25519 dan jurnal miliknya sendiri | Brankas pengumpul, kunci penandatanganan, atau token panel | | Token bot Telegram miliknya sendiri | Isi pesan: bagian awal berisi jumlah catatan dan hash | Token ini dibuat di **More tools → Extras → Independent witness**, ditampilkan sekali, dan disimpan hanya sebagai SHA-256. Token ini membuka tepat satu titik akhir, `GET /api/witness/head`, yang mengembalikan titik pemeriksaan yang baru ditandatangani beserta penghitung koleksi tanpa konten yang ditandatangani dan status kesehatan operasional. Token ini tidak dapat membuka panel, membaca isi pesan, atau mengubah pengaturan, dan token panel tidak diterima di sana. Cabut token di halaman yang sama. Pengumpul mencatat saat kunci saksi baru mulai melakukan pemeriksaan (`witness.seen`) dan menampilkan pemeriksaan terakhir per token; seorang saksi yang belum melakukan pemeriksaan dalam interval 2.5 ditandai sebagai terlambat. Saksi baru mengirimkan tantangan acak pada setiap jajak pendapat; pernyataan penangkapan mengulanginya di bawah tanda tangan pengumpul. Penghitung terikat pada titik pemeriksaan yang tepat dan disertakan dalam posting saksi yang ditandatangani. Kepala warisan tetap diterima oleh saksi mandiri. Pertumbuhan jurnal saja tidak pernah dihitung sebagai pesan baru. ## Apa yang diperiksa dan dicatat Setiap interval (secara default 10 menit), TgWitness: 1. mengambil header itu sendiri (pengumpul tidak dapat memaksa atau melewatkannya); 2. memverifikasi tanda tangan pengumpul, kunci pengumpul yang disematkan (`--collector-fingerprint`, atau kunci pertama yang terlihat), hitungan yang tidak berkurang, dan kepala yang tidak berubah pada hitungan yang tidak berubah. Bukti inklusi dan konsistensi Merkle memverifikasi bahwa jurnal yang terus bertambah memperluas titik pemeriksaan yang disimpan. Setelah bukti kontinuitas digunakan, upaya untuk menghapusnya akan ditolak; 3. menambahkan catatan yang ditandatangani ke jurnalnya sendiri: `witness.anchor` dengan status `ok`, `key_changed`, `rollback` (jumlah catatan lebih sedikit daripada sebelumnya), `fork` (panjangnya sama, head-nya berbeda) atau `invalid` (jawaban gagal verifikasi), atau `witness.no_response` ketika pengumpul tidak menjawab; 4. mengunggah hasilnya ke saluran, yang telah ditandatangani, termasuk "tidak ada jawaban" selama TgWitness sedang berjalan dan dapat mengakses Bot API. ID unggahan dicatat (`witness.posted`), begitu pula unggahan yang gagal (`witness.post_failed`). Sebuah posting terlihat seperti ini; baris terakhir berisi pernyataan yang telah ditandatangani: ``` TgWitness witness #42 · journal head Collector 3fa9c2d1e0b4a7f6: 18234 records Head 9b1f…c07e 2026-10-28T19:40:00.123+00:00 TGW1.eyJhdCI6…. ``` ## Jalankan TgWitness Anda memerlukan bot Telegram (buatlah dengan @BotFather), sebuah saluran di mana bot tersebut menjadi administrator, serta alamat pengumpul yang dapat diakses oleh saksi — melalui HTTPS di luar jaringan pribadi (lihat profil HTTPS pada [bagian penerapan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/)). Buka **Lebih banyak alat → Ekstra → Saksi independen → Konfigurasi** di panel. Tiga langkah mencakup akses baca-saja, saluran Anda, dan interval, lalu meluncurkan saksi. Kebijakan publikasi, proxy HTTP/SOCKS5 opsional, dan alamat Bot API khusus terdapat di **pengaturan Lanjutan** . Formulir mengunduh `witness.json` dengan kunci pengumpul ruang kerja ini yang disematkan. Unduh token baca-saja yang baru dibuat dengan **Simpan berkas akses** sebagai `witness-token.txt` ; letakkan berkas tersebut beserta `bot-token.txt` yang dibuat di host saksi di samping berkas JSON tersebut. Pengumpul tidak pernah menerima token bot. Pengunduhan tidak memulai layanan atau mempublikasikan pesan. Tidak ada saksi proyek yang dihosting yang secara implisit terdaftar. ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json python -m tgwitness.witness fingerprint --config witness.json ``` Perintah pertama memeriksa berkas konfigurasi dan berkas rahasia tanpa permintaan jaringan atau pembuatan kunci. Jalur dalam JSON bersifat relatif terhadap berkas tersebut; jalur CLI/lingkungan bersifat relatif terhadap direktori kerja. Simpan sidik jari saksi di luar hostnya. Indikator "last-poll" pengumpul hanya mengonfirmasi permintaan; publikasi dilaporkan oleh Proof atau diperiksa di jurnal saksi dan saluran. Jika panel berada di balik terowongan SSH, tampilkan hanya titik akhir saksi yang dibatasi pada nama host HTTPS terpisah dengan [contoh Caddy ini](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example). Ruang kerja default kemudian menggunakan `https://witness.example.org`, sedangkan ruang kerja lainnya menggunakan `https://witness.example.org/profiles/ID`. Token tetap diperlukan; panel dan rute API lainnya tidak diteruskan oleh host virtual tersebut. Pilih `all` untuk titik pemeriksaan yang diterbitkan secara teratur. Interval lima menit berarti sekitar 288 posting per ruang kerja per hari. `changes`/`problems` sengaja tidak mempublikasikan beberapa pemeriksaan. MTProxy diperuntukkan bagi klien Telegram pengumpul data. Pemantauan HTTP dan API Bot HTTPS Telegram menggunakan rute langsung/HTTP/SOCKS5 ([API Bot](https://core.telegram.org/bots/api)) masing-masing. **Di samping pengumpul, dengan Docker** (host yang sama — proses dan kunci independen, tetapi operator yang sama): masukkan nilai-nilai ke dalam `.env` dan jalankan profil tersebut. ``` TGWITNESS_WITNESS_TOKEN=tgww_... TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC... TGWITNESS_WITNESS_CHANNEL=@your_witness_channel # another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/ docker compose --profile witness up -d docker compose logs witness # prints the witness key fingerprint ``` Jika menggunakan gambar yang telah dipublikasikan, gunakan kode `docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d`. **Di server pihak lain** (penyimpanan terpisah): salin repositori ke sana, atur `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` ditambah tiga nilai di atas di `.env`, lalu ``` docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d ``` atau tanpa Docker: ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel ``` ### Publikasikan ke Discord Seorang saksi dapat memposting ke saluran Discord alih-alih ke Telegram. Di Discord, buka **Edit Channel → Integrations → Webhooks**, buat webhook, dan salin URL-nya. Di panel tersebut, pilih **Discord webhook · saluran Anda** pada langkah 2. Di server saksi, simpan URL tersebut sebagai `discord-webhook.txt` di samping `witness.json`; URL tersebut tidak akan pernah sampai ke pengumpul. ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --discord-webhook-file discord-webhook.txt ``` Seorang saksi memiliki satu penerbit: saluran Telegram atau webhook Discord, bukan keduanya. Postingan membawa pernyataan yang ditandatangani yang sama dan tidak dapat mengirim ping kepada siapa pun. Postingan yang lebih panjang dari batas 2,000 karakter Discord diganti dengan baris pendek yang dilengkapi dengan pemeriksaan lengkap yang dilampirkan sebagai `witness-check.txt` . Setiap ID postingan dicatat sebagai `witness.posted` . `verify.py --channel` hanya membaca saluran Telegram, jadi untuk Discord simpan jurnal saksi: jurnal tersebut menyimpan setiap pemeriksaan. Postingan Discord tidak memberikan waktu eksternal kepada verifikator. ### Opsi | Opsi | Lingkungan | Default | Arti | | --- | --- | --- | --- | | `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | Interval waktu antara pemeriksaan, 1–1.440 | | `--timeout` | `_TIMEOUT` | 30 | Waktu tunggu untuk pengumpul data dan Bot API, 5–600 detik | | `--post` | `_POST` | `all` | `all`: setiap pemeriksaan; `changes`: masalah baru; `problems`: hanya masalah dan jawaban yang hilang | | `--title` | `_TITLE` | `TgWitness witness` | Kata-kata pertama dari setiap postingan saluran | | `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | Simpan kunci pengumpul alih-alih mempercayai jawaban pertama | | `--proxy` | `_PROXY` | langsung | `socks5://host:port` atau `http://host:port` | | `--bot-api` | `_BOT_API` | `https://api.telegram.org` | Alamat API Bot, misalnya server API Bot lokal | | `--data-dir` | `_DATA` | `witness-data` | Kunci saksi dan jurnal | | `--config` | `_CONFIG` | – | Berkas JSON dengan salah satu opsi di atas | Alamat pengumpul, token, dan saluran berasal dari `--collector`, `--token` atau `--token-file`, `--bot-token` atau `--bot-token-file`, `--discord-webhook-file` dan `--channel`, atau `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` dan `_CHANNEL`, yang mencegah rahasia masuk ke dalam daftar proses. Sebuah berkas konfigurasi menggunakan nama opsi dengan garis bawah, ditambah `texts`, yang menggantikan kata-kata dalam postingan saluran: ``` {"collector": "https://your-collector.example.org", "token_file": "witness-token.txt", "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel", "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness", "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}} ``` Kunci `texts`: `ok`, `key_changed`, `rollback`, `fork`, `invalid`, `no_response`, `collector`, `records`, `head`. Baris perintah memiliki prioritas lebih tinggi daripada lingkungan, dan lingkungan memiliki prioritas lebih tinggi daripada berkas. Opsi atau kunci teks yang tidak dikenal akan menghentikan saksi dengan pesan, bukan diabaikan. Rumusan kata tidak pernah memengaruhi verifikasi: `verify.py` memeriksa token yang ditandatangani di akhir setiap posting. Dengan `--post changes` atau `problems`, pemeriksaan yang tidak diposting tetap ada di jurnal saksi dan `verify.py` mencantumkannya sebagai tidak pernah diposting; catatan awal menyebutkan kebijakan. Setiap pemeriksaan tetap muncul di jurnal, sehingga lebih sedikit posting berarti lebih sedikit kali diberi tanggal oleh Telegram, bukan lebih sedikit pemeriksaan. Tanpa saluran, TgWitness tetap menyimpan jurnalnya. Simpan sidik jari kunci TgWitness (`python -m tgwitness.witness fingerprint`) di tempat lain. ## Halaman bukti publik untuk beberapa ruang kerja `python -m tgwitness.proof` TgWitness dapat menangani hingga 32 ruang kerja sekaligus dan menampilkan halaman hanya-baca yang berisi pemeriksaan terbaru yang telah ditandatangani untuk masing-masing ruang kerja. Setiap ruang kerja memiliki kunci saksi dan jurnal tersendiri di dalam folder data serta kunci pengumpul yang disematkan; pengiriman ke saluran Telegram bersifat opsional untuk setiap ruang kerja. Mulailah dari [proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example): | Bidang | Arti | | --- | --- | | `title` | Judul halaman, 1–100 karakter | | `data_dir` | Kunci dan jurnal saksi, terkait dengan berkas; default `proof-data` | | `interval`, `timeout` | Jeda antara pemeriksaan (1–1440, default 5); waktu tunggu dalam detik (5–600, default 20) | | `workspaces[].id`, `label` | Alias singkat huruf kecil dan nama yang ditampilkan | | `workspaces[].collector` | Alamat Collector; ruang kerja lainnya berakhir dengan `/profiles/` | | `workspaces[].collector_fingerprint` | Diperlukan, berbeda untuk setiap ruang kerja | | `workspaces[].token_file` | File yang berisi token saksi read-only dari ruang kerja tersebut | | `workspaces[].channel`, `bot_token_file` | Opsional, secara bersamaan: posting setiap pemeriksaan ke saluran | | `workspaces[].proxy`, `bot_api` | Rute opsional dan alamat API Bot | ``` python -m tgwitness.proof --config proof.json --check-config python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790 ``` Perintah pertama memvalidasi berkas dan berkas token tanpa membuka koneksi. Halaman ini hanya merespons permintaan GET dan HEAD: - `/` menampilkan setiap ruang kerja; ruang kerja yang tidak diperiksa selama 2,5 interval akan ditandai sebagai usang. - `/api/proof` mengembalikan hasil yang sama dengan JSON. - `/api/proof/` mengunduh pernyataan terbaru yang telah ditandatangani (`tgwitness-public-proof-v1`): nomor dan hash catatan saksi, status, kunci pengumpul yang disematkan, titik pemeriksaan, penghitung pengumpulan, serta apakah posting saluran berhasil, yang ditandatangani oleh kunci saksi ruang kerja tersebut. - `/healthz` Menampilkan kode kesalahan 503 ketika monitor ruang kerja telah berhenti beroperasi. Beri halaman tersebut nama hostnya sendiri, seperti [Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example). Untuk verifikasi, ekspor jurnal saksi ruang kerja dengan `python -m tgwitness.witness export --data-dir proof-data/ --out witness.zip` dan gunakan sebagaimana dijelaskan di bawah ini. ## Verifikasi Dari sisi saksi, ekspor jurnalnya: ``` python -m tgwitness.witness export --out witness.zip # Docker (add -f deploy/compose/compose.witness.yaml on a witness server): docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip docker compose cp witness:/witness/witness.zip . ``` Kemudian, di mana saja, dengan ZIP yang ditandatangani oleh pengumpul dan alamat saluran publik: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel ``` `--channel` juga menerima ekspor dari Telegram Desktop (*Ekspor riwayat obrolan* → JSON menghasilkan `result.json`) atau salinan halaman yang disimpan; keduanya memeriksa isi postingan tetapi tidak memberikan waktu eksternal. `verify.py` memeriksa jurnal saksi (rantai dan tanda tangan), kemudian memastikan bahwa **setiap head yang dilihat saksi merupakan bagian dari jurnal yang diekspor**: catatan pada hitungan tersebut harus memiliki hash yang persis sama. Sebuah head yang tidak cocok akan gagal verifikasi — jurnal telah diubah setelah saksi melihatnya. Alat ini juga melaporkan head yang terlihat setelah ekspor, anomali yang dicatat oleh saksi, jawaban yang gagal, periode di mana checkpoint yang cocok terdapat dalam ekspor ini ("Disaksikan dari X hingga Y"), dan celah. Checkpoint yang lebih baru tidak memperpanjang periode tersebut. Hasilnya mencakup nomor catatan terakhir yang cocok dan jumlah catatan berikutnya tanpa checkpoint yang cocok. Hanya jawaban yang ditandatangani oleh kunci ekspor itu sendiri yang dihitung: ekspor yang ditandatangani oleh kunci yang tidak pernah dilihat saksi dilaporkan sebagai tidak disaksikan, dan tanpa `--fingerprint`, penandatanganannya tetap tidak terikat. Dengan `--channel`, setiap posting yang ditandatangani harus cocok dengan jurnal saksi catatan demi catatan: posting yang diubah gagal verifikasi, posting yang hilang dicantumkan. Kesesuaian token mengautentikasi konten; tanggal berada di luar token yang ditandatangani. Dengan alamat langsung `https://t.me/s/…` atau `https://telegram.me/s/…`, verifikator membaca tanggal setiap posting dari halaman pada saat verifikasi. Telegram yang menetapkan tanggal tersebut; tanggal postingan yang telah diedit tidak digunakan. Tanggal paling awal dari sebuah postingan pada titik awal ekspor adalah waktu eksternal untuk catatan terakhir, yang memenuhi syarat minimum sebagai bukti. Tanggal dari sumber lain apa pun, seperti `result.json` yang disediakan, halaman yang disimpan, atau alamat web lainnya, merupakan metadata yang disediakan, bukan waktu independen; hasil tersebut menyebutkan dari mana tanggal postingannya berasal (`post_date_verification`). ### Memerlukan batas ekspor yang disaksikan Untuk serah terima yang harus menyertakan catatan akhir yang disaksikan, tambahkan `--require-witness`: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness ``` Hal ini memerlukan sidik jari saksi yang disimpan secara independen, kunci selain kunci pengumpul, dan titik pemeriksaan yang cocok tepat di akhir ekspor ini. Titik pemeriksaan yang hanya mencakup awalan sebelumnya tidak memadai. Hentikan sementara pengumpulan, biarkan saksi mengamati keadaan akhir, dan ekspor sebelum penulisan jurnal lebih lanjut; jika jurnal berubah, simpan titik pemeriksaan lain dan ekspor keadaan tersebut. Titik pemeriksaan yang lebih baru saja tidak dapat memverifikasi hash akhir dari ekspor yang lebih pendek. Ketika `--channel`juga disertakan, posting yang diklaim hilang atau himpunan pencocokan yang kosong akan gagal dalam pemeriksaan ketat ini. Tanpa bendera tersebut, pemeriksaan integritas biasa tetap melaporkan catatan yang tidak disaksikan tanpa menolak arsip yang sebaliknya utuh. Simpan jurnal saksi dan kuncinya yang disematkan secara terpisah. Pemeriksaan daring memverifikasi kontinuitas antara titik pemeriksaan; verifikasi luring membandingkan setiap titik pemeriksaan yang disimpan dengan ekspor. Kepala lama tanpa bukti kontinuitas tetap mempertahankan perbandingan luring dan dilaporkan tanpa verifikasi kontinuitas daring. Laporan tersebut mencantumkan waktu henti saksi dan publikasi yang gagal berdasarkan interval. ### Segel harian dan kalender cap waktu yang tidak tersedia Saksi tersebut menyegel batas jurnal hari UTC sebelumnya dan mengirimkan hash dari segel yang telah ditandatangani tersebut ke OpenTimestamps. Pengiriman kalender merupakan bukti yang masih tertunda; hanya komitmen Bitcoin yang telah diverifikasi secara independen yang menerima konfirmasi di verifikator. Jika semua kalender gagal, segel yang ditandatangani dan upaya yang tidak berhasil tetap ada di jurnal. Proses pemeliharaan setiap jam akan mencoba kembali catatan asli tersebut, termasuk setelah restart atau perubahan tanggal. Proses ini memindai paling banyak 32 segel, mengirimkan paling banyak dua pengiriman yang terlewat, dan menghabiskan paling banyak 60 detik untuk upaya ulang per siklus. Sebuah kursor persisten bergilir melalui segel-segel yang lebih lama. Pengiriman yang disimpan mengikuti jalur peningkatan bukti yang ada. Upaya ulang tidak akan menulis ulang segel, mengubah tanggal aslinya, atau menyatakan bahwa kalender telah menerimanya lebih awal. Komitmen Bitcoin yang lebih baru tetap menjadi konfirmasi eksternal yang lebih baru. Bukti yang hilang tetap berstatus `none`; bukti yang tertunda tetap berstatus `pending` hingga verifikator memeriksanya secara independen. --- # Telegram · Cap waktu Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/ Stempel waktu RFC 3161 untuk titik pemeriksaan yang ditandatangani: apa yang dikirimkan ke otoritas dan bagaimana responsnya diverifikasi. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt) Stempel waktu RFC 3161 untuk titik pemeriksaan yang ditandatangani: apa yang dikirimkan ke otoritas dan bagaimana responsnya diverifikasi. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bukti dan verifikasi](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/) ![Bukti & verifikasi](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness menyiapkan permintaan RFC 3161 dan memverifikasi respons otoritas cap waktu (TSA). Prosedur manual ini tidak memilih TSA maupun mengirimkan data; mode bukti melakukan keduanya sesuai jadwal ([format bukti](https://phishdestroy.io/tgwitness/id/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)). Permintaan yang telah disiapkan **belum** merupakan **bukti cap waktu**. ## Apa yang diikat oleh bukti tersebut Diagram alur · Pengamatan akun → Rantai SHA-256 dan tanda tangan Ed25519; Rantai SHA-256 dan tanda tangan Ed25519 → Titik pemeriksaan yang ditandatangani; Titik pemeriksaan yang ditandatangani → Hash byte-per-byte dan nonce acak; Hash byte-per-byte dan nonce acak → Permintaan RFC 3161; Permintaan RFC 3161 → TSA Independen; TSA Independen → Tanggapan TSA yang ditandatangani; Titik pemeriksaan yang ditandatangani → Verifikasi data, nonce, dan kepercayaan CA yang eksplisit; Tanggapan TSA yang ditandatangani → Verifikasi data, nonce, dan kepercayaan CA yang eksplisit · Pengamatan akun · Rantai SHA-256 dantanda tangan Ed25519 · Titik pemeriksaan yangditandatangani · Hash byte-per-byte dannonce acak · Permintaan RFC 3161 · TSA Independen · Tanggapan TSA yangditandatangani · Verifikasi data,nonce, dan kepercayaanCA yang eksplisit **Diagram dalam bentuk teks** 1. Pengamatan akun → Rantai SHA-256 dan tanda tangan Ed25519 2. Rantai SHA-256 dan tanda tangan Ed25519 → Titik pemeriksaan yang ditandatangani 3. Titik pemeriksaan yang ditandatangani → Hash byte-per-byte dan nonce acak 4. Hash byte-per-byte dan nonce acak → Permintaan RFC 3161 5. Permintaan RFC 3161 → TSA Independen 6. TSA Independen → Tanggapan TSA yang ditandatangani 7. Titik pemeriksaan yang ditandatangani → Verifikasi data, nonce, dan kepercayaan CA yang eksplisit 8. Tanggapan TSA yang ditandatangani → Verifikasi data, nonce, dan kepercayaan CA yang eksplisit Tanda tangan pengumpul mengikat catatan ke kuncinya. Respons TSA yang tepercaya dapat membuktikan bahwa titik pemeriksaan tertentu telah ada pada waktu yang dinyatakan oleh TSA. Titik pemeriksaan tersebut kemudian dapat mengikat awalan jurnal. Batas waktu atas ini berlaku untuk awalan yang telah dikonfirmasi tersebut; tindakan Telegram individu tetap mempertahankan waktu peristiwa yang tercatat. ## Prosedur Verifikator jurnal melaporkan langkah mundur dan nilai `observed_at` yang tidak dapat diurai dalam `chronology` jika ada, serta menyertakan peringatan dalam keluaran perintahnya. Verifikator ini mempertahankan cap waktu yang ditandatangani dan tetap memeriksa tanda tangannya. Langkah mundur dapat berasal dari koreksi jam, jadi tinjau hal ini dengan catatan jam tuan rumah. Waktu independen berasal dari cap waktu eksternal yang terverifikasi, posting saksi yang dibaca dari halaman t.me publik mereka, dan putaran drand; `--strict` mengatur penentuan penandatangan dan format yang didukung. Nilai drand yang direkam menjalani pemeriksaan konsistensi struktural dan hash secara offline. `--check-drand` membandingkan putaran yang direkam yang dipilih dengan respons relai HTTPS; hasilnya menyatakan berapa banyak putaran yang dibandingkan dan relai mana yang merespons, serta putaran yang dibandingkan memberikan batas waktu bawah yang terotentikasi. 1. Simpan sidik jari kunci pengumpul melalui saluran tepercaya terpisah; sidik jari ini mengidentifikasi pengumpul secara independen dari berkas ZIP yang diperiksa. 2. Di **Ekspor → Siapkan permintaan cap waktu**, unduh berkas ZIP permintaan dari ruang kerja yang dipilih. Ekstrak `checkpoint.json`, `timestamp.tsq`, `SHA256SUMS`, dan `README.txt`. Jangan ubah byte titik pemeriksaan. 3. Pilih TSA yang sesuai dengan penyelidikan. Kirimkan `timestamp.tsq` menggunakan metode yang terdokumentasi, dengan `application/timestamp-query` untuk layanan HTTP. Simpan balasan biner asli sebagai `timestamp.tsr`, beserta titik akhir, waktu pengambilan, dan hasil permintaan. Permintaan tersebut berisi hash dan nonce, bukan pesan; metadata jaringan tetap mengungkapkan permintaan tersebut. 4. Peroleh sertifikat akar tepercaya secara terpisah dari balasan, beserta sertifikat perantara yang diperlukan. Sertifikat yang terdapat dalam balasan tidak otomatis menjadi tepercaya hanya karena disertakan di sana. 5. Dari instalasi TgWitness yang tepercaya, verifikasi: ``` python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem ``` Tambahkan `--intermediates tsa-intermediates.pem` bila perlu. OpenSSL tidak diperlukan: tanda tangan, referensi sertifikat penanda tangan, dan rantainya diperiksa di Python dengan pustaka `cryptography`, kode yang sama dengan yang dipakai `verify.py --tsa-ca`. `openssl ts -verify` tetap menjadi pemeriksaan kedua yang independen bagi ahli yang menginginkannya. 1. Ekspor ZIP jurnal yang telah ditandatangani setelah titik pemeriksaan sehingga mencakup awalan tersebut. Verifikasi menggunakan sidik jari yang diketahui secara independen: ``` python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json ``` Hal ini menunjukkan bahwa ekspor tersebut berisi awalan bertanda waktu. `verify.py` hanya membaca tanda terima bertanda waktu dari ZIP, tempat mode bukti menyimpannya; balasan manual diperiksa pada langkah ke-5 dan mencakup catatan hingga titik pemeriksaan ini. 1. Simpan ZIP, titik pemeriksaan, permintaan, balasan, rantai sertifikat, hasil verifikasi, dan catatan serah terima di luar pengumpul. Lakukan verifikasi ulang saat penerimaan. Untuk menyiapkan permintaan dari titik pemeriksaan yang disimpan: ``` python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip ``` Proses persiapan ini menstandarkan JSON dan menyertakan titik pemeriksaan yang sesuai ke dalam arsip. Gunakan **byte titik** pemeriksaan **dari arsip tersebut** untuk verifikasi TSA, meskipun berkas masukan memiliki spasi kosong yang berbeda. ## Batasan verifikasi | Periksa | Perilaku saat ini | | --- | --- | | Data | Nilai SHA-256 dari byte titik pemeriksaan yang tepat harus sesuai dengan respons | | Permintaan | Dengan `--request`, kueri asli dan nonce diverifikasi | | Tanda tangan TSA | Tanda tangan, sertifikat penanda tangan, dan rantainya hingga CA yang ditentukan diperiksa pada waktu stempel | | Tanda tangan pengumpul | Diverifikasi secara terpisah oleh verifikator jurnal dengan kunci yang disematkan | | Pencabutan | Mode bukti menyimpan bukti OCSP/CRL yang diperiksa oleh `verify.py` | | Pengiriman terjadwal | Mode Bukti, diaktifkan oleh setiap tujuan pengaturan | `--request` secara teknis opsional, tetapi tanpanya nonce asli tidak dapat diverifikasi. Untuk prosedur lengkap ini, `request_checked` pada hasil harus true. Setiap sertifikat dalam rantai harus berlaku pada waktu stempel, dan sertifikat penanda tangan hanya boleh untuk stempel waktu. Respons TSA mengaitkan byte checkpoint yang dikirimkan dengan waktu yang dinyatakan. Tinjau hasil tersebut dengan catatan akuisisi dan verifikasi lingkungan untuk mode yang dipilih. Mode bukti mencakup TSA terakreditasi pemerintah Belgia `http://tsa.belgium.be/connect`; balasan RFC 3161 ditandatangani, sehingga HTTP biasa tidak melemahkan keamanannya). Dengan akar penyedia tersebut diteruskan ke `--tsa-ca`, `verify.py` melaporkan cap waktu eIDAS yang memenuhi syarat beserta unit pencapannya; Peraturan (UE) No. 910/2014, pasal 41(2), mengasumsikan keakuratan waktunya dan integritas data yang terikat. ### Pencabutan sertifikat penandatanganan Segera setelah setiap balasan, mode bukti mengambil bukti pencabutan untuk sertifikat penandatanganan TSA: respons OCSP dari alamat OCSP AIA sertifikat tersebut, atau CRL dari titik distribusinya (paling banyak 4 MiB). Bukti ini disimpan bersama balasan sebagai `checkpoint-N..ocsp` atau `.crl` dan diekspor bersamanya. Pengambilan yang gagal tidak pernah menunda cap waktu; catatan `anchor.completed` mencantumkannya sebagai `unavailable` beserta alasannya. `verify.py` memeriksa tanda tangan respons OCSP (oleh penerbit, atau oleh sertifikat penanggap yang diberikan penerbit untuk tujuan penandatanganan OCSP), ID sertifikat, dan statusnya, serta memastikan bahwa jawaban tersebut diterbitkan pada atau setelah genTime atau masih berlaku saat itu (nextUpdate). Untuk CRL, program ini memeriksa tanda tangan penerbit, jendela waktu yang sama, dan memastikan nomor seri tidak terdaftar. Kemudian, skrip ini melaporkan `signing certificate not revoked as of