- Фаловый контейнер
Для использования в качестве ключевого контейнера сессии загружается файловый контейнер в кодировке 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 | { |
| 503 | application/json | message | { |
| 400 | application/json | message | { |
| 500 | application/json | 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": "eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTUxMiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjQyOTliODQyLWVhOWMtNGJhMy04ZTZmLWFiZWUxMmE5MDcyMCIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL25hbWUiOiJ0ZXN0RFMiLCJuYmYiOjE2MTA2OTc3MTAsImV4cCI6MTYxMDc4NDExMCwiaXNzIjoiaHR0cDovL2RlcG9zaXRzaWduLmNvbSIsImF1ZCI6Imh0dHA6Ly9kZXBvc2l0c2lnbi5jb20ifQ.vwosOK_5WzWtjymN-ZDdR_5EZ7dNZyOkGbAhh17V9xtJyLOv5xJFXD_udZROzrpaj0uVcMb0867tuNkQG6-om"
}),
};
$.ajax(settings).done(function (response) {
console.log(response);
});