Перейти к основному содержимому
Veriqa
Документация Живое демо

Встроенные каналы

Каналы, которые поставляются с Veriqa: мессенджеры, почта и вход через аккаунт провайдера.

Базовые claims есть у каждого канала: channel_type channel_user_id name

В карточке канала — что он добавляет сверх базовых.

— номер телефона: приходит, только если приложение его запросило, и каждый канал возвращает его по-своему. Подробнее о номере телефона

Встроенные каналы

Доступно

Поставляются вместе с Veriqa. В Docker-образе и в сервисе для ОС уже есть все — нужные вы просто включаете в конфигурации. Если Veriqa встроена в .NET-приложение, каждый канал — отдельный пакет: устанавливаете только нужные. Восемь каналов — Telegram, WhatsApp, MAX, Instagram Direct*, Messenger*, WeChat, Viber и почта.

Вход через аккаунт провайдера

Доступно

Вход через аккаунт Google, Apple, Huawei, Яндекс или VK ID — или любого другого из 80+ провайдеров клиента OpenIddict. Экран показывает QR-код, пользователь входит в свой аккаунт на собственном телефоне и подтверждает вход на странице там же — и вход завершается на экране. Это выручает там, где пароль не набрать или набирать рискованно, — на телевизоре, на общем компьютере, — а войти может и пользователь, у которого нет ни одного из мессенджеров. Даже на личном компьютере вход через соцлогин по QR-коду безопаснее: пароль от учётной записи на компьютере не вводится, и зловреду нечего перехватить. А раз вводить пароль каждый раз не нужно, сессию можно делать короче — это тоже снижает риски.

Полный список провайдеров можно посмотреть на этой странице.

Термины

В карточках каналов указано, нужно ли секретное сообщение, есть ли подтверждение в канале и как приходит номер телефона. Вот что это значит.

Секретное сообщение

Сообщение с кодом входа, которое пользователь сам отправляет в канал после перехода по ссылке или сканирования QR-кода. Veriqa заполняет его, мессенджер показывает готовым, пользователю остаётся нажать «Отправить». Нужно не каждому каналу.

Telegram, MAX
Не нужно — мессенджер сам открывает бота и передаёт ему код.
WhatsApp
Нужно для большей безопасности — готовое сообщение уходит одним касанием.
Почта
То же с заполненным письмом — письмо в одно касание.
Видео пример Какой режим почты выбрать

Подтверждение в канале

Бот спрашивает прямо в чате, пропустить ли вход — в какое приложение и с какого устройства, — с кнопками «Подтвердить» и «Отклонить». Можно включить автоматический режим, тогда вход проходит без дополнительного запроса.

MAX, Telegram
Вопрос приходит сразу, как только пользователь открыл ссылку.
WhatsApp
Вопрос приходит в ответ на секретное сообщение.
Почта
В канале вопроса нет — по желанию он задаётся на странице в браузере.
Видео пример Подробнее в документации

Номер телефона

Veriqa берёт номер только из канала — его передаёт мессенджер, пользователь ничего не вводит. Номер приходит, когда приложение запрашивает scope phone, и каждый канал возвращает его по-своему; phone_number_verified показывает, подтверждает ли канал, что номер принадлежит пользователю.

WhatsApp
Проще всего: номер приходит с каждым сообщением, ничего не спрашивается.
Telegram, MAX
Бот спрашивает после подтверждения входа: пользователь делится своим контактом одной кнопкой. В MAX — только в режиме webhook.
Остальные
Кнопка или профиль без подтверждения владельца, только ваша собственная интеграция с платформой или номера нет вовсе.
Как номер возвращает каждый канал

Секретное сообщение — примеры

WhatsApp: секретное сообщение заполнено Veriqa и готово к отправке
WhatsApp
Email: письмо для входа заполнено Veriqa и готово к отправке
Почта

Подтверждение в канале — примеры

Telegram: бот просит подтвердить вход, кнопки «Подтвердить» и «Отклонить»
Telegram
WhatsApp: пользователь отправил секретное сообщение, бот просит подтвердить вход
WhatsApp