К содержанию
Happ-VPN

Как проверить подлинность APK Happ: контрольная сумма и подпись

Установка

Актуально на

4 мин чтения

Чтобы проверить Happ.apk, посчитайте SHA-256 файла (certutil на Windows, shasum на macOS, sha256sum на Linux) и сравните со строкой sha256 рядом с файлом на странице релиза GitHub. Затем командой apksigner сверьте сертификат подписи: у новой версии он должен совпадать с сертификатом уже установленной.

Короткая версия проверки есть на странице Happ APK. Здесь та же процедура подробнее: с командами для трёх систем, примерами вывода и проверкой подписи. Проверка нужна, если файл пришёл не прямо с GitHub: от знакомого, из облака, с флешки или из чата.

Коротко: порядок проверки

  1. 1

    Найдите эталонную сумму

    Откройте релиз в репозитории Happ-proxy/happ-android на GitHub и найдите строку sha256 рядом с файлом Happ.apk.

  2. 2

    Посчитайте SHA-256 своего файла

    На Windows выполните certutil -hashfile Happ.apk SHA256, на macOS shasum -a 256 Happ.apk, на Linux sha256sum Happ.apk.

  3. 3

    Сравните строки

    Сумма должна совпасть полностью, до последнего символа. Любое расхождение означает другой файл.

  4. 4

    Проверьте подпись

    Выполните apksigner verify --print-certs Happ.apk и сравните сертификат с тем, что у установленной версии.

  5. 5

    Установите файл

    Если всё совпало, установите APK. Если нет, удалите файл и скачайте его заново из релиза разработчика.

Зачем проверять APK

APK из случайного источника может оказаться изменённым: внутри такого файла может быть чужой код, а выглядеть он будет как обычный Happ. Две проверки снижают этот риск. SHA-256 показывает, что файл совпадает с лежащим в релизе, а сертификат подписи показывает, что приложение подписано тем же ключом, что и уже установленное.

Отдельных файлов контрольных сумм и подписей разработчик к релизам не прикладывает. Сумму SHA-256 показывает сам GitHub в списке файлов релиза. Это данные платформы, но сверяться с ними можно.

Шаг 1. Найдите эталонную SHA-256 на GitHub

Откройте страницу релиза в репозитории Happ-proxy/happ-android, раскройте список файлов (Assets). Рядом с Happ.apk GitHub показывает строку, начинающуюся с sha256:, дальше идёт 64 символа. Скопируйте её или оставьте вкладку открытой.

Берите сумму именно для той версии, которую вы скачали. Если вы скачали Happ.apk по ссылке releases/latest, ориентируйтесь на последний стабильный релиз. Тестовый Happ_beta.apk имеет свою сумму.

Шаг 2. Посчитайте SHA-256 файла на компьютере

Скачайте файл на компьютер или перенесите его туда с телефона, затем откройте терминал в папке с файлом.

Как проверить SHA-256 на Windows

В PowerShell или в командной строке:

certutil -hashfile Happ.apk SHA256

Вывод выглядит так (хеш условный, сокращён):

SHA256 hash of Happ.apk:
a8cb…
CertUtil: -hashfile command completed successfully.

Как проверить SHA-256 на macOS

В Терминале:

shasum -a 256 Happ.apk

Вывод: хеш, два пробела и имя файла.

a8cb…  Happ.apk

Как проверить SHA-256 на Linux

sha256sum Happ.apk

Вывод такой же, как на macOS: a8cb… Happ.apk.

Шаг 3. Сравните суммы

Сумма вашего файла должна совпасть со строкой sha256: на GitHub полностью, символ в символ. Регистр букв роли не играет: certutil и GitHub могут писать буквы по-разному, значение при этом одно.

РезультатЧто значитЧто делать
Совпала полностьюфайл тот же, что в релизепереходите к проверке подписи или устанавливайте
Отличается хотя бы один символфайл другой или повреждёнудалите, скачайте заново с GitHub, сравните снова
Отличается и после повторной загрузкивероятно, вы смотрите сумму не от той версииубедитесь, что открыт тот же релиз, из которого скачан файл

Шаг 4. Проверьте сертификат подписи через apksigner

Каждый APK подписан сертификатом разработчика. Проверку делает инструмент apksigner из Android SDK Build-Tools. Он ставится вместе с Android SDK и лежит в папке build-tools нужной версии.

apksigner verify --print-certs Happ.apk

В ответе будут данные сертификата. Вывод условный:

Signer #1 certificate DN: …
Signer #1 certificate SHA-256 digest: 5f2e…

Что делать с результатом: сертификат новой версии должен совпадать с сертификатом уже установленной. Если вы ставите Happ первый раз, сравнивать пока не с чем: сохраните значение для будущих обновлений. Если у вас уже стоит Happ, выполните ту же команду для вашей копии файла и сравните строки certificate SHA-256 digest. Android и сам не даст обновить приложение поверх установленного, если подписи разные: появится ошибка установки.

Это второй, дополнительный шаг. Для большинства случаев хватает сверки SHA-256, а подпись проверяют, когда файл попал к вам окольным путём.

Play Защита и предупреждения Android

Когда вы открываете APK не из Google Play, система спрашивает разрешение для приложения, из которого файл открыт, а Play Защита может предложить проверить установку. Это нормальная реакция Android на любой файл вне магазина. Она не доказывает, что Happ.apk подделан, и не доказывает обратного. Решает ваша сверка суммы.

После установки отключите разрешение на установку неизвестных приложений для браузера или файлового менеджера, через которые открывали файл.

Частые ошибки при проверке

СимптомПричинаРешение
«certutil не является внутренней командой»команда запущена не в Windowsиспользуйте shasum на macOS или sha256sum на Linux
«No such file or directory»терминал открыт не в той папкеперейдите в папку с файлом или укажите полный путь
Сумма не совпаладругая версия, неполная загрузка или чужой файлскачайте файл заново из нужного релиза
«apksigner: command not found»Android SDK Build-Tools не установлены или не в PATHустановите Build-Tools или запустите apksigner по полному пути

Где лежит файл и как его правильно установить, написано на странице Happ на Android, а все ссылки на репозитории разработчика собраны на странице Happ на GitHub. После установки переходите к статье как настроить Happ на Android.

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

Есть ли у Happ отдельные файлы с контрольными суммами?

Нет. В релизах разработчика нет отдельных файлов контрольных сумм и подписей. Сумму SHA-256 показывает сам GitHub рядом с каждым файлом релиза. Это данные платформы, а не отдельное заявление разработчика, но для сверки файла с тем, что лежит в релизе, этого достаточно.

Что делать, если SHA-256 не совпала?

Не устанавливайте файл. Скорее всего, он скачался не полностью или это другой файл. Удалите его и скачайте Happ.apk заново прямо со страницы релиза Happ-proxy/happ-android. Если сумма снова не совпала, не пользуйтесь файлом и напишите в поддержку сервиса, у которого берёте подписку.

Достаточно ли одной проверки SHA-256?

Сумма доказывает, что ваш файл совпадает с лежащим на GitHub, но не сообщает, кто его подписал. Проверка подписи через apksigner добавляет второй уровень: при обновлении сертификат должен совпадать с уже установленной версией. Лучше сделать обе проверки, если файл пришёл не напрямую с GitHub.

Что говорит Play Защита об APK не из магазина?

Play Защита может показать предупреждение или предложить проверить приложение, потому что файл поставлен не из Google Play. Само по себе предупреждение не значит, что файл поддельный. Сначала сверьте SHA-256 с релизом на GitHub, а решение об установке принимайте по результату проверки.

Источники

  1. Релизы Happ для Android — GitHub Happ-proxy/happ-android
  2. Документация Happ: страница загрузки

Happ установлен — осталось подключить серверы

Подписка — это ссылка со списком серверов, которую вы один раз добавляете в Happ. Начать можно с пробного доступа на 1 день, дальше — от 290 ₽ в месяц за устройство.

Опубликовано . Автор — редакция сайта.