TgWitness / Dokumentasi

Apa yang telah diuji →

Dokumentasi / 14

Telegram · Jaga keamanannya

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.1alamat panel secara default
256-bittoken panel acak
0CDN, analitik, atau font jarak jauh
Ed25519tanda 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
Panel127.0.0.1:8787 · token bearer
Pengumpulsatu klien Telegram per ruang kerja
DIREKTORI DATA
JurnalSQLite · berantai hash · ditandatangani
Mediafile yang diberi nama berdasarkan SHA-256
VaultFernet · sesi, pasangan API, kunci penandatanganan, proxy
  • TelegramSelalu · 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 situsOpsional · 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.

  • PemberitahuanOpsional · dinonaktifkan secara default

    Masalah dan jumlah perubahan disertai judul obrolan. Kutipan pesan hanya dikirim jika Anda mengaktifkannya.

  • Otoritas cap waktuOpsional · dinonaktifkan secara default

    Hanya nilai SHA-256 dari titik pemeriksaan yang ditandatangani dan nilai nonce acak. Tidak ada pesan, tidak ada nama obrolan.

  • SaksiOpsional · 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

RahasiaDi mana disimpanApa yang dapat diaksesJika bocor
Token panelpanel-token.txt di direktori data; browser menyimpannya per tabSemua hal di setiap ruang kerjaHentikan TgWitness, hapus panel-token.txt, jalankan lagi: Anda mendapat yang baru
Sesi TelegramVault, terenkripsi (credentials.enc)Akun Telegram itu sendiriAkhiri sesi di Telegram melalui Pengaturan → Perangkat
Kunci penandatangananVault, terenkripsi (signing.enc)Menandatangani catatan dengan sidik jari AndaCheckpoint di tempat lain, saksi, dan cap waktu tetap menunjukkan apa yang ada sebelumnya
Kunci brankasvault.key di samping data, atau kunci induk eksternalBrankasAnggap sesi dan kunci tanda tangan juga bocor
Token WitnessDi server TgWitnessBaca-saja: checkpoint dan statusHapus di halaman saksi, buat yang baru
Kunci teks di luar situsVault; unduh sekali untuk pemulihanSalinan luarSiapa 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 dengan izin, masa berlaku, dan batas sesi.

Memperkuat instalasi

  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.