Нестандартные функции приложения PKI

USB-токены и смарт-карты JaCartaAPI и SDKUSB-токены и смарт-карты JaCarta

JC_PKI_SetComplexity

CK_RV JC_PKI_SetComplexity(CK_SLOT_ID * slotID*, JC_PKI_PERSONALIZATION_INFO_PTR * pInfo*) Параметры:

slotID (in) – идентификатор слота.
pInfo (in) – параметры персонализации. Установка параметров персонализации для приложения PKI. Функции передается указатель на структуру JC_PKI_PERSONALIZATION_INFO с параметрами персонализации. Примечание: Параметры персонализации применяются только при инициализации апплета.

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

Администратор;
Пользователь;
Гость. Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_GetComplexity

CK_RV JC_PKI_GetComplexity(CK_SLOT_ID * slotID*, JC_PKI_PERSONALIZATION_INFO_PTR * pInfo*) Параметры:

slotID (in) – идентификатор слота.
pInfo (out) – параметры персонализации. Получение параметров персонализации для приложения PKI. Функция возвращает указатель на структуру JC_PKI_PERSONALIZATION_INFO с параметрами персонализации.

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

Администратор
Пользователь
Гость Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_WipeCard

CK_RV JC_PKI_WipeCard(CK_SLOT_ID * slotID*) Параметры:

slotID (in) – идентификатор слота. Очистка содержимого приложения PKI.

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

Гость Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_GetPINInfo

CK_RV JC_PKI_GetPINInfo(CK_SLOT_ID * slotID*, JC_PKI_PIN_INFO_PTR * pInfo*) Параметры:

slotID (in) – идентификатор слота.
pInfo (out) – счетчики PIN-кодов. Получить счетчики PIN-кодов для приложения PKI. Функция возвращает указатель на структуру JC_PKI_PIN_INFO с данными счетчиков.

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

Администратор;
Пользователь;
Гость. Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_UnlockUserPIN

CK_RV JC_PKI_UnlockUserPIN(CK_SLOT_ID * slotID*) Параметры:

slotID (in) – идентификатор слота. Функция разблокирует PIN-код пользователя приложения PKI или возвращает ошибку CKR_CANNOT_UNLOCK, если разблокировка невозможна.

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

Администратор. Результат:
CKR_CANNOT_UNLOCK – разблокировка невозможна. Совет: Полный список ошибок см. в приложении.

JC_PKI_ReadPinCounters

CK_RV JC_PKI_ReadPinCounters(CK_SLOT_ID * slotID*, CK_USER_TYPE * userType*, JC_PKI_PIN_COUNTERS_PTR * pPinCounters*) Параметры:

slotID (in) – идентификатор слота.
userType (in) – тип пользователя. Возможные значения:
- CKU_USER – пользователь;
- CKU_SO – администратор.
**pPinCounters ** (out) – информация о счетчиках PIN-кода. Функция возвращает указатель на структуру типа JC_PKI_PIN_COUNTERS с информацией о PIN-коде для приложения PKI.

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

Администратор;
Пользователь;
Гость. Результат:
CKR_SLOT_ID_INVALID – недопустимый идентификатор слота;
CKR_GENERAL_ERROR – общий сбой при работе с библиотекой. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_GetSupported

CK_RV JC_PKI_BIO_GetSupported(CK_SLOT_ID * slotID*, JC_PKI_BIO_SUPPORT_INFO_PTR * pInfo*) Параметры:

slotID (in) – идентификатор слота.
pInfo (out) – указатель на структуру, содержащую информацию о поддержке биометрии. Функция возвращает указатель на структуру типа JC_PKI_BIO_SUPPORT_INFO с информацией о поддержке биометрии.

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

Администратор;
Пользователь;
Гость. Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_GetFingerIndexes

CK_RV JC_PKI_BIO_GetFingerIndexes(CK_SLOT_ID * slotID*, CK_BYTE_PTR * pFingers*, CK_ULONG_PTR * pulFingerCount*) Параметры:

slotID (in) – идентификатор слота.
pFingers (out) – указатель на массив байт с буфером для идентификаторов пальцев.
**pulFingerCount ** (out) – количество идентификаторов пальцев. Получить идентификаторы зарегистрированных пальцев.

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

Администратор;
Пользователь;
Гость. Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_GetFingerPublicData

CK_RV JC_PKI_BIO_GetFingerPublicData(CK_SLOT_ID * slotID*, CK_BYTE * fingerIndex*, CK_BYTE_PTR * pPublicData*, CK_ULONG_PTR * pulPublicDataSize*) Параметры:

slotID (in) – идентификатор слота.
fingerIndex (in) – идентификатор пальца (от 1 до 10).
pPublicData (out) – указатель на массив байт с буфером для публичной биометрической информации о пальце.
**pulPublicDataSize ** (out) – размер буфера в байтах. Получить публичную биометрическую информацию о пальце по его идентификатору.

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

Администратор;
Пользователь;
Гость. Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_SetFingerData

CK_RV JC_PKI_BIO_SetFingerData(CK_SLOT_ID * slotID*, CK_BYTE * fingerIndex*, CK_BYTE_PTR * pPublicData*, CK_ULONG * ulPublicDataSize*, CK_BYTE_PTR * pPrivateData*, CK_ULONG * ulPrivateDataSize*, CK_BYTE_PTR * pDeviceName*, CK_ULONG * ulDeviceNameSize*) Параметры:

slotID (in) – идентификатор слота.
fingerIndex (in) – идентификатор пальца (от 1 до 10).
pPublicData (in) – указатель на массив байт с буфером публичной биометрической информации о пальце.
ulPublicDataSize (in) – размер буфера публичной информации в байтах.
pPrivateData (in) – указатель на массив байт с буфером закрытой биометрической информации о пальце.
ulPrivateDataSize(in) – размер буфера закрытой информации в байтах.
pDeviceName (in) – имя устройства для считывателя смарт-карт со встроенным сканером отпечатков пальцев, на которое будет записана биометрическая информация.
ulDeviceNameSize (in) – размер имени устройства в байтах. Функция записывает на устройство со сканером отпечатков пальцев биометрическую информацию о пальце по его идентификатору.

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

Администратор. Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_DeleteFinger

CK_RV JC_PKI_BIO_DeleteFinger(CK_SLOT_ID * slotID*, CK_BYTE * fingerIndex*) Параметры:

slotID (in) – идентификатор слота.
fingerIndex (in) – идентификатор пальца (от 1 до 10). Функция удаляет из памяти устройства, соответствующего идентификатору слота, данные об отпечатке пальца по его идентификатору. Запускается в режимах:
Администратор. Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_SetLibrary

CK_RV JC_PKI_BIO_SetLibrary(CK_UTF8CHAR_PTR * pLibraryPath*, CK_ULONG * ulLibraryPathSize*) Параметры:

pLibraryPath (in) – абсолютный путь к файлу с биометрической библиотекой.
ulLibraryPathSize (in) – размер пути до файла библиотеки в байтах или CK_UNAVAILABLE_INFORMATION, если путь заканчивается 0. Установить путь к файлу биометрической библиотеки.

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

Администратор;
Пользователь;
Гость. Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_EnrollPinWithResponse

CK_RV JC_PKI_BIO_EnrollPinWithResponse (CK_SLOT_ID slotID, CK_BYTE_PTR pResponse, CK_ULONG ulResponseLength) Параметры:

slotID (in) – идентификатор слота.
pResponse (in) - ответ Администратора на запрос
ulResponseLength (in) - длина ответа Задать (сменить) отпечаток пальцев с использованием механизма Challenge-Response

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

Администратор
Пользователь
Гость Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_GetBioTicket

CK_RV JC_PKI_BIO_GetBioTicket (CK_SLOT_ID slotID, CK_BYTE_PTR pBioTicket, CK_ULONG_PTR pulTicketDataSize) Параметры:

slotID (in) – идентификатор слота
pBioTicket (out) - указатель на данные (тикет)
pulTicketDataSize (out) - длина данных Осуществить БИО-аутентификацию и получить данные аутентификации (тикет)

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

Гость Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_BIO_GetSupportedEx

CK_RV JC_PKI_BIO_GetSupportedEx (CK_SLOT_ID slotID, JC_PKI_BIO_SUPPORT_INFO_EX_PTR pInfo) Параметры:

slotID (in) – идентификатор слота
pInfo (out) - указатель на структуру, содержащую расширенную информацию по биометрии Получить расширенную информацию о поддержке биометрии

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

Гость Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_GetPinPolicy

CK_RV JC_PKI_GetPinPolicy (CK_SESSION_HANDLE hSession, CK_USER_TYPE userType, JC_PKI_PIN_POLICY_PTR pPinPolicy) Параметры:

hSession (in) – описатель сессии
userType (in) - тип пользователя, поддерживается только CKU_USER
pPinPolicy (out) - указатель на структуру, содержащую информацию о политике PIN-кода типа пользователя Получение параметров политики PIN-кода

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

Администратор
Пользователь Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_ReadBioCounters

CK_RV JC_PKI_ReadBioCounters (CK_SLOT_ID slotID, JC_PKI_PIN_COUNTERS_PTR pPinCounters) Параметры:

slotID (in) - дескриптор слота
pPinCounters(in) - указатель на структуру, содержащую информацию о счетчиках Получение параметров политики PIN-кода

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

Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_SetPinPolicy

CK_RV JC_PKI_SetPinPolicy (CK_SESSION_HANDLE hSession, CK_USER_TYPE userType, JC_PKI_PIN_POLICY_PTR pPinPolicy) Параметры:

hSession (in) – описатель сессии
userType (in) - тип пользователя, поддерживается только CKU_USER
pPinPolicy (out) - указатель на структуру, содержащую информацию о политике PIN-кода типа пользователя Установка параметров политики PIN-кода Пользователя

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

Администратор
Пользователь Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_SetUserPinToBeChanged

CK_RV JC_PKI_SetUserPinToBeChanged (CK_SESSION_HANDLE hSession, CK_BBOOL toBeChanged) Параметры:

hSession (in) – описатель сессии
toBeChanged (in) требовать (CK_TRUE) или не требовать (CK_FALSE) смены PIN-кода пользователя сразу после предъявления Установка/сброс флага обязательной смены PIN-кода пользователя после первого предъявления

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

Администратор Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_SetUserPinWithResponse

CK_RV JC_PKI_SetUserPinWithResponse (CK_SLOT_ID slotID, CK_BYTE_PTR pResponse, CK_ULONG ulResponseLength, CK_UTF8CHAR_PTR pNewUserPin, CK_ULONG ulNewUserPinLen) Параметры:

slotID (in) - идентификатор слота
pResponse (in) - ответ Администратора на запрос
ulResponseLength (in) - длина ответа
pNewUserPin (in) - указатель на новый ПИН пользователя
ulNewUserPinLen (in) - длина нового ПИН пользователя Задать PIN-код пользователя с использованием механизма “Запрос-Ответ”

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

Гость Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.

JC_PKI_UnlockUserPinWithResponse

CK_RV JC_PKI_UnlockUserPinWithResponse (CK_SLOT_ID slotID, CK_BYTE_PTR pResponse, CK_ULONG ulResponseLength, CK_UTF8CHAR_PTR pNewUserPin, CK_ULONG ulNewUserPinLen) Параметры:

slotID (in) - идентификатор слота
pResponse (in) - ответ Администратора на запрос
ulResponseLength (in) - длина ответа
pNewUserPin (in) - указатель на новый ПИН пользователя
ulNewUserPinLen (in) - длина нового ПИН пользователя Разблокировать PIN-код пользователя с использованием механизма “Запрос-Ответ”

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

Гость Результат: Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11. Совет: Полный список ошибок см. в приложении.