Разработка авторизации по биометрии (Touch ID) в iOS-приложении
Touch ID старше Face ID, но до сих пор актуален: iPhone SE 3rd gen, iPad mini 6, iPad 10th gen с боковым сенсором — всё это действующий парк устройств у реальных пользователей. LAContext один и тот же, но поведение отличается в деталях, которые бьют в продакшене.
Специфика Touch ID против Face ID
Главное отличие — мультипальцевая регистрация. У пользователя может быть до пяти отпечатков. При biometryType == .touchID и успешной аутентификации вы не знаете, какой именно палец был использован — API этого не отдаёт. Для большинства сценариев это нормально, но в enterprise-приложениях с журналом аудита иногда хотят логировать "какое устройство использовалось". Touch ID это не позволяет по дизайну.
Второе отличие — скорость деградации. Влажные пальцы, перчатки, порезы — Touch ID чаще уходит в fallback, чем Face ID. Это значит, что .userFallback надо обрабатывать качественно, а не показывать кнопку "Введите пароль" без объяснений.
Ошибка, которую встречаю регулярно: разработчик проверяет biometryType один раз при запуске и кэширует результат. Пользователь добавляет новый отпечаток в настройках — кэш устарел, Keychain-запись с .biometryCurrentSet инвалидирована, приложение падает с errSecItemNotFound (-25300) при попытке достать токен. Правильно: создавать новый LAContext перед каждой попыткой аутентификации и не хранить контекст дольше одной транзакции.
Реализация
Политика та же — .deviceOwnerAuthenticationWithBiometrics. Но для Touch ID особенно важен параметр localizedFallbackTitle у LAContext. Если поставить пустую строку "" — кнопка fallback скроется полностью. Если не задать — появится "Enter Password" (системный текст). Ставим кастомный: "Войти по PIN-коду" или "Использовать пароль приложения" — в зависимости от того, что у вас реализовано.
Хранение секрета в Keychain под Touch ID:
var error: Unmanaged<CFError>?
guard let access = SecAccessControlCreateWithFlags(
kCFAllocatorDefault,
kSecAttrAccessibleWhenPasscodeSetThisDeviceOnly,
[.biometryCurrentSet, .privateKeyUsage],
&error
) else { /* handle */ }
Флаг .privateKeyUsage добавляется, если секрет используется для крипто-операций (подпись запросов). Для простого хранения токена достаточно .biometryCurrentSet.
Боковой Touch ID (iPad, iPhone SE)
На iPad mini 6 и iPad 10th gen сенсор встроен в кнопку питания. Анимация разблокировки другая — пользователь прикладывает палец к боковой кнопке, а не к нижней. Это влияет на то, как вы позиционируете подсказки в UI. biometryType вернёт .touchID в обоих случаях — различий в API нет, только в UX-копирайтинге.
Тестирование и edge cases
Обязательно тестируем:
- Отпечаток не распознан три раза подряд → lockout → корректный переход на fallback
- Touch ID отключён в настройках устройства →
.biometryNotAvailable - Passcode не задан →
canEvaluatePolicyвернётfalseс ошибкой.passcodeNotSet - Приложение уходит в background во время ожидания Touch ID →
.systemCancel
На симуляторе эмулируем через Features → Touch ID → Matching Touch / Non-matching Touch.
Сроки
Реализация Touch ID-аутентификации с Keychain-хранилищем, обработкой всех error states и unit-тестами — 2–5 рабочих дней. Если нужна интеграция с существующим auth-модулем или миграция с UserDefaults на Keychain — добавляем 1–2 дня на аудит и рефакторинг.