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

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

Справочник / Установка

Прокси Telegram и безопасность подключения

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

TgWitness / Документация · Развертывание и восстановление

Развертывание и восстановление

В данном документе описывается поведение TgWitness0.9.3 и его ограничения. Аутентификация, доступ к исходным данным, сетевая связь и полнота сбора данных представляют собой отдельные состояния. Информацию о шагах входа в систему, форматах файлов и работе с несколькими учётными записями см. в разделе Форматы учётных записей и сеансов. Информацию о политиках событий и поведении при перезапуске см. в разделе Как работает сбор данных.

Пошаговая инструкция по настройке подключения#

В разделе Дополнительные инструменты → Учётная запись → Маршрут подключения администратор может выбрать «Эта учётная запись», Группа учётных записей или Все учётные записи, а затем выбрать маршрут. В разделе Просмотр выбора отображается список затронутых учётных записей. Функция Подготовить и проверить позволяет протестировать предложенный маршрут без изменения сохраненного. Функция Применить проверенное подключение подтверждает предварительный просмотр, приостанавливает мониторинг, если это необходимо, сохраняет маршрут и возобновляет уже запущенный мониторинг. Сбор данных никогда не запускается в учетной записи, которая ранее находилась в неактивном состоянии. Загрузка истории остается приостановленной и может быть возобновлена отдельно. Перед переключением приостановите активные экспорты.

Изменения в группе по умолчанию сохраняют учетные записи с их собственным маршрутом. Снимайте эту опцию только тогда, когда в предварительном просмотре отображаются именно те изменения, которые вы намереваетесь внести. Приложение сообщает о результатах для каждой учетной записи; это не транзакция типа «всё или ничего» между базами данных. В случае неудачного переключения восстанавливаются предыдущие настройки этой учетной записи. Невозможность возобновления отображается явно. Срок действия предварительного просмотра истекает через десять минут, а изменения в настройках подключения или членстве в группах требуют новой проверки.

Функция «Apply» повторно использует успешный результат предварительной проверки в течение максимум 90 секунд, если маршрут, режим и политика остаются неизменными. Управляемый туннель по-прежнему должен иметь тот же запущенный процесс. Более старые результаты, измененные процессы туннелей и автоматические маршруты пула MTProxy проверяются заново. Подписанная запись приложения сохраняет исходное время проверки и фиксирует повторное использование, а также его возраст. Каждая предварительная проверка закрывает свой временный неавторизованный клиент; коллектор подключается, используя собственную авторизованную сессию.

Маршрут Что управляет TgWitness
Прямой Подключения с хоста; VPN внешнего хоста не обнаруживается и не принудительно применяется.
VPN Один профиль WireGuard с полным туннелем на каждую учетную запись, реализуемый локальным процессом SOCKS5 в пользовательском пространстве. Никаких сетевых интерфейсов или драйверов не устанавливается.
Мой прокси Учетные данные SOCKS5, HTTP CONNECT или MTProxy. В поля SOCKS5/HTTP можно ввести URL-адрес. При выборе нескольких учетных записей введенный прокси-сервер используется для всех них.
Публичный MTProto Существующий пул назначает маршруты Telegram. Внешние запросы отключены до тех пор, пока в расширенных настройках не будет настроен отдельный подходящий прокси-сервер.
WARP Отдельный локальный туннель для каждой выбранной учетной записи с регистрацией в WARP и профилем WireGuard, хранящимся в хранилище этой учетной записи.

При проверке текущего маршрута используется новый неавторизованный транспорт Telegram, а не сессия учетной записи. При этом открывается транспортное соединение по маршруту к центру обработки данных учетной записи и выполняется один цикл обмена данными по протоколу MTProto без аутентификации (req_pq_multi); при этом не создаётся ключ авторизации и не используется учётная запись. Указанная задержка представляет собой время соединения плюс время обмена данными, и проверка регистрирует обе части отдельно. Для маршрутов, поддерживающих HTTP, также запрашивается HTTPS-трассировку Cloudflare по этому маршруту и отображает указанный в ней IP-адрес выхода, страну, состояние WARP и время проверки. Подготовка WARP завершается сбоем, если трассировка не сообщает об активном состоянии WARP. Эти предварительные проверки сообщают о доступности маршрута и наблюдаемом выходе. Просмотрите захваченные записи в результатах сбора и верификации архива. Один только запущенный локальный процесс не является успешной проверкой выхода.

Панель рассчитывает скользящее среднее значение по последним пяти проверкам. Маршрут считается медленным, если среднее значение превышает 5 секунд или три проверки подряд превышают это значение, и считается недоступным после двух неудачных проверок подряд; network.slow_route и network.route_recovered записывает изменения. Для медленного маршрута WARP функция Re-roll WARP перезапускает туннель учетной записи через другие конечные точки Cloudflare WARP, сохраняет самый быстрый вариант и записывает network.warp_rerolled с указанием времени до и после; New WARP identity регистрирует новое устройство WARP и сохраняет его только в том случае, если оно работает быстрее. Адрес локального прокси, учётная запись Telegram и её сессия остаются прежними; соединения Telegram восстанавливаются через перезапущенный туннель. Медленный маршрут WARP перезапускается автоматически не чаще одного раза в 30 минут; если это не помогает, дальнейшие перезапуски ожидают вмешательства оператора.

Портативные версии WARP и WireGuard#

Это неофициальная интеграция с WARP с использованием wgcf 2.3.1 и wireproxy 1.1.3 . Администратор явно соглашается с настройкой перед первой загрузкой или регистрацией в WARP. Эти соединения для настройки устанавливаются напрямую с GitHub и Cloudflare и раскрывают IP-адрес компьютера. Трафик обычных учётных записей сохраняет существующий маршрут до момента запуска приложения. Cloudflare выбирает адрес выхода и страну; отдельные туннели могут использовать один и тот же адрес выхода. Выбор страны, периодическая ротация IP-адресов и общесистемный VPN-kill-switch не поддерживаются данной функцией.

Поддерживаемые версии вспомогательных программ: Linux и macOS x86-64/ARM64, а также Windows x86-64. Артефакты сверяются с хешами SHA-256, включёнными в проверяемый исходный код, а кэшированные исполняемые файлы проверяются повторно перед запуском. Ни одна вспомогательная утилита не добавляется в PATH, не устанавливается в качестве системной службы и не получает общедоступного прослушивателя. Все файлы находятся в каталоге portable-routes/ рабочей области и в зашифрованных записях хранилища. Для прослушивателя loopback SOCKS5 требуются независимо сгенерированные учетные данные.

Личные профили и учетные данные учетной записи WARP шифруются с помощью существующего хранилища рабочей среды. Во время работы вспомогательной программе требуется конфигурационный файл в виде открытого текста, доступный только владельцу; при нормальном завершении работы он удаляется. В случае сбоя хоста этот файл может остаться в папке данных, доступной только владельцу. Это не обеспечивает шифрование диска и не защищает от его администратора. Супервизор закрывает туннель, если родительский канал панели исчезает. Неудавшийся туннель никогда не включает прямой резервный вариант. Перезапуск панели восстанавливает выбранный туннель; неудавшиеся запуски повторяются с ограниченной задержкой. Stop tunnel также приостанавливает мониторинг и сохраняет состояние остановки. Start tunnel запускает туннель; возобновите мониторинг отдельно, когда будете готовы.

Загруженные профили WireGuard должны содержать один интерфейс и один узел, полные маршруты IPv4 и IPv6, а также не должны содержать хуков, включений, подстановок переменных среды или дополнительных прослушивателей. Адреса публичных конечных точек разрешаются и фиксируются перед запуском. Используйте внешний VPN или шлюз SOCKS5 для OpenVPN/IPsec и частных конечных точек.

Методы аутентификации#

Идентификатор API и хеш API служат для идентификации приложения; они не заменяют данные для входа в учётную запись. Их использование в TgWitness не является обязательным. Приоритет: сначала пара, введённая в форму, затем — из импортированного JSON-файла учётной записи, далее — пара, сохранённая в рабочей области, и, наконец, встроенный пул из 50 общедоступных пар, которые пробуются в случайном порядке с автоматической ротацией в случае отказа Telegram. Только пара Telegram Desktop (2040) отправляется с соответствующим описанием клиента Telegram Desktop. Ваша собственная пара из инструментов разработки API на сайте my.telegram.org может использоваться со всеми вашими учётными записями; при этом каждая учётная запись по-прежнему имеет собственную авторизацию.

Метод Требования Служба поддержки TgWitness
Номер телефона, код, двухфакторная аутентификация (2FA) — по желанию Доступ к учётной записи; пара API не обязательна Вход в панель управления
HEX-код авторизационного ключа + DC-идентификатор Полный ключ длиной 512 символов и DC 1–5 Вкладка «Ключ прямой авторизации»; при желании перед сохранением авторизации проверяется идентификатор пользователя
Telethon StringSession Действительная строка сеанса Вход в панель управления
Telethon SQLite .session Закрытый, последовательный текст Прямой импорт схем через панель управления 7/8; опциональный автономный интерфейс командной строки (CLI)
Pyrogram SQLite .session Закрытая производственная сессия пользователя Прямой импорт схем через панель 2/3
Telegram Desktop TData ZIP Одна современная учетная запись; локальный пароль, если учетная запись защищена Преобразование в памяти с проверкой контрольных сумм и расшифровки
JSON-файл учетной записи Поддерживаемые поля API/сессии/ключа Метаданные сами по себе заполняют учетные данные API; по-прежнему требуется вход с помощью сеанса/ключа или номера телефона/QR-кода
Вход с помощью QR-кода Подтверждение от официального приложения Telegram Локальное генерация QR-кодов, управление сроком действия и повторными попытками, опциональная двухфакторная аутентификация (2FA)
TDLib / Pyrogram StringSession Другие форматы, специфичные для библиотек Не поддерживается
Токен бота Бот с собственной моделью доступа и обновления Не используется данным сборщиком данных

Telegram выбирает способ доставки кода, в том числе решает, отправлять ли SMS. Хеш API не может восстановить отмененную сессию или заменить забытый пароль 2. TgWitness не сохраняет коды входа или пароль 2 Telegram на диске.

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

Импорт файла сеанса Telethon#

Telethon SQLite, Pyrogram SQLite и Telegram Desktop TData используют разные форматы. Панель определяет и преобразует поддерживаемые структуры; переименование файла не является преобразованием. Выберите один сеанс и сопутствующий ему файл JSON в разделе Файлы, нажмите Проверить файлы, а затем Подключить аккаунт. Допускается до четырёх совпадающих файлов и общий объём до 8 MiB. См. ограничения по формату для получения подробной информации о TData/JSON. Восстановление пароля невозможно. Вход с помощью телефона/двухфакторной аутентификации (2FA) или QR-кода создаёт отдельную авторизацию.

Дополнительный путь командной строки, доступный исключительно для Telethon, по-прежнему остается в использовании:

  1. Прекратите работу клиента, использующего исходную сессию, и создайте точную копию. Конвертер отклоняет файлы с незавершённым журналом WAL. Закройте исходный клиент надлежащим образом, а не удаляйте эти файлы, чтобы обойти проверку.
  2. Из среды TgWitness выполните следующую команду:
python -m tgwitness.sessions account.session --out account.tgwitness-session
  1. В разделе «Добавить аккаунт» → «Файлы» загрузите результат или вставьте его строку и продолжайте.
  2. Проверьте отображаемый цифровой идентификатор аккаунта, выберите источники и начните наблюдение.

Преобразованный файл представляет собой незашифрованный секретный ключ доступа к учётной записи. Храните его в защищённом месте и ни в коем случае не фиксируйте его в репозитории и не отправляйте сторонним сервисам конвертации. TgWitness сохраняет авторизованную сессию в своём зашифрованном хранилище. Копирование сессии не приводит к созданию отдельной авторизации: не запускайте одновременно несколько клиентов с клонированными ключами авторизации и не предполагайте независимую доставку обновлений.

Преобразование передаёт авторизацию, а не исходные сообщения, кэш объекта или постоянный курсор обновления. Оно не обеспечивает восстановление обновлений после перезапуска процессов.

MTProto, Telethon и прокси-серверы#

MTProto — это протокол Telegram. Telethon — это библиотека клиента на языке Python, которую использует TgWitness. MTProxy — это транспортный прокси Telegram; SOCKS5 и HTTP CONNECT обеспечивают общие туннели. Ни один из них не заменяет аутентификацию учетной записи.

Сохраните маршрут для каждой рабочей области в разделе Дополнительные инструменты → Учётная запись → Настройки → Настройки подключения → Изменить маршрут подключения перед входом в систему. Для новых рабочих областей по умолчанию установлен режим Автоматический MTProxy · публичные списки с опцией Скрыть адрес. Существующие рабочие области, в которых явно использовался режим Прямой, сохраняют режим, допускающий его использование.

Файлы читаются по отдельным соединениям, отличным от того, по которому читаются сообщения, как это делается в официальных приложениях. В собственном центре обработки данных учетной записи ключ авторизации учетной записи используется повторно в новой сессии MTProto; для другого центра обработки данных создается один ключ, который авторизуется во время подключения учетной записи и хранится только в памяти. Каждое соединение для работы с файлами использует тот же маршрут, что и учетная запись. Их количество на каждый центр обработки данных ограничено в разделе Параметры → Производительность → Количество файловых соединений на один центр обработки данных Telegram; при значении 0 файлы читаются только через основное соединение аккаунта. Одновременно может быть установлено не более пяти соединений с Telegram для всех аккаунтов в рамках одной установки.

Режимы IP#

Маршрут выбирает тип подключения. Режим IP, настройка «Защита IP» в разделе «Аккаунт» панели управления, определяет, когда адрес сервера может быть раскрыт. Эти настройки не устанавливают VPN и не перенаправляют весь трафик устройства.

Режим Telegram Внешние запросы
Скрыть адрес (hide) Используйте прокси; если ни один из них не работает, подождите. Прямого резервного варианта нет. Требуется SOCKS5/HTTP; запросы без соответствующего прокси-сервера отклоняются.
Direct — в крайнем случае (fallback) Автоматический MTProxy может использовать Direct по истечении настроенной задержки, а затем вернуться к рабочему прокси-серверу. Предпочтительно использовать настроенный внешний прокси-сервер или маршрут SOCKS5/HTTP учетной записи; в противном случае допускается использование прямого подключения.
Сервер, расположенный за туннелем или VPN (tunnel) Допускаются прямые маршруты и немедленное переключение на резервный пул. Прямой доступ разрешён, если не настроено соответствующее прокси-сервер.

Режим «туннель» или «VPN» предполагает, что вы управляете этой сетью отдельно. Без работающего туннеля адресаты могут увидеть собственный адрес сервера. Выбирайте режим в соответствии с вашей фактической сетью, а не по названию опции.

Выберите вариант#

Маршрут Настройки Границы
Автоматический MTProxy Встроенные списки или каталог операторов Поддерживается рабочий маршрут Telegram; выбор альтернативного варианта зависит от режима IP
Прямой Режим «Туннель» или «VPN» Telethon использует сетевой маршрут хоста
SOCKS5 Хост, порт, опционально — имя пользователя/пароль python-socks, поддержка удалённого DNS-адреса
HTTP CONNECT Хост, порт, опционально — имя пользователя/пароль Используется простой HTTP-запрос CONNECT; поддержка TLS для самого прокси не реализована
MTProxy Хост, порт, секретный ключ Экспериментальный формат передачи данных Telethon: 32 шестнадцатеричных цифры или «dd» + 32 шестнадцатеричных цифры

Поддельные секретные ключи TLS ee отклоняются. Функция нормализации в Telethon 1.45 может удалять префикс и домен, однако это не реализует механизм Fake TLS. Вставьте tg://proxy?server=…&port=…&secret=… или https://t.me/proxy?server=…&port=…&secret=… и выберите «Заполнить поля из ссылки». При этом происходит проверка и заполнение полей без установления соединения или сохранения; проверьте и сохраните маршрут отдельно. Поля для ручного ввода остаются доступными. См. ссылки на прокси Telegram.

Общедоступные прокси-серверы, предоставляемые вашей установкой#

Встроенный список объединяет семь источников: SoliSpirit/mtproto, zakky8/mtproto-proxy-pro, kort0881/telegram-proxy-collector, 3yed-61/MTP-Collector, Therealwh/MTPproxyLIST, KhodeJav/telegram-proxy-collector и tgmtproxy/telegram-mtproto-proxy-list. Включённый в пакет снэпшот содержит данные о конечных точках, информацию об авторах источников и даты загрузки. Списки являются исходными данными; приведённые ниже проверки доступности определяют, какие прокси будут использоваться.

Автоматический MTProxy проверяет подключение к транспортному каналу Telegram, поддерживает рабочий прокси-сервер и переключается на другой в случае сбоя. Рабочие пространства предпочитают разные прокси-серверы, когда доступно достаточное количество рабочих записей; прокси-серверы могут использовать общий выходной адрес. Неработающие прокси-серверы отдыхают перед повторной попыткой. Если ни один не работает, режим IP определяет, должна ли сборка данных ждать или может использовать прямое соединение. Смена прокси не приводит к смене учётной записи или удалению её журнала. Выбор и изменения маршрутов записываются в подписанный журнал.

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

Трафик Telegram и HTTPS-запросы используют разные маршруты. Загрузка списков осуществляется через отдельное HTTPS-соединение и предоставленный маршрут внешних запросов. TGWITNESS_PROXY_FEED_PROXY явно переопределяет этот маршрут с помощью HTTP/SOCKS5-прокси; оба варианта сборщика Compose перенаправляют его. Фоновый пул следует за основным рабочим пространством. Ни сеансы Telegram, ни учетные данные API, ни токен панели, ни токен бота не передаются поставщикам данных. Названия поставщиков, даты создания моментальных снимков и маршрут загрузки указаны в разделе «Откуда взят список».

MTProxy передаёт только трафик Telegram. HTTP-операции рабочего пространства, такие как временные метки, уведомления, внешние копии и проверки источников, используют отдельный SOCKS5/HTTP-прокси, если он настроен, а затем — маршрут SOCKS5/HTTP аккаунта. При отсутствии того или другого «Скрыть адрес» отклоняет запрос; остальные режимы разрешают «Прямой». Внешние запросы можно отключить. Явно настроенный прокси для загрузки ленты остаётся отдельным переопределением оператора. Независимый сервис свидетелей использует свой собственный маршрут.

Для частных сервисов, управляемых оператором, существующая настройка серверной среды TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1 разрешает частные адреса назначения и сохраняет разрешение имен хостов на стороне прокси. Её нельзя включить через панель управления. Режим «только публичные» отклоняет адреса назначения в формате .onion перед отправкой запроса в публичный резолвер; для onion-сервисов Tor требуется явная настройка частных адресов назначения и подходящий прокси. Данное поведение DNS применимо к внешним HTTP-операциям, а не к транспортному протоколу Telegram. Cloudflare предоставляет документацию по JSON-конечной точке DNS.

Параметры автоматического пула

В разделе Дополнительные инструменты → Параметры → Автоматический MTProxy настройте порог сбоя, время ожидания, плановую ротацию, совместное использование прокси и допустимую задержку переключения на резервный сервер.

Контроль По умолчанию
Отключается перед заменой 3 в течение 10 минут
Количество проб прокси-серверов на каждую попытку подключения 3
Первый / максимальный перерыв после сбоя 10 минут / 6 часов
Планируемая ротация Отключено; включить при сбое
Учётные записи на один прокси 0: предпочтительно создавать отдельные записи, объединять их при необходимости. Установите 1, чтобы дождаться появления эксклюзивной записи.
Задержка перед разрешенным прямым переходом на резервный вариант Протоколы 10; Скрытие адреса по-прежнему не работает Direct
Обновление ленты / проверки передачи данных Протоколы 60 / 10; значения основного рабочего пространства применяются к общему пулу

Различные прокси-серверы могут использовать один и тот же адрес выхода. Ограничения Telegram применяются на каждом маршруте.

Чтобы заменить общедоступный список на свой собственный каталог операторов, настройте приведённую ниже переопределение. Это полностью отключает внешние подписки, в том числе в случае, когда массив proxies пуст.

Скопируйте пустой каталог в папку «proxy-config/proxies.json » и добавьте ваши развернутые публичные конечные точки:

{"format": "tgwitness-proxy-catalog-v1", "proxies": [
  {"id": "project-eu", "label": "Project EU",
   "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}

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

Запуск в нативной среде: укажите TGWITNESS_PROXY_CATALOG в качестве локального пути к файлу JSON. Docker:

docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build

Накладка монтирует каталог proxy-config в режиме «только для чтения»; файлы должны быть доступны для чтения контейнеру с UID 10001. Данный каталог исключён из Git, контекста сборки Docker и архивов исходного кода. В этом каталоге настраиваются учётные записи для сбора данных; бот-свидетель использует собственный маршрут HTTP/SOCKS5, а не MTProxy.

Прямой резервный вариант регулируется описанным выше IP-режимом. Приостановите наблюдение перед изменением маршрута. Сохранение отключает старые клиенты и отменяет незавершённый вход в систему; новый клиент использует сохранённый маршрут. Связь между учётной записью и журналом/сессией сохраняется. Настройки заменяют предыдущий маршрут: при их редактировании необходимо повторно ввести учетные данные прокси.

Учетные данные шифруются с использованием алгоритма network.enc. API не возвращает имя пользователя, пароль или секретный ключ. Подписанные записи содержат тип маршрута и информацию о наличии учетных данных, исключая конечную точку и секретные ключи. Оператор может увидеть конечную точку в панели управления. Поля с секретными данными очищаются после сохранения, блокировки или переключения рабочих пространств.

Функция «Проверить соединение с Telegram», доступная также до входа в систему, открывает и закрывает временное неавторизованное соединение с Telegram через маршрут. Она не обращается к веб-сайту проверки IP-адресов. Успешное выполнение этой функции подтверждает наличие транспортного соединения, но не гарантирует доступ к группам, полную доставку сообщений или анонимность.

Прокси применяется к соединениям клиента Telegram, включая загрузку медиафайлов из дата-центров Telegram. Для браузера, pip, SSH и запускаемых вручную инструментов TSA предусмотрены отдельные маршруты. Имя хоста прокси может разрешаться локально. rdns влияет на имена хостов назначения; Telegram часто предоставляет числовые IP-адреса дата-центров.

SOCKS5 и простой HTTP CONNECT сами по себе не шифруют учетные данные прокси или туннель клиент-прокси. MTProto отдельно защищает трафик Telegram. Используйте соответствующий безопасный канал для связи с прокси в ненадежной сети. Закрытые группы — это облачные чаты, защищенные MTProto при передаче; секретные чаты с сквозным шифрованием — это отдельный тип чата, записываемый модулем Секретный чат.

Шифрование и подписи#

Уровень Реализовано Ответственность оператора
Трафик Telegram Telethon MTProto Доверие к платформе, маршрутизация и доступность
Веб-панель Токен-носитель, настройка loopback по умолчанию, ограничения на количество запросов HTTPS или SSH-туннель для удалённого доступа
Секреты Fernet для хранения учетных данных API, сеансов, учетных данных прокси и закрытого ключа для подписи Обеспечьте защиту ключа дешифрования и хоста, на котором работает система
Ключ хранилища Локальный ключ или внешний мастер-ключ для новой установки Отдельное защищённое хранилище и резервное копирование ключей
Сообщения и вложения Хранение приложений в виде открытого текста Зашифрованный диск/том
ZIP/JSONL/CSV/HTML Проверка целостности данных, отсутствие шифрования содержимого Защита экспортированных копий и передач данных
Происхождение и время Подписанный журнал, подтверждение обработки, инструменты в соответствии с RFC 3161 Доверенный ключ, независимые контрольные точки/TSA и процедура хранения

В разделе «Защита хранилища» в учетной записи отображаются следующие состояния. Токен панели — это секретный ключ доступа, а не пароль для шифрования. Он предоставляет права администратора; выданные токены могут быть привязаны к конкретным учетным записям и чатам. Рабочие пространства используют общий хост-процесс и не являются изолированными арендаторами.

BitLocker, LUKS, FileVault или управляемый зашифрованный том могут обеспечить защиту хранилища в рамках соответствующих моделей угроз. Администратор разблокированного работающего компьютера по-прежнему может прочитать данные. При планировании хранилища учитывайте файлы WAL/SHM баз данных SQLite, мультимедиа, временные экспортные файлы, файлы подкачки, резервные копии и загрузки из браузера. Том Docker не шифруется только по той причине, что он является томом.

Внешний мастер-ключ#

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

python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key
export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key
python -m tgwitness --data-dir /private/observations/new-case

PowerShell с использованием установленной среды проекта:

python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key
$env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key'
python -m tgwitness --data-dir E:\PrivateData\new-case

В Docker смонтируйте файл в режиме «только для чтения» вне каталога /data, например, в каталоге /run/secrets/tgwitness-master.key, и задайте переменную среды с указанием этого пути. UID службы должен иметь права на чтение этого файла. Передавайте путь, а не байты ключа, через файлы среды/конфигурации.

Каждое рабочее пространство получает случайный публичный солевой ключ (salt) и собственный ключ Fernet, полученный с помощью алгоритма HKDF-SHA256. В базе данных «vault.external.json» хранятся метаданные о выведении ключа, а не сам мастер-ключ. Отсутствие или неверность ключа приводит к сбою при запуске без автоматической замены. Сохраняйте как метаданные о солевом ключе, так и мастер-ключ для восстановления.

Все рабочие пространства производятся от одного и того же мастер-ключа; его компрометация затрагивает всю инсталляцию. Запущенный процесс может расшифровывать секретные данные. Это не HSM и не KDF на основе пароля. Произвольные пароли, введенные пользователем, не допускаются вместо случайного ключа.

Сохраняйте существующий ключ для действующих установок до тех пор, пока не будет осуществлена и проверена плановая миграция. Удаление vault.key или замена мастер-ключа может привести к потере доступа к сеансам/ключам подписи. Храните зашифрованные резервные копии и ключи отдельно и проверяйте возможность восстановления в изолированной среде.