TgWitness / Dokumentasi

Dokumentasi / 10

Jaga keselamatannya

Ketahuilah laluan untuk Telegram, senarai proksi awam dan perkhidmatan luaran pilihan. Ketahuilah apa yang dibuka oleh setiap rahsia, apa yang dilindungi dan apa yang diserahkan kepada anda.

127.0.0.1alamat panel secara lalai
256-bittoken panel rawak
0CDN, analitik atau fon jauh
Ed25519tandatangan pada setiap rekod

Tempat segala-galanya wujud

Pengumpul, panelnya dan setiap rekod yang disimpan kekal pada komputer atau pelayan yang anda jalankannya. Telegram adalah satu-satunya destinasi secara lalai; setiap destinasi lain adalah suis berasingan.

06 / APA YANG KELUAR DARI MESINPemasangan anda
KOMPUTER ATAU PELAYAR ANDA
Panel127.0.0.1:8787 · token pembawa
Pengumpulsatu klien Telegram bagi setiap ruang kerja
DIREKTORI DATA
JurnalSQLite · berantai hash · disahkan
Mediafail dinamakan oleh SHA-256
Petak keselamatanFernet · sesi, pasangan API, kunci penandatangan, proksi
  • TelegramSentiasa · melalui laluan anda

    Sambungan MTProto akaun: terus, SOCKS5, HTTP atau MTProxy. Mod Sembunyikan IP menunggu proksi yang berfungsi. Peralihan terus memerlukan mod yang secara eksplisit membenarkannya.

  • Salinan luar tapakPilihan · dimatikan secara lalai

    Jurnal, fail dan titik pemeriksaan disulitkan dengan AES-GCM sebelum dimuat naik ke storan serasi S3. Kunci kekal bersama anda; lampiran dinamakan menggunakan hash berasaskan kunci, bukan hash kandungan mereka.

  • PemberitahuanPilihan · dimatikan secara lalai

    Masalah dan kiraan perubahan dengan tajuk sembang. Petikan mesej hanya dihantar jika anda mengaktifkannya.

  • Pihak berkuasa cap masaPilihan · dimatikan secara lalai

    Hanya SHA-256 titik pemeriksaan yang ditandatangani dan nonce rawak. Tiada mesej, tiada nama sembang.

  • SaksiPilihan · dimatikan secara lalai

    Mengambil titik pemeriksaan yang ditandatangani dan pengira tangkapan dengan token baca sahaja. Ia tidak boleh membaca perbualan atau mengubah tetapan.

Lalai: hanya sambungan Telegram yang keluar dari mesin ini.

Tujuan pilihan dikonfigurasikan mengikut ruang kerja. Teks mesej dan media disimpan tanpa disulitkan dalam direktori data: lindungi ia dengan penyulitan cakera dan kebenaran fail.

Apa yang dibuka oleh setiap rahsia

RahsiaDi mana ia disimpanApa yang dibukanyaJika bocor
Panel tokenpanel-token.txt dalam direktori data; pelayar menyimpannya hanya untuk tab tersebutSegala-galanya dalam setiap ruang kerja: baca dan eksport, ubah skop, log masuk ke akaunHentikan TgWitness, padamkan panel-token.txt, mulakan semula: token baru telah dicipta
Sesi TelegramVault, disulitkan (credentials.enc)Akaun Telegram itu sendiriBatalkan sesi di Telegram di bawah Tetapan → Peranti
Kunci penandatanganVault, disulitkan (signing.enc)Menandatangani rekod yang disahkan di bawah cap jari andaTitik pemeriksaan disimpan di tempat lain, seorang saksi dan cap masa menunjukkan apa yang wujud sebelum
Kunci peti besivault.keydi sebelah data, atau kunci induk luaran untuk direktori data baruMengekodekan semula peti besiAnggap juga sesi dan kunci tandatangan telah bocor
Token saksiPada hos saksiHanya baca: checkpoint ber tandatangan dan kesihatanPadamkannya di halaman Witness; buat yang baru
Salinan kunci luar tapakVault; muat turun sekali untuk pemulihanMengekodekan semula salinan luar tapakSesiapa yang juga memegang objek yang disimpan boleh menyahsulitkannya: anggap salinan itu telah terdedah

Apa yang dilindungi oleh perlindungan

Diliputi

  • Rekod yang diubah, dipadam atau disusun semula dalam eksport: rantaian hash atau tandatangan tidak lagi dapat disahkan.
  • Jurnal dipulihkan atau dibina semula selepas titik pemeriksaan disimpan di tempat lain: titik pemeriksaan yang disimpan tidak lagi sepadan.
  • Meneka token panel: 256 bit rawak, dibandingkan dalam masa tetap; selepas 15 kegagalan seminit, alamat ditolak.
  • Kandungan sembang bermusuhan: teks dimasukkan sebagai teks, bukan sebagai HTML; lampiran dimuat turun sebagai fail; panel tidak memuat apa-apa daripada laman lain.
  • Direktori data salinan dengan kunci peti besi luaran: sesi dan kunci penandatanganan kekal disulitkan tanpa kunci induk.

Dibiarkan kepada anda

  • Token panel utama mempunyai kawalan penuh. Berikan orang lain akses terhad kepada akaun, sembang dan tindakan yang mereka perlukan; jaga kunci utama agar kekal peribadi.
  • Pentadbir mesin boleh membaca semuanya dan menulis semula serta menandatangani semula jurnal tersebut. Simpan cap jari dan titik pemeriksaan pada sistem lain.
  • Teks mesej dan media tidak disulitkan oleh TgWitness. Gunakan penyulitan cakera dan kebenaran yang ketat.
  • HTTP biasa di luar localhost mendedahkan token di rangkaian. Gunakan HTTPS atau terowong SSH.
  • Tandatangan membuktikan apa yang dirakam tidak diubah, bukan bahawa setiap peristiwa Telegram telah dirakam.

Berkongsi akses kepada satu kes dengan kebenaran, tarikh luput dan had sesi. Token saksi kekal sebagai kelayakan berasingan.

Mengukuhkan pemasangan

  1. Gunakan akaun Telegram khusus — jangan sekali-kali akaun utama anda. Token panel dan sesi memberikan kawalan penuh ke atasnya.
  2. Biarkan panel pada 127.0.0.1. Aksesnya secara jauh hanya melalui HTTPS (konfigurasi Caddy yang disertakan) atau terowong SSH.
  3. Sulitkan cakera yang mengandungi direktori data: teks mesej dan media disimpan seperti mana ia diterima.
  4. Hadkan direktori data kepada akaun perkhidmatan. Direktori baru mendapat mod 0700 pada Unix; pada Windows, tetapkan kebenaran folder.
  5. Simpan kunci induk peti di lokasi lain pada pelayan: tetapkan TGWITNESS_VAULT_KEY_FILE sebelum mencipta direktori data.
  6. Simpan cap jari kunci penandatanganan dan titik pemeriksaan pada sistem lain, dan tambahkan saksi pada hos lain.
  7. Jangan muat naik data/, sesi, panel-token.txt atau kunci vault ke GitHub atau sembang.
  8. Jangan log penanda aras Authorization atau badan permintaan di proksi terbalik.
Bolehkah saya menukar token panel tanpa kehilangan data?

Ya. Token hanya membuka panel. Hentikan TgWitness, padamkan panel-token.txt daripada direktori data dan mulakan semula; jurnal, sesi dan kunci tidak terjejas. Apabila TGWITNESS_TOKEN ditetapkan, nilai persekitaran digunakan sebaliknya fail.

Mengapa mesej tidak disulitkan semasa disimpan?

Pengumpul mesti membacanya untuk mencari, membandingkan versi dan mengeksport. Mengkripsi dengan kunci pada mesin yang sama hanya menambah sedikit perlindungan terhadap seseorang yang boleh membaca mesin tersebut. Penyulitan cakera melindungi cakera yang dimatikan atau dicuri; kebenaran ketat melindungi cakera yang sedang berjalan.

Laporkan kerentanan

Gunakan Security → Laporkan kerentanan di repositori GitHub. Sertakan versi, impak dan reproduksi sintetik minimum. Jangan sekali-kali menghantar maklumat log masuk, direktori akaun atau arkib bukti sebenar. Jika pelaporan peribadi tidak tersedia, buka isu untuk meminta saluran peribadi tanpa butiran eksploitasi.