1.1 Получение JaCarta SDK

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

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

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

1.2 Назначение 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) — интерфейс для встраивания в другие СКЗИ.
  
  Описание APDU-интерфейса предоставляется по запросу в рамках действующего NDA. 

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

JaCarta SDK поддерживает работу со следующими моделями USB-токенов\смарт-карт:

• JaCarta PKI;
• JaCarta PKI/BIO;
• JaCarta-2 ГОСТ;
• JaCarta-2 PKI/ГОСТ;
• JaCarta-3 ГОСТ;
• JaCarta-3 PKI/ГОСТ;
• JaCarta-2 SE;
• JaCarta-3 SE;
• JaCarta SecurBIO;
• JaCarta LT.

Поддерживаются следующие модели смарт-карт ридеров (поддержка смарт-карт-ридеров других производителей ничем не ограничена):

• JCR721
• Aladdin SecurBIO Reader

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

Microsoft

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

Apple

• macOS 10.12  - 15.5

Linux

• GNU/Linux

Оперативная память (RAM)

Минимально: 1 ГБ.
Рекомендовано: 2 ГБ.

Минимально: 1 ГБ.
Рекомендовано: 5 ГБ.

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

Microsoft Windows

• Драйвера и обновления USB-CCID (Microsoft Windows XP, 7, 2008R2).
• Для Microsoft Windows 7 и 2008R2 установите обновление KB2800095 c сайта Microsoft https://support.microsoft.com/en-us/kb/2800095.

macOS

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

GNU/Linux

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