Всё на этой странице — про локальную проверку. В продакшне, где у Veriqa настоящий домен и
валидный сертификат, ни одной из этих сложностей нет: боевая схема проще локальной.
Сертификат
Самоподписанный сертификат придётся смонтировать внутрь каждого контейнера и выполнитьupdate-ca-certificates — иначе обмен кода на токены в PHP-cURL завершается ошибкой. В продакшне
этого шага нет вовсе.
Отдельная ловушка: антивирус, перехватывающий TLS, подменяет самоподписанный сертификат своим
и показывает заглушку «переход на домен с недоверенным сертификатом». Ссылка «продолжить» в такой
заглушке теряет query string — то есть весь OIDC-запрос, — поэтому пройти её нельзя ни мышью, ни
программно. Серверные вызовы это не затрагивает: PHP в контейнере ходит по смонтированному CA и
проблемы не видит.
Рабочий обход, не трогающий настройки безопасности машины: поднять два HTTPS-эндпоинта —
один со своим сертификатом для контейнеров, другой с dev-сертификатом, уже доверенным в системе,
для браузера человека.
Адрес issuer
Три правила:- issuer только по https. На
http://localhost:5200ядро отвечает отказом даже в Development.redirect_uriпоhttpпри этом принимается — ограничение касается именно адреса issuer; - адрес должен резолвиться одинаково из контейнера и с хоста, иначе
issв discovery не совпадёт с тем, что видит браузер; - приватный адрес блокируется клиентами.
host.docker.internal— приватная сеть, и почти каждая система защищается от обращений туда собственным флагом: WordPress блокирует такие запросы черезwp_safe_remote_post()(лечится настройкойallow_internal_idp), Drupal — флагомallow_private_issuer, Nextcloud —allow_local_remote_servers, Discourse —allowed_internal_hosts, Moodle —curlsecurityblockedhosts. В продакшне адрес публичный, и все эти флаги не нужны.
Hop-режим на локальном стенде
Hop-режим стоит попробовать и локально — именно его рекомендуется включать в продакшне. К правилам issuer выше он добавляет одно условие: QR-код несёт ссылку на адрес issuer, и открывает её телефон. Доlocalhost вашей машины телефон не дотянется, а
вашему самоподписанному сертификату не доверяет.
Откройте доступ к Veriqa через HTTPS-туннель — любой сервис, который даёт локальному порту публичный
адрес https с действительным сертификатом, — и задайте этот адрес как issuer
(Veriqa:OpenIddict:Server:Issuer). Правило одного адреса для всех действует и здесь: браузер,
контейнеры и телефон должны видеть адрес туннеля, а не localhost. После этого включите hop-режим:
Veriqa:HopMode:Enabled = true.
В продакшне ничего из этого не нужно: issuer там уже публичный адрес https.
Мелочи окружения
Почта
Для канала Email локально удобно поднять почтовый приёмник вместо настоящего SMTP: письма никуда не уходят, а ссылку из письма видно в его веб-интерфейсе. Канал Email ограничивает частоту писем: новое письмо того же входа раньшеMailResendInterval
(по умолчанию 30 секунд) получает 429, как и письмо на адрес, который за час уже получил
SignInMailsPerAddress писем (по умолчанию 5). Закладывайте паузу между попытками или берите другой
адрес.
Чего локальный стенд не проверяет
- доставляемость почты — SPF, DKIM, DMARC и репутацию домена локальный приёмник не проверяет;
- поведение сторонних платформ — Shopify и Wix ходят к Veriqa снаружи, им нужен её публичный HTTPS-адрес, см. SaaS-конструкторы;
- скорость под нагрузкой — локальные цифры отклика ничего не говорят о продакшне.