Реверс Electron-приложений с нуля — полный гайд: asar, integrity, патчинг | End Way — сообщество разработчиков и готовых решений
  • Больше материалов без ожидания и лишних условий
    Доступ к скрытым публикациям на 2 месяца, 3 месяца или навсегда. Ограничения «Команда форума» и «Личный» сохраняются.

    Сравнить варианты доступа →

    🔔 EndWay в Telegram

    Следите за новостями и релизами:
    EndWay | EndSoft

Реверс Electron-приложений с нуля — полный гайд: asar, integrity, патчинг

badxprogramm

Сеньор
Автор темы
23 Май 2025
17
62
Всем привет. Этот гайд — про то, как разбирать Electron-приложения: от первого взгляда на папку до рабочего патчера-скрипта, всё на пальцах, но без упрощений — после прочтения сможешь взять почти любую прогу на электроне и понять как она устроена.

Часть 1. Что такое Electron и где что лежит

Electron — это Chromium + Node.js в одном флаконе. Разработчик пишет обычный веб-фронт (HTML/CSS/JS) и node-бэк, electron упаковывает это в десктопную прогу. На нём сидят Discord, VS Code, Slack, Figma, куча оптимизаторов, трекеров, лаунчеров.

Структура установленной проги всегда одинаковая:

Код:
Program Files/Prog/
├── Prog.exe            ← лаунчер: chromium-движок + node + обвязка
├── resources/
│   └── app.asar        ← ВЕСЬ код приложения в одном архиве (цель №1)
├── *.dll               ← ffmpeg, swiftshader, системные либы electron
├── locales/            ← переводы интерфейса
└── Uninstall Prog.exe

Данные юзера лежат отдельно, обычно в %AppData%/Roaming/Prog/: LevelDB-хранилища (localStorage, IndexedDB), кэши, логи, куки. Туда пойдём в части про сеть и кэш.

Два процесса внутри: main (node, доступ к системе — файлы, сеть, реестр, железо) и renderer (chromium, интерфейс). Общаются через IPC. Для реверса важно: проверки лицензий бывают в обоих, патчить иногда надо оба.

app.asar — и есть цель. asar — простой архив без сжатия: в начале json-хедер с деревом файлов (имена, размеры, оффсеты, хеши), дальше сырые байты всех файлов подряд. Весь JS лежит внутри открытым текстом — обычно минифицированный (переменные e,t,i), но не шифрованный и не обфусцированный. Строки, URL API, ключи — всё читается.

Часть 2. Инструменты реверсёра

Минимальный набор, всё бесплатное:

  • Распаковка asar — пакет @electron/asar через npm: npx asar extract app.asar ./out. Листает содержимое: npx asar list app.asar. Если npm ставить лень — формат разбирается руками за вечер (про него в части 4)
  • Поиск по коду — VS Code «поиск по папке» или ripgrep (rg). Минифицированный JS — это одна строка на 10 МБ, ищи по словам: premium, license, subscription, isPro, entitlement, hasActive, trial, paywall, billing, stripe, paddle
  • Просмотр PE-ресурсов exe — Resource Hacker (GUI) или python-pefile (скриптами). Для записи — WinAPI UpdateResourceW через ctypes, это 15 строк
  • Хеши — certutil -hashfile в винде, sha256sum в линуксе, или hashlib в питоне. Понадобится постоянно
  • Сеть — Fiddler Classic / Charles / mitmproxy. Смотришь какие API дёргает прога, какие ответы приходят. Но помни про pinning (часть 6)
  • Дизассемблер — обычно не нужен для electron-реверса (весь смысл в JS), но если упрёшься в нативную проверку в exe/dll — x64dbg или Ghidra
  • Python 3 — основной инструмент для патчеров: парсинг asar, пересчёт хешей, правка PE-ресурсов. Всё из этого гайда делается на чистом питоне без node

Часть 3. Разведка: первые 15 минут с новой прогой

Алгоритм первичного осмотра, работает всегда:

  1. Открываешь папку установки, проверяешь наличие resources/app.asar — если есть, это electron, гайд применим
  2. Смотришь package.json внутри asar (имя, версия, автор, точка входа)
  3. Распаковываешь asar во временную папку, смотришь размеры: main.js (бэк, обычно 1-5 МБ), renderer.js (фронт, 5-15 МБ), preload.js (мост между ними, там список всех IPC-каналов — золотая жила, читай первым)
  4. Грепаешь https:// в main.js — получаешь список всех API-хостов проги за минуту
  5. Грепаешь premium|license|subscription|trial в renderer.js — получаешь карту всех мест где премиум упоминается
  6. Открываешь Roaming/Prog/logs/ — логи часто содержат URL запросов, тексты ошибок, названия внутренних модулей

Уже после этого обычно понятно: где проверка, какой API, какая защита. Дальше — вглубь.

Часть 4. Формат asar изнутри

Чтобы не зависеть от npm-пакета и писать свои патчеры, разберём формат.

Код:
смещение 0:  uint32 x4  (служебные, нужен только 4-й)
смещение 12: uint32 H   (длина json-хедера в байтах)
смещение 16: H байт json (дерево файлов)
дальше:      контент-блок (файлы подряд), начало выровнено до 8 байт

Json-хедер — обычный объект с деревом файлов: files → dist → files → main → files → main.js, у каждого файла size, offset (строка! от начала контент-блока) и integrity. Header-хеш (тот что проверяет electron) — это sha256 от байт json-хедера как есть. Не весь файл, не контент — только json-кусок. Это главная деталь, на ней все спотыкаются.

Per-file integrity у каждого файла:

Код:
"integrity": {
  "algorithm": "SHA256",
  "blockSize": 4194304,
  "blocks": ["<sha256 блока 1>", "<sha256 блока 2>"],
  "hash": "<sha256 всего файла>"
}

Файл режется на куски по 4 МБ, хешируется каждый кусок + целиком. Правишь байт и не обновляешь запись — получишь ASAR Integrity Violation.

Часть 5. Как устроена проверка премиума

В 90% приложений схема одинаковая:

  1. Клиент при старте дёргает API: GET /subscription, /license, /payments/..., /user
  2. Ответ кладётся в стор (redux/vuex/pinia): hasPremium = status == active
  3. UI смотрит на флаг: paywall-модалки, locked-кнопки, лимиты

Ключевое понимание: флаг живёт на клиенте, решение принимает клиент. Точек воздействия три:

  • Подменить ответ сервера (прокси) — ломается о pinning, см. часть 6
  • Подменить флаг в коде (патч функции проверки) — самое надёжное, сервер вообще не нужен
  • Подменить данные в локальном хранилище (LevelDB) — работает до первого опроса сервера

Как найти проверку: не ищи где флаг читается (таких мест десятки), ищи где он вычисляется (1-3 на всё приложение). Маркеры: hasActiveSubscription, status === active, includes('trialing'). Проверок бывает несколько: отдельно в renderer, отдельно в main — патчить надо все.

Часть 6. Сеть: API, pinning, кэш

  • Запускаешь Fiddler, смотришь запросы: endpoint подписки, формат ответа, частота опроса (обычно раз в 1-5 минут + по фокусу)
  • Если pinning нет — подменяешь ответ прокси: отдаёшь hasActiveSubscription true. Временно, для тестов
  • SSL-pinning — проги вешают setCertificateVerifyProc, самоподписанный серт режется. Обход — это уже патч main.js, так что сразу иди в код
  • Кэш как запасной путь — при обрыве API многие клиенты работают по кэшу из стора. Можно подсунуть кэш в LevelDB, но endpoint обычно на общем хосте — костыль

Часть 7. Техника in-place патча (ядро гайда)

Проблема: поменяешь размер файла — поплывут оффсеты всех следующих. Чистый путь — in-place: новая функция занимает ровно столько же байт. Было function(e) с проверкой на 200 байт — стало function(e) с return true + паддинг-коммент, те же 200 байт.

Пошаговый алгоритм:

  1. Распаковываешь asar, находишь функцию проверки, определяешь границы по балансу скобок
  2. В бинарнике asar заменяешь байты: return true + паддинг до исходной длины. Размер файла не меняется, оффсеты целы
  3. Считаешь sha256 нового контента + поблочные хеши (куски по 4 МБ)
  4. В хедере меняешь старую integrity-запись на новую 1-в-1 по длине
  5. Считаешь sha256 нового json-хедера — это новый header-hash
  6. Вписываешь его в PE-ресурс exe (INTEGRITY / ELECTRONASAR)
  7. Бекапы app.asar.bak + Prog.exe.bak — до любых правок, без исключений

Три грабли:

  • Ложные совпадения — ищи сигнатуру только внутри диапазона конкретного файла, не по всему архиву
  • Порядок ключей в integrity — длина замены обязана совпасть, проверяй assert'ом
  • Вторая подпись — JWT от издателя рядом не трогай, локальный рантайм её не проверяет

Часть 8. Автоматизация: патчер-скрипт

Руками — один раз интересно, после каждой обновы проги — обязательно (апдейт перезаписывает asar и exe). Поэтому цикл упаковывается в скрипт на чистом питоне:

Код:
найти установку → убить процессы → бекапы .bak →
для каждого файла: найти диапазон → найти сигнатуры →
заменить in-place → пересчитать integrity →
обновить хедер → посчитать header-hash → вшить в exe →
готово

Зависимостей ноль: struct, json, hashlib, ctypes. Если сигнатуры не найдутся — скрипт честно скажет «версия не поддерживается».

Часть 9. Что ещё можно крутить

  • preload.js — мост main↔renderer, карта всех IPC-каналов. Читай первым
  • Фиче-флаги — isBeta, isDev, скрытые меню. Ищи __DEV__, debug, internal, unleash
  • Автообновление — app-update.yml рядом с asar, там URL апдейт-сервера
  • LevelDB в Roaming — токены, сессии, кэши. Читать можно, править осторожно

Часть 10. Этика и риски

Разбирать для учёбы — нормально. Бесплатный патчер — максимум DMCA и снос темы. Акки под мод-клиентом держи одноразовые. Токены и пароли в открытые чаты не кидай никогда. Патчеры протухают после обнов — отслеживай версии.

Удачи в реверсе. Вопросы — в комменты, конкретные кейсы разберём вместе.

Практический пример по этому гайду — патчер Hone: тык
 1
 
Последнее редактирование:
  • 1
Реакции: 1 user
Активность:
Пока что здесь никого нет