Аварійна генерація ключів

Запит ініціює запуск процесу аварійної генерації ключів. У процесі виконання запиту користувача за допомогою елементів керування відповідного діалогового вікна, необхідно вказати шлях до існуючого чи нового ключового контейнеру, а також пароль до ключового контейнеру та його підтвердження.

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

https://local.cipher.kiev.ua:9090/api/v1/generator/emergencyCreator

Метод

POST

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

Відсутні

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

Content-Type

application/json

Параметри JSON обʼєкта запиту

Імʼя	Тип	Опис	Допустимі параметри
NEW_KEY_TYPE	String	Тип ключа чи ключів, які генеруються	AGREEMENT - ключ звʼязку (шифрування), використовуваний для зашифрування даних SIGNATURE - ключ електронного підпису SIGNATURE_AND_AGREEMENT - ключ електронного підпису та ключ звʼязку
PROFILE_ID	String	OID профіля сертифікатів	Значення параметру oid з профіля генерації ключів
TRANSPORT_CONTAINER_PASSWORD	String	Пароль на PKCS#12 контейнер, який буде повернено як результат запиту	Текстовий рядок
Значення параметрів name обʼєкта з масиву fields пофіля генерації ключів з oid = PROFILE_ID	String	Параметри профіля генерації ключів з oid = PROFILE_ID	Залежить від параметру

Відповідь

Код відповіді	Content-type	Допустимі параметри	Приклад вмісту
200	application/json	message	{ "message": "Ключі успішно згенеровані.", "base64TransportContainer": " ... " }
503	application/json	message	{ "message" : "Сервіс зберігання даних не запущено." }
500	application/json	message failureCause	{ "message" : "Помилка при створенні файлу ключового контейнеру.", "failureCause" : "" } { "message": "Запит на генерацію ключів містить не всі обовʼязкові параметри.", "failureCause": [ "EXTERNAL_USER_ID", "UNZR" ] }
400	application/json	message	{ "message" : "Запит на генерацію ключів не містить JSON обʼєкта з додатковими даними." }

Параметри JSON обʼєкту відповіді

Параметр	Тип даних	Опис
failureCause	String	Опис причини виникнення помилки
failureCause	Array	Масив з ідентифікаторами відсутніх обовʼязкових параметрів
message	String	Опис результату проведення операції
base64TransportContainer	String	Контейнер PKCS#12 із запитом(ами) PKCS#10 у форматі base64

Приклад коду на JavaScript + jQuery 2.2.4

 var keyGenerationData = {
    "NEW_KEY_TYPE" : "SIGNATURE",
	"PROFILE_ID" : "1.3.6.1.4.1.7845.2.1.12.3",
	"TRANSPORT_CONTAINER_PASSWORD" : "12345678",
	"COMMON_NAME" : "Повне імʼя",
	"COUNTRY_NAME" : "ua",
	"GIVEN_NAME" : "Імʼя, по батькові",
	"LOCALITY_NAME" : "Харків",
	"STATE_OR_PROVINCE_NAME" : "Харківська",
	"STREET_ADDRESS" : "пр-т Науки 7",
	"SURNAME" : "Прізвище",
	"TITLE" : "Посада",
	"ORGANIZATION_NAME" : "Організація",
	"ORGANIZATIONAL_UNIT_NAME" : "Підрозділ",
	"POSTAL_CODE" : "61000",
	"DRFOU" : "0000000019",
	"EDRPOU" : "0000000019",
	"PASSPORT" : "KH123445",
	"MAIL" : "a.stoky@gmail.com",
	"UNZR" : "01010101010114",
	"EXTERNAL_USER_ID" : "001",
	"TELEPHONE_NUMBER" : "0670000001"
};
$.ajax({
    url: "https://local.cipher.kiev.ua:9090/api/v1/generator/emergencyCreator",
    type: "POST",
    dataType: "json",
    contentType: "application/json",
    data: JSON.stringify(keyGenerationData)
}).done(function (jsonResponse, textStatus, xhr) {
    message = jsonResponse.message;
}).fail(function (xhr) {
    try {
        var jsonResponse = JSON.parse(xhr.responseText);
        message = jsonResponse.message;
        failure = jsonResponse.failureCause;
    } catch (e) {
        message = (xhr.responseText == undefined) ? "Помилка у процесі аварійної генерації ключів." : xhr.responseText;
    }
})

Page tree