Что такое…

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

Иллюстрация: ключ заперт в чипе, наружу выходит только результат

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

Звучит как перебор. Но именно на этом держится вход по 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →