ENСканировать

База знаний / Секреты и API-ключи

В приложении утёк API-ключ: что делать

Почему обфускация не защищает ключи внутри APK, как утёкшие токены находят за минуты, и план восстановления: ротация, ограничение скоупа, перенос секретов на бэкенд.

Обновлено: 2026-11-13·6 мин чтения

Начинается с сообщения от безопасников, багбаунти-репорта или собственного аудита: строка 142 в strings.xml содержит живой Stripe-ключ. API-ключ, попавший в APK, публичен: считайте момент попадания в сборку моментом утечки. Ниже разобрано, почему так происходит, как такие ключи находят и что делать дальше.

Почему ключи внутри APK публичны

APK — это ZIP-архив, который телефон каждого пользователя получает целиком. Любой, без специальных навыков, может его открыть, и всё, что приложение везёт с собой, лежит в этом архиве: ресурсы, DEX-байткод, нативные библиотеки, ассеты. Вопрос в том, сколько займёт извлечение: открытая строка в ресурсах достаётся за секунды, обфусцированная константа за минуту, ключ в нативной библиотеке требует одной лишней команды strings.

Первая естественная реакция, «мы обфусцируем», не выдерживает знакомства с тем, как реально происходит извлечение. Обфускаторы переименовывают ваши классы; строка sk_live_… остаётся строкой. Автоматические сканеры секретов ищут по форме токена (sk_, ghp_, ключи Google API, JWT, AWS access ID) сразу по декомпилированным исходникам, ресурсам и бинарникам. В нашем публичном демо npm-токен, Slack-вебхук и Firebase-ключ находятся в sample-приложении за секунды после загрузки. Тот же проход можно запустить и на вашей сборке до следующего релиза.

Где реально прячутся утёкшие ключи

  • Ресурсы: res/values/strings.xml и соседи, классическое место «положим в конфиг», ищется grep без инструментов.
  • Ассеты и конфиги: assets/config.json, прихваченный сборочным скриптом .env.
  • Константы DEX: строковые литералы в Java/Kotlin, переживают обфускацию без изменений.
  • Нативные библиотеки: .so с вычисляемыми или XOR-енными ключами; видны strings и дизассемблеру.
  • Метаданные сборки: забытые debug-эндпоинты, стейджинг-URL и их basic-auth пары.

Для каждого места нужен свой шаг извлечения, поэтому серьёзное сканирование покрывает все сразу: ресурсы, декомпилированный Java, нативные бинарники и ассеты в одном отчёте, с severity и точной уликой file:line.

План восстановления

  1. Ротация немедленно. Утёкший ключ скомпрометирован с момента распространения APK; «наверное, никто не смотрел» не аргумент. Ротация дешёвая; разбор того, что ключ делал три месяца, дорогой.
  2. Проверить панель провайдера. Всплески использования, незнакомые регионы, новые объекты, созданные токеном. Понять, утечка осталась теоретической или её эксплуатировали.
  3. Ограничить замену. Restricted-ключи, привязанные к конкретным API, правила referrer/IP там, где провайдер поддерживает, раздельные ключи dev/staging/prod, чтобы следующая утечка была скучной.
  4. Перенести секрет на сервер. Единственное долговечное решение: клиент держит короткоживущий токен, ключ держит ваш бэкенд. Всё, что клиент везёт с собой, читаемо всем; проектируйте из этого.
  5. Пересканировать каждый релиз. Секреты регрессируют: обновление библиотеки возвращает debug-ключ, коллега откатывает чистку конфига. Дифф между версиями показывает, какие находки новые; так регрессию ловят раньше пользователей.

Что утёкший ключ говорит о сборке

Помимо прямого ущерба, встроенные секреты служат диагностикой: они помечают места, где граница между клиентом и бэкендом осталась без охраны. Firebase-ключ плюс Slack-вебхук плюс npm-токен в одной сборке говорят, что команда считает APK приватным артефактом, и исправление головы важнее ротации. По теме: как аналитики используют встроенные секреты, разбирая малварь и какие файлы выставляет каждый формат пакета.

Частые вопросы

Обфускация ProGuard/R8 защищает мой API-ключ?

Нет. Обфускация переименовывает классы и методы, но строковая константа остаётся строковой константой. Любой grep по декомпилированным исходникам (или по сырому DEX) находит токены вида 'sk_live_', как бы ни был обфусцирован код вокруг.

Ключ спрятан в нативном коде (.so), я в безопасности?

Чуть безопаснее от grep. Ключ, зашитый в нативную библиотеку, извлекается командой 'strings libapp.so' за секунды, если он не вычисляется в рантайме, а логику вычисления видит каждый, кто откроет бинарник в Ghidra.

Что делать в первый час после обнаружения утёкшего ключа?

Ротировать у провайдера, проверить панель использования/биллинга на незнакомую активность и ограничить замену (restricted-ключ, правила IP/referrer, раздельные dev/prod). Затем найти все остальные копии: статический анализ APK показывает все встроенные секреты с уликами file:line, а не только тот, о котором вы уже знаете.

Из других разделов