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

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

TGWITNESS / СПРАВОЧНИК

Справочник по сбору и проверке данных Telegram

Все документы проекта со схемами. Руководства — короткий путь, здесь — все подробности.

Установка

01

TgWitness: запуск, масштаб и доказательства

Установка одной командой или сбор через GitHub Actions. Сценарии расследования, опубликованный масштаб и смысл проверки архива.

02

Быстрый старт

Все способы установки и запуска TgWitness: пакет для Windows, Python, Docker и синтетическая демонстрационная версия с первыми проверками.

03

Установка, проверка и обновление

Установите с помощью одной команды, проверьте подписи и хеши, обновите и удалите установку.

04

Первоначальная настройка и параметры

Мастер настройки, цели, уровни интерфейса, маршруты подключения и настройки, общие для группы аккаунтов.

05

Аккаунты и форматы сессий

Войдите в систему с помощью телефона, QR-кода или ключа аутентификации, импортируйте сеансы из Telethon, Pyrogram или Telegram Desktop и управляйте несколькими учётными записями.

06

Доступ и разрешения

Устанавливайте ограниченный доступ к аккаунтам и чатам, выбирайте права доступа, ограничивайте количество сеансов и IP-адресов, а также отзывайте доступ.

07

Подключение, прокси и защита данных

Аутентификация, автоматические пулы прокси-серверов, режимы работы с IP-адресами, политика резервного переключения, внешние запросы и хранение секретных данных.

08

Развёртывание

Запускайте TgWitness в качестве службы на Windows, Linux, macOS или в Docker, через HTTPS, с резервным копированием и обновлениями.

09

Развертывание с высоким уровнем безопасности

Защищённый сервер, работающий круглосуточно на Hetzner или Phala Cloud, шлюзовой DNS и проверки, которые может повторить любая третья сторона.

Сбор

10

Руководство по панелям

Все экраны панели: чаты, дневник, источники, экспорт, «Дополнительно», режимы защиты и проверка кода.

11

Как устроен сбор

Объём наблюдения, обновления в режиме реального времени, повторные проверки, вложения, собственные действия и значение пробелов — запись за записью.

12

Секретные чаты: настройка и запись

Установите протокольный модуль секретных чатов, включите его для аккаунта и записывайте чаты, которые TgWitness создаёт или принимает.

13

Загрузить историю источников

Загрузка прошлых сообщений из включенных источников, приостановка и возобновление, а также проверка подписанного отчета о ходе работы.

14

Работа и обслуживание

Ежедневная эксплуатация панели управления: режимы работы, категории мониторинга, параметры, уведомления, экспорт данных, резервное копирование и емкость хранилища.

15

Режим расследования

Комплексные расследования по всем учетным записям, включая каналы, группы, личные чаты и ботов — от определения объёма расследования до формирования подтверждённого пакета материалов по делу.

16

Возможности и охват

Текущая модель сбора данных, рабочие процессы с несколькими учетными записями, экспорт данных и операционные ограничения TgWitness.

Архив и интеграции

17

Справочная информация по Case Board

Закладки, точные выделения, фрагменты действий, обсуждения, ограниченный доступ и история подписанных аннотаций, используемые в Case Board.

18

Анализ архива

Выполняйте поиск по сохраненным сообщениям, просматривайте данные, обработанные искусственным интеллектом, и ведите аналитические отчеты с указанием источников.

19

Полнотекстовый поиск

Поиск сохраненных сообщений по формам слов, точным фразам, доменам и @именам пользователей, с отображением наиболее подходящих результатов в первую очередь, при этом индекс привязан к подписанному журналу.

20

MCP только для чтения

Подключите клиент MCP к выбранным рабочим пространствам и чатам с ограниченным по времени и отзывным доступом.

21

Командная строка

Поиск, чтение контекста, подсчёт активности и экспорт сохраненных сообщений из скриптов и агентов с выводом в формате --json, стабильными кодами завершения и токенами с ограниченной областью действия, доступными только для чтения.

22

Локальное распознавание текста (OCR) и транскрипция

Распознавайте захваченные изображения и аудио с помощью локального рабочего процесса; сохраняйте полученный текст с привязкой к исходному файлу.

23

Исходящие веб-хуки

Отправка событий в заданном диапазоне на HTTPS-приемники с HMAC-подписями, повторными попытками и статусом доставки.

24

Публичная витрина

Публикуйте сохраненные сообщения из выбранных публичных каналов и подписанные снимки состояния по ссылкам с ограниченным сроком действия и возможностью отзыва.

Доказательства

25

Как устроены доказательства

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

26

Настройка и проверка отчетов

Фильтры отчетов, восемь шаблонов дизайна, предустановленные настройки содержания, сохраненная история изменений и оценка, включённая в подписанные экспортные файлы.

27

Экспорт аккаунта

Экспорт того, что аккаунт может прочитать в данный момент: область действия, возобновляемые задания, подписанный архив и сжатые копии для обмена.

28

Формат доказательств

Содержимое подписанного ZIP-архива, типы записей, подтверждения обработки, профили пользователей, внешние копии и офлайн-проверка.

29

Перевод отчётов для суда

Какой файл является оригиналом, что подавать вместе с заверенным переводом и какие термины сохраняют переводчики.

30

Независимый свидетель

Запустите Witness с собственным ключом и ботом, публикуйте подписанные контрольные точки в канале и сверяйте экспортированные данные с ними.

31

Метки времени

Временные метки RFC 3161 для подписанных контрольных точек: что отправляется в центр авторизации и как проверяется ответ.

32

Хранение и восстановление

Резервное копирование, перемещение старых файлов в облако, копии с защитой Object Lock и восстановление на новом компьютере.

Безопасность и проект

33

Безопасность и обращение с данными

Модель угроз, модель доступа, защита конфиденциальных данных в состоянии покоя, сетевая уязвимость, импорт сеансов и порядок сообщения об уязвимостях.

34

Архитектура

Компоненты системы: сборщик, панель управления, журнал, рабочие процессы и модуль «witness», а также схема передачи данных между ними.

35

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

Тестирование Telegram в режиме реального времени, автоматические проверки, проверки в браузере и следующие квалификационные прогоны.

36

Уведомление о несовместимости лицензий и архитектуры

TgWitness распространяется по лицензии MIT для всех, и почему он архитектурно несовместим с рабочим процессом Taylor Wessing.

37

Уведомление о несовместимости с операторами

Наше уведомление оператора о компании Taylor Wessing и её исходных данных.

38

Список изменений

Все изменения по версиям, включая те, которые ещё не выпущены.

В данных руководствах описывается текущая реализация. Результаты валидации и остающиеся пробелы документируются отдельно. Что проверено →