Dokumentatsiya / 02
Telegram · GitHub Actions yozib oladi
Vaqtinchalik GitHub runner’da Takeout, oddiy API eksporti yoki chat jurnalini tanlang.
To'liq manba
TgWitness / Hujjatlash · Mustaqil ushlash
maindan 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 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
- Sessiya vaqti byudjeti
- Ushbu rejimni yoki doimiy ish maydonini tanlang
- Nima ommaviy bo'lishi kerak va nima xususiy qolishi kerak
- Muammolarni bartaraf etish
- Mahalliy dekriptirovka va tasdiqlash
- Cho'qqi qanday qilib ushlash jarayonidan tashqarida saqlanadi
- Kriptografik topshirish
- Doira va tasdiqlash
- Saqlovchi reliz ketma-ketligi
Foydalanuvchi oqimi
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.
- 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 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. - 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.
- 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.
- Ijro vaqtida Artifacts-dan sealed-connection-ni yuklab oling va uni arxivdan chiqarib oling.
Yuklang
connection.tgwsealedHelperda 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. - 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_idvaapi_hashmy.telegram.org/apps saytidan 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. - 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.
- Muxrlangan natijani kuting, uni yuklab oling va arxivni oching, so'ng dekript qiling
delivery.tgwsealedhelper-da. Siz olasizdelivery.zip, ichidaevidence.zip,attestation.jsonlva ko'rsatmalar. Brauzerda dekriptiya 256 MiB bilan cheklangan; kattaroq paketlar quyidagi mahalliy oqimli buyrug'dan foydalanadi. Katta natijalar shuningdekdelivery-NNNNNN.tgwsealedbo'laklari; asosiydelivery.tgwsealedso'ngrani o'z ichiga oladievidence.parts.jsonva attestasiyani o'z ichiga oladi. Har bir qismini yuklab oling va quyida tavsiflab o'tilganidek mahalliy tarzda yig'ing. - 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 ish maydonini 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 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.
Sozlamalarni 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 xususiy 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.
Muammolarni bartaraf etish
| 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/REPOSITORYArxiv 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 tasdiqlash
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 qarang.
Forkani qanday qilib ushlash jarayonidan 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 topshirish
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 tasdiqlash
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 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 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#
- Yig'uvchi, nazoratchi va konteyner ta'riflari hamda testlarini bajaring va ko'rib chiqing.
- O'sha collector commitni
sealed-collector.yml, so'ngra qayta ishlatiladigan ish jarayonini commit/review qiling. Hech qachon chaqiruvchining SHA-sidan jimicha checkout olmang. - Qayta ishlatiladigan ish jarayoni commitini belgilash
sealed-witness.ymlva uning workflow/collector SHA juftligini qo'shingsealed_policy.jsonishonchli relizga qo'shing. - 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 ko'ring, chaqiruvchi ombor bilan yuqori bosqichdagi imzolovchi o'rtasidagi farqni aniqlash uchun.