Dokumentasi / 07

Ekspor dan verifikasi

Bagikan catatan yang telah ditandatangani sehingga orang lain dapat memeriksanya.

Simpan referensiEkspor ZIP yang ditandatanganiPenerima memverifikasi

Baru mengenal tanda tangan dan titik pemeriksaan? Ubah catatan contoh dan lihat pemeriksaan mana yang mendeteksinya.

Ingin menyimpan salinan di luar sistem pengumpul? Kunjungi pengaturan S3, Object Lock, atau pemulihan terverifikasi.

Simpan sebagai referensi tepercaya

Simpan sidik jari kunci publik ruang kerja di luar pengumpul. Selama proses pengumpulan, simpan titik pemeriksaan yang telah ditandatangani di tempat lain atau gunakan saksi independen. Referensi ini memungkinkan penerima untuk memverifikasi kunci dan batas jurnal sebelumnya.

Unduh ZIP yang telah ditandatangani

Buka "Exports" dan buat berkas ZIP bukti yang ditandatangani. Berkas ini mencakup jurnal ruang kerja dan daftar isi berkas yang ditandatangani. Filter panel tidak membatasi ekspor jurnal lengkap ini: periksa materi tersebut sebelum membagikannya.

Unduhan HTML dan CSV yang berdiri sendiri berguna untuk pembacaan dan analisis. Simpan berkas ZIP yang telah ditandatangani sebagai salinan asli yang dapat diverifikasi; berkas HTML atau CSV terpisah tidak memiliki tanda tangan yang berdiri sendiri.

Verifikasi dengan salinan TgWitness yang tepercaya

Di lingkungan proyek yang telah diinstal, ganti sidik jari contoh dan jalur file berikut:

python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --checkpoint retained-checkpoint.json

Jika kedua referensi lolos, hasilnya akan melaporkan key_pinned: true dan checkpoint_checked: true. Simpan hasil verifikasi bersama arsip aslinya. Titik pemeriksaan yang disimpan harus berada pada atau sebelum batas ekspor.

Memahami hasilnya

Integritas: riwayat yang direkam dan berkas yang diekspor sesuai dengan tanda tangannya.
Catatan sebelumnya: titik pemeriksaan eksternal memungkinkan Anda membandingkan hasil ekspor dengan awalan jurnal yang telah disimpan sebelumnya.
Pelaksanaan: uji coba terkontrol berupa kirim → edit → hapus memeriksa peristiwa-peristiwa tertentu berdasarkan catatan yang telah direkam.

Tanda tangan yang sah tidak membuktikan bahwa setiap peristiwa Telegram telah diterima, bahwa sumber tersebut mengatakan yang sebenarnya, atau bahwa jam pengumpulnya akurat.

Siapkan salinan cadangan di luar lokasi di S3

Di ruang kerja Anda yang sedang berjalan, buka Ekspor → Salinan di luar situs. Fitur opsional ini kompatibel dengan AWS S3 dan layanan lain yang mendukung S3. Fitur ini menyalin segmen jurnal, foto dan file yang disimpan, titik pemeriksaan beserta respons cap waktunya, serta ekspor obrolan yang telah selesai. Setiap objek dienkripsi di pengumpul menggunakan AES-256-GCM sebelum diunggah.

Demo online ini menampilkan kontrol yang sama dengan fitur unggah yang dinonaktifkan. Masukkan kredensial penyimpanan hanya di ruang kerja Anda sendiri yang sedang berjalan.

Panel salinan lengkap di luar situs: titik akhir, wilayah, bucket, kunci akses, jadwal, penguncian objek, dan kontrol kunci pemulihan — Panel lengkap dengan opsi lanjutan yang diperluas. Tidak ada kredensial penyimpanan yang ditampilkan.

Pengaturan penyimpanan di Ekspor → Salinan di luar lokasi
Bidang	Apa yang harus dimasukkan
Titik akhir	URL layanan penyimpanan, tanpa jalur bucket atau kredensial. Contoh fiktif: `https://s3.example.invalid`.
Wilayah	Wilayah yang disyaratkan oleh penyedia layanan Anda. Nilai default aplikasi adalah `us-east-1`.
Bucket	Sebuah bucket yang sudah ada dan dapat Anda akses. Contoh fiktif: `example-case-backup`.
Folder di dalam bucket	Awalan objek; default `tgwitness`. Aplikasi ini menambahkan awalan yang diturunkan dari sidik jari kunci penandatanganan ruang kerja ini.
ID Kunci Akses / Kunci Akses Rahasia	Masukkan kedua kredensial penyimpanan secara bersamaan. Kredensial tersebut disimpan di brankas ruang kerja. Biarkan keduanya kosong pada penyimpanan berikutnya untuk mempertahankan pasangan kredensial yang telah disimpan.
Alamat bergaya jalur	Gunakan `endpoint/bucket` jika diaktifkan, atau `bucket.endpoint` jika dinonaktifkan, sesuai dengan penyedia layanan.
Interval penyalinan	Dari 1 hingga 1.440 menit; default 5 menit. Aplikasi harus dalam keadaan berjalan untuk pencadangan terjadwal.
Penyimpanan Object Lock	Jumlah hari penyimpanan dan mode untuk bucket yang mendukung Object Lock. Nilai "Zero days" membuat pengaturan penyimpanan default bucket tetap berlaku.

Masukkan tujuan dan kredensial. Biarkan opsi "Simpan salinan di luar lokasi" tidak dicentang saat mempersiapkan, lalu pilih "Simpan salinan di luar lokasi".
Pilih "Uji Koneksi". Ini akan mengunggah objek uji terenkripsi dan memeriksa respons penyimpanan.
Pilih "Unduh kunci enkripsi". Simpan berkas tersebut terpisah dari pengumpul data; berkas ini diperlukan untuk pemulihan.
Aktifkan kotak centang "Simpan salinan di luar situs" dan simpan kembali. Pilih "Salin sekarang" untuk proses manual, atau biarkan penjadwalan berjalan.

Yang tidak dilakukan Alat ini tidak membuat bucket penyimpanan. Pengunggahan terjadwal akan berhenti ketika aplikasi dihentikan.

Periksa retensi dan kemajuan penyalinan

Di bawah "More options", pilih jumlah hari penyimpanan dan "GOVERNANCE" atau "COMPLIANCE" jika bucket Anda mendukung Object Lock. TgWitness akan membaca kembali mode penyimpanan dan batas waktu objek yang diunggah. Laporan status akan menunjukkan konfirmasi, penyimpanan yang hilang, atau kegagalan verifikasi; unggahan yang berhasil saja tidak menjamin penyimpanan.

Panel ini melaporkan putaran terakhir, jumlah objek, byte yang ditransfer, batas jurnal yang disalin, dan kesalahan apa pun. Media lokal yang hilang atau berubah akan dilaporkan dan dicoba kembali pada putaran berikutnya. File, titik pemeriksaan, dan ekspor yang antri setelah media tersebut masih dapat disalin.

Pengunggahan menggunakan rute Direct, SOCKS5, atau HTTP dari ruang kerja. Penyalinan ke S3 tidak tersedia melalui MTProxy; aplikasi ini tidak beralih ke koneksi langsung.

Yang tidak dilakukan Hal ini tidak mewajibkan penyedia layanan untuk menerapkan Object Lock hanya karena unggahan tersebut diterima.

Simpan kunci pemulihan secara terpisah

Berkas JSON yang diunduh berisi kunci dekripsi, pengaturan tujuan, awalan objek ruang kerja, dan sidik jari kunci penandatanganan. Berkas tersebut tidak berisi kredensial akses S3: proses pemulihan memerlukan kredensial terpisah dengan akses baca ke bucket.

Jika Anda mengubah titik akhir (endpoint), bucket, atau awalan folder, unduh kembali berkas kunci agar pengaturan tujuannya sesuai. Aplikasi ini akan memulai salinan baru dari jurnal, berkas, dan titik pemeriksaan yang disimpan secara lokal di tujuan baru tersebut. Ekspor obrolan yang sudah selesai dan telah dihapus dari antrian unggahan lokal tetap berada di tujuan sebelumnya.

Yang tidak dilakukan Alat ini tidak akan mendekripsi salinan tersebut tanpa kunci yang diekspor. Kredensial akses penyimpanan tidak dapat menggantikan kunci tersebut.

Pulihkan dan verifikasi di mesin lain

Gunakan instalasi TgWitness yang tepercaya, berkas JSON kunci yang telah diunduh, kredensial penyimpanan dengan akses baca, dan direktori keluaran yang kosong. Ganti tempat penanda kredensial fiktif di bawah ini.

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

File yang diunduh dan objek yang telah didekripsi disimpan di penyimpanan sementara pribadi sementara jurnal lengkap, titik pemeriksaan yang disimpan, serta hash dan ukuran media yang dilestarikan diperiksa. Jalur yang tidak aman, segmen jurnal yang bertentangan, dan jurnal yang lebih pendek dari titik pemeriksaannya akan ditolak. Verifikasi yang gagal tidak akan mempublikasikan file yang dipulihkan.

Pemulihan yang berhasil akan menghasilkan events.jsonl, media/, checkpoints/, dan exports/ untuk materi yang tersedia dalam salinan tersebut. Simpan hasil JSON perintah tersebut bersama dengan materi yang telah dipulihkan.

Yang tidak dilakukan Alat ini tidak merekonstruksi pengamatan yang tidak pernah tercatat dalam jurnal tersebut atau menggantikan titik pemeriksaan atau saksi yang disimpan secara independen.