# Telegram · Xavfsizlik va ma'lumotlarni boshqarish

Canonical page: https://phishdestroy.io/tgwitness/uz/docs/reference/security/

Xavf modeli, kirish modeli, saqlashdagi sirlar, tarmoqdagi ochiqlik, sessiya importlari va zaiflikni qanday xabar qilish.

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

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

Xavf modeli, kirish modeli, saqlashdagi sirlar, tarmoqdagi ochiqlik, sessiya importlari va zaiflikni qanday xabar qilish.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Hujjatlash](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Joylashtirish va tiklash](https://phishdestroy.io/tgwitness/uz/docs/reference/deployment/)

![Joylashtirish va tiklash](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

Ushbu sahifa mahalliy yoki server ish maydonida kirish, saqlash va tarmoqni himoya qilishni tasvirlaydi. GitHub runner'da yoki Intel TDX maxfiy VM'da yig'ish uchun yig'ish muhitini tekshiruvchi qo'shimcha [tekshiruv rejimlar](https://phishdestroy.io/tgwitness/uz/docs/reference/evidence/#verification-scope)iga qarang. Hisobga ulanishlar, bildirishnomalar, vaqt tamg'alari, masofaviy nusxalar va guvohlarning o'z yo'naltirish sozlamalari mavjud.

| Soha | Qisqasi |
| --- | --- |
| Kirish | Administrator kaliti va hisoblar/suhbatlarga chegaralangan kirish, yetti ruxsat va bekor qilinishi mumkin bo'lgan sessiyalar; standart bo'yicha localhost |
| Saqlangan sirlar | Sessiya, API juftligi, imzolash kaliti va proksi sozlamalari Fernet bilan shifrlangan |
| Xabarlar va media | Ish maydonidagi fayllar disk yoki hajm shifrlash hamda mezbonning fayl ruxsatnomalari bilan himoyalangan |
| Buzilmaslik | Har bir yozuvda SHA-256 xesh zanjiri va Ed25519 imzosi |
| Tashqi vaqt | RFC 3161 va OpenTimestamps kvitansiyalari, Telegram va GitHub tasdiqlari bilan sanalangan guvoh postlari; saqlangan tekshiruv nuqtalari, guvoh yozuvlari va Intel TDX o'lchovlari yordamchi tekshiruvlardir. Verifikator qaysi dalil shartlariga javob berishini xabar qiladi. |

Zaifliklar bo'yicha hisobotlar uchun [xavfsizlik siyosat](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md)iga qarang.

**Ushbu sahifada**

- [Kirish modeli](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#access-model)
- [Panel mazmuni va eksportlari](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#panel-content-and-exports)
- [Saqlangan sirlar](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#secrets-at-rest)
- [Proxy-lar va tarmoq yo'nalishlari](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#proxies-and-network-routes)
- [Kirish va sessiya importlari](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#sign-in-and-session-imports)
- [Loglar va transport](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#logs-and-transport)
- [Buzilmaslik va tashqi vaqt](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#integrity-and-external-time)
- [Agar muammo borligiga shubha qilsangiz](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#if-you-suspect-a-problem)

## Kirish modeli

Asosiy panel tokeni to'liq nazoratni beradi. Boshqa odamlar o'zlarining [chegaralangan kirish hu quqlar](https://phishdestroy.io/tgwitness/uz/docs/reference/access/)ini olishlari mumkin: tanlangan ish maydonchalari va suhbatlar, ruxsatnomalar, amal qilish muddati, IP-cheklovlar, tizimga kirish limitlari va bekor qilinishi mumkin bo'lgan sessiyalar. Suhbatga cheklangan kirish huquqi odamlarning ruxsatnomasi belgilangan bo'lsa ham butun ish maydonchasi bo'yicha amaliyotlarni bajara olmaydi. Har bir ish maydoni bitta jarayonda o'z jurnaliga, xazinaga va imzolash kalitiga ega; hostdagi odamlar o'rtasidagi ajratish operatsion tizim hisoblaridan kelib chiqadi.

Panel mahalliy tarmoq (localhost) orqali standart bo'yicha tinglaydi. Brauzerda tizimga kirish sessiya ma'lumotini kirish tokeniga almashtiradi; brauzer uni bearer tokeni sifatida yuboradi. U autentifikatsiya cookie o'rniga sessionStorage'da saqlanadi. Qulflash/chiqish brauzer sessiyasini tozalaydi. Brauzerni yopish yoki sessiyani tugatish ma'lumotlarni yig'ishni to'xtatmaydi.

Chiqarilgan tokenlar va sessiya ma'lumotlari shifrlangan omborda xeshlar ko'rinishida saqlanadi. Bekor qilish tegishli sessiyalarni tugatadi; ruxsat o'zgarishlari keyingi so'rovlarga ta'sir qiladi. Yuklab olingan fayllarni qaytarib olib bo'lmaydi. Administrator o'z brauzer sessiyalarini ham cheklashi mumkin, ammo asosiy panel tokenidan to'g'ridan-to'g'ri foydalanadigan skriptlar to'liq kirishni saqlab qoladi va brauzer sessiyasi cheklovlarini chetlab o'tadi.

Avtorizatsiya muvaffaqiyatsiz bo'lsa, mijoz manzili bo'yicha tez-tezlik cheklovi qo'llanadi. IP-cheklovlar ilova ko'rayotgan manzilga asoslanadi; unga tayanishdan oldin teskari proksi xatti-harakatlarini tekshiring. Witness hisob ma'lumotlari alohida, faqat o'qish uchun mo'ljallangan tekshiruv nuqtasi/sog'liqni tekshirish ma'lumotlari bo'lib qoladi.

### Demo kirish

`/api/demo-access` aniq boshlangan, izolyatsiyalangan sintetik demo uchun ataylab autentifikatsiyalanmagan bootstrap hisoblanadi. U alohida jarayon umrboqiyligi imkoniyatini beradi, hech qachon haqiqiy panel tokeni yoki TGWITNESS_TOKEN ustuvor tokenini bermaydi. Chiqarish va foydalanish loopback tengdosh va mezbonni, yo'naltirilgan sarlavhalarni va manba-aralash so'rovlarni talab qiladi. Qo'shimcha ish maydonchalari yoki ruxsat etilgan sessiya ushbu yo'nalishni o'chirib qo'yadi. Jonli ish maydonchalari hech qachon ushbu imkoniyatni bermaydi. Demo hisoblarni bog'lay olmaydi yoki yig'ish sozlamalarini o'zgartira olmaydi.

## Panel mazmuni va eksportlari

Panel hech qanday tashqi shriftlar, tahliliy vositalar, CDN resurslari yoki o'rnatilgan masofaviy media elementlaridan foydalanmaydi. Telegram manbasidan olingan matn HTML emas, oddiy matn sifatida kiritiladi. Yuklab olingan ilovalar binar ilovalar sifatida taqdim etiladi. JSONL eksporti asl satrlarni saqlaydi; HTML ularni qochiradi; formulaga aylanishi mumkin bo'lgan CSV hujayralari esa apostrof bilan boshlanadi.

Eksportlar autentifikatsiya va imzolash sirlarini o'z ichiga olmaydi, lekin ataylab to'plangan manba metama'lumotlari, identifikatorlar va ehtimol shaxsiy yoki nozik kontentni o'z ichiga oladi. Telegramga kirish hashlar va fayl havolalari xom manba metama'lumotlarida uchrashi mumkin.

## Saqlangan sirlar

Telegram API kreditsialari, sessiya va imzolash kaliti Fernet bilan shifrlanadi. Mahalliy xabarlar va media uchun shifrlash mezbonning diski yoki hajmi tomonidan ta'minlanadi; ish maydoni oddiy fayllarni saqlaydi. Eksportlar parol bilan himoyalangan AES-256 ZIP-dan foydalanishi mumkin, va tashqi nusxalar AES-256-GCM-dan foydalanadi.

Ombor kaliti standart bo'yicha himoyalangan ma'lumotlar papkasiga o'rnatiladi. Uni alohida saqlash uchun quyida tashqi bosh kalit faylidan foydalaning. Unix tizimida yangi shaxsiy kalit fayllari 0600 rejimidan, yangi ma'lumotlar papkalari esa 0700 rejimidan foydalanadi; Windows tizimida esa xizmat akkaunti va ruxsat berilgan ma'murlar uchun papka ACL sozlamalarini o'rnating. Mavjud papka ruxsatlari saqlanib qoladi.

### Tashqi bosh kalit

Yangi ma'lumotlar katalogi uchun TGWITNESS_VAULT_KEY_FILE tashqi tasodifiy bosh kalitni ta'minlashi mumkin. HKDF-SHA256 va alohida tasodifiy tuz har bir ish maydoni uchun turli Fernet kalitini hosil qiladi. Tiklash uchun vault.external.json saqlanishi kerak. Yo'qolgan yoki noto'g'ri bosh kalitlar yopiladi. Mavjud mahalliy omborlar jimjit ko'chirilmaydi. Panel tanlangan kalit saqlash rejimini ko'rsatadi. Diskni shifrlash har ikkala rejimda ham mahalliy xabar va media fayllarni himoya qiladi; sozlash tafsilotlari uchun [ulanish va ma'lumotlarni himoya qilish bo'limlariga](https://phishdestroy.io/tgwitness/uz/docs/reference/connection/) qarang.

## Proxy-lar va tarmoq yo'nalishlari

Proxy konfiguratsiyasi omborda shifrlanadi. Parollar va MTProxy sirlar API orqali qaytarilmaydi yoki dalil yozuvlariga yozilmaydi. Har bir ish maydoni o'z Telegram yo'nalishi va [IP rejimini](https://phishdestroy.io/tgwitness/uz/docs/reference/connection/#ip-modes) tanlaydi.

**"Hide the address"** bevosita Telegram zaxira rejimiga o'tishni rad etadi va tashqi HTTP so'rovlari uchun proksi talab qiladi. Aniq tanlangan zaxira rejimi kechikishdan so'ng Telegramga bevosita ulanishga ruxsat beradi; tunnel/VPN rejimi esa bevosita yo'nalishlarni ta'minlaydi. Tunnel rejimini tanlash VPNni o'rnatmaydi yoki tekshirmaydi. Ushbu sozlamalar butun tizim trafigini, brauzerlarni, paket boshqaruvchilarni yoki mahalliy proksi-server DNS aniqlashni nazorat qilmaydi.

MTProxy faqat Telegram trafigini uzatadi. Tashqi so'rovlar alohida SOCKS5/HTTP proksidan, ish maydonining SOCKS5/HTTP yo'nalishidan yoki ruxsat etilgan to'g'ridan-to'g'ri yo'ldan foydalanishi mumkin; ularni o'chirib qo'yish ham mumkin. Mustaqil guvoh o'z transport sozlamalariga ega. Oddiy SOCKS5/HTTP CONNECT autentifikatsiyasi o'sha proksi protokollari tomonidan shifrlanmaydi. Soxta TLS MTProxy sirlarini qo'llab-quvvatlash hali ham mavjud emas.

## Kirish va sessiya importlari

Konvertlangan .tgwitness-session fayllarida oddiy matnda avtorizatsiya sirini o'z ichiga oladi, ular omborga yuklanib saqlanmaguncha. Oflayn CLI ko'rib chiqilgan Telethon sxemalarini qabul qiladi. Panel importi shuningdek Pyrogram SQLite, zamonaviy yagona akkauntli TData ZIP va hujjatlashtirilgan JSON kirishlarni qabul qiladi. U autentifikatsiyalangan, to'rtta fayl / 8 MiB bilan cheklangan va yuklamalarni arxivni chiqarib olish yoki asl fayllarni saqlashsiz xotirada qayta ishlaydi. Normalizatsiyalangan kreditsialar faqat so'rov yuborgan autentifikatsiyalangan brauzerga qaytariladi; ular Telegramda muvaffaqiyatli ruxsat berilgach shifrlangan omborga saqlanadi. Asl fayllar va konvertatsiya qilingan fayllarni himoya qiling va bir vaqtning o'zida bir nechta mijozlarning ruxsatnoma nusxasini yaratishining oldini oling.

TData ishlovi konteyner tekshiruv yig'indilarini, mahalliy dekriptirovka xeshlarini va tuzilma uzunliklarini tasdiqlaydi. Taqdim etilgan Desktop mahalliy parol vaqtinchalik ishlatiladi va saqlanmaydi. Cheklangan parser o'z tasdiqlaydigan Desktop formatlarini qo'llab-quvvatlaydi va boshqalarini rad etadi. QR tasvirlari mahalliy ravishda yaratiladi, qisqa muddatli Telegram kirish tokenlarini o'z ichiga oladi va hech qachon tashqi render xizmatiga yuborilmaydi. Bloklash, ish maydoni almashtirish, yangi kirish va yo'nalish o'zgarishlari kutayotgan QR urinishlarini bekor qiladi. Vozkani qayta yuklash/yopish urinishni muddat tugaguncha kutib turishi mumkin. Muvaffaqiyatli QR kirish hanuzgacha hisobni bog'lashni majburiy qiladi. Oddiy API tanalari 16 KiB bilan cheklangan bo'lib qoladi; autentifikatsiyalangan import yo'li kodlangan JSON uchun 12 MiB gacha qabul qiladi, dekodlangan faylning kichikroq limitini alohida qo'llaydi.

Kirish kodlari va Telegram ikki bosqichli tasdiqlash parollari saqlanmaydi. Telefon raqami/kod-hash holati avtorizatsiya vaqtida xotirada saqlanadi. Telegram sessiyalari hisobga kirish huquqini beradi; hech qachon ma'lumotlar katalogi, sessiya, token, xazina kaliti yoki xususiy imzo kalitini GitHubga yuklamang.

## Loglar va transport

Standart API tasdiqlash javobi o'zgartiriladi, shunda u kirish ma'lumotlari qiymatlarini aks ettirmaydi. Ilova kirishini qayd etish o'chirilgan. Revers proksini avtorizatsiya sarlavhalari yoki so'rov tanalarini qayd etish uchun sozlamang. Panel localhost bo'yicha tinglaydi; masofaviy kirish taqdim etilgan SSH tunneli, Cloudflare Tunnel yoki Caddy HTTPS orqali amalga oshiriladi, shuning uchun tokenlar va kirish sirlar SSH yoki TLS ichida uzatiladi.

## Butunlik va tashqi vaqt

Verifikatsiya tekshiruvlari yozuv imzolarini, xesh zanjirini, ilovalarni va eksport manifestini yig'uvchi kaliti bilan solishtiradi. Amaliy imzo baytlar imzolanganidan beri o'zgarmaganligini ko'rsatadi. Har bir ish maydoni dastlabki ishga tushirilganda o'z imzolash kalitini yaratadi va barmoq izini paneldagi hamda har bir eksportda ko'rsatadi. Operator barmoq izini alohida kanal orqali qabul qiluvchiga beradi, va `--fingerprint` kalitni bloklaydi.

O'zgartirilgan, kiritilgan yoki o'chirilgan yozuv xesh zanjirini yoki imzoni buzadi va verifikator buni xabar qiladi. Tashqi vaqt tamg'alari va guvoh ham ish maydonidan tashqaridagi jurnalni mustahkamlaydi. SQLite jurnal jadvalida yuzaga keladigan ogohlantirishlar ilovani yozuvni xato bilan ustiga yozish yoki o'chirishdan to'xtatadi. `TGWITNESS_VAULT_KEY_FILE` seyf kalitini ma'lumotlar katalogi nusxasidan tashqarida saqlaydi.

RFC 3161 va OpenTimestamps kvitansiyalari hamda verifikator Telegram'dan o'qiydigan sanalarga ega guvohlik postlari, o'zlari qamrab olgan jurnal prefiksini uchinchi tomon belgilagan vaqtga bog'laydi. Jurnalga yozilgan drand raundi undan keyingi yozuvlarning ushbu raund e'lon qilinganidan oldin yaratilmaganligini ko'rsatadi. Tekshirilgan GitHub guvohligi ham o'z imzosi tasdiqlangan vaqtini o'z ichiga oladi, bu esa butun arxivni tashqi vaqtga bog'laydi. Tekshiruv nuqtasi (checkpoint) kollektor kaliti bilan imzolanadi va qabul qiluvchi uni boshqa kanal orqali olgan lahzadan boshlab o'zgacha bo'lgan yozuvlarni bog'laydi. Guvoh (witness) ikkinchi kalit jurnal boshini saqlab turganini ko'rsatadi; saqlovchining kalitni boshqarish yozuvi esa kimda bu kalit borligini ko'rsatadi. Ikkalasi ham qo'llab-quvvatlovchi tekshiruvlardir; minimal talab – uchinchi tomon vaqti. [GitHub Actions yozib olish](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) yoki [Intel TDX joriy etilishi](https://phishdestroy.io/tgwitness/uz/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) yig'ish muhitining ish jarayoni kelib chiqishi yoki apparat o'lchovlarini qo'shadi.

Har bir tasdiqlash javobi dalillar shartlarini va ularning har biri qanday tekshirilganini ko'rsatadi, minimal shartlardagi rollariga ko'ra guruhlangan:

| Rol | Shart |
| --- | --- |
| Majburiy | Yakka-butunlik; imzolovchi kaliti `--fingerprint` bilan bog'langan; so'nggi yozuvni qamrab olgan tashqi vaqt (RFC 3161 kvitasi `--tsa-ca` bilan tekshirilgan, OpenTimestamps kvitasi `--check-bitcoin` bilan tasdiqlangan, guvoh xabari t.me dan `--channel` orqali o'qilgan, guvoh Bitcoin muhri yoki GitHub tasdig'i tekshirilgan) |
| Minimal tarkibga kirmaydigan, balki uni qo'llab-quvvatlaydigan | O'z kalitiga ega guvoh; saqlangan tekshiruv nuqtasi; tasdiqlangan to'plam ijrosi |

**Dalil uchun minimal** talab — so'nggi eksport qilingan yozuvni qamrab olgan uchta zarur shartning barchasidir; tasdiqlangan yig'ilgan ma'lumotlar yurituvi qo'shadi `attested` profil. Oxirgi satr natijani bildiradi, javob esa yetishmayotgan shartlarga javob beradigan variantlarni nomlaydi. `--fingerprint` oxirgi satr quyidagicha boshlanadi `EVIDENCE: minimum not met · missing: confirmed signer key`. Tegishli vaqt belgilari faqat avvalgi yozuvlarni qamrab olsa, javob minimal shartlar qaysi yozuvgacha amal qilishini ko'rsatadi.sizsiz, oxirgi satr quyidagicha boshlanadi: `--require evidence` yoki `--require attested` profil butun eksport davomida erishilmagan bo'lsa, kod 2 bilan chiqadi, va buyruq satrida so'ralgan, lekin bajarilmaydigan tekshiruv ham shu kod bilan bajarilmaganligi haqida xabar qilinadi. Har bir hisobot o'sha nusxadagi shartlarning holati va ularni tekshiradigan buyruq bilan birga taqdim etiladi. Ishonch darajalari va `--strict` mavjud bo'lib qoladi; [dalil formati](https://phishdestroy.io/tgwitness/uz/docs/reference/evidence/#verification-scope) har bir yig'ish rejimi uchun tekshiruvlarni ro'yxatlaydi.

## Agar muammo borligiga shubha qilsangiz

Asl ma'lumotlar katalogini saqlang va tahlil uchun alohida nusxa ishlating. [Xavfsizlik siyosati](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md) orqali ta'sirlangan versiya, amaliyot va qayta yaratilishi mumkin bo'lgan bosqichlarni xabar qiling, hisob ma'lumotlari va parollarni maxfiy saqlang.
