Перейти к основному содержанию
На сайт «1С-Битрикс: Управление сайтом» вход через Veriqa ставится модулем Veriqa из Маркетплейса. Посетитель сканирует QR-код или нажимает кнопку и подтверждает вход в мессенджере. При первом входе сайт создаёт ему учётную запись. Модуль подключает Veriqa к штатному модулю «Социальные сервисы», поэтому поиск, создание и привязку учётных записей делает сама платформа. Весь путь посетителя показан на видео о входе в магазин на Битриксе, там же ссылка на статью о подключении.
Проверено: редакция «Управление сайтом: Бизнес», модуль из Маркетплейса. Работают вход, регистрация, автосоздание пользователя, привязка мессенджера в профиле.
Посетитель сканирует QR-код и подтверждает вход в MAX:

Что понадобится

  • «1С-Битрикс: Управление сайтом» с установленным модулем «Социальные сервисы»;
  • PHP 8.1 или новее;
  • сервер Veriqa, доступный с сайта. Как его запустить, рассказано на странице Быстрый старт: self-hosted;
  • каналы, подключённые к серверу Veriqa: бот или бизнес-аккаунт в каждом мессенджере, через который будет вход. Условия подключения задают сами мессенджеры: например, бота MAX может создать только организация или ИП, зарегистрированные в РФ;
  • для ввода email при входе — сервер Veriqa 0.7.0 или новее. Вход с адресом-заглушкой работает и на более ранних версиях.

Установка

  1. Установите решение со страницы Маркетплейса или из админки сайта, затем откройте «Marketplace → Установленные решения → Veriqa → Установить». Без модуля «Социальные сервисы» или на PHP ниже 8.1 установщик остановится и назовёт причину.
  2. Зарегистрируйте сайт клиентом на сервере Veriqa (следующий раздел).
  3. Откройте «Настройки → Настройки модулей → Социальные сервисы», отметьте Veriqa и заполните блок Veriqa (раздел Настройки модуля). Для отдельной кнопки регистрации отметьте ещё Veriqa: регистрация.
  4. Включите регистрацию новых пользователей (раздел Регистрация).

Клиент на сервере Veriqa

Сайту нужен на сервере Veriqa свой клиент:
  • адрес возврата — тот, что модуль показывает под своими настройками: https://<ваш сайт>/bitrix/tools/veriqa.auth/callback.php;
  • секрет клиента;
  • scope openid, profile, email и channel. Без них сервер отклонит вход с ошибкой invalid_scope.
Для сервера, который настраивается переменными окружения:

Настройки модуля

Настройки находятся на странице «Социальные сервисы» в блоке Veriqa. У каждого сайта они свои. У кнопки Veriqa: регистрация своих настроек нет: адрес и ключи она берёт из блока Veriqa и всегда спрашивает email. Учётная запись у обеих кнопок общая.

Регистрация

Чтобы при первом входе создавалась учётная запись, нужны две настройки:
  • «Позволять пользователям регистрироваться самостоятельно» в настройках Главного модуля;
  • регистрация новых пользователей в настройках «Социальных сервисов» — по умолчанию она включена.
Без них вход нового посетителя завершается отказом, и снаружи это выглядит как сбой входа, а не как настройка. Учтите, что первая настройка включает и штатную регистрацию Битрикса.

Email

Битрикс требует email только у нового пользователя, и требование отключается настройкой main.new_user_email_required. Это мягче, чем у Drupal и Joomla, где адрес нужен на каждом входе. Канал Email передаёт адрес сам. MAX, Telegram и другие мессенджеры адреса не передают, и тогда работает настройка Email пользователя:
  • Адрес-заглушка, если канал не передаёт email — учётная запись получает адрес вида telegram-123@telegram.veriqa.invalid. Домен .invalid зарезервирован RFC 2606: письма на такой адрес не уходят, и учётная запись не получит ни уведомлений, ни восстановления пароля;
  • Спрашивать email при входе — человек вводит адрес в окне Veriqa. Нужен сервер Veriqa 0.7.0 или новее.
Введённый адрес модуль принимает без подтверждения, только если на сайте выключены подтверждение регистрации по email, проверка уникальности email и регистрация по номеру телефона. Иначе учётная запись получает адрес-заглушку, пока Veriqa не подтвердит адрес кодом или ссылкой. Это подтверждение включается на сервере Veriqa.

Что видит посетитель

  • Страница входа (system.auth.authorize) — кнопки «Войти через мессенджер» и «Зарегистрироваться через мессенджер». Шаблон формы править не нужно.
  • Страница регистрации (system.auth.registration) — штатная форма регистрации соцсервисы не показывает, поэтому в модуле есть компонент veriqa:auth.buttons. Вставьте строку в копию шаблона формы регистрации в шаблоне сайта:
    MODE — register (по умолчанию), signin или both. Проверка includeModule нужна на случай удаления модуля: без неё платформа выведет на месте кнопки ошибку компонента.
  • Профиль (socserv.auth.split) — кнопка «Привязать мессенджер» привязывает мессенджер к уже существующей учётной записи. Привязанный профиль показан как «Имя (MAX)».

Свой вид кнопок

  • Отметьте Не подключать оформление кнопок Veriqa и оформите в шаблоне сайта классы veriqa, veriqa-register и разметку компонента veriqa-auth-button.
  • Или скопируйте шаблон компонента в шаблон сайта (components/veriqa/auth.buttons/.default) и измените его.
  • Ссылку на вход для своей кнопки в любом месте сайта возвращает (new \Veriqa\Auth\Provider())->getUrl(['BACKURL' => '/']). Для входа, который спрашивает email, — \Veriqa\Auth\RegisterProvider.

Удаление

«Marketplace → Установленные решения → Veriqa → Удалить» снимает обработчик события, файлы модуля в /bitrix/tools, /bitrix/css и /bitrix/components и настройки модуля. Пользователи, входившие через Veriqa, и их привязки остаются: после повторной установки они войдут в прежние учётные записи.

Своя интеграция без модуля

Сервер Veriqa — стандартный провайдер OpenID Connect, и интеграцию с ним можно написать самостоятельно, без модуля.

Что не подойдёт

Встроенный COpenIDClient — это OpenID 2.0, а не OpenID Connect: в нём есть openid.ns и check_authentication, но нет ни id_token, ни JWKS, ни PKCE. С Veriqa он несовместим в принципе. По умолчанию в форме входа активны как раз сервисы той эпохи — Livejournal, Rambler, Blogger, Mail.Ru OpenID.

Провайдер socialservices

Модуль Veriqa построен так же, на штатных точках расширения:
  1. обработчик события OnAuthServicesBuildList возвращает дескриптор провайдера (ID / CLASS / NAME / ICON) — после этого кнопка появляется в форме входа сама, шаблон формы править не нужно;
  2. класс провайдера отдаёт ссылку на /connect/authorize и обрабатывает возврат;
  3. CSocServAuth::AuthorizeUser() берёт на себя поиск, создание и связывание — связь ложится в b_socialservices_user.
Образец OIDC-провайдера есть в комплекте платформы: apple.php в модуле socialservices.
Callback держите в /local/, а не в /bitrix/tools/oauth/ — каталог /bitrix/ затирается обновлением. Публичного CSocServAuthManager::Authorize($id) для этого достаточно.
Без двух настроек из раздела Регистрация AuthorizeUser возвращает SOCSERV_REGISTRATION_DENY:

Ловушка CUser::GetList — читать обязательно

CUser::GetList не понимает D7-синтаксис '=ПОЛЕ': нераспознанные ключи фильтра он молча выбрасывает и ведёт себя так, будто фильтра не было. Fetch() отдаёт первую строку — то есть пользователя с id 1, администратора. Код «нашли существующего и авторизовали» превращается во вход администратором после любой успешной OIDC-аутентификации. Дыры в Битриксе тут нет: в самой платформе ключи написаны верно. Виновато смешение диалектов в коде интеграции. Правило простое: либо старые ключи в старом API, либо D7-синтаксис в UserTable::getList(), но не вперемешку. И «своих» пользователей ищите через связи в b_socialservices_user, а не по полям b_user.

Ещё три ловушки каркаса

  • getUrl() вызывается дважды за одну отрисовку формы (GetFormHtml и GetOnClickJs) — генерацию state и PKCE нужно кешировать в пределах запроса, иначе второй вызов перезапишет первый.
  • Сессия ядра уже открыта внутри провайдера — своя не нужна. session_write_close() закрывает сессию Битрикса посреди отрисовки страницы.
  • session_name() меняется на весь процесс. Если открыть свою сессию и не вернуть имя до prolog_before.php, ядро откроет сессию под чужой cookie: вход «исчезает» на следующем запросе.

Учётные записи

Маркер владения учётной записью ставит платформа: у созданной через каркас записи b_user.EXTERNAL_AUTH_ID = socservices — это подставляет сам CSocServAuth::AuthorizeUser. Собственный идентификатор провайдера в это поле не попадает, искать по нему бесполезно. Если канал не передаёт email, подставьте адрес вида {канал}-{id}@{канал}.veriqa.invalid, как это делает модуль. Почему такой адрес никуда не доставляется, рассказано в разделе Email. Штатный checkOldUser узнаёт учётные записи «старой схемы» (EXTERNAL_AUTH_ID плюс XML_ID прямо в b_user) и переносит их в таблицу связей без дублей — миграция со старой интеграции проходит сама.