Функции для работы с апплетом Laser

JC_PKI_SetComplexity

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

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

JC_PKI_WipeCard(CK_SLOT_ID slotID)
Параметры:
  • slotID (in) – идентификатор слота.

Очистка содержимого карты Laser. Метод требует аутентификации администратором.

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

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

Совет

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

JC_PKI_GetPINInfo

JC_PKI_GetPINInfo(CK_SLOT_ID slotID, JC_PKI_PIN_INFO_PTR pInfo)
Параметры:
  • slotID (in) – идентификатор слота.
  • pInfo (out) – счетчики ПИН-кодов.

Получить счетчики ПИН-кодов для апплета Laser. Функция возвращает указатель на структуру JC_PKI_PIN_INFO с данными счетчиков.

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

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

Совет

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

JC_PKI_GetChallenge

JC_PKI_GetChallenge(CK_SLOT_ID slotID, CK_BYTE_PTR pChallenge, CK_ULONG ulChallengeSize)
Параметры:
  • slotID (in) – идентификатор слота.
  • pChallenge (out) – буфер для challenge.
  • ulChallengeSize (out) – размер буфера в байтах.

Функция возвращает т.н. challenge - случайную последовательность, выработанную токеном, для последующей внешней аутентификации апплета Laser. Полученное значение challenge следует преобразовать при помощи ключа администратора с использованием алгоритма CBC DES и с нулевым вектором инициализации. В результате получится т.н. response - значение, которое можно предъявить в качестве PIN-кода для функции C_Login() с указанием типа пользователя CKU_SO_RESPONSE.

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

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

Совет

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

JC_PKI_UnlockUserPIN

JC_PKI_UnlockUserPIN(CK_SLOT_ID slotID)
Параметры:
  • slotID (in) – идентификатор слота.

Функция разблокирует PIN-код пользователя для апплета Laser или возвращает ошибку CKR_CANNOT_UNLOCK, если разблокировка не возможна. Требует аутентификации администратором.

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

Результат:
  • CKR_CANNOT_UNLOCK – разблокировка не возможна.

Совет

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

JC_PKI_BIO_GetSupported

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

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

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

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

JC_PKI_BIO_DeleteFinger(CK_SLOT_ID slotID, CK_BYTE fingerIndex)
Параметры:
  • slotID (in) – идентификатор слота.
  • fingerIndex (in) – идентификатор пальца (от 1 до 10).

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

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

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

Совет

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

JC_PKI_BIO_SetLibrary

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

Установить путь к файлу биометрической библиотеки.

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

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

Совет

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

Оглавление