Часть страницы пока на английском: английский оригинал изменился после перевода.
Справочник / Установка
Сессии Telegram: TData, Telethon и способы импорта
Войдите в систему с помощью телефона, QR-кода или ключа аутентификации, импортируйте сеансы из Telethon, Pyrogram или Telegram Desktop и управляйте несколькими учётными записями.
TgWitness / Документация · Начало работы
TgWitness входит в систему как учетная запись пользователя Telegram (а не как бот) через протокол MTProto с использованием Telethon. Каждая учетная запись находится в собственном рабочем пространстве (называемом «workspace» в API и инструментах командной строки) с собственной сессией, источниками, журналом и ключом подписи.
Файлы сеансов, строки сеансов и ключи аутентификации являются средствами авторизации учетной записи: любой, кто имеет один из них, может действовать от имени этой учетной записи. Они не содержат истории сообщений.
[!ПРЕДУПРЕЖДЕНИЕ] Используйте специальные аккаунты. Telegram ограничивает и может навсегда заблокировать аккаунты за объем запросов, который он считает чрезмерным, независимо от клиента или цели, и документирует эти ограничения лишь частично. Подключайте аккаунты, подготовленные для наблюдения, а не личные или иные ценные аккаунты, и создавайте API-ID / API-хэш на специальном аккаунте.
- Краткий обзор
- Прежде чем начать: идентификатор API и хеш API
- Номер телефона · QR-код · Ключ аутентификации + идентификатор DC
- Файлы учетных записей: Telethon .session · Pyrogram .session · Пара «сессия + JSON» · TData · StringSession · Ключ аутентификации и DC в одной строке · JSON-файл учетной записи
- Определите, чем вы располагаете · Неподдерживаемые форматы
- Наличие нескольких учётных записей · Обеспечение безопасности файлов учетных записей · Устранение неполадок
Краткий обзор#
| Что у вас есть | Вкладка «Добавить аккаунт» | Вам также понадобятся |
|---|---|---|
| Номер телефона и доступ к кодам входа в систему | Телефон | Пароль двухфакторной аутентификации (2FA), если она включена |
| Telegram открыт на другом устройстве | QR-код | Пароль двухфакторной аутентификации (2FA), если она включена |
Файл .session (Telethon или Pyrogram) |
Файлы | Дополнительный файл JSON с настройками приложения |
.session + .json с одинаковым названием |
Файлы (выберите оба) | Обычно ничего больше |
Папка «tdata» в Telegram Desktop |
Файлы (в формате ZIP) | Локальный пароль для настольной версии, если он установлен |
StringSession Telethon (текст, .txt, .tgwitness-session) |
Файлы | Отдельная пара API не требуется |
Ключ авторизации и DC в одной строке: <512 hex>:<1–5> |
Файлы (вставленный текст или текстовый файл) | Отдельная пара API не требуется |
.json с сессией или ключом аутентификации |
Файлы | Отдельная пара API не требуется |
| Ключ аутентификации (512 шестнадцатеричных символов) и его номер DC | Ключ аутентификации | Необязательный идентификатор пользователя |
TgWitness распознает файлы по их содержимому, а не по именам. Переименование файла никогда не приводит к его преобразованию.
Прежде чем начать: идентификатор API и хеш API#
Вы можете войти в систему без создания приложения Telegram API. Если пара не введена,
не импортирована и не сохранена в рабочей области, TgWitness выбирает пару из встроенного пула, состоящего из
50 общедоступных пар API (tgwitness/api_pool.py), отдавая предпочтение Telegram Desktop при новом
входе в систему и в первую очередь используя сохраненную пару; остальные варианты перемешиваются. Если Telegram отклоняет пару
(API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), пробуется следующая,
до восьми на один вход; отклоненные пары пропускаются до перезапуска. Пара, с помощью которой был выполнен вход,
сохраняется вместе с учётной записью и повторно используется для неё.
Встроенные пары являются общедоступными: они публикуются в открытом исходном коде клиентов и библиотек Telegram.
Идентификатор API и хеш API идентифицируют приложение в Telegram
и не предоставляют доступа к данным учетной записи. Для входа используется собственная система авторизации учетной записи: код входа
и пароль двухфакторной аутентификации (2FA) или сессия, в которой учетная запись уже авторизована. В каждой
observation.started запись содержит название использованной пары, поэтому встроенная пара документируется для
суда так же, как и ваша собственная. Вместо этого вы можете ввести свою собственную пару с сайта my.telegram.org.
По опыту проекта новая личная пара приводит к выходу из системы большинства аккаунтов, поэтому используйте её
только в том случае, если дело требует использования вашего собственного приложения: создайте её с помощью специального аккаунта и
введите её до начала сбора данных (шаги описаны ниже).
В отсутствующих полях подключения используется детерминированная пара устройство/ОС из входящих в комплект каталогов
opentele2 2.0.0:
Desktop 2040, Android 6, Android X 21724, iOS 10840, macOS 2834 и Web 2496.
Идентификатор сборки исходного кода Android 4 также использует каталог Android, как указано в
BuildVars Telegram для Android .
Для Web по умолчанию используется A; импортированный суффикс версии приложения K или языковой пакет macos выбирает
K, а версия 0.7.0 выбирает Webogram. Неизвестные идентификаторы приложений сохраняют
значения по умолчанию хоста Telethon. Импортированные поля всегда имеют приоритет, включая более старую версию приложения и пустой
языковой пакет. Каталог никогда не изменяет ID/хэш API. Его моментальный снимок версии
проверяется явно, а не извлекается во время входа в систему. Сохраненный профиль остается неизменным после обновлений.
account.getAuthorizations сообщает о сохраненных метаданных авторизации Telegram; это
не повторение каждого нового initConnection. Сравните его с фактически отправленным профилем.
Подключение существующей авторизации не проверяет соответствующий хеш API:
initConnection отправляет ID API, тогда как хеш используется в запросах на вход.
После новой авторизации по телефону или QR-коду TgWitness запрашивает конфигурацию, ближайший дата-центр,
статус подключения, языки (если языковой пакет не пуст), обновления приложения и
обновления условий предоставления услуг с интервалом 0.3–1.5 секунд между запросами. Обновление статуса
на короткое время помечает аккаунт как находящийся в сети. Эта последовательность запускается один раз по завершении входа в систему,
а не при импорте данных, повторном подключении или перезапуске. Сначала сохраняется авторизация; неудачный
запрос останавливает последовательность без повторных попыток или отмены входа. Результаты
записываются как account.initialized с указанием названий ошибок, а не телами ответов.
Ограничения для аккаунтов определяются собственными политиками Telegram.
Для tdesktop
при отсутствии tz_offset
используется локальное смещение UTC сервера, округлённое
до 900
секунд с помощью алгоритма
opentele2
(MIT; лицензия в tgwitness/client_profiles.LICENSE
). Оно обновляется при каждом
подключении, чтобы учитывать изменения, связанные с переходом на летнее время. Импортированное значение tz_offset
имеет приоритет на любой платформе и сохраняется в точности, включая ноль. Остальные записи
initConnection.params
сохраняются.
Форма входа по HTTP принимает числовое значение часового пояса, возвращаемое при импорте файла;
булевы значения, дроби и смещения, выходящие за пределы поддерживаемого диапазона, отклоняются.
Прямые, SOCKS5 и HTTP CONNECT маршруты используют ConnectionTcpObfuscated
от Telethon (зашифрованный сокращённый MTProto). HTTPS CONNECT сохраняет TLS до прокси и использует
тот же запутывающий транспорт внутри туннеля. MTProxy сохраняет требуемый
рандомизированный промежуточный транспорт и обработку секретных данных. Переключение маршрутов применяет
те же варианты. Запутывание изменяет структуру пакетов; оно не скрывает аккаунт
или метаданные его клиента от Telegram и не подразумевает иммунитет к ограничениям.
После подключения авторизованного клиента TgWitness проверяет конфигурацию, ближайший центр обработки данных,
текущую авторизацию, утвержденный базовый уровень, языки, обновления приложения
и обновления условий предоставления услуг. Эти диагностические проверки выполняются один раз для каждого экземпляра клиента,
до начала сбора данных, и отображаются в деталях подключения с указанием времени. В поле `
account.connection_checked` записывается результат без хешей сеансов, IP-адресов,
токенов или хешей API. Клиенты никогда не принимают условия и не устанавливают обновления. Сбой запроса
или состояние `FloodWait` останавливают последующие запросы; отсутствующий результат остается неизвестным.
Локальные проверки по-прежнему могут сообщать о своих результатах, в то время как сетевые проверки пропускаются.
При включенном режиме Выбранные чаты текущая
авторизация не запрашивается, и эта проверка отображается как пропущенная.
После входа в систему и при каждом новом подключении TgWitness считывает настройку конфиденциального
контента учетной записи. Если она отключена, а Telegram разрешает изменение, TgWitness включает её,
чтобы контент, помеченный Telegram как конфиденциальный (18+), сохранялся, и записывает значение параметра
account.content_settings. Этот параметр относится к учётной записи и применяется во всех
приложениях Telegram. Режим «Только выбранные чаты» оставляет его без изменений; включите его перед входом в систему.
Параллельные запросы на восстановление соединения с одной рабочей областью используют один и тот же клиент и ожидают завершения установки соединения. В случае сбоя или отмены попытки освобождается следующий запрос для повторной попытки. Если сохраненные учетные данные, клиент или состояние авторизации изменяются во время установки соединения, более старая попытка прерывается, а не сообщает о готовности соединения.
Диагностика FloodWait сохраняет в telegram.backoff неудавшийся метод TL, любые обертки Takeout/range,
запрошенное сервером время ожидания и фактический крайний срок.
Сведения о соединении показывают метод и крайний срок, пока запросы приостановлены.
Диагностика включает счетчики вызовов клиента по каждому методу с момента
создания данного клиента; они отдельно учитывают вложенное разрешение узлов, но не учитывают пакеты
или внутренние попытки повторного вызова Telethon. Текущие счетчики также доступны как
collector.rpc_activity в API состояния. Аргументы запроса, имена пользователей,
хэши доступа или текст исключений не включаются. Последняя диагностика и полный крайний срок
сохраняются после перезапуска. Более ранние ожидания без записи о методе не могут быть отнесены
к конкретному методу задним числом. См. : ограничения экспорта для проверки исходного кода и
различия между обнаружением и сбором истории.
official_app=True или False — это флаг текущей авторизации в Telegram. Ни одно из
этих значений не определяет, является ли аккаунт ограниченным, доверенным или находится под наблюдением.
Существующие снимки account.devices в режиме сбора доказательств по-прежнему содержат историю всех
подключённых устройств; диагностика подключения сохраняет только описание текущего устройства.
Перед подключением консультативные проверки сравнивают платформу API, языковой пакет, форматы устройства/ОС и версии приложения, локаль мобильной системы, а также фактический уровень схемы Telethon с базовыми данными проверенного каталога. Предупреждения появляются в журнале сервера и метаданных статуса учётной записи; они никогда не заменяют импортированные значения и не изменяют уровень схемы. Несовпадение уровней является сигналом для проверки совместимости; собственный статус подключения учётной записи показывает, работает ли она. Telegram определяет ограничения со своей стороны, независимо от того, какой профиль клиента используется. Статус отключенной учетной записи использует сохраненный профиль вместо генерации нового описания устройства.
Чтобы вместо этого использовать собственное приложение:
- Откройте сайт my.telegram.org и войдите, указав любой номер телефона, который принадлежит вам. Код приходит в приложение Telegram, а не в виде SMS.
- Выберите инструменты для разработки API.
- Создайте приложение: укажите любое название и краткое имя (5–32 буквы), платформа — «Настольный компьютер». Поля «URL» и «Описание» можно оставить пустыми.
- Скопируйте App api_id (число) и App api_hash (32 шестнадцатеричных символа).
В панели под формой входа указаны поля «Идентификатор API» и «Хеш». Вы можете ввести одну
пару api_id:api_hash в поле «Идентификатор API», и оба поля будут заполнены. Одну пару можно
использовать для всех ваших учётных записей. После успешного входа данные сохраняются в зашифрованном виде
исключительно в данной рабочей среде и никогда не отправляются обратно в браузер.
Здесь задействованы три различных типа учетных данных:
| Секретно | Открыть | Где это находится |
|---|---|---|
| Токен панели | Веб-панель TgWitness | panel-token.txt в каталоге данных или TGWITNESS_TOKEN |
| Идентификатор API + хеш | Ничего не говорит само по себе; определяет приложение | Встроенная пара, импортированные настройки или ваше собственное приложение на сайте my.telegram.org |
| Авторизация учетной записи | Аккаунт в Telegram | Создается посредством входа с помощью телефона или QR-кода либо импортируется в качестве сеанса |
Если для доступа к Telegram требуется прокси-сервер, сначала настройте его в разделе Дополнительные инструменты → Аккаунт → Настройки → Настройки подключения → Изменить маршрут подключения.
Номер телефона#
- Откройте Дополнительные инструменты → Учётная запись, вкладку Телефон и введите номер в международном формате,
например,
+44 7700 900123. Пробелы и дефисы удаляются автоматически. - Нажмите «Продолжить». Поля «API ID» и «Хеш» можно оставить пустыми.
- Введите код, который Telegram отправляет, как правило, в приложение Telegram; Telegram сам решает, отправлять ли SMS.
- Если для аккаунта настроена двухэтапная аутентификация, введите соответствующий пароль. Это не токен панели и не код доступа к устройству.
- Проверьте идентификатор учетной записи, отображаемый после входа в систему, а затем выберите источники.
Коды входа и пароль двухфакторной аутентификации (2FA) никогда не записываются на диск.
QR-код#
Используйте эту функцию, если учетная запись уже авторизована на телефоне или другом компьютере.
- Вкладка «QR-код» → Показать QR-код. Поля «API ID» и «Хеш» можно оставить пустыми.
- На устройстве, на котором выполнен вход: «Настройки» → «Устройства» → «Привязать настольное устройство», отсканируйте код и подтвердите.
- Введите пароль двухфакторной аутентификации (2FA) в TgWitness, если Telegram запрашивает его.
Изображение QR-кода генерируется локально. Срок действия кодов истекает; нажмите «Сгенерировать другой QR-код», чтобы повторить попытку. Блокировка панели, переключение рабочего пространства или вход под другим аккаунтом приводят к аннулированию кода, ожидающего обработки.
Ключ аутентификации + идентификатор DC#
Ключ авторизации — это исходный 256-байтовый ключ авторизации, лежащий в основе каждого сеанса Telegram, записанный в виде 512 шестнадцатеричных символов вместе с номером центра обработки данных DC 1–5.
- Вкладка «Ключ аутентификации». Вставьте полный ключ; сокращённый ключ, содержащий символ
…, не будет работать. - Выберите идентификатор DC, предоставленный вместе с ключом.
- По желанию введите идентификатор пользователя. В этом случае TgWitness откажется подключаться, если Telegram сообщит о другом аккаунте.
- Аккаунт в Press Connect.
Ключ авторизации (512 символов) не является хешем API (32 символа). Тот же ключ также можно импортировать в формате JSON; см. раздел «JSON-файл учетной записи».
Файлы учетных записей#
Open Add account → Files and select up to four files belonging to one account, 8 MiB in total, press Check files, then Connect account. Choosing files or pasting session text sends nothing; Check files sends them to your TgWitness server, which reads them without signing in and shows the session it found.
Формы Files, Auth key и массового импорта отображают предупреждение о параллельных сессиях перед подключением. По умолчанию импортированные авторизации используются повторно. Оставьте исходный клиент закрытым, пока его ключ используется здесь. Files и Auth key также предлагают создать независимую авторизацию, описанную ниже. Массовый импорт по-прежнему использует прямой режим. Вход через телефон и интерактивный QR-код создают отдельные авторизации. Заголовок предупреждения остаётся видимым в форме импорта; его полное объяснение открывается автоматически при предоставлении файлов или строки ключа/сеанса. Его можно свернуть после прочтения, чтобы на телефоне оставались доступными элементы управления выбором файлов и подключением.
В подтверждённой конфигурации (Phala Cloud, Intel TDX) не происходит сбор данных по импортированному ключу. В этом случае файлы и ключ авторизации связываются только при выборе опции Создать независимую авторизацию; массовый импорт не допускается. Вход по телефону и через QR-код работает в обычном режиме.
- Файлы конвертируются в памяти на вашем сервере TgWitness. Загруженные файлы не сохраняются, архивы ZIP не распаковываются на диск, и не происходит обращения к каким-либо внешним сервисам.
- Полученный файл затем сверяется с данными Telegram. Если в файле указан идентификатор пользователя, он должен совпадать с идентификатором учетной записи, указанным в отчёте Telegram.
- Файлы, в которых описываются разные учётные записи или разные учетные данные API, отклоняются, вместо того чтобы выбрать одну из них.
- Поле Пароль или Текст сессии содержит локальное поле TData для пароля, поле для вставки StringSession и функцию Чтение файлов без входа в систему (заполняет форму без подключения к Telegram). Вставка StringSession очищает выбранные файлы, а выбор файлов очищает вставленный текст, поэтому при проверке и подключении используется последний выбор. После смены пароля нажмите Проверить файлы ещё раз.
Создать независимую авторизацию#
Выберите Создать независимую авторизацию перед подключением импортированных файлов или авторизационного ключа. TgWitness кратковременно подключается к импортированному донору, использует его для утверждения QR-токена входа нового клиента и отключается от донора сразу после утверждения. Новый клиент имеет собственный ключ авторизации и отдельно выбранный профиль Desktop . Предоставленные донором учетные данные API и профиль устройства используются только для подключения к донору. Ни одна существующая авторизация не отменяется и не аннулируется.
На этом этапе исходный клиент донора должен оставаться полностью закрытым. Первоначальное соединение по-прежнему использует скопированный ключ, поэтому данный режим не позволяет устранить риск параллельного использования. После установления нового авторизованного соединения владелец может вновь открыть исходный клиент и использовать оба одновременно. Интерактивный вход с помощью QR-кода позволяет исходному клиенту утвердить вход без копирования или подключения своего ключа на этом этапе.
Не выходите из системы и не завершайте сеанс донора. Когда заканчивается сеанс, в котором был одобрен вход по QR-коду,
Telegram также завершает одобренный им сеанс; в ходе тестирования в режиме реального времени новая
авторизация прекратилась в течение секунды после выхода донора из системы. При импорте фиксируются
данные сеанса донора (session_origin.approved_by: устройство, API-ID и время создания).
Список сеансов помечает его, команда Завершить сеанс отклоняет его, а команды Завершить все остальные сеансы
и Сделать этот сеанс единственным оставляют его авторизованным.
Если Telegram запрашивает двухфакторную аутентификацию (2FA), в этом режиме используется twoFA из выбранного JSON-файла, если он имеется,
или запрашивает пароль. В случае отклонения импортированного пароля происходит возврат к форме ввода пароля.
Пароли не сохраняются. Ключ-кандидат сохраняется в зашифрованном виде в
independent_login.enc, включая изменения во время миграции между дата-центрами. После
перерыва выберите того же донора и эту опцию, чтобы возобновить работу с сохраненным кандидатом.
Донор проверяется help.getAppConfig перед утверждением; при замороженной учетной записи
процесс останавливается на этом этапе. Если Telegram отклоняет донора до утверждения входа, неутвержденный
кандидат-ключ отбрасывается, и импорт можно начать заново. Другой донор заменяет
сохраненного кандидата только в том случае, если Telegram сообщает, что этот кандидат не вошел в систему;
кандидат, который вошел в систему или ожидает ввода пароля 2FA, сохраняется.
Рабочая область остаётся зарезервированной для этой учётной записи; неудачное завершение не приводит к удалению
новой рабочей области. Сохраните её каталог данных и ключ хранилища. Окончательные учетные данные и
account.authorized запись в журнале содержат метод импорта, форматы ввода и
идентификатор API донора, без указания ключа или пароля донора.
5 ноября 2026 года специальная учетная запись прошла проверки в режиме реального времени с донорами Telethon, Pyrogram и TData: прохождение двухфакторной аутентификации (2FA), уникальные новые ключи авторизации, одновременный доступ донора и нового клиента, а также чтение общедоступного канала. В случае с Telethon также был возобновлен сохраненный кандидат после прерывания на этапе ввода пароля. Каждая новая авторизация завершила шесть запросов инициализации после входа в систему, а её подписанный журнал был проверен. Исходная сессия оставалась пригодной к использованию во всех четырёх предоставленных форматах.
База данных ошибок RPC Telegram связывает
FRESH_CHANGE_ADMINS_FORBIDDEN со сменой администраторов, FRESH_CHANGE_PHONE_FORBIDDEN
— со сменой номера телефона, а FRESH_RESET_AUTHORISATION_FORBIDDEN — с
отзывом других сессий, изменением их срока действия или регистрацией пароля.
SESSION_TOO_FRESH_* и PASSWORD_TOO_FRESH_* касаются передачи прав собственности и
вывода доходов или подарков. Это не операции сбора данных; новый вход в систему
не влечет за собой полный запрет на чтение в течение 24 часов. При экспорте можно отдельно возвращать
TAKEOUT_INIT_DELAY_*. TgWitness сохраняет паузы, запрошенные сервером, и не повторяет
прием токенов автоматически, а также не аннулирует сессии для обхода ограничений.
Дополнительные инструменты → Аккаунт → Безопасность аккаунта → Сессии этого аккаунта → Завершить все остальные сессии вызывает метод `auth.resetAuthorizations` по
запросу оператора и записывает в `account.all_other_sessions_terminated` количество сессий
до и после. Telegram принимает этот запрос от сессии, авторизованной в течение 24 часов.
Когда в этом рабочем пространстве вход осуществляется по QR-коду из импортированной сессии, сессия, которая это одобрила,
остаётся авторизованной: TgWitness поочерёдно завершает остальные с помощью account.resetAuthorization и
записывает значение kept_approving_session. Сделайте эту сессию единственной, затем остановите процесс с указанием этой причины
и не меняйте пароль.
Убедитесь, что только в данном сеансе выполняется следующее: для ключа, созданного при входе в данную рабочую область, активируется двухэтапная аутентификация, если для учетной записи она ещё не настроена. Панель отобразит этот пароль один раз; TgWitness хранит его в хранилище рабочей области только до этого момента. В журнале фиксируются session.exclusive_from. Если Telegram позже укажет другой сеанс, журнал фиксирует session.exclusive_ended , и панель выдает предупреждение. Проверяющее устройство выводит на экран и то, и другое.
Сделать эту сессию единственной, когда Telegram разрешает выполнять одно и то же действие по таймеру. Эта
опция появляется в разделе Сессии данной учётной записи для ключа, созданного в этом рабочем пространстве, и
записывается как session.exclusive_automatic. Во время наблюдения коллектор каждые пять
минут проверяет, прошло ли 24 часов с момента записи account.authorized для этого ключа —
до этого Telegram отвечает FRESH_RESET_AUTHORISATION_FORBIDDEN — и затем запускает одну и ту же
операцию один раз. Успех записывается как session.exclusive_from, как и при нажатии кнопки вручную.
Отказ фиксируется один раз как session.exclusive_postponed с указанием причины Telegram, и
коллектор повторяет попытку с увеличивающейся задержкой до шести часов. Режим только для чтения здесь не действует:
завершение сеансов является действием, связанным с безопасностью учётной записи, а не действием в чате.
Двухэтапный пароль, сгенерированный при автоматическом запуске, сохраняется в хранилище рабочей среды, зашифрованный ключом рабочей среды, до того как Telegram его установит. Панель один раз извлекает его из POST /api/account/sessions/only/password, после чего он удаляется, и отображает его в том же диалоговом окне, что и при ручном запуске, когда вы открываете Сессии данной учётной записи. На странице подключения отображается уведомление о том, что пароль находится в ожидании. Он никогда не попадает в журнал и сохраняется после перезапуска до тех пор, пока не будет отображён.
О новых сессиях также сообщается в процессе наблюдения: когда в список сессий Telegram добавляется запись,
запись account.sessions указывает её под ключом added, а панель выдает оповещение с указанием
устройства, приложения и страны из этого моментального снимка.
Зонд-свидетель#
Дополнительные инструменты → Аккаунт → Безопасность аккаунта → Проверка Свидетель проверяет, получает ли другой клиент обновления этого аккаунта. Добавьте вторую рабочую область, авторизованную с помощью другого аккаунта Telegram и собственного сессионного ключа, создайте закрытую группу с участием обоих аккаунтов, затем выберите эту группу в качестве чата Проверка и вторую рабочую область в качестве рабочей области Свидетель, после чего включите проверку. Для обоих аккаунтов необходимо отключить режим Только чтение, а рабочая область Свидетель должна находиться в режиме наблюдения.
Во время наблюдения эта рабочая область каждые 60–120 секунд отправляет в группу probe:<n>:<token>
и записывает probe.sent. Свидетель отвечает ack:<n>:<token> и записывает probe.seen и
probe.ack_sent. Подтверждение (ack), поступающее в эту сессию в режиме реального времени в течение 20 секунд,
записывается как probe.acked. В противном случае рабочая область считывает недавнюю историю группы. Подтверждение
, найденное там, но не доставленное в режиме реального времени, записывается как coverage.gap с причиной
probe_ack_missed_live: панель генерирует предупреждение и помечает приём события как неудачный до тех пор, пока
позже не поступит подтверждение в режиме реального времени (connection.restored, причина probe_ack_live). Отсутствие подтверждения записывается как
probe.unanswered; прерывание соединения во время ожидания или нечитаемая история — как
probe.inconclusive. Режим только для чтения, ограничения Telegram и паузы FloodWait записываются один раз
как probe.skipped.
Телемарафон .session#
| Что это такое | База данных SQLite, создаваемая инструментами на основе Telethon, например, my_account.session |
| Признан | Таблицы sessions (вместе с dc_id, server_address, port, auth_key) и version = 7 или 8 |
| Требования | Ровно одна строка, относящаяся к авторизованной сессии; закрытая, полная база данных |
Сначала закройте программу, создавшую файл. Если рядом с ним присутствует файл my_account.session-journal или
my_account.session-wal, это означает, что база данных не завершена: откройте и
корректно закройте исходный клиент. Удаление этих вспомогательных файлов может привести к появлению повреждённой копии.
Pyrogram .session#
| Что это такое | Инструменты на основе Pyrogram, использующие базу данных SQLite, создают |
| Признан | Таблица sessions с dc_id, auth_key, test_mode, user_id, is_bot; version = 2 или 3 |
| Требования | Допускается один авторизованный сеанс пользователя в производственной сети. Сеансы ботов и тестовых распределённых центров (DC) отклоняются. |
При входе в систему сохраненный идентификатор пользователя сверяется с данными Telegram.
Пара «сессия + JSON»#
Отчёты часто предоставляются в виде двух файлов с одинаковыми именами, например,
447700900123.session и 447700900123.json. Выберите оба файла одновременно.
- На основании данных JSON TgWitness использует
app_id/api_idиapp_hash/api_hash, поэтому вам как правило, не требуется вводить учетные данные API. - Профиль подключения использует
device_model(псевдонимdevice),system_version(псевдонимsdk),app_version,lang_code,system_lang_code(псевдонимsystem_lang_pack),lang_packи опциональныйtz_offset(секунды от UTC, от -43200 до 50400). Указанные поля имеют приоритет над сгенерированными значениями по умолчанию и языком панели/браузера . Конфликтующие псевдонимы отклоняются. Окончательный профиль сохраняется в зашифрованных учетных данных рабочей области и повторно используется после перезапуска, включая версию приложения. phone, настройки прокси и токены устройств игнорируются.twoFAдоступен только для чтения, если выбран параметр Создать независимую авторизацию; при прямом импорте он игнорируется.- JSON-файл без поддерживаемого поля авторизации является лишь метаданными. Добавьте файл сеанса или продолжите вход с помощью телефона или QR-кода. JSON-файл, содержащий поддерживаемый сеанс или авторизационный ключ, может авторизоваться самостоятельно; см. Account JSON.
Telegram Desktop (TData)#
TData — это папка tdata приложения Telegram Desktop (кроссплатформенного
приложения с сайта desktop.telegram.org).
| Система | Местоположение по умолчанию: tdata |
|---|---|
| Windows | %APPDATA%\Telegram Desktop\tdata (портативная версия Telegram: рядом с Telegram.exe) |
| Linux | ~/.local/share/TelegramDesktop/tdata |
| macOS | ~/Library/Application Support/Telegram Desktop/tdata |
Чтобы импортировать его:
Предупреждение о параллельной сессии. Прямой импорт TData повторно использует ключ авторизации Telegram Desktop. Не используйте этот ключ одновременно в Desktop и TgWitness. Telegram может аннулировать авторизацию с помощью
AUTH_KEY_DUPLICATED, в результате чего обе копии станут непригодными для использования до нового входа в систему.Полностью закройте Desktop, включая его процесс в трее, и держите эту копию закрытой, пока TgWitness использует импортированную сессию. Закройте программу, не выходите из системы и не отзывайте сессию: отзыв также делает импортированную копию недействительной. Если вам необходимо, чтобы оба клиента работали, выберите Создать независимую авторизацию и держите Desktop закрытым до тех пор, пока новый вход в систему не пройдет успешно, либо войдите в систему TgWitness с помощью телефона или QR-кода. Рекомендуется использовать отдельную учётную запись, однако это не гарантирует безопасность параллельного использования клонированных ключей.
Это также относится к импортированным
.sessionфайлы, текст StringSession и шестнадцатеричный код авторизационного ключа. Другие клиенты с собственными, независимо созданными авторизациями могут оставаться авторизованными. См. документацию Telegram по AUTH_KEY_DUPLICATED.
- Полностью закройте Telegram Desktop.
-
Создайте ZIP-архив, содержащий только эти два элемента из
tdata:key_datas- 16-символьный файл с расширением «
s», расположенный рядом с ним, обычно «D877F783D5D3EF8Cs»
Сжатие всей папки вместе с кэшем мультимедиа, как правило, превышает установленные ограничения (512 записей, 32 MiB в распакованном виде). 3. Выберите ZIP-файл в разделе «Файлы». Если у Telegram Desktop установлен локальный пароль, сначала введите его в поле «Пароль» или «Текст сеанса». Это не пароль двухфакторной аутентификации (2FA).
Поддерживается: один аккаунт на архив, современное хранилище key_datas/key_data0/key_data1,
локальный пароль. Не поддерживается: папки с несколькими авторизованными аккаунтами, устаревшие версии
десктопного приложения, ZIP-архивы, защищённые паролем, а также отдельное нативное приложение для macOS «Telegram для macOS».
Telethon StringSession#
Одна строка текста, обычно начинающаяся с 1 и содержащая около 350 символов. Загрузите
её в виде файла .txt или .tgwitness-session (размером не более 4 КиБ) или вставьте в поле
«Пароль» или «Текст сеанса». Принимаются только строки формата Telethon; строки Pyrogram и TDLib
используют другие форматы.
Ключ аутентификации и DC в одной строке#
Списки учетных записей часто содержат исходные данные авторизации в формате <512 hexadecimal characters>:<DC id>,
например, a1b2…ef:5. Вставьте эту строку в поле Пароль или Текст сеанса, загрузите её как
текстовый файл или поместите в поле session JSON-объекта Учетная запись. TgWitness
сопоставляет DC 1–5 тем же производственным адресам, что и при импорте JSON-данных auth_key + dc_id, и
отражает формат как HEX-ключ авторизации и DC. Любой другой номер DC или длина ключа отклоняются.
JSON-файл учетной записи#
Один объект JSON размером не более 64 КиБ в файле с расширением .json.
| Поле (псевдонимы) | Значение |
|---|---|
api_id (app_id) |
Идентификатор приложения — положительное число |
api_hash (app_hash) |
Хеш приложения, 32 шестнадцатеричных символа |
string_session (session_string, session_str; устаревшее session) |
Текст StringSession из Telethon или <512 hexadecimal characters>:<DC id>, а не имя файла |
auth_key (auth_key_hex) + dc_id |
Полный 512-символьный ключ аутентификации и DC 1–5 |
user_id (id) |
Необязательно; проверка в Telegram производится до сохранения авторизации |
device_model (device) |
Описание устройства подключения |
system_version (sdk) |
Версия ОС, с которой установлено соединение |
app_version |
Версия приложения, отправленная в Telegram |
lang_code, system_lang_code (system_lang_pack), lang_pack |
Язык клиента, язык системы и языковой пакет клиента; допускается пустое значение lang_pack |
tz_offset |
Необязательное смещение по отношению к UTC в секундах, отправляемое в поле initConnection.params; целое число или строка, представляющая десятичное целое число |
Если присутствуют как псевдоним, так и основное имя, они должны совпадать. Явные поля сессии Telethon
имеют приоритет над общим блоком session в другом формате. Если
оба содержат распознаваемые сессии Telethon, они должны описывать одну и ту же авторизацию.
При отсутствии явного поля session должно быть действительной StringSession Telethon или ключом авторизации
и DC в формате <512 hexadecimal characters>:<DC id>. Примеры:
{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }
{
"api_id": 1234567,
"api_hash": "0123456789abcdef0123456789abcdef",
"auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
"dc_id": 2,
"user_id": 123456789
}
В первом примере заполняются только учетные данные API; войдите в систему с помощью телефона или QR-кода либо добавьте файл сеанса. Массовые списки (массив JSON с учетными записями) не принимаются.
Определите, чем вы располагаете#
| Как видите | Это | Использование |
|---|---|---|
*.session; при открытии в текстовом редакторе в верхней части отображается SQLite format 3 |
Telethon или Pyrogram SQLite | Файлы (обнаруживаются автоматически) |
Папка «tdata», содержащая файл «key_datas» |
Telegram Desktop TData | Скомпрессируйте два файла в ZIP, затем «Файлы» |
Одна строка текста, начинающаяся с 1, ~350 символов |
Telethon StringSession | Файлы |
Одна строка текста 512 characters 0-9a-f, затем : и цифра от 1 до 5 |
Ключ аутентификации и DC | Файлы, код доступа к ящику или текст сеанса |
*.json с app_id/app_hash |
Сопутствующие метаданные | Файлы вместе с данными сеанса |
*.json с auth_key или string_session |
JSON-файл учетной записи | Файлы |
512 символов 0-9a-f |
Ключ аутентификации | Ключ аутентификации |
32 символа 0-9a-f |
Хеш API | Идентификатор API + хеш |
td.binlog или db.sqlite из приложения TDLib |
Хранилище TDLib | Не поддерживается |
123456789:AA… |
Токен бота | Не поддерживается |
Неподдерживаемые форматы#
| Формат | Альтернативный вариант |
|---|---|
Хранилище TDLib (td.binlog) и экспорт данных из TDLib |
Войдите с помощью телефона или QR-кода |
| Строки сеансов Pyrogram | Используйте файл Pyrogram с кодом .session или сканируйте QR-код с телефона |
| TData с несколькими авторизованными учетными записями | Выйдите из других учётных записей в Telegram Desktop или используйте файл сеанса для каждой учётной записи отдельно |
| Токены ботов | Не поддерживается: TgWitness осуществляет мониторинг в качестве учетной записи пользователя |
| Списки многих учетных записей в форматах CSV/JSON | Импортируйте поддерживаемые файлы сессий через Аккаунты → Импорт учетных записей или войдите по номеру телефона / QR-коду в отдельных рабочих пространствах |
| Тестовые сеансы DC или сеансы с ботами | Используйте рабочую учетную запись пользователя |
Наличие нескольких учётных записей#
Нажмите + рядом с выбором учётной записи или откройте Дополнительные инструменты → Учётная запись → Настройки → Настройки подключения → Рабочие пространства, введите название и войдите в систему.
- Неограниченное количество рабочих пространств, включая основное. Каждое из них имеет собственную сессию, прокси- маршрут, источники, политику сбора данных, журнал, ключ подписи, контрольные точки и настройки экспорта.
- Переключение между отображаемыми рабочими пространствами не приводит к приостановке работы остальных.
- Журнал привязан к учетной записи, с которой он был создан. Для входа под другой учетной записью требуется отдельное рабочее пространство, при этом одна учетная запись не может быть привязана к двум рабочим пространствам.
- Токен главной панели управляет всеми рабочими пространствами. Предоставленный доступ позволяет ограничить доступ других пользователей к выбранным аккаунтам и чатам с помощью отдельных прав доступа и ограничений по продолжительности сеанса.
- Функция «Учётные записи» позволяет переименовать рабочую область и удалить добавленную рабочую область вместе с её сессией, журналом, источниками и ключом подписи. Главную рабочую область нельзя удалить с панели.
Массовый импорт и группы аккаунтов#
Воспользуйтесь меню «Аккаунты» → «Импорт аккаунтов», чтобы добавить несколько аккаунтов, сопоставить файлы по базовому имени и просмотреть результаты каждого входа в систему. Каждому аккаунту выделяется собственная рабочая область.
Группа объединяет связанные аккаунты, не объединяя при этом их сессии, ключи или
доказательства. Открыв группу в разделе «Аккаунты», вы перейдёте на её страницу по адресу /groups/<id>:
- Аккаунты: маршрут подключения каждого участника, наблюдения и последнее сообщение, с кнопками «Запустить все» и «Приостановить все».
- Требует внимания: аккаунты, из которых вышли, которые недоступны или у которых возникли проблемы с подключением, приемом данных, источником или мультимедиа; каждое имя ведёт к соответствующей карточке.
- В чатах нескольких учетных записей отображаются: общие источники, учетные записи, наблюдающие за ними, и перерывы в периоде наблюдения за рабочим пространством (до семи дней). Экспорт с N учетными записями распределяет экспорт канала или супергруппы между ними и подписывает один архив.
- Экспорт группы: один элемент ZIP, в котором находится подписанный экспорт каждого аккаунта в разделе
accounts/иmanifest.jsonс указанием их SHA-256 и отпечатков ключей, подписанных главным рабочим пространством вmanifest.signature.json. Проверяйте каждый архив аккаунта отдельно с помощьюpython -m tgwitness.verifyи доверенным отпечатком этой учетной записи.
Участники используют общие настройки группы; при этом каждый аккаунт может сохранять свои собственные значения. См. раздел «Общие настройки», руководство по импорту и группам, а также панель управления пулом MTProxy.
Выйти#
Дополнительные инструменты → Учётная запись → Выйти из Telegram (с приостановкой наблюдения) отправляет запрос Telegram на завершение сеанса, в результате чего он также исчезает из раздела Настройки → Устройства учётной записи и удаляется из хранилища рабочей области. Журнал, источники, настройки и ключ подписи остаются, а журнал фиксирует выход из системы. Рабочая область по-прежнему принадлежит своей учётной записи: только эта учётная запись может подключиться к ней снова. Если Telegram не отвечает, сессия всё равно удаляется здесь, и панель отображает соответствующее сообщение; завершите её в Telegram в разделе Настройки → Устройства.
Когда Telegram завершает сеанс#
Если Telegram заблокирует, заморозит или выйдет из учетной записи, либо завершит сессию с другого устройства, в
журнале фиксируются причина, код ошибки Telegram, маршрут и центр обработки данных. Состояние учетной записи
отражается в отчете о потере учетной записи: подписанном файле JSON, содержащем записи журнала
за 24 часа до потери, а именно: подключения, маршруты, сессии, уведомления учетной записи и пробелы в
покрытии, каждая из которых имеет свой хеш журнала и подпись. Проверьте это с помощью
python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP; экспорт доказательств
содержит полную цепочку хешей. Заблокированная учетная запись также обнаруживается при подключении и во время наблюдения, а её
возможности отправки и присоединения к чатам отключаются.
Обеспечение безопасности файлов учетных записей#
- Относитесь к каждому
.session, TData ZIP, StringSession, Auth Key и JSON-файлу учетной записи как к паролю. TgWitness хранит импортированные данные авторизации в зашифрованном хранилище; вы можете удалить исходные файлы впоследствии. - Не запускайте одну и ту же авторизацию одновременно в двух программах. Telegram может отозвать её
(
AUTH_KEY_DUPLICATED), и обе копии перестанут работать. - Сеанс, срок действия которого истек или который был отозван, не может быть восстановлен посредством преобразования. Войдите в систему заново.
Устранение неполадок#
| Сообщение или признак | Что делать |
|---|---|
| Не удаётся прочитать данную сессию. Закройте исходный клиент… | Файл SQLite открыт или не завершен (файл-сайдкар -journal/-wal). Корректно закройте исходную программу и скопируйте файл заново. |
| Поддерживаемые схемы базы данных Telethon SQLite: 7 и 8 / Pyrogram … 2 и 3 | Файл был создан с использованием очень старой или неизвестной версии библиотеки. Вместо этого войдите в систему с помощью телефона или QR-кода. |
| Поддерживаются только авторизованные сеансы пользователей в производственной среде | Файл Pyrogram принадлежит боту или тестовой сети. |
| Архив TData превышает 512 записей или 32 МиБ | В ZIP-архив следует включить только файлы key_datas и D877F783D5D3EF8Cs, а не всю папку. |
| Не удаётся расшифровать TData. Проверьте локальный пароль на рабочем столе | Введите локальный пароль Telegram Desktop в поле «Пароль» или «Текст сеанса». |
| Импортируйте по одной учетной записи TData за раз | В Telegram Desktop было несколько учётных записей; см. раздел «Неподдерживаемые форматы». |
| Выбранные файлы содержат информацию о различных учетных записях или учетных данных API | Выберите файлы только из одной учетной записи. |
| Файл JSON не содержит учетных данных или авторизационных данных для поддерживаемых API | Проверьте названия полей в JSON-файле учетной записи. |
| Только метаданные API | В JSON отсутствует сессия. Добавьте файл .session или воспользуйтесь номером телефона/QR-кодом. |
| HEX-код авторизационного ключа должен содержать все 512 шестнадцатеричных символов | Ключ усечён или содержит символы «…». |
| Идентификатор учетной записи не совпадает с импортированной учетной записью | Идентификатор пользователя в файле отличается от того, который указывает Telegram; данный файл относится к другому аккаунту. |
| Данный аккаунт уже принадлежит другому рабочему пространству | Откройте эту рабочую область вместо того, чтобы добавлять аккаунт дважды. |
| Связано, но в списке чатов в разделе Дополнительные инструменты → Источники отсутствует закрытая группа. | Проверить членство. Выборщик проверяет первые 1,000 диалогов; увеличить лимит в разделе Дополнительные инструменты → Параметры. |
| Ошибка подключения через прокси | Проверьте режим маршрутизации и IP. При автоматическом режиме MTProxy происходит попытка подключения к другой рабочей записи. При режиме «Скрыть адрес» происходит ожидание; режим «Прямой» в крайнем случае позволяет подключиться напрямую после заданной задержки. См. режимы маршрутизации. |
См. также: подключение и безопасность прокси-серверов и шифрования, а также принципы сбора данных, которые фиксируются после входа в систему.