Функции проверки электронной подписи и имитовставки¶

`C_VerifyInit`¶

CK_RV C_VerifyInit(CK_SESSION_HANDLE hSession, CK_MECHANISM_PTR pMechanism, CK_OBJECT_HANDLE hKey)¶

Параметры:	hSession (in) – дескриптор сеанса. pMechanism (in) – указатель на механизм. Идентификатор механизма задается в поле `mechanism`. hKey (in) – идентификатор ключа проверки.

Инициализирует операцию проверки электронной подписи, имитовставки или значения HMAC.

Поддерживаемые механизмы:

Криптотокен
- CKM_GOSTR3410 (0x00001201) – механизм для генерации и проверки ЭП, соответствующий стандарту ГОСТ Р 34.10–2001. Использует в качестве входного параметра ранее вычисленное 32-байтовое значение хэш-функции.
- CKM_GOSTR3410_WITH_GOSTR3411 (0x00001202) – механизм для генерации и проверки ЭП (ГОСТ Р 34.10–2001) с хэшированием (ГОСТ Р 34.11–94) подаваемых на вход данных. Размер данных не ограничен.
- CKM_GOST28147_MAC (0x00001223) – механизм выработки и проверки имитовставки, соответствующий стандарту ГОСТ 28147–89. Размер входных данных не ограничен.
Криптотокен 2 ЭП
- CKM_GOSTR3410_256 – псевдоним для CKM_GOSTR3410;
- CKM_GOSTR3410_WITH_GOSTR3411_2012_256 (CK_VENDOR_PKCS11_RU_TEAM_TC26 | 0x008) – механизм для генерации и проверки ЭП (ГОСТ Р 34.10–2012 (длина ключа 256 бит)) с хэшированием (ГОСТ Р 34.11–2012 (длина хэш–кода 256 бит)) подаваемых на вход данных. Размер данных не ограничен.
- CKM_GOSTR3410_WITH_GOSTR3411_12_256 – псевдоним для CKM_GOSTR3410_WITH_GOSTR3411_2012_256;
- CKM_GOSTR3411_2012_256_HMAC (CK_VENDOR_PKCS11_RU_TEAM_TC26 | 0x014) – механизм выработки и проверки имитовставки, соответствующий стандарту ГОСТ Р 34.11–2012 (длина хэш–кода 256 бит);
- CKM_GOSTR3411_12_256_HMAC – псевдоним для CKM_GOSTR3411_2012_256_HMAC;
- CKM_GOSTR3411_2012_512_HMAC (CK_VENDOR_PKCS11_RU_TEAM_TC26 | 0x015) – механизм выработки и проверки имитовставки, соответствующий стандарту ГОСТ Р 34.11–2012 (длина хэш–кода 512 бит);
- CKM_GOSTR3411_12_512_HMAC – псевдоним для CKM_GOSTR3411_2012_512_HMAC.
Laser
- CKM_RSA_PKCS (0x00000001) – механизм для генерации и проверки ЭП по алгоритму RSA. Может быть также использован для зашифрования/расшифрования данных.
- CKM_SHA1_RSA_PKCS (0x00000006) – механизм для генерации и проверки ЭП (RSA) с предварительным хэшированием по алгоритму SHA-1.
- CKM_SHA256_RSA_PKCS (0x00000040) – механизм для генерации и проверки ЭП (RSA) с предварительным хэшированием по алгоритму SHA-256.
- CKM_DES3_MAC (0x00000134) – механизм для формирования и проверки имитовставки фиксированной длины на основе triple-DES. Ограничение длины выхода – 4 байт.
- CKM_DES3_MAC_GENERAL (0x00000135) – механизм для формирования и проверки имитовставки произвольной длины на основе triple-DES.
- CKM_MD5_HMAC (0x00000211) – механизм для формирования и проверки имитовставки на основе MD5.
- CKM_SHA_1_HMAC (0x00000221) – механизм для формирования и проверки имитовставки на основе SHA-1.
- CKM_SHA256_HMAC (0x00000251) – механизм для формирования и проверки имитовставки на основе SHA-256.
- CKM_SHA384_HMAC (0x00000261) – механизм для формирования и проверки имитовставки на основе SHA-384.
- CKM_SHA512_HMAC (0x00000271) – механизм для формирования и проверки имитовставки на основе SHA-512.
- CKM_CMS_SIG (0x00000500) – механизм для генерации и проверки ЭП в формате CMS.
- CKM_ECDSA (0x00001041) – механизм для генерации и проверки ЭП по алгоритму ECDSA.
- CKM_ECDSA_SHA1 (0x00001042) – механизм для генерации и проверки ЭП (ECDSA) с предварительным хэшированием по алгоритму SHA1.
- CKM_ECDSA_SHA256 (0x00001043) – механизм для генерации и проверки ЭП (ECDSA) с предварительным хэшированием по алгоритму SHA256.
- CKM_AES_MAC (0x00001083) – механизм для формирования и проверки имитовставки фиксированной длины на основе AES. Ограничение длины выхода – 8 байт.
- CKM_AES_MAC_GENERAL (0x00001084) – механизм для формирования и проверки имитовставки произвольной длины на основе AES.

Запускается в режимах

Пользователь;

См.также

C_Verify(), C_VerifyUpdate() и C_VerifyFinal().

Результат:

CKR_ARGUMENTS_BAD – недопустимые аргументы.
CKR_CRYPTOKI_NOT_INITIALIZED – функция не может быть выполнена, т.к. библиотека еще не была инициализирована (см. C_Initialize()).
CKR_DEVICE_ERROR – возникла проблема с токеном и/или слотом.
CKR_DEVICE_MEMORY – памяти токена недостаточно для данной операции.
CKR_DEVICE_REMOVED – токен был изъят из слота.
CKR_FUNCTION_CANCELED – функция была отменена в момент исполнения.
CKR_FUNCTION_FAILED – выполнение функции было прервано или она не может быть выполнена.
CKR_GENERAL_ERROR – общий сбой при работе с библиотекой.
CKR_HOST_MEMORY – компьютер, на котором запущена библиотека, не имеет достаточно памяти для выполнения функции.
CKR_KEY_FUNCTION_NOT_PERMITTED – атрибуты ключа не позволяют его использование данным образом.
CKR_KEY_HANDLE_INVALID – недопустимый дескриптор ключа.
CKR_KEY_SIZE_RANGE – размер ключа лежит за пределами, поддерживаемыми библиотекой.
CKR_KEY_TYPE_INCONSISTENT – данный ключ невозможно использовать с указанным механизмом.
CKR_MECHANISM_INVALID – недопустимый механизм.
CKR_MECHANISM_PARAM_INVALID – недопустимый параметр механизма.
CKR_OK – функция выполнена успешно.
CKR_OPERATION_ACTIVE – на устройстве уже есть активная операция, что не позволяет активизировать данную операцию.
CKR_OPERATION_NOT_INITIALIZED – операция для указанного ключа не может быть инициализирована, т.к. ключ не был сгенерирован или импортирован.
CKR_PIN_EXPIRED – срок действия указанного PIN-кода истек.
CKR_SESSION_CLOSED – сеанс был закрыт в момент выполнения функции.
CKR_SESSION_HANDLE_INVALID – недопустимый дескриптор сеанса.
CKR_USER_NOT_LOGGED_IN – действие не может быть выполнено, т.к. пользователь не залогинен.

Совет

Полный список ошибок см. в приложении.

`C_Verify`¶

CK_RV C_Verify(CK_SESSION_HANDLE hSession, CK_BYTE_PTR pData, CK_ULONG ulDataLen, CK_BYTE_PTR pSignature, CK_ULONG_PTR pulSignatureLen)¶

Параметры:	hSession (in) – дескриптор сеанса. pData (in) – указатель на данные. ulDataLen (in) – размер данных. pSignature (in) – указатель на подпись. pulSignatureLen (in) – размер подписи.

Осуществляет единоразовую проверку подписи, т.е проверяет только один блок данных. Либо проверяет значение HMAC для одного блока данных, проверяет значение имитовставки для одного блока данных – конкретная операция зависит от того, с каким значением параметра pMechanism была инициализирована операция проверки.

Примечание

В случае инициализации операции проверки (см. C_VerifyInit()) с механизмом CKM_GOSTR3410 размер данных должен быть 32-байта.

Запускается в режимах

Пользователь;

См.также

C_VerifyInit(), C_VerifyUpdate() и C_VerifyFinal().

Результат:

CKR_ARGUMENTS_BAD – недопустимые аргументы.
CKR_CRYPTOKI_NOT_INITIALIZED – функция не может быть выполнена, т.к. библиотека еще не была инициализирована (см. C_Initialize()).
CKR_DATA_INVALID – недопустимые данные.
CKR_DATA_LEN_RANGE – недопустимый размер данных.
CKR_DEVICE_ERROR – возникла проблема с токеном и/или слотом.
CKR_DEVICE_MEMORY – памяти токена недостаточно для данной операции.
CKR_DEVICE_REMOVED – токен был изъят из слота.
CKR_FUNCTION_CANCELED – функция была отменена в момент исполнения.
CKR_FUNCTION_FAILED – выполнение функции было прервано или она не может быть выполнена.
CKR_GENERAL_ERROR – общий сбой при работе с библиотекой.
CKR_HOST_MEMORY – компьютер, на котором запущена библиотека, не имеет достаточно памяти для выполнения функции.
CKR_OK – подпись верна.
CKR_OPERATION_NOT_INITIALIZED – в указанном сеансе нет активной операции данного типа.
CKR_SESSION_CLOSED – сеанс был закрыт в момент выполнения функции.
CKR_SESSION_HANDLE_INVALID – недопустимый дескриптор сеанса.
CKR_SIGNATURE_INVALID – неверная подпись.
CKR_SIGNATURE_LEN_RANGE – недопустимый размер подписи.

Совет

Полный список ошибок см. в приложении.

`C_VerifyUpdate`¶

CK_RV C_VerifyUpdate(CK_SESSION_HANDLE hSession, CK_BYTE_PTR pPart, CK_ULONG ulPartLen)¶

Параметры:	hSession (in) – дескриптор сеанса. pPart (in) – указатель на блок данных. ulPartLen (in) – размер блока данных.

Продолжает составную операцию проверки подписи – проверяет очередной блок данных, проверяет HMAC или имитовставку для очередного блока данных.

При работе с апплетом Криптотокен функция C_VerifyUpdate() поддерживает только механизмы CKM_GOSTR3410_WITH_GOSTR3411 и CKM_GOST28147_MAC.

Примечание

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

Запускается в режимах

Пользователь;

См.также

C_VerifyInit(), C_Verify() и C_VerifyFinal().

Результат:

CKR_ARGUMENTS_BAD – недопустимые аргументы.
CKR_CRYPTOKI_NOT_INITIALIZED – функция не может быть выполнена, т.к. библиотека еще не была инициализирована (см. C_Initialize()).
CKR_DATA_LEN_RANGE – недопустимый размер данных.
CKR_DEVICE_ERROR – возникла проблема с токеном и/или слотом.
CKR_DEVICE_MEMORY – памяти токена недостаточно для данной операции.
CKR_DEVICE_REMOVED – токен был изъят из слота.
CKR_FUNCTION_CANCELED – функция была отменена в момент исполнения.
CKR_FUNCTION_FAILED – выполнение функции было прервано или она не может быть выполнена.
CKR_GENERAL_ERROR – общий сбой при работе с библиотекой.
CKR_HOST_MEMORY – компьютер, на котором запущена библиотека, не имеет достаточно памяти для выполнения функции.
CKR_OK – функция выполнена успешно.
CKR_OPERATION_NOT_INITIALIZED – в указанном сеансе нет активной операции данного типа.
CKR_SESSION_CLOSED – сеанс был закрыт в момент выполнения функции.
CKR_SESSION_HANDLE_INVALID – недопустимый дескриптор сеанса.

Совет

Полный список ошибок см. в приложении.

`C_VerifyFinal`¶

CK_RV C_VerifyFinal(CK_SESSION_HANDLE hSession, CK_BYTE_PTR pSignature, CK_ULONG_PTR pulSignatureLen)¶

Параметры:	hSession (in) – дескриптор сеанса. pSignature (in) – указатель на подпись. pulSignatureLen (in) – размер подписи.

Завершает операцию проверки подписи, проверки HMAC или проверки имитовставки.

При работе с апплетом Криптотокен функция C_VerifyFinal() поддерживает только механизмы CKM_GOSTR3410_WITH_GOSTR3411 и CKM_GOST28147_MAC.

Примечание

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

Запускается в режимах

Пользователь;

См.также

C_VerifyInit(), C_VerifyUpdate() и C_Verify().

Результат:

CKR_ARGUMENTS_BAD – недопустимые аргументы.
CKR_CRYPTOKI_NOT_INITIALIZED – функция не может быть выполнена, т.к. библиотека еще не была инициализирована (см. C_Initialize()).
CKR_DATA_LEN_RANGE – недопустимый размер данных.
CKR_DEVICE_ERROR – возникла проблема с токеном и/или слотом.
CKR_DEVICE_MEMORY – памяти токена недостаточно для данной операции.
CKR_DEVICE_REMOVED – токен был изъят из слота.
CKR_FUNCTION_CANCELED – функция была отменена в момент исполнения.
CKR_FUNCTION_FAILED – выполнение функции было прервано или она не может быть выполнена.
CKR_GENERAL_ERROR – общий сбой при работе с библиотекой.
CKR_HOST_MEMORY – компьютер, на котором запущена библиотека, не имеет достаточно памяти для выполнения функции.
CKR_OK – подпись верна.
CKR_OPERATION_NOT_INITIALIZED – в указанном сеансе нет активной операции данного типа.
CKR_SESSION_CLOSED – сеанс был закрыт в момент выполнения функции.
CKR_SESSION_HANDLE_INVALID – недопустимый дескриптор сеанса.
CKR_SIGNATURE_INVALID – неверная подпись.
CKR_SIGNATURE_LEN_RANGE – недопустимый размер подписи.

Совет

Полный список ошибок см. в приложении.

Использование¶

Для обеспечения успешного проверки данных, необходимо, чтобы функции в алгоритме были использованы в одной из следующих последовательностей:

Для единоразовой операции проверки	Для составной операции проверки
`C_VerifyInit()` `C_Verify()`	`C_VerifyInit()` `C_VerifyUpdate()` (один или более раз) `C_VerifyFinal()`

Примеры Криптотокен¶

Пример проверки ЭП по ГОСТ Р 34.10–2001 на языке C:

// дескриптор сессии
CK_SESSION_HANDLE session = 0;

// дескриптор открытого ключа
CK_OBJECT_HANDLE pubKeyHandle;

// механизм для формирования ЭП по ГОСТ Р34.10-2001
CK_MECHANISM mech = { CKM_GOSTR3410, NULL_PTR, 0 };

// хэш от данных, на который вычислялась подпись
CK_BYTE hash[32];

// подпись хэша
CK_BYTE signature[64];

// длина подписи
CK_ULONG signatureLength = sizeof(signature);

// инициализируем проверку подписи
rv = C_VerifyInit(session, &mech, pubKeyHandle);
if(rv != CKR_OK)
{
  PrintError("C_VerifyInit", rv);
  return;
}

// проверяем подпись
rv = C_Verify(session, hash, sizeof(hash), signature, signatureLength);
if(rv != CKR_OK)
{
  PrintError("C_Verify", rv);
  return;
}

Примеры Криптотокен 2 ЭП¶

Пример проверки ЭП по ГОСТ Р 34.10–2012 (длина ключа 256 бит) на языке C:

// дескриптор сессии
CK_SESSION_HANDLE session = 0;

// дескриптор открытого ключа
CK_OBJECT_HANDLE pubKeyHandle;

// механизм для формирования ЭП по ГОСТ Р 34.10-2012 с хешированием по ГОСТ Р 34.11-2012
CK_MECHANISM mech = { CKM_GOSTR3410_WITH_GOSTR3411_12_256, NULL_PTR, 0 };

// данные, на которые вычислялась подпись
CK_BYTE data[128];

// подпись данных
CK_BYTE signature[64];

// длина подписи
CK_ULONG signatureLength = sizeof(signature);

// инициализируем проверку подписи
rv = C_VerifyInit(session, &mech, pubKeyHandle);
if(rv != CKR_OK)
{
  PrintError("C_VerifyInit", rv);
  return;
}

// проверяем подпись
rv = C_Verify(session, data, sizeof(data), signature, signatureLength);
if(rv != CKR_OK)
{
  PrintError("C_Verify", rv);
  return;
}

Примеры Laser¶

Пример проверки ЭП по RSA с предварительным хэшированием по SHA-1 на языке C:

// дескриптор сессии
CK_SESSION_HANDLE session = 0;

// дескриптор открытого ключа
CK_OBJECT_HANDLE pubKeyHandle = 0;

// механизм для проверки ЭП по RSA с предварительным хэшированием по SHA-1
CK_MECHANISM mech = { CKM_SHA1_RSA_PKCS, NULL_PTR, 0 };

// данные, на которые вычислялась подпись
CK_BYTE data[128];

// подпись данных. Длина подписи зависит от ключа, который использовался при ее создании
CK_BYTE signature[64];

// длина подписи
CK_ULONG signatureLength = sizeof(signature);

// инициализируем проверку подписи
rv = C_VerifyInit(session, &mech, pubKeyHandle);
if(rv != CKR_OK)
{
   PrintError("C_VerifyInit", rv);
   return;
}

// проверяем подпись
rv = C_Verify(session, data, sizeof(data), signature, &signatureLength);
if(rv != CKR_OK)
{
   PrintError("C_Verify", rv);
   return;
}

Навигация

Функции проверки электронной подписи и имитовставки¶

C_VerifyInit¶

C_Verify¶

C_VerifyUpdate¶

C_VerifyFinal¶

Использование¶

Примеры Криптотокен¶

Примеры Криптотокен 2 ЭП¶

Примеры Laser¶

Оглавление

Быстрый поиск

`C_VerifyInit`¶

`C_Verify`¶

`C_VerifyUpdate`¶

`C_VerifyFinal`¶