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

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

Привет, 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-подхода три плюса:

  1. Скорость обновлений. Не нужно поддерживать полноценные кодовые базы для iOS и Android. Изменения на фронте автоматически появляются в приложении.
  2. Единый функционал. Всё, что есть на сайте, доступно и в мобильном приложении.
  3. Простота поддержки. Обновили веб-часть — обновилось и приложение. Нет нужды делать новые релизы в сторах.

Нативная оболочка при этом минимальна: один экран с WKWebView, который отвечает за пуш-уведомления, диплинки (внешние ссылки сразу на нужный экран), лоадеры и алерты об отсутствии сети. И за Face ID, о котором пойдёт речь.

Но у WebView есть ограничения. Биометрическая авторизация — одно из них.

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

Зачем понадобился Face ID

Клиенты заходят в кабинет по нескольку раз в день: проверить статус заявки, скачать документы, посмотреть финансовые операции. Вводить каждый раз логин и пароль на телефоне неудобно, а вход по лицу или отпечатку пальца владельцы айфонов ждут от любого приложения с личным кабинетом. Для B2B-платформы, которая конкурирует за внимание клиентов, это ещё и вопрос имиджа.

До внедрения вход в приложение выглядел традиционно: логин, пароль, кнопка «Войти». Никакой биометрии, просто пара «кредов».

Задача звучала так: добавить Face ID в существующее WebView-приложение, не ломая текущую архитектуру и не утяжеляя проект сторонними зависимостями.

Нельзя просто взять и…

Вообще интеграция механизма Face ID — сравнительно тривиальная задача. Вызвал системное окошко, получил подтверждение, залогинился. В нативном приложении так примерно и работает. Но WebView — не нативное приложение.

Проблема в том, что WebView по сути браузер. У веб-страницы внутри WKWebView нет API, через который она могла бы попросить iOS проверить лицо и получить ответ. Ближе всего к этому стандарт WebAuthn, но он требует перестроить авторизацию на бэкенде под ключи доступа, а задача была как раз в том, чтобы существующую авторизацию не трогать.

Есть несколько вариантов сделать Face ID на WebView:

  1. Подключить стороннюю библиотеку, которая работает мостом между веб-частью и системной биометрией. Мы от этого отказались. Любая сторонняя зависимость — риск: обновления, уязвимости, проблемы совместимости, сложность поддержки.
  2. Перейти на полноценное нативное приложение. Не вариант — это означало бы переписать всё с нуля, отказаться от преимуществ WebView, кратно увеличить бюджет и срок.
  3. Сделать собственный «мостик» между нативной оболочкой и WebView. Именно этот путь мы и выбрали.

Как это работает под капотом

Разберём процесс от запуска приложения до успешного входа.

Шаг 1. Запуск приложения и проверка биометрии

Когда приложение запускается, внутренний сервис в нативной части проверяет три вещи:

  1. Может ли устройство проверить владельца: биометрией или код-паролем?
  2. Включил ли пользователь вход по биометрии?
  3. Есть ли сохранённые логин и пароль с прошлого входа?

Если хотя бы одно условие не выполнено, показываем обычный экран с логином и паролем.

Первую проверку делает LAContext из фреймворка LocalAuthentication. Затем приложение проверяет флаг согласия и наличие сохранённых учётных данных. Упрощённо это выглядит так:

			import LocalAuthentication

private enum StorageKey {
    static let biometryEnabled = "biometryEnabled"
    static let savedLogin = "savedLogin"
}

func shouldStartBiometricLogin() -> Bool {
    let context = LAContext()
    var error: NSError?
    // 1. Может ли устройство проверить владельца: биометрией или код-паролем
    let canAuthenticate = context.canEvaluatePolicy(.deviceOwnerAuthentication, error: &error)
    // 2. Согласился ли пользователь на вход по Face ID
    let userAgreed = UserDefaults.standard.bool(forKey: StorageKey.biometryEnabled)
    // 3. Есть ли сохранённые креды с прошлого входа
    let hasCredentials = UserDefaults.standard.string(forKey: StorageKey.savedLogin) != nil
    return canAuthenticate && userAgreed && hasCredentials
}
		

Важный нюанс: приложение не выбирает между 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 загружает страницу авторизации, проверка запускается автоматически — пользователю не нужно ничего нажимать.

Что происходит дальше:

  1. Нативная часть отправляет запрос к системе: «Проверь биометрию».
  2. Система запускает проверку. Вся проверка — на стороне операционной системы. Приложение не видит ни изображение, ни данные сканирования.
  3. Система возвращает результат: успех или неудача.
  4. Если успех, нативная часть достаёт из локального хранилища сохранённые логин и пароль.
  5. Отправляет их на специальный эндпоинт вместе с cookie сессии, которую сайт уже выдал этому WebView.
  6. Бэкенд проверяет креды и помечает эту сессию авторизованной. WebView перезагружается с той же cookie.
  7. Пользователь видит личный кабинет. Успех!

Проверку запускает делегат навигации WKWebView: как только загрузилась страница авторизации, нативная часть сама вызывает биометрию.

			extension WebViewController: WKNavigationDelegate {
    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
        guard webView.url?.path == loginPath,
              biometricService.shouldStartBiometricLogin() else { return }

        biometricService.authenticate { [weak self] success in
            self?.handleAuthResult(success)
        }
    }
}
		


Сама проверка идёт через LAContext. Колбэк evaluatePolicy приходит не на главном потоке, поэтому всё, что трогает интерфейс, возвращаем на main:

			func authenticate(completion: @escaping (Bool) -> Void) {
    let context = LAContext()
    context.evaluatePolicy(.deviceOwnerAuthentication,
                           localizedReason: "Вход в личный кабинет") { success, _ in
        DispatchQueue.main.async {
            completion(success)
        }
    }
}
		


Отдельно передавать сессию в WebView не нужно: она у него уже есть. Как только страница авторизации открывается, WebView получает cookie сессии (в нашем случае PHPSESSID). Нативная часть читает её из хранилища cookie и отправляет на бэкенд вместе с сохранёнными логином и паролем. Бэкенд проверяет креды и помечает эту сессию авторизованной. Нам остаётся перезагрузить страницу: тот же WebView с той же cookie теперь получает уже авторизованный кабинет.

			func loginWithSavedCredentials() {
    let cookieStore = webView.configuration.websiteDataStore.httpCookieStore

    // 1. Берём cookie сессии, которую уже выдал сайт этому WebView
    cookieStore.getAllCookies { [weak self] cookies in
        let sessionID = cookies.first { $0.name == "PHPSESSID" }?.value ?? ""
        self?.signIn(sessionID: sessionID)
    }
}

func signIn(sessionID: String) {
    var request = URLRequest(url: signInURL)
    request.httpMethod = "POST"
    // 2. Отправляем креды вместе с той же сессией
    request.setValue("PHPSESSID=\(sessionID)", forHTTPHeaderField: "Cookie")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = try? JSONEncoder().encode(savedCredentials)

    URLSession.shared.dataTask(with: request) { [weak self] data, _, _ in
        let isAuthorized = self?.parseAuthResult(data) ?? false
        DispatchQueue.main.async {
            if isAuthorized {
                // 3. Бэкенд пометил сессию авторизованной — просто перезагружаем страницу
                self?.webView.reload()
            } else {
                self?.showLoginForm()
            }
        }
    }.resume()
}
		
Face ID в WebView: как мы подключили нативную биометрию iOS к веб-кабинету без сторонних библиотек_49

Ключевое отличие от классического Face ID

В нативном приложении биометрия работает так: система проверяет лицо или отпечаток локально на устройстве и возвращает приложению результат проверки — «совпало» или «не совпало». Приложение использует этот результат для авторизации пользователя. Никакие данные биометрии не покидают устройство и не передаются на сервер.

В нашей WebView-схеме результат проверки тот же — флаг успеха или неудачи. Но дальше механика отличается. В нативном приложении флаг «совпало» сам по себе является основанием для авторизации. В нашем случае этот флаг лишь открывает доступ к сохранённым кредам: приложение достаёт логин и пароль из локального хранилища и отправляет их на бэкенд. Авторизация всё ещё идёт по кредам — как если бы пользователь ввёл их руками.

В WebView-схеме Face ID — что-то вроде замка на шкатулке. Он не авторизует пользователя в системе, он подтверждает, что человек имеет право достать сохранённые логин и пароль из локального хранилища устройства.

Такое архитектурное решение не требует изменений в существующей системе авторизации бэкенда и не передаёт биометрические данные за пределы устройства.

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

Что мы сделали

На мобильной части (нативной оболочке):

  1. Сервис запросов к биометрии. Логика обращения к системному API Apple, обработка ответов.
  2. Логика отказов на любом этапе. Пользователь нажал «Отмена», лицо не распозналось, биометрия заблокирована после нескольких попыток — для каждого сценария предусмотрен запасной путь: сообщение об ошибке и переход на экран ручного ввода. Приложение не должно зависнуть или сброситься ни на одном из этапов.
  3. Работа с UserDefaults. Сохранение и извлечение кредов.
  4. Флаг разрешения. Приложение помнит, что пользователь включил биометрию, и не запрашивает согласие повторно.

Все ветки отказа сходятся в одном месте. Для приложения неважно, что именно пошло не так: пользователь отменил проверку, лицо не распозналось или биометрия заблокирована. Повторные попытки и запрос код-пароля берёт на себя iOS, а мы получаем только итог. Если итог отрицательный, показываем сообщение об ошибке, а после его закрытия переводим пользователя на обычную форму входа. Упрощённо:

			func handleAuthResult(_ success: Bool) {
    guard success else {
        // отмена, не распознали, биометрия заблокирована — для приложения это один исход
        showAlert("Ошибка Face ID") { [weak self] in
            self?.showLoginForm() // логин и пароль подставлены, остаётся нажать «Войти»
        }
        return
    }
    loginWithSavedCredentials()
}
		

На бэкенде:

Один новый эндпоинт. По сути, «ручка», которую мобильная часть дёргает после успешной проверки владельца устройства. Она получает сохранённые логин и пароль вместе с PHPSESSID, проверяет креды и помечает существующую сессию авторизованной. Изменение минимальное, чтобы не трогать существующую архитектуру авторизации.

На веб-части (фронтенде):

Ничего. WebView перезагружается с уже авторизованной сессией — для веб-части это выглядит так же, как обычный вход по логину и паролю.

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

Самой трудоёмкой оказалась именно мобильная часть, так как необходимо было корректно обработать все промежуточные состояния и сценарии отказов, чтобы пользователь ни при каком раскладе не завис между экранами.

Корнер-кейсы. Что может пойти не так

В разработке так называемого happy path — сценария, где всё работает идеально — обычно мало интересного. Проблемы могут возникнуть в неочевидных юзкейсах. Вот что мы предусмотрели:

1. Пользователь удалил Face ID с устройства

Допустим, человек заходил по лицу, а потом сбросил биометрию в настройках iPhone. Приложение помнит, что Face ID был разрешён, и при запуске отправляет запрос к системе. Система не находит зарегистрированное лицо и вместо Face ID показывает запрос на код-пароль iPhone. Пользователь вводит код-пароль, авторизация проходит. Успех!

2. Пользователь нажал «Отмена»

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

3. Биометрия не распозналась

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

4. Переустановка приложения

Если пользователь удалил приложение и поставил заново, сохранённые в UserDefaults учётные данные и флаг включённой биометрии не подтягиваются. Всё с нуля: установка → логин/пароль → предложение включить Face ID → только после успешной проверки — биометрический вход.

5. Биометрия заблокирована

После нескольких неудачных попыток iOS временно блокирует биометрию. Дальше iOS сама предлагает ввести код-пароль, а если пользователь отменит и его, приложение сообщит об ошибке и покажет обычную форму входа.

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

Что получил пользователь

До внедрения:

Вход → вспомнить/ввести логин → вспомнить/ввести пароль → войти.

После внедрения:

Открыть приложение → посмотреть на экран → войти.

Для B2B-клиента, который заходит в личный кабинет несколько раз в день, это ощутимая перемена.

Презентация фичи прошла успешно, заказчик остался доволен. Мы внедряли Face ID параллельно с другими доработками, и весь релиз прошёл без остановки работы сервиса.

Если вы встраивали биометрию в WebView иначе, например через WebAuthn или с токеном вместо пароля в хранилище, расскажите в комментариях: интересно сравнить подходы.

FAQ
1
Можно ли встроить Face ID в любое WebView-приложение?

Технически — да, но не «из коробки». WebView не имеет прямого доступа к биометрии, поэтому нужна нативная прослойка, которая возьмёт на себя запрос к системе и передачу результата обратно.

2
Хранит ли приложение данные лица?

Нет. Биометрические данные обрабатываются и хранятся исключительно операционной системой iOS. Приложение получает только результат проверки — «да/нет» — и на его основе достаёт сохранённые креды из локального хранилища.

3
Что будет, если Face ID не сработает?

iOS предложит повторить проверку или ввести код-пароль устройства. Если проверка завершится неудачей или пользователь её отменит, приложение покажет сообщение об ошибке, а после его закрытия — обычную форму входа с подставленными логином и паролем. Остаётся нажать «Войти»: биометрия — опция, а не единственный способ входа.

4
Нужны ли сторонние библиотеки для Face ID в WebView?

Не обязательно. В нашем кейсе мы обошлись без них, используя системный API Apple и собственный мост между нативной частью и WebView.

5
Нужно ли делать отдельно Face ID и Touch ID в WebView?

Нет. Разработчик отправляет один запрос к системе, а iOS сама решает, какой метод биометрии доступен на конкретном устройстве. Если нет ни того, ни другого — запросит код-пароль.