Versions Compared

Key

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

...

Excerpt

Установка ключей Guardant в операционных системах GNU/Linux

Ключи Guardant работают в OC GNU/Linux (в том числе и в HID-режиме) без установки дополнительных драйверов и демонов, требуя лишь обеспечить имя и разрешение доступа к файлу устройства. Для обращения к ключу используются соответственно Linux USB Device Filesystem или Linux USB HID Device Interface (в случае HID-режима).

Для работы с ключами в ОС GNU/Linux необходимо добавить правило для штатного средства обработки HotPlugging. На большинстве современных дистрибутивов, таким средством является udev (https://ru.wikipedia.org/wiki/Udev). В комплект разработчика включен набор правил для udev (архив udev-rules.tar.gz ). Указанные правила предписывает udev установить права на чтение и запись для файла устройства, представляющего электронный ключ Guardant в системе. Это позволяет обращаться к ключу с привилегиями любого пользователя системы.

UI Text Box
typeinfo

Внимание!

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

Anchor
udev
udev

Установка правил для udev

Для ключей как в драйверном, так и в HID-режиме, и в случае использования файлов-устройств USB Device Filesystem.

Скачать архив udev-rules.tar.gz , распаковать и выполнить установку правил:


No Format
$ tar -xvf udev-rules.tar.gz
$ ./install.sh

После успешной установки правил нужно отсоединить электронный ключ от USB-порта и подсоединить повторно.

Ключ готов к работе с защищенным Linux-приложением.

Anchor
devices
devices

Имена и доступ к устройствам

Expand

Для ключей, работающих в драйверном режиме

Обращение к ключу происходит через Linux USB Device Filesystem. Подробную информацию см. в файле linux/Documentation/usb/proc_usb_info.txt из документации к Linux. Для успешной работы с ключом в системе нужно разрешить доступ на чтение/запись к файлу устройства.

Для ключей, работающих в HID-режиме

Обращение к ключу происходит через Linux USB HID Device Interface (драйвер usbhid). Подробную информацию см. в файле linux/Documentation/usb/hiddev.txt из документации к Linux. Для успешной работы с ключом в системе нужно изменить имена соответствующих устройств на /dev/grdhidN и разрешить доступ на чтение/запись к файлу устройства.

Anchor
_Toc260939214
_Toc260939214
Anchor
_Toc326167609
_Toc326167609
Переменные окружения

Для настройки Guardant API под GNU/Linux следует пользоваться следующими переменными окружения:

GRD_IPC_NAME

директория, в которой процессы будут создавать/открывать для чтения и записи файлы, используемые для синхронизации доступа к ключу. Если переменная не задана, используется значение по умолчанию (/tmp)

USB_DEVFS_PATH

директория LinuxUSBDeviceFilesystem (точка монтирования или директория, содержащая дерево соответствующих устройств).
Если переменная не задана, будет использоваться /dev/bus/usb (если существует), иначе – /proc/bus/usb

...

Для работы приложений Windows, защищённых ключами Guardant Sign/Time и Guardant Code под Wine (www.winehq.org), необходима библиотека grdwine.dll.so. Для этого в комплект разработчика включен проект библиотеки для Wine — grdwine, распространяемый под свободной лицензией GNU Lesser General Public License version 2.1 (поставляется в двух вариантах - в виде скомпилированных библиотек grdwine-0.5.57-bin.tar.gz и в виде пакета с исходными текстами – grdwine-0.5.57.tar.gz).

UI Text Box
typewarning

Важно!
Рекомендуемая к использованию версия Wine — 1.x.x. Корректная работа с более ранними версиями Wine не гарантируется. Загрузить последнюю версию Wine можно по адресу: https://www.winehq.org/download

...

Имеется два варианта установки библиотеки grdwine.dll.so под Wine: установка скомпилированных библиотек из grdwine-0.5.57-bin.tar.gz и компиляция библиотек из исходных текстов и их последующая установка из grdwine-0.5.57.tar.gz.

Установка скомпилированных библиотек

...

2. Распаковать архив grdwine-0.5.57-bin.tar.gz и перейти в распакованную директорию

No Format
Пример:
$ tar -xvf grdwine-0.5.57-bin.tar.gz
$ cd grdwine-0.5.57-bin

3. Перейти в распакованную директорию и запустить скрипт install.sh c правами администратора

No Format
Пример:
$ sudo ./install.sh x86 /usr/lib/i386-linux-gnu/wine
$ sudo ./install.sh x64 /usr/lib/x86_64-linux-gnu/wine

Первый из параметров скрипта install.sh указывает на разрядность устанавливаемой библиотеки После того как библиотека grdwine.dll.so распакована, необходимо перенести ее версию нужной разрядности в директорию с защищенным приложением ("x86" необходима для работы 32-битных windows-приложений, а "x64x86_64" - для работы 64-битных windows-приложений соответственно). Второй параметр - путь установки библиотеки
Затем файл библиотеки необходимо переименовать изменив расширение с grdwine.dll.so - должен указывать на место расположения в системе библиотек wine соответствующих разрядности, заданной первым параметром.
То есть, например, если требуется обеспечить работу 64-битных windows-приложений, то необходимо установить 64-битную grdwine.dll.so и первым параметром install.sh нужно передавать "x64", а вторым - путь к 64-битным библиотекам wine в системе (например, /usr/lib/x86_64-linux-gnu/wine).
Пути расположения библиотек wine в системе можно узнать, выяснив расположение библиотек kernel32.dll.so. Необходимо выбрать пути к библиотекам в соответствии с используемой версией wine.

No Format
Пример:
$ sudo find / -name kernel32.dll.so
UI Text Box
typeinfo

Внимание!

В системе может быть установлено несколько версий wine и, соответственно, несколько копий библиотеки kernel32.dll.so

 на grdwine.dll.

No Format
Пример:
$ cp ./grdwine-0.5.7-bin/x86/grdwine.dll.so /home/user/samples/
/home/user/samples/ - путь к директории с защищенным приложением
$ mv /home/user/samples/grdwine.dll.so /home/user/samples/grdwine.dll


Компиляция библиотек Компиляция библиотек из исходных текстов и их последующая установка

...

Скачать и распаковать пакет с исходными текстами grdwine-0.5.57.tar.gz :

No Format
$ tar -xvf grdwine-0.5.57.tar.gz
$ cd grdwine-0.5.57

Запустить ./bootstrap.sh

No Format
$ ./bootstrap.sh

...