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

Что проверено →

Документация / 07

Экспорт чатов Telegram и проверка подписи

Передайте файлы, которые получатель сам сверит с вашим пространством.

Сохранить ссылкуЭкспорт подписанного ZIP-архиваПолучатель проверяет

Впервые слышите о подписях и контрольных точках? Измените пример записи и посмотрите, какие проверки это заметят.

Хотите хранить копию отдельно от системы сбора данных? Перейдите в раздел «Настройка S3», «Блокировка объектов» или «Проверенное восстановление».

Сохраните надёжный справочный материал

Запишите отпечаток ключа рабочей области в месте, отличном от коллектора. Во время сбора включите режим сбора доказательств, чтобы контрольные точки получали временные метки по стандартам RFC 3161 и OpenTimestamps, либо запустите свидетеля, который публикует сообщения в общедоступном канале. Храните подписанные контрольные точки также в другом месте: получатель сверяет с ними ключ, время и более раннее состояние журнала.

Скачайте ZIP-архив с подписью

Экспорт → подписанный ZIP с доказательствами. В нём весь журнал и подписанный манифест файлов. Читаемый отчёт настраивается в Report studio, а если нужно отдать только выбранное — сделайте выписку для передачи.

У отчётов HTML, PDF и JSON свои печати. CSV — просто рабочая копия; для проверки целостности берите CSV из проверенного ZIP.

Проверьте с помощью надёжной копии TgWitness

В окружении проекта, со своим отпечатком и путями:

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

При успешном прохождении проверки отображаются значения key_pinned: true и checkpoint_checked: true. Для параметра --require evidence также требуется стороннее время для последней записи, например, проверенная временная метка: контрольная точка подписана вашим собственным ключом, поэтому одной только её недостаточно. Сохраните этот вывод рядом с архивом. Контрольная точка должна находиться в конце экспорта или перед ним.

Используйте результат проверки

  • Файлы: манифест связывает их хеши, подписи — журнал. Любое изменение будет заметно.
  • Ключ: сохранённый вами отпечаток подтверждает, что это тот самый ключ.
  • Прежнее состояние: контрольная точка сравнивает экспорт с началом журнала, сохранённым до передачи.
  • Охват: пробелы, результаты сбора и тест «отправить → изменить → удалить» показывают, что эта настройка действительно поймала.

Подробнее: что доказывает проверка.

Настройка внешней копии в S3

Экспорт → Внешняя копия в вашем пространстве. Работает с AWS S3 и любым S3-совместимым хранилищем. Копирует сегменты журнала, сохранённые файлы, контрольные точки с метками времени и готовые экспорты чатов, каждый шифруется AES-256-GCM ещё на сборщике.

В онлайн-демо эти настройки показаны с выключенной загрузкой. Настоящие учётные данные вводите только в своей установке.

Полная панель настроек для внешнего хранения: конечная точка, регион, хранилище, ключи доступа, расписание, управление функцией Object Lock и ключом восстановления
Вся форма с раскрытыми дополнительными настройками. Учётные данные хранилища не указаны.
Настройки хранения в разделе «Экспорт» → «Внешняя копия»
Область примененияЧто следует ввести
Конечная точкаURL хранилища, без пути к бакету и учётных данных. Пример: https://s3.example.invalid.
РегионЧто требует ваш провайдер. По умолчанию us-east-1.
КонтейнерСуществующий бакет с правом записи. Пример: example-case-backup.
Папка в хранилищеПрефикс, по умолчанию tgwitness. Поверх добавляется префикс пространства.
Идентификатор ключа доступа / Секретный ключ доступаОба вместе, хранятся в хранилище секретов. Чтобы оставить сохранённые, потом оставьте оба пустыми.
Адреса в формате «Path»Вкл.: endpoint/bucket. Выкл.: bucket.endpoint. Зависит от провайдера.
Интервал копированияОт 1 до 1440 минут, по умолчанию 5. Только пока приложение запущено.
Сохранение данных с помощью Object LockДни и режим, если бакет поддерживает Object Lock. Ноль оставляет настройку бакета по умолчанию.
  1. Создайте бакет, заполните адрес и учётные данные при снятой галочке Хранить внешнюю копию и нажмите Сохранить внешнюю копию.
  2. Проверить подключение загружает зашифрованный тестовый объект.
  3. Скачать ключ шифрования и храните его подальше от сборщика. Нет ключа — нет восстановления.
  4. Отметьте Хранить внешнюю копию, сохраните, затем Копировать сейчас или оставьте работать по расписанию.

Проверьте срок хранения и ход копирования

В разделе Дополнительно выберите срок хранения и GOVERNANCE или COMPLIANCE. TgWitness считывает срок с загруженного объекта и сообщает: подтверждён, отсутствует или проверка не удалась.

Панель показывает последний проход, число объектов, байты, скопированную границу журнала и ошибки. Отсутствующий локальный файл попадает в отчёт и повторяется в следующий раз, остальное копируется дальше.

Загрузка идёт напрямую, через SOCKS5 или HTTP. С маршрутом только через MTProxy копия ждёт с ошибкой.

Храните ключ восстановления отдельно

В JSON-ключе — ключ расшифровки, адрес, префикс и отпечаток ключа. Для восстановления нужен он и учётные данные хранилища с правом чтения.

Сменили адрес, бакет или префикс? Скачайте ключ заново. В новом месте начнётся свежая копия, старые экспорты чатов останутся там, где были.

Восстановление и проверка на другом компьютере

Нужны установка TgWitness, которой вы доверяете, JSON-ключ, учётные данные только для чтения и пустая папка:

Windows PowerShell

$env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY'
$env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY'
python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence

Linux / macOS

export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY'
export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY'
python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence

Сначала всё проверяется во временной закрытой папке: весь журнал, контрольные точки, хеши и размеры файлов. Небезопасные пути, конфликтующие сегменты или журнал короче контрольной точки — ошибка, и тогда ничего не записывается.

При успехе получите events.jsonl, media/, checkpoints/ и exports/. Сохраните JSON-вывод команды рядом и сверьте всё с контрольными точками или записями свидетеля, которые храните сами.