Проверено: редакция «Управление сайтом: Бизнес», модуль из Маркетплейса. Работают вход,
регистрация, автосоздание пользователя, привязка мессенджера в профиле.
Что понадобится
- «1С-Битрикс: Управление сайтом» с установленным модулем «Социальные сервисы»;
- PHP 8.1 или новее;
- сервер Veriqa, доступный с сайта. Как его запустить, рассказано на странице Быстрый старт: self-hosted;
- каналы, подключённые к серверу Veriqa: бот или бизнес-аккаунт в каждом мессенджере, через который будет вход. Условия подключения задают сами мессенджеры: например, бота MAX может создать только организация или ИП, зарегистрированные в РФ;
- для ввода email при входе — сервер Veriqa 0.7.0 или новее. Вход с адресом-заглушкой работает и на более ранних версиях.
Установка
- Установите решение со страницы Маркетплейса или из админки сайта, затем откройте «Marketplace → Установленные решения → Veriqa → Установить». Без модуля «Социальные сервисы» или на PHP ниже 8.1 установщик остановится и назовёт причину.
- Зарегистрируйте сайт клиентом на сервере Veriqa (следующий раздел).
- Откройте «Настройки → Настройки модулей → Социальные сервисы», отметьте Veriqa и заполните блок Veriqa (раздел Настройки модуля). Для отдельной кнопки регистрации отметьте ещё Veriqa: регистрация.
- Включите регистрацию новых пользователей (раздел Регистрация).
Клиент на сервере Veriqa
Сайту нужен на сервере Veriqa свой клиент:- адрес возврата — тот, что модуль показывает под своими настройками:
https://<ваш сайт>/bitrix/tools/veriqa.auth/callback.php; - секрет клиента;
- scope
openid,profile,emailиchannel. Без них сервер отклонит вход с ошибкойinvalid_scope.
Настройки модуля
Настройки находятся на странице «Социальные сервисы» в блоке Veriqa. У каждого сайта они свои.
У кнопки Veriqa: регистрация своих настроек нет: адрес и ключи она берёт из блока Veriqa и
всегда спрашивает 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 или новее.
Что видит посетитель
-
Страница входа (
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 построен так же, на штатных точках расширения:
- обработчик события
OnAuthServicesBuildListвозвращает дескриптор провайдера (ID/CLASS/NAME/ICON) — после этого кнопка появляется в форме входа сама, шаблон формы править не нужно; - класс провайдера отдаёт ссылку на
/connect/authorizeи обрабатывает возврат; CSocServAuth::AuthorizeUser()берёт на себя поиск, создание и связывание — связь ложится вb_socialservices_user.
apple.php в модуле socialservices.
Без двух настроек из раздела Регистрация 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) и переносит их в таблицу связей без дублей — миграция со старой интеграции
проходит сама.