Работа с апплетами

Апплет – криптографическое приложение, загружаемое в устройство JaCarta на производстве.

Устройства JaCarta могут содержать от одного и более апплетов. Устройства, содержащие несколько апплетов, называются комбинированными.

Примеры устройств с одним апплетом:

• JaCarta-2 ГОСТ – содержит апплет Криптотокен 2 ЭП.
• JaCarta PKI – содержит апплет Laser.

Примеры комбинированных устройств:

• JaCarta-2 PKI/ГОСТ – содержит апплеты Laser и Криптотокен 2 ЭП.
• JaCarta-2 PRO/ГОСТ – содержит апплеты PRO и Криптотокен 2 ЭП.

Библиотека взаимодействует с апплетами через слоты (см. Апплеты и слоты).

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

Апплет	В состав каких устройств входит
Криптотокен 2 ЭП	JaCarta-2 ГОСТ Комбинированные устройства JaCarta-2: JaCarta-2 PKI/ГОСТ JaCarta-2 PKI/BIO/ГОСТ JaCarta-2 PRO/ГОСТ JaCarta-2 SE
Laser	JaCarta PKI JaCarta PKI/BIO Комбинированные устройства JaCarta-2: JaCarta-2 PKI/ГОСТ JaCarta-2 PKI/BIO/ГОСТ JaCarta-2 PRO/ГОСТ JaCarta-2 SE Комбинированные устройства JaCarta: JaCarta PKI/BIO JaCarta PKI/ГОСТ JaCarta PKI/BIO/ГОСТ
Datastore	JaCarta LT
PRO	JaCarta PRO Комбинированные устройства JaCarta-2: JaCarta-2 PRO/ГОСТ Комбинированные устройства JaCarta: JaCarta PRO/ГОСТ
Криптотокен	JaCarta ГОСТ Комбинированные устройства JaCarta: JaCarta PRO/ГОСТ JaCarta PKI/ГОСТ JaCarta PKI/BIO/ГОСТ

Апплеты и слоты

Взаимодействие каждого апплета на устройстве устанавливается через слоты.

Слот – это логическое цифровое представлением разъёма, к которому может быть подключен апплет. Каждому апплету соответствует один слот. Схема ниже иллюстрирует общий случай связи слотов с апплетами и устройствами:

Из схемы видно, что при подключении нескольких устройств (USB-токен, смарт-карта в Антифрод-терминале) каждый апплет устройства, а также Антифрод-терминал без смарт карты, будет закреплен за отдельным слотом, которые используются в API.

Чтобы узнать какому апплету соответствует выбранный слот, необходимо:

• вызвать функцию C_GetTokenInfo();
• в полученной информации об апплете посмотреть название модели – аргумент CK_TOKEN_INFO.model.

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

• JC_MODEL_CRYPTOTOKEN_2 – для апплета Криптотокен 2 ЭП;
• JC_MODEL_CRYPTOTOKEN_1 – для апплета Криптотокен;
• JC_MODEL_LASER – для апплета Laser;
• JC_MODEL_DATASTORE – для апплета Datastore;
• JC_MODEL_PRO – для апплета PRO.

Библиотека jcPKCS11-2 резервирует 20 слотов. При подключении нового устройства для каждого его апплета выделяется по одному из зарезервированных слотов. Библиотека самостоятельно отслеживает подключенные устройства и асинхронно обновляет служебную информацию о соответствующих им слотах.