# Telegram · GitHub Actions ضبط می‌کند

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

Takeout, خروجی با API معمولی یا گزارش یک گفتگو را روی اجراکننده موقت GitHub انتخاب کنید.

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

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

Takeout, خروجی با API معمولی یا گزارش یک گفتگو را روی اجراکننده موقت GitHub انتخاب کنید.

جاوااسکریپت را فعال کنید تا یک کلید تولید شود و آرشیو خود را رمزگشایی کنید.

**مرجع کامل**

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [بازداشت مستقل](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)

![دستگیری مستقل](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b)

**پیش‌نمایش از `main` در دسترس است.** یک فورک یک جریان کاری قابل استفاده مجدد سنجاق‌شده را از `phishdestroy/TgWitness`. این گردش کار با استفاده از یک جلسه تلگرام تازه‌ساخت، یک حساب کاربری، چت‌های منتخب یا دفتر وقایع یک چت را صادر می‌کند، مدرک ZIP یا مانیفست چندبخشی را تصدیق می‌کند و تنها هاندآف‌های رمزگذاری‌شده برای دریافت‌کننده را بارگذاری می‌کند. پنل مدیریت عادی در معرض دید قرار نمی‌گیرد.

انتخاب کنید `client=official_web` برای اجرای [witness کلاینت رسمی](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) با کنترل‌های وب تلگرام محافظت‌شده و ویدئو. این نیازمند پروکسی بالادستی خودتان است و یک چت رندر شده را مشاهده می‌کند. پیش‌فرض `client=api` حالت‌های خروجی‌گیری کامل حساب کاربری را که در زیر توضیح داده شده‌اند، حفظ می‌کند.

تأییدکننده، آرشیو را با تأییدیه گیت‌هاب، گردش کار تأییدشده و کامیت‌های گردآورنده، و همچنین هش‌های امضا شده ژورنال و پیوست، بررسی می‌کند. فرآیند جمع‌آوری از کد بالادست پین‌شده و فضای ذخیره‌سازی جدید استفاده می‌کند. یک بازبین می‌تواند آن کد را بررسی کرده و آرشیو تحویل‌شده را با اجرای ثبت‌شده آن تأیید کند.

**در این صفحه**

- [جریان کاربر](https://phishdestroy.io/tgwitness/fa/docs/capture/#user-flow)
- [بودجه زمانی جلسه](https://phishdestroy.io/tgwitness/fa/docs/capture/#session-time-budget)
- [این حالت یا یک فضای کاری پایدار را انتخاب کنید](https://phishdestroy.io/tgwitness/fa/docs/capture/#choose-this-mode-or-a-persistent-workspace)
- [چه چیزی عمومی است و چه چیزی باید خصوصی بماند](https://phishdestroy.io/tgwitness/fa/docs/capture/#what-is-public-and-what-must-stay-private)
- [عیب‌یابی](https://phishdestroy.io/tgwitness/fa/docs/capture/#troubleshooting)
- [رمزگشایی و تأیید محلی](https://phishdestroy.io/tgwitness/fa/docs/capture/#local-decryption-and-verification)
- [چگونه چنگال خارج از فرآیند ضبط نگه داشته می‌شود](https://phishdestroy.io/tgwitness/fa/docs/capture/#how-the-fork-is-kept-outside-the-capture-process)
- [واگذاری رمزنگاری‌شده](https://phishdestroy.io/tgwitness/fa/docs/capture/#cryptographic-handoff)
- [دامنه و اعتبارسنجی](https://phishdestroy.io/tgwitness/fa/docs/capture/#scope-and-validation)
- [ترتیب انتشار نگه‌دارنده](https://phishdestroy.io/tgwitness/fa/docs/capture/#maintainer-release-sequence)

## کاربر#

کمک‌کننده پنج مرحله را توضیح می‌دهد و به شما اجازه می‌دهد جایگزینی پیام یا گردآورنده را روی داده‌های نمونه امتحان کنید. **شروع ضبط من** ویزارد را باز می‌کند.

1. **گزینه ضبط GitHub Actions را** در صفحه اصلی پروژه، صفحه ورود به محیط کاری، یا از مسیر **Exports → Open capture helper** انتخاب کنید. همچنین می‌توانید ابزار [کمکی رسمی](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) یا `tgwitness/static/capture.html` را از یک چک‌آوت معتبر در یک مرورگر مدرن باز کنید. این ابزار کمکی برای پردازش کلید یا فایل، هیچ درخواست شبکه‌ای انجام نمی‌دهد. این ابزار از زبان‌های رابط کاربری سایت پشتیبانی می‌کند؛ پنل جمع‌آوری موقت از زبان‌های انگلیسی و روسی پشتیبانی می‌کند و در صورتی که زبان مرورگر یکی از این زبان‌ها باشد، به آن زبان باز می‌شود.
2. یک کلید ایجاد کرده و ذخیره کنید **کلید-مهرشده.json**. این تنها کلید خصوصی رمزگشایی است. کلید عمومی جداگانه را کپی کنید **گیرنده** ارزش. از دست دادن کلید خصوصی، دسترسی به هر دو اتصال و آرشیو را از بین می‌برد. تأیید کنید که آن را ذخیره کرده‌اید تا مرحله بعدی را باز کنید. اگر از قبل یک فایل تحویل دارید، کلید ذخیره شده را بارگذاری کرده و انتخاب کنید **من قبلاً یک آرشیو دارم**.
3. فork TgWitness را انجام دهید، Actions را در fork فعال کنید و **Sealed chat capture** را اجرا کنید. گیرنده عمومی را الصاق کنید و ۳۰، ۶۰ یا ۱۲۰ دقیقه را انتخاب کنید. هرگز شماره تلفن، کد ورود، رمز عبور تلگرام، کلید خصوصی یا session را در ورودی‌های workflow، commits، issues یا logs قرار ندهید.
4. در حین اجرا، بسته**ٔ sealed-connection را** از Artifacts دانلود کرده و آن را از حالت فشرده خارج کنید. بارگذاری `connection.tgwsealed` در ابزار کمکی، با استفاده از کلید خصوصی ذخیره شده. پیوند حاصل شامل یک رمز دسترسی تصادفی در بخش URL آن است. این لینک را خصوصی نگه دارید. پنل بخش را حذف کرده و رمز را در ذخیره‌سازی جلسه این زبانه نگه می‌دارد؛ این رمز در گزارش‌های دسترسی HTTP ثبت نمی‌شود.
5. لینک اتصال را باز کنید. با کد QR یا با شماره تلفن و کد ورود وارد شوید. اگر تلگرام از شما خواست، رمز عبور احراز هویت دو مرحله‌ای خود را وارد کنید. مخزن اعتبارنامه‌های داخلی API به‌طور پیش‌فرض استفاده می‌شود، درست مانند فضای کاری عادی. می‌توانید بخش اعتبارنامه‌های سفارشی اختیاری را گسترش دهید و هر دو را وارد کنید. `api_id` و `api_hash` از [my.telegram.org/apps](https://my.telegram.org/apps). برای استفاده از مخزن داخلی، هر دو فیلد را خالی بگذارید؛ جفت جزئی یا نامعتبر رد می‌شود. وارد کردن جلسات (Session imports) مجاز نیست. حالت و دامنه خروجی را انتخاب کنید. لینک اتصال حاوی یک رمز دسترسی است: آن را خصوصی نگه دارید.
6. انتخاب کن **تلگرام تیک‌آوت**, **API معمولی تلگرام** یا **دفترچه خاطرات رویداد چت**برای خروجی‌گیری حساب، تمام چت‌های در دسترس را انتخاب کنید یا آن‌ها را بارگذاری کرده و یک یا چند چت را برگزینید، سپس تاریخ‌ها، انواع چت، دسته‌بندی‌های حساب و قوانین پیوست را تنظیم کنید. تنظیمات و اندازه را بررسی کنید، در صورت تمایل فایل JSON تنظیمات را برای یک بازبین مستقل ذخیره کنید، سپس فشار دهید. **شروع ضبط**. تنظیمات پس از شروع، ثابت هستند. ادامه کار تنها زمانی که این راनर وجود دارد انجام می‌شود؛ پایان زودهنگام، داده‌های به‌دست‌آمده را حفظ کرده و فاصله‌ها را ثبت می‌کند. انقضای مهلت پس از شروع، یک آرشیو صریحاً ناقص تولید می‌کند؛ انقضا پیش از شروع یا لغو، هیچ آرشیوی تولید نمی‌کند.
7. منتظر **نتیجهٔ مهر و موم‌شده** بمانید، آن را دانلود و از حالت فشرده خارج کنید و رمزگذاری‌شده را رمزگشایی کنید `delivery.tgwsealed` در helper. شما دریافت می‌کنید `delivery.zip`، شامل `evidence.zip`, `attestation.jsonl`، و دستورالعمل‌ها. رمزگشایی مرورگر محدود به ۲۵۶ مگابایت است؛ بسته‌های بزرگ‌تر از دستور محلی پخش زیر استفاده می‌کنند. نتایج بزرگ همچنین شامل `delivery-NNNNNN.tgwsealed` بخشی؛ بخش اصلی `delivery.tgwsealed` سپس حاوی است `evidence.parts.json` و گواهی. هر قسمت را دانلود کرده و همان‌طور که در زیر توضیح داده شده، به‌صورت محلی مونتاژ کنید.
8. اگر لغو تأیید نشده باشد یا اجرای برنامه متوقف شده باشد، جلسهٔ موقت را در تنظیمات تلگرام → دستگاه‌ها پایان دهید. درخواست‌های عادی تکمیل، خروج را ثبت می‌کنند و اجرای برنامه ثبت می‌کند که آیا لغو تأیید شده است یا خیر.

مخزن باید شامل منبع پین‌شده منتشرشده و کامیت‌های جریان‌کار قابل‌استفاده مجدد باشد. یک شاخه محلی به‌تنهایی نمی‌تواند توسط مخزن دیگری در گیت‌هاب فراخوانی شود.

## زمانی جلسه#

قبل از جمع‌آوری **زمان و اندازه را محاسبه کنید** تخمین می‌زند تاریخچه و فایل‌های انتخاب‌شده را از روی تعداد پیام‌ها و یک نمونه محدود. نمایش شامل زمان صرف‌شده برای ورود، زمان تخمینی جمع‌آوری و یک ذخیره برای بسته‌بندی است. برای فایل‌ها، تخمین اولیه از سرعت ۱ مگابایت بر ثانیه و ضریب زمانی دو برابر استفاده می‌کند؛ پیشرفت این فرض را با نرخ اندازه‌گیری‌شده جایگزین می‌کند. استفاده **فقط پیام‌ها** یا وقتی برآورد از زمان باقی‌مانده بیشتر شد، چت‌های کمتری را انتخاب کنید.

زمان انتظار گزارش‌شده برای Takeout تلگرام به بودجه اضافه می‌شود. گردآورنده هنگامی که زمان باقی‌مانده برای بسته‌بندی مورد نیاز است، فرآیند گردآوری را متوقف می‌کند، داده‌های گردآوری‌شده را حفظ کرده و یک نتیجه جزئی را علامت‌گذاری می‌کند. بنابراین، یک جلسه ۱۲۰ دقیقه‌ای به جای انتظار برای مهلت نهایی، از پنجره گردآوری باقی‌مانده خود استفاده می‌کند. این نمایش، انتخاب‌هایی را شناسایی می‌کند که امکان نمونه‌برداری از اندازه کامل آن‌ها وجود نداشته است.

## این حالت یا یک فضای کاری پایدار را انتخاب کنید

| حالت ثبت | دامنه قابل پیکربندی | تفاوت |
| --- | --- | --- |
| تلگرام تیک‌آوت، پیش‌فرض | تمام چت‌های ابری قابل دسترسی یا چت‌های منتخب، تاریخ‌ها، دسته‌بندی‌های حساب، سیاست‌های رسانه‌ای و نماهای JSON/HTML | از مکانیزم رسمی خروجی تلگرام استفاده می‌کند؛ ممکن است نیاز به تأیید یا انتظار باشد. Takeout می‌تواند فهرست کانال‌ها/گروه‌های در دسترس را که تلگرام اجازه می‌دهد، استخراج کرده و درخواست داده‌های شخصی بیشتری نماید. |
| API معمولی تلگرام | همان دامنه حساب و گزینه‌های خروجی، مشروط به روش‌های موجود از طریق API معمولی | Takeout را راه‌اندازی نمی‌کند؛ نمی‌توانید کانال‌ها/ابرگروه‌های سمت چپ را فهرست کنید یا داده‌های شخصی اختصاصی Takeout را بازیابی کنید. مخاطبین به جای کل فهرست تماس‌های تلفنی ذخیره شده، کاربران تلگرام را پوشش می‌دهند. محدودیت‌های نرخ همچنان اعمال می‌شوند. |
| دفترچه خاطرات رویداد چت | یک گفتگوی منتخب، سیاست‌های پیوست و آواتارهای اختیاری | تاریخ و تغییرات مشاهده‌شده در طول این اجرا را ثبت می‌کند. دسته‌بندی‌های حساب، فیلترهای تاریخ و نماهای سازگار با دسکتاپ اعمال نمی‌شوند. |

هر سه حالت دارای تأیید هویت گیت‌هاب و تحویل رمزگذاری‌شده یکسان هستند. Takeout روش دریافت را انتخاب می‌کند و هرگز به‌طور بی‌سروصدا توسط دسترسی معمولی به API جایگزین نمی‌شود. TgWitness ویوهای JSON/HTML را از رکوردهای ضبط‌شده تولید می‌کند و روش دریافت انتخاب‌شده را در خروجی حفظ می‌کند. به [API رسمی Takeout](https://core.telegram.org/api/takeout) مراجعه کنید.

پیش‌فرض‌ها از Takeout استفاده می‌کنند، شامل تمام انواع چت‌های قابل دسترسی از جمله چت‌های بایگانی‌شده، تمام تاریخ‌ها، پروفایل حساب کاربری و مخاطبین، JSON و HTML سازگار، و دانلود فایل‌ها. بودجه اولیه رسانه ۴ گیگابایت است، با محدودیت‌های قابل مشاهده برای هر نوع فایل؛ فایل‌های بزرگ‌تر یا بودجه‌های دانلود اتمام‌شده در صورت امکان از هش‌های سرور استفاده می‌کنند. پیش از جمع‌آوری، این محدودیت‌ها را بررسی کنید. هش‌ها نمی‌توانند یک فایل را بازسازی کنند. عکس‌های اختیاری، استوری‌ها، متادیتای جلسه و داده‌های شخصی اضافی همچنان گزینه‌های جداگانه‌ای باقی می‌مانند.

خروجی گرفتن ممکن است در یک جلسه تلگرام موجود نیاز به تأیید داشته باشد. تلگرام تأخیر را تعیین می‌کند؛ ورود مجدد یا اجرای جدید آن را دور نمی‌زند. حداکثر بازه زمانی ضبط ۱۲۰ دقیقه است که شامل ورود و تأیید می‌شود، بنابراین یک حساب بزرگ یا انتظار طولانی برای تأیید ممکن است به پایان نرسد. یک خروجی‌گیری محلی پایدار می‌تواند همان جلسه را از سر گیرد، اما اعتبارسنجی گیت‌هاب را به ارث نمی‌برد.

### توافق کنید و تنظیمات را تأیید کنید

پس از **بررسی تنظیمات و اندازه**، از **«ذخیره تنظیمات برای تأیید**» استفاده کنید. با نتیجه موافقت کنید `sealed-export-settings.json` با بازبین قبل از جمع‌آوری. تغییرات، ارزیابی ذخیره شده را باطل می‌کنند. گردآورنده تنظیمات مؤثر و SHA-256 آن‌ها را امضا می‌کند، و رسیدهای صادرشده از حساب، همان گزینه‌ها را الزام می‌کنند. تأییدکننده، حالت، انتخاب و کامل بودن واقعی را گزارش می‌دهد و هرگونه اختلاف بین ژورنال و خروجی حساب تودرتو را رد می‌کند.

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

`--expected-selection` یک حمل‌ونقل، دامنه چت، فیلتر یا سیاست پیوست متفاوت را رد می‌کند. `--require-complete` فقط خروجی‌های حساب کاربری و گزارش‌های گفتگو را که به‌عنوان کامل ثبت شده‌اند، می‌پذیرد. بدون این پرچم‌ها، اعتبارسنجی همچنان منشأ و یکپارچگی را بررسی می‌کند و در عین حال تنظیمات ثبت‌شده و شکاف‌ها را گزارش می‌دهد. پیش از اجرای عملیات، روی انتخاب مورد انتظار توافق کنید و آن را به‌طور جداگانه از آرشیو نگهداری کنید. دامنه و فواصل برداشت، مواد ضبط‌شده در طول اجرای عملیات را مشخص می‌کنند؛ هنگام مقایسه نسخه‌های قبلی از مشاهدات قبلی نگهداری‌شده استفاده کنید.

| نیاز | حالت |
| --- | --- |
| داده‌های حساب قابل دسترسی یا چت‌های منتخب را در یک جلسه محدود صادر کرده و یک آرشیو تصدیق‌شدهٔ خارجی در اختیار بازبین قرار دهید. | سنجاق‌کردن اِکشن‌های گیت‌هاب (پیش‌نمایش) |
| چندین چت را به‌طور مداوم مشاهده کنید، حساب‌ها را مدیریت کنید، در آرشیوی رو به رشد جستجو و مطالعه کنید. | محیط کاری محلی یا داکر |

این کار یک ضبط جداگانه را با یک ورود جدید آغاز می‌کند. این کار ژورنال محلی موجود شما را آپلود نمی‌کند، فضای کاری باز فعلی را صادر (export) نمی‌کند، یا از جلسه تلگرام آن استفاده مجدد نمی‌کند. یک ضبط ابری ناتمام پس از از بین رفتن اجرای‌کننده‌اش (runner) نمی‌تواند از سر گرفته شود؛ یک گردش کار جدید، یک ضبط جدید را آغاز می‌کند.

گزینه **Exports → Open capture helper** فضای کاری، ویزارد کامل را در داخل پنل باز می‌کند. صفحه مستقل از همان ویزارد، کنترل‌ها و تم‌ها استفاده می‌کند. هر دو، کلیدها و رمزگشایی را در مرورگر شما نگه می‌دارند. گردش کار گیت‌هاب و پنل موقت تلگرام در زبانه‌های جداگانه باز می‌شوند؛ ویزارد به شما می‌گوید چه زمانی باید بازگردید. قفل کردن فضای کاری، کلید موجود در حافظه ویزارد را پاک می‌کند. فایل کلید ذخیره شده شما روی دستگاهتان باقی می‌ماند.

## چه چیزی عمومی است و چه چیزی باید خصوصی بماند

مجموعه روی یک رانر استاندارد میزبانی‌شده توسط گیت‌هاب اجرا می‌شود. گیت‌هاب، گردآورنده تأییدشده، وابستگی‌ها، صفحه کمکی، مرورگر و تونل HTTPS بخش‌های مورد اعتماد این پیکربندی هستند. میزبان موقت جلسه تلگرام و پیام‌های متن ساده را پردازش می‌کند؛ آرتفکت‌های تحویل‌شده برای گیرنده رمزگذاری می‌شوند.

فورک کردن، کد پروژه را به مخزن شما کپی می‌کند. این کار را انجام می‌دهد. **نه** حساب تلگرام خود را صادر کنید. ورودی جریان کاری گیرنده یک کلید رمزگذاری عمومی است. حفظ کنید `sealed-key.json`، اعتبارنامه‌های تلگرام، کدهای ورود، رمزهای احراز هویت دو مرحله‌ای و URL اتصال رمزگشایی‌شده از کامیت‌ها، ورودی‌های گردش کار و لاگ‌های عمومی.

جریان کاری، آرتفکت‌های اتصال/نتیجه رمزگذاری‌شده را برای یک روز منتشر می‌کند. هر دو را به‌موقع دانلود کنید؛ محدودیت‌های حساب کاربری و صورت‌حساب GitHub Actions اعمال می‌شوند. یک فورک عمومی، وعده‌ای برای محاسبات نامحدود و رایگان نیست. هیچ پرداختی یا توکن دسترسی GitHub در این ابزار کمکی وارد نمی‌شود.

کلید رمزگشایی خصوصی در مرورگر/فایل شما باقی می‌ماند. محتوای جلسه تلگرام و مشاهدات متن ساده لزوماً در داخل گردآورنده موقت وجود دارند. گیت‌هاب و تونل HTTPS به عنوان زیرساخت مورد اعتماد باقی می‌مانند. تأییدیه ممکن است هش آرشیو و هویت گردش کار را عمومی کند؛ محتوای آرشیو در تأییدیه قرار نمی‌گیرد. مهر زمانی تأییدیه، مهر زمانی پیام نیست.

##

| نشانه | مرحله بعدی |
| --- | --- |
| خیر **اجرای گردش کار** دکمه | فورک خود را باز کنید، Actions را فعال کنید و آن را با upstream همگام‌سازی کنید `main`. پین‌های بالادستی تأییدشده را برای دور زدن یک خطا ویرایش نکنید. |
| خیر `sealed-connection` یافته‌ی باستان‌شناسی | بررسی کنید که آیا کار شروع شده و مرحلهٔ راه‌اندازی/بارگذاری آن تکمیل شده است. خطاها در صف، رانر، دانلود تصویر، تونل یا سیاست‌های مخزن می‌توانند مانع راه‌اندازی شوند. |
| اتصال باز نمی‌شود | کلید ذخیره شده را برای این اجرا بارگذاری کنید، آرتیفکت دانلود شده را از حالت فشرده خارج کنید و انتخاب کنید `connection.tgwsealed`. راه‌انداز باید همچنان فعال باشد. |
| تاریخ متوقف شده است | وضعیت پنل را بررسی کنید و تا زمانی که جلسه فعال است از دکمهٔ «از سرگیری» استفاده کنید، یا با داده‌های جمع‌آوری‌شده کار را به پایان برسانید. محدودیت‌های تلگرام و محتوای غیرقابل‌دسترس ممکن است شکاف‌هایی ایجاد کنند. |
| خیر `sealed-result` | لغو یا انقضا پیش از آغاز جمع‌آوری هیچ آرشیوی ایجاد نمی‌کند؛ سپس فرایند با پیغام **هیچ آرشیو** پایان می‌یابد. یک مرحلهٔ ناموفق جمع‌آوری، تأیید یا بسته‌بندی نیز مانع از تحویل می‌شود؛ مرحلهٔ ناموفق دلیل سرپرست را بدون داده‌های خصوصی اعلام می‌کند. آن را بدون ارسال اطلاعات احراز هویت بررسی کنید. |
| مرورگر قادر به رمزگشایی آرشیو بزرگ نیست | برای بسته‌های بزرگ‌تر از ۲۵۶ مگابایت از CLI استریمینگ زیر استفاده کنید. کلید خصوصی اشتباه یا گم‌شده قادر به رمزگشایی نتیجه نخواهد بود. |
| تأیید امضاکننده را رد می‌کند. | از یک نصب معتبر و به‌روز TgWitness و شماره‌گیرندهٔ دقیق استفاده کنید. `OWNER/REPOSITORY`. سیاست جایگزینی ارائه‌شده همراه با آرشیو را نپذیرید. |
| تلگرام هنوز جلسهٔ موقت را فهرست می‌کند. | آن را در تنظیمات → دستگاه‌ها پایان دهید. خروج ممکن است ناموفق باشد و یک جریان کاری به‌طور اجباری خاتمه‌یافته ممکن است پاک‌سازی را اجرا نکند. |

پیش از اتکا به این پیش‌نمایش، یک گفتگوی کوچک را که خودتان کنترل می‌کنید امتحان کنید: یک پیام و فایل پیوست ایجاد کنید، آن‌ها را جمع‌آوری کرده، نتیجه را رمزگشایی کنید، اعتبارسنج را اجرا کنید، نتایج پوشش/رسانه‌ای را بررسی کرده و لغو جلسه تلگرام را تأیید کنید. بررسی‌های خودکار از یک کلاینت مصنوعی تلگرام به علاوه یک تست جداگانه و واقعی گواهی GitHub استفاده می‌کنند؛ هیچ اجرای حساب واقعی در نسخه فعلی ثبت نشده است.

## رمزگشایی و  محلی#

از ابزارهای یک منبع نصب معتبر و مستقل استفاده کنید، نه فایل‌های اجرایی ارائه‌شده توسط یک آرشیو ناشناس:

```
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
```

برای تحویل چندبخشی، ابتدا بسته اصلی را رمزگشایی کنید و فایل manifest استخراج‌شده آن را در کنار هر بخش رمزگذاری‌شده نگه دارید، سپس اجرا کنید:

```
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
```

منیفست، موضوع تأییدشده است و هر بخش و فایل ZIP فشرده‌شده را پیوند می‌دهد. استفاده کنید `--max-gib` برای تنظیم سقف تأیید صحت فشرده‌نشده مناسب برای یک بایگانی بزرگ؛ مقدار پیش‌فرض ۴ گیگابایت است. بررسی‌های انتخاب-منتظره و دامنه-کامل نیز با تحویل چندبخشی کار می‌کنند.

پایتون ۳.۱۱ به بالا، وابستگی‌های پروژه و یک CLI گیت‌هاب جدید که از `--signer-digest` و `--deny-self-hosted-runners` نیاز است. یک تولیدکننده کلید CLI نیز در دسترس است: `python -m tgwitness.sealed_crypto keygen sealed-key.json`.

تأییدکننده استفاده می‌کند `tgwitness/sealed_policy.json` از نصب مورد اعتماد. این بررسی‌ها شامل مخزن فراخواننده، گردش کار امضاکننده بالادست، کامیت امضاکننده تأییدشده، الزامات راनर میزبانی‌شده، یکپارچگی هش کامل ZIP، مجله داخلی و پیوست، منشأ تازه حساب-کلید، و کامیت مورد انتظار گردآورنده است. این ابزار به جای اینکه فرض کند تمام داده‌ها ذخیره شده‌اند، تاریخچه و نتایج رسانه‌ای را نمایش می‌دهد. فهرست خالی نسخه‌های تأییدشده، عملیات را با شکست خاتمه می‌دهد. به‌روزرسانی سیاست، یک تصمیم صریح اعتماد است؛ هرگز سیاست پیشنهادی خود آرشیو را به‌طور خودکار نپذیرید.

برای استفاده آفلاین، از قبل ریشه‌های مورد اعتماد را از یک محیط مورد اعتماد تهیه کنید:

```
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
```

برچسب زمانی گواهی، تعهد آرشیو را نشان می‌دهد. این برچسب، برچسب‌های زمانی پیام یا ساعت دستگاه جمع‌آوری‌کننده را احراز هویت نمی‌کند. [گزینه‌های تأیید GitHub را](https://cli.github.com/manual/gh_attestation_verify) ببینید.

## چگونه چنگال خارج از فرآیند ضبط نگه داشته می‌شود

فراخواننده حاوی یک مرجع در سطح وظیفه به جریان کاری قابل استفاده مجدد بالادست در یک SHA کامیت کامل است. آن جریان کاری صراحتاً **مخزن بالادست را در یک SHA گردآورنده ثابت** چک‌آوت می‌کند. یک پیش‌فرض `actions/checkout` در یک جریان کاری قابل استفاده مجدد، (SHA) مخزن فراخواننده را بررسی می‌کند و عمداً استفاده نمی‌شود.

این جریان کاری کش‌های فراخواننده را بازیابی نمی‌کند، آرتفکت‌های فراخواننده را مصرف نمی‌کند، فایل‌های فراخواننده را اجرا نمی‌کند، و URLهای منبع/تصویر، دستورات شل، فایل‌های ZIP آماده، یا هش‌های امضا را نمی‌پذیرد. این جریان یک گیرنده عمومی محدود و مدت زمان جلسه را می‌پذیرد. اقدامات، تصویر پایه پایتون و cloudflared توسط هش‌های ثابت (immutable digests) ثابت شده‌اند؛ وابستگی‌های پایتون از الزامات موجود قفل‌شده با هش استفاده می‌کنند. این تصویر از منبع مورد اعتماد بدون استفاده از کش ساخته می‌شود.

این کولکتور به عنوان یک کاربر غیر-روت با یک ایمیج فقط-خواندنی، قابلیت‌های لینوکس حذف‌شده، محدودیت‌های منابع، و بدون ساکت داکر یا محیط توکن گیت‌هاب اجرا می‌شود. تنها مونت‌های آن دایرکتوری‌های پیکربندی تازه، فضای کاری، و خروجی هستند. برنامه FastAPI محدودشده، قابلیت‌های ورود، دیالوگ‌ها، مجموعه حساب کاربری یا چت قابل پیکربندی، وضعیت، از سرگیری، پایان و لغو را در دسترس قرار می‌دهد. هیچ مسیر دانلود متن ساده، مسیر مدیریت عمومی، مسیر وارد کردن، یا نقطه پایانی امضا وجود ندارد.

سرپرست، کانتینرهای رو به شبکه را قبل از عمل تأیید متوقف می‌کند و مقدار نهایی ثابت را می‌خواند. `evidence.zip` یا `evidence.parts.json`. کانتینر بسته‌بندی شبکه ندارد. نام مراحل آپلود فقط `connection.tgwsealed` و `delivery*.tgwsealed`؛ نه مدرک متن ساده و نه اعتبارنامه‌های تلگرام به عنوان آرتفکت آپلود نمی‌شوند. فرآیند پاک‌سازی، دایرکتوری‌ها و کانtejnerهای خصوصی را حذف می‌کند و گیت‌هاب پس از انجام کار، VM راunner میزبانی‌شده را دور می‌اندازد. نگهداری آرتفکت یک روز است؛ قبل از انقضا دانلود کنید.

مالک یک فورک می‌تواند فراخواننده را جایگزین کند یا یک فایل امضا شده متفاوت ایجاد نماید. اعتبارسنج سختگیر باید **گردش کار/هش امضاکننده متفاوت** حاصل را رد کند. این ساختار همچنان به عدم وجود باگ‌های قابل بهره‌برداری در کد تأیید شده و یکپارچگی راه‌انداز و زیرساخت امضای گیت‌هاب وابسته است.

## رمزنگاری‌شده

هر کلید گیرنده از نوع RSA-3072 است (واردات RSA-4096 نیز پذیرفته می‌شود)، با نمایه ۶۵۵۳۷. هر پاکت، یک کلید تصادفی جدید AES-256 و یک نانس ۹۶ بیتی دارد. RSA-OAEP با SHA-256/MGF1-SHA256، کلید AES را در بر می‌گیرد. AES-GCM با یک تگ ۱۲۸ بیتی، کل پیش‌وند و بار مفید را احراز هویت می‌کند. کلید عمومی گیرنده در فرمت DER SPKI به صورت base64 است؛ فایل کلید خصوصی حاوی فرمت DER PKCS8 به صورت base64 است.

بایت‌های Envelope هستند `TGWSEAL1\n`، یک طول هدر JSON از نوع uint32 به صورت big-endian، هدر، متن رمزگذاری‌شده، و یک تگ GCM ۱۶ بایتی. هدر دقیقاً `algorithm`, `key`، و `nonce`; الگوریتم است `RSA-OAEP-256+A256GCM`. پیشوند کامل تا انتهای هدر، داده‌های احراز هویت اضافی GCM است. اندازه هدر به ۸۱۹۲ بایت محدود است. CLI بارهای باری تا ۸ گیگابایت را منتقل می‌کند و قبل از نصب خروجی درخواست‌شده، آن را احراز هویت می‌کند؛ این ابزار از بازنویسی مقصد موجود خودداری می‌کند. این یک لایه حفاظتی (envelope) خاص پروژه است که بر روی ساختارهای پایه‌ای رمزنگاری استاندارد قرار گرفته است: RSA-OAEP با SHA-256 و AES-256-GCM، که در OpenSSL و هر کتابخانه رمزنگاری اصلی در دسترس است.

بایت‌های شواهد اصلی **پیش از** قرار دادن شواهد و تأییدیه در بستهٔ بیرونی رمزگذاری‌شده، تأیید می‌شوند. این کار از وابستگی دایره‌ای بین هش آرشیو و گواهی‌ای که در همان آرشیو گنجانده شده است، جلوگیری می‌کند. برای مخازن عمومی، متادیتای تأییدیه (مخزن، گردش کار، کامیت، نام محصول و هش) عمومی است. هرگز نام‌های چت را در متادیتای عمومی قرار ندهید.

## دامنه و

این حالت از دفترچه یادداشت امضا شده و موتور خروجی‌گیری حساب استفاده می‌کند. چت‌های مخفی، تاریخچه پاک‌شده قبل از جمع‌آوری و داده‌های غیرقابل دسترسی به حساب کاربری، مستثنی هستند. چت‌های ابری خصوصی در صورت انتخاب، واجد شرایط هستند. انتخابگر چت به ۲۰٬۰۰۰ گفتگوی ورودی محدود است؛ خروجی‌گیری حساب، موجودی خود را کشف می‌کند. داده‌های ناقص، فایل‌های ناموفق و وظایف ناتمام ثبت می‌شوند. محدودیت‌های پیوست و محدودیت‌های دیسک/زمان برای برنامه اجراکننده همچنان اعمال می‌شوند. ارسال بزرگ به جای محدودیت ثابت ۴ گیگابایتی، از بخش‌های رمزگذاری‌شده استفاده می‌کند. تکمیل به معنای اتمام وظایف انتخاب‌شده منجمدشده است، نه اینکه هر رکورد تاریخی تلگرام در آرشیو موجود باشد. دفترچه چت همچنین می‌تواند به‌روزرسانی‌های زنده را مشاهده کند؛ هیچ‌کدام از این حالت‌ها یک نمای کلی اتمی نیستند. اسکرین‌شات‌ها و ضبط‌های صفحه نمایش تولیدشده بخشی از این حالت نیستند.

تست‌ها شامل ورود مجدد مصنوعی، جداسازی دامنه، رسانه، لغو، تکمیل جزئی مهلت، خروج ناموفق، مسیرها و فیلدهای API ممنوعه، رد فضای کاری از پیش بارگذاری شده، رد کلید اشتباه و دستکاری، پرچم‌های اعتبارسنج لازم، و قابلیت تعامل رمزگذاری مرورگر/پایتون هستند. تست پذیرش مرورگر از یک گواهی‌سازی نمونه‌ای با برچسب‌های واضح استفاده می‌کند؛ این یک تست واقعی Sigstore نیست. آزمون‌های میزبانی‌شده واقعی، Docker، تأیید هویت گیت‌هاب و پذیرش زنده تلگرام باید به‌طور جداگانه‌ای از بررسی‌های مصنوعی محلی گزارش شوند.

[شرایط GitHub Actions](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) ، استفاده از رانرهای میزبانی‌شده را به چرخه عمر پروژه نرم‌افزاری محدود می‌کند. یک فورک این محدودیت‌ها را از بین نمی‌برد؛ این پیش‌نمایش نباید به عنوان میزبانی تولید رایگان و بدون محدودیت بازاریابی شود. [Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) نیز برای تست و توسعه در نظر گرفته شده‌اند. هِلپرها/ورک‌فلوها برای ارزیابی این ویژگی مناسب هستند؛ صلاحیت برای سرویس تولید یک نیازمندی مستقِل برای استقرار باقی می‌ماند.

## انتشار نگه‌دارنده#

1. تعهد و بازبینی تعریف و تست‌های جمع‌آورنده، سرپرست و مخزن را انجام دهید.
2. آن کامیت کالکِر را در `sealed-collector.yml`، سپس workflow قابل‌استفاده مجدد را commit/review کنید. هرگز checkout را به‌صورت بی‌صدا از SHA فراخواننده استخراج نکنید.
3. کمیت قابل‌استفاده‌ی workflow را در `sealed-witness.yml` و جفت SHA کارکرد/جمع‌کننده آن را به `sealed_policy.json` در یک انتشار مورد اعتماد اضافه کنید.
4. تمام کامیت‌های مرجع و فایل کمکی را منتشر کنید، سپس یک فورک مستقل و گواهی واقعی گیت‌هاب را تست کنید. کامیت‌های مرجع این پین‌ها را حذف نکنید، مگر اینکه ارجاعات دوباره تولید و منتشر شوند.

برای تمایز بین مخزن فراخواننده و امضاکننده بالادست، [گردش‌های کاری قابل‌استفاده مجدد و گواهی‌ها را](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) ببینید.
