Проверено вживую: Joomla 5 + miniOrange OAuth Client 3.2.0 (free). Работает вход
в существующую учётную запись. Поведение текущей версии 3.2.3 (октябрь 2026) описано по
исходникам бесплатного пакета: поиск учётной записи по username, флаг «Update Email» и лимит в
25 входов вживую не проверялись.
Установка и настройка
Ставится miniOrange OAuth Client (GPLv2, J3–J6), текущая версия — 3.2.3. Архив zip скачивается по прямой ссылке, аккаунт miniOrange не нужен. Открытая альтернативаdamyvv/openidconnect-joomla не
развивается: последний коммит — 2023 года, под Joomla 5 её не обновляли.
- Установите пакет.
- Включите плагин
PLG_SYSTEM_MINIORANGEOAUTH— он приходит выключенным. - В Configuration выберите провайдер Custom OpenID Connect App и задайте
client_id,client_secret, три эндпоинта и scopes. - Снимите галочку «In Header» в блоке «Set Client Credentials».
- На шаге сопоставления атрибутов выберите
emailи для Email Attribute, и для Username Attribute — почему, см. ниже.
redirect_uri у Joomla 4+ — маршрут веб-сервиса, а не страница сайта:
{сайт}/api/index.php/v1/miniorangeoauth. Ссылка входа — тот же путь с
?morequest=oauthredirect&app_name=openidconnect.
Три ловушки установки
- Установщик выдаёт противоречивые сообщения. Рядом появляются
Can't find XML setup file(warning) иInstallation successful. Ставится всё нормально — предупреждение относится к промежуточному архиву внутри пакета. - Системный плагин выключен после установки. Без него вход не работает, и в интерфейсе это не бросается в глаза.
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..
email оба атрибута и сделайте email обязательным в Veriqa: задайте
RequireEmail в Veriqa:ScopesClaims или в
записи клиента и запрашивайте scope email. Тогда Veriqa
спросит адрес и подтвердит его письмом внутри того же входа, на любом канале, и оба атрибута не
придут пустыми — см. Получение телефона и email. Адрес нужен плагину на каждом
входе, но спрашивать его каждый раз не придётся: с включённым хранилищем собранных claims
Veriqa запоминает подтверждённый адрес и на следующих входах подставляет его сама. Администратор
заводит пользователя с логином, равным его адресу почты, и пользователь подтверждает именно этот
адрес.
Сопоставлять Username Attribute с
sub смысла нет: логин в Joomla пришлось бы задать вида
telegram:123456789, а этот идентификатор администратор до первого входа не знает.email, флаг ничего не меняет — его можно не
трогать.
Ограничения бесплатной версии
- нет автосоздания пользователей: вход только в учётные записи, заведённые администратором;
- всего 25 успешных входов на установку;
- нет расширенного сопоставления атрибутов и ролей и advanced login.