Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  1. Файловий контейнер
    Для

...

  1. використання в якості ключового контейнеру сесії завантажується файловий контейнер у кодуванні base64 у форматі PKCS#12, пропрієтарні формати ІІТ ("Key-6.dat", "Приватбанк jks", "

...

  1. Україна ZS2").

...

Данные ключевого контейнера сессии находятся в оперативной памяти с момента загрузки до момента удаления сессии и выполнения виртуальной машиной Java последующей процедуры сборки мусора. Данные ключевого контейнера НИКОГДА не сохраняются сервисом в файл, базу данных или другие объекты для долгосрочного хранения информации.  

URL-адрес запроса
  1. У випадку успішного завантаження при виконанні операції створення КЕП, зашифрування та розшифрування використовується особистий ключ, та за наявності сертифікат (ланцюг сертифікатів) із завантаженого файлового контейнеру.
    Дані ключового контейнеру сесії знаходяться в оперативній памʼяті з моменту завантаження до моменту видалення сесії та виконання віртуальною машиною Java наступної процедури збору сміття. Дані ключового контейнеру НІКОЛИ не зберігаються сервісом у файл, базу даних чи інші обʼєкти для довгострокового зберігання інформації. 
  2. Сховище ключів (токен) у складі хмарного сервісу.
    Підтримувані сервіси: Cipher-CKS, Depositsign
Note
titleУвага

Метод підтримує захищені параметри. 
Ознайомитись с описом та деталями використання захищених параметрів можливо за посиланням Створення та використання захищених параметрів.
Усі параметри JSON обʼєкту запиту можуть бути передані як захищені параметри. Якщо відкритий параметр та захищений параметр мають однакове ім'я, то буде використане значення захищеного параметра.

URL-адреса запиту

https://ccs-dev-api.cipher.kiev.ua/ccshttps://localhost:9094/api/v1/ticket/{uuid}/keyStore

Метод

PUT

...

Параметри запиту
uuidStringИдентификатор сессииІдентифікатор сесії

...

Налаштовувані заголовки

...

запиту
Content-Typeapplication/json

...

Параметри JSON

...

обʼєкту запиту
ИмяІмʼя
Тип
ОписаниеОпис
Допустимые значенияДопустимі значення
base64Data
StringФайловый

Файловий контейнер

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

у кодуванні Base64.

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

Правильно закодований Base64 рядок
keyStoreUriString

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

Не обовʼязковий параметр, який використовується лише при роботі з деякими хмарними сервісами.

Формат залежить від хмарного сервісу, який згенерував URI
bearerTokenString

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

Не обовʼязковий параметр, який використовується лише при роботі з деякими хмарними сервісами.

Формат залежить від хмарного сервісу, який згенерував токен
privilegedBearerTokenString

Токен доступу, який використовується для виконання запитів без другого фактору, навіть якщо другий фактор ввімкнено в налаштуваннях облікового запису користувача.

Не обовʼязковий параметр, який використовується лише при роботі з деякими хмарними сервісами.

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

...

Параметри JSON

...

обʼєкта відповіді
ПараметрТип данныхданихОписаниеОпис
messageStringОписание результата проведения операцииОпис результату проведення операції
failureCause StringОписание причины возникновения ошибки
Пример кода на JavaScript + jQuery 2.2.4

...

languagejs

...

Опис причини появи помилки