- Что записывает
- Только чаты, выбранные вручную.
- Новые чаты
- Не добавляются автоматически.
- Когда выбирать
- Известный набор каналов или групп. Проверенного предела по числу чатов нет.
Режимы, сценарии и уровни доказательства
Один журнал. Четыре режима сбора. Восемь уровней проверки.
TgWitness записывает то, что видит подключённый аккаунт. Третья сторона проверяет целостность записи по заранее доверенному ключу.
- Telegram
Обновления, видимые для учетной записи
- Коллектор
Связанные записи, каждая из которых подписана
- Верификатор
Доверенный ключ + сохраненная граница
h₁ → h₂ → h₃ · Ed25519Рассматривайте каждое наблюдение вместе с идентификаторами источника и записью о сборе.Выберите режим сбора
Три области наблюдения и пресет расследования. Исключения и выбранные типы источников действуют во всех соответствующих режимах.
- Что записывает
- Чаты и категории папки, за вычетом исключений и архивных чатов, если это задано папкой.
- Новые чаты
- Подходящие активные чаты; изменения состава папки — в течение часа.
- Когда выбирать
- Аналитик уже ведёт папку по делу. Сбор требует подтверждения и выделенного аккаунта.
- Что записывает
- Доступные аккаунту чаты, включая личные и ботов, в пределах выбранных типов источников.
- Новые чаты
- Добавляется с первым обновлением.
- Когда выбирать
- Выделенный аккаунт наблюдения, в том числе для участия в расследуемых чатах.
- Что записывает
- Все типы источников, собственные действия, профили источников и последние 200 видимых сообщений каждого нового источника.
- Новые чаты
- Для нового чата или бота сохраняются профиль и снимок истории.
- Когда выбирать
- Вступление в команду или диалог с ботом из панели. Просмотрите настройки и сохраните пресет.
Карточки служат для сравнения. Выбор здесь не меняет настройки подключённого аккаунта.
ПодробностиЧто фиксируется
В журнал попадают доставленные или явно запрошенные наблюдения. Неизвестный участник действия остаётся неизвестным.
В панели переключатели действуют на весь workspace. Отключение сохраняет прежние записи; повторное включение не восстанавливает пропущенные события.
Матрица событий: сохранённое и неизвестное
| Категория | Что сохраняется |
|---|---|
| Сообщение | Текст, идентификаторы, метаданные отправителя, контекст ответа и исходный конверт обновления. |
| Правка | Все наблюдённые версии без подмены предыдущих. |
| Удаление | Уведомление плюс ранее сохраненный текст, если таковой имеется. |
| Unscoped deletion | Уведомление уровня аккаунта; неизвестный чат отмечен явно. |
| Реакция | Полученные счётчики и доступные недавние участники реакций. |
| Членство | Доставленные служебные сообщения и обновления участников. |
| Вложение | Дескриптор исходной версии, сохранённые байты, SHA-256 и результаты попыток загрузки. |
| Снимок истории | Снимок сообщений, видимых в момент запроса, с отметкой о происхождении из истории. |
| Собственные действия | Исходящие сообщения и правки; button_press при совпадении с сохранённой клавиатурой ответа. |
| Кнопки бота | Метаданные callback, URL, web app и запросов вместе с сообщением. |
Лимиты вложений по умолчанию
- Фотографии
- 20 MiB
- Видео
- 100 MiB
- Файлы
- 50 MiB
- Анимации
- 20 MiB
- Видеосообщения
- 50 MiB
- Голосовые
- 20 MiB
- Аудио
- 50 MiB
- Стикеры
- 5 MiB
Подключение и гибкость
На каждый аккаунт — свой workspace, журнал, ключ подписи, маршрут и очередь.
Номер телефона + код
Пароль 2FA, если он включён.
QR код
Сканирование с авторизованного устройства; может потребоваться 2FA.
Telethon .session
Импортируйте файл сеанса учетной записи.
Pyrogram .session
Импорт поддерживаемого формата сессии Pyrogram.
TData ZIP
Один поддерживаемый аккаунт Desktop; локальный passcode, если установлен.
StringSession текст
Текст Telethon StringSession.
.session + .json
Выберите сессию и соответствующие сопутствующие метаданные.
Auth key HEX + DC ID
Ключ авторизации аккаунта и идентификатор его дата-центра.
Direct · SOCKS5 · HTTP CONNECT · MTProxyMTProxy — экспериментальный маршрут; доступны встроенные публичные списки MTProxy. При ошибке прокси отката на прямое соединение нет.
Два workspace на одной машине — не два независимых свидетеля.
Форматы учётных записейАктивные действия из панели
Написать или ответить, нажать кнопку бота, сохранить превью ссылки, затем явно вступить в чат или открыть бота со start-параметром.
interaction.previewinteraction.requestedinteraction.resultПревью, запрос и результат сохраняются как подписанные записи. Перед нажатием сервер повторно получает сообщение и отказывает, если клавиатура изменилась. Текст callback-ответа и URL остаются в журнале.
ПодробностиВосстановление и непрерывность
Разрывы показываются, а не скрываются.
Продолжение с сохранённой позиции
После рестарта коллектор запрашивает у Telegram пропущенные обновления. Срок хранения ограничен: устаревшая разница может оставить разрыв.
Повторная проверка сообщений
По умолчанию: приоритетные источники — каждые 15 минут, остальные — каждые 6 часов. Результаты: message.recovered и message.missing_on_recheck.
Отчёт coverage.json
В подписанном экспорте — периоды наблюдения, разрывы с причиной и ненаблюдённые ID. Отсутствие при recheck не равно уведомлению об удалении.
Семь уровней. Разные вопросы.
Каждый механизм отвечает на ограниченный вопрос. Внешние сервисы настраиваются отдельно; доверенные ключи и контрольные точки храните вне коллектора.
-
Запись
SHA-256-цепочка и Ed25519 на каждое событие; первый previous_hash состоит из 64 нулей.
Что проверяет третья сторона Порядок записей и подписи под заранее доверенным ключом коллектора.
Команда проверки
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 -
Контейнер
manifest.json перечисляет хеши файлов; manifest.sig подписывает его. media.saved связывает байты вложения с событием.
Что проверяет третья сторона Файлы согласуются с подписанным манифестом и записями сохранения вложений.
Команда проверки
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 -
Граница
Checkpoint при старте, по умолчанию каждые 5 минут и при штатной остановке. Сохраните копию вне коллектора.
Что проверяет третья сторона Поздний экспорт совпадает с ранее сохранённой длиной и головным хешем; откат можно обнаружить.
Команда проверки
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json -
Время
Evidence mode отправляет SHA-256 checkpoint в RFC 3161 TSA (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 -
Свидетель
Отдельный хост, один read-only endpoint, случайный challenge, собственные ключ и журнал, посты 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 -
Реплика
Копия в S3-совместимом хранилище с AES-256-GCM; Object Lock, если его поддерживает bucket.
Что проверяет третья сторона Файлы появляются в каталоге восстановления только после проверки журнала, checkpoint и сохранённых вложений.
Команда проверки
python -m tgwitness.replica restore --key-file KEY.json --out EMPTY_DIR -
Происхождение
Подписанный run receipt: хеши исходников, версии зависимостей и контекст процесса. Self-reported.
Что проверяет третья сторона То, что сам подписывающий коллектор сообщил о своём запуске.
Команда проверки
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
Локальный эксперимент с SHA-256
Попробуйте изменить запись №2
Следующая запись хранит прежнюю ссылку. При изменении текста пересчитывается хеш записи №2.
h1Начинается с 64 нулейh2Содержит сохранённый h1h3Содержит сохранённый h2Статический пример: h2 включает «Meet at 11:00». Изменение текста меняет h2; запись №3 по-прежнему ссылается на прежний h2.
Посмотреть полные хеши
- Хеш сохраненной записи № 2
SHA-256(e₂)- Пересчитанный хеш записи № 2
SHA-256(e₂)
Сценарии применения
Вымышленные ситуации. Начинайте сбор до интересующего события; сохраняйте границы и разрывы вместе с содержимым.
Канал изменяет платежные реквизиты
- Режим → события
- Выбранные чаты → сообщения, правки, удаления.
- Что получаем
- Наблюдаемые версии сообщений и вложения по хешу.
- Проверка
- Подписанный ZIP + сохранённый checkpoint + проверенный ответ TSA.
Сообщения исчезают после инцидента
- Режим → события
- Папка или весь аккаунт → все категории событий.
- Что получаем
- Сохранённые оригиналы, уведомления об удалении и coverage с разрывами.
- Проверка
- Подписанный ZIP + независимый журнал свидетеля.
Расследование бота-магазина
- Режим → события
- Investigation mode → кнопки, превью ссылок и явный запуск бота.
- Что получаем
- Подписанные interaction-записи, callback-квитанции и сохранённые профили.
- Проверка
- Подписанный ZIP; досье проверяется по этому ZIP.
Участник меняет имена в разных чатах
- Режим → события
- Любой режим → наблюдённые метаданные отправителя и профиля.
- Что получаем
- История имён и username по численному ID, ссылки «также в…» и извлечённые зацепки.
- Проверка
- Dossier JSON с проверкой против подписанного ZIP.
Долгое наблюдение с внешней копией
- Режим → события
- Любой режим → Evidence mode и S3-реплика с поддержкой Object Lock.
- Что получаем
- Зашифрованная копия, сохраненные контрольные точки и ответы с временными метками.
- Проверка
- Восстановите данные с помощью экспортированного ключа, а затем проверите их без использования исходного сервера.
Экспорт и передача
Передайте подписанный оригинал, заранее сохранённый отпечаток ключа, подходящий checkpoint и результат проверки.
- ZIP с подписью
- JSONL
- CSV
- HTML
- Контрольная точка
- Run receipt
- Экспорт чатов: 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Верификатор берите из доверенной копии, а не из проверяемого архива.
ПодробностиЧестное сравнение подходов
Базовые артефакты без добавленных подписей, меток времени и свидетелей. Возможности скриптов и логгеров зависят от реализации; «частично» означает только наблюдённый или видимый материал.
| Подход | Изменения / удаления | Подпись записи | Внешняя метка времени | Независимый свидетель | Покрытие / разрывы | Проверка без автора |
|---|---|---|---|---|---|---|
| Экспорт из Telegram Desktop | Частично | Нет | Нет | Нет | Нет | Нет |
| Telethon-скрипт выгрузки | Частично | Нет | Нет | Нет | Нет | Нет |
| Логгер удалений: текстовый журнал | Частично | Нет | Нет | Нет | Нет | Нет |
| Скриншоты / веб-фиксация | Частично | Нет | Нет | Нет | Нет | Нет |
| TgWitness с настроенными дополнениями | Частично | Да | Да | Да | Частично | Да |