Referensi / Keamanan & proyek
Telegram · Keamanan dan penanganan data
Model ancaman, model akses, data rahasia yang disimpan, paparan jaringan, impor sesi, dan cara melaporkan kerentanan.
TgWitness / Dokumentasi · Penerapan dan pemulihan
Halaman ini menjelaskan akses, penyimpanan, dan perlindungan jaringan di ruang kerja lokal atau server. Untuk pengumpulan data di GitHub Runner atau di VM rahasia Intel TDX, lihat mode verifikasi, yang menambahkan pemeriksaan terhadap lingkungan pengumpulan data. Koneksi akun, pemberitahuan, cap waktu, salinan di luar lokasi, dan saksi memiliki pengaturan perutean tersendiri.
| Area | Singkatnya |
|---|---|
| Akses | Kunci administrator ditambah akses terbatas ke akun/obrolan, tujuh izin, dan sesi yang dapat dicabut; defaultnya menggunakan localhost |
| Rahasia yang tersimpan | Pengaturan sesi, pasangan API, kunci penandatanganan, dan proxy dienkripsi menggunakan Fernet |
| Pesan dan media | Berkas-berkas di ruang kerja, yang dilindungi oleh enkripsi disk atau volume serta izin berkas dari host |
| Integritas | Rantai hash SHA-256 dan tanda tangan Ed25519 pada setiap catatan |
| Waktu eksternal | Tanda terima RFC 3161 dan OpenTimestamps, posting saksi yang diberi tanggal oleh Telegram dan pengesahan GitHub; titik pemeriksaan yang disimpan, catatan saksi, dan pengukuran Intel TDX merupakan pemeriksaan pendukung. Verifikator melaporkan kondisi bukti mana yang dipenuhi |
Untuk laporan kerentanan, lihat kebijakan keamanan.
Di halaman ini
Model akses#
Token panel utama memberikan kendali penuh. Orang lain dapat menerima akses terbatas mereka sendiri: ruang kerja dan obrolan yang dipilih, izin, masa berlaku, pembatasan IP, batas masuk, dan sesi yang dapat dicabut. Akses yang dibatasi pada obrolan tidak dapat melakukan operasi di seluruh ruang kerja meskipun izinnya telah dicentang. Setiap ruang kerja memiliki jurnal, brankas, dan kunci penandatanganan tersendiri dalam satu proses; pemisahan antar pengguna di host dilakukan melalui akun sistem operasi.
Panel ini secara default mendengarkan di localhost. Proses masuk melalui browser menukar token akses dengan kredensial sesi; browser mengirimkannya sebagai token bearer. Token ini disimpan di sessionStorage, bukan di cookie otentikasi. Mengunci/keluar akan menghapus sesi browser. Menutup browser atau mengakhiri sesi tidak menghentikan proses pengumpulan data.
Token yang diterbitkan dan kredensial sesi disimpan sebagai hash di brankas terenkripsi. Pencabutan akan mengakhiri sesi yang terkait; perubahan izin akan memengaruhi permintaan berikutnya. File yang telah diunduh tidak dapat ditarik kembali. Administrator juga dapat membatasi sesi browser mereka sendiri, tetapi skrip yang menggunakan token panel utama secara langsung tetap memiliki akses penuh dan melewati batasan sesi browser tersebut.
Kegagalan otentikasi dibatasi berdasarkan alamat klien. Pembatasan IP menggunakan alamat yang terlihat oleh aplikasi; periksa perilaku reverse-proxy sebelum mengandalkannya. Kredensial Witness tetap terpisah sebagai kredensial titik pemeriksaan/kesehatan yang hanya dapat dibaca.
Akses demo#
/api/demo-access adalah bootstrap yang sengaja tidak diautentikasi untuk
demo sintetis yang dimulai secara eksplisit dan terisolasi. Ini mengeluarkan kemampuan yang berlaku selama masa hidup proses,
bukan token panel asli atau penggantian TGWITNESS_TOKEN. Penerbitan dan penggunaannya memerlukan
peer loopback dan Host, tanpa header yang diteruskan, serta tanpa permintaan lintas asal. Ruang kerja tambahan
atau sesi yang diotorisasi akan menonaktifkan jalur ini. Ruang kerja aktif tidak pernah menerbitkan
kemampuan tersebut. Demo ini tidak dapat menghubungkan akun atau mengubah pengaturan pengumpulan data.
Konten panel dan ekspor#
Panel ini tidak menggunakan font eksternal, analitik, sumber daya CDN, atau media jarak jauh yang disematkan. Teks yang bersumber dari Telegram disisipkan sebagai teks, bukan HTML. Lampiran yang diunduh disajikan sebagai lampiran biner. Ekspor JSONL mempertahankan string asli; HTML melakukan escape terhadapnya; sel CSV yang berpotensi menjadi rumus diberi awalan tanda apostrof.
Ekspor tidak menyertakan rahasia otentikasi dan penandatanganan, tetapi secara sengaja berisi metadata sumber yang dikumpulkan, pengenal, dan kemungkinan konten pribadi atau sensitif. Hash akses Telegram dan referensi berkas dapat muncul dalam metadata sumber mentah.
Rahasia yang tersimpan#
Kredensial API Telegram, sesi, dan kunci penandatanganan dienkripsi menggunakan Fernet. Untuk pesan dan media lokal, enkripsi disediakan oleh disk atau volume host; ruang kerja menyimpan berkas biasa. Ekspor dapat menggunakan ZIP AES-256 yang dilindungi kata sandi, dan salinan di luar lokasi menggunakan AES-256-GCM.
Kunci brankas secara default berada di direktori data yang dilindungi. Gunakan berkas kunci utama eksternal di bawah ini untuk menyimpannya secara terpisah. Pada sistem Unix, berkas kunci pribadi baru menggunakan mode 0600 dan direktori data baru menggunakan mode 0700; pada Windows, atur ACL direktori untuk akun layanan dan administrator yang berwenang. Izin direktori yang sudah ada tetap dipertahankan.
Kunci utama eksternal#
Untuk direktori data baru, TGWITNESS_VAULT_KEY_FILE dapat menyediakan kunci utama acak eksternal. HKDF-SHA256 dan garam acak terpisah menghasilkan kunci Fernet yang berbeda untuk setiap ruang kerja. vault.external.json harus dipertahankan untuk pemulihan. Kunci utama yang hilang atau salah akan menyebabkan kegagalan. Brankas lokal yang sudah ada tidak akan dimigrasikan secara diam-diam. Panel menampilkan mode penyimpanan kunci yang dipilih. Enkripsi disk melindungi berkas pesan dan media lokal di kedua mode; lihat koneksi dan perlindungan data untuk detail pengaturan.
Proksi dan rute jaringan#
Konfigurasi proxy dienkripsi di dalam vault. Kata sandi dan rahasia MTProxy tidak dikembalikan oleh API atau ditulis ke dalam catatan bukti. Setiap ruang kerja memilih rute Telegram dan mode IP-nya sendiri.
Menyembunyikan alamat akan menonaktifkan fallback Telegram langsung dan memerlukan proxy untuk permintaan HTTP eksternal. Mode fallback yang dipilih secara eksplisit memungkinkan akses langsung ke Telegram setelah penundaan; mode terowongan/VPN memungkinkan rute langsung. Memilih mode terowongan tidak menginstal atau memverifikasi VPN. Pengaturan ini tidak mengontrol seluruh lalu lintas mesin, peramban, pengelola paket, atau resolusi DNS host proxy lokal.
MTProxy hanya mengangkut lalu lintas Telegram. Permintaan eksternal dapat menggunakan proksi SOCKS5/HTTP terpisah, rute SOCKS5/HTTP ruang kerja, atau rute langsung yang diizinkan; permintaan tersebut juga dapat dinonaktifkan. Saksi independen memiliki pengaturan transportasi tersendiri. Otentikasi SOCKS5/HTTP CONNECT biasa tidak dienkripsi oleh protokol proxy tersebut sendiri. Rahasia TLS MTProxy palsu tetap tidak didukung.
Masuk dan impor sesi#
File .tgwitness-session yang telah dikonversi berisi rahasia otorisasi dalam bentuk teks biasa hingga dimuat dan disimpan di vault. CLI offline menerima skema Telethon yang telah ditinjau. Impor panel juga menerima Pyrogram SQLite, TData ZIP akun tunggal modern, dan masukan JSON yang terdokumentasi. Fitur ini diotentikasi, dibatasi hingga empat berkas / 8 MiB, dan memproses unggahan di memori tanpa mengekstrak arsip atau menyimpan berkas asli. Kredensial yang dinormalisasi hanya dikembalikan ke browser terotentikasi yang meminta; kredensial tersebut disimpan di brankas terenkripsi setelah otorisasi Telegram berhasil. Lindungi berkas asli dan berkas yang telah dikonversi, serta hindari klien bersamaan yang mengkloning otorisasi.
Pemrosesan TData memverifikasi checksum wadah, hash dekripsi lokal, dan panjang struktur. Kode sandi lokal Desktop yang diberikan digunakan sementara dan tidak disimpan. Parser terbatas mendukung format Desktop yang divalidasi dan menolak yang lain. Gambar QR dihasilkan secara lokal, berisi token login Telegram yang berumur pendek, dan tidak pernah dikirim ke layanan rendering eksternal. Penguncian, peralihan ruang kerja, login baru, dan perubahan rute membatalkan upaya QR yang tertunda. Memuat ulang/menutup tab dapat membuat upaya tetap tertunda hingga kedaluwarsa. Login QR yang berhasil tetap memberlakukan pengikatan akun. Isi API biasa tetap dibatasi hingga 16 KiB; rute impor terotentikasi menerima hingga 12 MiB JSON yang dikodekan, dengan memberlakukan batas file terdekodasi yang lebih kecil secara terpisah.
Kode login dan kata sandi verifikasi dua langkah Telegram tidak disimpan secara permanen. Status nomor telepon/hash kode disimpan dalam memori selama proses otorisasi. Sesi Telegram memberikan akses ke akun; jangan pernah mengunggah direktori data, sesi, token, kunci vault, atau kunci penandatanganan pribadi ke GitHub.
Log dan pengiriman#
Respons validasi API default diganti agar tidak menampilkan nilai kredensial. Pencatatan akses aplikasi dinonaktifkan. Jangan konfigurasikan proxy terbalik untuk mencatat header Otorisasi atau isi permintaan. Panel mendengarkan di localhost; akses jarak jauh dilakukan melalui terowongan SSH yang disediakan, Cloudflare Tunnel, atau Caddy HTTPS, sehingga token dan rahasia login dikirim melalui SSH atau TLS.
Integritas dan waktu eksternal#
Proses verifikasi memeriksa tanda tangan catatan, rantai hash, lampiran, dan manifes ekspor
dengan membandingkannya terhadap kunci pengumpul. Tanda tangan yang valid menunjukkan bahwa byte-byte tersebut tidak berubah sejak
ditandatangani. Setiap ruang kerja membuat kunci penandatanganannya sendiri saat pertama kali dijalankan dan menampilkan
sidik jarinya di panel serta pada setiap ekspor. Operator memberikan sidik jari tersebut kepada
penerima melalui saluran terpisah, dan --fingerprint mengamankan kunci tersebut.
Catatan yang diubah, ditambahkan, atau dihapus akan memutus rantai hash atau tanda tangan, dan
pemeriksa akan melaporkannya. Cap waktu eksternal dan saksi juga mengunci jurnal di luar
ruang kerja. Pemicu SQLite pada tabel jurnal hanya mencegah aplikasi
menimpa atau menghapus catatan secara tidak sengaja. TGWITNESS_VAULT_KEY_FILE menjaga agar kunci brankas
tidak termasuk dalam salinan direktori data.
RFC 3161 dan tanda terima OpenTimestamps, serta posting saksi yang tanggalnya dibaca oleh verifikator dari Telegram, mengikat awalan jurnal yang dicakupnya ke waktu yang ditetapkan oleh pihak ketiga. Putaran drand yang ditulis ke dalam jurnal menunjukkan bahwa catatan setelahnya dibuat tidak lebih awal dari saat putaran tersebut diterbitkan. Atestasi GitHub yang telah diverifikasi juga memuat waktu terverifikasi dari tanda tangannya, yang mengikat seluruh arsip ke waktu eksternal. Sebuah titik pemeriksaan ditandatangani dengan kunci pengumpul dan mengikat catatan hingga titik tersebut sejak saat penerima memperolehnya, melalui saluran lain. Seorang saksi menunjukkan bahwa kunci kedua menyimpan bagian awal jurnal; catatan kontrol kunci pengelola menunjukkan siapa yang memegang kunci tersebut. Keduanya merupakan pemeriksaan pendukung; syarat minimalnya adalah waktu pihak ketiga. Penangkapan GitHub Actions atau penyebaran Intel TDX menambahkan riwayat alur kerja atau pengukuran perangkat keras dari lingkungan pengumpulan.
Setiap jawaban verifikasi mencantumkan kondisi bukti beserta cara masing-masing diperiksa, dikelompokkan berdasarkan perannya dalam kriteria minimum:
| Peran | Kondisi |
|---|---|
| Diperlukan | Integritas; kunci penandatangan disematkan dengan --fingerprint; waktu eksternal yang mencakup catatan terakhir (tanda terima RFC 3161 diverifikasi dengan --tsa-ca, tanda terima OpenTimestamps dikonfirmasi dengan --check-bitcoin, posting saksi dibaca dari t.me dengan --channel, segel Bitcoin saksi atau verifikasi GitHub) |
| Mendukung, bukan bagian dari persyaratan minimum | Saksi dengan kunci sendiri; titik pemeriksaan yang disimpan; proses pengumpulan yang disahkan |
Syarat minimum untuk bukti adalah terpenuhinya ketiga kondisi yang diperlukan yang mencakup catatan terakhir yang diekspor;
proses pengumpulan yang telah diverifikasi dan disahkan akan menambahkan attested profil.
Baris terakhir menyatakan hasilnya, dan jawabannya menyebutkan opsi-opsi yang akan memenuhi
syarat-syarat yang belum terpenuhi. Tanpa --fingerprint baris terakhir dimulai dengan
EVIDENCE: minimum not met · missing: confirmed signer key.
Jika cap waktu yang terverifikasi hanya mencakup catatan sebelumnya, jawaban tersebut menyebutkan catatan terakhir
di mana syarat minimum tersebut berlaku. --require evidence atau --require attested akan keluar dengan kode 2 jika
profil tidak tercapai untuk seluruh proses ekspor, dan permintaan pemeriksaan pada baris perintah
yang tidak dapat dijalankan dilaporkan sebagai tidak dilakukan dengan kode yang sama. Setiap laporan
mencantumkan syarat-syarat yang sama beserta statusnya dalam salinan tersebut dan perintah yang memeriksanya
. Tingkat jaminan dan --strict tetap tersedia;
format bukti mencantumkan pemeriksaan untuk setiap mode pengumpulan.
Jika Anda mencurigai adanya masalah#
Pertahankan direktori data asli dan gunakan salinan terpisah untuk analisis. Laporkan versi yang terpengaruh, operasi, dan langkah-langkah yang dapat direproduksi melalui kebijakan keamanan , dengan menjaga kerahasiaan data akun dan kredensial.