...
- Создавать и закрывать хэндл защищенного контейнера
- Инициализировать и деиницилизировать память ключа
- Получать информацию из защищенного контейнера, в том числе и о последней ошибке
- Преобразовывать получаемую информациию в текстовые соощения
Перечень функций основных операций Guardant API общего назначения:
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Не нужен | Инициализировать GrdAPI + задать путь к GnClient.ini | |
Не нужен | Деинициализировать Guardant API | |
Не нужен | Получить информацию о последней ошибке из защищенного контейнера | |
Не нужен | Преобразовать код ошибки в текстовое сообщение | |
Не нужен | Получить информацию из защищенного контейнера | |
Не нужен | Проверить валидность хэндла защищенногоконтейнера | |
Не нужен | Создать хэндл защищенного контейнера | |
Не нужен | Закрыть хэндл защищенного контейнера |
Поиск и проверка наличия ключа:
Функции(методы) данного раздела позволяют найти электронный ключ, который удовлетворяет критериям поиска. Если такой ключ имеется то на нем можно зарегистрироваться.
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Public и Read обязательно, остальные по необходимости | Поместить коды доступа в защищенный контейнер | |
Не нужен | Установить режимы поиска электронных ключей | |
Private Read | Найти электронный ключ, удовлетворяющий критериям поиска | |
Private Read | Зарегистрироваться на электронном ключе | |
Private Read | Снять регистрацию с электронного ключа | |
Private Read | Проверить наличие электронного ключа |
Работа с памятью ключа:
Функции(методы) работы с памятью ключа позволяют осуществлять сервисные операции, связанные с инициализацией и защитой памяти электронного ключаI, а также выполнять операции связанные с чтением информации из памяти электронного ключа и записью необходимых данных в его память.
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Не нужен | Установить режимы работы Guardant API | |
Private Read | Прочитать данные из памяти электронного ключа | |
Private Write | Записать данные в память электронного ключа | |
Не нужен | Переместить указатель на текущий адрес памяти электронного ключа | |
Private master | Инициализировать память электронного ключа | |
Private master | Установить аппаратные запреты чтения/записи и записать количество аппаратных алгоритмов и защищенных ячеек |
Работа с аппаратными и программно-реализованными алгоритмами:
Функции(методы) работы этого раздела позволяют преобразовывать, кодировать и декодировать данные с помощью аппаратно- или программно-реализованных алгоритмов.
Они позволяют вычислить и проверить ЭЦП массива данных.
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Private Read | Преобразовать данные аппаратно- или программно-реализованным алгоритмом | |
Private Read | Закодировать/раскодировать данные аппаратноили программно-реализованным алгоритмом | |
Private Read | Расширенный вариант GrdHash | |
Private Read | Вычислить ЭЦП массива данных | |
Не нужен | Проверить ЭЦП массива данных | |
не нужен | Вычислить CRC |
Монопольная работа с ключом:
...
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Private Read | Заблокировать ключ на время выполнения операций, требующих монопольного режима работы с ключом | |
Private Read | Разблокировать электронный ключ |
Поиск и проверка наличия ключа:
Функции(методы) данного раздела позволяют найти электронный ключ, который удовлетворяет критериям поиска. Если такой ключ имеется то на нем можно зарегистрироваться.
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Public и Read обязательно, остальные по необходимости | Поместить коды доступа в защищенный контейнер | |
Не нужен | Установить режимы поиска электронных ключей | |
Private Read | Найти электронный ключ, удовлетворяющий критериям поиска | |
Private Read | Зарегистрироваться на электронном ключе | |
Private Read | Снять регистрацию с электронного ключа | |
Private Read | Проверить наличие электронного ключа |
Работа с аппаратными и программно-реализованными алгоритмами:
Функции(методы) работы этого раздела позволяют преобразовывать, кодировать и декодировать данные с помощью аппаратно- или программно-реализованных алгоритмов.
...
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Private Read | Преобразовать данные аппаратно- или программно-реализованным алгоритмом | |
Private Read | Закодировать/раскодировать данные аппаратноили программно-реализованным алгоритмом | |
Private Read | Расширенный вариант GrdHash | |
Private Read | Вычислить ЭЦП массива данных | |
Не нужен | Проверить ЭЦП массива данных | |
не нужен | Вычислить CRC |
...
Работа с защищенными ячейками:
Для работы с защищенными ячейками существуют специальные функции(методы) Guardant API:
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Private Read и пароль на данную операцию, если он задан в ключе | Активировать алгоритм / защищенную ячейку | |
Private Read и пароль на данную операцию, если он задан в ключе | Деактивировать аппаратный алгоритмили защищенную ячейку | |
Private Read и пароль на данную операцию, если он задан в ключе | Прочитать данные из защищенной ячейки | |
Private Read и пароль, на данную операцию, если он задан в ключе | Обновить данные в защищенной ячейке | |
Private Read | Получить значение счетчика запусков алгоритма |
Использование технологии загружаемого кода (ключи Guardant Code):
Технология Загружаемый Код может быть реализована не только при помощи утилит, входящих в Комплект разработчика. При желании разработчики могут встраивать поддержку этой технологии непосредственно в свои приложения, используя набор предназначенных для этой цели функций:
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Private Read | Загружает код приложения в формате GCEXE во flash- память ключа | |
Private Read | Исполняет код, предварительно загруженный в ключ | |
Private Read | Возвращает информацию из дескриптора загруженного кода | |
Private Read | Задает режим работы ключей Guardant Code/Code Time через драйвер Guardant или в HID режиме |
Функции внутренннего Guardant Code API
Технология Guardant Code API позволяет использовать сервисы микропрограммы ключа серии Code, вызывая их загружаемого кода (по аналогии, как операционная система предоставляет свои сервисы пользовательской программе посредством API). При желании разработчики могут встраивать поддержку этой технологии непосредственно в свои приложения, используя набор предназначенных для этой цели функций:
Название функции | Код доступа | Краткое описание |
|---|---|---|
- | Считать данные из памяти ключа | |
- | Записать данные в память ключа | |
- | Считать данные защищенной ячейки | |
- | Изменить данные защищенной ячейки или определителя алгоритма | |
- | Получить время таймера ключа | |
- | Получить оставшееся время работы алгоритма | |
- | Получить значение счетчика запусков алгоритма | |
- | Получить код последней ошибки | |
- | Выполнить тест часов реального времени - RTC | |
- | Включить светодиод | |
- | Выключить светодиод | |
- | Завершить выполнение загруженного кода | |
- | Зашифровать/расшифровать блок данных | |
- | Вычислить ЭЦП массива данных | |
- | Проверить ЭЦП массива данных | |
- | Выполнить загружаемый код из другого участка загружаемого кода | |
- | Создать пару ключей | |
- | Вычислить хэш-функцию блока данных | |
- | Сгенерировать случайное число | |
- | Установить максимально разрешенное время работы загружаемого кода | |
- | Запросить информацию из дескриптора загружаемого кода |
Функции(методы) для ключей Time:
...
Название функции(метода) | Код доступа | Краткое описание |
|---|---|---|
Private Read+ PrivateWrite | Декрементировать счетчик GP | |
Private Read | Преобразовать данные аппаратно- или программно-реализованным алгоритмом | |
Private Read | Закодировать/раскодировать данные аппаратноили программно-реализованным алгоритмом | |
Private Read | Вычислить значение хэш-функции программноили аппаратно-реализованным алгоритмом | |
PrivateRead | Инициализировать пароль быстрого взаимообратного преобразования | |
не нужен | Закодировать данные быстрым взаимообратнымпреобразованием | |
не нужен | Раскодировать данные быстрым взаимообратнымпреобразованием |
Функции внутренннего Guardant Code API
Технология Guardant Code API позволяет использовать сервисы микропрограммы ключа серии Code, вызывая их загружаемого кода (по аналогии, как операционная система предоставляет свои сервисы пользовательской программе посредством API). При желании разработчики могут встраивать поддержку этой технологии непосредственно в свои приложения, используя набор предназначенных для этой цели функций:
...