Перейти к основному содержимому

Живое демо

Вы можете перейти в демонстрационные онлайн-приложения, которые показывают Veriqa в работе:

Nova Stream — стриминг на телевизоре: показывает, как легко реализовать вход на экране без клавиатуры

Helio — страница поддержки клиентов выдуманной компании, где можно попробовать, как удобно вашим клиентам отправлять заявки в поддержку или регистрироваться в личном кабинете с помощью Veriqa

Вы также можете за несколько действий настроить свой сценарий и попробовать его в работе без написания кода, а нужный код скопировать из конструктора.

Сценарий
Каналы

Вопрос и кнопки ответа приходят прямо в чат. Email здесь не подходит: на письмо нельзя ответить кнопкой.

Оформление
Документация
Превью входа Предпросмотр подтверждения

Это макет. «Запустить вход» откроет настоящую страницу входа с этими параметрами.

Это макет. «Запустить подтверждение» создаёт настоящее подтверждение Veriqa — ответьте на него в мессенджере.

Инструкция / документация

Предусловия

  • .NET SDK 10.0+
  • Доверенный локальный HTTPS-сертификат разработки: dotnet dev-certs https --trust. Клиентское приложение само загружает метаданные издателя по HTTPS и недоверенный сертификат отклоняет — открытая https://localhost:7020/ тогда отвечает ошибкой IDX20803 … UntrustedRoot вместо перехода на страницу входа. На Linux одной команды мало: она печатает значение SSL_CERT_DIR, которое нужно экспортировать в терминале клиента, — см. шаг запуска в quickstart для .NET.
  • dotnet add package Veriqa.Core.AuthServer
  • Каналы: dotnet add package Veriqa.Core.BaseChannels (Telegram, WhatsApp, Email) и dotnet add package Veriqa.Core.ChannelAdapter.Max; нужен один канал — ставится только его пакет (Veriqa.Core.ChannelAdapter.Telegram и т.п.)
  • (опционально) токен демо-бота канала для реального входа через мессенджер

Шаги запуска

  1. Вставьте фрагмент подключения в Program.cs.
  2. dotnet run --project samples/dotnet/inproc/login — издатель, https://localhost:7300.
  3. Во втором терминале запустите клиентское приложение, в которое издатель выполняет вход: dotnet run --project samples/dotnet/inproc/login-client — https://localhost:7020.
  4. Откройте https://localhost:7020/. Вход начнётся сам: клиент отправит вас на страницу входа издателя, а после подтверждения в канале вернёт обратно и покажет Hello, {name}!.

У самого издателя страница / входа не начинает — она только отвечает Hello!.

О выбранной комбинации

login — обычный вход пользователя через доверенный канал. Режим inproc — OpenIddict-issuer встроен в процесс приложения, ключи эфемерны. Каналы: telegram, whatsapp, max, email — все 4 зарегистрированы; включаются по отдельности конфигурацией (Veriqa:Channels:<Канал>:Enabled). По умолчанию все выключены — dotnet run запускается без внешних токенов/SMTP; задайте учётные данные нужного канала для реального входа.

Письмо в один тап через IMAP

Секция Email в appsettings.json подготовлена под письмо в один тап: пользователь отправляет готовое письмо, а пример читает его из почтового ящика по IMAP — провайдер входящей почты и публичный адрес не нужны.

  1. Выделите ящик под Veriqa. Каждое свежее непрочитанное письмо его входящих будет помечено прочитанным, поэтому не используйте ящик, который читают люди.
  2. Включите для ящика доступ по IMAP и получите пароль приложения в настройках вашего почтового провайдера.
  3. Узнайте AuthservId: откройте исходник любого письма, полученного этим ящиком, и возьмите имя хоста, с которого начинается значение верхнего заголовка Authentication-Results, — то, что стоит до первой ;. Значение, которое начинается с результата (spf=pass …), идентификатора не содержит — с этим примером такой ящик не работает, как и ящик, у которого идентификатор различается от письма к письму.
  4. В Veriqa:Channels:Email:Inbound задайте InboundAddress — адрес ящика, а в Imap — Host (IMAP-сервер вашего провайдера), Username и AuthservId.
  5. Передайте пароль переменной окружения Veriqa__Channels__Email__Inbound__Imap__Password — в appsettings.json он не записывается.
  6. Поставьте Veriqa:Channels:Email:Enabled в true.
  7. Запустите пример и начните вход по «Шагам запуска», выберите Email и отправьте готовое письмо с другого ящика. Страница завершит вход через несколько секунд после того, как письмо пришло.

Ящик, который не принимает пароль (Microsoft 365, часть организаций Google Workspace), подключается по OAuth 2.0: см. «Вход в ящик по OAuth» в разделе Email руководства по настройке каналов в документации. OAuth меняет только способ входа в ящик: требование шага 3 к AuthservId остаётся, и ящик, заголовок которого идентификатора не содержит, не заработает и с OAuth. Сам пример остаётся на пароле приложения.

Реальный OIDC-вход: код и инструкция применяются к запуску, без заглушек.

Nova Stream — стриминг на телевизоре

Войдите с дивана, отсканировав QR-код на экране, и подтвердите покупку в мессенджере. Сделано для телевизора и пульта.

Открыть Nova Stream

Helio — поддержка клиентов

Войдите в раздел поддержки выдуманной компании без пароля и подтвердите закрытие или удаление обращения одним нажатием в мессенджере.

Открыть Helio