TgWitness / Belgeler

Neler test edildi →

Belgeler / 14

Telegram · Güvenliği sağlayın

Makinenizden ne çıkar, her sır neyi açar ve korumalar neyi kapsar, neyi size bırakır.

127.0.0.1Varsayılan panel adresi
256 bitrastgele panel jetonu
0CDN'ler, analitik araçlar veya uzaktan fontlar
Ed25519her kayda imza

Her şeyin bulunduğu yer

Toplayıcı, panel ve tüm kayıtlar makinenizde kalır. Varsayılan olarak yalnızca Telegram'a bağlanılır; geri kalan her şey ayrı bir anahtardır.

06 / MAKİNEDEN NE ÇIKAR?Kurulumunuz
BİLGİSAYARINIZ VEYA SUNUCUNUZ
Panel127.0.0.1:8787 · taşıyıcı belirteci
ToplayıcıHer çalışma alanı için bir Telegram istemcisi
VERİ DİZİNİ
GünlükSQLite · hash zincirli · imzalı
MedyaSHA-256 ile adlandırılmış dosyalar
VaultFernet · oturum, API çifti, imzalama anahtarı, proxy
  • TelegramHer zaman · sizin rotanız üzerinden

    Hesabın MTProto bağlantısı: doğrudan, SOCKS5, HTTP veya MTProxy. IP gizleme modu, çalışan bir proxy bekler. Doğrudan yedekleme, bunu açıkça izin veren bir mod gerektirir.

  • Site dışı metinİsteğe bağlı · varsayılan olarak kapalı

    Günlük, dosyalar ve kontrol noktaları, S3 uyumlu depolama alanına yüklenmeden önce AES-GCM ile şifrelenir. Şifre anahtarı sizde kalır; ekler, içerik hash'leri yerine anahtarlı hash'lerle adlandırılır.

  • Bildirimlerİsteğe bağlı · varsayılan olarak kapalı

    Sohbet başlıklarıyla ilgili sorunlar ve değişiklik sayıları. Mesaj alıntıları, yalnızca bu özelliği etkinleştirirseniz gönderilir.

  • Zaman damgası yetkisiİsteğe bağlı · varsayılan olarak kapalı

    Yalnızca imzalı bir kontrol noktasının SHA-256 değeri ve rastgele bir nonce. Mesaj yok, sohbet adları yok.

  • Tanıkİsteğe bağlı · varsayılan olarak kapalı

    Salt okunur bir jetonla imzalı kontrol noktalarını ve yakalama sayaçlarını alır. Sohbetleri okuyamaz veya ayarları değiştiremez.

Varsayılan ayar: Bu makineden yalnızca Telegram bağlantısı dışarıya çıkar.

İsteğe bağlı hedefler, çalışma alanı başına yapılandırılır.

Her bir sırın açığa çıkardığı şeyler

GizliNerede saklanır?Neleri mümkün kılarEğer sızarsa
Panel jetonuVeri klasöründe panel-token.txt; tarayıcı onu sekme başına tutarHer çalışma alanındaki her şeyTgWitness'ı durdurun, panel-token.txt'yi silin, yeniden başlatın: yenisi oluşur
Telegram oturumuŞifreli depo (credentials.enc)Telegram hesabının kendisiTelegram'da Ayarlar → Cihazlar bölümünden oturumu sonlandırın
İmza anahtarıŞifreli depo (signing.enc)Kayıtları sizin parmak izinizle imzalamakBaşka yerde saklanan kontrol noktaları, bir tanık ve zaman damgaları önceden neyin var olduğunu yine gösterir
Kasa anahtarıVerilerin yanında vault.key ya da harici bir ana anahtarKasaOturumun ve imza anahtarının da sızdığını varsayın
Witness tokeniWitness sunucusundaSalt okunur: kontrol noktaları ve durumTanık sayfasında silin, yenisini oluşturun
Site dışı metin anahtarıVault; kurtarma amacıyla bir kez indirinHarici kopyaBucket'a da sahip olan herkes onu çözebilir: kopyayı açığa çıkmış sayın

Koruma kapsamı

Kapsanan konular

  • Değiştirilmiş, kaldırılmış ya da yeniden sıralanmış bir kayıt: karma zinciri ya da bir imza bozulur.
  • Siz başka yere bir kontrol noktası kaydettikten sonra kısaltılmış ya da yeniden kurulmuş bir günlük: kontrol noktası artık eşleşmez.
  • Belirteci tahmin etmek: 256 rastgele bit, sabit zamanlı karşılaştırma; dakikada 15 hata ve adres engellenir.
  • Düşmanca sohbet içeriği: metin metin kalır, asla HTML olmaz; ekler dosya olarak iner; panel başka sitelerden hiçbir şey yüklemez.
  • Harici kasa anahtarıyla çalınmış bir veri klasörü: oturumlar ve anahtarlar şifreli kalır.

Size kalmış

  • Ana belirteç her şeyi yapabilir. Başkalarına kısıtlı erişim verin, ana belirteci kendinize saklayın.
  • Parmak izini ve kontrol noktalarını başka yerde tutun.
  • Diski şifreleyin, izinleri kısıtlayın.
  • localhost dışında düz HTTP belirteci sızdırır. HTTPS ya da SSH tüneli kullanın.
  • Kapsamda boşluk olup olmadığını kontrol edin ve teslimatı kendi hesaplarınız ve kaynaklarınızda test edin.

Bir davaya erişimi paylaşın; izinler, süre sonu ve oturum sınırlarıyla.

Kurulumu güçlendirin

  1. Ayrı bir Telegram hesabı kullanın, asla ana hesabınızı değil.
  2. Paneli 127.0.0.1'de tutun. Uzaktan erişim yalnızca HTTPS (paketli Caddy) ya da SSH tüneli ile.
  3. Veri klasörünün bulunduğu diski şifreleyin.
  4. Veri klasörünü hizmet hesabıyla sınırlayın (Unix'te 0700, Windows'ta klasör izinleri).
  5. Kasa anahtarını başka yerde tutun; sunucularda ilk başlatmadan önce TGWITNESS_VAULT_KEY_FILE ayarlayın.
  6. Parmak izini ve kontrol noktalarını başka bir sistemde saklayın, başka bir sunucuda bir tanık çalıştırın.
  7. data/, oturum anahtarları, panel-token.txt veya kasa anahtarlarını asla GitHub'a veya bir sohbete yüklemeyin.
  8. Ters proxy'de Authorization başlıklarını veya istek gövdelerini kaydetmeyin.
Verileri kaybetmeden panel jetonunu değiştirebilir miyim?

Evet, yalnızca paneli açar. TgWitness'ı durdurun, panel-token.txt'yi silin, yeniden başlatın. Günlük, oturumlar ve anahtarlar kalır. TGWITNESS_TOKEN ayarlıysa o değer dosyanın önüne geçer.

Bir güvenlik açığını bildir

GitHub'da Security → Report a vulnerability. Sürüm, etki ve kurgusal verilerle küçük bir örnek. Asla kimlik bilgileri, hesap klasörleri ya da gerçek kanıt göndermeyin. Gizli bildirim kapalıysa, istismar ayrıntısı vermeden gizli bir kanal isteyen bir issue açın.