Koneksi, proxy, dan perlindungan data

Dokumen ini menjelaskan perilaku TgWitness 0.7.0 dan batasannya. Otentikasi, akses sumber, konektivitas jaringan, dan kelengkapan penangkapan merupakan kondisi yang terpisah. Untuk langkah-langkah masuk, format berkas, dan pengelolaan beberapa akun, mulailah dengan bagian akun dan format sesi. Untuk kebijakan peristiwa dan perilaku saat dimulai ulang, lihat cara kerja pengumpulan data.

Metode otentikasi#

API ID dan API hash mengidentifikasi sebuah aplikasi; keduanya tidak menggantikan proses login akun. Keduanya bersifat opsional di TgWitness. Urutan prioritas: pasangan yang dimasukkan melalui formulir, kemudian pasangan dari berkas JSON akun yang diimpor, lalu pasangan yang disimpan di ruang kerja, kemudian kumpulan bawaan berisi 50 pasangan publik, dicoba dalam urutan acak dengan rotasi otomatis saat Telegram menolak salah satunya. Hanya pasangan Telegram Desktop (2040) yang dikirim bersama deskripsi klien Telegram Desktop yang sesuai. Pasangan Anda sendiri dari Alat Pengembangan API di my.telegram.org dapat digunakan dengan semua akun Anda; setiap akun tetap memiliki otorisasi tersendiri.

Telegram memilih pengiriman kode; pengiriman melalui SMS tidak dijamin. Hash API tidak dapat memperbaiki sesi yang dicabut atau menggantikan kata sandi 2FA yang terlupa. TgWitness tidak menyimpan kode login atau kata sandi 2FA Telegram ke disk.

Untuk sumber pribadi, akun tersebut harus sudah memiliki akses. Nama pengguna grup tidak diperlukan. Penggunaan proxy atau impor sesi tidak memberikan hak keanggotaan maupun hak administrator. Keanggotaan saat ini tidak menjamin akses ke riwayat sebelum bergabung.

Impor berkas sesi Telethon#

Telethon SQLite, Pyrogram SQLite, dan Telegram Desktop TData menggunakan format yang berbeda. Panel ini mendeteksi dan mengonversi struktur yang didukung; mengganti nama file bukanlah proses konversi. Pilih satu sesi dan file JSON yang menyertainya di bawah "Files", lalu tekan "Connect account". Maksimal empat file yang cocok dan total 8 MiB diterima. Lihat batasan format untuk detail TData/JSON. Tidak ada pemulihan kode sandi. Masuk melalui telepon/2FA atau QR akan membuat otorisasi terpisah.

Jalur baris perintah opsional khusus Telethon tetap tersedia:

1. Hentikan klien yang menggunakan sesi asli dan buat salinan yang konsisten. Konverter akan menolak berkas dengan WAL/jurnal yang belum selesai. Tutup klien asli dengan benar, bukan dengan menghapus berkas-berkas tersebut untuk menghindari pemeriksaan.
2. Dari lingkungan TgWitness, jalankan:

python -m tgwitness.sessions account.session --out account.tgwitness-session

3. Di bawah Tambahkan akun → File, unggah hasilnya atau tempelkan stringnya, lalu lanjutkan.
4. Periksa ID akun numerik yang ditampilkan, pilih sumber, dan mulailah pemantauan.

Konverter ini membuka SQLite dalam mode baca saja, tidak melakukan pembaruan skema atau permintaan jaringan, dan tidak mencetak sesi tersebut. Konverter ini memeriksa versi skema, tipe tabel, satu baris sesi, IP/port/DC, dan panjang kunci. Masukan CLI dibatasi hingga 64 MiB; teks StringSession dibatasi hingga 4 KiB. Konversi panel mengunggah berkas ke server TgWitness yang terotentikasi, memprosesnya dalam memori, dan mengembalikan kredensial yang dinormalisasi ke browser tersebut tanpa menyimpan berkas asli yang diunggah. Gunakan HTTPS untuk server jarak jauh.

File yang dikonversi merupakan rahasia akses akun yang tidak terenkripsi. Simpanlah di tempat penyimpanan yang terlindungi dan jangan pernah mengunggahnya atau mengirimkannya ke layanan konversi pihak ketiga. TgWitness menyimpan sesi otorisasi di brankas terenkripsinya. Menyalin sesi tidak akan menciptakan otorisasi terpisah: jangan jalankan klien secara bersamaan dengan kunci otorisasi yang dikloning dan mengasumsikan pengiriman pembaruan yang independen.

Konversi mentransfer otorisasi, bukan pesan asli, cache entitas, atau kursor pembaruan yang tahan lama. Konversi ini tidak memastikan pemulihan pembaruan saat proses dimulai ulang.

MTProto, Telethon, dan proxy#

MTProto adalah protokol Telegram. Telethon adalah pustaka klien Python yang digunakan oleh TgWitness. MTProxy adalah proxy transportasi Telegram; SOCKS5 dan HTTP CONNECT menyediakan terowongan umum. Tidak ada yang menggantikan otentikasi akun.

Simpan rute untuk setiap ruang kerja di Akun → Pengaturan → Pengaturan koneksi → Ubah rute koneksi sebelum masuk. Ruang kerja baru secara default menggunakan MTProxy Otomatis · daftar publik dengan perilaku Sembunyikan IP. Ruang kerja yang sudah ada yang secara eksplisit menggunakan Direct tetap mempertahankan mode yang mengizinkannya.

Mode IP#

Rute menentukan koneksi. Mode IP menentukan kapan alamat server dapat terungkap. Kontrol ini tidak menginstal VPN atau mengalihkan seluruh lalu lintas perangkat.

Mode terowongan/VPN mengasumsikan Anda mengelola jaringan tersebut secara terpisah. Tanpa terowongan yang berfungsi, tujuan dapat melihat alamat server itu sendiri. Pilih mode sesuai dengan jaringan Anda yang sebenarnya, bukan berdasarkan nama opsi tersebut.

Pilih jalur#

Rahasia TLS palsu ee ditolak. Normalisasi Telethon 1.45 dapat menghilangkan awalan dan domain, tetapi hal itu tidak mengimplementasikan TLS palsu. Tempelkan tg://proxy?server=…&port=…&secret=… atau https://t.me/proxy?server=…&port=…&secret=… dan pilih "Isi bidang dari tautan". Ini akan memvalidasi dan mengisi kolom tanpa terhubung atau menyimpan; tinjau dan simpan rute secara terpisah. Kolom manual tetap tersedia. Lihat tautan proxy Telegram.

Proksi publik yang disediakan oleh instalasi Anda#

Daftar bawaan ini menggabungkan empat sumber: SoliSpirit/mtproto, zakky8/mtproto-proxy-pro, kort0881/telegram-proxy-collector dan 3yed-61/MTP-Collector. Snapshot yang disertakan berisi data titik akhir, atribusi sumber, dan tanggal unduhan. Kehadiran penyedia dalam daftar ini bukanlah bukti bahwa proxy tersebut berfungsi atau menyalurkan setiap pembaruan Telegram.

MTProxy otomatis memeriksa konektivitas transportasi Telegram, mempertahankan proxy yang berfungsi dan beralih ke proxy lain saat terjadi kegagalan. Ruang kerja lebih memilih proxy yang berbeda jika tersedia cukup entri yang berfungsi; alamat keluar yang unik tidak dijamin. Proksi yang gagal akan beristirahat sebelum upaya berikutnya. Jika tidak ada yang berfungsi, mode IP menentukan apakah pengumpulan harus ditunda atau dapat menggunakan koneksi langsung. Mengganti proksi tidak mengubah akun atau menghapus jurnalnya. Pilihan dan perubahan rute dicatat dalam jurnal yang ditandatangani.

Selama rute otomatis aktif, daftar diperbarui setiap jam dan pemeriksaan pengiriman dijalankan setiap sepuluh menit secara default. Interval-interval ini dapat dikonfigurasi. Permintaan pembaruan daftar publik memicu pembaruan; hanya melihat daftar saja tidak mengubah rute manual yang telah disimpan.

Setiap respons umpan dibatasi hingga 1 MiB dengan batas waktu permintaan delapan detik dan batas waktu unduhan keseluruhan 20 detik; pengalihan ditolak. Hingga 64 entri yang kompatibel per sumber disimpan dan didedupikasi. Parser menerima rahasia heksadesimal dan base64url yang didukung serta umpan JSON. TLS palsu ee, tautan tidak valid, literal IP pribadi/tercadangkan, dan nama host lokal akan dilewati. Nama host diselesaikan dan diperiksa sebelum digunakan, dan IP yang dipilih akan ditetapkan untuk koneksi tersebut. Akuisisi ulang otomatis akan menyelesaikan nama host kembali; terapkan kembali entri manual untuk menyelesaikannya lagi.

Respons feed yang gagal, kosong, atau tidak kompatibel akan mempertahankan snapshot sumber sebelumnya. Pembaruan bersifat atomik, diserialisasikan, dan dibatasi satu upaya per menit per ruang kerja. Uji koneksi yang berhasil hanya memastikan konektivitas, bukan anonimitas atau kelengkapan penangkapan data.

Lalu lintas Telegram dan permintaan HTTPS menggunakan rute yang berbeda. Unduhan daftar menggunakan koneksi HTTPS terpisah dan rute permintaan eksternal yang disediakan. `TGWITNESS_PROXY_FEED_PROXY` secara eksplisit mengganti rute tersebut dengan proxy HTTP/SOCKS5; kedua varian pengumpul Compose meneruskannya. Kolam latar belakang mengikuti ruang kerja utama. Tidak ada sesi Telegram, kredensial API, token panel, atau token bot yang dikirim ke penyedia umpan. Nama penyedia, tanggal snapshot, dan rute unduhan tercantum di bagian “Dari mana daftar ini berasal”.

MTProxy hanya mengangkut lalu lintas Telegram. Operasi HTTP Workspace seperti cap waktu, pemberitahuan, salinan di luar situs, dan pemeriksaan sumber menggunakan proxy SOCKS5/HTTP terpisah saat dikonfigurasi, kemudian rute SOCKS5/HTTP akun tersebut. Tanpa keduanya, Hide IP akan menolak permintaan; mode lainnya mengizinkan Direct. Permintaan eksternal dapat dinonaktifkan. Proksi unduhan umpan yang dikonfigurasi secara eksplisit tetap menjadi pengaturan khusus operator. Layanan saksi independen mempertahankan rutenya sendiri.

Parameter kolam otomatis

Di bawah **Parameter → MTProxy Otomatis**, konfigurasikan ambang batas kegagalan, waktu tunggu, rotasi terjadwal, pembagian proxy, dan penundaan fallback yang diizinkan. | Kontrol | Default | | --- | --- | | Terputus sebelum penggantian | 3 kali dalam 10 menit | | Jumlah proxy yang dicoba per upaya koneksi | 3 | | Waktu istirahat pertama / maksimum setelah kegagalan | 10 menit / 6 jam | | Rotasi terjadwal | Dinonaktifkan; aktifkan saat kegagalan | | Akun per proxy | 0: utamakan entri terpisah, bagikan jika diperlukan. Atur ke 1 untuk menunggu entri eksklusif. | | Penundaan sebelum fallback Direct diizinkan | 10 menit; Hide IP tetap menolak Direct | | Pembaruan feed / pemeriksaan transportasi | 60 / 10 menit; nilai ruang kerja utama berlaku untuk kumpulan bersama | Proksi yang berbeda tidak menjamin alamat keluar yang berbeda. Pengaturan ini tidak menggantikan batasan Telegram atau menjamin anonimitas.

Untuk mengganti daftar publik dengan katalog operator Anda sendiri, konfigurasikan pengaturan penggantian di bawah ini. Pengaturan ini menonaktifkan langganan eksternal sepenuhnya, termasuk ketika array proxies-nya kosong.

Salin katalog kosong ke proxy-config/proxies.json dan tambahkan titik akhir publik yang telah Anda terapkan:

{"format": "tgwitness-proxy-catalog-v1", "proxies": [
  {"id": "project-eu", "label": "Project EU",
   "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}

Nilai-nilai contoh harus diganti. Maksimal 32 entri berbeda dapat diterima. Daftar yang terotentikasi mengembalikan label/host/port tanpa rahasia bersama; memilih salah satunya akan menyimpan kredensialnya ke dalam brankas ruang kerja. Ketersediaan belum diuji hingga dilakukan uji transportasi secara eksplisit. Katalog yang tidak valid memungkinkan konfigurasi manual.

Peluncuran lokal: atur TGWITNESS_PROXY_CATALOG ke jalur JSON lokal. Docker:

docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build

Overlay dipasang sebagai proxy-config read-only; berkas harus dapat dibaca oleh UID kontainer 10001. Direktori tersebut dikecualikan dari Git, konteks build Docker, dan arsip sumber. Katalog ini mengonfigurasi akun-akun pengumpul; bot saksi menggunakan rute HTTP/SOCKS5-nya sendiri, bukan MTProxy.

Pengalihan langsung diatur oleh mode IP di atas. Jeda pengamatan sebelum mengubah rute. Penyimpanan akan memutuskan koneksi klien lama dan membatalkan proses login yang belum selesai; klien baru akan menggunakan rute yang disimpan. Pengikatan jurnal/sesi akun tetap berlaku. Pengaturan akan menggantikan rute sebelumnya: masukkan kembali kredensial proxy saat mengeditnya.

Kredensial dienkripsi menggunakan network.enc. API tidak mengembalikan nama pengguna, kata sandi, atau rahasia. Catatan yang ditandatangani berisi jenis rute dan apakah kredensial terdapat di dalamnya, tanpa menyertakan titik akhir dan rahasia. Operator dapat melihat titik akhir di panel. Bidang rahasia akan dihapus setelah menyimpan, mengunci, atau beralih antar ruang kerja.

Uji koneksi Telegram, juga tersedia sebelum masuk, membuka dan menutup koneksi Telegram sementara yang tidak sah melalui rute tersebut. Fitur ini tidak menghubungi situs web pemeriksaan IP. Keberhasilan uji ini menunjukkan terjalinnya konektivitas transportasi, bukan akses ke grup, pengiriman yang lengkap, atau anonimitas.

Proksi ini berlaku untuk koneksi klien Telegram, termasuk unduhan media dari server distribusi (DC) Telegram. Alat-alat seperti browser, pip, SSH, dan TSA yang dijalankan secara manual memiliki rute terpisah. Nama host proksi dapat diresolusi secara lokal. rdns memengaruhi nama host tujuan; Telegram sering kali menyediakan alamat IP numerik dari server distribusi (DC).

SOCKS5 dan HTTP CONNECT biasa tidak mengenkripsi kredensial proxy atau terowongan klien-ke-proxy itu sendiri. MTProto secara terpisah melindungi lalu lintas Telegram. Gunakan saluran aman yang sesuai ke proxy pada jaringan yang tidak tepercaya. Grup pribadi adalah obrolan cloud; MTProto tidak mengubahnya menjadi Obrolan Rahasia yang dienkripsi ujung-ke-ujung.

Enkripsi dan tanda tangan#

Perlindungan penyimpanan di Akun menampilkan status-status ini. Token panel adalah kunci akses, bukan kata sandi enkripsi. Token ini memberikan akses administrator; token yang diterbitkan dapat dibatasi cakupannya ke akun dan obrolan. Ruang kerja berbagi proses host dan bukan penyewa yang terisolasi.

Demo sintetis yang dimulai secara eksplisit dan terisolasi dapat terbuka secara otomatis melalui koneksi loopback langsung. Fitur ini menggunakan kemampuan masa hidup proses terpisah; fitur ini tidak mengungkapkan token panel yang dikonfigurasi maupun memberikan akses ke ruang kerja yang sebenarnya. Permintaan jarak jauh, melalui proxy, atau lintas asal tidak dapat memperoleh/menggunakan kemampuan masuk otomatis ini. Kemudahan ini tidak menghilangkan batasan otentikasi untuk data akun yang sebenarnya.

BitLocker, LUKS, FileVault, atau volume terenkripsi yang dikelola dapat melindungi penyimpanan sesuai dengan model ancaman masing-masing. Seorang administrator pada mesin yang sedang berjalan dan tidak terkunci masih dapat membaca data. Sertakan SQLite WAL/SHM, media, ekspor sementara, swap, cadangan, dan unduhan browser dalam perencanaan penyimpanan. Volume Docker tidak otomatis terenkripsi hanya karena statusnya sebagai volume. TgWitness tidak mengimplementasikan SQLCipher atau enkripsi objek.

Kunci utama eksternal#

Untuk instalasi baru, letakkan kunci utama di luar direktori data. Hal ini tidak secara otomatis memigrasikan brankas kunci lokal yang sudah ada. Siapkan direktori kunci yang hanya dapat diakses oleh identitas layanan, lalu jalankan:

python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key
export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key
python -m tgwitness --data-dir /private/observations/new-case

PowerShell, menggunakan lingkungan proyek yang telah diinstal:

python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key
$env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key'
python -m tgwitness --data-dir E:\PrivateData\new-case

Di Docker, pasang berkas tersebut sebagai read-only di luar /data, misalnya di /run/secrets/tgwitness-master.key, dan atur variabel lingkungan ke jalur tersebut. UID layanan harus memiliki izin baca terhadap berkas tersebut. Sampaikan jalurnya, bukan byte kunci, melalui berkas lingkungan/konfigurasi.

Setiap ruang kerja menerima salt publik acak dan kunci Fernet-nya sendiri yang diturunkan melalui HKDF-SHA256. vault.external.json menyimpan metadata derivasi, bukan kunci utama. Kunci yang hilang atau salah akan menyebabkan kegagalan saat memulai tanpa menggantinya secara diam-diam. Simpan baik metadata salt maupun kunci utama untuk pemulihan.

Semua ruang kerja berasal dari kunci utama yang sama; jika kunci tersebut bocor, hal itu akan memengaruhi seluruh instalasi. Proses yang sedang berjalan dapat mendekripsi rahasia. Ini bukanlah HSM atau KDF kata sandi. Kata sandi buatan manusia yang sembarangan tidak diterima sebagai pengganti kunci acak.

Simpan kunci yang ada untuk instalasi yang sudah ada hingga migrasi yang disengaja dilaksanakan dan diverifikasi. Menghapus vault.key atau mengganti kunci utama dapat menghancurkan akses ke sesi/kunci penandatanganan. Simpan cadangan terenkripsi dan kunci secara terpisah, serta uji pemulihan di instance yang terisolasi.

Sumber dan ruang lingkup verifikasi#

Ditinjau pada 26 Oktober 2026:

• https://core.telegram.org/api/auth
• https://core.telegram.org/api/obtaining_api_id
• https://docs.telethon.dev/en/stable/basic/signing-in.html
• https://docs.telethon.dev/en/stable/concepts/sessions.html
• https://core.telegram.org/mtproto/mtproto-transports
• https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/storage/storage_account.cpp
• Telethon 1.45.0: SQLiteSession, StringSession, Connection._proxy_connect, TcpMTProxy.normalize_secret, dan metode pengunduhan.

Pengujian lokal mencakup fixture loopback SOCKS5/HTTP CONNECT, sesi SQLite sintetis, isolasi rute, pengecualian rahasia, dan penolakan kunci yang hilang. Pengujian ini tidak memastikan interoperabilitas Telegram/proksi yang sebenarnya atau perilaku MTProxy secara langsung. Lihat VERIFICATION.md dan LIVE_ACCEPTANCE.md.