Документация / 14
Защита сессий Telegram и хранилища доказательств
Что уходит с вашей машины, что открывает каждый секрет и что защищено, а что остаётся на вас.
Где всё хранится
Сборщик, панель и все записи остаются на вашей машине. По умолчанию связь есть только с Telegram, всё остальное включается отдельно.
- 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-туннель.
- Проверяйте охват на пропуски и тестируйте доставку на своих аккаунтах и источниках.
Дайте доступ к делу с правами, сроком действия и лимитом сессий.
Усиление безопасности установки
- Используйте отдельный аккаунт Telegram, никогда не основной.
- Держите панель на 127.0.0.1. Удалённо — только через HTTPS (встроенный Caddy) или SSH-туннель.
- Зашифруйте диск с папкой данных.
- Ограничьте папку данных служебной учётной записью (0700 в Unix, права папки в Windows).
- Храните ключ хранилища отдельно на серверах: задайте
TGWITNESS_VAULT_KEY_FILEдо первого запуска. - Сохраняйте отпечаток и контрольные точки на другой системе, запустите свидетеля на другом хосте.
- Ни в коем случае не загружайте ключи
data/, сеансовые ключи,panel-token.txtили ключи хранилища на GitHub или в чат. - Не регистрируйте заголовки
Authorizationили тела запросов на обратном прокси-сервере.
Можно ли изменить токен панели без потери данных?
Да, он только открывает панель. Остановите TgWitness, удалите panel-token.txt, запустите снова. Журнал, сессии и ключи останутся. Если задан TGWITNESS_TOKEN, используется он, а не файл.
Сообщить об уязвимости
Security → Report a vulnerability на GitHub. Версия, последствия и минимальный пример на вымышленных данных. Никогда не присылайте учётные данные, папки аккаунтов или настоящие доказательства. Если приватные отчёты выключены, откройте issue с просьбой о закрытом канале, без деталей эксплойта.