Auth key и форматы сессий Telegram
AuthKey — секретный ключ авторизации MTProto. Session, StringSession и Session+JSON — способы сохранения или передачи данных клиента; их совместимость зависит от программы, создавшей экспорт.

Содержание материала
Auth Key (HEX): что означает подпись в форме
HEX — способ записать ключ шестнадцатеричными символами. Для 256 байт требуется 512 символов: по два на каждый байт.
Сама подпись Auth Key (HEX) не обозначает отдельный вид аккаунта.
| У вас есть | Что это означает | Куда перейти |
|---|---|---|
| AuthKey в HEX и известный DC ID | Ключ и контекст подключения; это ещё не готовый файл Session. | Пошаговый импорт AuthKey в Telecobra |
| Каталог TData | Локальные данные Telegram Desktop. Каталог или ZIP нельзя вставить в поле HEX. | Что такое TData и как выбирать способ переноса |
| Session или Session+JSON | Данные конкретного клиента; схему нужно сверить с импортёром. | Таблица форматов в следующем разделе этой статьи. |
Строка правильной длины не подтверждает действительность ключа.
Не вставляйте рабочий AuthKey в поисковик, онлайн-генератор или публичный чат. В официальной документации создание ключа MTProto описано отдельно от пользовательского интерфейса импорта.
Что такое AuthKey#
AuthKey (auth_key) — секретный ключ, который клиент и сервер Telegram вырабатывают для MTProto. Это 256-байтовое значение. В текстовом HEX-представлении один байт записывается двумя символами, поэтому ключ занимает 512 шестнадцатеричных символов.
Ключ используют при защищённом обмене с сервером; после авторизации пользователя он связан с доступом к аккаунту.
Идентификатор сессии MTProto — отдельное понятие. В названиях файлов сторонних программ слово Session обычно означает сохранённые данные клиента, а не один этот идентификатор.
AuthKey, Session, StringSession и Session+JSON#
| Название | Конкретный источник | Что передаётся | Граница совместимости |
|---|---|---|---|
| AuthKey | Клиент MTProto; в Telecobra — форма Auth Key (HEX) | Сам ключ; для формы Telecobra также нужен его DC ID | Ключ не является готовым файлом сессии. HEX, строка экспорта и API Hash — разные данные. |
| Session / .session | Например, Telethon 1.x — SQLiteSession | База с ключом, параметрами подключения и данными, которые сохраняет библиотека | Нужен импорт именно схемы Telethon. Расширение .session не определяет схему. |
| Session / .session | Pyrogram — File Storage | SQLite-база Pyrogram | Совпадение расширения и типа базы с Telethon не делает файлы взаимозаменяемыми. |
| StringSession | Telethon — telethon.sessions.StringSession | Строковое представление данных для подключения | Принимающий инструмент должен разбирать StringSession Telethon. |
| Session string | Pyrogram — export_session_string() | Строковый экспорт Pyrogram | Это формат Pyrogram, а не другое имя для строки Telethon. |
| Session+JSON | Например, экспорт аккаунта Telecobra; у другого экспортёра — своя схема | Файл сессии и связанное описание параметров | Нужно знать производителя пары, тип .session, состав JSON и требования импортёра. |
Названия форматов взяты из документации Telethon и Pyrogram. Таблица не заявляет, что Telecobra принимает любую версию каждой библиотеки.
Что нельзя подставлять вместо ключа#
- API ID и API Hash описывают Telegram-приложение. Они не заменяют пользовательскую авторизацию.
- Токен Bot API предназначен для бота и другого интерфейса.
- StringSession содержит упакованные данные; её нельзя целиком вставлять в поле AuthKey HEX.
- TData — каталог Telegram Desktop. Путь к нему и ZIP-архив не являются ключом.
Форма может распознать правильную длину HEX, но это не доказывает действительность ключа.
Если неизвестен DC ID или строка обрезана, вернитесь к исходному комплекту своих данных.
Дописывание символов и случайный перебор DC не восстанавливают сессию.
Как описать исходные данные#
До переноса запишите название и версию программы-источника, способ экспорта, список расширений, наличие JSON и нужный целевой формат.
Для Session+JSON сохраните соответствие пары одному аккаунту.
Это сведения о формате; содержимое ключа для такой карточки не требуется.
Не размещайте рабочие строки и файлы сессий в статье, скриншоте или открытом репозитории. Они могут предоставлять доступ к аккаунту.
Пример имени account_a.session описывает файл, но не содержит реальной авторизации.
Почему Session+JSON не универсальный стандарт#
В этом названии указана упаковка из двух файлов, а не единая схема Telegram.
JSON может сопровождать сессию параметрами конкретной программы; сам по себе набор настроек не восстанавливает отсутствующий ключ.
Например, Telecobra экспортирует аккаунт в Session+JSON. При переносе такого комплекта нужно сверить требования принимающей программы.
Для пары от другого инструмента дополнительно выясняют, какой клиент создал .session и что означают поля JSON.
Переименование расширений не выполняет конвертацию.
Импорт в Telecobra и отдельный конвертер#
Для подключения аккаунта в основной платформе выбирают соответствующий режим: Auth Key — для HEX и DC ID, «Загрузить» — для поддерживаемых файлов Session+JSON, «Из tdata» — для ZIP с каталогом TData.
Отдельный инструмент «Сессии Telegram — Telecobra 5» заявляет загрузку TData в ZIP, Session+JSON и StringSession.
Доступный результат зависит от разобранных данных. Обычного JSON без сессии недостаточно; защищённая локальным паролем TData в этой версии не поддерживается.
Преобразование файла и проверка доступа — разные операции: этот конвертер прямо указывает, что не проверяет действительность сессии в Telegram.
Матрицу совместимости всех сторонних экспортёров из списка входных форматов вывести нельзя.
Порядок проверки перед переносом#
- Сохраните исходный комплект в отдельном закрытом месте.
- Сопоставьте программу-источник с документированным форматом импортёра.
- Выберите нужный сценарий: подключить аккаунт или получить файл другого формата.
- После разбора проверьте, какой аккаунт обнаружен и какие поля отсутствуют.
- Если требуется рабочее подключение, отдельно подтвердите авторизацию и права на свою задачу.
Что означает ошибка#
| Симптом | Что проверить |
|---|---|
| Файл не распознан | Реальный формат, производителя и версию; целостность исходного комплекта. |
| Не хватает параметров | Соответствие JSON файлу сессии и наличие полей, требуемых именно выбранным форматом. |
| Database is locked | Не использует ли тот же файл другой процесс. Это не название ошибки AuthKey. |
| AuthKeyUnregistered / Session Revoked | Точный ответ при подключении и состояние авторизации. Конвертация не оживляет отозванный доступ. |
Источники и дата проверки#
Проверено 9 октября 2026 года. Документы протокола, библиотек и Telecobra подтверждают только описанные в них возможности. Действующие ключи, файлы сессий и реквизиты прокси в примерах не используются.
- Telegram MTProto: AuthKey — создание ключа авторизации.
- Telegram MTProto: описание протокола — роль ключа и отдельного идентификатора сессии.
- Telethon: Session Files — SQLiteSession и StringSession этой библиотеки.
- Pyrogram: Storage Engines — собственные файлы и строковый экспорт Pyrogram.
- Форма Auth Key в Telecobra — HEX и DC ID.
- Импорт файлов в Telecobra — раздельные способы подключения.
- Сессии Telegram — Telecobra 5 — заявленные входные форматы и ограничения отдельного конвертера.
Инструменты для вашей
работы в Telegram
Узнайте условия доступа и выберите возможности Telecobra под свою задачу.
- Парсинг
- Приглашения
- Рассылки