TgWitness / مستندسازی

آنچه آزمایش شده است ←

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

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

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

TgWitness / مستندسازی · مجموعه

مجموعه

در بخش More tools → Sources → Chats in scope، چت‌های فعال را مرور کنید، Standard API یا Takeout export را انتخاب کرده، سپس Load full history را برگزینید. این عملیات آن لیست منابع را تثبیت کرده و پیام‌های گذشته موجود آن‌ها را در چت‌ها و دفتر مشاهدات امضا شده بارگذاری می‌کند. بخش Media از تنظیمات پیوست موجود و صف دانلود پایدار استفاده می‌کند. این بخش، جدا از خروجی امضا شده JSON/HTML برای هر چت است.

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

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

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

  • تاریخچه توقف، خواندن را متوقف می‌کند. ادامه تاریخچه از آخرین پیام ثبت‌شده در هر منبع از سر گرفته می‌شود؛ راه‌اندازی مجدد برنامه نیز اجرای آن را تا زمان از سرگیری متوقف می‌کند. از سرگیری نیازمند همان حساب تلگرام غیرفعال است.
  • مشاهده پیام، انجام عملیات پیوست و ثبت مکان نما در یک تراکنش واحد. اجرای از سر گرفته شده مشاهدات ثبت‌شده قبلی را تکرار نمی‌کند. ضبط زنده یا اجرای جداگانه و صراحتاً آغازشده می‌تواند به‌طور مستقل همان پیام را مشاهده کند.
  • هر منبع (هر بازهٔ تقسیم‌شدهٔ تلگرام در Takeout) در اولین خواندن خود یک شناسهٔ پیام بالا را تثبیت می‌کند. پیام‌های جدیدتر به مشاهدهٔ زنده تعلق دارند، نه به صفحات تاریخی باقی‌ماندهٔ آن منبع.
  • منابع غیرقابل‌دسترس و منابعی که در حین جمع‌آوری غیرفعال شده‌اند، همچنان به‌عنوان «ناموفق» یا «نادیده گرفته شده» قابل مشاهده‌اند. سایر منابع به کار خود ادامه می‌دهند؛ نتیجه کلی ناقص است.
  • تلگرام گزارش مدیر چت را فقط به مدیران آن نشان می‌دهد. برای یک عضو عادی، خواندن گزارش مدیر به‌عنوان history.admin_log.unavailable با reason: not_admin ثبت می‌شود و تاریخچه را ناقص نمی‌کند؛ اما خواندن ناموفق گزارش مدیر توسط یک مدیر، تاریخچه را ناقص می‌کند.
  • تأخیرهای FloodWait به فاصله زمانی افزایش‌یافته حساب ذخیره شده احترام می‌گذارند. خطاهای موقت تا پنج بار مجدداً تلاش می‌کنند؛ در صورت اتمام تلاش‌ها و کمبود فضای دیسک، عملیات متوقف می‌شود اما مکان‌نما دست‌نخورده باقی می‌ماند.
  • پایان این اجرای تاریخچه مشاهدات ذخیره‌شده را حفظ می‌کند. این کار آن‌ها را حذف نمی‌کند یا وظایف پیوست استاندارد-API را لغو نمی‌کند. پایان Takeout فایل‌های Takeout باقی‌مانده را به‌عنوان ردشده علامت‌گذاری می‌کند؛ مکث آن‌ها را قابل ازسرگیری نگه می‌دارد. یک اجرای جدید منابع فعال‌شده را دوباره می‌خواند.

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

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

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

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

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

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

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