Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Утилита grdarmor.exe поставляется в составе Guardant SDK (версии не ниже 7 Update 3) и является консольной. Запустить grdarmor.exe можно через стандартную командную строку, Windows Power Shell или при помощи заранее подготовленных пакетных файлов (*.BAT, *.CMD).

 

При работе с утилитой можно применять различные опции и параметры:

...

Внимание!

  • Нельзя выполнять защиту файлов, которые ранее уже были защищены другими протекторами, в том числе

...

  • утилитами

...

  • автозащиты Guardant.

Важно!

...

  • Для того чтобы выполнить защиту

...

  • приложения, необходимо при его сборке включать опцию

...

  • генерации MAP-файла, а при защите использовать опцию “-MAP=”.

...

  • Опция режима работы конверта “-ENVELOPE_MODE=”

...

  • должна быть задана всегда .

 

При работе с утилитой можно применять различные опции и параметры:

Схема 1Схема 2

grdarmor.exe <опции защиты>

___________<опции поиска ключа> <модель ключа>[=<параметры привязки>]

___________<опции защиты файлов> [<файл 1>] ...[<файл N>]

grdarmor.exe <опции защиты>

___________<опции поиска ключа> <модель ключа>[=<параметры привязки>]

___________<опции защиты файлов> [<файл 1>] [<файл 2>]

___________<опции поиска ключа> <модель ключа>[=<параметры привязки>]

___________<опции защиты файлов> [<файл 3>] [<файл 4>]

...

N

Номер алгоритма ключа (GSII64 или AES)

L

Длина вопроса к алгоритму

ID

ID ключа, на котором будет происходить защита

S

Номер алгоритма ECC160

<файл ключа>

Путь к файлу с открытым ключом ECC160



Пример:

  1. grdarmor.exe -ENVELOPE_MODE=H:5:16 -GS3S=0:16 -OUT=./result -PRC=clock.prc -MAP=Clock.map Clock.exe
    Защищенное приложение Clock.exe будет запускаться в случае, если к компьютеру подсоединен ключ Guardant Sign\Time с симметричными алгоритмами #0 и #5, а длина вопроса 16.
  1. Код для защиты указан в файле clock.prc, а защищенный исполняемый файл будет помещен в подкаталог result.

  2. grdarmor.exe -ENVELOPE_MODE=S -GC=0:16 -GS3S=0:16 -OUT=./result -INI=Clock.ini -MAP=Clock.map Clock.exe
    Защищенное приложение Clock.exe будет запускаться в случае, если к компьютеру подсоединен ключ Guardant Sign\Time или Code\Code Time с симметричным алгоритмом #0 и длинной вопроса 16. Режим работы конверта программный. Для различных моделей аппаратных ключей можно использовать алгоритмы с разными номерами (числовыми именами).

  

Важно!

Привязать одно приложение к разным моделям электронных ключей возможно только в программном режиме работы конверта

“-ENVELOPE_MODE=S ”.


На SДля указания функций и участков кода, которые будут защищаться, на вход утилита grdarmor.exe может принимать 2 вида конфигурационных файлов - PRC или INI.типа конфигурационных файлов для указания функций и участков кода, которые нужно защитить:

  • PRC – файл с расширением *.prc создается в результате обработки защищаемого приложения приложения утилитой профилирования. Сформированный ранее PRC-файл Его можно позже открыть и отредактировать при помощи утилиты профилирования. При защите измененного приложения (например, новая версия, в которой добавлены новые функции и\или переработаны существующие функции) можно воспользоваться «старым» PRC-файлом, но в таком случае защитятся только защитятся только те функции, hash которых не изменилсякоторых не изменился.
  • INI – файл с расширением *.ini создается разработчиком вручную, где на отдельных строках сначала указывается опция включения\исключения (+p\-p) и через пробел имя функции со всеми искажениями из MAP-файла.:
    +p <имя функции>
    -p <имя функции>

Пример:

  1. +p ?OnPaint@CWnd@Win32xx@@MAEJIIJ@Z
  2. -p ?OnTimer@CDlgMain@@MAEJIIJ@Z

 

При повторном использовании INI-файла будет произведена попытка защиты всех указанных функций, вне зависимости от того, менялся их hash или нет.