TgWitness / Dokumentasi

Apa yang telah diuji →

Dokumentasi / 14

Telegram · Jaga keselamatannya

Apa yang meninggalkan mesin anda, apa yang dibuka oleh setiap rahsia, dan apa yang dilindungi berbanding apa yang menjadi tanggungjawab 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, panel dan setiap rekod kekal pada mesin anda. Secara lalai hanya Telegram yang dihubungi; selebihnya 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.

Apa yang dibuka oleh setiap rahsia

RahsiaDi mana ia disimpanApa yang dibukanyaJika bocor
Token panelpanel-token.txt dalam direktori data; pelayar menyimpannya bagi setiap tabSegala-galanya dalam setiap ruang kerjaHentikan TgWitness, padam panel-token.txt, mulakan semula: anda mendapat yang baharu
Sesi TelegramVault, disulitkan (credentials.enc)Akaun Telegram itu sendiriBatalkan sesi di Telegram di bawah Tetapan → Peranti
Kunci penandatanganVault, disulitkan (signing.enc)Menandatangani rekod di bawah cap jari andaCheckpoint di tempat lain, saksi dan cap masa masih menunjukkan apa yang wujud sebelum ini
Kunci peti besivault.key di sebelah data, atau kunci induk luaranPeti besiAnggap sesi dan kunci tandatangan juga bocor
Token saksiPada hos saksiBaca sahaja: checkpoint dan kesihatanPadamkannya di halaman Saksi, buat yang baharu
Salinan kunci luar tapakVault; muat turun sekali untuk pemulihanSalinan luar tapakSesiapa yang juga memegang bucket boleh menyahsulitnya: anggap salinan itu terdedah

Apa yang dilindungi oleh perlindungan

Diliputi

  • Rekod yang diubah, dibuang atau disusun semula: rantaian hash atau tandatangan rosak.
  • Jurnal yang dipotong atau dibina semula selepas anda menyimpan checkpoint di tempat lain: checkpoint tidak lagi sepadan.
  • Meneka token: 256 bit rawak, perbandingan masa malar, 15 kegagalan seminit dan alamat itu disekat.
  • Kandungan sembang berniat jahat: teks kekal teks, tidak pernah HTML; lampiran dimuat turun sebagai fail; panel tidak memuatkan apa-apa daripada laman lain.
  • Direktori data yang dicuri dengan kunci peti besi luaran: sesi dan kunci kekal disulitkan.

Dibiarkan kepada anda

  • Token utama boleh melakukan apa sahaja. Beri orang lain akses berskop dan simpan token utama untuk diri sendiri.
  • Simpan cap jari dan checkpoint di tempat lain.
  • Sulitkan cakera, ketatkan kebenaran.
  • HTTP biasa di luar localhost membocorkan token. Gunakan HTTPS atau terowong SSH.
  • Semak liputan untuk mencari jurang dan uji penghantaran pada akaun dan sumber anda sendiri.

Kongsi akses kepada kes dengan kebenaran, tarikh luput dan had sesi.

Mengukuhkan pemasangan

  1. Gunakan akaun Telegram khusus, jangan sekali-kali akaun utama anda.
  2. Kekalkan panel pada 127.0.0.1. Akses jauh hanya melalui HTTPS (Caddy yang disertakan) atau terowong SSH.
  3. Sulitkan cakera yang menyimpan direktori data.
  4. Hadkan direktori data kepada akaun perkhidmatan (0700 pada Unix, kebenaran folder pada Windows).
  5. Simpan kunci peti besi di tempat lain pada pelayan: tetapkan TGWITNESS_VAULT_KEY_FILE sebelum mula pertama.
  6. Simpan cap jari dan checkpoint pada sistem lain, jalankan 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, ia hanya membuka panel. Hentikan TgWitness, padam panel-token.txt, mulakan semula. Jurnal, sesi dan kunci kekal. Jika TGWITNESS_TOKEN ditetapkan, nilai itu mengatasi fail.

Laporkan kerentanan

Security → Report a vulnerability di GitHub. Versi, kesan dan penghasilan semula minimum dengan data palsu. Jangan sekali-kali hantar kelayakan, folder akaun atau bukti sebenar. Jika pelaporan peribadi dimatikan, buka issue untuk meminta saluran peribadi, tanpa butiran eksploit.