Page History

1. Файловий контейнер
   Для

...

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

...

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

...

Путь к аппаратному носителю с поддержкой PKCS#11, который подключен к компьютеру, на котором выполняется сервис, необходимо получить посредством запроса https://docs.cipher.kiev.ua/x/GYOD.

Если в запросе одновременно присутствуют данные файлового ключевого контейнера и путь к ключевому контейнеру, то будет использован только путь.

Если отдельными запросами для сессии были загружены и данные файлового контейнера, и путь к ключевому контейнеру, то будет использован только путь.

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

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

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

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

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

Метод

PUT

...

Параметри запиту

...

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

...

запиту

...

Параметри JSON

...

обʼєкту запиту

base64Data

Ответ

Відповідь

{

    "message" :

 "Дані ключового контейнеру успішно завантажено.",
}

{

    "message" :

 "Сервіс зберігання даних не запущено." 
}

{

    "message" : "

Сесія відсутня." 
}

{

    "message" : "

Помилка при 

завантаженні 

даних 

ключового 

контейнеру.",
    "failureCause" : ""
}

...

Параметри JSON

...

обʼєкта відповіді

Пример кода на JavaScript + jQuery 2.2.4 в случае использования аппаратного носителя в активном режиме

var data = {
    keyStorePath: "@. Avtor SecureToken 0"
}
$.ajax({
    url: "https://local.cipher.kiev.ua:9090/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/keyStore",
    type: "POST",
    dataType: "json",
    contentType: "application/json",
    data: JSON.stringify(data)
}).done(function (jsonResponse, textStatus, xhr) {
    message = jsonResponse.message;
}).fail(function (xhr) {
    try {
        var jsonResponse = JSON.parse(xhr.responseText);
        message = jsonResponse.message;
        failureCause = jsonResponse.failureCause;
    } catch (e) {
        message = (xhr.responseText == undefined) ? "Ошибка при загрузке данных ключевого контейнера." : xhr.responseText;
    }
})

Пример кода на JavaScript + jQuery 2.2.4 в случае использования файлового контейнера с указанием пути

var data = {
    keyStorePath: "z:\\sharedFiles\\temp\\7\\Molyakov_overdue-DS+Arg.pfx"
}
$.ajax({
    url: "https://local.cipher.kiev.ua:9090/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/keyStore",
    type: "POST",
    dataType: "json",
    contentType: "application/json",
    data: JSON.stringify(data)
}).done(function (jsonResponse, textStatus, xhr) {
    message = jsonResponse.message;
}).fail(function (xhr) {
    try {
        var jsonResponse = JSON.parse(xhr.responseText);
        message = jsonResponse.message;
        failureCause = jsonResponse.failureCause;
    } catch (e) {
        message = (xhr.responseText == undefined) ? "Ошибка при загрузке данных ключевого контейнера." : xhr.responseText;
    }
})

Пример кода на JavaScript + jQuery 2.2.4 в случае использования данных файлового контейнера

...

...