Rujukan / Keselamatan & projek
Telegram · Keselamatan dan pengendalian data
Model ancaman, model capaian, rahsia semasa rehat, pendedahan rangkaian, import sesi dan cara melaporkan kerentanan.
TgWitness / Dokumentasi · Penyebaran dan pemulihan
Halaman ini menerangkan akses, penyimpanan dan perlindungan rangkaian dalam ruang kerja tempatan atau pelayan. Untuk pengumpulan pada pelari GitHub atau dalam VM sulit Intel TDX, lihat mod pengesahan, yang menambah semakan persekitaran pengumpulan. Sambungan akaun, pemberitahuan, cap masa, salinan luar tapak dan saksi mempunyai tetapan penghalaan mereka sendiri.
| Kawasan | Ringkasnya |
|---|---|
| Akses | Kunci pentadbir serta akses terhad ke akaun/perbualan, tujuh kebenaran dan sesi yang boleh ditarik balik; localhost secara lalai |
| Rahsia yang disimpan | Sesi, pasangan API, kunci penandatanganan dan tetapan proksi disulitkan dengan Fernet |
| Mesej dan media | Fail dalam ruang kerja, dilindungi oleh penyulitan cakera atau volum dan kebenaran fail hos |
| Integriti | Rantaian hash SHA-256 dan tandatangan Ed25519 pada setiap rekod |
| Masa luaran | RFC 3161 dan resit OpenTimestamps, kiriman saksi bertarikh oleh pengesahan Telegram dan GitHub; checkpoint yang disimpan, rekod saksi dan pengukuran Intel TDX adalah semakan sokongan. Pengesah melaporkan syarat bukti yang dipenuhinya. |
Untuk laporan kerentanan, lihat dasar keselamatan.
Pada halaman ini
Model akses#
Token panel utama memberikan kawalan penuh. Orang lain boleh menerima akses terhad mereka sendiri: ruang kerja dan sembang terpilih, kebenaran, tamat tempoh, sekatan IP, had log masuk dan sesi yang boleh ditarik balik. Akses terhad sembang tidak boleh melakukan operasi seluruh ruang kerja walaupun kebenaran mereka telah dicentang. Setiap ruang kerja mempunyai jurnal, peti besi dan kunci tandatangan sendiri dalam satu proses; pemisahan antara orang pada hos datang daripada akaun sistem pengendalian.
Panel mendengar pada localhost secara lalai. Log masuk pelayar menukar token akses untuk kelayakan sesi; pelayar menghantarnya sebagai token pembawa. Ia disimpan dalam sessionStorage dan bukannya kuki pengesahan. Kunci/keluar log membersihkan sesi pelayar. Menutup pelayar atau menamatkan sesi tidak menghentikan pengumpulan.
Token yang dikeluarkan dan kelayakan sesi disimpan sebagai hash dalam peti besi yang disulitkan. Pencabutan menamatkan sesi yang berkaitan; perubahan kebenaran menjejaskan permintaan seterusnya. Fail yang dimuat turun tidak dapat ditarik balik. Pentadbir juga boleh mengehadkan sesi pelayar mereka sendiri, tetapi skrip yang menggunakan token panel utama secara langsung mengekalkan akses penuh dan memintas had sesi pelayar tersebut.
Pengesahan gagal dihadkan kadar mengikut alamat klien. Sekatan IP menggunakan alamat yang dilihat oleh aplikasi; semak tingkah laku proksi songsang sebelum bergantung padanya. Kredensial Witness kekal berasingan sebagai kredensial titik pemeriksaan/kesihatan baca sahaja.
Akses demo#
/api/demo-access adalah bootstrap yang sengaja tidak diautentikasi untuk demo sintetik yang dimulakan secara eksplisit dan terasing. Ia mengeluarkan keupayaan tempoh-proses yang berasingan, tidak pernah token panel sebenar atau penimpaan TGWITNESS_TOKEN. Penerbitan dan penggunaan memerlukan rakan sebaya loopback dan Host, tiada pengepala yang diteruskan, dan tiada permintaan rentas asal. Ruang kerja tambahan atau sesi yang dibenarkan menyahaktifkan laluan ini. Ruang kerja langsung tidak pernah mengeluarkan keupayaan ini. Demo ini tidak boleh menghubungkan akaun atau menukar tetapan pengumpulan.
Kandungan panel dan eksport#
Panel ini tidak menggunakan fon luaran, analitik, sumber CDN, atau media jauh yang disemat. Teks yang diperoleh daripada Telegram disisipkan sebagai teks, bukan HTML. Lampiran yang dimuat turun dihidangkan sebagai lampiran binari. Eksport JSONL mengekalkan rentetan asal; HTML melarikan mereka; sel CSV yang boleh menjadi formula diberi awalan tanda petik.
Eksport mengecualikan rahsia pengesahan dan penandatanganan, tetapi sengaja mengandungi metadata sumber yang dikumpul, pengecam, dan mungkin kandungan peribadi atau sensitif. Hash akses Telegram dan rujukan fail boleh muncul dalam metadata sumber mentah.
Rahsia yang disimpan#
Kredensial API Telegram, kunci sesi dan kunci penandatanganan disulitkan dengan Fernet. Untuk mesej dan media tempatan, penyulitan disediakan oleh cakera atau volum hos; ruang kerja menyimpan fail biasa. Eksport boleh menggunakan ZIP AES-256 yang dilindungi kata laluan, dan salinan luar tapak menggunakan AES-256-GCM.
Kunci peti keselamatan secara lalai disimpan di direktori data terlindung. Gunakan fail kunci induk luaran di bawah untuk menyimpannya secara berasingan. Pada Unix, fail kunci peribadi baharu menggunakan mod 0600 dan direktori data baharu menggunakan 0700; pada Windows, tetapkan ACL direktori untuk akaun perkhidmatan dan pentadbir yang dibenarkan. Kebenaran direktori sedia ada dikekalkan.
Kunci induk luaran#
Untuk direktori data baharu, TGWITNESS_VAULT_KEY_FILE boleh membekalkan kunci induk rawak luaran. HKDF-SHA256 dan garam rawak berasingan menghasilkan kunci Fernet yang berbeza untuk setiap ruang kerja. vault.external.json mesti disimpan untuk pemulihan. Kunci induk yang hilang atau salah akan menyebabkan kegagalan dalam mod tertutup. Vault tempatan sedia ada tidak dipindahkan secara senyap. Panel memaparkan mod penyimpanan kunci yang dipilih. Penyulitan cakera melindungi fail mesej dan media tempatan dalam kedua-dua mod; lihat sambungan dan perlindungan data untuk butiran tetapan.
Proksi dan laluan rangkaian#
Konfigurasi proksi disulitkan dalam peti besi. Kata laluan dan rahsia MTProxy tidak dikembalikan oleh API atau ditulis ke dalam rekod bukti. Setiap ruang kerja memilih laluan Telegram dan mod IP masing-masing.
Sembunyikan alamat menolak fallback Telegram langsung dan memerlukan proksi untuk permintaan HTTP luaran. Mod fallback yang dipilih secara eksplisit membenarkan akses Telegram langsung selepas kelewatannya; mod terowong/VPN membenarkan laluan langsung. Memilih mod terowong tidak memasang atau mengesahkan VPN. Tetapan ini tidak mengawal semua trafik mesin, pelayar, pengurus pakej atau penyelesaian DNS hos proksi tempatan.
MTProxy hanya membawa trafik Telegram. Permintaan luaran boleh menggunakan proksi SOCKS5/HTTP berasingan, laluan SOCKS5/HTTP ruang kerja, atau laluan terus yang dibenarkan; ia juga boleh dilumpuhkan. Saksi bebas mempunyai tetapan pengangkutan tersendiri. Pengesahan CONNECT SOCKS5/HTTP biasa tidak disulitkan oleh protokol proksi tersebut itu sendiri. Rahsia MTProxy TLS palsu masih tidak disokong.
Log masuk dan import sesi#
Fail .tgwitness-session yang diubah suai mengandungi rahsia kebenaran teks biasa sehingga dimuat dan disimpan dalam peti besi. CLI luar talian menerima skema Telethon yang telah disemak. Panel import juga menerima Pyrogram SQLite, TData ZIP akaun tunggal moden, dan input JSON yang didokumenkan. Ia disahkan, terhad kepada empat fail / 8 MiB, dan memproses muat naik dalam memori tanpa mengekstrak arkib atau menyimpan fail asal. Butiran pengesahan yang telah dinormalisasi hanya dikembalikan kepada pelayar yang disahkan yang membuat permintaan; ia disimpan dalam peti besi yang disulitkan selepas pengesahan Telegram berjaya. Lindungi fail asal dan fail yang telah ditukar, dan elakkan klien serentak menyalin kebenaran.
Pemprosesan TData mengesahkan checksum bekas, has ratah decryption tempatan, dan panjang struktur. Kod laluan tempatan Desktop yang dibekalkan digunakan secara sementara dan tidak disimpan. Parser terhad menyokong format Desktop yang disahkannya dan menolak yang lain. Imej QR dijana secara tempatan, mengandungi token log masuk Telegram yang bersifat sementara, dan tidak pernah dihantar ke perkhidmatan paparan luaran. Kunci, pertukaran ruang kerja, log masuk baru, dan perubahan laluan membatalkan percubaan QR yang sedang menunggu. Memuat semula/menutup tab mungkin menyebabkan percubaan masih menunggu sehingga tamat tempoh. Log masuk QR yang berjaya masih menguatkuasakan pengikatan akaun. Badan API biasa kekal terhad kepada 16 KiB; laluan import yang disahkan menerima sehingga 12 MiB JSON yang disulitkan, dengan menguatkuasakan had fail terdekod yang lebih kecil secara berasingan.
Kod log masuk dan kata laluan pengesahan dua langkah Telegram tidak disimpan. Status nombor telefon/kod-hash disimpan dalam memori semasa kebenaran. Sesi Telegram memberikan akses akaun; jangan sekali-kali memuat naik direktori data, sesi, token, kunci peti, atau kunci tandatangan peribadi ke GitHub.
Logs dan penghantaran#
Tindak balas pengesahan API lalai digantikan supaya ia tidak memaparkan semula nilai kelayakan. Log akses aplikasi dilumpuhkan. Jangan tetapkan proksi songsang untuk melogkan penanda aras Kebenaran atau badan permintaan. Panel mendengar di localhost; akses jauh melalui terowong SSH yang disediakan, Cloudflare Tunnel atau Caddy HTTPS, jadi token dan rahsia log masuk dihantar melalui SSH atau TLS.
Integriti dan masa luaran#
Semakan pengesahan memeriksa tandatangan rekod, rantaian hash, lampiran dan manifes eksport
menentang kunci pengumpul. Tandatangan yang sah menunjukkan bahawa bait tidak berubah sejak
ia ditandatangani. Setiap ruang kerja mencipta kunci penandatanganannya pada permulaan pertama dan memaparkan jejak jarinya dalam panel dan dalam setiap eksport. Pengendali memberikan jejak jari itu kepada
penerima melalui saluran berasingan, dan --fingerprint menetapkan kunci.
Rekod yang diubah, disisipkan atau dialih keluar memecahkan rantaian hash atau tandatangan, dan pengesah melaporkannya. Cap masa luaran dan saksi juga menetapkan jurnal di luar ruang kerja. Pencetus pada jadual jurnal hanya menghentikan aplikasi daripada menulis ke atas atau memadam rekod secara tidak sengaja. TGWITNESS_VAULT_KEY_FILE menjaga kunci peti simpanan supaya tidak termasuk dalam salinan direktori data.
Resit RFC 3161 dan OpenTimestamps, serta kiriman saksi yang tarikhnya dibaca oleh pengesah daripada Telegram, mengikat awalan jurnal yang mereka liputi kepada masa yang ditetapkan oleh pihak ketiga. Satu pusingan drand yang ditulis dalam jurnal menunjukkan bahawa rekod-rekod selepasnya dibuat tidak lebih awal daripada pusingan itu diterbitkan. Satu pengesahan GitHub yang diperiksa juga membawa masa teresahkan tandatanganannya, yang mengikat keseluruhan arkib kepada masa luaran. Satu checkpoint ditandatangani dengan kunci pengumpul dan mengikat rekod-rekod sehingga ke titik itu dari saat penerima memperolehnya melalui saluran lain. Seorang saksi menunjukkan bahawa kunci kedua mengekalkan kepala jurnal; rekod kawalan kunci pemegang menunjukkan siapa yang memegang kunci itu. Kedua-duanya adalah pemeriksaan sokongan; minimumnya ialah masa pihak ketiga. GitHub Actions menangkap atau penyebaran Intel TDX menambah asal-usul aliran kerja atau pengukuran perkakasan persekitaran pengumpulan.
Setiap jawapan pengesahan menyenaraikan syarat bukti beserta cara setiap satu disemak, dikelompokkan mengikut peranan mereka dalam minimum:
| Peranan | Kondisi |
|---|---|
| Diperlukan | Integriti; kunci penandatangan dipaku dengan --fingerprint; masa luaran yang merangkumi rekod terakhir (resit RFC 3161 diperiksa dengan --tsa-ca, resit OpenTimestamps disahkan dengan --check-bitcoin, pos saksi dibaca dari t.me dengan --channel, meterai Bitcoin saksi atau pengesahan GitHub diperiksa) |
| Menyokong, bukan sebahagian daripada minimum | Saksi dengan kuncinya sendiri; checkpoint yang disimpan; pelaksanaan koleksi yang disahkan |
Syarat minimum bagi bukti ialah ketiga-tiga syarat yang diperlukan merangkumi rekod terakhir yang dieksport; pelaksanaan pengesahan dan pengakuan koleksi yang disahkan menambah attested profil.
Baris terakhir menyatakan keputusan, dan jawapannya menamakan pilihan yang akan memenuhi
syarat yang hilang. Tanpa --fingerprint baris terakhir bermula dengan
EVIDENCE: minimum not met · missing: confirmed signer key. Apabila cap masa yang disahkan hanya merangkumi rekod-rekod terdahulu, jawapan menyatakan rekod sehingga mana syarat minimum itu terpakai. --require evidence atau --require attested keluar dengan kod 2 apabila profil tidak dicapai untuk keseluruhan eksport, dan pemeriksaan yang diminta pada baris arahan yang tidak dapat dijalankan dilaporkan sebagai tidak dilakukan dengan kod yang sama. Setiap laporan membawa syarat yang sama dengan status mereka dalam salinan tersebut dan arahan yang memeriksanya. Tahap jaminan dan --strict tetap tersedia; format bukti menyenaraikan semakan untuk setiap mod pengumpulan.
Jika anda mengesyaki terdapat masalah#
Pelihara direktori data asal dan gunakan salinan berasingan untuk analisis. Laporkan versi terjejas, operasi dan langkah yang boleh diulang melalui dasar keselamatan, sambil mengekalkan data akaun dan maklumat log masuk secara peribadi.