Versions Compared

Old Version 8

changes.mady.by.user Svitlana Nimych

Saved on

compared with

New Version 9

changes.mady.by.user Svitlana Nimych

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

Запрос инициирует запуск процесса аварийной генерации ключей. В процессе выполнения запроса пользователю посредством элементов управления соответствующего диалогового окна необходимо указать путь к существующему или новому ключевому контейнеру, а также пароль на ключевой контейнер и его подтверждение.

...

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

Метод

POST

...

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

ОтсутствуютВідсутні

...

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

...

запиту
Content-Typeapplication/json

...

Параметри JSON

...

обʼєкта запиту
ИмяІмʼяТипОписаниеОписДопустимые значенияДопустимі параметри
NEW_KEY_TYPEStringТип генерируемого ключа или ключей.ключа чи ключів, які генеруються AGREEMENT - ключ звʼязку (шифрування), використовуваний для зашифрування даних
SIGNATURE - ключ електронного підписуAGREEMENT - ключ связи, используемый для шифрования данных
SIGNATURE - ключ электронной подписи
SIGNATURE_AND_AGREEMENT - ключ электронной подписи и ключ связиелектронного підпису та ключ звʼязку
PROFILE_IDStringOID профиля сертификатовЗначение параметра oid из профиля генерации ключейпрофіля сертифікатів

Значення параметру oid з профіля генерації ключів

TRANSPORT_CONTAINER_PASSWORDStringПароль на PKCS#12 контейнер, который будет возвращен как результат запросаТекстовая строкаякий буде повернено як результат запитуТекстовий рядок
Значення параметрів name обʼєкта
з масиву fields пофіля генерації ключів з oid = Значения параметров name объекта
из массива fields профиля генерации ключей
с oid равным PROFILE_ID		StringПараметры профиля генерации ключей с oid равным Параметри профіля генерації ключів з oid = PROFILE_IDЗависит от параметра

...

Залежить від параметру

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

...

Параметри JSON

...

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

...

Приклад коду на JavaScript + jQuery 2.2.4
Code Block
languagejs
 var 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;
    }
})

...