Работа с контейнерами

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

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

writeUserCertificate

Для GOST 2, PKI.

Записать пользовательский сертификат.

После успешной записи образовывается контейнер и идентификатор ключевой пары становится невалидным.

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

Примеры в разделе Создание контейнера с помощью команды writeUserCertificate.

Аргументы:

keyPairID

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

cert

• Тип: Array | String
• Описание: Значение сертификата в формате X509 (может быть закодирован в PEM или DER, см. Поддержка PEM и DER форматов).

Результат: Integer — идентификатор образованного контейнера.

generateUserSelfSignedCertificate

Для GOST 2, PKI.

Сгенерировать и записать самоподписанный пользовательский сертификат.

После успешной записи образовывается контейнер и идентификатор ключевой пары становится невалидным.

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

Примеры в разделе Создание контейнера с помощью команды generateUserSelfSignedCertificate.

Аргументы:

keyPairID

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

dn

• Тип: PlainObject

• Описание: Объект, содержащий элементы ключ-значение. В качестве ключа задаются элементы типа String, а в качестве значения:

  • String
  • массив из String, если необходимо установить несколько значений — значения будут объеденены через запятую

  (см. Генерация запроса на квалифицированный сертификат).

exts

• Тип: PlainObject
• Описание: Расширения для включения в запрос. Формат аналогичен dn. Для добавления нескольких расширений с одинаковым ключом, в качестве значения ключа можно использовать:
  • PlainObject с полем “multi”, содержащим массив из String

days

• Тип: Integer
• Описание: Срок действия сертификата в днях с момента выпуска.

Результат: Integer — идентификатор образованного контейнера.

deleteUserCertificate

Для GOST 2, PKI.

Удалить пользовательский сертификат.

После успешного удаления контейнер трансформируется в ключевую пару и идентификатор контейнера становится невалидным.

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

Аргументы:

contID

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

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

deleteContainer

Для GOST 2, PKI.

Удалить контейнер.

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

Примеры в разделе Удаление контейнера.

Аргументы:

contID

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

getContainerList

Для GOST 2, PKI.

Получить список контейнеров.

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

Примеры в разделе Получение списков сущностей.

Аргументы:

tokenID

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

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

• Тип: PlainObject
• Описание: Дополнительные параметры поиска.

Параметры:

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

• Тип: String
• Описание: Серийный номер сертификата. В результат добавляются контейнеры, имеющие указанный серийный номер (регистр не учитывается).

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

• Тип: String
• Описание: Имя издателя. В результат добавляются контейнеры, имеющие указанную подстроку в имени издателя (регистр учитывается).

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

• Тип: String
• Описание: Имя субъекта. В результат добавляются контейнеры, имеющие указанную подстроку в имени субъекта (регистр учитывается).

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

id

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

description

• Тип: String
• Описание: Описание контейнера.

algorithm

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