TGWITNESS / СПРАВОЧНИК
Справочник по сбору и проверке данных Telegram
Все документы проекта со схемами. Руководства — короткий путь, здесь — все подробности.
Установка
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 и проверки, которые может повторить любая третья сторона.
Сбор
Руководство по панелям
Все экраны панели: чаты, дневник, источники, экспорт, «Дополнительно», режимы защиты и проверка кода.
11Как устроен сбор
Объём наблюдения, обновления в режиме реального времени, повторные проверки, вложения, собственные действия и значение пробелов — запись за записью.
12Секретные чаты: настройка и запись
Установите протокольный модуль секретных чатов, включите его для аккаунта и записывайте чаты, которые TgWitness создаёт или принимает.
13Загрузить историю источников
Загрузка прошлых сообщений из включенных источников, приостановка и возобновление, а также проверка подписанного отчета о ходе работы.
14Работа и обслуживание
Ежедневная эксплуатация панели управления: режимы работы, категории мониторинга, параметры, уведомления, экспорт данных, резервное копирование и емкость хранилища.
15Режим расследования
Комплексные расследования по всем учетным записям, включая каналы, группы, личные чаты и ботов — от определения объёма расследования до формирования подтверждённого пакета материалов по делу.
16Возможности и охват
Текущая модель сбора данных, рабочие процессы с несколькими учетными записями, экспорт данных и операционные ограничения TgWitness.
Архив и интеграции
Справочная информация по Case Board
Закладки, точные выделения, фрагменты действий, обсуждения, ограниченный доступ и история подписанных аннотаций, используемые в Case Board.
18Анализ архива
Выполняйте поиск по сохраненным сообщениям, просматривайте данные, обработанные искусственным интеллектом, и ведите аналитические отчеты с указанием источников.
19Полнотекстовый поиск
Поиск сохраненных сообщений по формам слов, точным фразам, доменам и @именам пользователей, с отображением наиболее подходящих результатов в первую очередь, при этом индекс привязан к подписанному журналу.
20MCP только для чтения
Подключите клиент MCP к выбранным рабочим пространствам и чатам с ограниченным по времени и отзывным доступом.
21Командная строка
Поиск, чтение контекста, подсчёт активности и экспорт сохраненных сообщений из скриптов и агентов с выводом в формате --json, стабильными кодами завершения и токенами с ограниченной областью действия, доступными только для чтения.
22Локальное распознавание текста (OCR) и транскрипция
Распознавайте захваченные изображения и аудио с помощью локального рабочего процесса; сохраняйте полученный текст с привязкой к исходному файлу.
23Исходящие веб-хуки
Отправка событий в заданном диапазоне на HTTPS-приемники с HMAC-подписями, повторными попытками и статусом доставки.
24Публичная витрина
Публикуйте сохраненные сообщения из выбранных публичных каналов и подписанные снимки состояния по ссылкам с ограниченным сроком действия и возможностью отзыва.
Доказательства
Как устроены доказательства
Объяснение принципов работы цепочки хешей, подписей, контрольных точек и свидетелей с указанием точных формул, используемых верификатором.
26Настройка и проверка отчетов
Фильтры отчетов, восемь шаблонов дизайна, предустановленные настройки содержания, сохраненная история изменений и оценка, включённая в подписанные экспортные файлы.
27Экспорт аккаунта
Экспорт того, что аккаунт может прочитать в данный момент: область действия, возобновляемые задания, подписанный архив и сжатые копии для обмена.
28Формат доказательств
Содержимое подписанного ZIP-архива, типы записей, подтверждения обработки, профили пользователей, внешние копии и офлайн-проверка.
29Перевод отчётов для суда
Какой файл является оригиналом, что подавать вместе с заверенным переводом и какие термины сохраняют переводчики.
30Независимый свидетель
Запустите Witness с собственным ключом и ботом, публикуйте подписанные контрольные точки в канале и сверяйте экспортированные данные с ними.
31Метки времени
Временные метки RFC 3161 для подписанных контрольных точек: что отправляется в центр авторизации и как проверяется ответ.
32Хранение и восстановление
Резервное копирование, перемещение старых файлов в облако, копии с защитой Object Lock и восстановление на новом компьютере.
Безопасность и проект
Безопасность и обращение с данными
Модель угроз, модель доступа, защита конфиденциальных данных в состоянии покоя, сетевая уязвимость, импорт сеансов и порядок сообщения об уязвимостях.
34Архитектура
Компоненты системы: сборщик, панель управления, журнал, рабочие процессы и модуль «witness», а также схема передачи данных между ними.
35Что проверено
Тестирование Telegram в режиме реального времени, автоматические проверки, проверки в браузере и следующие квалификационные прогоны.
36Уведомление о несовместимости лицензий и архитектуры
TgWitness распространяется по лицензии MIT для всех, и почему он архитектурно несовместим с рабочим процессом Taylor Wessing.
37Уведомление о несовместимости с операторами
Наше уведомление оператора о компании Taylor Wessing и её исходных данных.
38Список изменений
Все изменения по версиям, включая те, которые ещё не выпущены.