Общие сведения о JaCarta SDK

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

Получение JaCarta SDK

Компания Аладдин оказывает консультационную поддержку по вопросам:

выбора SDK для требуемой задачи;
способа решений требуемой задачи;
работы c SDK и примерами;
иным вопросам, связанных с SDK.

Для получения комплекта разработчика и консультационной поддержки оформите заявку на сайте компании. Менеджер компании свяжется с Вами в течении 24 часов.

Назначение JaCarta SDK

Комплект разработчика JaCarta® SDK предназначен для встраивания устройств JaCarta PKI, JaCarta PKI/BIO, JaCarta-2 ГОСТ, JaCarta-2 PKI/ГОСТ, JaCarta-3 ГОСТ, JaCarta-3 PKI/ГОСТ, JaCarta-2 SE, JaCarta-3 SE, JaCarta LT, JaCarta SecurBIO®, а также смарт-карт ридеров JCR721 и Aladdin SecurBIO Reader в прикладное ПО.

Для взаимодействия прикладного ПО с перечисленными устройствами используется интерфейс PKCS#11 версии 2.40 draft с расширением ТК26 для использования российских стандартов ГОСТ 34.12-2018, ГОСТ 34.13-2018, ГОСТ 34.10-2018, ГОСТ 34.11-2018, а также криптографических механизмов, построенных на их основе.

Решаемые с помощью SDK задачи:

Подготовка JaCarta к эксплуатации - инициализация устройства, установка ПИН-кодов и парольных политик. Для биометрических продуктов - регистрация отпечатков пользователя. Генерация криптографических ключей и запроса на сертификат. Запись сертификатов и других пользовательских данных.
Двухфакторная аутентификация в информационных системах и прикладном ПО - получение информации о подключенных устройствах, проверка ПИН-кода и чтение сертификатов. Проверка валидности сертификатов, разбор сертификатов, получение информации о пользователе из сертификата.
Электронная подпись/проверка подписи документов и данных - получение информации о ключах и сертификатах, формирование электронной подписи в форматах PKCS#7 и CAdES с возможностью соподписи и добавления метки времени. Проверка электронной подписи, включая соподпись, проверка валидности сертификата подписанта.
Организация безопасного обмена зашифрованными данными - генерация ключей обмена и шифрования, экспорт ключей шифрования, зашифрование/расшифрование данных на различных алгоритмах и режимах работы, формирование CMS-конвертов и их разбор.
Администрирование устройств - разблокировка заблокированных ПИН-кодов, в т.ч. удаленная разблокировка, смена ПИН-кодов и парольных политик, инициализация устройства. Получение информации о ключах и сертификатах, обновление ключей и сертификатов.
Безопасное хранение данных - запись любых данных, включая логины/пароли, сертификаты и др. Управлением доступом к объектам (общедоступный или приватный).

Демонстрируемые в примерах возможности:

Генерация ключевой пары заданной длины.
Генерация запроса на сертификат, включая запрос на квалифицированные сертификат.
Хэширование и электронная подпись в форматах PKCS#7, CAdES.
Проверка электронной подписи.
Выработка ключей согласования.
Выработка ключей шифрования.
Шифрование и расшифрование данных в формате CMS.
Запись/поиск/чтение пользовательской информации.
Администрирование устройств JaCarta - инициализация, назначение ПИН-кодов, установка парольных политик, разблокировка.
Для комбинированных биометрических моделей JaCarta - сохранение отпечатков пальцев, администрирование отпечатков.

Доступные интерфейсы:

PKCS#11 — рекомендованный интерфейс. Представлен в виде библиотеки стандарта PKCS #11.
ИКБ (APDU) — сертифицированный интерфейс для встраивания моделей JaCarta-2 ГОСТ, JaCarta-2 PKI/ГОСТ, JaCarta-2 SE c СКЗИ. Представлен в виде отдельной библиотеки (интерфейсная криптобиблиотека или ИКБ), использующей в своей работе интерфейс APDU.
PC/SC (APDU) — интерфейс для встраивания в другие СКЗИ.

Поддерживаемые модели JaCarta

Модель	Форм-фактор	Приложения (апплеты)	Функциональность
JaCarta PKI	USB-токен, смарт-карта	PKI	Зарубежная криптография
JaCarta-3 PKI	USB-токен	PKI	Зарубежная криптография
JaCarta-2 ГОСТ	USB-токен	GOST версии 2.5.13	Российская криптография.
JaCarta-2 ГОСТ	смарт-карта	GOST версии 2.5.5	Российская криптография.
JaCarta-3 ГОСТ	USB-токен	GOST версии 2.5.13	Российская криптография.
JaCarta-2 PKI/ГОСТ	USB-токен	PKI, GOST версии 2.5.13	Зарубежная криптография, Российская криптография.
JaCarta-2 PKI/ГОСТ	смарт-карта	PKI, GOST версии 2.5.5	Зарубежная криптография, Российская криптография.
JaCarta-3 PKI/ГОСТ	USB-токен	PKI, GOST версии 2.5.13	Зарубежная криптография, Российская криптография.
JaCarta PKI/BIO	смарт-карта	PKI	Зарубежная криптография. Поддержка биометрии при использовании с биометрическим смарт-карт ридером.
JaCarta-2 PKI/BIO/ГОСТ	смарт-карта	PKI, GOST версии 2.5.5	Зарубежная криптография, Российская криптография. Поддержка биометрии при использовании с биометрическим смарт-карт ридером.
JaCarta-2 SE	USB-токен	GOST версии 2.5.5	Зарубежная криптография, Российская криптография. Основная модель для ЕГАИС.
JaCarta LT	USB-токен	LT	Защищённое хранение ключевых контейнеров СКЗИ (КриптоПро CSP, ViPNet CSP), ключей, паролей; без криптографии.
JaCarta SecurBIO	USB-токен со сканером отпечатка пальца	Biomanager, PKI, GOST версии 2.5.13	Зарубежная криптография, Российская криптография. Встроенный сканер отпечатков пальцев.

Системные требования JaCarta SDK

Операционные системы

Microsoft Windows:

Microsoft Windows 11 (64-бит)
Microsoft Windows 10 (32/64-бит)
Microsoft Windows 8 – 8.1 (32/64-бит)
Microsoft Windows 7 SP1 (32/64-бит)
Microsoft Windows Server 2019
Microsoft Windows Server 2016
Microsoft Windows Server 2012 R2

Apple macOS:

OS X 10.9 (Mavericks) – macOS 15.5

GNU/Linux:

GNU/Linux
Astra Linux SE 1.6, 1.7, 1.8 (в режиме ЗПС)

Аппаратные требования

Оперативная память (RAM): минимально 1 ГБ, рекомендовано 2 ГБ.
Свободное пространство на диске: минимально 1 ГБ, рекомендовано 5 ГБ.

Дополнительное программное обеспечение

Microsoft Windows:

Драйверы и обновления USB-CCID (Microsoft Windows XP, 7, 2008R2).
Для Microsoft Windows 7 и 2008R2 установите обновление KB2800095 с сайта Microsoft.
Только при проблемах с подсистемой USB-CCID установите HotFix KB2800095 с сайта Microsoft.

macOS:

Установите пакет pcsc-lite.

GNU/Linux:

Для ОС семейства Debian установите пакеты pcscd, libpcsclite1, libccid.
Для ОС семейства CentOS установите пакеты pcsc-lite, pcsc-lite-ccid.