Инструменты пользователя

Версия драйвера: 7.0.215 от 29.07.2020, WHQL-certified
Драйверы электронных ключей требуются для нормальной работы защищенного приложения. Они выступают своего рода «проводником» между программой и аппаратной частью защиты (ключом). Поэтому после инсталляции защищенной программы следует убедиться, что драйверы Guardant также установлены и работают корректно.

Все модели электронных ключей Guardant
32- и 64-разрядные редакции MS Windows начиная с Windows XP
Драйверы Guardant 7.0.206
Драйверы Guardant, MSI, x86

Версия 7.0.215 от 29.07.2020
Установочные файлы предназначены для централизованной установки драйверов Guardant в сетях Windows при помощи групповых политик.

Все модели электронных ключей Guardant
32-разрядные редакции MS Windows начиная с Windows XP
Драйверы Guardant 7.0.206, MSI, x86
Драйверы Guardant, MSI, x64

Версия 7.0.215 от 29.07.2020
Установочные файлы предназначены для централизованной установки драйверов Guardant в сетях Windows при помощи групповых политик.

Все модели электронных ключей Guardant
64-разрядные редакции MS Windows начиная с Windows XP
Драйверы Guardant 7.0.206, MSI, x64
Мероприятия

Конференция
15 сентября 2023 года
Москва, 2-й Кожуховский проезд, 29к6

Эксперт Guardant примет участие в инженерном фестивале KOMPAScon — ежегодной встрече сообщества пользователей системы проектирования КОМПАС-3D.

11 июля 2023 года
Мероприятие завершено

Мы запускаем серию онлайн-встреч Guardant TechClub — практического сообщества пользователей продуктов Guardant.

22 марта 2023 года
Мероприятие завершено

Компания «Актив» приглашает на бесплатный вебинар «Эффективная монетизация ПО с помощью решений Guardant». На встрече мы поговорим о том, как выстроить в компании сложный бизнес-процесс монетизации, и как профессиональные решения Guardant могут поддержать и оптимизировать его. Мы также продемонстрируем на практике, как комплексные решения Guardant могут помочь разработчикам ПО.

14 декабря 2022 года
Мероприятие завершено

Компания «Актив» приглашает на бесплатный вебинар «Guardant. Итоги 2022 года. Развитие продуктов и функционала в 2023 году». На встрече вы узнаете о стратегических планах по развитию отдельных продуктов и платформы Guardant в целом в следующем году.

4 октября 2022 года
Мероприятие завершено

Ассоциация Интернета Вещей (АИВ) и Компания «Актив» организуют круглый стол «Информационная безопасность в современной инфраструктуре IoT» профессионалов российского рынка IoT. Встреча состоится в офлайн формате.

23 августа 2022 года
Мероприятие завершено

Компания «Актив» приглашает на бесплатный вебинар бизнес-направления Guardant, на котором будут рассмотрены преимущества, недостатки и перспективы семейства аппаратных ключей Stealth II и Net II с учетом современных реалий.

12 июля 2022 года
Мероприятие завершено

Компания «Актив» приглашает на бесплатный вебинар «Новые возможности Guardant. Релиз 3.0». Слушателям будут представлены новые возможности инструментов в составе решений для лицензирования и защиты ПО Guardant. Спикеры вебинара расскажут о новых функциях программных ключей и их оптимальном использовании для пользы бизнеса в нынешних реалиях.

12 апреля 2022 года
Мероприятие завершено

Ассоциация разработчиков программных продуктов «Отечественный софт» запустила серию вебинаров, посвященных обзору российских решений для ускоренного импортозамещения.

22 марта 2022 года
Мероприятие завершено

Компания «Актив» приглашает на бесплатный вебинар «Новое поколение программных ключей Guardant DL». На встрече вы узнаете о принципиально новых возможностях продукта, позволяющих ему стать наиболее востребованным на сегодняшний день решением для контроля распространения ПО, продаваемого через Интернет.

Для чего вообще нужны драйверы Guardant?

Пункт первый. Современные ОС поддерживают HID режим. Драйверы, то есть, не нужны.
Пункт второй. Guardant много лет назад как отказался от поддержки «несовременных» ОС.

Вопрос: для чего Guardant предлагает драйверы?
Только для совместимости со старыми конфигурациями защиты? Или реим драйвера имеет какие-то необыкновенные преимущества перед HID режимом?
Вроде бы HID режим в некоторых случаях чуть помедленнее режима «с драйверами». Я пока не проверял, насколько.

В режиме драйвера, как пишут в соседних темах, может происходить крах ОС.
Например, несколько наши клиентов безвозвратно потеряли важные данные при установке драйвера на Win11. Компьютер переходит в режим бесконечной перезагрузки, и . и всё

Озвученное предложение «отключать изоляцию ядра» — это, извините, предложение уровня мамкиных хакеров при попытке взломать старую пиратскую игрушку. Это ВАШЕ устройство и ВАШ софт. Проблема возникла не сегодня и не вчера, «отключить изоляцию ядра» — это не ответ, это позор.
Ваш разработчик драйвера не может повторить аварийную ситуацию? Неужели ваши клиенты всякий раз отказывали ему в физическом доступе к своей «глючной» конфигурациям? Обратитесь к нам.
.
. ОК, т.к. ждать от Guardant решения в разумные сроки традиционно не приходится, пробуем работать только в HID режиме.

HID режим. Вопрос: какими подводными камнями грозит перевод всех клиентов на работу в HID режиме?
Ну, кроме головной боли из-за самого процесса (отзыв ключей для перепрошивки/регистрации, переписание инсталлятора, работа со старыми клиентами и т.д.).
Может, в каких-то случаях HID режим вообще неприемлем/недоступен/нестабилен, а мы об этом не знаем? Расскажите, пожалуйста.
Спасибо.

#2 Ответ от teamru 2023-08-28 10:56:57

Re: Для чего вообще нужны драйверы Guardant?

Из нашего опыта работы с ключами Guardant. В режиме записи как HID в Guardant Station некоторые ключи несколько раз в сутки могли выдавать 34 код ошибки. В других режимах эти же ключи работали стабильно.

#3 Ответ от vlad-mal 2023-08-30 14:17:45

Re: Для чего вообще нужны драйверы Guardant?

teamru пишет:

Из нашего опыта работы с ключами Guardant. В режиме записи как HID в Guardant Station некоторые ключи несколько раз в сутки могли выдавать 34 код ошибки. В других режимах эти же ключи работали стабильно.

То есть, GrdE_AlgoNotFound?
О, Господи.
.
Ну, будем разгребать кучи по мере их появления. Guardant Station мы не используем, и ее планируем использовать. Возможно, обойдется.
Спасибо.

#4 Ответ от teamru 2023-08-31 07:25:50 (2023-08-31 07:29:09 отредактировано teamru)

Re: Для чего вообще нужны драйверы Guardant?

vlad-mal пишет:

Для Guardant Station коды возвратов отличаются, в нашем случае это NO_RESULTS_FOUND. Случается не часто, но приходится иметь ввиду и с первой ошибки получения лицензии не рубануть функционал клиентам. Возможно, это касается только SLK от Guardant Station и на SDK возможно, таких проблем нет.

Драйвера, в нашем случае, тоже иногда приходится использовать, потому что Guardant Station по дефолту каждый раз предлагает писать ключи в режиме WinUSB. Если вдруг кто-то при записи ключа забудет переткнуть на режим HID, то получится ключ который не будет работать на Windows 7 без установки драйверов.

#5 Ответ от vlad-mal 2023-09-13 22:52:55

Re: Для чего вообще нужны драйверы Guardant?

teamru пишет:
vlad-mal пишет:

Для Guardant Station коды возвратов отличаются, в нашем случае это NO_RESULTS_FOUND. Случается не часто, но приходится иметь ввиду и с первой ошибки получения лицензии не рубануть функционал клиентам. Возможно, это касается только SLK от Guardant Station и на SDK возможно, таких проблем нет.
.

teamru пишет:
vlad-mal пишет:

.
Драйвера, в нашем случае, тоже иногда приходится использовать, потому что Guardant Station по дефолту каждый раз предлагает писать ключи в режиме WinUSB. Если вдруг кто-то при записи ключа забудет переткнуть на режим HID, то получится ключ который не будет работать на Windows 7 без установки драйверов.

Ну, с этим у нас проблем нет: ключи мы инициализируем собственной утилитой.

#6 Ответ от Антон Тихиенко 2023-09-15 17:34:11

• Антон Тихиенко
• Администратор
• Неактивен

Re: Для чего вообще нужны драйверы Guardant?

Здравствуйте!
vlad-mal, прошу прощения что задержались с нашим ответом!

vlad-mal пишет:

Вопрос: для чего Guardant предлагает драйверы?

Исторически драйверный режим работы был первым и когда-то единственным. Причем тут речь не только и не столько про ключи Guardant, а в целом про устройства периферии для ПК.

В районе 2008 года у нас появились ключи с поддержкой «бездрайверного» HID-режима.
Итого, за предыдущие 17 лет работы, Guardant накопил базу клиентов и пользователей с ключами, способными работать только через наш проприетарный драйвер и количество таких ключей отнюдь не уменьшалось со скоростью света. Только год назад мы начали процесс постепенного сворачивания производства последнего поколения ключей, которые могут работать только через драйвер (тут про это поподробнее: https://youtu.be/ofGSxTgQB1s?si=zMCZvlVSMD4vfLO9 ).

Соответственно поддержка пользователей устаревших ключей и сейчас остается причиной присутствия драйвера на нашем сайте.

Есть и еще одна причина, это производственный процесс, который сложно менять. Суть тут такова, что новые ключи современных моделей производятся и попадаю на руки нашим клиентам (разработчиками приложений) в режиме использования драйвера. То есть чтобы проинициализировать ключ и перевести его в один из двух режимов работы без драйвера, нужно чтобы на ПК, где производится эта самая инициализация, был установлен драйвер Guardant.

Проблема несовместимости драйвера и т. н. «режима изоляции ядра» в операционной системе Windows так же связана с поддержкой устаревших ключей. Мы стараемся сделать оптимизацию так, чтобы обойтись без глобальных компромиссов и рассчитываем, что к концу года сможем предоставить новый драйвер, не вызывающий проблем при работе вместе с включенным режимом изоляции ядра.

Главная же рекомендация на данный момент, это не отключение этого режима в ОС, а как раз-таки использование ключей именно в режимах работы без драйвера. А пользователям, которые уже столкнулись с этой проблемой, мы действительно рекомендовали загружать ОС в безопасном режиме и удалять драйвер, чтобы восстановить работу системы. Отключение изоляции ядра также для многих является допустимым решением, но мы прекрасно понимаем, что такая рекомендация подходит не всем. Поэтому снова призываю уходить от использования драйвера по возможности (пользователи Guardant Station «по умолчанию» инициализируют ключи в режиме WinUSB).

Ну и немного про эти самые «бездрайверные» режимы:

• HID — помедленнее и не такой стабильный, как драйвер. В основном из-за того, что изначально HID проектировался для устройств, не требующих строго контроля целостности данных, передаваемых от ОС и обратно. Потеря пакета-другого для мышки, например, не особенно критично
• WinUSB — по скорости работы и стабильности практически двойник драйвера. «Практически» тут вставил, потому что чисто статистически нет такого доверия, как к драйверу, который развивали и поддерживали 30 лет

Установка ключа в среде Windows

Аппаратные ключи Guardant могут работать как через драйверы Guardant, так и без них (HID-режим, доступен для ключей моделей Guardant Sign/Time/Code и их сетевых версий).
Программные ключи Guardant SP и устаревшие аппаратные ключи Guardant Stealth III/Stealth II работают только через драйвер!

1. Работа ключа через драйвер Guardant

Важно!

1. Наличие установленных драйверов Guardant в Windows-системе обязательно для работы программных ключей SP и устаревших аппаратных ключей Guardant Stealth III/Stealth II и т. п. Поэтому драйверы Guardant должны входить в комплект поставки приложения, защищенного указанными ключами.
2. Новые модели ключей (Guardant Sign/Time/Code и их сетевые версии) могут работать под Windows как с драйверами, так и без установки драйверов (если ключ предварительно переведен разработчиком в HID-режим – см. описание HID-режима).
3. Драйверы Guardant универсальны для всех электронных ключей Guardantи операционных систем семейства Microsoft Windows одной разрядности.
4. Для 32- и 64-разрядных версий ОС Windows используются отдельные инсталляторы драйверов.

Установка драйверов

При инсталляции Комплекта разработчика Guardant драйверы автоматически устанавливаются в операционную систему.
Чтобы переустановить драйверы (установить драйверы на другом компьютере), запустите файл GrdDriversRU.msi (или Setup.exe), который по умолчанию находится в каталоге:

ОС Windows

Каталог по умолчанию

После появления на экране мастера установки следуйте его указаниям. Инсталлятор произведет копирование и установку драйверов для всех типов электронных ключей Guardant независимо от интерфейса подключения.
Важно!

• Во время установки драйверов ВСЕ приложения должны быть закрыты, в противном случае возможны ошибки разделения файлов.

• Для Windows 7/2008/Vista/2003/XP также необходимо, чтобы пользователь, который работает с программой установки, обладал правами администратора системы.

Диагностика ключей Guardant

Для диагностики ключей Guardant воспользуйтесь апплетом Драйверы Guardant из Панели управления Windows.
По нажатию кнопки [Диагностика] вызывается утилита диагностики электронных ключей.
Драйверы Guardant комплектуются утилитой диагностики GrdDem32.exe. Она помогает службе технической поддержки более оперативно проводить диагностику, анализируя сгенерированные утилитой отчеты.

Удаление драйверов

Для удаления драйверов Guardant необходимо воспользоваться меню Установка и удаление программ Панели Управления Windows.
Выберите из списка установленных программ Драйверы Guardant и нажмите на кнопку [Удалить].

Передача драйверов Guardant конечным пользователям

Разработчикам предоставляется несколько способов передачи драйверов конечным пользователям.

1. Распространение дистрибутива драйверов

Наиболее простым решением является распространение готового дистрибутива драйверов Guardant.
В состав ПО Guardant входят 32- и 64-разрядные версии драйверов, файлы которых имеют одинаковое название:

GrdDriversRU.msi

Дистрибутив х86 или х64 с русской версией драйверов Guardant

GrdDriversEN.msi

Дистрибутив х86 или х64 с английской версией драйверов Guardant

Необходимо просто включить в комплект поставки защищенного приложения русский и/или английский вариант драйвера нужной разрядности.

2. Интеграция драйверов в дистрибутив защищенного приложения

Если предполагается устанавливать драйверы Guardant через инсталлятор защищенного приложения, то необходимо включить MSI-пакет с драйверами Guardant в свой комплект установки без изменений.
Драйверы Guardant работают с командной строкой через msiexec. Синтаксис команды должен быть следующим:
msiexec</обязат. параметр> [необязат. параметр]
К примеру, команды для скрытой установки и удаления драйверов должны выглядеть так:

msiexec /i GrdDriversRU.msi /quiet

Установить драйвер в «тихом» режиме

msiexec /x GrdDriversRU.msi /quiet

Удалить драйвер в «тихом» режиме

Другие опции Windows Installer см. с помощью команды msiexec /?

3. Использование драйверного Guardant API

Драйверы Guardant можно устанавливать, конфигурировать и удалять из Windows-приложений (например, из программы установки программного продукта). Для этого в комплект поставки включена библиотека GrdDrv.dll, содержащая все необходимые функции API.
Описания всех используемых констант и структур данных находятся в файле GrdDrv.h. Можно включить эти файлы в приложение, использующее библиотеку GrdDrv.dll.
Подробно процесс работы с библиотекой описан в примере, написанном на языке C (файл InstDrvTest.c).
В процессе установки приложения файлы GrdDrv.dll и GrdDriversRU.msi (или английская версия GrdDriversEN.msi)должны находиться в одном каталоге.

2. Работа ключа без драйвера. HID-режим

Аппаратные ключи, начиная с Guardant Sign, могут работать ОС семейства Windows без установки драйверов Guardant. Для этого ключи необходимо предварительно перевести в Human Interface Device (HID) режим при помощи утилиты GrdUtil.exe.
При подсоединении ключа в HID-режиме к USB-порту компьютера система распознает ключ как стандартное HID-совместимое устройство, после чего ключ сразу же готов к работе.
Режимы работы ключей Guardant в HID-режиме и со стандартным драйвером для пользователя ничем не отличаются.

Установка ключа в среде Linux

Аппаратные ключи, начиная с Guardant Sign, поддерживают работу в среде Linux, в том числе, в HID-режиме 1 Также поддерживается работа защищенных Windows-приложений под WINE.

Для работы с ключами в ОС GNU/Linux необходимо добавить правило для штатного средства обработки HotPlugging. На большинстве современных дистрибутивов, использующих ядро 2.6.х, таким средством является udev ( http://kernel.org/pub/linux/utils/kernel/ hotplug/udev.html ).
Правило для udev добавляется следующим образом:

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

# cp etc/grdnt.udev /etc/udev/rules.d/95-grdnt.rules

Для ключей в HID-режиме

# cp etc/grdnt_hid.udev /etc/udev/rules.d/95-grdnt_hid.rules

Для записи в каталог /etc/udev/rules.d требуются права суперпользователя.

Указанные правила предписывают udev установить права на чтение и запись для файла-устройства, представляющего электронный ключ Guardant в системе. Это позволит обращаться к ключу с привилегиями любого пользователя системы.
Информацию по защите приложений под Linux см. во 2-й части Руководства пользователя.

• Нет меток

При подготовке материала использовались источники:
https://www.guardant.ru/support/users/drivers/
https://forum.guardant.ru/topic/1021/
https://dev.guardant.ru/pages/viewpage.action?pageId=1278381