Как добавить вход по отпечатку — и не сделать защиту декоративной

Самая частая ошибка в биометрическом входе выглядит невинно:
if (успешно) {
открытьПриложение()
}
Экран с отпечатком показали, галочку получили, пустили. Проблема в том, что защиты тут ноль. Токен всё это время лежал в хранилище открытым, и достать его можно в обход этого экрана — просто прочитав файлы приложения.
Биометрия работает иначе: она не отвечает «это ты», она разрешает воспользоваться ключом. Разберём, как сделать правильно.
Что получится
Пользователь входит логином один раз. Дальше открывает приложение отпечатком или лицом за полсекунды. Токен при этом физически недоступен, пока биометрия не пройдена.
1. Не заменяй вход, а надстрой его
Биометрия — это не способ авторизации на сервере. Сервер про твой палец ничего не знает и знать не должен.
Поэтому схема такая:
- Первый вход — обычный: почта, пароль, код или вход через Google. Как это поднять за 20 минут, разобрано в гайде как добавить вход в приложение.
- С сервера приходит refresh-токен.
- Ты сохраняешь его — и вот тут начинается биометрия.
2. Положи токен в хранилище с условием «только после биометрии»
Ключевой шаг. Токен уходит в защищённое хранилище, но не просто так, а с политикой доступа.
- iOS. Создаёшь
SecAccessControlи кладёшь запись в Keychain с ним. ФлагbiometryCurrentSetдаёт полезный побочный эффект: если в телефон добавят новый отпечаток или лицо, запись перестанет открываться и вернётerrSecAuthFailed. Кто-то подсадил свой палец в разблокированный телефон — доступ к секрету он не получит. - Android. Генеришь ключ в Keystore с
setUserAuthenticationRequired(true). После этого ключ физически нельзя использовать без подтверждения владельца.
Токен шифруется этим ключом. Файл украсть можно, расшифровать — нет.
3. Показывай промпт так, чтобы он что-то значил
На Android вызывай BiometricPrompt с CryptoObject — передай в него Cipher, проинициализированный твоим ключом:
biometricPrompt.authenticate(promptInfo, BiometricPrompt.CryptoObject(cipher))
Разница принципиальная. Без CryptoObject ты получаешь просто «пользователь приложил палец» — то самое булево из начала статьи. С ним ты получаешь работающий шифр, которым расшифровываешь токен. Обойти нечего: без успешной биометрии расшифровки не существует.
Для денежных операций Android советует требовать биометрию класса 3 (сильную) и работать именно через CryptoObject.
На iOS отдельный вызов часто не нужен: система сама поднимет Face ID, когда ты попробуешь прочитать защищённую запись из Keychain.
4. Обработай отказы — их больше, чем кажется
Путей «биометрия не сработала» примерно пять, и все встречаются в первый же день:
- сенсора нет вовсе (старое или дешёвое устройство);
- сенсор есть, но ничего не настроено;
- пользователь нажал «Отмена»;
- три неудачные попытки подряд — система временно блокирует;
- набор биометрии изменился, ключ стал недоступен.
Правило: биометрия — всегда ускорение, а не единственная дверь. На каждый из случаев оставь обычный вход. Последний пункт обрабатывай отдельно: секрет пропал не по ошибке, надо честно попросить войти заново.
5. Проверь на настоящем устройстве
Симулятор здесь врёт. Обычную проверку LocalAuthentication он изобразит, а вот биометрический доступ к Keychain в симуляторе не работает. Ровно то место, ради которого всё затевалось, останется непроверенным.
Пять минут на живом телефоне — и три ошибки находятся сразу.
6. Спроси разрешения в правильный момент
Техническая часть готова, осталась половина успеха — момент, когда ты предлагаешь включить биометрию.
Плохой момент — первый запуск. Человек ещё не понял, что за приложение, а у него уже просят палец. Отказ здесь дорогой: системный запрос показывают один раз, дальше пользователя придётся отправлять в настройки телефона.
Хороший момент — сразу после первого успешного входа. Ценность очевидна: «чтобы не вводить это каждый раз». И обязательно оставь переключатель в настройках приложения: кто-то отказался случайно, кто-то передумал через неделю.
Мелочь, которая заметно влияет: пиши в промпте, зачем это нужно, а не «Подтвердите личность». «Открыть KODiQ без ввода пароля» — понятнее и честнее.
Частые вопросы
Приложение получает моё лицо или отпечаток?
Нет. Данные биометрии не покидают защищённый чип. Приложению возвращается только результат проверки — а в правильной схеме ещё и доступ к ключу.
Это замена паролю или второй фактор?
Формально — удобный способ разблокировать локальный секрет. Полноценный второй фактор для аккаунта — это 2FA на стороне сервиса.
Что делать, если пользователь сменил телефон?
Ничего особенного: на новом устройстве ключа нет, значит будет обычный вход и новая привязка. Так и задумано — секрет не переезжает вместе с бэкапом.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





