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


GOST 2

PKI

writeUserCertificate

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

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

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

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

Аргументы:


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

Значение идентификатора не постоянно, но в рамках сессии не меняется.


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

Результат:


Integer – идентификатор образованного контейнера.

GOST 2

PKI

generateUserSelfSignedCertificate

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

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

Работает при состоянии аутентификации выше, чем 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 – идентификатор образованного контейнера.

GOST 2

PKI

deleteUserCertificate

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

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

Аргументы:


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

Значение идентификатора не постоянно, но в рамках сессии не меняется.

Результат:


Integer – идентификатор соответствующей ключевой пары.

GOST 2

PKI

deleteContainer

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

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded.

Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

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

Аргументы:


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

Значение идентификатора не постоянно, но в рамках сессии не меняется.

GOST 2

PKI

getContainerList

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

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

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

Аргументы:


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

Значение идентификатора не постоянно, но в рамках сессии не меняется.


filters (Необязательный)
Тип: PlainObject
Дополнительные параметры поиска.

Параметры:


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


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


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

Результат:


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


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


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


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