# Telegram · Gizli Sohbetler: kurulum ve kayıt

Canonical page: https://phishdestroy.io/tgwitness/tr/docs/reference/secret-chats/

Gizli sohbet protokol eklentisini kurun, hesap bazında etkinleştirin ve TgWitness'in oluşturduğu veya kabul ettiği sohbetleri kaydedin.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/tr/llms.txt)

Gizli sohbet protokol eklentisini kurun, hesap bazında etkinleştirin ve TgWitness'in oluşturduğu veya kabul ettiği sohbetleri kaydedin.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Belgeler](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

Yayınlanan uygulama, Gizli Sohbet arka ucunu, toplayıcı entegrasyonunu, API rotalarını ve **Sözde sır** arayüz. Protokol kütüphanesi ayrı bir modüldür: aç **Sözde sır** ve tuşa basın **Kurun ve çalıştırın**. Otomatik gelen çağrı kabulü siz etkinleştirene kadar kapalı kalır.

## Protokol modülü

|  |  |
| --- | --- |
| Modül | `kiaro-telethon-secret-chat` 0.2.0 |
| Yazar | KiaroSama |
| Lisans | GPL-3.0 veya daha yeni sürümleri; bunun `LICENSE` ve `NOTICE` kaydedilen arşivin içinde kal |
| Kaynak | [KiaroSama/Telethon-Secret-Chat,](https://github.com/KiaroSama/Telethon-Secret-Chat) commit sırasında `d87bf037b90060383c7b704d8a06ebb98c621c6f` |
| Kontrol et | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` paket dosyalarının listesi ve bunların kendi SHA-256 değerleri üzerinde |

**Yükleme ve etkinleştirme işlemleri** ana yönetici tarafından gerçekleştirilebilir. TgWitness, Telegram dışındaki istekler için çalışma alanının rotası üzerinden GitHub’dan söz konusu commit’in kaynak arşivini indirir, paketin her dosyasını TgWitness sürümünde belirlenen değerle karşılaştırır, arşivi `modules/telethon-secret-chat-<commit>.zip` veri dizini içinde kaydeder ve kodu bellekten yükler. Yeniden başlatma gerekmez. Kontrol, her başlangıçta yeniden gerçekleştirilir; farklılık gösteren bir arşiv yüklenmez ve sayfada bu durum belirtilir. Değiştirilmiş, eksik veya eklenmiş bir paket dosyası, kontrolün başarısız olmasına neden olur.

Bu modül, kendi lisansına sahip ayrı bir çalışmadır. TgWitness bu modülü paketlemez: her kurulumda modül, yazarın deposundan indirilir. Sayfadaki **ayrıntılar**, yüklenen modülü, yazarını, lisansını, commit numarasını ve SHA-256 değerini gösterir.

GitHub’a erişimi olmayan bir sunucu, aynı commit’i bunun yerine Python ortamına yükleyebilir; panel daha sonra bu kopyayı kullanır:

```
python -m pip install ".[secret-chats]"
```

TgWitness, oluşturduğu veya kabul ettiği sohbetler için bir uç nokta haline gelir. İmzalı günlükte mesajları, mevcut ekleri, zamanlayıcı değişikliklerini ve silme bildirimlerini kaydeder. Daha önce kaydedilen içerik, daha sonraki bir silme bildiriminden sonra da erişilebilir kalır.

## Paketin kullanılabilirliği

8 Kasım 2026 tarihinde, yayınlanan yükleyici paketi [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) kaynak kodunda, `b35f8e18f3d1-1ff85ec98bb2` sürümünde, 0.9.1 önizleme sürümünde kontrol edildi. [Değiştirilemez tekerlek](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) ve bağımlılık kilidi, SHA-256 ve RSA sürüm imzası doğrulamasından geçti. Paketlenmiş arka uç ve arayüz, söz konusu kaynak revizyonuyla bayt bayt eşleşti. Paket ayrıca API kaydı ve toplayıcı kancalarını da içerir.

O paket protokol kütüphanesini içermiyordu ve bağımlılık kilidinde de yer almıyor. `secret-chats` [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) dosyasındaki "extra" kısmı, panel düğmesiyle aynı commit'i sabitliyor.

Bu paket denetimi, hangi dosyaların ve bağımlılık bildirimlerinin dağıtıldığını belirler. [Doğrulama kaydı,](https://phishdestroy.io/tgwitness/tr/docs/reference/verification/) ayrı çalışma zamanı kontrollerini tanımlar. 6 Kasım tarihli önceki kılavuzda bir geliştirme anlık görüntüsü açıklanmıştı; artık yukarıdaki paketi açıklamamaktadır.

## Arayüzü kullanın

**Pseudo-secret'i** açın, sayfa sunuyorsa modülü yükleyin, hesap için etkinleştirin ve bağlayın. Otomatik kabul özelliği etkinleştirilmedikçe, gelen istekler kabul edilene kadar bekler. Başlatma, kabul etme, gönderme ve kapatma işlemleri, hesabın etkileşim izinlerini ve salt okunur korumasını kullanır.

| Eylem | Korunan sonuç |
| --- | --- |
| Kullanıcı adı veya kullanıcı kimliği ile sohbet başlatın | Giden istek; eş, bunu kendi cihazında kabul eder. |
| Bir isteği kabul et | TgWitness, alıcı uç noktası haline gelir. |
| Mesaj gönderin veya alın | Yönü, içeriği ve sağlanan zamanlayıcısıyla birlikte `secret_chat.message`. |
| Bir dosya alın | SHA-256 ve bir `secret_chat.file` makbuzu ile depolanan şifresi çözülmüş baytlar; kanıt dışa aktarımına dahil edilmiştir. |
| Zamanlayıcı veya silme bildirimi alın | Saklanan mesajlar ve dosyaların yanı sıra ayrı bir eylem kaydı. |
| Sohbeti inceleyin | Sohbet, dosya makbuzları, bildirimler ve anahtar görselleştirme. |

Başka bir cihazdaki mevcut Gizli Sohbetler, cihaza özgü anahtarlarını korur. İçe aktarılan bir bulut oturumu bu anahtarları aktarmaz. Gizli sohbet anahtar malzemesi ve sayaçlar çalışma alanı kasasını kullanır; saklanan mesajlar ve şifresi çözülmüş dosyalar ise normal çalışma alanı depolama korumalarını kullanır.

## Kaydedilmiş mesajları bul

Açık bir sohbet içindeki **Mesajları Ara** özelliğini kullanarak, büyük/küçük harf farkı gözetmeksizin belirli bir ifadeyi bulun. Arama alanında **Önceki** ve **Sonraki** düğmelerini veya Enter ve Shift+Enter tuşlarını kullanarak, eşleşen mesajlar arasında geçiş yapabilirsiniz. Sayaç mesaj sayısını gösterir; her mesajdaki ilk eşleşen ifade vurgulanır. Escape tuşuna basıldığında arama silinir.

Arama özelliği, çevredeki sohbeti, kaydedilmiş dosyaları ve silme bildirimlerini görünür tutar. Panele önceden yüklenmiş kayıtları tarar. Daha eski kayıtlar varsa, panel bunu bildirir; **Daha eski kayıtları yükle** seçeneği, geçmişi genişletir ve mevcut mesajı yerinde tutarken arama sonuçlarını günceller.

Aynı çalışma alanı içinde geçiş yaptığınızda her sohbetin arama geçmişi korunur. Paneli kilitlemek veya çalışma alanını değiştirmek bu aramaları siler. Arama terimleri sayfanın belleğinde kalır; tarayıcı depolama alanına kaydedilmez veya API sorguları olarak gönderilmez. Arama işlemi, Telegram mesajları veya yazma/okuma bildirimleri göndermez. Mevcut görünürlük ayarları, sohbeti açma ve diğer eylemler üzerinde hâlâ geçerlidir.

**Oluşturma raporu,** seçilen sohbetin rapor kapsamını korur; ekran araması, dışa aktarılan kayıtları görünmez bir şekilde sınırlamaz. Raporu indirmeden önce seçimi önizleyin.

## Kalıcılık ve etkileşim denetimleri

Entegre uygulama, yinelenenleri tespit etmek için dayanıklı günlük aramasını kullanır, indirme başarısızlığı sonrasında ek işlerini beklemede tutar ve kapatma işlemlerini diğer uzaktan eylemlerle aynı etkileşim koruyucusu üzerinden yönlendirir. Bunlar, 6 Kasım tarihli geliştirme anlık görüntüsü denetim raporunda belirtilen üç yolu değiştirir.

Günlüğe yazma işlemi başarısız olan şifresi çözülmüş mesajlar, yeniden deneme amacıyla kasada tutulur. Ek boyutu ve boş disk alanı kontrolleri, görevleri korurken indirme işlemlerini erteler. Modül, hesabın mevcut bağlantısını yeniden kullanır. Okuma ve yazma bildirimleri, yalnızca [Karşı tarafın gördükleri](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees) bölümünde seçilen şekilde gönderilir; ekran görüntüsü bildirimleri hiçbir zaman gönderilmez. [secret_chats.py dosyasına](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [API rotalarına](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) ve [erişim politikasına](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py) bakınız.

[Geçmiş denetim](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md), orijinal anlık durum bulgularını korur. Güncel kullanılabilirlik ve uygulama bilgileri, yukarıdaki paket revizyonundan ve [mevcut yetenek](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md)lerden okunmalıdır.

## Arayüz tanıtımı

Web sitesi senaryosu, panel iş akışını göstermek için kurgusal istekler, mesajlar ve dosyalar kullanır. Bu bir arayüz örneğidir; protokol ve toplama kontrolleri doğrulama kaydında kendi tarihli sonuçlarına sahiptir.
