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

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

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

Защита сессий Telegram и хранилища доказательств

Что уходит с вашей машины, что открывает каждый секрет и что защищено, а что остаётся на вас.

127.0.0.1Адрес панели по умолчанию
256-битныйслучайный токен панели
0CDN, аналитика или удалённые шрифты
Ed25519подпись на каждой записи

Где всё хранится

Сборщик, панель и все записи остаются на вашей машине. По умолчанию связь есть только с Telegram, всё остальное включается отдельно.

06 / ЧТО ОСТАЁТСЯ В СИСТЕМЕВаша установка
ВАШ КОМПЬЮТЕР ИЛИ СЕРВЕР
Панель127.0.0.1:8787 · токен bearer
Коллектородин клиент Telegram на каждое рабочее пространство
КАТАЛОГ ДАННЫХ
ЖурналSQLite · с цепочкой хешей · подписанный
СМИФайлы, имена которых сформированы на основе SHA-256
ХранилищеFernet · сессия, пара API, ключ подписи, прокси
  • TelegramВсегда · по вашему маршруту

    Тип подключения аккаунта по протоколу MTProto: прямое, SOCKS5, HTTP или MTProxy. Режим «Скрытие IP» ожидает подключения к рабочему прокси-серверу. Для перехода на прямое подключение в качестве резервного варианта требуется режим, явно разрешающий такую возможность.

  • Текст для внешних ресурсовНеобязательно · по умолчанию отключено

    Журнал, файлы и контрольные точки шифруются с помощью алгоритма AES-GCM перед загрузкой в хранилище, совместимое с S3. Ключ хранится у вас; вложения именуются по хэшам с ключом, а не по хэшам их содержимого.

  • УведомленияНеобязательно · по умолчанию отключено

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

  • Служба меток времениНеобязательно · по умолчанию отключено

    Только хеш SHA-256 подписанной контрольной точки и случайный нонс. Никаких сообщений, никаких имен участников чата.

  • СвидетельНеобязательно · по умолчанию отключено

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

По умолчанию: с данного компьютера выходит только соединение с Telegram.

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

Что открывает каждая тайна

СекретноГде хранитсяКакие возможности это открываетВ случае утечки
Токен панелиpanel-token.txt в папке данных; браузер хранит его для вкладкиВсё во всех пространствахОстановите TgWitness, удалите panel-token.txt, запустите снова — будет новый
Сессия TelegramХранилище, зашифрованное (credentials.enc)Сам аккаунт в TelegramЗавершите сессию в Telegram в разделе «Настройки» → «Устройства»
Ключ подписиХранилище, зашифрованное (signing.enc)Подпись записей вашим отпечаткомКонтрольные точки в другом месте, свидетель и метки времени по-прежнему показывают, что было раньше
Ключ хранилищаvault.key рядом с данными или внешний мастер-ключХранилище секретовСчитайте, что сессия и ключ подписи тоже утекли
Токен WitnessНа хостинге WitnessТолько чтение: контрольные точки и состояниеУдалите его на странице свидетеля и создайте новый
Ключевые фразы для текстов на внешних ресурсахVault; загрузите его один раз для восстановления данныхВнешнюю копиюТот, у кого есть ещё и бакет, может её расшифровать: считайте копию раскрытой

Что охватывают меры защиты

: освещено

  • Изменённая, удалённая или переставленная запись: ломается цепочка хешей или подпись.
  • Журнал обрезан или пересобран после того, как вы сохранили контрольную точку в другом месте: точка перестаёт совпадать.
  • Подбор токена: 256 случайных бит, сравнение за постоянное время, 15 ошибок в минуту — и адрес блокируется.
  • Враждебное содержимое чатов: текст остаётся текстом, не HTML; вложения скачиваются как файлы; панель ничего не грузит с чужих сайтов.
  • Украденная папка данных при внешнем ключе хранилища: сессии и ключи остаются зашифрованными.

Решать вам

  • Главный токен может всё. Давайте другим ограниченный доступ, а главный держите при себе.
  • Храните отпечаток и контрольные точки в другом месте.
  • Шифруйте диск и ограничивайте права.
  • Обычный HTTP вне localhost раскрывает токен. Используйте HTTPS или SSH-туннель.
  • Проверяйте охват на пропуски и тестируйте доставку на своих аккаунтах и источниках.

Дайте доступ к делу с правами, сроком действия и лимитом сессий.

Усиление безопасности установки

  1. Используйте отдельный аккаунт Telegram, никогда не основной.
  2. Держите панель на 127.0.0.1. Удалённо — только через HTTPS (встроенный Caddy) или SSH-туннель.
  3. Зашифруйте диск с папкой данных.
  4. Ограничьте папку данных служебной учётной записью (0700 в Unix, права папки в Windows).
  5. Храните ключ хранилища отдельно на серверах: задайте TGWITNESS_VAULT_KEY_FILE до первого запуска.
  6. Сохраняйте отпечаток и контрольные точки на другой системе, запустите свидетеля на другом хосте.
  7. Ни в коем случае не загружайте ключи data/, сеансовые ключи, panel-token.txt или ключи хранилища на GitHub или в чат.
  8. Не регистрируйте заголовки Authorization или тела запросов на обратном прокси-сервере.
Можно ли изменить токен панели без потери данных?

Да, он только открывает панель. Остановите TgWitness, удалите panel-token.txt, запустите снова. Журнал, сессии и ключи останутся. Если задан TGWITNESS_TOKEN, используется он, а не файл.

Сообщить об уязвимости

Security → Report a vulnerability на GitHub. Версия, последствия и минимальный пример на вымышленных данных. Никогда не присылайте учётные данные, папки аккаунтов или настоящие доказательства. Если приватные отчёты выключены, откройте issue с просьбой о закрытом канале, без деталей эксплойта.