Проверено: 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.
Включите все три: 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 обязательным в 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 изменится, ранее заведённые пользователи перестанут узнаваться.
Ограничения
- Хук выше — пример, а не готовый модуль для продакшна: решение про адреса принимает сам сайт.