Справочник / Безопасность и проект
Модель безопасности TgWitness и хранение сессий
Модель угроз, модель доступа, защита конфиденциальных данных в состоянии покоя, сетевая уязвимость, импорт сеансов и порядок сообщения об уязвимостях.
TgWitness / Документация · Развертывание и восстановление
На этой странице описываются доступ, хранение и сетевая защита в локальной рабочей среде или на сервере. Для сбора данных на GitHub Runner или в конфиденциальной виртуальной машине Intel TDX см. режимы verification, которые добавляют проверки среды сбора данных. Подключения учетных записей, уведомления, временные метки, внешние копии и свидетели имеют собственные настройки маршрутизации.
| Область | Вкратце |
|---|---|
| Доступ | Ключ администратора, а также ограниченный доступ к аккаунтам и чатам, семь уровней прав доступа и сеансы с возможностью отзыва; по умолчанию используется localhost |
| Секреты в состоянии покоя | Настройки сеанса, пары API, ключа подписи и прокси шифруются с помощью алгоритма Fernet |
| Сообщения и мультимедиа | Файлы в рабочей области, защищенные шифрованием диска или тома и правами доступа к файлам хоста |
| Целостность | Цепочка хешей SHA-256 и подпись Ed25519 на каждой записи |
| Внешнее время | Квитанции по стандарту RFC 3161 и OpenTimestamps, записи свидетелей с датами от Telegram и подтверждения GitHub; сохраненные контрольные точки, записи свидетелей и измерения Intel TDX служат в качестве подтверждающих данных. Верификатор сообщает, каким условиям доказательности они соответствуют |
Информацию об отчетах об уязвимостях см. в политике безопасности.
На этой странице
Модель доступа#
Токен главной панели предоставляет полный контроль. Другие пользователи могут получать доступ с ограниченной областью действия: выбранные рабочие пространства и чаты, разрешения, срок действия, ограничения по IP, лимиты входа и отзывные сессии. Пользователь с доступом, ограниченным чатом, не может выполнять операции, затрагивающие всё рабочее пространство, даже если у него есть соответствующее разрешение. Каждая рабочая область имеет собственный журнал, хранилище и ключ подписи в рамках одного процесса; разделение пользователей на хосте осуществляется с помощью учетных записей операционной системы.
По умолчанию панель прослушивает соединения на localhost. При входе через браузер токен доступа обменивается на сессионные учетные данные; браузер отправляет их в виде токена «bearer». Он хранится в sessionStorage, а не в файле cookie аутентификации. Блокировка или выход из системы очищает сессию браузера. Закрытие браузера или завершение сессии не останавливает сбор данных.
Выданные токены и учетные данные сеанса хранятся в виде хэшей в зашифрованном хранилище. Отзыв токена приводит к завершению связанных с ним сеансов; изменения прав доступа влияют на последующие запросы. Загруженные файлы невозможно отозвать. Администратор может ограничить также свои собственные сеансы браузера, однако скрипты, использующие токен главной панели напрямую, сохраняют полный доступ и обходят эти ограничения сеансов браузера.
Число неудачных попыток аутентификации ограничивается по адресу клиента. При ограничении по IP-адресу используется адрес, видимый приложению; прежде чем полагаться на это ограничение, проверьте поведение обратного прокси-сервера. Учетные данные Witness остаются отдельными учетными данными для проверки работоспособности и контроля состояния, доступными только для чтения.
Доступ к демо-версии#
/api/demo-access представляет собой намеренно неаутентифицированный начальный код для явно
запущенной, изолированной синтетической демонстрационной версии. Он предоставляет отдельную возможность, действующую в течение срока жизни процесса,
но никогда не предоставляет реальный токен панели или переопределение TGWITNESS_TOKEN. Для выдачи и использования требуются
узел loopback и хост, отсутствие перенаправленных заголовков и отсутствие междоменных запросов. Дополнительные
рабочие пространства или авторизованная сессия блокируют этот путь. Активные рабочие пространства никогда не выдают
данную возможность. Демонстрационная версия не может связывать учетные записи или изменять настройки сбора данных.
Содержание панелей и экспорт данных#
На данном сайте не используются внешние шрифты, аналитические инструменты, ресурсы CDN или встроенные удалённые мультимедийные файлы. Текст из Telegram вставляется в виде текста, а не HTML. Загруженные вложения предоставляются в виде двоичных вложений. При экспорте в формат JSONL сохраняются исходные строки; в HTML они кодируются; ячейки CSV, которые могут содержать формулы, снабжаются префиксом в виде апострофа.
При экспорте исключаются секретные данные аутентификации и подписи, однако намеренно сохраняются собранные исходные метаданные, идентификаторы, а также, возможно, личный или конфиденциальный контент. В исходных метаданных могут присутствовать хэши доступа к Telegram и ссылки на файлы.
Секреты в состоянии покоя#
Учетные данные API Telegram, сессия и ключ подписи зашифрованы с помощью Fernet. Для локальных сообщений и мультимедиа шифрование обеспечивается диском или томом хоста; в рабочей области хранятся обычные файлы. При экспорте может использоваться ZIP-архив с защитой паролем по стандарту AES-256, а для внешних копий — AES-256-GCM.
По умолчанию ключ хранилища находится в каталоге защищённых данных. Используйте внешний файл мастер-ключа, указанный ниже, для его отдельного хранения. В Unix новые файлы закрытых ключей используют режим 0600, а новые каталоги данных — 0700; в Windows установите ACL каталога для учётной записи службы и авторизованных администраторов. Существующие права доступа к каталогу сохраняются.
Внешний мастер-ключ#
Для нового каталога данных TGWITNESS_VAULT_KEY_FILE может предоставлять внешний случайный главный ключ. HKDF-SHA256 и отдельный случайный соль вычисляют отдельный ключ Fernet для каждой рабочей области. Файл vault.external.json необходимо сохранить для восстановления. Отсутствие или неверность мастер-ключей приводит к сбою с закрытием. Существующие локальные хранилища не мигрируются автоматически. На панели отображается выбранный режим хранения ключей. Шифрование диска защищает локальные сообщения и мультимедийные файлы в любом режиме; подробности настройки см. в разделах « подключение» и « защита данных».
Прокси-серверы и сетевые маршруты#
Настройки прокси зашифрованы в хранилище. Пароли и секретные ключи MTProxy не возвращаются API и не записываются в записи доказательств. Каждая рабочая область выбирает свой маршрут Telegram и режим IP.
Функция «Скрыть адрес» отключает прямой резервный доступ к Telegram и требует использования прокси для внешних HTTP-запросов. Явно выбранный режим резервного доступа разрешает прямой доступ к Telegram после задержки; режим «туннель/VPN» разрешает прямые маршруты. Выбор режима «туннель» не влечёт за собой установку или проверку VPN. Эти настройки не контролируют весь трафик компьютера, браузеры, менеджеры пакетов или разрешение DNS локального прокси-хоста.
MTProxy передаёт исключительно трафик Telegram. Для внешних запросов можно использовать отдельный прокси SOCKS5/HTTP, маршрут SOCKS5/HTTP рабочей среды или разрешённый прямой маршрут; их также можно отключить. Независимый свидетель имеет собственные настройки транспорта. Обычная аутентификация SOCKS5/HTTP CONNECT не шифруется самими этими протоколами прокси. Поддельные секретные ключи TLS для MTProxy по-прежнему не поддерживаются.
Вход в систему и импорт сеансов#
Преобразованные файлы .tgwitness-session содержат секретный ключ авторизации в виде открытого текста до тех пор, пока они не будут загружены и сохранены в хранилище. Автономный интерфейс командной строки (CLI) поддерживает проверенные схемы Telethon. Функция импорта через панель управления дополнительно поддерживает форматы Pyrogram SQLite, современный ZIP-файл TData для одной учетной записи, а также задокументированные входы в формате JSON. Она проходит аутентификацию, ограничена четырьмя файлами / 8 MiB, и обрабатывает загрузки в памяти без извлечения архивов или сохранения исходных файлов. Нормализованные учетные данные возвращаются исключительно запрашивающему авторизованному браузеру; они сохраняются в зашифрованном хранилище после успешной авторизации в Telegram. Обеспечьте защиту исходных и преобразованных файлов и предотвратите клонирование авторизационных данных параллельными клиентами.
Обработка TData проверяет контрольные суммы контейнеров, хэши локального дешифрования и длину структур. Предоставленный локальный пароль Desktop используется временно и не сохраняется. Ограниченный парсер поддерживает форматы Desktop, которые он проверяет, и отклоняет остальные. Изображения QR-кодов генерируются локально, содержат краткосрочные токены входа в Telegram и никогда не отправляются во внешний сервис рендеринга. Блокировка, переключение рабочего пространства, новый вход и изменения маршрута отменяют ожидающие попытки сканирования QR-кода. Перезагрузка или закрытие вкладки может привести к тому, что попытка останется в ожидании до истечения срока действия. Успешный вход с помощью QR-кода по-прежнему требует привязки учетной записи. Размер обычных тел запросов API по-прежнему ограничен 16 КиБ; маршрут импорта с аутентификацией принимает до 12 МиБ закодированного JSON, при этом отдельно применяется меньший лимит на размер декодированного файла.
Коды входа и пароли двухэтапной аутентификации Telegram не сохраняются. Состояние номера телефона/хеша кода хранится в памяти во время авторизации. Сеансы Telegram предоставляют доступ к учётной записи; ни в коем случае не загружайте каталог данных, сеанс, токен, ключ хранилища или закрытый ключ подписи на GitHub.
Журналы и передача данных#
Ответ API по проверке по умолчанию заменяется, чтобы он не повторял значения учетных данных. Регистрация доступа приложения отключена. Не настраивайте обратный прокси на регистрацию заголовков авторизации или тел запросов. Панель прослушивает localhost; удаленный доступ осуществляется через предоставленный SSH-туннель, Cloudflare Tunnel или Caddy HTTPS, поэтому токены и секретные данные для входа передаются внутри SSH или TLS.
Целостность и внешнее время#
В ходе проверки осуществляется сравнение подписей записей, цепочки хэшей, вложений и манифеста экспорта
с ключом сборщика. Достоверная подпись свидетельствует о том, что байты не изменились с момента
их подписания. Каждая рабочая область создаёт свой ключ подписи при первом запуске и отображает его
отпечаток на панели, а также в каждом экспорте. Оператор передаёт отпечаток
получателю по отдельному каналу и --fingerprint закрепляет ключ.
Изменение, вставка или удаление записи приводит к разрыву хеш-цепочки или подписи, и
проверяющая сторона фиксирует это. Внешние временные метки и «свидетель» также фиксируют журнал за пределами
рабочей области. Триггеры SQLite на таблице журнала лишь предотвращают случайное
перезаписывание или удаление записи приложением. TGWITNESS_VAULT_KEY_FILE сохраняет ключ хранилища
вне копии каталога данных.
Квитанции по стандарту RFC 3161 и OpenTimestamps, а также сообщения-свидетельства, даты которых верификатор считывает из Telegram, привязывают префикс журнала, который они охватывают, к времени, установленному третьей стороной. Раунд drand, записанный в журнал, показывает, что записи, следующие за ним, были созданы не ранее публикации этого раунда. Проверенное подтверждение GitHub также содержит подтверждённое время своей подписи, что привязывает весь архив к внешнему времени. Контрольная точка подписывается ключом сборщика и привязывает записи, предшествующие ей, с момента получения её получателем по другому каналу. Свидетельство показывает, что второй ключ сохранил начало журнала; запись о контроле ключей хранителя показывает, кто владеет этим ключом. Оба являются вспомогательными проверками; минимум — это время, установленное третьей стороной. Запись GitHub Actions или развертывание Intel TDX добавляют информацию о происхождении рабочего процесса или аппаратные измерения среды сбора данных.
В каждом ответе на проверку перечислены условия доказательств с указанием способа проверки каждого из них, сгруппированные по их роли в минимальном наборе:
| Роль | Условие |
|---|---|
| Обязательно | Целостность; ключ подписывающего закреплён с помощью --fingerprint; внешнее время, охватывающее последнюю запись (квитанция по RFC 3161, проверенная с помощью --tsa-ca; квитанция OpenTimestamps, подтверждённая с помощью --check-bitcoin; сообщение свидетеля, прочитанное с t.me с помощью --channel; печать Bitcoin свидетеля или проверенное подтверждение GitHub) |
| Дополнительные функции, не входящие в минимальный набор | Свидетель с собственным ключом; сохраненная контрольная точка; заверенный цикл сбора данных |
Этот минимальные требования к доказательствам если все три обязательных условия выполняются в отношении последней экспортированной
записи; проверенный и заверенный цикл сбора данных добавляет attested профиль.
В последней строке приводится результат, а в ответе перечисляются варианты, которые соответствовали бы
неуказанным условиям. Без --fingerprint последняя строка начинается со слов
EVIDENCE: minimum not met · missing: confirmed signer key.
Если проверенные временные метки охватывают только более ранние записи, в ответе указывается запись, до
которой действует минимальное значение. --require evidence или --require attested программа завершается с кодом 2, если
профиль не достигнут для всего экспорта, а запрос на проверку в командной
строке, которую невозможно выполнить, фиксируется как невыполненная с тем же кодом. Каждый отчет
содержит информацию об одних и тех же условиях с указанием их состояния в данной копии и команды, которая их
проверяет. Уровни достоверности и --strict остаются доступными;
формат доказательств содержит перечень проверок для каждого режима сбора данных.
Если у вас возникли подозрения о наличии проблемы#
Сохраните исходный каталог данных и используйте отдельную копию для анализа. Сообщите о затронутой версии, операции и шагах, позволяющих воспроизвести проблему, через политику безопасности, сохраняя конфиденциальность данных учетной записи и учетных данных.