Вход по почте кажется самым простым из всех. Ваш сайт отправляет письмо с кодом или ссылкой, пользователь открывает почту и входит. Пароль не нужен, SMS-код не нужен, почта есть у всех. Даже у Дед Мороза и Санта-Клауса есть почта, так что и они смогут войти на ваш сайт по почте. Но простота обманчива… На деле у этой простой схемы есть три слабых места.
Письмо может не дойти или прийти через десять минут, и причины могут быть разными: спам, greylisting, репутация вашего домена.
Корпоративный почтовый сканер на вирусы открывает ссылку раньше человека и расходует ее.
И главное: переход по ссылке или ввод кода доказывает только то, что письмо до кого-то дошло, но не то, что ящик в руках вашего пользователя.
Есть третий способ, в котором эти слабые места отсутствуют и о котором пишут редко: письмо отправляет не сайт, а пользователь. Как это часто бывает, он сложнее, НО так ли это? Давайте рассмотрим, как он устроен по шагам:
Пользователь пишет письмо на определенный адрес и указывает в письме секретный токен длиной не менее 43 символа, который система выдала для входа. Почему именно 43 подробно разобрано в RFC 7636.
Система сверяет токен с выданными, которые ещё не погашены и не истекли.
Если токен совпал, значит, письмо отправил тот, кто этот токен знает.
Система проверяет, что письмо правда пришло из ящика, указанного в
From, используя SPF, DKIM и DMARC. И если успех, то тогда адрес отправителя и берем как подтвержденный.
Если реализовать эту схему в лоб, то вашему пользователю придется переписывать адрес или токен руками, а значит удар по карме и душевная боль вашей поддержки обеспечены :)
Хорошая новость в том, что это только выглядит сложно, но со смартфоном и QR-кодом этот способ даже проще кода и ссылки.
Посмотрите, как это выглядит с QR-кодом.

Пользователь сканирует QR-код телефоном, почтовое приложение открывает уже готовое письмо, он нажимает «Отправить» и подтверждает вход в окне входа. Это похоже на magic link, но направление обратное. Доставлять вашему сайту нечего, а ссылку в письме некому израсходовать. 4 действия, ни одного введённого символа и всего 13 секунд против 30 у ссылки и 34 у кода. Для сравнения по нажатиям: у magic link — 6 нажатий и ввод адреса, а у кода — 5 нажатий и ввод адреса, и ввод шести цифр. Убедиться и сравнить все три способа в одном месте можно самому на демо Helio.
Буду очень признателен, если в конце статьи вы проголосуете или выскажете мнение об этом способе. опрос
Далее в статье
Где ломаются код и ссылка и как устроено письмо от пользователя.
Сравню три способа входа по почте в одной таблице: что нужно сайту, сложность для пользователя и слабые места каждого способа.
Разберу, почему полю
Fromнельзя верить и как сайту понять, что письмо правда пришло из ящика пользователя.Представлю один из путей, как получить все три способа без своей реализации, через Open-source IdP Veriqa, который подключается к сайту на любом стеке, как обычный провайдер OpenID Connect, часто обычной настройкой.
Это продолжение цикла статей о использовании QR-кода в аутентификации. Предыдущая о входе по QR-коду через Яндекс ID, Google, Apple. Здесь та же механика входа по QR-коду, только через почту.
Где ломаются код и ссылка
Общих проблем у кода и ссылки две:
Вход зависит от того, дойдёт ли ваше письмо. Письмо уходит в спам, задерживается на greylisting, теряется из-за репутации домена. Почтовые сервисы при этом ужесточают требования к отправителям: Gmail с 2024 года требует SPF или DKIM от всех, а от массовых отправителей ещё и DMARC. Письма Gmail считает по всему домену сразу: если сайт шлёт с него и рассылку, вы можете стать массовым отправителем, и требования к массовым лягут и на письма входа. Требование SPF или DKIM не лишнее: это защита и гигиена. Но никто не гарантирует, что ваш домен не попадёт в чёрный список. Я несколько раз видел, как домены совершенно обычной контейнерной компании, где я работал, попадали в спам-листы, и вытаскивать их оттуда — отдельная работа.
Код или ссылка доказывают только доставку, а не владение ящиком. Письмо могло уйти по правилу пересылки или лежать в общем ящике отдела. Я знаю многих людей, которые таким образом делятся подпиской на сервисы, просто пересылая коды, которые им приходят на почту.

Есть и отдельные проблемы:
Код. Пользователь переключается в почту, ищет письмо, возвращается и вводит шесть цифр, если писем несколько они могут сложится в цепочку где легко ошибиться. Код легко выманить. «Продиктуйте, пожалуйста, код из письма» — классика телефонного мошенничества. Зато в письме нет ссылки, и почтовому шлюзу-антивирусу нечего открыть. Как сделать само поле кода удобным, хорошо разобрали на Хабре в ЮMoney: «Как мы проектировали идеальный пользовательский опыт для OTP-поля».
Магическая ссылка. Корпоративные почтовые шлюзы-антивирусы и почтовые клиенты открывают ссылки из писем, чтобы проверить их на фишинг. После такой проверки одноразовая ссылка уже израсходована, и пользователю приходит недействительная ссылка. На это жалуются, например, пользователи Auth0. Ещё ссылка открывается не в том браузере: вход начат на компьютере, а письмо пользователь читает на телефоне. Вы сами можете этого не замечать, ведь magic link от крупных компаний вам стабильно доходят. Но у крупной компании годами наработана репутация домена, и с доставкой у неё меньше проблем. Для маленькой компании всё может быть не так радужно.
Эти проблемы и решает третий способ.
Письмо от пользователя или письмо в один тап
На компьютере окно входа показывает QR-код. Пользователь сканирует его телефоном, и почтовое приложение открывается с уже готовым письмом: адресат, тема и текст заполнены. Он нажимает только «Отправить» — это и есть один тап в названии способа. Окно входа на компьютере пишет «Отправитель подтвержден» и спрашивает, подтвердить ли вход: в какое приложение, когда, из какого браузера и системы. Пользователь нажимает «Да» — и он на сайте. Если вход начат на телефоне, то вместо QR-кода будет кнопка: она открывает такое же письмо.

Почему это работает?
QR-код несёт ссылку
mailto:. По стандарту RFC 6068 в такую ссылку можно вписать не только адресата, но и тему, и текст письма, поэтому это работает везде, где стандарт поддержан.Чтобы сайт понял, к какому входу относится письмо, в него вписан токен — в адресе получателя или в теме или в теле письма.
На телефоне почтовое приложение обычно есть сразу: в Android — Gmail, в iOS — «Почта» (с iOS 14 можно выбрать другое приложение). На компьютере всё зависит от того, подключил ли пользователь ящик в почтовой программе, поэтому основной сценарий — QR-код на компьютере и письмо с телефона.
Я проверил это на Android, MacBook, iPad, iPhone и компьютере с Outlook. Письма отправлял с ящиков Gmail, Яндекса, Outlook.com, Reg.ru и iCloud. Вход прошёл везде успешно.

Токен для входа можно передавать в письме разными способами:
| Кому уходит письмо | Где токен |
|---|---|---|
|
| в адресе, теме и тексте |
|
| только в адресе, и QR-код меньше |
Тема письма — Sign in to {app}: {token}. Текст задаётся шаблоном, и формулировки в нём могут быть любыми: токен ищется по его форме, а не по словам вокруг. Отдельно о емкости QR-кода: чем длиннее текст письма, тем плотнее QR-код, и слишком длинный текст в него не влезет. В QR-код вмещается до 2 953 байт, а кириллица в mailto: занимает 6 символов на букву (%D0%BF), поэтому длинных предисловий в таких письмах лучше не ставить.
Сравнение трёх способов
Для вашего удобства я сравнил все три способа и свел это в одну небольшую таблицу.
Таблица сравнения
Код из письма | Ссылка из письма (magic link) | Письмо в один тап | |
|---|---|---|---|
Что нужно сайту | исходящая почта | исходящая почта | входящая почта: вебхук или IMAP-ящик. Исходящая не нужна |
Зависит от доставки вашего письма | да: спам, задержка, репутация домена | да: спам, задержка, репутация домена | нет: доставлять нечего |
Может ли шлюз израсходовать | нет: в письме нет ссылки | обычная одноразовая ссылка — да | нет: в письме, которое отправляет пользователь, ссылок нет |
Что доказывает | доступ к письму, в том числе пересланному | что письмо до кого-то дошло | что отправитель управляет ящиком: DMARC проходит |
Что делает пользователь | вводит адрес, ждёт письмо, вводит 6 цифр | вводит адрес, ждёт письмо, открывает ссылку | сканирует QR-код, нажимает «Отправить» |
Время до входа (замер) | 34 сек. | 30 сек. | 13 сек. |
Вход с другого устройства | прочитать код на телефоне, ввести на компьютере | ссылка открывается на телефоне, «Да» — в окне входа на компьютере | QR-код на компьютере, письмо с телефона, «Да» в окне входа |
Слабое место | переключиться в почту и ввести 6 цифр руками | шлюз может открыть ссылку раньше человека; ссылка открывается не в том браузере | нужна почта с этим ящиком на телефоне; не у всех доменов проходит DMARC |
Если выманивают | «продиктуйте код» | «перешлите письмо» | «отсканируйте QR-код» — QR-фишинг |
Если ящик взломан | входит атакующий | входит атакующий | входит атакующий |

Как замеряли время
Время мерилось на секундомере от нажатия «Войти» до входа на сайт, на демо Helio, один и тот же человек и телефон, 8 попыток, медиана. У кода и ссылки в замер входит доставка письма, а также ввод адреса 9символов@gmail.com без автоподстановки. Письмо в один тап, тут был разброс. На iCloud с выключенной задержкой отмены отправки 13 сек, Яндекс — 12 сек, на Gmail 24 сек.
Почему полю From нельзя верить
Письмо в один тап держится на точном ответе на вопрос: правда ли письмо пришло из ящика, который указан в From? Поле From отправитель заполняет как хочет. Поэтому нужна проверка, которую делает не он. Это SPF, DKIM и DMARC. Коротко расскажу про каждый термин:
SPF — домен публикует список серверов, которым можно отправлять письма от его имени. Сервер, который принимает письмо, проверяет домен из конверта письма (
MAIL FROM), а не видимыйFrom.DKIM — сервер отправителя подписывает письмо ключом домена, а ключ для проверки подписи лежит в DNS. Принимающий сервер берёт ключ из DNS и проверяет подпись.
DMARC — связывает обе проверки с видимым
From: проверка проходит, если домен изFromсовпадает с доменом, который прошёл SPF или DKIM. Именно это закрывает подменуFrom.
Все три проверки делает сервер, который принимает письмо, он ваш или вашего почтового провайдера, а не отправителя. Подменить их результат отправитель не может. Результаты проверки почтовый сервер записывает в заголовок Authentication-Results. Первым в нём идёт имя сервера, который проверял, — authserv-id. Но тут есть нюанс. Отправитель может вписать в письмо и свой заголовок Authentication-Results, с pass во всех проверках. Однако сервер получателя ставит свой заголовок поверх всех пришедших. Поэтому верить можно только верхнему заголовку, в котором стоит имя принимающего сервера. Это правило из RFC 8601, раздел 5, и так делает open-source IdP Veriqa.

Настоящий и поддельный заголовок
Пользователь alice@gmail.com отправляет письмо входа на ящик в Google Workspace. Верхний заголовок письма в этом ящике:
Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=Kx3vQ9aZ; spf=pass (google.com: domain of alice@gmail.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=alice@gmail.com; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com
Теперь письмо отправил кто-то другой, со своего сервера, с From: alice@gmail.com, и вписал в него «готовый» результат проверки. Сервер ящика добавил свой заголовок сверху:
Authentication-Results: mx.google.com; spf=fail (google.com: domain of alice@gmail.com does not designate 203.0.113.7 as permitted sender) smtp.mailfrom=alice@gmail.com; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Authentication-Results: mx.google.com; spf=pass smtp.mailfrom=alice@gmail.com; dkim=pass header.i=@gmail.com; dmarc=pass header.from=gmail.com
Верхний заголовок настоящий, нижний вписал отправитель. Veriqa читает верхний: dmarc=fail, вход не завершается. Значения подписи и IP-адреса здесь для примера.
Важен результат проверки, а не политика домена отправителя. У gmail.com политика DMARC p=none, но это не значит, что подделка пройдёт. Проверка всё равно вернёт dmarc=fail, и вход не завершится. По умолчанию Veriqa требует dmarc=pass. Есть и политики слабее — для закрытых сред, где это оправдано.
Политики проверки отправителя в Veriqa
| Что проверяет |
|---|---|
| по умолчанию: DMARC прошёл, домен |
| слабее: прошёл SPF или DKIM, совпадение с |
| только домены из |
Как принимать письма: вебхук или IMAP
Письмо пользователя нужно как-то получить. Способа два: провайдер входящей почты присылает его на вебхук или приложение само читает обычный ящик по IMAP. Мы в Veriqa реализовали оба способа.
IMAP проще всего для старта: нужны только ящик и пароль приложения. Публичный адрес сервера и провайдер входящей почты не нужны. Ящик лучше завести отдельный и помечать обработанные письма прочитанными. Для вебхука лучше задать свой формат JSON. Зачем? Провайдеры входящей почты разные — Mailgun, Postmark, SendGrid и у каждого свой формат. Чтобы не писать вебхук под каждого, делаем один формат и небольшой пересыльщик, который переложит в него письмо от любого провайдера. Если убрать код и ссылку из сценариев и оставить только письмо в один тап, то SMTP-сервер вам не нужен, так как письмо в один тап обходится без исходящей почты.
Как оба способа устроены в open-source IdP Veriqa:
Вебхук | IMAP | |
|---|---|---|
Как письмо попадает в Veriqa | провайдер входящей почты или пересыльщик шлёт | Veriqa сама забирает непрочитанные письма из ящика |
Что нужно | публичный адрес Veriqa, провайдер входящей почты, секрет | ящик, пароль приложения или OAuth2 |
Задержка | Без задержек | до 10 секунд по умолчанию ( |
Откуда результат проверки | поля | верхний |
Чего не любит | провайдера без своего формата в Veriqa | ящик без |
Настройка: IMAP-ящик, только письмо в один тап
{ "Veriqa": { "Channels": { "Email": { "Enabled": true, "InboundVerification": "outbound_fetch", "PublicBaseUrl": "https://auth.your-domain.com", "PullEnabled": false, "PushEnabled": true, "PreferredMode": "Push", "Inbound": { "Provider": "ImapPolling", "InboundAddress": "login@your-domain.com", "UsePlusAddressing": true, "VerificationPolicy": "DmarcAlignedPass", "Imap": { "Host": "imap.your-provider.com", "Port": 993, "Username": "login@your-domain.com", "AuthMode": "Password", "Password": "…", "Folder": "INBOX", "PollIntervalSeconds": 10, "AuthservId": "mx.your-provider.com" } } } } } }
Пароль храните в секретах, а не в appsettings.json. AuthservId — имя из начала заголовка Authentication-Results в любом письме этого ящика. Настройка с вебхуком — в документации.
Две грабли, на которые мы наступили сами.
При прогоне тестов мы неожиданно столкнулись со следующими проблемами, которые решили.
Ящик без вердикта DMARC. Мы подключили ящик у хостинг-провайдера (это был Reg.ru), и вход не проходил. Его сервер не писал в Authentication-Results вердикт DMARC, и письмо не проходило проверку отправителя. Поэтому для таких ящиков мы добавили политику AllowListOnly со списком AllowedDomains. В этой политике Veriqa сверяет только домен в From, а отсеивать подделку остаётся почтовому серверу ящика. Это годится для закрытого круга доменов, но не для публичного входа.
Пересыльщик перед вебхуком. В режиме вебхука Veriqa верит полям spf, dkim и dmarc из JSON. Значит, вся проверка отправителя держится на пересыльщике. Наш первый пересыльщик на Cloudflare брал вердикт из любого заголовка Authentication-Results в письме и на проверке пропустил поддельные заголовки из раздела выше. Чтобы это исправить, мы применили такое же правило, что и для IMAP, стали брать только верхний заголовок, который поставил сервер. У Cloudflare это mx.cloudflare.net.
Атаки и ограничения
Взлом ящика одинаково опасен для всех трёх способов: кто владеет ящиком, тот и входит.
Подделку From закрывает проверка отправителя из раздела выше.
QR-фишинг. О нём я подробно писал в прошлой статье. У письма в один тап здесь своя слабость, и скажу о ней прямо. Вопрос «Да/Нет» задаёт окно входа, где вход начат. Если злоумышленник подсунул пользователю свой QR-код, а тот отправил письмо, вопрос увидит злоумышленник. Пользователю остаётся одно: тема и текст письма называют приложение, в которое он входит, и по ним можно заметить подмену. У кода и ссылки слабость того же рода: «продиктуйте код» и «перешлите письмо». Сканер почты письму в один тап не страшен: в письме, которое отправляет пользователь, нет ссылок.
Когда этот способ не подходит:
На телефоне пользователя нет почтового приложения с этим ящиком.
У почтового домена пользователя нет DMARC, или его письмо не проходит DMARC — например, из-за пересылки или своих релеев.
Письма принимает ящик Microsoft 365 через IMAP: его заголовок без
authserv-idне отличить от поддельного, нужен вебхук.
Что даёт Veriqa и как совмещать способы
Open-source Veriqa умеет все три способа, и код со ссылкой в ней сделаны с учётом проблем из начала статьи:
Открытие ссылки ничего не расходует: страница предлагает «Продолжить вход», и вход продвигает только эта кнопка.
Вопрос «Да/Нет» задаёт окно входа, где вход начат, а не страница ссылки, поэтому сканер почты до него не доходит.
Код из шести цифр, на него 5 попыток, новое письмо гасит прежний код.
В одном письме может быть ссылка, код или оба, засчитывается то, что сделано первым.
У каждого приложения свои тема и текст письма, а письмо приходит на языке пользователя.
Главное
Вашему сайту ничего из этого писать не нужно, он получает подтверждённый адрес почты по OpenID Connect, как от любого провайдера. А подключать и использовать open-source IdP Veriqa можно на любом стеке. Если у вас уже есть IAM, например Keycloak или Logto, Veriqa добавляется в него внешним провайдером — настройкой, без кода. Подробнее Документация
Все три способа можно включить на одной странице входа. Настройка PreferredMode решает, что предложить первым, а поле адреса под QR-кодом остаётся запасным путём. Если среди ваших пользователей много корпоративных, у которых шлюзы проверяют ссылки, выручит код.
Настройка: все три способа, первым — письмо в один тап
Без JavaScript поле кода на странице не появится, поэтому для них лучше «ссылка + код» в одном письме.
{ "Veriqa": { "Channels": { "Email": { "PreferredMode": "Push", "PullEnabled": true, "PushEnabled": true, "PullMethods": ["MagicLink", "Code"] } } } }
Попробовать
Все три способа включены в демо Helio — это поддержка вымышленной компании. Код и ссылку можно посмотреть ещё и в конструкторе демо.
Veriqa — open-source IdP на OpenID Connect (MPL-2.0) для любого стека. Подробности о почте — в документации.
При написании статьи я опирался на исследования, а также свой опыт работы, в котором были случаи с проблемами прихода ссылок или кодов от наших почтовых серверов. А сталкивались ли вы с таким и считаете ли интересным письмо в один тап?
