Face ID в WebView: как мы подключили нативную биометрию iOS к веб-кабинету без сторонних библиотек

Wait 5 sec.

Привет, Tproger! Меня зовут Дмитрий Никоноров, я iOS-разработчик в «Триаде». Мы разрабатываем сайты, порталы и мобильные приложения. В этой статье расскажу про задачу, которую делал для одного из наших клиентов: вход по Face ID в iOS-приложении, построенном на WebView.В нативном приложении биометрия делается штатно: вызываешь фреймворк LocalAuthentication, получаешь ответ системы и пускаешь пользователя. У нас же под тонкой нативной оболочкой работает сайт, а у веб-страницы доступа к Face ID нет.Ниже расскажу, как мы построили мост между нативной частью и WebView, покажу ключевые фрагменты кода на Swift и разберу пограничные случаи, на которых такой вход легко сломать. Спойлер: на бэкенде понадобился один новый эндпоинт, а веб-часть кабинета мы не меняли вообще.Контекст задачиЗаказчик — логистическая компания, которая помогает клиентам вести внешнеэкономическую деятельность — от закупки товаров на фабриках до поставки на склады маркетплейсов. У компании есть закрытая платформа для клиентов: публичный сайт служит витриной, а вся операционная работа — заявки, статусы, документы, финансовые операции — идёт в личном кабинете.Архитектурно кабинет связан с корпоративной информационной системой — глубоко переработанной 1С, где живут все клиентские данные. Апдейты происходят 24/7, и клиент всегда видит актуальную картину.Мобильное приложение доступно в App Store, Google Play, AppGallery и RuStore. Технически это не нативное приложение, специально разработанное для мобильных устройств, а WebView-обёртка.Что такое WebView и почему выбрали именно егоWebView — это, говоря просто, браузер, встроенный внутрь приложения. Вместо того чтобы рисовать каждый экран нативным кодом под iOS и Android отдельно, разработчики «заворачивают» веб-версию личного кабинета в тонкую нативную оболочку. Пользователь видит интерфейс как в приложении, но под капотом работает сайт.Для заказчика это осознанный выбор. У WebView-подхода три плюса:Скорость обновлений. Не нужно поддерживать полноценные кодовые базы для iOS и Android. Изменения на фронте автоматически появляются в приложении.Единый функционал. Всё, что есть на сайте, доступно и в мобильном приложении.Простота поддержки. Обновили веб-часть — обновилось и приложение. Нет нужды делать новые релизы в сторах.Нативная оболочка при этом минимальна: один экран с WKWebView, который отвечает за пуш-уведомления, диплинки (внешние ссылки сразу на нужный экран), лоадеры и алерты об отсутствии сети. И за Face ID, о котором пойдёт речь.Но у WebView есть ограничения. Биометрическая авторизация — одно из них.Зачем понадобился Face IDКлиенты заходят в кабинет по нескольку раз в день: проверить статус заявки, скачать документы, посмотреть финансовые операции. Вводить каждый раз логин и пароль на телефоне неудобно, а вход по лицу или отпечатку пальца владельцы айфонов ждут от любого приложения с личным кабинетом. Для B2B-платформы, которая конкурирует за внимание клиентов, это ещё и вопрос имиджа.До внедрения вход в приложение выглядел традиционно: логин, пароль, кнопка «Войти». Никакой биометрии, просто пара «кредов».Задача звучала так: добавить Face ID в существующее WebView-приложение, не ломая текущую архитектуру и не утяжеляя проект сторонними зависимостями.Нельзя просто взять и…Вообще интеграция механизма Face ID — сравнительно тривиальная задача. Вызвал системное окошко, получил подтверждение, залогинился. В нативном приложении так примерно и работает. Но WebView — не нативное приложение.Проблема в том, что WebView по сути браузер. У веб-страницы внутри WKWebView нет API, через который она могла бы попросить iOS проверить лицо и получить ответ. Ближе всего к этому стандарт WebAuthn, но он требует перестроить авторизацию на бэкенде под ключи доступа, а задача была как раз в том, чтобы существующую авторизацию не трогать.Есть несколько вариантов сделать Face ID на WebView:Подключить стороннюю библиотеку, которая работает мостом между веб-частью и системной биометрией. Мы от этого отказались. Любая сторонняя зависимость — риск: обновления, уязвимости, проблемы совместимости, сложность поддержки.Перейти на полноценное нативное приложение. Не вариант — это означало бы переписать всё с нуля, отказаться от преимуществ WebView, кратно увеличить бюджет и срок.Сделать собственный «мостик» между нативной оболочкой и WebView. Именно этот путь мы и выбрали.Как это работает под капотомРазберём процесс от запуска приложения до успешного входа.Шаг 1. Запуск приложения и проверка биометрииКогда приложение запускается, внутренний сервис в нативной части проверяет три вещи:Может ли устройство проверить владельца: биометрией или код-паролем?Включил ли пользователь вход по биометрии?Есть ли сохранённые логин и пароль с прошлого входа?Если хотя бы одно условие не выполнено, показываем обычный экран с логином и паролем.Первую проверку делает LAContext из фреймворка LocalAuthentication. Затем приложение проверяет флаг согласия и наличие сохранённых учётных данных. Упрощённо это выглядит так:Важный нюанс: приложение не выбирает между Face ID и Touch ID. Это решает iOS: мы отправляем один запрос, а система сама определяет, что доступно на конкретной модели iPhone. Если биометрия не настроена, система попросит код-пароль устройства. Так работает политика .deviceOwnerAuthentication. Если нужна строго биометрия, без запасного варианта с кодом, используют .deviceOwnerAuthenticationWithBiometrics.Шаг 2. Первый входПользователь вводит логин и пароль. Если они корректны, он попадает в личный кабинет. Сразу после первого успешного входа приложение предлагает включить биометрию: показывает системный экран Face ID.При самом первом обращении iOS сначала спросит разрешение на использование Face ID, а текст пояснения берётся из ключа NSFaceIDUsageDescription в Info.plist. Без этого ключа Face ID в приложении не заработает. Если проверка прошла, мы запоминаем это как согласие пользователя на вход по биометрии. Если нет, при следующем входе по паролю предложим ещё раз.Шаг 3. Сохранение данныхПосле успешного входа логин и пароль сохраняются локально на устройстве в хранилище UserDefaults — независимо от результата запроса Face ID. Согласие влияет только на то, будут ли эти данные затем использоваться для биометрического входа.Пароль лежит в UserDefaults без дополнительного шифрования: на этапе проектирования мы с заказчиком выбрали более простое решение ради сроков. Хранить креды в Keychain и очищать их по флагу в UserDefaults при первом запуске после установки здесь тоже подошло бы и дало бы более надёжную защиту. Это следующий логичный шаг, как и хранение токена вместо пароля.Никакие биометрические данные — слепок лица, отпечаток пальца — не сохраняются и не передаются в приложение. Это принципиальный момент, лицо живёт только на iPhone и больше нигде. Приложение не знает пользователя в лицо, оно лишь знает, что этот пользователь разрешил вход по биометрии.Шаг 4. Повторный входТеперь самое интересное. Пользователь снова открывает приложение. Сервис видит: устройство может проверить владельца, вход по биометрии включён, учётные данные сохранены. Как только WebView загружает страницу авторизации, проверка запускается автоматически — пользователю не нужно ничего нажимать.Что происходит дальше:Нативная часть отправляет запрос к системе: «Проверь биометрию».Система запускает проверку. Вся проверка — на стороне операционной системы. Приложение не видит ни изображение, ни данные сканирования.Система возвращает результат: успех или неудача.Если успех, нативная часть достаёт из локального хранилища сохранённые логин и пароль.Отправляет их на специальный эндпоинт вместе с cookie сессии, которую сайт уже выдал этому WebView.Бэкенд проверяет креды и помечает эту сессию авторизованной. WebView перезагружается с той же cookie.Пользователь видит личный кабинет. Успех!Проверку запускает делегат навигации WKWebView: как только загрузилась страница авторизации, нативная часть сама вызывает биометрию.Сама проверка идёт через LAContext. Колбэк evaluatePolicy приходит не на главном потоке, поэтому всё, что трогает интерфейс, возвращаем на main:Отдельно передавать сессию в WebView не нужно: она у него уже есть. Как только страница авторизации открывается, WebView получает cookie сессии (в нашем случае PHPSESSID). Нативная часть читает её из хранилища cookie и отправляет на бэкенд вместе с сохранёнными логином и паролем. Бэкенд проверяет креды и помечает эту сессию авторизованной. Нам остаётся перезагрузить страницу: тот же WebView с той же cookie теперь получает уже авторизованный кабинет.Ключевое отличие от классического Face IDВ нативном приложении биометрия работает так: система проверяет лицо или отпечаток локально на устройстве и возвращает приложению результат проверки — «совпало» или «не совпало». Приложение использует этот результат для авторизации пользователя. Никакие данные биометрии не покидают устройство и не передаются на сервер.В нашей WebView-схеме результат проверки тот же — флаг успеха или неудачи. Но дальше механика отличается. В нативном приложении флаг «совпало» сам по себе является основанием для авторизации. В нашем случае этот флаг лишь открывает доступ к сохранённым кредам: приложение достаёт логин и пароль из локального хранилища и отправляет их на бэкенд. Авторизация всё ещё идёт по кредам — как если бы пользователь ввёл их руками.В WebView-схеме Face ID — что-то вроде замка на шкатулке. Он не авторизует пользователя в системе, он подтверждает, что человек имеет право достать сохранённые логин и пароль из локального хранилища устройства.Такое архитектурное решение не требует изменений в существующей системе авторизации бэкенда и не передаёт биометрические данные за пределы устройства.Что мы сделалиНа мобильной части (нативной оболочке):Сервис запросов к биометрии. Логика обращения к системному API Apple, обработка ответов.Логика отказов на любом этапе. Пользователь нажал «Отмена», лицо не распозналось, биометрия заблокирована после нескольких попыток — для каждого сценария предусмотрен запасной путь: сообщение об ошибке и переход на экран ручного ввода. Приложение не должно зависнуть или сброситься ни на одном из этапов.Работа с UserDefaults. Сохранение и извлечение кредов.Флаг разрешения. Приложение помнит, что пользователь включил биометрию, и не запрашивает согласие повторно.Все ветки отказа сходятся в одном месте. Для приложения неважно, что именно пошло не так: пользователь отменил проверку, лицо не распозналось или биометрия заблокирована. Повторные попытки и запрос код-пароля берёт на себя iOS, а мы получаем только итог. Если итог отрицательный, показываем сообщение об ошибке, а после его закрытия переводим пользователя на обычную форму входа. Упрощённо:На бэкенде:Один новый эндпоинт. По сути, «ручка», которую мобильная часть дёргает после успешной проверки владельца устройства. Она получает сохранённые логин и пароль вместе с PHPSESSID, проверяет креды и помечает существующую сессию авторизованной. Изменение минимальное, чтобы не трогать существующую архитектуру авторизации.На веб-части (фронтенде):Ничего. WebView перезагружается с уже авторизованной сессией — для веб-части это выглядит так же, как обычный вход по логину и паролю.Самой трудоёмкой оказалась именно мобильная часть, так как необходимо было корректно обработать все промежуточные состояния и сценарии отказов, чтобы пользователь ни при каком раскладе не завис между экранами.Корнер-кейсы. Что может пойти не такВ разработке так называемого happy path — сценария, где всё работает идеально — обычно мало интересного. Проблемы могут возникнуть в неочевидных юзкейсах. Вот что мы предусмотрели:1. Пользователь удалил Face ID с устройстваДопустим, человек заходил по лицу, а потом сбросил биометрию в настройках iPhone. Приложение помнит, что Face ID был разрешён, и при запуске отправляет запрос к системе. Система не находит зарегистрированное лицо и вместо Face ID показывает запрос на код-пароль iPhone. Пользователь вводит код-пароль, авторизация проходит. Успех!2. Пользователь нажал «Отмена»Системное окошко биометрии появилось, но человек передумал. В этом случае приложение сообщает об ошибке, а после закрытия сообщения показывает стандартный экран логина и пароля. Сессия не прерывается.3. Биометрия не распозналасьСистема не уверена в биометрических данных — помешали освещение, очки, маска, неудачный угол. iOS сама предложит повторить проверку или перейти к код-паролю. Приложение получает итоговый результат: при успехе продолжает вход, при неудаче показывает сообщение об ошибке, а после его закрытия — обычную форму входа.4. Переустановка приложенияЕсли пользователь удалил приложение и поставил заново, сохранённые в UserDefaults учётные данные и флаг включённой биометрии не подтягиваются. Всё с нуля: установка → логин/пароль → предложение включить Face ID → только после успешной проверки — биометрический вход.5. Биометрия заблокированаПосле нескольких неудачных попыток iOS временно блокирует биометрию. Дальше iOS сама предлагает ввести код-пароль, а если пользователь отменит и его, приложение сообщит об ошибке и покажет обычную форму входа.Что получил пользовательДо внедрения:Вход → вспомнить/ввести логин → вспомнить/ввести пароль → войти.После внедрения:Открыть приложение → посмотреть на экран → войти.Для B2B-клиента, который заходит в личный кабинет несколько раз в день, это ощутимая перемена.Презентация фичи прошла успешно, заказчик остался доволен. Мы внедряли Face ID параллельно с другими доработками, и весь релиз прошёл без остановки работы сервиса.Если вы встраивали биометрию в WebView иначе, например через WebAuthn или с токеном вместо пароля в хранилище, расскажите в комментариях: интересно сравнить подходы.