Работа с ключевыми парами

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

Описание и примеры представлены в разделе Жизненные циклы основных сущностей.

createKeyPair

Создать ключевую пару с возможностью установить признак предъявления PIN-кода подписи. Содержимое сертификата и открытого ключа сервера при создании пустое.

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded. Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Аргументы:

paramSet

• Тип: String
• Допустимые значения:
  • алгоритм JCWebClient2.Vars.KeyAlgorithm.GOST_2012_256:
    • версия токена ниже 2.5.13 — A или XA
    • версия токена 2.5.13 и выше — TC26-256-B, TC26-256-C, TC26-256-D, TC26-256-A
  • алгоритм JCWebClient2.Vars.KeyAlgorithm.GOST_2012_512 — TC26-512-A, TC26-512-B, TC26-512-C
• Описание: Параметры эллиптической кривой ключевой пары.

Осторожно

Определение версии токена описано здесь: Версии токена GOST 2

description

• Тип: String
• Описание: Описание ключевой пары.

ckaID (Необязательный)

• Тип: Array
• Описание: Массив байт со значением CKA_ID. Будет создана ключевая пара с переданным CKA_ID.

algorithm

• Тип: String
• Допустимые значения:
  • версия токена ниже 2.5.13 — JCWebClient2.Vars.KeyAlgorithm.GOST_2012_256
  • версия токена 2.5.13 и выше — JCWebClient2.Vars.KeyAlgorithm.GOST_2012_256 или JCWebClient2.Vars.KeyAlgorithm.GOST_2012_512
• Описание: Алгоритм.

Осторожно

Определение версии токена описано здесь: Версии токена GOST 2

requireSignaturePin (По умолчанию: false)

• Тип: Boolean
• Описание: Признак необходимости предъявления PIN-кода подписи.

Результат: Integer — идентификатор созданной ключевой пары.

getKeyPairList

Получить список ключевых пар.

Работает при любом состоянии аутентификации.

Аргументы:

tokenID

• Тип: Integer
• Описание: Идентификатор токена. Получается с помощью команды getAllSlots. Значение идентификатора не постоянно, но в рамках сессии не меняется.

Результат: Array — массив из объектов типа PlainObject со следующими параметрами:

id

• Тип: Integer
• Описание: Идентификатор ключевой пары.

description

• Тип: String
• Описание: Описание ключевой пары.

algorithm

• Тип: String
• Допустимые значения: JCWebClient2.Vars.KeyAlgorithm
• Описание: Алгоритм.

signaturePin

• Тип: String
• Допустимые значения: JCWebClient2.Vars.SignaturePinState
• Описание: Состояние установки PIN-кода подписи. Так как информация о предъявлении PIN-кода подписи является приватной, то при состоянии аутентификации равной JCWebClient2.Vars.AuthState.notBinded всегда будет возвращаться значение JCWebClient2.Vars.SignaturePinState.n_a.