Hesaplar ve oturum biçimleri

TgWitness, Telethon kullanarak MTProto üzerinden bir Telegram kullanıcı hesabı (bot değil) olarak oturum açar. Her hesap, kendi oturumu, kaynakları, günlüğü ve imzalama anahtarı ile birlikte kendi çalışma alanında (API ve komut satırı araçlarında "çalışma alanı" olarak adlandırılır) bulunur.

Oturum dosyaları, oturum dizeleri ve Oturum Açma Anahtarları hesap yetkilendirmeleridir: bunlardan birine sahip olan kişi, o hesap adına hareket edebilir. Bunlar mesaj geçmişini içermez.

[!UYARI] Kaybetmeyi göze alamayacağınız hiçbir şeyi kullanmayın. Kişisel veya başka şekilde değerli hesapları bağlamamanızı ve değer verdiğiniz bir hesap üzerinde API kimliği / API hash'i oluşturmamanızı şiddetle tavsiye ederiz. Bu, TgWitness’in test edilmemiş olmasıyla ilgili değildir: Telegram, hesapları öngörülemez bir şekilde kısıtlar ve kalıcı olarak yasaklar — istem hacminin, istemci veya amaç ne olursa olsun, aşırı olduğunu düşündüğü durumlarda, yeterli bir dokümantasyon olmaksızın. Birçok yasaklama geri alınamaz. Yalnızca bu amaç için ayrılmış hesaplar kullanın. Testlerin sorunsuz geçmesi, yazılıma değil Telegram’a bağlıdır ve ileride herhangi bir garanti vermez.

• Bir bakışta
• Başlamadan önce: API kimliği ve API hash değeri
• Telefon numarası · QR kodu · Oturum Açma Anahtarı + DC Kimliği
• Hesap dosyaları: Telethon .session · Pyrogram .session · Oturum + JSON çifti · TData · StringSession · Hesap JSON'u
• Elinizde ne olduğunu belirleyin · Desteklenmeyen formatlar
• Birden fazla hesap · Hesap dosyalarını güvende tutma · Sorun Giderme

Bir bakışta#

TgWitness, dosyaları adlarına göre değil, içeriklerine göre tanır. Bir dosyanın adının değiştirilmesi asla dosyanın dönüştürülmesine yol açmaz.

Başlamadan önce: API kimliği ve API hash değeri#

Telegram API uygulaması oluşturmadan oturum açabilirsiniz. Hiçbir çift girilmediğinde, ithal edilmediğinde veya çalışma alanında önceden kaydedilmediğinde, TgWitness yerleşik havuzundaki 50 adet genel API çiftinden (tgwitness/api_pool.py) rastgele bir çift seçer. Telegram bir çifti reddederse (API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), bir sonraki çift denenir; her oturum açma işlemi için en fazla sekiz çift denenir; reddedilen çiftler yeniden başlatılana kadar atlanır. Oturum açmada kullanılan çift, hesapla birlikte kaydedilir ve o hesap için yeniden kullanılır. Bir API kimliği ve API hash'i, uygulamayı Telegram'a tanımlar; bunlar tek başlarına bir hesabı yetkilendirmez.

Bunun yerine kendi uygulamanızı kullanmak isterseniz (uygulamayı kaydeden hesap risk altındadır; bkz. Neden yerleşik bir API havuzu?):

1. my.telegram.org adresini açın ve sahip olduğunuz herhangi bir telefon numarasıyla giriş yapın. Kod, SMS yoluyla değil, Telegram uygulamasına gelir.
2. API geliştirme araçlarını seçin.
3. Bir uygulama oluşturun: herhangi bir başlık ve kısa ad (5–32 harf), platform: Masaüstü. URL ve açıklama alanları boş bırakılabilir.
4. App api_id (bir sayı) ve App api_hash (32 onaltılık karakter) değerlerini kopyalayın.

Panelde, oturum açma formunun altında açık API Kimliği + Hash bulunur. API Kimliği alanına tek bir api_id:api_hash çifti yapıştırdığınızda her iki alan da doldurulur. Tek bir çift, tüm hesaplarınız için kullanılabilir. Başarılı bir oturum açma işleminden sonra bu bilgi, şifrelenmiş olarak yalnızca o çalışma alanında saklanır ve asla tarayıcıya geri gönderilmez.

Burada üç farklı kimlik bilgisi söz konusudur:

Telegram'a bir proxy üzerinden erişilmesi gerekiyorsa, önce Hesap → Ayarlar → Bağlantı ayarları → Bağlantı yolunu değiştir seçeneğinden ayarlayın.

Telefon numarası#

1. Hesap Aç seçeneğine tıklayın, Telefon sekmesine gidin ve numarayı uluslararası formatta girin, örneğin +44 7700 900123. Boşluklar ve tireler otomatik olarak kaldırılır.
2. "Devam" düğmesine basın. API Kimliği + Hash alanları boş bırakılabilir.
3. Telegram'ın gönderdiği kodu girin (genellikle Telegram uygulamasına gönderilir; SMS ile gönderilmesi garanti edilmez).
4. Hesapta iki aşamalı doğrulama varsa, o şifreyi girin. Bu, panel jetonu veya cihaz şifresi değildir.
5. Giriş yaptıktan sonra gösterilen hesap kimliğini kontrol edin, ardından kaynakları seçin.

Giriş kodları ve 2FA şifresi hiçbir zaman diske kaydedilmez.

QR kodu#

Hesap bir telefonda veya başka bir bilgisayarda zaten oturum açmışsa bunu kullanın.

1. QR kodu sekmesi → QR kodunu göster. API Kimliği + Hash alanları boş bırakılabilir.
2. Oturum açılmış cihazda: Ayarlar → Cihazlar → Masaüstü Cihazını Bağla seçeneğine gidin, kodu tarayın ve onaylayın.
3. Telegram talep ederse, TgWitness'e 2FA şifresini girin.

QR kodu görüntüsü yerel olarak oluşturulur. Kodların geçerlilik süresi dolabilir; yeniden denemek için "Başka bir QR kodu oluştur" düğmesine basın. Paneli kilitlemek, çalışma alanını değiştirmek veya başka bir oturum açma işlemi başlatmak, beklemede olan kodu iptal eder.

Oturum Açma Anahtarı + DC Kimliği#

Bir Oturum Açma Anahtarı (Auth Key), her Telegram oturumunun arkasında yatan 256 baytlık ham yetkilendirme verisidir ve 512 onaltılık karakterden oluşur; buna veri merkezi numarası DC 1–5 de eklenir.

1. "Auth" sekmesi. Anahtarın tamamını yapıştırın; … içeren kısaltılmış bir anahtar çalışmaz.
2. Anahtarla birlikte sağlanan DC kimliğini seçin.
3. İsteğe bağlı olarak Kullanıcı Kimliğini girin. Telegram farklı bir hesap bildirdiğinde TgWitness bağlantı kurmayı reddeder.
4. Press Connect hesabı.

Bir Oturum Açma Anahtarı (512 karakter), bir API hash'i (32 karakter) değildir. Aynı anahtar ayrıca JSON olarak da içe aktarılabilir; bkz. Hesap JSON'u.

Hesap dosyaları#

"Hesap Ekle" → "Dosyalar" seçeneğini açın ve bir hesaba ait, toplamda 8 MiB'ye kadar dört dosyayı seçin, ardından "Hesabı Bağla" düğmesine basın.

• Dosyalar, TgWitness sunucunuzun belleğinde dönüştürülür. Yüklenen dosyalar depolanmaz, ZIP dosyaları diske açılmaz ve hiçbir harici hizmetle bağlantı kurulmaz.
• Elde edilen oturum daha sonra Telegram ile karşılaştırılır. Bir dosyada bir kullanıcı kimliği belirtiliyorsa, bu kimlik, Telegram'ın bildirdiği hesapla eşleşmelidir.
• Farklı hesapları veya farklı API kimlik bilgilerini açıklayan dosyalar reddedilir; tek bir tanesini seçmek yerine.
• Şifre veya oturum metni, TData yerel şifre alanını içerir; bu alan, oturum açmadan StringSession ve Read dosyalarını yapıştırmak için bir kutudur (Telegram ile iletişime geçmeden formu doldurur).

Telethon .session#

Öncelikle dosyayı oluşturan programı kapatın. Yanında my_account.session-journal veya my_account.session-wal dosyası varsa, veritabanı henüz tamamlanmamıştır: orijinal istemciyi açın ve düzgün bir şekilde kapatın. Bu yan dosyaları silmek, bozuk bir kopya bırakabilir.

Pyrogram .session#

Oturum açma sırasında saklanan kullanıcı kimliği, Telegram ile karşılaştırılarak doğrulanır.

Oturum + JSON çifti#

Hesaplar genellikle aynı ada sahip iki dosya olarak dağıtılır; örneğin, 447700900123.session ve 447700900123.json. Her ikisini de aynı anda seçin.

• JSON'dan TgWitness, app_id/api_id ve app_hash/api_hash kullanır, bu nedenle genellikle API kimlik bilgilerini girmeniz gerekmez.
• phone, device, sdk, app_version, lang_pack gibi diğer alanlar veya kayıtlı bir twoFA şifresi göz ardı edilir. Hesapta 2FA varsa, TgWitness bunu ister.
• Tek başına bir JSON dosyası yalnızca meta veridir. Oturum dosyası yoksa, telefon veya QR koduyla oturum açmaya devam edin.

Telegram Masaüstü (TData)#

TData, Telegram Desktop uygulamasının (desktop.telegram.org adresinden indirilebilen platformlar arası uygulama) tdata klasörüdür.

İçe aktarmak için:

Paralel oturum uyarısı. TData'yı içe aktarmak, Telegram Desktop'un yetkilendirme anahtarını yeniden kullanır; bağımsız bir oturum açma oluşturmaz. Bu anahtarı Desktop ve TgWitness'te aynı anda kullanmayın. Telegram, AUTH_KEY_DUPLICATED ile yetkilendirmeyi geçersiz kılabilir ve yeni bir oturum açılana kadar her iki kopyayı da kullanılamaz hale getirebilir.

Desktop'u, sistem tepsisindeki işlemi de dahil olmak üzere tamamen kapatın ve TgWitness içe aktarılan oturumu kullanırken bu kopyayı kapalı tutun. Çıkın, oturumu kapatmayın veya oturumu iptal etmeyin: iptal etme işlemi, içe aktarılan kopyayı da geçersiz kılar. Her iki istemcinin de çalışması gerekiyorsa, telefon veya QR koduyla TgWitness'e giriş yaparak kendi yetkilendirme bilgilerinizi oluşturun. Ayrı bir hesap kullanılması önerilir, ancak bu, klonlanmış anahtarların paralel olarak güvenli bir şekilde kullanılmasını sağlamaz.

Bu, içe aktarılan .session dosyalar, StringSession metni ve Auth Key HEX için de geçerlidir. Kendi bağımsız yetkilendirmelerine sahip diğer istemciler oturumda kalmaya devam edebilir. Telegram’ın AUTH_KEY_DUPLICATED belgelerine bakın.

1. Telegram Desktop'tan tamamen çıkın.

2. tdata'den yalnızca bu iki öğeyi içeren bir ZIP dosyası oluşturun:

   • key_datas
   • Yanında s ile biten 16 karakterlik dosya, genellikle D877F783D5D3EF8Cs

   Medya önbelleği ile birlikte tüm klasörü ZIP dosyasına sıkıştırmak genellikle sınırları aşar (512 giriş, sıkıştırılmamış haliyle 32 MiB). 3. Dosyalar bölümünden ZIP dosyasını seçin. Telegram Desktop'ta yerel bir şifre varsa, bunu önce Şifre veya oturum metni alanına girin. Bu, 2FA şifresi değildir.

Desteklenenler: arşiv başına tek hesap, modern key_datas/key_data0/key_data1 depolama, yerel şifre. Desteklenmeyenler: birden fazla oturum açılmış hesabın bulunduğu klasörler, eski Masaüstü düzenleri, şifre korumalı ZIP dosyaları ve ayrı bir yerel macOS uygulaması olan "Telegram for macOS".

Telethon StringSession#

Genellikle 1 ile başlayan ve yaklaşık 350 karakter uzunluğunda tek satırlık bir metin. Bunu .txt veya .tgwitness-session dosyası olarak yükleyin (en fazla 4 KiB) ya da Şifre veya oturum metni alanına yapıştırın. Yalnızca Telethon dizeleri kabul edilir; Pyrogram ve TDLib dizeleri farklı biçimler kullanır.

Hesap JSON'u#

.json ile biten bir dosyada, en fazla 64 KiB boyutunda tek bir JSON nesnesi.

Hem takma ad hem de asıl ad mevcutsa, bunlar birbiriyle uyumlu olmalıdır. Örnekler:

{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }

{
  "api_id": 1234567,
  "api_hash": "0123456789abcdef0123456789abcdef",
  "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
  "dc_id": 2,
  "user_id": 123456789
}

İlk örnekte yalnızca API kimlik bilgileri girilir; telefon veya QR koduyla oturum açın ya da bir oturum dosyası ekleyin. Toplu listeler (hesapların bulunduğu bir JSON dizisi) kabul edilmez.

Elinizde ne olduğunu belirleyin#

Desteklenmeyen formatlar#

Birden fazla hesap#

Hesap seçicinin yanındaki + tuşuna basın veya Hesap → Ayarlar → Bağlantı ayarları → Çalışma alanları'nı açın, bir etiket girin ve oturum açın.

• Ana çalışma alanı dahil olmak üzere sınırsız sayıda çalışma alanı. Her birinin kendine ait oturumu, proxy yolu, kaynakları, yakalama politikası, günlüğü, imzalama anahtarı, kontrol noktaları ve dışa aktarımları vardır.
• Görüntülenen çalışma alanını değiştirmek, diğerlerini duraklatmaz.
• Bir günlük, onu oluşturan hesaba bağlı kalır. Farklı bir hesapla oturum açmak için başka bir çalışma alanı gerekir ve bir hesap iki çalışma alanına atanamaz.
• Ana panel jetonu tüm çalışma alanlarını kontrol eder. Verilen erişim izni, ayrı izinler ve oturum sınırlamalarıyla diğer kişilerin erişimini belirli hesaplar ve sohbetlerle sınırlayabilir.
• Hesaplar, bir çalışma alanının adını değiştirir ve eklenen bir çalışma alanını, oturumu, günlüğü, kaynakları ve imzalama anahtarıyla birlikte siler. Ana çalışma alanı panelden silinemez.

Toplu içe aktarma ve hesap grupları#

Birden fazla hesap eklemek, dosyaları temel adlarına göre eşleştirmek ve her girişin sonucunu görmek için Hesaplar → Hesapları içe aktar bölümünü kullanın. Her hesabın kendi çalışma alanı vardır. Gruplar oturumları, anahtarları veya kanıtları birleştirmeden bir şablondan seçilen ayarları kopyalayabilir. Bkz. içe aktarma ve grup kılavuzu ve MTProxy havuz paneli.

Çıkış#

Hesap → Telegram'dan çıkış yap (gözlem duraklatılmış halde), Telegram'dan oturumu sonlandırmasını ister; böylece oturum, hesabın Ayarlar → Cihazlar bölümünden de kaybolur ve çalışma alanı kasasından kaldırılır. Günlük, kaynaklar, ayarlar ve imzalama anahtarı kalır ve günlük, çıkış işlemini kaydeder. Çalışma alanı hâlâ ilgili hesaba aittir: yalnızca o hesap tekrar bağlanabilir. Telegram yanıt vermezse, oturum yine de buradan kaldırılır ve panelde bu durum belirtilir; Telegram’da Ayarlar → Cihazlar altından oturumu sonlandırın.

Bir Telethon oturumunu çevrimdışı ortama dönüştürün#

Panel, .session dosyalarını doğrudan içe aktarır. Çevrimdışı olarak bir StringSession dosyasına dönüştürmek için proje klasöründen şu komutu çalıştırın:

.venv\Scripts\python.exe -m tgwitness.sessions account.session --out account.tgwitness-session   # Windows

.venv/bin/python -m tgwitness.sessions account.session --out account.tgwitness-session          # Linux/macOS

Dönüştürücü yalnızca Telethon SQLite dosyalarını okur (en fazla 64 MiB), girdiyi asla değiştirmez, ağ isteği göndermez ve mevcut bir çıktı dosyasının üzerine yazmayı reddeder.

Hesap dosyalarını güvende tutma#

• Her bir .session, TData ZIP, StringSession, Auth Key ve hesap JSON dosyasını bir şifre gibi ele alın. TgWitness, içe aktarılan yetkilendirme bilgilerini şifreli kasasında saklar; daha sonra orijinal dosyaları silebilirsiniz.
• Aynı yetkilendirmeyi aynı anda iki programda çalıştırmayın. Telegram bu yetkilendirmeyi iptal edebilir (AUTH_KEY_DUPLICATED) ve her iki kopya da çalışmaz hale gelir.
• Süresi dolmuş veya iptal edilmiş bir oturum, dönüştürme yoluyla yeniden etkinleştirilemez. Lütfen tekrar oturum açın.

Sorun Giderme#

Ayrıca bakınız: proxy'ler ve şifreleme için bağlantı ve güvenlik, ve oturum açıldıktan sonra yakalanan verilerin nasıl toplandığı.