TgWitness / مستندسازی

منبع / جمع‌آوری

بارگذاری تاریخچه منبع

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

نسخهٔ اصلی کنونی: از منبع در دسترس است؛ در پیش‌نمایش قابل حمل ۰.۷.۰ گنجانده نشده است.

در بخش «منابع» (Sources)، چت‌های فعال را مرور کنید، مشاهده را شروع کنید، سپس «بارگذاری کل تاریخچه» (Load full history) را انتخاب کنید. این فرایند آن فهرست منابع را تثبیت کرده و پیام‌های گذشتهٔ در دسترس آن‌ها را در بخش «چت‌ها» (Chats) و دفترچهٔ مشاهدات امضا شده بارگذاری می‌کند. بخش «رسانه‌ها» (Media) از تنظیمات پیوست موجود و صف دانلود پایدار استفاده می‌کند. این بخش از خروجی امضا شدهٔ JSON/HTML برای هر چت به صورت جداگانه مستقل است.

برای جمع‌آوری در سطح کل حساب، گزینه «کل حساب» (Whole account) را انتخاب کنید، «مشاهده» (Observation) را برای بارگذاری لیست منابع آن شروع کنید و پیش از شروع تاریخچه، آن لیست را بررسی کنید. محدودیت لیست مکالمات همچنان اعمال می‌شود (به طور پیش‌فرض ۱۰۰۰، قابل تنظیم در «پارامترها» (Parameters)). یک اجرای موفق، اثبات نمی‌کند که تمام مکالمات حساب فهرست شده‌اند. چت‌هایی که بعداً کشف یا فعال می‌شوند، به اجرای مجدد نیاز دارند.

تعطیل، راه‌اندازی مجدد و نتایج جزئی#

  • تاریخچه توقف، خواندن را متوقف می‌کند. ادامه تاریخچه از آخرین پیام ثبت‌شده در هر منبع از سر گرفته می‌شود؛ راه‌اندازی مجدد برنامه نیز اجرای آن را تا زمان از سرگیری متوقف می‌کند. ابتدا مشاهده را راه‌اندازی مجدد کنید. از سرگیری نیازمند همان حساب تلگرام است.
  • مشاهده پیام، انجام عملیات پیوست و ثبت مکان نما در یک تراکنش واحد. اجرای از سر گرفته شده مشاهدات ثبت‌شده قبلی را تکرار نمی‌کند. ضبط زنده یا اجرای جداگانه و صراحتاً آغازشده می‌تواند به‌طور مستقل همان پیام را مشاهده کند.
  • هر منبع در اولین خواندن، یک شناسهٔ بالای پیام را تثبیت می‌کند. پیام‌های جدیدتر مربوط به مشاهدهٔ زنده هستند، نه صفحات تاریخی باقی‌ماندهٔ آن منبع.
  • منابع غیرقابل‌دسترس و منابعی که در حین جمع‌آوری غیرفعال شده‌اند، همچنان به‌عنوان «ناموفق» یا «نادیده گرفته شده» قابل مشاهده‌اند. سایر منابع به کار خود ادامه می‌دهند؛ نتیجه کلی ناقص است.
  • تأخیرهای FloodWait به بازه زمانی انتظار ذخیره شده برای حساب احترام می‌گذارند. تایم‌اوت‌های انتقال و کمبود فضای دیسک اجرای برنامه را متوقف می‌کنند و نشانگر آن را دست‌نخورده نگه می‌دارند. پس از برطرف شدن علت، اجرا از سر گرفته می‌شود.
  • پایان این اجرای تاریخچه مشاهدات ذخیره‌شده را حفظ می‌کند. این کار آن‌ها را حذف نمی‌کند یا دانلودهای پیوست‌های صف‌شده را لغو نمی‌کند. یک اجرای جدید منابع فعال را دوباره می‌خواند.

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

انتقال و تأیید#

گزارش پیشرفت امضا شده را ذخیره کنید، سپس از «صادرات شواهد» برای دانلود دفترچه و پیوست‌های ذخیره شده استفاده کنید. یک صادرات شواهد بعدی ممکن است شامل سوابق اضافی باشد؛ گزارش شمارشگرهای خود را به پیشوند دفترچه در زمان ایجاد آن متصل می‌کند. راستابار را از یک نسخه برداری معتبر از این نسخه اجرا کنید:

python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT

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

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

نشانگر اکتشاف وضعیت فضای کاری محلی است. بازیابی یک فایل ZIP مدرک به تنهایی، شغل اکتشافی در حال انتظار یا جلسه تلگرام را بازیابی نمی‌کند. اگر ادامه شغل اصلی لازم است، از پشتیبان فضای کاری نگهداری کنید.