# Telegram · Akses dan kebenaran

Canonical page: https://phishdestroy.io/tgwitness/ms/docs/reference/access/

Keluarkan akses terhad kepada akaun dan sembang, pilih kebenaran, hadkan sesi dan alamat IP, dan tarik balik akses.

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

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

Keluarkan akses terhad kepada akaun dan sembang, pilih kebenaran, hadkan sesi dan alamat IP, dan tarik balik akses.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Permulaan](https://phishdestroy.io/tgwitness/ms/docs/reference/quickstart/)

![Memulakan](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

Beri seorang penilai akses kepada satu sembang, seorang penganalisis kebenaran untuk mengeksport satu kes, atau seorang pengendali kawalan ke atas akaun terpilih. Setiap orang mendapat token mereka sendiri. Token panel utama kekal dengan pentadbir.

[Pengesetan akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/) · [Laluan sambungan](https://phishdestroy.io/tgwitness/ms/docs/reference/connection/) · [Model keselamatan](https://phishdestroy.io/tgwitness/ms/docs/reference/security/)

## Dua skop, dua tugas berbeza

**Skop pengumpulan** menentukan apa yang direkodkan oleh akaun: sembang terpilih, folder Telegram atau keseluruhan akaun. **Skop capaian** menentukan mana-mana akaun dan sembang yang direkodkan boleh dilihat dan digunakan oleh orang lain. Memberi capaian tidak menyertai sembang Telegram, memulakan pengumpulan atau memberi kebenaran akaun Telegram.

Akses boleh membuka ruang kerja terpilih, sembang terpilih di dalamnya, semua ruang kerja, atau setiap akaun dalam [kumpulan akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#bulk-import-and-account-groups). **Semua ruang kerja, termasuk yang ditambah kemudian** juga merangkumi akaun masa depan. Akses kumpulan juga merangkumi akaun yang ditambah ke kumpulan itu kemudian. Pilih ruang kerja secara eksplisit apabila kes harus terhad kepada mereka.

## Memberi seseorang akses

1. Log masuk sebagai pentadbir utama dan buka **Alat Lain → Akses**.
2. Di bawah **'Beri seseorang akses**', masukkan nama yang akan anda kenali dalam log.
3. Pilih ruang kerja dan, jika perlu, sembang individu.
4. Pilih apa yang mungkin dilakukan oleh orang ini. **Lihat** sentiasa disertakan.
5. Tetapkan tarikh luput, had log masuk/sesi dan alamat yang dibenarkan mengikut keperluan.
6. Tekan **'Create access**'. Salin token sekarang: ia hanya dipaparkan sekali.
7. Hantar alamat panel dan token secara peribadi. Penerima memasukkan token itu pada halaman log masuk biasa; mereka tidak memerlukan token panel utama anda atau sesi Telegram.

Buka panel dengan token yang dikeluarkan dalam sesi pelayar berasingan dan periksa sembang yang boleh dilihat serta tindakan yang dibenarkan sebelum menyerahkannya.

Nama capaian kekal dalam storan tempatan yang disulitkan dan diselesaikan oleh panel pentadbir. Nama diabaikan daripada rekod audit capaian baharu dan penciptaan ruang kerja; rekod bertera yang sedia ada mengekalkan medan asal mereka.

## Pilih kebenaran

Untuk demonstrasi awam hanya teks, gunakan **Paparan Awam** sebaliknya akses penilai biasa. Ia memaparkan saluran awam yang dipilih secara eksplisit, suntingan dan pemadaman yang disimpan, serta statistik yang disahkan, dengan medan pengarang disembunyikan dan fail ditutup pada sempadan API. [Buat dan sahkan paparan](https://phishdestroy.io/tgwitness/ms/docs/reference/showcase/).

| Kebenaran | Apa yang dibenarkan |
| --- | --- |
| `view` | Baca sembang yang dibenarkan, mesej yang dirakam, profil, fail dan rekod jurnal yang ditapis. Sentiasa disertakan. |
| `export` | Eksport sejarah sembang dan dosie yang dibenarkan. Eksport bukti seluruh ruang kerja memerlukan akses ke seluruh ruang kerja. |
| `sources` | Urus sumber, tangkapan skrin dan cap profil. Akses terhad sembang hanya boleh bertindak pada sembang yang dibenarkan; penemuan sumber dan tetapan skop merentas akaun kekal tertutup. |
| `collect` | Mulakan atau hentikan pengumpul. Memerlukan akses ke seluruh ruang kerja kerana pengumpulan menjejaskan akaun. |
| `interact` | Lakukan interaksi Telegram yang disokong dalam skop capaian. Akses terhad sembang tidak boleh menggunakan pratonton pautan untuk seluruh akaun. |
| `settings` | Ubah tetapan pengumpulan, cap masa, pemberitahuan, salinan luar tapak dan parameter. Memerlukan akses penuh ke ruang kerja. |
| `account` | Masuk atau log keluar Telegram dan urus laluan sambungan. Memerlukan akses penuh ke ruang kerja. |
| `board.read` | Bacalah nota Papan Kes hanya dalam ruang kerja dan sembang yang dibenarkan. |
| `board.write` | Tambah penanda buku, sorotan, hirisan, ulasan dan status buka/semak. Juga memerlukan `board.read`. |
| `board.manage` | Urus koleksi, status akhir pasukan dan kad peserta lain. Juga memerlukan hak baca/tulis papan. |

Hanya pentadbir utama boleh memuat turun kunci pemulihan replika luar tapak. Akses `settings` atau `account` yang diwakilkan tidak memberikan kunci tersebut.

Kebenaran dan skop disemak serentak. Menandakan kebenaran tidak akan membuka sembang lain atau membuka operasi merentas ruang kerja untuk capaian terhad pada sembang. Untuk eksport selari, capaian mesti merangkumi sembang yang dieksport dalam setiap akaun yang dipilih. Capaian yang dikeluarkan tidak boleh mencipta capaian baru, mengurus sesi orang lain atau membuka konsol pentadbir.

### Tiga susunan berguna

| Orang | Skop | Kebenaran |
| --- | --- | --- |
| Penilai | Perbualan rakaman satu kes | `view` |
| Penganalisis menyediakan penyerahan tugas | Perbualan untuk disiasat dan dieksport | `view`, `export`; tambahkan `interact` hanya jika mereka perlu bertindak melalui Telegram |
| Pengendali pengumpulan | Ruang kerja keseluruhan yang dipilih | `view`, `sources`, `collect`; tambahkan `settings` atau `account` hanya apabila diperlukan |

Preset permulaan Borang Akses juga merangkumi Papan Kes: Pengulas boleh membaca, Penganalisis boleh membaca dan menulis, dan Pengendali boleh mengurusnya. Preset kekal boleh disunting, dan pemberian hak sedia ada tidak diperluas secara automatik. Lihat [Papan Kes](https://phishdestroy.io/tgwitness/ms/docs/reference/case-board/) untuk skop sembang yang diwarisi dan privasi eksport.

## Had dan sesi

| Persetelan | Bagaimana ia berfungsi |
| --- | --- |
| Sesi selari | Hadkan sesi serentak kepada 1–100. Apabila mencapai had, tolak log masuk seterusnya atau tamatkan sesi tertua. |
| Log masuk dibenarkan | Hadkan penggunaan token yang berjaya hanya untuk memulakan sesi. Sesi sedia ada tidak akan ditamatkan semata-mata kerana log masuk terakhir yang dibenarkan telah digunakan. |
| Bersahaja sehingga | Tamat akses secara mutlak. Akses yang telah tamat tidak dapat log masuk atau terus membuat permintaan. |
| Minit tanpa aktiviti | Tamat masa tidak aktif sesi, dari 5 minit hingga 30 hari. Permintaan yang berjaya akan memanjangkannya; panel terbuka boleh kekal aktif dengan membuat semakan berkala. |
| Alamat yang dibenarkan | Terima alamat IP tertentu atau subnet CIDR. Biarkan kosong untuk membenarkan sebarang alamat melainkan pengikatan log masuk pertama diaktifkan. |
| Ikatan pada log masuk pertama | Log masuk pertama yang berjaya menetapkan alamat yang dibenarkan untuk capaian tersebut. |

IP ialah alamat klien yang dilihat oleh aplikasi. Di sebalik proksi songsang atau terowong, semak alamat yang dipaparkan dalam **Sesi Terbuka** sebelum bergantung pada peraturan IP: jika tidak, beberapa pengguna mungkin kelihatan berkongsi alamat proksi tersebut.

## Ubah atau tarik balik akses

Sunting entri di bawah **Akses yang diberikan** untuk mengubah skop, kebenaran atau hadnya. Perubahan skop dan kebenaran disemak pada permintaan seterusnya, termasuk permintaan daripada sesi yang sudah dibuka. Membatalkan akses akan menamatkan sesi-sesi dan menjadikan token yang dikeluarkan tidak boleh digunakan. **Sesi terbuka** juga membolehkan pentadbir menamatkan sesi individu tanpa membatalkan keseluruhan akses.

Salinan eksport yang disimpan mengekalkan penciptanya, ruang kerja, skop sembang dan kebenaran yang diperlukan. Akses yang dikeluarkan hanya boleh menyenaraikan atau memuat turun salinannya sendiri selagi kebenaran tersebut masih terpakai; salinan yang mengandungi Papan Kes juga memerlukan `board.read`. Pentadbir boleh mendapatkan semua salinan. Salinan lama tanpa metadata ini dan bundel kumpulan adalah untuk pentadbir sahaja. Tiket muat turun dan respons fail yang disediakan akan menyemak semula akses selepas menyediakan fail, sebelum menghantar baitnya. Setiap akses, termasuk pentadbir, boleh memegang sepuluh tiket muat turun yang belum diproses bagi setiap ruang kerja; had untuk seluruh ruang kerja ialah 1,000. Tiket akan tamat tempoh selepas 120 saat dan hanya boleh digunakan sekali.

Pencabutan tidak dapat memulihkan semula fail yang telah dimuat turun oleh seseorang. Log keluar, mengunci panel atau menamatkan sesi tidak menghentikan pengumpul yang sedang berjalan.

## Apa yang boleh dilihat oleh pentadbir

Pemeriksa dan penganalisis menerima kemajuan pengumpulan tanpa hujung proksi, diagnostik kolam, laluan pelayan atau ralat sambungan mentah. Diagnostik sambungan memerlukan kebenaran `account` ke atas seluruh ruang kerja. Membaca pemberitahuan, salinan luar tapak dan tetapan parameter memerlukan kebenaran `settings`.

Rentetan pelayar penuh User-Agent tidak dikekalkan dalam sesi akses. Peningkatan juga menyingkirkannya daripada cache sesi yang boleh diubah. Log proses panel menyembunyikan alamat IP literal, kelayakan URL dan rahsia berlabel. Log perkhidmatan tempatan dan rekod jurnal yang telah ditandatangani sebelum ini tidak ditulis semula. Peraturan akses dan rekod log masuk yang ditandatangani masih menggunakan alamat klien.

### Gantikan kunci utama

Gunakan **Alat Lain → Akses → Had saya → Terbitkan semula kunci pentadbir**, atau jalankan `tgwitness token rotate` daripada pemasangan yang diuruskan semasa panel sedang berjalan. Semua sesi pelayar sedia ada akan tamat, termasuk sesi yang dibuka dengan token rakan sekerja. Pelayar yang membuat permintaan menerima sesi baru; simpan kunci pentadbir baru sebelum menyembunyikannya. Token rakan sekerja yang telah dikeluarkan kekal sah sehingga dibatalkan secara berasingan. Pemasangan yang menggunakan `TGWITNESS_TOKEN` mesti menukar tetapan persekitaran tersebut dan memulakan semula.

### Batas permintaan dan proksi

API membenarkan sehingga 600 permintaan seminit bagi setiap klien dan keluarga kelayakan: panel, arkib/MCP atau saksi. Tempoh penyejukan pengesahan adalah berasingan bagi keluarga-keluarga ini. Sepuluh pengesahan yang ditolak dalam masa seminit memulakan tempoh penyejukan eksponen, dari satu saat hingga lima minit. Percubaan yang gagal selepas tempoh penyejukan akan meningkatkannya; sepuluh minit tanpa percubaan gagal akan menetapkan semula peningkatan itu. Penolakan mengembalikan HTTP 429 dan `Retry-After` . Had disimpan dalam memori, dikongsi di seluruh ruang kerja dalam satu proses panel; memulakan semula akan membersihkannya. Siaran langsung dihadkan kepada empat setiap token pembawa dan 32 untuk proses panel. Membuka siaran juga menggunakan bajet permintaan API.

Badan permintaan mempunyai had masa penerimaan 60 saat, dikurangkan kepada 10 saat untuk log masuk, akses demo, API arkib dan laluan witness-head, atau 8 saat untuk pengangkutan MCP. Setiap aplikasi membenarkan empat badan belum selesai bagi setiap alamat klien, dengan had keseluruhan 32 dan 64 MiB kelayakan laluan yang diperuntukkan. Permintaan tanpa badan tidak menggunakan slot ini. Badan yang terlalu besar akan mengembalikan 413, badan yang tamat masa akan mengembalikan 408, dan kapasiti klien yang melebihi akan mengembalikan 429 dengan `Retry-After: 1`. Kapasiti keseluruhan badan yang habis akan mengembalikan 503 dengan `Retry-After`.

Header IP yang diteruskan diabaikan melainkan rakan sebaya TCP sebenar tergolong dalam `TGWITNESS_TRUSTED_PROXIES` (IP yang dipisahkan dengan koma atau CIDR). Tetapkan `TGWITNESS_PROXY_HEADER` kepada `x-forwarded-for` atau `cf-connecting-ip`. XFF dilalui daripada proksi terdekat ke arah rakan sebaya pertama yang tidak dipercayai. Metadata alamat dipercayai yang rosak atau berganda ditolak, jadi ia tidak dapat mewarisi alamat proksi yang dibenarkan. Terowong pantas yang diurus mempercayai penyambung cloudflared tempatan; tetapan domain sendiri mempercayai Caddy tempatan. Penyebaran langsung secara lalai tidak mempercayai mana-mana proksi. Jika anda melancarkan Uvicorn sendiri, nyahdayakan pemprosesan header-proksi supaya sempadan ini menerima rakan sebaya sebenar.

`TGWITNESS_PANEL_ALLOWED_IPS` mengehadkan semua akses panel, termasuk pentadbir, kepada IP atau CIDR yang disenaraikan. Uji identiti penjejakan pemasang kekal awam dan tidak mengembalikan sebarang data akaun. Sertakan laluan pentadbiran tempatan yang diperlukan sebelum mengaktifkan senarai benarkan. Panduan **START-HERE** untuk pemasangan yang diuruskan merangkumi konfigurasi perkhidmatan dan arahan pemulihan.

Pemilih pertanyaan API `ws` mesti mengenal pasti ruang kerja dalam laluan permintaan; pemilih yang tidak diketahui, tidak sepadan dan dwi salinan ditolak dengan kod 404.

Skrip dan gaya panel membawa metadata integriti SHA-384. Peta import juga merangkumi modul JS yang diimport secara tempatan dalam pelayar yang menyokong integriti import-map. Tindak balas bahasa yang dijana secara dinamik adalah berasingan. Semakan ini mengesan penggantian aset berbanding halaman yang dihantar; halaman itu sendiri dan hashnya datang daripada pelayan panel, jadi lindungi pelayan itu dan laluan penghantarannya.

**Log sejak permulaan ini** menggabungkan log proses dengan aktiviti jurnal dari setiap ruang kerja: log masuk, penolakan, perubahan laluan dan tindakan pengendali. Ia adalah konsol dalam memori untuk proses semasa, bukan salinan kekal bagi setiap mesej. Acara mesej yang kerap kekal dalam jurnal dan bukannya memenuhi konsol.

Penerbitan, perubahan dan pembatalan akses, serta permulaan atau penamatan sesi, juga menghasilkan rekod jurnal `access.*` yang disahkan. Token tidak disertakan dalam rekod tersebut. Token yang dikeluarkan dan kelayakan sesi disimpan sebagai hash dalam peti besi yang disulitkan.

Log masuk QR yang tertangguh milik sesi panel yang memulakannya. Mengakhiri atau membatalkan sesi tersebut, atau memutarkan token panel utama, membatalkan klien QR tertunggak di pelayan. Ini juga terpakai apabila pelayar tidak dapat menghantar permintaan pembatalan sendirinya. Pemutaran token juga membatalkan kemasukan QR yang dimulakan terus dengan token panel utama. Permintaan QR yang menunggu operasi lain menyemak semula akses sebelum ia bermula. Kebenaran Telegram yang telah diselesaikan dan kemasukan tertunggak yang dimulakan oleh sesi panel lain dikekalkan.

****Pentadbir utama dan sempadan kepercayaan****

Token panel utama kekal tidak terhad. Log masuk pelayar dengannya mewujudkan sesi yang tertakluk kepada had sesi yang dikonfigurasikan oleh pentadbir. Skrip yang menghantar token utama secara langsung mengekalkan akses penuh dan tidak dikira sebagai sesi pelayar.

Ini adalah kawalan capaian peringkat aplikasi dalam satu pemasangan. Semua ruang kerja berkongsi proses pelayan; ini bukan pengasingan daripada pentadbir hos. Kekalkan token utama, sesi Telegram, kunci penandatanganan dan direktori data secara peribadi. Token saksi adalah titik pemeriksaan/kredensial kesihatan berasingan, bukan token capaian panel.
