Операции с контейнером

createContainer

Поддерживаемые типы токенов
GOST
PRO
createContainer(string ecParams, string description)

Создать контейнер. Контейнер содержит ключевую пару, сертификат и опционально открытый ключ сервера для установки защищенного канала. Содержимое сертификата и открытого ключа сервера при создании пустое. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:
  • ecParams

    параметры эллиптической кривой ключевой пары. Может принимать значения A, B, C, XA, XB.

    Примечание

    При работе с апплетом PRO, параметр эллиптической кривой должен быть пустым.

  • description – описание контейнера.
Результат:

int – идентификатор созданного контейнера (сертификата).

createContainerAsync

Поддерживаемые типы токенов
GOST
PRO
createContainerAsync(string ecParams, string description, JSObjectPtr callback)

Создать контейнер. Метод выполняется асинхронно. Контейнер содержит ключевую пару, сертификат и опционально открытый ключ сервера для установки защищенного канала. Содержимое сертификата и открытого ключа сервера при создании пустое. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:
  • ecParams

    параметры эллиптической кривой ключевой пары. Может принимать значения A, B, C, XA, XB.

    Примечание

    При работе с апплетом PRO, параметр эллиптической кривой должен быть пустым.

  • description – описание контейнера.
  • callback – сallback-функция JavaScript, которая будет выполнена после завершения работы метода. В случае ошибки или отмены операции в функцию будет передан массив вида ['Error', 'КодОшибки'], в случае успеха - результат выполнения метода.
Результат:

int – идентификатор созданного контейнера (сертификата).

Примечание

Результат будет передан в параметр callback в качестве входного аргумента.

createContainerEx

Поддерживаемые типы токенов
GOST
PRO
createContainerEx(array CkaID, string ecParams, string description)

Создать контейнер с указанием параметра CKA_ID. Контейнер содержит ключевую пару, сертификат и опционально открытый ключ сервера для установки защищенного канала. Содержимое сертификата и открытого ключа сервера при создании пустое. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:
  • CkaID – массив байт со значением CKA_ID.
  • ecParams

    параметры эллиптической кривой ключевой пары. Может принимать значения A, B, C, XA, XB.

    Примечание

    При работе с апплетом PRO, параметр эллиптической кривой должен быть пустым.

  • description – описание контейнера.
Результат:

int – идентификатор созданного контейнера (сертификата).

createContainerExAsync

Поддерживаемые типы токенов
GOST
PRO
createContainerExAsync(array CkaID, string ecParams, string description, JSObjectPtr callback)

Создать контейнер с указанием параметра CKA_ID. Метод выполняется асинхронно. Контейнер содержит ключевую пару, сертификат и опционально открытый ключ сервера для установки защищенного канала. Содержимое сертификата и открытого ключа сервера при создании пустое. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:
  • CkaID – массив байт со значением CKA_ID.
  • ecParams

    параметры эллиптической кривой ключевой пары. Может принимать значения A, B, C, XA, XB.

    Примечание

    При работе с апплетом PRO, параметр эллиптической кривой должен быть пустым.

  • description – описание контейнера.
  • callback – сallback-функция JavaScript, которая будет выполнена после завершения работы метода. В случае ошибки или отмены операции в функцию будет передан массив вида ['Error', 'КодОшибки'], в случае успеха - результат выполнения метода.
Результат:

int – идентификатор созданного контейнера (сертификата).

Примечание

Результат будет передан в параметр callback в качестве входного аргумента.

deleteContainerOrCertificate

Поддерживаемые типы токенов
GOST
PRO
deleteContainerOrCertificate(int contID)

Удалить контейнер или сертификат. Приложение JC-WebClient не делает различия между сертификатами и созданными с помощью приложения контейнерами (содержащими сертификат и ключевую пару). Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:
  • contID

    идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

    Примечание

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

deleteCertificate

Поддерживаемые типы токенов
GOST
PRO
deleteCertificate(int contID)

Удалить сертификат, связанный с публичным ключом. Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:
  • contID

    идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи метода поиска getContainerList().

    Примечание

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

writeCkaID

Поддерживаемые типы токенов
GOST
PRO
writeCkaID(int contID, array newCkaID)

Записать новое значение CKA_ID для контейнера. Работает при состоянии аутентификации большем, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:
  • contID

    идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

    Примечание

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

  • newCkaID – массив байт с новым значением CKA_ID.

readCkaID

Поддерживаемые типы токенов
GOST
PRO
readCkaID(int contID)

Получить значение CKA_ID для контейнера. Работает при состоянии аутентификации большем, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:
  • contID

    идентификатор контейнера (сертификата). Получается при создании контейнера createContainer()/createContainerAsync() или при помощи методов поиска getCertificateList()/getCertificateListEx().

    Примечание

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

Результат:

array – массив байт со значением CKA_ID.