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

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.