View Source

Фаловый контейнер
Для использования в качестве ключевого контейнера сессии загружается файловый контейнер в кодировке base64 в формате PKCS#12, проприетарных форматах ИИТ ("Key-6.dat", "Приватбанк jks", "Украина ZS2"). В случае успешной загрузки при выполнении операций создания ЭП, зашифрования и расшифрования будет использоваться личный ключ и, в случае наличия, сертификат (цепочка сертификатов) из загруженного файлового контейнера.
Данные ключевого контейнера сессии находятся в оперативной памяти с момента загрузки до момента удаления сессии и выполнения виртуальной машиной Java последующей процедуры сборки мусора. Данные ключевого контейнера НИКОГДА не сохраняются сервисом в файл, базу данных или другие объекты для долгосрочного хранения информации.
Хранилище ключей (токен) в составе облачного сервиса
Поддерживаемые сервисы: Cipher-CKS, Depositsign

URL-адрес запроса

https://localhost:9094/api/v1/ticket/{uuid}/keyStore

Метод

PUT

Параметры запроса

uuid

String

Идентификатор сессии

Настраиваемые заголовки запроса

Content-Type

application/json

Параметры JSON объекта запроса

Имя

Тип

Описание

Допустимые значения

base64Data

String

Файловый контейнер в кодировке Base64.

Необязательный параметр, используется только при работе с файловым контейнером.

Правильно закодированная Base64 строка

keyStoreUri

String

Уникальный идентификатор хранилища ключей (токена).

Необязательный параметр, используется только при работе с некоторыми облачными сервисами.

Формат зависит от облачного сервиса, который сгенерировал URI

bearerToken

String

Токен доступа, который необходим для доступа к API облачного сервиса.

Необязательный параметр, используется только при работе с некоторыми облачными сервисами.

Формат зависит от облачного сервиса, который сгенерировал токен

Ответ

Код ответа	Content-type	Допустимые параметры	Пример содержимого
200	application/json	message	{ "message" : "Данные ключевого контейнера успешно загружены.", }
503	application/json	message	{ "message" : "Сервис хранения данных не запущен." }
400	application/json	message	{ "message" : "Сессия отсутствует." }
500	application/json	message failureCause	{ "message" : "Ошибка при загрузке данных ключевого контейнера.", "failureCause" : "" }

Параметры JSON объекта ответа

Параметр	Тип данных	Описание
message	String	Описание результата проведения операции
failureCause	String	Описание причины возникновения ошибки

Пример кода на JavaScript + jQuery 2.2.4

var settings = {
  "url": "https://localhost:9094/api/v1/ticket/86e81068-aa67-47ff-98b3-cc226a9147c0/keyStore",
  "method": "PUT",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json"
  },
  "data": JSON.stringify({
    "keyStoreUri": "93fd72ec-55f6-4985-8216-6eb112d99508",
    "bearerToken": "{{tDepsignToken}}"
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});