Page History

Composition Setup

Функция GrdCrypt зашифровывает или расшифровывает блок данных при помощи аппаратного или программно-реализованного алгоритма.

Входные параметрыВыходные параметры

Deck of Cards

id	001

Wiki Markup

{dojo-tabs:theme=tundra|id=1} {dojo-tab:title=C|selected=true} *C*

Card

default	true
label	С

Code Block

language	cpp

int GRD_API GrdCrypt(	
  HANDLE hGrd,
  DWORD dwAlgo,
  DWORD dwDataLng,
  void *pData,
  DWORD dwMethod,
  void *pIV,
  void *pKeyBuf,
  void *pContext
);

{dojo-tab} {dojo-tab:title=C#|selected=true} *C#* {dojo-tab} {dojo-tab:title=Visual Basic (Declaration)} *Visual Basic* {dojo-tab} {dojo-tab:title=Visual C++} *Visual C++* {dojo-tab} {dojo-tabs}

Expand

title

Параметры функции

hGrd

хэндл, через который будет выполнена данная операция.

dwAlgo

номер аппаратного (GSII64) или программно-реализованного алгоритма (AES), которым будет производиться преобразование. Программно-реализованный алгоритм AES 256 имеет номер GrdSC_AES256.

dwDataLng

длина блока данных в байтах

pData

буфер данных для преобразования

dwMethod

метод преобразования, который задается комбинацией флагов GrdAM_XXX и GrdSC_XXX

Биты 0-5 - режим работы алгоритма
GrdAM_ECB	Режим электронной кодовой книги
GrdAM_CBC	Режим сцепления кодированных блоков
GrdAM_CFB	Режим с кодированной обратной связью
GrdAM_OFB	Режим с обратной связью по выходу
Бит 6 - резерв
Бит 7 - тип операции
GrdAM_Encrypt	Кодировать блок
GrdAM_Decrypt	Декодировать блок
Биты 8-9: тип блока данных
GrdSC_First	Первый блок данных
GrdSC_Next	Следующий блок данных
GrdSC_Last	Последний блок данных
GrdSC_All	Единственный блок данных

pIV

вектор инициализации:
для GSII64 - 8 байтов, для AES - 16 байтов.
Если в качестве указателя на вектор инициализации задан NULL, то преобразование пройдет корректно, при этом будет использован нулевой вектор

pKeyBuf

буфер для передачи ключа шифрования для программно-реализованного алгоритма (AES). Длина ключа 256 бит (32 байта). Только для программно-реализованных алгоритмов. При использовании аппаратного алгоритма параметр должен быть равен NULL

pContext

буфер для контекста при шифровании больших массивов данных, которые разбиваются на несколько блоков. Для контекста должна быть зарезервирована память размером GrdXXXXXX_CONTEXT_SIZE байт в зависимости от алгоритма. Только для программно-реализованных алгоритмов. При использовании аппаратного алгоритма параметр должен быть равен NULL

GrdAES256_KEY_SIZE	Длина ключа AES - 256 бит
GrdAES256_BLOCK_SIZE	Длина блока данных AES - 128 бит
GrdAES_CONTEXT_SIZE	Значение должно быть больше или равно sizeof(AES_CONTEXT)

Expand

title

Возвращаемое значение функции

Cтандартный набор ошибок

Card

label	C#

Code Block

language	c#

public static GrdE GrdCrypt(Handle grdHandle,GrdAlgNum algNum, byte[] data, GrdAM method, ref long iv)
public static GrdE GrdCrypt(Handle grdHandle,GrdAlgNum algNum, byte[] data, GrdAM method, byte[] iv)
public static GrdE GrdCrypt(Handle grdHandle,GrdAlgNum algNum, byte[] data, GrdAM method, byte[] iv, byte[] key)
public static GrdE GrdCrypt(Handle grdHandle, GrdAlgNum algNum, byte[] data, GrdAM method, byte[] iv, byte[] key, byte[] context)

Expand

title	Параметры метода

Expand

title	Возвращаемое значение метода

Card

label	Java

Code Block

language	java

Expand

title	Параметры метода

Expand

title	Возвращаемое значение метода

Expand

title	Описание

Функция GrdCrypt позволяет зашифровывать и расшифровывать данные с использованием аппаратно или программно-реализованных симметричных алгоритмов.

Преобразование производится алгоритмом с порядковым номером, заданным в параметре dwAlgo. В зависимости от номера алгоритма dwAlgo функция определяет, каким образом реализован алгоритм - аппаратным или программным. Если номер алгоритма соответствует аппаратному алгоритму, вызов переадресуется функции GrdTransform. Аппаратно реализованный алгоритм должен быть типа GSII64. Иначе, если алгоритм реализован программно (dwAlgo>=GrdSA_SoftAlgo), вызывается соответствующая функция программного шифрования.

Программно-реализованные алгоритмы шифрования при шифровании больших массивов данных используют контекст, память для которого размером не менее GrdXXXXXX_CONTEXT_SIZE должна быть зарезервирована до вызова функции. Указатель на буфер для контекста передается через параметр pContext.

Длина шифруемых блоков данных зависит от метода шифрования (см. описание методов в Руководство пользователя, часть 2). Для методов CFB и OFB длина шифруемых блоков может быть произвольной.

Если шифрование на аппаратно-реализованном алгоритме выполнялось блоками произвольной длины (т. е. использовались флаги GrdSC_First, GrdSC_Next, GrdSC_Last), то для корректного расшифрования длина и порядок обработки блоков должны сохраняться. Для программно-реализованных алгоритмов такое ограничение отсутствует.

Если в дескрипторе аппаратного алгоритма установлен флаг nsafl_GP_dec (уменьшение счетчика), вычитание счетчика GP происходит при каждом вызове GrdCrypt.

Expand

title	Пример

Пример для используемого средства разработки см. в директории:

"\%Program Files%\Guardant\Guardant 6\%PublicCode%\Samples\x86\Win32\General Guardant API\"
или
"\%Program Files%\Guardant\Guardant 6\%Public Code%\Samples\x64\Win64\General Guardant API\"

Page tree

Versions Compared

Old Version 6

New Version 7

Key