Sentinel LDK Envelope & API

• 1 Методы защиты программ при помощи системы защиты Sentinel LDK
• 2 Envelope API для .Net & Java
• 3 Envelope.com - Что? Как? и Зачем?
• 4 Защита ПО на терминальном сервере
• 5 Можно ли автоматизировать защиту Sentinel LDK Envelope?
• 6 Ошибка "Required assembly...could not be found"
• 7 Ошибка "HASP_NO_API_DYLIB" и "HASP_INV_VCODE"
• 8 Ошибка "...haspdnert.dll is too old(E0001)"
• 9 Как защитить документы (аудио, видео или текстовые файлы) с помощью ключей Sentinel (HASP)?
• 10 Как переопределить сообщения об ошибках, выдаваемых защищённым ПО?
• 11 Ошибки "HASP_NO_VLIB = 48", "HASP_INV_VLIB = 49" и "HASP_OLD_VLIB = 56"
• 12 Защита приложений под ARM
• 13 Как защитить ПО на КОНКРЕТНЫЙ ключ?
• 13.1 ==
• 13.2 ==
• 14 Что такое Vendor код? Что даёт злоумышленнику знание Vendor кода?
• 15 Какие существуют способы защиты конфигураций на платформе 1С: Предприятие версий 7.7 / 8.х?
• 16 Какие параметры входят в Fingerprint, собираемый с компьютера при установке Sentinel (HASP) SL?
• 17 Как узнать, к каким аппаратным характеристикам ПК привязан установленный Sentinel (HASP) SL ключ?

Методы защиты программ при помощи системы защиты Sentinel LDK

При защите с помощью Sentinel LDK Licensing API разработчик самостоятельно может в коде своего приложения переопределить выдаваемые сообщения об ошибках.

При защите с помощью Sentinel LDK Envelope задать свои сообщения об ошибках можно на вкладке "User Messages". Можно один раз переопределить все необходимые коды ошибок и затем сохранить результат, используя кнопку "Export...". Получившийся файл с расширением "*.msgx" в будущем можно загружать в любой проект защиты в Sentinel LDK Envelope, используя кнопку "Import...".

Ошибки "HASP_NO_VLIB = 48", "HASP_INV_VLIB = 49" и "HASP_OLD_VLIB = 56"

Для работы программных Sentinel (HASP) SL ключей с защищённым ПО требуется дополнительная кастомизированная библиотека Sentinel LDK API вида "haspvlib_* Vendor_ID*.dll".

Данная библиотека попадает на ПК пользователя несколькими путями, простейший из них:

В Sentinel LDK EMS -> "Developer" -> "RTE Installer" -> необходимо выбрать код разработчика и нажать кнопку "Generate" -> .

В результате генерируется консольная версия драйвера с включенной в него библиотекой "haspvlib_* Vendor_ID*.dll". После установки такого драйвера на ПК пользователя защищённое приложение сможет работать с программными Sentinel (HASP) SL ключами.

• Ошибка "HASP_NO_VLIB = 48" говорит о том, что на ПК пользователя нет требуемой "haspvlib_*ваш_Vendor_ID*.dll" библиотеки.
• Ошибка "HASP_INV_VLIB = 49" говорит о том, что на ПК пользователя нет целостной, актуальной "haspvlib_*ваш_Vendor_ID*.dll" библиотеки.
• Ошибка "HASP_OLD_VLIB = 56" говорит о том, что на ПК пользователя есть "haspvlib_*ваш_Vendor_ID*.dll" библиотека, но её версия сильно устарела и необходимо обновить данную библиотеку.

Получить свежую версию библиотеки "haspvlib_* Vendor_ID*.dll" можно путём проведения процедуры представления Sentinel (HASP) HL Master ключа на своём ПК с установленным комплектом разработчика. Требуемая библиотека будет загружена в директорию "C:\Program Files\Common Files\Aladdin Shared\HASP\".

На ПК с защищённым ПО библиотека "haspvlib_* Vendor_ID*.dll" должна располагаться:

1. Если на ПК используются программные ключи типа SL-AdminMode, либо SL-Legacy, то в директории "C:\Program Files\Common Files\Aladdin Shared\HASP\";
2. Если на ПК используются программные ключи типа SL-UserMode, то в директории с защищённым ПО и файлом портативного менеджера лицензий "hasp_rt.exe".

Защита приложений под ARM

Система защиты Sentinel LDK (SRM) поддерживает защиту приложений под ARM.

Стандартный, актуальный комплект разработчика Sentinel LDK уже содержит средства защиты программ под ARM.

Как защитить ПО на КОНКРЕТНЫЙ ключ?

Все модели ключей, кроме Sentinel (HASP) HL Basic, имеют уникальные 32-битные ID.

При защите с помощью Sentinel LDK Licensing API для привязки экземпляра защищённого ПО к конкретному ключу можно использовать функцию hasp_login_scope.

При защите через Sentinel LDK Envelope на вкладке "Advanced" есть параметр "Enable Custom Protection Key Login Scope". Необходимо его активировать и в окне ниже ввести XML структуру следующего вида:

==

<?xml version="1.0" encoding="UTF-8" ?>

<haspscope>

<hasp id="ххххххх" />

</haspscope>

==

Где "ххххххх" - ID ключа, к которому требуется привязать конкретный экземпляр защищённого приложения.

В данном поле можно задать любой фильтр поиска ключа для логина, примеры XML шаблонов фильтров поиска можно посмотреть в утилите Sentinel LDK Toolbox из комплекта разработчика.

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

Что такое Vendor код? Что даёт злоумышленнику знание Vendor кода?

Vendor код – уникальная строка, в которой хранятся в зашифрованном виде секретные ключи для каждой серии разработчика, необходимые для работы с ключами защиты через функции Sentinel LDK Licensing API.

Знание Vendor кода даёт хакеру возможность легче детектировать точки входа в функции Sentinel LDK Licensing API, с помощью которых производятся обращения к ключу, так как Vendor код передаётся как один из параметров при вызове, к примеру, функции логина в ключ.

Поэтому мы не рекомендуем хранить Vendor код в открытом виде (например в конфиг файле защищаемого приложения).

Какие существуют способы защиты конфигураций на платформе 1С: Предприятие версий 7.7 / 8.х?

Для защиты 1С конфигураций возможны следующие варианты:

1. Необходимо часть логики 1С конфигурации вынести во внешнюю DLL библиотеку. Такую библиотеку можно будет защитить с помощью Sentinel LDK Envelope, либо с помощью Sentinel LDK Licensing API.
2. Можно использовать стороннее решение Wise Advice для защиты 1С конфигураций, построенное на базе Sentinel LDK Licensing API. Подробности можно уточнить у разработчиков данного решения.

Какие параметры входят в Fingerprint, собираемый с компьютера при установке Sentinel (HASP) SL?

В Fingerprint входят информация об аппаратных характеристиках ПК, например: CPU ID, Motherboard ID, HDD ID, Ethernet UID и т.д.

Для расшифровки C2V c Fingerprint используется функция sntl_lg_decode_current_state из Sentinel LDK License Generation API.

Пример расшифрованного Fingerprint:

<?xml version="1.0" encoding="utf-8"?>

<sentinel_ldk_info>

<key>

<type>SL-AdminMode</type>

<configuration_info>

<system_fingerprint>

<fingerprint_info>

<criteria>

<name>cpu</name>

<value>2940756505</value>

</criteria>

<criteria>

<name>cpu</name>

<value>2940756505</value>

</criteria>

<criteria>

<name>mainboard</name>

<value>784958864</value>

</criteria>

<criteria>

<name>mainboard_uid</name>

<value>1047497330</value>

</criteria>

<criteria>

<name>hdd</name>

<value>635259119</value>

</criteria>

<criteria>

<name>optical_drive</name>

<value>2112966545</value>

</criteria>

<criteria>

<name>ethernet_uid</name>

<value>3138813999</value>

</criteria>

<criteria>

<name>vm_info</name>

<value>1927478231</value>

</criteria>

<criteria>

<name>secure_storage_uid</name>

<value>2713919246</value>

</criteria>

<criteria>

<name>computer_name</name>

<value>928116403</value>

</criteria>

<criteria>

<name>domain_name</name>

<value>3175731470</value>

</criteria>

<criteria>

<name>pci_storage_ide</name>

<value>1654369457</value>

</criteria>

<criteria>

<name>pci_storage_serial_scsi</name>

<value>2734835677</value>

</criteria>

<criteria>

<name>pci_display_vga</name>

<value>1424666256</value>

</criteria>

<criteria>

<name>pci_multimedia_hd_audio</name>

<value>2402293240</value>

</criteria>

</fingerprint_info>

</system_fingerprint>

</configuration_info>

</key>

<key>

<type>SL-UserMode</type>

<vendor>

<id>110659</id>

</vendor>

<configuration_info>

<system_fingerprint>

<fingerprint_info>

<criteria>

<name>cpu</name>

<value>2940756505</value>

</criteria>

<criteria>

<name>cpu</name>

<value>2940756505</value>

</criteria>

<criteria>

<name>mainboard</name>

<value>1253465720</value>

</criteria>

<criteria>

<name>mainboard_uid</name>

<value>1047497330</value>

</criteria>

<criteria>

<name>hdd</name>

<value>635259119</value>

</criteria>

<criteria>

<name>optical_drive</name>

<value>2112966545</value>

</criteria>

<criteria>

<name>ethernet_uid</name>

<value>3138813999</value>

</criteria>

<criteria>

<name>vm_info</name>

<value>1927478231</value>

</criteria>

<criteria>

<name>secure_storage_uid</name>

<value>1611978419</value>

</criteria>

<criteria>

<name>computer_name</name>

<value>928116403</value>

</criteria>

<criteria>

<name>domain_name</name>

<value>3175731470</value>

</criteria>

</fingerprint_info>

</system_fingerprint>

</configuration_info>

</key>

</sentinel_ldk_info>

Как узнать, к каким аппаратным характеристикам ПК привязан установленный Sentinel (HASP) SL ключ?

Привязка Sentinel (HASP) SL ключа к аппаратным характеристикам ПК зависит от типа машины: виртуальная или физическая, а также от схемы параметров привязки, выбранной при генерации программных ключей, см. "Ошибка SL Clone detected".