Перейти к основному содержанию
Joomla входит через Veriqa на плагине miniOrange OAuth Client. Технически всё штатно: правок кода не требуется вообще. Ограничения здесь другие: бесплатная версия не создаёт пользователей и пускает ограниченное число раз.
Проверено вживую: Joomla 5 + miniOrange OAuth Client 3.2.0 (free). Работает вход в существующую учётную запись. Поведение текущей версии 3.2.3 (октябрь 2026) описано по исходникам бесплатного пакета: поиск учётной записи по username, флаг «Update Email» и лимит в 25 входов вживую не проверялись.
Главные ограничения — коммерческие.
  • Автосоздания нет. Незнакомому пользователю бесплатная версия показывает «Automatic user creation is not available in the free version» и предлагает перейти на платный тариф. Кода создания учётной записи в ней нет вообще.
  • Всего 25 входов. Каждый успешный вход увеличивает счётчик, и после 25-го плагин отвечает «Reached the authentication limit, Please contact your administrator.». Сброса счётчика в коде нет, неограниченный вход — в платных тарифах.
Значит бесплатно доступен не тот сценарий, что на WordPress и Drupal: там через мессенджер можно зарегистрироваться с нуля, здесь — только попробовать вход в учётные записи, заведённые администратором. Для работы с реальными пользователями нужен платный тариф miniOrange.

Установка и настройка

Ставится miniOrange OAuth Client (GPLv2, J3–J6), текущая версия — 3.2.3. Архив zip скачивается по прямой ссылке, аккаунт miniOrange не нужен. Открытая альтернатива damyvv/openidconnect-joomla не развивается: последний коммит — 2023 года, под Joomla 5 её не обновляли.
  1. Установите пакет.
  2. Включите плагин PLG_SYSTEM_MINIORANGEOAUTH — он приходит выключенным.
  3. В Configuration выберите провайдер Custom OpenID Connect App и задайте client_id, client_secret, три эндпоинта и scopes.
  4. Снимите галочку «In Header» в блоке «Set Client Credentials».
  5. На шаге сопоставления атрибутов выберите email и для Email Attribute, и для Username Attribute — почему, см. ниже.
redirect_uri у Joomla 4+ — маршрут веб-сервиса, а не страница сайта: {сайт}/api/index.php/v1/miniorangeoauth. Ссылка входа — тот же путь с ?morequest=oauthredirect&app_name=openidconnect.

Три ловушки установки

  1. Установщик выдаёт противоречивые сообщения. Рядом появляются Can't find XML setup file (warning) и Installation successful. Ставится всё нормально — предупреждение относится к промежуточному архиву внутри пакета.
  2. Системный плагин выключен после установки. Без него вход не работает, и в интерфейсе это не бросается в глаза.
  3. ID2087 при обмене кода. По умолчанию плагин шлёт учётные данные и заголовком Authorization: Basic, и в теле запроса, а RFC 6749 §2.3.1 разрешает только один способ. Лечится снятием галочки «In Header». Сообщение плагина «проверьте client id и secret» уводит не туда — дело не в них.

Email и username: обязательны на каждом входе

Плагин читает оба атрибута до поиска учётной записи, то есть на каждом входе, и обрывает вход, если:
  • Email Attribute не сопоставлен — «Login not Allowed», «Attibute Mapping is empty»;
  • email пришёл пустым — [MOOAUTH-008] : Email attribute is not received.;
  • username пришёл пустым — [MOOAUTH-009] : Username attribute is not received..
Учётную запись плагин ищет только по username: значение Username Attribute должно совпасть с полем «Логин» пользователя в Joomla. По email поиска нет. Поэтому сопоставьте с email оба атрибута и сделайте email обязательным в Veriqa: задайте RequireEmail в Veriqa:ScopesClaims или в записи клиента и запрашивайте scope email. Тогда Veriqa спросит адрес и подтвердит его письмом внутри того же входа, на любом канале, и оба атрибута не придут пустыми — см. Получение телефона и email. Адрес нужен плагину на каждом входе, но спрашивать его каждый раз не придётся: с включённым хранилищем собранных claims Veriqa запоминает подтверждённый адрес и на следующих входах подставляет его сама. Администратор заводит пользователя с логином, равным его адресу почты, и пользователь подтверждает именно этот адрес.
Сопоставлять Username Attribute с sub смысла нет: логин в Joomla пришлось бы задать вида telegram:123456789, а этот идентификатор администратор до первого входа не знает.
Флаг Update Email (по умолчанию выключен) после входа перезаписывает email учётной записи значением из Email Attribute. Плагин проверяет формат адреса и не записывает адрес, занятый другим пользователем. Если оба атрибута сопоставлены с email, флаг ничего не меняет — его можно не трогать.

Ограничения бесплатной версии

  • нет автосоздания пользователей: вход только в учётные записи, заведённые администратором;
  • всего 25 успешных входов на установку;
  • нет расширенного сопоставления атрибутов и ролей и advanced login.