# Один журнал. Чотири режими збору даних. Вісім рівнів верифікації.

Canonical page: https://phishdestroy.io/tgwitness/uk/guides/modes

Області збору даних, межі подій, вісім механізмів верифікації та шість вигаданих сценаріїв розслідування.

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

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

Режими, сценарії та рівні доказовості

TgWitness записує те, що спостерігає підключений обліковий запис. Третя сторона може перевірити цілісність запису за допомогою незалежно довіреного ключа.

[Режими збору даних](https://phishdestroy.io/tgwitness/uk/guides/modes#scope)[Сценарії](https://phishdestroy.io/tgwitness/uk/guides/modes#scenarios)[Рівні доказовості](https://phishdestroy.io/tgwitness/uk/guides/modes#levels)

3–5-хвилинний огляд · вигадані приклади · поточна реалізація

1. **Telegram**

   Оновлення, видимі для облікового запису
2. **Колектор**

   Пов’язані записи, кожен із яких підписаний
3. **Верифікатор**

   Довірений ключ + збережена межа

`h₁ → h₂ → h₃ · Ed25519`Розглядайте кожне спостереження разом з ідентифікаторами джерела та записом про збір.

## Виберіть сферу спостереження

Три області дії та попереднє налаштування для розслідування. Виключення та увімкнені типи джерел залишаються чинними.

За замовчуванням**Вибрані чати**

Записи

Тільки джерела, відібрані вручну.

Нові чати

Не додається автоматично.

Вибирайте

Відомий набір каналів або груп. Фіксована місткість чату не була визначена.

Папка облікового запису**Папка Telegram**

Записи

Включення папок та категорій, за винятком виключень та архівних чатів, якщо це налаштовано.

Нові чати

Збіг активних чатів; зміни у папках протягом години.

Вибирайте

Аналітик уже веде папку справи. Підтверджуйте збір даних на спеціальному обліковому записі.

Підтвердіть сферу застосування**Весь обліковий запис**

Записи

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

Нові чати

Буде додано після виходу першого оновлення.

Вибирайте

Спеціальний обліковий запис для спостереження, включаючи обліковий запис, що бере участь у справі.

Попереднє налаштування для всього облікового запису**Режим розслідування**

Записи

Усі типи джерел, власні дії, профілі джерел та останні 200 видимих повідомлень від нещодавно виявлених джерел.

Нові чати

Новий чат або бот отримує профіль та знімок історії.

Вибирайте

Приєднайтеся до команди або взаємодійте з ботом через панель. Перегляньте та збережіть пресет.

Ці картки призначені для локального порівняння, а не для управління колектором у режимі реального часу. Вони не змінюють обліковий запис.

[Ознайомтеся з деталями](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/)

## Вивантаження через GitHub Actions (попередня версія)

Новий вхід у Telegram, один чат, зашифрований архів і атестація GitHub.

[Відкрити помічник вивантаження](https://phishdestroy.io/tgwitness/uk/docs/capture/)

## Що фіксується

До запису потрапляють лише доставлені або явно запитані спостереження. Невідоме походження залишається невідомим.

 Перемикачі фіксації · локальна ілюстраціяНові повідомленняРедагуванняВидаленняРеакціїЧленство

Панель застосовує ці перемикачі для кожного робочого простору. Вимкнення одного з них зберігає існуючі записи; повторне ввімкнення не відновлює пропущені події.

**Матриця подій: збережений матеріал та залишені невідомі**

| Категорія | Збережено |
| --- | --- |
| Повідомлення | Текст, ідентифікатори, метадані відправника, контекст відповіді та оригінальний конверт оновлення. |
| Редагувати | Кожна спостережувана версія, без перезапису попередніх. |
| Видалення | Повідомлення та раніше збережений текст, якщо такий є. |
| Видалення без обмеження сфери дії | Повідомлення на рівні облікового запису; невідомий вузол залишається явно зазначеним. |
| Реакція | Надані лічильники та видимі останні ідентифікатори. |
| Членство | Доставлені службові повідомлення та оновлення учасників. |
| Вкладення | Дескриптор оригінальної версії, збережені байти, SHA-256 та результати спроб. |
| Знімок історії | Повідомлення, що наразі відображаються, позначені як спостереження в історії. |
| Власні дії | Вихідні messages/edits та відповідні метадані button_press метадані. |
| Кнопки бота | Метадані зворотного виклику, URL-адреси, веб-додатку та запиту зберігаються разом із повідомленням. |

### Стандартні обмеження на вкладення

Фотографії

20 MiB

Відео

100 MiB

Файли

50 MiB

Анімації

20 MiB

Відеонотатки

50 MiB

Голос

20 MiB

Аудіо

50 MiB

Стікери

5 MiB

[Ознайомтеся з деталями](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/)

## Використовуйте ті повноваження, які у вас є

Кожен обліковий запис має власний робочий простір, журнал, ключ підпису, маршрут та чергу.

### Номер телефону + код

Введіть 2FA , якщо ця опція увімкнена.

### QR код

Скануйте з авторизованого пристрою; 2FA це все ще може бути необхідним.

### Telethon .session

Імпортуйте файл сеансу облікового запису.

### Pyrogram .session

Імпортуйте підтримуваний Pyrogram формат сесії.

### TData ZIP

Підтримується один обліковий запис Desktop; локальний пароль, якщо він встановлений.

### StringSession текст

Вставте Telethon StringSession.

### .session + .json

Виберіть сесію та відповідні супутні метадані.

### Ключ автентифікації HEX + DC ID

Імпортуйте авторизацію облікового запису разом з ідентифікатором центру обробки даних.

**API pair**

Ваша власна API пара є необов’язковою. Без неї TgWitness використовується пул публічних пар, включаючи пари з офіційного Telegram Desktop.

`Direct · SOCKS5 · HTTP CONNECT · MTProxy`MTProxy є експериментальним; доступні вбудовані публічні MTProxy списки. У разі збою проксі-маршруту не відбувається перехід на пряме з’єднання.

Дві робочі області на одній машині не є двома незалежними свідками.

[Формати облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/)

## Дійте з панелі

Надішліть повідомлення або дайте відповідь, натисніть кнопку поточного бота, збережіть попередній перегляд посилання, а потім явно приєднайтеся до чату або запустіть бота з його параметром запуску.

`interaction.preview``interaction.requested``interaction.result`

Квитанції попереднього перегляду, запиту та результату підписуються. Перед натисканням кнопки сервер знову отримує повідомлення та відхиляє змінену клавіатуру. Повернутий текст зворотного виклику та URL-адреси залишаються записаним контекстом.

[Ознайомтеся з деталями](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/)

## Відновлення та безперебійність роботи

Прогалини показуються, а не приховуються.

### Повернутися до збереженого місця

Після перезапуску Telegram запитує про пропущені оновлення. Обмежений термін зберігання та відмінності, термін дії яких закінчився, можуть залишати прогалини.

### Перевіряйте видимі повідомлення ще раз

Значення за замовчуванням: пріоритетні джерела — кожні 15 хвилин, інші — кожні 6 годин. Результати включають message.recovered та message.missing_on_recheck.

### Читати coverage.json

Підписаний експорт супроводжується періодами спостереження, пропусками з обґрунтуванням та неспостереженими ідентифікаторами. Запис про відсутність при повторній перевірці не є повідомленням про видалення.

[Ознайомтеся з деталями](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/)

## Сім рівнів. Різні питання.

Кожен механізм відповідає на конкретне питання. Налаштовуйте зовнішні служби окремо та зберігайте їхні опорні точки довіри поза межами колектора.

1. ### Запис

   SHA-256 ланцюг + Ed25519 на подію; перша previous_hash — 64 нулі.

   **Перевірки сторонніми організаціями** Упорядкування та підписи здійснюються під закріпленим ключем колектора.

   **Команда верифікації**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
   ```
2. ### Контейнер

   manifest.json перелічує хеші файлів; manifest.sig підписує його. media.saved прив’язує байти вкладення до події.

   **Перевірки сторонніми організаціями** Надані файли відповідають підписаному маніфесту та квитанціям про отримання медіафайлів.

   **Команда верифікації**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
   ```
3. ### Збережена межа

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

   **Перевірки сторонніми організаціями** Пізніший експорт узгоджується з раніше збереженою довжиною та заголовком; відкат можна виявити.

   **Команда верифікації**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json
   ```
4. ### Зовнішній час

   Режим доказів надсилає контрольну точку SHA-256 до RFC 3161 органи влади (FreeTSA, DigiCert) та OpenTimestamps календарів.

   **Перевірки сторонніми організаціями** Перевірена відповідь TSA датує ці байти; підтверджена квитанція OpenTimestamps прив’язує їх до Bitcoin.

   **Команда верифікації**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca trusted-ca.pem
   ots upgrade checkpoint.ots
   ots verify checkpoint.ots
   ```
5. ### Незалежний свідок

   Відокремте хост, кінцеву точку з обмеженим доступом тільки для читання, новий челендж та власний key/journal та TGW1 публікації в каналі.

   **Перевірки сторонніми організаціями** Раніше прийняті версії; статуси: ok, key_changed, «rollback», «fork», «invalid» та no_response.

   **Команда верифікації**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL
   ```
6. ### Зовнішня репліка

   S3-сумісна копія, зашифрована за допомогою AES-256-GCM; Object Lock якщо сховище це підтримує.

   **Перевірки сторонніми організаціями** Restore публікує файли лише після успішної перевірки журналу, контрольної точки та збережених медіафайлів.

   **Команда верифікації**

   ```
   python -m tgwitness.replica restore --key-file KEY.json --out EMPTY_DIR
   ```
7. ### Перевірте походження

   Підписане підтвердження виконання: хеші вихідного коду, версії залежностей та контекст процесу. Надано самостійно.

   **Перевірки сторонніми організаціями** Що повідомив колектор підписів про власне виконання.

   **Команда верифікації**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
   ```

### Джерело та запис про збір

Розглядайте кожне спостереження разом з ідентифікаторами джерела та записом про збір.

[Незалежний свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/)

Місцевий SHA-256 експеримент

### Спробуйте змінити запис 2

Наступний запис зберігає попередньо збережене посилання. Зміна тексту змінює обчислений хеш запису № 2.

Текст запису 2

Запис 1`h1`Починається з 64 нулів

Запис 2`h2`Включає збережені h1

Запис 3`h3`Включає збережені h2

Статичний приклад: h2 містить «Зустріч о 11:00». Зміна цього тексту змінює h2; запис 3 все ще посилається на збережене h2.

**Перевіряйте повні дайджести**

Хеш збереженого запису 2

`SHA-256(e₂)`

Перерахований хеш запису 2

`SHA-256(e₂)`

Цей приклад обчислює хеші, а не підписи. Справжній верифікатор перевіряє кожен підпис і посилання щодо довіреного ключа.

 [Ознайомтеся з деталями](https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/)

## Оберіть шлях через докази

Вигадані ситуації. Починайте збір даних до відповідної події; зберігайте межі та пропуски разом із вмістом.

### Канал змінює платіжні реквізити

Режим → події

Вибрані чати → повідомлення, редагування, видалення.

Вихідні дані

Спостережувані версії публікацій та вкладень за хешем.

Верифікація

Підписано ZIP + збережений контрольний пункт + перевірена відповідь TSA.

### Повідомлення зникають після інциденту

Режим → події

Папка або весь обліковий запис → усі категорії подій.

Вихідні дані

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

Верифікація

Підписано ZIP + незалежний журнал свідків.

### Дослідіть бота-магазин

Режим → події

Попередні налаштування розслідування → кнопки, попередній перегляд посилань та явний запуск бота.

Вихідні дані

Підписані квитанції про взаємодію, повернені зворотні виклики та збережені профілі.

Верифікація

Підписано ZIP; перевіряйте будь-яке досьє щодо ZIP.

### Учасник змінює імена в різних чатах

Режим → події

Будь-яка область дії → спостережувані sender/profile метадані.

Вихідні дані

Історія імен/імен користувачів за числовим ідентифікатором, посилання «також у» та витягнуті зачіпки.

Верифікація

Досьє JSON перевірено на відповідність підписаному ZIP.

### Тривале спостереження з копією, що зберігається поза сервером

Режим → події

Будь-яка область дії → режим «Докази» та S3 репліка з підтримкою Object Lock.

Вихідні дані

Зашифрована копія, збережені контрольні точки та відповіді з часовими мітками.

Верифікація

Відновіть дані за допомогою експортованого ключа, а потім перевірте їх без оригінального сервера.

[Ознайомтеся з деталями](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/)

## Передайте пакет, який можна перевірити

Надайте підписаний оригінал, незалежно збережений відбиток ключа, відповідну контрольну точку та результат перевірки.

- Підписано ZIP
- JSONL
- CSV
- HTML
- Контрольна точка
- Квитанція про виконання
- Експорт чату: chat.json / chat.html
- Досьє JSON
- Захищено паролем AES-256 ZIP
- Окремі експорти для декількох облікових записів
- Потоковий CLI: 5 GiB обмеження за замовчуванням

```
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint checkpoint.json --require evidence
```

Отримуйте верифікатор із надійної копії, а не з архіву, що перевіряється.

[Ознайомтеся з деталями](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/)

## Порівняйте наданий артефакт

Основні артефакти без додаткового підписання, міток часу або систем свідків. Скрипти та логери різняться залежно від реалізації; «частковий» означає обмежений зафіксованим або видимим матеріалом.

| Підхід | Редагування / видалення | Запис підпису | Зовнішній час | Незалежний свідок | Покриття / прогалини | Верифікація без автора |
| --- | --- | --- | --- | --- | --- | --- |
| Експорт з Telegram Desktop | Частково | Ні | Ні | Ні | Ні | Ні |
| Telethon скрипт знімка | Частково | Ні | Ні | Ні | Ні | Ні |
| Реєстратор видалень: текстовий журнал | Частково | Ні | Ні | Ні | Ні | Ні |
| Скріншоти / знімки веб-сторінок | Частково | Ні | Ні | Ні | Ні | Ні |
| TgWitness з налаштованими додатковими параметрами | Частково | Так | Так | Так | Частково | Так |

[Ознайомтеся з деталями](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/)

[Інструкція з налаштування](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=uk)[Спеціальний обліковий запис](https://phishdestroy.io/tgwitness/uk/docs/dedicated-account/)[EVIDENCE.md](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/)[INVESTIGATION.md](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/)
