Начало темыИсходник

Magisk-модуль подмены отпечатка: сборка, верификатор контракта и почему Play Integrity это не лечит

stalevstalevНовичок·11.11.2026· 0 ответов 0 реакций

Сначала про рамку. Дальше — модуль Magisk, который выставляет отпечаток устройства, и верификатор, который доказывает, что модуль собран правильно. На телефоне он не запускался: у меня Windows, ни adb, ни Magisk, ни аппарата под рукой. Поэтому весь текст про контракт модуля и структуру zip, а не про то, как красиво он поднимается на живом Android.

Зачем вообще трогать отпечаток

После GSI, порта или сборки vendor с чужого аппарата build.prop превращается в лоскутное одеяло. Модель от донора, build id от рома, security patch невнятный, а ro.build.fingerprint собран из двух разных устройств — половину строк кто-то поправил, вторую забыл. Система работает. Ломается другое: такси говорит «устройство не поддерживается», маркет отдаёт версии под другой экран, банк смотрит на свойства и уходит в отказ.

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

Что именно правится

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

# system.prop — единственное место, где лежат значения
ro.product.brand=google
ro.product.manufacturer=Google
ro.product.model=Pixel 5
ro.product.device=redfin
ro.product.name=redfin
ro.product.board=redfin
ro.boot.hardware=redfin
ro.build.id=RQ1A.201105.002
ro.build.version.release=11
ro.build.version.incremental=6825462
ro.build.type=user
ro.build.tags=release-keys
ro.build.description=redfin-user 11 RQ1A.201105.002 6825462 release-keys
ro.build.fingerprint=google/redfin/redfin:11/RQ1A.201105.002/6825462:user/release-keys
ro.build.version.security_patch=2020-11-05
ro.vendor.build.security_patch=2020-11-05
ro.system.build.fingerprint=google/redfin/redfin:11/RQ1A.201105.002/6825462:user/release-keys
ro.vendor.build.fingerprint=google/redfin/redfin:11/RQ1A.201105.002/6825462:user/release-keys

Восемнадцать свойств. Половина из них — те, которые все забывают: ro.product.manufacturer, ro.product.board, ro.boot.hardware, ro.build.version.security_patch. Отпечаток в каноническом формате brand/product/device:release/build_id/incremental:type/tags. Сборка RQ1A.201105.002 и incremental 6825462 — публичный factory image Pixel 5 (redfin), Android 11, ноябрь 2020; это демонстрационный набор, а не «последняя прошивка», и для другого аппарата правится только этот файл.

Два прохода, а не один

system.prop Magisk применяет сам на стадии post-fs-data. Для половины устройств этого хватит. На второй половине часть ro.* перезаписывается init уже после того, как модуль отработал, и вы получаете телефон, у которого отпечаток «правильный», но не тот, что в файле.

Поэтому проходов два. post-fs-data.sh — до zygote, пока свойства никто не прочитал. service.sh — после того, как система дошла до sys.boot_completed=1, второй раз тем же набором, и потом чтение обратно.

i=0
while [ "$(getprop sys.boot_completed)" != "1" ]; do
  i=$((i + 1))
  if [ "$i" -ge "$WAIT_MAX" ]; then
    log -t fpfix "service: boot_completed timeout after ${WAIT_MAX}s"
    exit 0
  fi
  sleep 1
done

want=$(grep -m1 '^ro\.build\.fingerprint=' "$MODDIR/system.prop" | cut -d= -f2-)
"$MODDIR/bin/fpfix_apply.sh" "$MODDIR/system.prop" "$STATE/service.log" || true

got=$(getprop ro.build.fingerprint)
tries=0
while [ "$got" != "$want" ] && [ "$tries" -lt "$RETRIES" ]; do
  tries=$((tries + 1))
  sleep 5
  "$MODDIR/bin/fpfix_apply.sh" "$MODDIR/system.prop" "$STATE/service.log" || true
  got=$(getprop ro.build.fingerprint)
done

Смысл read-back простой: скрипт не верит, что resetprop сработал, — он идёт и смотрит. Не совпало — до трёх повторов с паузой, результат в /data/adb/fpfix/status, и этот файл можно просто cat-нуть вместо гадания.

И про сам вызов: везде resetprop -n, где -n — «не дёргать property triggers». Без флага смена ro.* триггерит init-действия, часть сервисов перезапускается по ходу загрузки. Из этого «перезапуска на полпути» и растут истории про телефон, уходящий в ребут на логотипе. Флаг — половина разницы между «работает» и «бутлуп».

Защита от бутлупа: счётчик, а не надежда

Скрипт, который может уронить загрузку, обязан уметь отключаться сам. Тут это счётчик в /data/adb/fpfix/boot_count: post-fs-data.sh инкрементит его на каждой загрузке, service.sh сбрасывает в 0 только после того, как система дошла до boot_completed и отпечаток совпал. Порог — три неудачных старта подряд. На четвёртом props не применяются вообще, и устройство обязано подняться без них.

Логика простая до неприличия, и именно поэтому работает: не дошло до boot_completed — счётчик не сбросился. Три раза не дошло — модуль выключается сам. Всё равно нужен выход руками: Magisk Safe Mode, зажать громкость вверх при загрузке, модуль отключается на один старт. Об этом почему-то пишут мелким шрифтом в конце, хотя это первое, что нужно знать до, а не после.

Теперь то, ради чего это всё писалось

Модуль без проверки — это набор файлов, про который автор говорит «должно работать». У меня нет телефона, значит единственный способ не врать — проверить то, что проверяется: контракт модуля и структуру zip.

Верификатор — tools/verify.py, проверки — чистые функции в tools/checks.py, каждая возвращает имя, PASS/FAIL и причину. По дереву модуля их 22, все PASS: файлы и относительные пути, разбор module.prop, формат id и versionCode, разбор system.prop, дубликаты ключей, формат отпечатка, сходимость его полей с ro.product.* и description, патч безопасности, shebang, CRLF, set -e, executable-бит, шаблон update-binary, хуки customize.sh, уборка в uninstall, единственный источник значения, синтаксис.

$ python cli.py verify module/
PASS  layout.required_files           9 обязательных файлов на месте
PASS  module_prop.parse               6 ключей разобрано, дубликатов нет
PASS  system_prop.parse               18 пар, все 11 обязательных есть
PASS  system_prop.fingerprint_format  google/redfin/redfin:11/RQ1A.201105.002/6825462:user/release-keys
PASS  system_prop.cross_fields        8 полей + description сходятся с отпечатком
PASS  scripts.crlf                    8 текстовых файлов, ни одного CR
PASS  scripts.syntax                  sh -n прошёл по 6 файлам (sh.exe)

итого 22 проверок: 22 PASS, 0 FAIL   (sh -n: C:\Program Files\Git\usr\bin\sh.exe)

Про sh -n отдельно: это единственная проверка, которая не моя выдумка, а настоящий парсер — нашёлся POSIX sh из Git for Windows, им и парсится каждый скрипт. Если sh не найден, верификатор не делает вид, что синтаксис проверен: пишет, что работал встроенный лексер (кавычки и пары if/fi, case/esac, do/done). Лексер ловит забытый fi и незакрытую кавычку, но не всё остальное.

Архив проверяется двадцатью пятью: те же 22 по распакованному дереву плюс три своих — имена записей (относительные пути, прямые слэши, без __MACOSX и .DS_Store), mode 0755 у скриптов и CRC. Девять файлов, 8106 байт zip против 14656 байт исходников.

$ python cli.py pack module/ _run/fp.zip
записей: 9  сырых байт: 14656  zip: 8106 байт
сжатие: 55.3% от исходного

$ python cli.py verify _run/fp.zip
PASS  zip.entries                     9 записей, пути относительные
PASS  zip.modes                       6 скриптов с mode 0755, всего 9 записей
PASS  zip.integrity                   CRC ок, файлов 9, нулевой размер: нет

итого 25 проверок: 25 PASS, 0 FAIL

Сборщик отказывается собирать мусор: CRLF в скрипте, скрипт без shebang, пустой файл, дубликат ключа — отказ с причиной, а не zip, который «ну вроде поставится». Архив детерминированный: фиксированное время записей, сортировка, никакой зависимости от порядка обхода файловой системы; два прогона дают побайтово одинаковый файл, на это есть тест.

Как я убедился, что это не штамп

Верификатор, который всегда говорит PASS, бесполезен, и отличить его от настоящего по одному зелёному прогону нельзя. Поэтому в прогоне отдельный шаг: копия модуля портится четырьмя способами — удалён uninstall.sh, post-fs-data.sh переведён в CRLF, в system.prop добавлен второй ro.build.tags, в service.sh открыт if без fi. Прогон по копии даёт шесть FAIL с конкретными причинами.

FAIL  layout.required_files           нет: uninstall.sh
FAIL  system_prop.duplicate_keys      повторяются: ro.build.tags
FAIL  scripts.crlf                    post-fs-data.sh: CR в строках [1, 2, 3]
FAIL  scripts.set_e                   uninstall.sh: файла нет
FAIL  uninstall.cleanup               uninstall.sh отсутствует
FAIL  scripts.syntax                  service.sh: line 52: syntax error: unexpected end of file

итого 22 проверок: 16 PASS, 6 FAIL

Шесть, а не четыре: диагностика честно каскадится — удалённый файл валит и set -e, и уборку в uninstall. Это три разных утверждения про один отсутствующий файл. Лучше так, чем один FAIL «модуль сломан».

И тот же битый модуль на сборке:

$ python cli.py pack _run/broken/module _run/broken.zip
PACK ОТКАЗ: нет uninstall.sh; post-fs-data.sh: CRLF в строках [1, 2, 3] — скрипт упадёт с 'not found'; system.prop: дубликаты ro.build.tags

Архив не создан. Вот это уже похоже на проверку, а не на ритуал.

Тестов 59, и они не только про «зелёное на хорошем модуле»: 20 из них — намеренно испорченные копии, по одному-два на каждый вид поломки, плюс проверка, что одна поломка не валит половину проверок, плюс детерминизм отчёта и побайтовое равенство двух сборок zip.

Чего это не делает

Главное, что нужно сказать прямо: подмена отпечатка сама по себе не проходит Play Integrity. Ни MEETS_DEVICE_INTEGRITY, ни тем более MEETS_STRONG_INTEGRITY: вердикт зависит от состояния загрузчика, verified boot и наличия root, а STRONG требует железячного ключа, которого у разлоченного устройства нет. Модуль чинит то, что приложения читают из build.prop — регион, модель, доступность фич. Аттестацию он не лечит и не пытается.

Дальше по списку, без порядка важности. Модуль не устанавливался: ни разу, ни на одном устройстве. Бутлуп не воспроизводился — guard проверен чтением кода и тестами на тексте, а не тремя ребутами. resetprop на живом property service не вызывался, read-back через getprop не выполнялся. Всё, что выше про два прохода и -n, — это как должно работать по устройству Android и по докам Magisk, а не отчёт с телефона.

Как поставить, если всё-таки ставите

Magisk → Modules → Install from storage → выбрать zip → перезагрузка. Проверка после загрузки: getprop ro.build.fingerprint и cat /data/adb/fpfix/status. Если там MISMATCH — в service.log построчно видно, что применилось и что resetprop отверг. Если телефон не поднялся: Safe Mode громкостью вверх при старте, модуль отключается.

Ставить это стоит не «чтобы прошёл банк», а когда конкретное приложение конкретно из-за модели или отпечатка отказывается работать. В остальных случаях вы меняете одну ложь в системе на другую, более аккуратную, и рискуете загрузкой ради этого.

Всё, что в тексте в виде чисел, — из transcript.txt этого же прогона: 59 тестов, 22 и 25 проверок, 9 файлов, 8106 байт, 6 скриптов через настоящий sh -n. Цифры не переписывались руками, это вывод прогона; при повторном запуске на этой машине они совпадут, кроме времени в pytest.

если что-то работает и никто не понимает почему — не трогай

Исходники
magisk-fp.zipЗарегистрируйтесь и поставьте реакцию на сообщение — исходник откроется.45 КБ

Комментарии

0
Пока нет комментариев. Войдите, чтобы ответить первым.