View Source

Поддерживаемые ключи

Guardant Mobile API поддерживает только следующие модели ключей с загружаемым кодом:

Guardant Code micro (и любые другие ключи семейства Code)
Планшет или смартфон должен быть оснащён функцией USB-host и версией операционной системы не ниже Android 3.1. Если в планшете нет функции USB-host, это означает, что подключение к аппарату периферии не поддерживается, т.к. порт работает только на "выход", в этом случае электронные ключи также не смогут работать на таких устройствах.
Guardant SD
Электронные ключи Guardant SD требуют наличия в мобильном устройстве разъёма для SD-карты. Данный форм-фактор может быть выбран по соображениям компактности, либо использоваться на устройствах, в которых отсутствует USB-порт, но есть разъём для SD-карты.

Поддерживаемые ОС

Проект Guardant Mobile направлен на поддержку максимально широкого спектра платформ.

	Android	Windows	Linux	OS X	Windows RT 8.1	Другие
Guardant Code	+	+	+	+	+	опция
Guardant SD	+	+	+	-	-	-

Особенности поддержки в Android:

Служба Guardant для ОС Android
Для работы защищённых приложений с электронными ключами на устройстве должна быть запущена специальная служба Guardant.
Установочный пакет службы входит в состав Mobile SDK. После установки пакета в списке запущенных программ появиться приложение "Guardant Service". Служба предоставляет API взаимодействия с электронными ключами, отслеживает подключение и отключение ключей, осуществляет синхронизацию запросов и т.д.
Java библиотека API для ОС Android
Для работы с электронным ключом из Android приложения, разработчику предоставляется Java API. Набор функций API позволяет выполнить заранее загруженный в электронный ключ код, а также произвести поиск ключа с известными параметрами.
Программирование электронных ключей
Программирование ключей Guardant Code micro осуществляется в операционной системе Windows c помощью утилиты программирования ключей Guardant. Для работы в Android ключи должны быть переведены в HID-режим.

Поля поиска ключа

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

Поле	Длина (байт)	Назначение
PUBLIC код	4	Открытый код ключа, однозначно идентифицирующий владельца данного электронного ключа. Программируется при покупке электронных ключей. Данное поле не может быть изменено.
Номер программы	1	Поле содержит номер защищенного программного продукта. Используется для «привязки» копии приложения к электронному ключу в случае, если программных продуктов несколько. Диапазон допустимых значений от 0 до 255.
Версия программы	1	Поле содержит номер версии защищенного программного продукта. Может использоваться для «привязки» копии приложения к электронному ключу в случае выпуска новых версий программы. В процессе поиска, поле в ключе должно быть больше или равно искомому значению. Диапазон допустимых значений от 0 до 255.
Серийный номер	2	Поле содержит номер копии защищенного программного продукта. Используется для «привязки» конкретной копии приложения к электронному ключу. Диапазон допустимых значений от 0 до 65535.
Битовая маска	2	Поле полезно в случае, если программный продукт состоит из комплекса независимых приложений. Используется для разрешения/запрета работы с отдельными модулями программного продукта (комплекса). Диапазон допустимых значений от 0 до 65535.
ID ключа	4	Уникальный идентификационный номер ключа. Записывается на стадии производства. Гарантируется, что двух ключей с одинаковыми значениями ID не может быть. Можно настроить приложение на идентификатор ключа, и тогда оно будет работать только с ключом, содержащим этот ID. Данное поле не может быть изменено.
Тип ключа	2	Битовое поле позволяет программному обеспечению искать ключи с наличием необходимой функциональности. Данное поле не может быть изменено.
Модель ключа	4	Позволяет программному обеспечению искать ключи только определённых моделей. Модель ключа не может быть изменена.