Запит ініціює запуск процесу аварійної генерації ключів. У процесі виконання запиту користувача за допомогою елементів керування відповідного діалогового вікна, необхідно вказати шлях до існуючого чи нового ключового контейнеру, а також пароль дна ключовий контейнер та його підтвердження.
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 | { |
503 | application/json | message | { |
500 | application/json | message failureCause | { { |
400 | application/json | message | { |
Параметри 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; } })