Что такое защищённое хранилище — и почему приложение не знает свой ключ

Странная вещь: приложение может хранить секрет так, что само его не прочитает. Оно кладёт ключ в чип и потом только просит: «зашифруй вот это». Ключ наружу не выходит никогда — даже в код приложения.
Звучит как перебор. Но именно на этом держится вход по Face ID и то, что твой токен не утекает вместе с украденным телефоном.
Что такое защищённое хранилище простыми словами
Это отдельная кладовка операционной системы для маленьких секретов: токенов, ключей, паролей.
- На iOS она называется Keychain.
- На Android — Keystore.
Главное отличие от обычного файла приложения — хранилищем управляет система, а не ты. Она решает, кому отдать содержимое и при каких условиях: например, только после отпечатка и только когда телефон разблокирован.
Класть туда гигабайты нельзя, да и незачем. Это сейф для ключей, а не склад.
Ключ, который нельзя вынести
Вот главная механика, которую стоит понять.
Когда ключ создан «в железе», его материал не попадает в процесс приложения — так это описывает документация Android. Приложение отправляет данные в защищённый чип и получает обратно результат: подпись или шифротекст.
Отсюда важное следствие. Если приложение взломали, злоумышленник сможет пользоваться ключом на этом телефоне, но не сможет его скопировать и унести на свой компьютер. Разница огромная: украденной базой ключей никто не воспользуется удалённо.
На Android 9 и новее часть устройств умеет ещё жёстче — StrongBox, отдельный защищённый чип. У Apple ту же роль играет Secure Enclave.
Куда точно не надо класть токен
Три места, где секрет лежит фактически открытым текстом:
UserDefaultsна iOS иSharedPreferencesна Android — это обычные файлы настроек;localStorageв вебе — его читает любой скрипт на странице;- сам код приложения. Ключ, вшитый в приложение, достаётся распаковкой файла за пару минут — подробнее в разборе как безопасно хранить API-ключи.
Правило простое: настройки — в настройки, секреты — в хранилище.
Что происходит, пока телефон заблокирован
Секрет доступен не всегда — и это настраивается тобой.
У каждой записи в Keychain есть класс доступности. Самый строгий отдаёт секрет только когда экран разблокирован. Есть помягче: «после первой разблокировки» — секрет остаётся доступным до перезагрузки, даже если телефон снова заперт. На Android похожую роль играет требование разблокированного устройства для ключа.
Разница вылезает в неожиданном месте — в фоне. Приложение просыпается ночью, чтобы синхронизировать данные, лезет за токеном и получает отказ, потому что телефон лежит заблокированный на тумбочке. В отладке это выглядит как случайные ошибки сети, хотя сеть ни при чём.
Правило простое: чем чаще секрет нужен в фоне, тем мягче класс — но никогда не мягче, чем реально требуется.
Грабли: секрет переживает удаление приложения
Неочевидное поведение iOS, о которое спотыкаются все.
Удаляешь приложение — данные приложения исчезают. А записи в Keychain остаются. Ставишь заново и обнаруживаешь, что уже залогинен, хотя явно всё снёс.
Apple прямо говорит: это побочный эффект реализации, полагаться на него не стоит. Но и рассчитывать на очистку тоже нельзя — ведёт себя оно именно так.
Лечится в одну строчку. При первом запуске проверь флаг в UserDefaults (он-то удаляется вместе с приложением). Флага нет — значит установка новая, почисти Keychain и начни с чистого листа.
На Android привычная библиотека устарела
Если найдёшь в старом туториале EncryptedSharedPreferences, знай: вся библиотека androidx.security-crypto объявлена устаревшей в версии 1.1.0, и новых релизов у неё не будет.
Актуальный путь — Jetpack DataStore. Для шифрования есть артефакт datastore-tink: он шифрует содержимое через библиотеку Tink, а ключ для этого держит в Keystore. Схема та же самая: данные лежат в файле, ключ — в железе.
Частые вопросы
Это спасёт, если телефон рутован или джейлбрейкнут?
Частично. Вынести ключ по-прежнему нельзя, но на самом устройстве им можно воспользоваться. Поэтому серверу всё равно нужны короткие сроки жизни токенов и возможность отозвать сессию — как у refresh-токена.
А в браузере есть такое же хранилище?
Нет, полного аналога нет. Самый близкий вариант — не хранить токен в JavaScript вообще, а держать его в cookie с флагом HttpOnly: скрипты до неё не дотянутся.
Обязательно ли просить отпечаток при каждом чтении?
Нет, это твоё решение. Разумный компромисс — биометрия на вход в приложение и на действия с деньгами; как это сделать правильно, разобрано в гайде как добавить вход по отпечатку.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





