TgWitness / Документація

Що було протестовано →

Довідка / Зібрати

Telegram · Завантажити історію джерел

Завантажуйте минулі повідомлення з увімкнених джерел, призупиняйте та відновлюйте процес, а також перевіряйте підписаний звіт про хід роботи.

TgWitness / Документація · Колекція

Збірка

У розділі Додаткові інструменти → Джерела → Чати в межах дії перегляньте увімкнені чати, виберіть «Стандартний API» або «Експорт Takeout», а потім натисніть Завантажити повну історію. Ця операція виправляє список джерел і завантажує доступні минулі повідомлення у розділ «Чати» та підписаний журнал спостережень. Для мультимедіа використовуються існуючі налаштування вкладень та постійна черга завантажень. Це не пов’язано з підписаним експортом у форматі JSON/HTML для кожного чату окремо.

Для збору даних по всьому обліковому запису виберіть Весь обліковий запис і збережіть область дії. Історія оновлює всі доступні діалоги, включаючи архівні чати, перед підписанням свого списку джерел. Цей процес виявлення не використовує обмеження списку, встановлене у вікні вибору чатів. Чати, виявлені пізніше, перебувають під спостереженням і отримують налаштований початковий знімок; під час наступного повного запуску можна завантажити їхню попередню історію. Залиште опцію Продовжувати спостереження під час та після завантаження історії увімкненою, щоб фіксувати нові повідомлення, редагування та повідомлення про видалення під час завантаження історії. Один цикл обробки історії або експорту використовує слот збору даних; спостереження в режимі реального часу відбувається паралельно з цим.

Виберіть від одного до трьох паралельних чатів, від одного до п’яти працівників, відповідальних за обробку вкладень, а також вкажіть, чи слід зберігати доступні «Останні дії» та порівнювати раніше збережені версії. Виведення даних може вимагати затвердження в Telegram та визначеного сервером часу очікування. Ці параметри залишаються незмінними після відновлення роботи. Див. розділ Поведінка заповнення прогалин та Контракт доказів для детальної інформації щодо передачі, повторних спроб та довіри.

Призупинення, поновлення та часткові результати#

  • Історія паузи зупиняє читання. Історія продовження відновлює з останнього збереженого повідомлення в кожному джерелі; перезапуск програми також залишає процес у стані паузи до його відновлення. Для відновлення потрібен той самий неактивний обліковий запис Telegram.
  • Спостереження за повідомленням, обробка вкладень та фіксація позиції курсора відбуваються в одній транзакції. При відновленні виконання вже зафіксовані спостереження не повторюються. У режимі реального часу або під час окремого, явно запущеного циклу виконання може відбуватися незалежне спостереження за тим самим повідомленням.
  • Кожне джерело (кожен розділений діапазон Telegram у Takeout) фіксує верхній ідентифікатор повідомлення під час першого зчитування. Новіші повідомлення належать до поточного спостереження, а не до решти історичних сторінок цього джерела.
  • Джерела, до яких неможливо отримати доступ, та джерела, вимкнені під час збору даних, залишаються видимими як «неуспішні» або «пропущені». Інші джерела продовжують працювати; загальний результат є неповним.
  • Telegram показує журнал адміністратора чату лише його адміністраторам. Для звичайного учасника перегляд журналу адміністратора реєструється як 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-файлу з доказами не відновлює завдання збору даних, що перебуває в процесі виконання, або сеансу Telegram. Зберігайте резервну копію робочого простору, якщо потрібно продовжити виконання початкового завдання.