IDMost Auth - вход через Telegram, MAX, Яндекс ID и VK ID

1. 
   Telegram: подключение в IDMost Auth 0.6.0
   

   Этот раздел дополняет основную инструкцию. Сначала проверьте подключение на копии сайта с HTTPS. Обычный вход по логину и паролю сохраните.

   1. Откройте мини-приложение BotFather, выберите своего бота и раздел Login Widget. Приложение на my.telegram.org для этого не нужно.
      
   2. В Allowed URLs добавьте origin сайта, например https://example.ru, и точный адрес возврата: https://example.ru/local/tools/idmost.auth/oauth/telegram_id/callback.php. Замените example.ru своим доменом. Адрес возврата также показан в настройках IDMost для выбранного сайта; скопируйте его без изменений.
      
   3. Сохраните выданные Client ID и Client Secret. В Login Widget > Advanced оставьте алгоритм подписи RS256.
      
   4. В настройках IDMost выберите нужный сайт и заполните поля Telegram Client ID и Telegram Client Secret. Это отдельные реквизиты входа, не токен бота. Секрет хранится только на сервере: не вставляйте его в шаблон, JS или переписку.
      
   5. В поле прав оставьте openid,profile. Право phone добавляйте только при необходимости: номер запрашивается с отдельным согласием пользователя.
      
   6. Включите авторизацию через Telegram и сохраните настройки. Откройте страницу с компонентом idmost:auth.button. Отдельный HTML-виджет Telegram добавлять не нужно: модуль использует переход через OIDC с response_type=code и PKCE S256.
      
   7. Нажмите Telegram, проверьте имя бота и адрес сайта на странице подтверждения. После согласия убедитесь, что выполнен вход под ожидаемым пользователем Битрикса.
      
   8. Выйдите из сайта и повторите вход. Затем отдельно проверьте отмену и новую попытку после истечения времени ожидания. Страницу с Композитом проверяйте в двух независимых браузерах; проверьте вход и отдельность сессий с включённым кешем вашего сервера и шаблона.
      

   Источник для настройки BotFather: официальная инструкция Telegram Login. Если адрес не принимается, сначала сверьте HTTPS, домен, путь и отсутствие лишнего слеша в конце callback.

   Перед обновлением и повторной попыткой
   

   Сделайте резервную копию файлов и базы данных, запишите установленную версию. Сначала обновите копию сайта штатным механизмом Битрикса и проверьте старые способы входа вместе с Telegram.

   Если обновление прервалось, запишите ошибку, сохраните журнал и устраните причину. Затем запустите штатное обновление ещё раз. Не удаляйте модуль с данными и не меняйте вручную отметку версии схемы. Для отката используйте согласованную копию файлов и базы с учётом новых пользователей после резервирования.

   Если не завершилась только попытка входа, вернитесь к кнопке и начните новую. Старый callback с одноразовым кодом повторно открывать не нужно.

   1. Сохраните резервную копию файлов и БД и начните с копии сайта. Требуются актуальное ядро Битрикса, PHP8.2+, UTF-8, MySQL/MariaDB, curl/mbstring/mysqli/openssl и HTTPS. Для установки из Маркета нужна действующая лицензия/поддержка платформы.
   
2. 2. Установите idmost.auth через Marketplace в админке. Откройте «Настройки -> Настройки продукта -> Настройки модулей -> IDMost Auth».
   
3. 3. Для MAX укажите своего бота и токен, настройте webhook с обязательным секретом и/или mini-app. Нажмите «Проверить бота», «Настроить webhook в MAX» и «Проверить подписку».
   
4. 4. Для Яндекс ID и VK ID создайте приложения, скопируйте точные Redirect URI из настроек модуля на нужном домене, сохраните идентификаторы/секреты и разрешения. Включайте только проверенные провайдеры. Согласования на стороне провайдера проходят отдельно.
   
5. 5. Добавьте компонент idmost:auth.button на страницу входа. RETURN_URL задает внутреннюю страницу после входа, LAYOUT=block выводит блок, inline выводит строку, module берет настройки модуля. Тема, размер, форма, ширина, подписи и локальные иконки настраиваются в модуле или параметрах компонента. Примеры для магазина, личного кабинета и закрытого раздела: https://idmost.ru/idmost-docs/setup.html#scenarios.
   
6. 6. Создание пользователей включайте только при разрешенной регистрации. Выберите обычную группу с минимальными правами. Совпадение email/телефона не заменяет проверку владельца для ручной привязки.
   
7. 7. Проверьте с компьютера и телефона все включенные способы, отмену, истечение и повтор ссылки, возврат на нужную страницу, права нового пользователя и обычный парольный вход. В MAX после подтверждения в мессенджере проверьте показанный аккаунт на сайте и нажмите «Войти с этим аккаунтом».
   
8. 8. После обновления используйте согласованный комплект модуля, компонента и обработчиков. Данные при обычном удалении сохраняются по умолчанию. Не отмечайте удаление таблиц без резервной копии и понимания последствий.
   

Полная инструкция: https://idmost.ru/idmost-docs/setup.html
Типовые ошибки: https://idmost.ru/idmost-docs/setup.html#troubleshooting
Лицензия: https://idmost.ru/idmost-docs/license.html
Установка самостоятельная. Если инструкция не дала описанный результат, обратитесь в поддержку с версиями, шагами и безопасным текстом ошибки. Секреты и персональные данные не отправляйте.

Подробная настройка оформления и размещения: https://idmost.ru/idmost-docs/customization.html . В инструкции есть PHP-вызовы компонента, CSS, свои изображения, шапка сайта, включаемая область, модальное окно и шаблон в /local/templates/. Новые параметры отмечены версией 0.5.0. Работающие примеры: https://test.idmost.ru/auth-design/ .

Установка и настройка выполняются самостоятельно по инструкции по установке.

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

В обращении укажите версии IDMost Auth, PHP и 1С-Битрикс, провайдера, ссылку на раздел инструкции, шаги воспроизведения, ожидаемый и фактический результат, время ошибки и ее безопасный код. Приложите минимальный пример или скриншот без персональных данных. Не отправляйте токены, client secret, cookies, пароли, полную строку initData и содержимое callback с одноразовым кодом.

Поддержка работает по рабочим дням с 10:00 до 18:00 по московскому времени, кроме официальных нерабочих дней. Первый ответ - в течение одного рабочего дня. Это начало рассмотрения, а не обещание исправить ошибку за этот срок. Срок решения зависит от причины и сложности; после диагностики сообщаем дальнейшие действия. Круглосуточное дежурство и SLA не включены.

Покупка включает 12 месяцев доступа к выпускаемым обновлениям и стандартной поддержке. Далее можно добровольно продлить их на 12 месяцев за 50% текущей цены решения. Без продления установленная оплаченная версия сама по себе не отключается. Частота релизов, новые функции по запросу и совместимость со всеми будущими API не обещаются.

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

Нужна установка или интеграция под ваш сайт? Можно обратиться к автору модуля Дмитрию Гребенникову через указанный выше контакт поддержки. Он помогает подключить провайдеров, разместить и оформить кнопки в шаблоне 1С-Битрикс и проверить сценарии входа. В обращении достаточно ссылки на сайт и описания задачи, без паролей и токенов. Это дополнительная платная работа: объём, стоимость и сроки согласуются отдельно до начала работ. Самостоятельная установка и стандартная поддержка модуля сохраняются на прежних условиях.