Перейти к основному содержанию
Drupal подключается к Veriqa штатными contrib-модулями. Правится только сторона сайта: сервер Veriqa и его поставка не трогаются.
Проверено: Drupal 10 + openid_connect 3.0.0-alpha8 + openid_client_advanced 1.0.0-rc8. Работают вход, создание пользователя, проверка подписи id_token по JWKS, nonce и PKCE S256.

1. Модули

openid_connect 3.0.0 — alpha, и это стоит учитывать при планировании. openid_client_advanced зависит от firebase/php-jwt.

2. Клиент и три переключателя

Configuration → People → OpenID Connect, плагин advanced. Заполняются issuer_url, три эндпоинта (/connect/authorize, /connect/token, /connect/userinfo) и scopes.
PKCE в самом openid_connect выключен на уровне кода (usesPkce() возвращает FALSE). PKCE S256, проверка подписи и nonce реализованы в openid_client_advanced, и все три по умолчанию выключены. «Drupal умеет PKCE» — верно только после того, как вы их включили.
Включите все три: use_pkce, use_nonce, validate_signature с allowed_algorithms: [RS256]. Ключи вставляются JSON-ом JWKS — поле ждёт содержимое документа /.well-known/jwks, а не ссылку на него. Ещё три настройки, без которых поведение будет неожиданным:
  • openid_connect.settings.user_login_display = above — иначе кнопки входа на форме просто не видно;
  • override_registration_settings и user.settings.register — определяют, разрешено ли создавать учётные записи через провайдера.
redirect_uri = {адрес сайта}/openid-connect/{id сущности клиента}.

3. Drupal требует email — на каждом входе

Самое важное место рецепта. openid_connect отклоняет вход, если провайдер не вернул адрес: в логе появляется No email address provided by <provider>, настройки обхода нет.
Проверка выполняется не при регистрации, а при построении контекста, до того как ищется учётная запись. Поэтому уже зарегистрированный пользователь без email тоже не войдёт: email нужен на каждом входе, а не только на первом.
Прямой путь — сделать email обязательным в Veriqa: задайте RequireEmail в Veriqa:ScopesClaims или в записи клиента и запрашивайте scope email. Тогда Veriqa спросит адрес и подтвердит его письмом внутри того же входа, до выдачи токенов, на любом канале — см. Получение телефона и email. Drupal получит настоящий адрес, а сайт править не придётся. Если спрашивать email у пользователей вы не хотите, запасной путь — хук, который модуль документирует сам (openid_connect.api.php) и вызывает до проверки; правка находится в вашем модуле, contrib и Veriqa остаются нетронутыми:
mymodule.module
Адрес получается вида telegram-123456789@telegram.veriqa.invalid. Домен .invalid зарезервирован RFC 2606 и гарантированно никуда не доставляется — это осознанная цена, а не бесплатный обход: учётная запись с таким адресом не получит ни сброса пароля, ни уведомлений. Используйте его, только если сайту никогда не нужно отправлять пользователю письма.

connect_existing_users — настройка, которую нельзя оставлять без внимания

Для нового пользователя Drupal сверяет адрес с существующими учётными записями. При включённом connect_existing_users он привяжет найденную локальную учётную запись к идентичности из Veriqa. С синтетическими адресами это безопасно: они детерминированы и уникальны на пару «канал + id». Но как только Veriqa начнёт отдавать настоящий адрес (обязательный email, канал Email или собственный резолвер), вход через Veriqa захватит локальную учётную запись с тем же адресом — классический захват через непроверенный email. Включайте эту настройку, только если уверены, что IdP проверил адрес. Адрес, который собирает Veriqa, подтверждён, если ClaimCompletionEmailMethods не разрешает Unverified: этот способ даёт email_verified: false.

Что получится

Учётная запись создаётся с именем из preferred_username (alice), а в authmap появляется запись provider=openid_connect.veriqa, authname=telegram:123456789 — Drupal связывает идентичность по sub Veriqa. Практический вывод: sub для Drupal — ключ учётной записи. Если способ его формирования на стороне Veriqa изменится, ранее заведённые пользователи перестанут узнаваться.

Ограничения

  • Хук выше — пример, а не готовый модуль для продакшна: решение про адреса принимает сам сайт.