# Telegram · GitHub Actions yozib oladi

Canonical page: https://phishdestroy.io/tgwitness/uz/docs/capture/

Vaqtinchalik GitHub runner’da Takeout, oddiy API eksporti yoki chat jurnalini tanlang.

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

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

Vaqtinchalik GitHub runner’da Takeout, oddiy API eksporti yoki chat jurnalini tanlang.

Kalit yaratish va arxivni dekriptirovka qilish uchun JavaScript-ni yoqish.

**To'liq manba**

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Hujjatlash](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Mustaqil ushlash](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)

![Mustaqil ushlash](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b)

**`main`dan ko'rinish mavjud.** Fork belgilangan, qayta ishlatiladigan ish jarayonini ishga tushiradi `phishdestroy/TgWitness`. Jarayon yangi yaratilgan Telegram sessiyasi yordamida hisobni, tanlangan suhbatlarni yoki bitta suhbatning voqealar jurnalini eksport qiladi, dalillar ZIP-faylini yoki ko'p bo'limli manifestni tasdiqlaydi va faqat qabul qiluvchi tomonidan shifrlangan handofflarni yuklaydi. Oddiy boshqaruv paneli ko'rinmaydi.

Tanlang `client=official_web` [rasmiy-client](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md)guvohini himoyalangan Telegram veb-boshqaruvlari va video bilan ishga tushirish. Bu sizning o'z upstream proksingizni talab qiladi va bitta renderlangan suhbatni kuzatadi. Standart `client=api` quyidagi tavsiflangan to'liq hisob eksporti rejimlarini saqlab qoladi.

Verifikator arxivni uning GitHub tasdig'i, tasdiqlangan ish jarayoni va to'plovchi commitlari, shuningdek imzolangan jurnal hamda ilovadagi hashlar bilan solishtirib tekshiradi. To'plash jarayoni mahkamlangan yuqori oqim kodi va yangi omborni ishlatadi. Ko'rib chiquvchi shu kodni tekshirishi va yetkazib berilgan arxivni uning qayd etilgan ijrosi bilan solishtirib tasdiqlashi mumkin.

**Ushbu sahifada**

- [Foydalanuvchi oqimi](https://phishdestroy.io/tgwitness/uz/docs/capture/#user-flow)
- [Sessiya vaqti byudjeti](https://phishdestroy.io/tgwitness/uz/docs/capture/#session-time-budget)
- [Ushbu rejimni yoki doimiy ish maydonini tanlang](https://phishdestroy.io/tgwitness/uz/docs/capture/#choose-this-mode-or-a-persistent-workspace)
- [Nima ommaviy bo'lishi kerak va nima xususiy qolishi kerak](https://phishdestroy.io/tgwitness/uz/docs/capture/#what-is-public-and-what-must-stay-private)
- [Muammolarni bartaraf etish](https://phishdestroy.io/tgwitness/uz/docs/capture/#troubleshooting)
- [Mahalliy dekriptirovka va tasdiqlash](https://phishdestroy.io/tgwitness/uz/docs/capture/#local-decryption-and-verification)
- [Cho'qqi qanday qilib ushlash jarayonidan tashqarida saqlanadi](https://phishdestroy.io/tgwitness/uz/docs/capture/#how-the-fork-is-kept-outside-the-capture-process)
- [Kriptografik topshirish](https://phishdestroy.io/tgwitness/uz/docs/capture/#cryptographic-handoff)
- [Doira va tasdiqlash](https://phishdestroy.io/tgwitness/uz/docs/capture/#scope-and-validation)
- [Saqlovchi reliz ketma-ketligi](https://phishdestroy.io/tgwitness/uz/docs/capture/#maintainer-release-sequence)

## Foydalanuvchi

Yordamchi beshta bosqichni tushuntiradi va sizga namunaviy ma'lumotlarda xabar yoki yig'uvchi almashtirishni sinab ko'rish imkonini beradi. **Capture-ni boshlash** ustuvor oynani ochadi.

1. Loyiha bosh sahifasida, ish maydoni kirish ekranida yoki **Eksportlar → Capture yordamchisini ochish** orqali **GitHub Actions yozuvini (oldindan ko'rish)** tanlang. Shuningdek, ishonchli checkout-dan zamonaviy brauzerda [rasmiy yordamchi](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) yoki `tgwitness/static/capture.html`-ni ochishingiz mumkin. Yordamchi kalit yoki faylni qayta ishlash uchun tarmoq so'rovlarini amalga oshirmaydi. Yordamchi sayt interfeysi tillarini qo'llab-quvvatlaydi; vaqtinchalik yig'ish paneli ingliz va rus tillarini qo'llab-quvvatlaydi va brauzerning tiliga mos ravishda ochiladi.
2. Kalit yarating va saqlang **muhrlangan-kalit.json**. Bu yagona xususiy dekripsiya kalitidir. Alohida jamoat kalitini nusxalang **qabul qiluvchi** qiymat. Xususiy kalitni yo'qotish aloqaga ham, arxivga ham kirishni yo'qotishga olib keladi. Keyingi bosqichni ochish uchun uni saqlaganingizni tasdiqlang. Agar sizda allaqachon yetkazib berish fayli bo'lsa, saqlangan kalitni yuklang va tanlang **Menda allaqachon arxiv bor**.
3. Fork TgWitness-ni yarating, forkdagi Actions-ni yoqing va **Sealed chat capture-ni** ishga tushiring. Ommaviy qabul qiluvchini joylashtiring va 30, 60 yoki 120 daqiqani tanlang. Hech qachon telefon raqami, kirish kodi, Telegram paroli, xususiy kalit yoki sessiyani ish jarayoni kirishlariga, commitlarga, masalalarga yoki loglarga kiritmang.
4. Ijro vaqtida Artifacts-dan **sealed-connection-ni** yuklab oling va uni arxivdan chiqarib oling. Yuklang `connection.tgwsealed` Helperda saqlangan xususiy kalitdan foydalaning. Natijada hosil bo'lgan havola uning URL bo'lagida tasodifiy kirish sirini o'z ichiga oladi. Ushbu havolani maxfiy saqlang. Panel bo'lakni olib tashlaydi va sirni shu yorliqning sessiya saqlashida saqlaydi; u HTTP kirish jurnaliga kiritilmaydi.
5. Ulanish havolasini oching. QR-kod yordamida yoki telefon raqamingiz va kirish kodi bilan tizimga kiring. Telegram so'rasa, ikki bosqichli tekshiruv parolingizni kiriting. Ichki API kredensiallar zaxirasi odatdagi ish maydoni kabi standart bo'yicha ishlatiladi. Ixtiyoriy maxsus kredensiallar bo'limini kengaytirib, ikkalasini ham kiriting `api_id` va `api_hash` [my.telegram.org/apps sayt](https://my.telegram.org/apps)idan va my.telegram.org/apps satrlarini kiriting. Ichki omborni ishlatish uchun ikkala maydonni bo'sh qoldiring; qisman yoki noto'g'ri juftlik rad etiladi. Sessiya importlari ruxsat etilmaydi. Eksport rejimi va doirasini tanlang. Ulanish havolasida kirish siridan foydalaniladi: uni maxfiy saqlang.
6. **Telegram Takeout**, **Oddiy Telegram API** yoki **Chat voqealari jurnalini** tanlang. Hisobni eksport qilish uchun barcha mavjud suhbatlarni tanlang yoki yuklab, bir yoki bir nechta suhbatni tanlang, so'ng sanalar, suhbat turlari, hisob toifalari va ilova qoidalarini belgilang. Sozlamalar va hajmni tekshiring, ixtiyoriy ravishda sozlamalar JSON-ini mustaqil ko'rib chiquvchi uchun saqlang, keyin **Yozib olishni boshlash tugmasini** bosing. Sozlamalar ish boshlangandan keyin o'zgarmas bo'ladi. Ishni davom ettirish faqat ushbu ijrochi mavjud bo'lgan paytda ishlaydi; erta yakunlash to'plangan ma'lumotlarni saqlab qoladi va bo'shliqlarni qayd etadi. Boshlashdan keyin muddat tugashi aniq qisman arxiv hosil qiladi; boshlashdan oldin muddat tugashi yoki bekor qilish arxiv hosil qilmaydi.
7. **Muxrlangan natijani** kuting, uni yuklab oling va arxivni oching, so'ng dekript qiling `delivery.tgwsealed` helper-da. Siz olasiz `delivery.zip`, ichida `evidence.zip`, `attestation.jsonl` va ko'rsatmalar. Brauzerda dekriptiya 256 MiB bilan cheklangan; kattaroq paketlar quyidagi mahalliy oqimli buyrug'dan foydalanadi. Katta natijalar shuningdek `delivery-NNNNNN.tgwsealed` bo'laklari; asosiy `delivery.tgwsealed` so'ngrani o'z ichiga oladi `evidence.parts.json` va attestasiyani o'z ichiga oladi. Har bir qismini yuklab oling va quyida tavsiflab o'tilganidek mahalliy tarzda yig'ing.
8. Agar bekor qilish tasdiqlanmagan yoki jarayon to'xtatib qo'yilgan bo'lsa, Telegram sozlamalari → Qurilmalar bo'limida vaqtinchalik sessiyani yakunlang. Oddiy yakunlash so'rovlari tizimdan chiqishni amalga oshiradi va bajarish jarayoni bekor qilish tasdiqlanganligini qayd etadi.

Repozitoriyda e'lon qilingan pinlangan manba va qayta ishlatiladigan ish jarayoni commitlari bo'lishi kerak. Faqat mahalliy filial boshqa GitHub repozitoriysi tomonidan chaqirilishi mumkin emas.

## Sessiya vaqti byudjeti

Yig'ishdan oldin **Vaqt va o'lchamni hisoblang** Xabarlar soni va chegaralangan namunaga asoslanib tanlangan tarix va fayllarni taxmin qiladi. Ko'rsatmada tizimga kirishga allaqachon sarflangan vaqt, taxminiy yig'ish vaqti va paketlash uchun zaxira ko'rsatiladi. Fayllar uchun dastlabki taxmin 1 MiB/s va ikki baravar vaqt zaxirasini qo'llaydi; jarayon davomida bu taxmin o'lchangan tezlikka almashtiriladi. Ishlatish **Faqat xabarlar** yoki taxmin qilingan vaqt qolgan vaqtdan oshsa, kamroq suhbatlarni tanlang.

Telegram'ning xabar qilingan Takeout kutish vaqti byudjetga qo'shiladi. Kollektor qolgan vaqt qadoqlash uchun kerak bo'lganda olishni to'xtatadi, olingan ma'lumotlarni saqlab qoladi va qisman natija deb belgilaydi. Shuning uchun 120 daqiqalik sessiya arxivni tayyorlashdan oldin muddatni kutish o'rniga qolgan yig'ish oynasidan foydalanadi. Ko'rsatkich to'liq hajmi namunalashtirilmagan tanlovlarni aniqlaydi.

## Ushbu rejimni yoki doimiy  tanlang

| Yozib olish rejimi | Sozlanadigan diapazon | Farq |
| --- | --- | --- |
| Telegram Takeout, standart | Barcha mavjud bulutli chatlar yoki tanlangan chatlar, sanalar, hisob toifalari, media siyosatlari va JSON/HTML ko'rinishlari | Telegramning rasmiy eksport mexanizmidan foydalanadi; tasdiqlash yoki kutish talab qilinishi mumkin. Takeout Telegram ruxsat bergan chatlardagi/guruhlardagi foydalanuvchilarni sanab o'tishi va qo'shimcha shaxsiy ma'lumotlarni so'rashi mumkin. |
| Oddiy Telegram API | Hisob doirasi va chiqish variantlari bo'yicha xuddi shunday tanlovlar, oddiy API orqali mavjud usullarga muvofiq | Takeoutni dastlabki holatga keltirmaydi; chap kanallar/superguruhlarni sanab o'tib bo'lmaydi yoki faqat Takeoutga tegishli shaxsiy ma'lumotlarni olib bo'lmaydi. Kontaktlar to'liq saqlangan telefon kontaktlari ro'yxati emas, balki Telegram foydalanuvchilarini qamrab oladi. Cheklovlar hanuz amalda. |
| Suhbat tadbiri jurnali | Tanlangan chat, ilovalar siyosati va ixtiyoriy avatarlar | Ushbu ish jarayonida kuzatilgan tarix va o'zgarishlarni qayd etadi. Hisob toifalari, sana filtrlari va ish stoli bilan mos ko'rinishlar qo'llanilmaydi. |

Uchala rejim ham bir xil GitHub tasdig'i va shifrlangan yetkazib berishga ega. Takeout ma'lumotlarni olish usulini tanlaydi va hech qachon oddiy API kirish bilan jimjit almashtirilmaydi. TgWitness qayd etilgan yozuvlardan JSON/HTML ko'rinishlarini yaratadi va eksportda tanlangan ma'lumotlarni olish usulini saqlab qoladi. [Rasmiy Takeout API](https://core.telegram.org/api/takeout) ga qarang.

Standart bo'yicha Takeout ishlatiladi, arxivlangan suhbatlar hamda barcha mavjud chat turlari, barcha sanalar, hisob profili va kontaktlar, mos keluvchi JSON va HTML, shuningdek fayllarni yuklab olish imkoniyati mavjud. Dastlabki media byudjeti 4 GiB bo'lib, har bir tur uchun ko'rinadigan fayl cheklovlari mavjud; katta hajmdagi fayllar yoki tugagan yuklab olish byudjeti mavjud bo'lgan joylarda server hashlaridan foydalanadi. Yig'ishdan oldin ushbu cheklovlarni ko'rib chiqing. Hashlar faylni qayta tiklay olmaydi. Ixtiyoriy fotosuratlar, hikoyalar, sessiya metama'lumotlari va qo'shimcha shaxsiy ma'lumotlar alohida tanlovlar bo'lib qoladi.

Takeout uchun mavjud Telegram sessiyasida tasdiq talab qilinishi mumkin. Telegram kechikishni belgilaydi; yangi kirish yoki ijrochi uni chetlab o'tmaydi. Maksimal ushlash oynasi kirish va tasdiqni o'z ichiga olgan holda 120 daqiqani tashkil etadi, shuning uchun katta hisob yoki uzoq tasdiq kutish yakunlanmasligi mumkin. Doimiy mahalliy eksport bir xil sessiyani davom ettirishi mumkin, lekin GitHub tasdig'ini meros qilib olmaydi.

### ni tasdiqlang va tekshiring

**Sozlamalar va hajmni tekshirgandan** so'ng, **tasdiqlash uchun sozlamalarni saqlashdan** foydalaning. Natijaga rozilik bildiring `sealed-export-settings.json` to'plashdan oldin ko'rib chiquvchi bilan. O'zgarishlar saqlangan baholashni bekor qiladi. Yig'uvchi amaliy sozlamalarni va ularning SHA-256 hashini imzolaydi, hisob-eksport kvitalari esa bir xil parametrlarni belgilaydi. Verifikator haqiqiy rejim, tanlov va to'liqlikni hisobot qiladi va jurnal bilan ichki hisob-eksport o'rtasidagi nomuvofiqlikni rad etadi.

```
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete
```

`--expected-selection` boshqa transport, suhbat doirasi, filtr yoki ilova siyosatini rad etadi. `--require-complete` faqat hisob eksportlari va yakunlangan deb qayd etilgan suhbat jurnallarini qabul qiladi. Ushbu bayroqlarsiz, tekshiruv baribir kelib chiqishini va yaxlitligini tekshiradi hamda qayd etilgan sozlamalar va bo'shliqlar haqida xabar beradi. Ishga tushirishdan oldin kutilayotgan tanlovni kelishib oling va uni arxivdan alohida saqlang. Doira va olish oraliklari ish jarayonida yozib olingan materialni aniqlaydi; oldingi versiyalarni solishtirishda avval saqlangan kuzatuvlardan foydalaning.

| Kerak | Rejim |
| --- | --- |
| Cheklangan sessiya davomida hisob ma'lumotlarini yoki tanlangan suhbatlarni eksport qiling va ko'rib chiquvchiga tashqi tasdiqlangan arxivni taqdim eting | GitHub Actions yozib olish (oldindan ko'rish) |
| Bir nechta suhbatlarni uzluksiz kuzating, hisoblarni boshqaring, o'sib borayotgan arxivni qidiring va o'qing | Mahalliy yoki Docker ish maydoni |

Bu yangi tizimga kirish bilan alohida yozib olishni boshlaydi. U mavjud mahalliy jurnalingizni yuklamaydi, hozirgi ochiq ish maydoningizni eksport qilmaydi yoki Telegram sessiyangizni qayta ishlatmaydi. Yakunlanmagan bulutli yozib olish uning ijrochisi yo'q qilingandan so'ng davom ettirilmaydi; yangi ish jarayoni yangi yozib olishni boshlaydi.

Ish maydonining **Eksportlar → Ochish yozib olish yordamchisi** panel ichida to'liq ustuvor oynani ochadi. Mustaqil sahifa ham xuddi shu ustuvor oynani, boshqaruv elementlarini va mavzularni ishlatadi. Ikkalasi ham kalitlarni va dekriptajni brauzeringizda saqlaydi. GitHub ish jarayoni boshlanishi va vaqtinchalik Telegram paneli alohida yorliqlarda ochiladi; ustuvor oynasi qaytib kelish vaqti haqida xabar beradi. Ish maydonini qulflash ustuvor oynaning xotiradagi kalitini tozalaydi. Saqlangan kalit faylingiz qurilmangizda qoladi.

## Nima ommaviy bo'lishi kerak va nima  qolishi kerak?

Yig'ish jarayoni standart GitHub tomonidan joylashtirilgan runner'da ishlaydi. GitHub, tasdiqlangan yig'uvchi va unga bog'liq modullar, yordamchi sahifa, brauzer va HTTPS tunneli ushbu sozlamaning ishonchli qismlari hisoblanadi. Vaqtinchalik host Telegram sessiyasini va oddiy matnli xabarlarni qayta ishlaydi; yetkazilgan artefaktlar qabul qiluvchi uchun shifrlanadi.

Fork loyiha kodini sizning omboringizga nusxa ko'chiradi. U shunday qiladi. **emas** Telegram akkauntingizni eksport qiling. Qabul qiluvchining ish jarayoni kirish qismi ommaviy shifrlash kalitidir. Saqlang `sealed-key.json`, Telegram ma'lumotlari, kirish kodlari, 2FA parollari va dekriptlangan ulanish URL manzili commitlar, ish jarayoni kirishlari va ommaviy loglardan olingan.

Ish jarayoni shifrlangan ulanish/natija artefaktlarini bir kun davomida e'lon qiladi. Ikkalasini ham o'z vaqtida yuklab oling; GitHub Actions mavjudligi, hisob cheklovlari va to'lov qoidalari tatbiq etiladi. Ochiq fork cheksiz bepul hisoblash va'dasi emas. Hech qanday to'lov yoki GitHub kirish tokeni yordamchi funksiyaga kiritilmaydi.

Shaxsiy dekripsiya kaliti brauzeringizda/faylingizda qoladi. Telegram sessiya materiali va oddiy matn kuzatuvlari majburiy ravishda vaqtinchalik yig'gich ichida mavjud bo'ladi. GitHub va HTTPS tunneli ishonchli infratuzilma bo'lib qoladi. Attestatsiya arxiv digesti va ish jarayoni identifikatorini ommaga e'lon qilishi mumkin; arxiv mazmuni attestatsiyaga joylashtirilmaydi. Attestatsiya vaqt belgisi xabar vaqt belgisi emas.

##

| Alomat | Keyingi qadam |
| --- | --- |
| Yo'q **Ish jarayonini ishga tushiring** tugma | O'zingizning forkni oching, Actions-ni yoqing va uni upstream bilan sinxronlashtiring `main`. Xatoni chetlab o'tish uchun tasdiqlangan upstream pinlarni tahrirlamang. |
| Yo'q `sealed-connection` yodgorlik | Ishning ishga tushirish/yuqlatish bosqichi boshlangan va yakunlanganligini tekshiring. Navbat, ijrochi, tasvirni yuklab olish, tunnel yoki ombor siyosati xatolari ishga tushirishni oldini olishi mumkin. |
| Ulanishni ochib bo'lmayapti | Ushbu ish uchun saqlangan kalitni yuklang, yuklab olingan artefaktni arxivdan chiqarib, tanlang `connection.tgwsealed`. Ijrochi hanuz faol bo'lishi kerak. |
| Tarix to'xtatildi | Paneldagi holatni tekshiring va sessiya faol bo'lgan paytda Resume tugmasidan foydalaning yoki allaqachon yig'ilgan ma'lumotlar bilan yakunlang. Telegram cheklovlari va kirib bo'lmaydigan kontent bo'shliqlar qoldirishi mumkin. |
| Yo'q `sealed-result` | Yig'ishni boshlashdan oldin bekor qilish yoki muddatining tugashi arxiv hosil qilmaydi; jarayon **Arxiv yo'q** xabari bilan yakunlanadi. Muvaffaqiyatsiz yig'ish, tasdiqlash yoki qadoqlash bosqichi ham yetkazib berishni to'xtatadi; muvaffaqiyatsiz bosqich rahbarning sababini shaxsiy ma'lumotlarsiz ko'rsatadi. Kirish ma'lumotlarini kiritmasdan tekshiring. |
| Brauzer katta arxivni dekript qila olmaydi | 256 MiB dan katta paketlar uchun quyidagi streaming CLI-dan foydalaning. Noto'g'ri yoki yo'qolgan shaxsiy kalit natijani dekript qila olmaydi. |
| Verifikatsiya imzo qo'yuvchini rad etadi | Ishonchli, hozirgi TgWitness o'rnatilmasidan va aniq qo'ng'iroq qiluvchidan foydalaning `OWNER/REPOSITORY`Arxiv bilan birga taqdim etilgan almashtirish siyosatini qabul qilmang. |
| Telegram hanuzgacha vaqtinchalik sessiyani ro'yxatda ko'rsatmoqda. | Buni Sozlamalar → Qurilmalar bo'limida yakunlang. Chiqish muvaffaqiyatsiz bo'lishi mumkin va majburan to'xtatilgan ish jarayoni tozalashni bajarmasligi mumkin. |

Ushbu ko'rinishga tayanishdan oldin, o'zingiz nazorat qiladigan kichik suhbatni sinab ko'ring: xabar va ilova yarating, ularni to'plang, natijani dekript qiling, verifikatorni ishga tushiring, qamrov/media natijalarini tekshiring va Telegram sessiyasining bekor qilinganini tasdiqlang. Avtomatlashtirilgan tekshiruvlar sun'iy Telegram-klient hamda alohida haqiqiy GitHub sertifikatini sinovdan o'tkazishni ishlatadi; joriy tahrirda hech qanday jonli hisob qaydnomasi ishga tushirilgani qayd etilmagan.

## Mahalliy dekriptirovka va

Noma'lum manba arxividan taqdim etilgan ijro etiladigan fayllar emas, balki mustaqil ishonchli manbadan olingan vositalardan foydalaning:

```
python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip
# Unzip delivery.zip using your archive manager, then:
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
```

Ko'p qismli yetkazib berish uchun avvalo asosiy paketni dekript qiling va undan olingan manifestni har bir shifrlangan qism yonida saqlang, so'ngra quyidagini bajaring:

```
python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip
python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
```

Manifest tasdiqlangan mavzu bo'lib, har bir qism va yig'ilgan ZIP-ni bog'laydi. Foydalaning `--max-gib` katta arxiv uchun mos siqilmagan tekshiruv chegarasini o'rnatish uchun; o'rnatilgan qiymat 4 GiB. Expected-selection va complete-scope tekshiruvlari shuningdek ko'p bo'limli yetkazib berish bilan ham ishlaydi.

Python 3.11+, loyiha bog'liqliklari va uni qo'llab-quvvatlaydigan so'nggi GitHub CLI `--signer-digest` va `--deny-self-hosted-runners` talab etiladi. CLI kalit generatori ham mavjud: `python -m tgwitness.sealed_crypto keygen sealed-key.json`.

Verifikator quyidagilarni ishlatadi `tgwitness/sealed_policy.json` ishonchli o'rnatish manbasidan foydalanadi. U chaqiruvchi omborni, yuqori bosqichdagi imzolovchi ish jarayonini, tasdiqlangan imzolovchi commitini, mezbon ijrochining talabini, to'liq ZIP digesti, ichki jurnal va ilovaning yaxlitligini, yangi hisob-kalit kelib chiqishini va kutilayotgan yig'uvchi commitini tekshiradi. U barcha ma'lumotlar saqlangan deb ishora qilish o'rniga tarix va media natijalarini ko'rsatadi. Ma'qullangan-chiqarishlar ro'yxatining bo'sh bo'lishi muvaffaqiyatsiz yakunlanadi. Siyosatni yangilash aniq ishonch qaroridir; arxivning o'zi taklif qilgan siyosatni hech qachon avtomatik qabul qilmang.

Oflayn foydalanish uchun ishonchli ildizlarni oldindan ishonchli muhitdan oling:

```
gh attestation trusted-root > trusted_root.jsonl
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl
```

Tasdiqning vaqt stempsi arxivning majburiyatini bildiradi. U xabar vaqt stempelari yoki yig'uvchining devor soatini tasdiqlamaydi. [GitHubning tasdiqlash variantlariga](https://cli.github.com/manual/gh_attestation_verify) qarang.

## Forkani qanday qilib ushlash  tashqarida saqlash

Chaqiruvchi upstream qayta ishlatiladigan ish jarayoni uchun ish darajasidagi havolani to'liq commit SHA bo'yicha o'z ichiga oladi. Ushbu ish jarayoni aniq **belgilangan collector SHA bo'yicha upstream omborini** chiqaradi. Standart `actions/checkout` qayta ishlatiladigan ish oqimida chaqiruvchini chiqarib oladi va ataylab ishlatilmaydi.

Ish jarayoni chaqiruvchi keshlarini tiklamaydi, chaqiruvchi artefaktlarini iste'mol qilmaydi, chaqiruvchi fayllarni ijro etmaydi yoki manba/tasvir URL manzillarini, shell buyruqlarini, tayyorlangan ZIP fayllarni yoki imzolash uchun hashlarni qabul qilmaydi. U chegaralangan ommaviy qabul qiluvchi va sessiya davomiyligini qabul qiladi. Actionlar, Python asosiy tasviri va cloudflared o'zgarmas digestlar bilan mahkamlanadi; Python bog'liqliklari mavjud hash-lockli talablarni ishlatadi. Tasvir ishonchli manbadan keshsiz quriladi.

Kollektor root bo'lmagan foydalanuvchi sifatida, faqat o'qish uchun mo'ljallangan image, Linux imtiyozlari bekor qilingan, resurslar chegaralangan va Docker soketi yoki GitHub-token muhitisiz ishlaydi. Uning yagona bog'lanadigan kataloglari yangi konfiguratsiya, ish maydoni va chiqish kataloglaridir. Cheklangan FastAPI ilovasi tizimga kirish, dialoglar, sozlanadigan hisob yoki chat to'plami, holat, davom ettirish, yakunlash va bekor qilish imkoniyatlarini taqdim etadi. Ochiq matnda yuklab olish marshruti, umumiy boshqaruv marshruti, import marshruti yoki imzolash endpointi mavjud emas.

Nazoratchi attest harakatidan oldin tarmoqqa qaragan konteynerlarni to'xtatadi oxirgi belgilangan qiymatni o'qiydi `evidence.zip` yoki `evidence.parts.json`. Qadoqlash konteynerida tarmoq yo'q. Yuklash bosqichlari nomi faqat `connection.tgwsealed` va `delivery*.tgwsealed`; na oddiy matnli dalillar, na Telegram ma'lumotlari artefakt sifatida yuklanmaydi. Tozalash shaxsiy papkalar va konteynerlarni o'chirib tashlaydi, va GitHub ish tugagach joylashtirilgan runner VM'ni bekor qiladi. Artefaktlar saqlash muddati bir kun; muddat tugashidan oldin yuklab oling.

Forkning egasi chaqiruvchini almashtirishi yoki boshqa imzolangan fayl yaratishi mumkin. Qat'iy tekshiruvchi natijada hosil bo'lgan **boshqa imzolovchi ish jarayoni/digestni** rad etishi kerak. Ushbu tuzilma hali ham tasdiqlangan kodda foydalanish mumkin bo'lgan xatolar yo'qligiga va GitHubning ijro etuvchi hamda imzolash infratuzilmasining yaxlitligiga bog'liq.

## Kriptografik

Har bir qabul qiluvchi kaliti RSA-3072 (RSA-4096 importi ham qabul qilinadi), eksponent 65537. Har bir konvertda yangi tasodifiy AES-256 kaliti va 96 bitli nonse bor. RSA-OAEP SHA-256/MGF1-SHA256 bilan AES kalitini o'rab chiqadi. AES-GCM 128 bitli teg bilan to'liq prefiks va yuklamani autentifikatsiya qiladi. Ochiq kalit DER SPKI bo'lib, base64 formatida; xususiy kalit faylida esa DER PKCS8 base64 formatida mavjud.

Envelope baytlari `TGWSEAL1\n`, big-endian uint32 JSON-sarlavha uzunligi, sarlavha, shifrmatn va 16 baytli GCM teg. Sarlavha aniq `algorithm`, `key`, va `nonce`; algoritm `RSA-OAEP-256+A256GCM`. To'liq prefiksdan headerigacha bo'lgan qism GCM qo'shimcha autentifikatsiyalangan ma'lumotdir. Header hajmi 8192 baytgacha cheklangan. CLI 8 GiB gacha bo'lgan yuklamalarni uzatadi va so'ralgan natijani o'rnatishdan oldin autentifikatsiya qiladi; u mavjud manzilni ustiga yozishni rad etadi. Bu standart kriptografik primitivlarga loyiha uchun maxsus o'ralgan qobiq: OpenSSL va har bir yirik kriptografiya kutubxonasida mavjud bo'lgan SHA-256 bilan RSA-OAEP va AES-256-GCM.

Asl dalil baytlari dalil va tasdiqni shifrlangan tashqi paketga joylashtirishdan **oldin** tasdiqlanadi. Bu arxivning xeshiga va shu arxiv ichiga kiritilgan sertifikat o'rtasidagi aylanma bog'liqlikni oldini oladi. Ochiq omborlar uchun tasdiq metadata (ombor, ish jarayoni, commit, artefakt nomi va digest) ommaviydir. Hech qachon suhbat nomlarini ommaviy metadatalarga kiritmang.

## Doira va

Ushbu rejim imzolangan jurnal va hisob-eksport dvigatelidan foydalanadi. Maxfiy suhbatlar, yig'ishdan oldingi o'chirilgan tarix va hisobga kirib bo'lmaydigan ma'lumotlar chiqarib tashlanadi. Tanlanganida shaxsiy bulut suhbatlari ham mos keladi. Suhbat tanlovchisi 20 000 dialog bilan cheklangan; hisob eksporti o'z inventarizatsiyasini aniqlaydi. Yetishmayotgan ma'lumotlar, muvaffaqiyatsiz fayllar va tugallanmagan vazifalar qayd etiladi. Ilova cheklovlari va ijrochining disk/vaqt cheklovlari hanuz amalda bo'ladi. Katta hajmdagi yetkazib berish 4 GiB doimiy yetkazib berish chegarasi o'rniga shifrlangan bo'laklardan foydalanadi. Yakunlash sovutilgan tanlangan vazifalarning tugaganini anglatadi, har bir tarixiy Telegram yozuvi arxivda mavjudligini emas. Suhbat jurnali jonli yangilanishlarni ham kuzatishi mumkin; hech bir rejim atomik snapshot emas. Yarilgan skrinshotlar va ekran yozuvlari ushbu rejimga kirmaydi.

Sinovlar sun'iy yangi kirish, doiraviy izolyatsiya, media, bekor qilish, qisman muddatni bajarish, muvaffaqiyatsiz chiqish, taqiqlangan API yo'llari va maydonlari, oldindan yuklangan ish maydoni rad etilishi, noto'g'ri kalit va aralashuv rad etilishi, zarur tasdiqlovchi bayroqlar hamda brauzer/Python shifrlash o'zaro mosligini qamrab oladi. Brauzer qabul qilish testi oddiy yorliqli soxta tasdiqdan foydalanadi; bu haqiqiy Sigstore testi emas. Haqiqiy hosted-runner, Docker, GitHub tasdiqlovi va jonli Telegram qabul qilish sinovlari mahalliy sintetik tekshiruvlardan alohida hisobot qilinishi kerak.

[GitHub Actions shartlari](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) joylashtirilgan ijrochilarning foydalanilishini dasturiy ta'minot loyihasining hayotiy tsiklida cheklaydi. Fork ushbu cheklovlarni olib tashlamaydi; bu ko'rinishni cheklovsiz bepul ishlab chiqarish hostingi sifatida targ'ib qilish mumkin emas. [Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) ham sinov va rivojlantirish uchun mo'ljallangan. Helper/workflows ushbu xususiyatni baholash uchun mos keladi; ishlab chiqarish xizmatiga moslik esa alohida joylashtirish talabi bo'lib qoladi.

## Saqlovchi reliz ketma-ketligi

1. Yig'uvchi, nazoratchi va konteyner ta'riflari hamda testlarini bajaring va ko'rib chiqing.
2. O'sha collector commitni `sealed-collector.yml`, so'ngra qayta ishlatiladigan ish jarayonini commit/review qiling. Hech qachon chaqiruvchining SHA-sidan jimicha checkout olmang.
3. Qayta ishlatiladigan ish jarayoni commitini belgilash `sealed-witness.yml` va uning workflow/collector SHA juftligini qo'shing `sealed_policy.json` ishonchli relizga qo'shing.
4. Barcha havola qilingan commitlarni va yordamchi commitni e'lon qiling, so'ng mustaqil fork va haqiqiy GitHub sertifikatini sinab ko'ring. Ushbu pinlar tomonidan havola qilingan commitlarni, agar havolalar qayta hosil qilinib yana e'lon qilinmaguncha, squash qilmang.

[Qayta ishlatiladigan ish jarayonlari va tasdiqnomalarni](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) ko'ring, chaqiruvchi ombor bilan yuqori bosqichdagi imzolovchi o'rtasidagi farqni aniqlash uchun.
