Referans / Güvenlik ve proje
Telegram · Güvenlik ve veri işleme
Tehdit modeli, erişim modeli, depolanan gizli bilgiler, ağ maruziyeti, oturum içe aktarmaları ve bir güvenlik açığının nasıl bildirileceği.
TgWitness / Belgeler · Dağıtım ve kurtarma
Bu sayfa, yerel veya sunucu çalışma alanında erişim, depolama ve ağ korumasını açıklamaktadır. GitHub runner'da veya Intel TDX gizli sanal makinesinde veri toplama için, toplama ortamına yönelik kontroller ekleyen doğrulama modları bölümüne bakın. Hesap bağlantıları, bildirimler, zaman damgaları, site dışı kopyalar ve tanıkların kendi yönlendirme ayarları vardır.
| Alan | Kısacası |
|---|---|
| Erişim | Yönetici anahtarı ve hesaplara/sohbetlere kapsamlı erişim, yedi izin düzeyi ve iptal edilebilir oturumlar; varsayılan olarak localhost |
| Depolanan gizli bilgiler | Oturum, API çifti, imzalama anahtarı ve proxy ayarları Fernet ile şifrelenmiştir. |
| Mesajlar ve medya | Çalışma alanındaki dosyalar, disk veya birim şifreleme ve ana bilgisayarın dosya izinleriyle korunur |
| Bütünlük | Her kayıtta SHA-256 hash zinciri ve Ed25519 imzası bulunur |
| Harici zaman | RFC 3161 ve OpenTimestamps makbuzları, Telegram tarafından tarih atanan tanık gönderileri ve GitHub tasdiki; saklanan kontrol noktaları, tanık kayıtları ve Intel TDX ölçümleri destekleyici kontroller olarak kullanılır. Doğrulayıcı, hangi kanıt koşullarını karşıladığını bildirir. |
Güvenlik açıkları bildirimleri için güvenlik politikasına bakınız.
Bu sayfada
Erişim modeli#
Ana panel belirteci tam kontrol sağlar. Diğer kullanıcılar kendi kapsamlı erişim haklarını alabilirler: seçilen çalışma alanları ve sohbetler, izinler, geçerlilik süresi, IP kısıtlamaları, oturum açma sınırları ve iptal edilebilir oturumlar. Sohbetle sınırlı erişim, izni işaretli olsa bile tüm çalışma alanı işlemlerini gerçekleştiremez. Her çalışma alanının tek bir işlem içinde kendi günlüğü, kasası ve imzalama anahtarı vardır; ana bilgisayardaki kullanıcılar arasındaki ayrım, işletim sistemi hesaplarından kaynaklanır.
Panel, varsayılan olarak localhost'ta dinleme yapar. Tarayıcı üzerinden oturum açıldığında, bir erişim jetonu oturum kimlik bilgileriyle değiştirilir; tarayıcı bunu taşıyıcı jeton olarak gönderir. Bu jeton, kimlik doğrulama çerezi yerine sessionStorage'da saklanır. Kilitleme/oturum kapatma işlemi, tarayıcı oturumunu temizler. Tarayıcının kapatılması veya oturumun sonlandırılması, veri toplama işlemini durdurmaz.
Verilen tokenlar ve oturum kimlik bilgileri, şifrelenmiş kasada hash olarak saklanır. İptal işlemi, ilgili oturumları sonlandırır; izin değişiklikleri ise sonraki istekleri etkiler. İndirilen dosyalar geri alınamaz. Yönetici, kendi tarayıcı oturumlarını da sınırlayabilir, ancak ana panel tokenını kullanan komut dosyaları doğrudan tam erişim hakkını korur ve bu tarayıcı oturumu sınırlamalarını atlar.
Başarısız kimlik doğrulama işlemleri, istemci adresine göre hız sınırlamasına tabidir. IP kısıtlamaları, uygulama tarafından görülen adresi kullanır; buna güvenmeden önce ters proxy davranışını kontrol edin. Witness kimlik bilgileri, ayrı, salt okunur kontrol noktası/durum kimlik bilgileri olarak kalır.
Demo erişimi#
/api/demo-access, açıkça
başlatılmış, izole edilmiş sentetik bir demo için kasıtlı olarak kimlik doğrulaması yapılmamış bir önyükleme aracıdır. Ayrı bir işlem ömrü yeteneği sağlar,
asla gerçek panel jetonu veya bir TGWITNESS_TOKEN geçersiz kılma işlemi yapmaz. Bu yetkinin verilmesi ve kullanılması için bir
loopback eş ve Host gereklidir; başlıkların iletilmesi ve kaynaklar arası istekler kabul edilmez. Ek
çalışma alanları veya yetkili bir oturum bu yolu devre dışı bırakır. Canlı çalışma alanları bu
yetkiyi asla vermez. Demo, hesapları birbirine bağlayamaz veya toplama ayarlarını değiştiremez.
Panel içeriği ve dışa aktarımlar#
Panel, harici yazı tipleri, analiz araçları, CDN kaynakları veya gömülü uzaktan medya kullanmaz. Telegram kaynaklı metinler HTML olarak değil, metin olarak eklenir. İndirilen ekler ikili ekler olarak sunulur. JSONL dışa aktarımları orijinal dizeleri korur; HTML ise bunları kaçırır; formüle dönüşebilecek CSV hücrelerinin başına apostrof eklenir.
Dışa aktarımlar, kimlik doğrulama ve imzalama gizli bilgilerini içermez, ancak kasıtlı olarak toplanan kaynak meta verilerini, tanımlayıcıları ve muhtemelen kişisel veya hassas içeriği içerir. Telegram erişim hash'leri ve dosya referansları, ham kaynak meta verilerinde yer alabilir.
Depolanan gizli bilgiler#
Telegram API kimlik bilgileri, oturum ve imzalama anahtarı Fernet ile şifrelenmiştir. Yerel mesajlar ve medya için şifreleme, ana bilgisayarın diski veya birimi tarafından sağlanır; çalışma alanı ise sıradan dosyaları depolar. Dışa aktarımlarda parola korumalı AES-256 ZIP kullanılabilir, ve site dışı kopyalar için AES-256-GCM kullanılır.
Kasa anahtarı varsayılan olarak korumalı veri dizinine ayarlanmıştır. Aşağıdaki harici ana anahtar dosyasını kullanarak anahtarı ayrı bir yerde saklayın. Unix'te, yeni özel anahtar dosyaları 0600 modunu ve yeni veri dizinleri 0700 modunu kullanır; Windows'ta ise hizmet hesabı ve yetkili yöneticiler için dizin ACL'sini ayarlayın. Mevcut dizin izinleri korunur.
Harici ana anahtar#
Yeni bir veri dizini için, TGWITNESS_VAULT_KEY_FILE harici bir rastgele ana anahtar sağlayabilir. HKDF-SHA256 ve ayrı bir rastgele tuz, her çalışma alanı için farklı bir Fernet anahtarı türetir. Kurtarma amacıyla vault.external.json dosyası saklanmalıdır. Eksik veya yanlış anahtarlar, işlem başarısızlıkla sonuçlanır. Mevcut yerel kasalar sessizce taşınmaz. Panel, seçilen anahtar depolama modunu gösterir. Disk şifreleme, her iki modda da yerel mesaj ve medya dosyalarını korur; kurulum ayrıntıları için bkz. bağlantı ve veri koruması.
Proxy'ler ve ağ yolları#
Proxy yapılandırması kasada şifrelenir. Şifreler ve MTProxy gizli bilgileri API tarafından döndürülmez veya kanıt kayıtlarına yazılmaz. Her çalışma alanı kendi Telegram rotasını ve bir IP modunu seçer.
Adresi gizle seçeneği, doğrudan Telegram yedeklemeyi engeller ve harici HTTP istekleri için bir proxy gerektirir. Açıkça seçilen yedekleme modu, gecikmeden sonra doğrudan Telegram erişimine izin verir; tünel/VPN modu ise doğrudan yollara izin verir. Tünel modunun seçilmesi, bir VPN'in kurulmasını veya doğrulanmasını gerektirmez. Bu ayarlar, tüm makine trafiğini, tarayıcıları, paket yöneticilerini veya yerel proxy sunucusunun DNS çözümlemesini kontrol etmez.
MTProxy yalnızca Telegram trafiğini taşır. Harici istekler için ayrı bir SOCKS5/HTTP proxy'si, çalışma alanının SOCKS5/HTTP rotası veya izin verilen bir doğrudan rota kullanılabilir; ayrıca devre dışı bırakılabilirler. Bağımsız tanık, kendi aktarım ayarlarına sahiptir. Sıradan SOCKS5/HTTP CONNECT kimlik doğrulaması, bu proxy protokollerinin kendisi tarafından şifrelenmez. Sahte TLS MTProxy gizli anahtarları hâlâ desteklenmemektedir.
Giriş ve oturum içe aktarma işlemleri#
Dönüştürülmüş .tgwitness-session dosyaları, kasaya yüklenip depolanana kadar düz metin biçiminde bir yetkilendirme şifresi içerir. Çevrimdışı CLI, gözden geçirilmiş Telethon şemalarını kabul eder. Panel içe aktarma özelliği ayrıca Pyrogram SQLite, modern tek hesaplı TData ZIP ve belgelenmiş JSON girdilerini kabul eder. Kimlik doğrulaması yapılır, dört dosya / 8 MiB ile sınırlıdır ve arşiv açma veya orijinal dosyaları kaydetme işlemine gerek kalmadan yüklemeleri bellekte işler. Normalleştirilmiş kimlik bilgileri yalnızca isteği yapan ve kimliği doğrulanmış tarayıcıya döndürülür; Telegram yetkilendirmesi başarıyla tamamlandıktan sonra şifreli kasada saklanır. Orijinalleri ve dönüştürülmüş dosyaları koruyun ve eşzamanlı istemcilerin yetkilendirmeyi kopyalamasını önleyin.
TData işleme, konteyner sağlama toplamlarını, yerel şifre çözme hash'lerini ve yapı uzunluklarını doğrular. Sağlanan Masaüstü yerel şifresi geçici olarak kullanılır ve saklanmaz. Sınırlı ayrıştırıcı, doğruladığı Masaüstü formatlarını destekler ve diğerlerini reddeder. QR görüntüleri yerel olarak oluşturulur, kısa ömürlü Telegram oturum açma belirteçleri içerir ve asla harici bir görüntüleme hizmetine gönderilmez. Kilitleme, çalışma alanı değiştirme, yeni oturum açma ve rota değişiklikleri, bekleyen QR denemelerini iptal eder. Bir sekmeyi yeniden yüklemek veya kapatmak, bir denemeyi süresi dolana kadar beklemede bırakabilir. Başarılı bir QR oturum açma işlemi yine de hesap bağlanmasını zorunlu kılar. Sıradan API gövdeleri 16 KiB ile sınırlı kalır; kimlik doğrulamalı içe aktarma yolu, 12 MiB'ye kadar kodlanmış JSON kabul eder ve daha küçük kod çözülmüş dosya sınırını ayrı olarak uygular.
Giriş kodları ve Telegram iki aşamalı doğrulama şifreleri kalıcı olarak saklanmaz. Telefon numarası/kod hash durumu, yetkilendirme sırasında bellekte tutulur. Telegram oturumları hesap erişimi sağlar; hiçbir zaman bir veri dizini, oturum, token, kasa anahtarı veya özel imzalama anahtarını GitHub'a yüklemeyin.
Günlükler ve aktarım#
Varsayılan API doğrulama yanıtı, kimlik bilgisi değerlerini yansıtmayacak şekilde değiştirilir. Uygulama erişim günlüğü devre dışıdır. Yetkilendirme başlıklarını veya istek gövdelerini günlüğe kaydetmek için ters proxy yapılandırmayın. Panel localhost'ta dinlemektedir; uzak erişim, sağlanan SSH tüneli, Cloudflare Tunnel veya Caddy HTTPS üzerinden gerçekleşir, bu nedenle belirteçler ve oturum açma gizli bilgileri SSH veya TLS içinde aktarılır.
Bütünlük ve harici zaman#
Doğrulama işlemi, kayıt imzalarını, hash zincirini, ekleri ve dışa aktarım manifestosunu
toplayıcı anahtarıyla karşılaştırır. Geçerli bir imza, baytların imzalandıklarından beri
değişmediğini gösterir. Her çalışma alanı, ilk başlatıldığında kendi imza anahtarını oluşturur ve
parmak izini panelde ve her dışa aktarımda gösterir. Operatör, parmak izini
alıcıya ayrı bir kanal üzerinden iletir ve --fingerprint anahtarı sabitler.
Değiştirilen, eklenen veya silinen bir kayıt, hash zincirini veya imzayı bozar ve
doğrulayıcı bunu bildirir. Harici zaman damgaları ve bir tanık da günlüğü çalışma
alanının dışında sabitler. Günlük tablosundaki SQLite tetikleyicileri, yalnızca uygulamanın
bir kaydı yanlışlıkla üzerine yazmasını veya silmesini engeller. TGWITNESS_VAULT_KEY_FILE kasayı
veri dizini kopyasının dışında tutar.
RFC 3161 ve OpenTimestamps makbuzları ile doğrulayıcının Telegram’dan okuduğu tarihlere sahip tanık gönderileri, kapsadıkları günlük önekini üçüncü bir tarafça belirlenen bir zamana bağlar. Günlüğe yazılan bir drand turu, ondan sonraki kayıtların o turun yayınlandığı tarihten önce oluşturulmadığını gösterir. Doğrulanmış bir GitHub tasdiki de imzasının doğrulanmış zamanını taşır; bu da tüm arşivi harici bir zamana bağlar. Bir kontrol noktası, toplayıcı anahtarıyla imzalanır ve alıcının başka bir kanal aracılığıyla bunu elde ettiği andan itibaren o noktaya kadar olan kayıtları bağlar. Bir tanık, ikinci bir anahtarın günlük başlığını sakladığını gösterir; saklayıcının anahtar kontrol kaydı ise bu anahtarı kimin elinde tuttuğunu gösterir. Her ikisi de destekleyici kontroller olup, asgari gereklilik üçüncü taraf zamanıdır. GitHub Actions kaydı veya bir Intel TDX dağıtımı, toplama ortamının iş akışı köken bilgisini veya donanım ölçümlerini ekler.
Her doğrulama yanıtı, kanıt koşullarını ve her birinin nasıl kontrol edildiğini listeler; bunlar, asgari düzeyde rollerine göre gruplandırılır:
| Rol | Koşul |
|---|---|
| Gerekli | Bütünlük; --fingerprint ile sabitlenmiş imzalayıcı anahtarı; son kaydı kapsayan harici zaman damgası (--tsa-ca ile kontrol edilen RFC 3161 makbuzu, --check-bitcoin ile onaylanan OpenTimestamps makbuzu, --channel ile t.me'den okunan tanık gönderisi, tanığın Bitcoin mührü veya kontrol edilmiş GitHub tasdiki) |
| Destekleyici, asgari gereksinimlerin bir parçası değil | Kendi anahtarına sahip tanık; saklanan kontrol noktası; onaylanmış toplama çalışması |
Kanıt için asgari şart, son dışa aktarılan
kayıt için gerekli üç koşulun da karşılanmasıdır; doğrulanmış ve onaylanmış bir toplama işlemi, attested profili ekler.
Son satır sonucu belirtir ve cevap, eksik koşulları karşılayacak seçenekleri
sıralar. --fingerprint son satır şu şekilde başlar
EVIDENCE: minimum not met · missing: confirmed signer key.
Doğrulanmış zaman damgaları yalnızca daha önceki kayıtları kapsıyorsa, cevap asgari koşulun geçerli olduğu
son kaydı belirtir. --require evidence veya --require attested dışa aktarımın tamamı için profile ulaşılamadığında
2 koduyla sonlandırılır ve komut
satırında talep edilen ancak çalıştırılamayan bir kontrol, aynı kodla gerçekleştirilmedi olarak raporlanır. Her rapor,
o kopyadaki durumlarıyla birlikte aynı koşulları ve bunları kontrol eden
komutu içerir. Güvence kademeleri ve --strict kullanılabilir olmaya devam eder;
kanıt biçimi, her bir toplama modu için kontrolleri listeler.
Bir sorun olduğundan şüpheleniyorsanız#
Orijinal veri dizinini koruyun ve analiz için ayrı bir kopya kullanın. güvenlik politikası aracılığıyla etkilenen sürümü, işlemi ve tekrarlanabilir adımları bildirin; hesap verilerini ve kimlik bilgilerini gizli tutun.