Генерация новых ключей

Доступно только в версии Enterprise.

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

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

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

Метод

POST

Параметры запроса

Отсутствуют

Настраиваемые заголовки запроса

Content-Type

application/json

Параметры JSON объекта запроса

Имя	Тип	Описание	Допустимые значения
NEW_KEY_TYPE	String	Тип генерируемого ключа или ключей.	AGREEMENT - ключ связи, используемый для шифрования данных SIGNATURE - ключ цифровой подписи SIGNATURE_AND_AGREEMENT - ключ цифровой подписи и ключ связи
PROFILE_ID	String	OID профиля сертификатов	Значение параметра oid из профиля генерации ключей
Значения параметров name объекта из массива fields профиля генерации ключей с oid равным PROFILE_ID	String	Параметри профиля генерации ключей с oid равным PROFILE_ID	Зависит от параметра

Ответ

Код ответа	Content-type	Допустимые параметры	Пример содержимого
200	application/json	message	{ "message": "Ключи успешно сгенерированы." }
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	Описание результата проведения операции

Пример кода на JavaScript + jQuery 2.2.4

 var keyGenerationData = {
    "NEW_KEY_TYPE" : "SIGNATURE",
	"PROFILE_ID" : "1.3.6.1.4.1.7845.2.1.12.3",
	"COMMON_NAME" : "Тестовый 14",
	"COUNTRY_NAME" : "ua",
	"GIVEN_NAME" : "Имя, отчество",
	"LOCALITY_NAME" : "Харьков",
	"STATE_OR_PROVINCE_NAME" : "Харьковская",
	"STREET_ADDRESS" : "пр. Науки, 7",
	"SURNAME" : "Фамилия",
	"TITLE" : "Должность",
	"ORGANIZATION_NAME" : "Организация",
	"ORGANIZATIONAL_UNIT_NAME" : "Подразделение",
	"DRFOU" : "121212",
	"PASSPORT" : "KH123447",
	"MAIL" : "test@cipher.com",
	"UNZR" : "01010101010115",
	"EXTERNAL_USER_ID" : "001"
};
$.ajax({
    url: "https://local.cipher.kiev.ua:9090/api/v1/generator/creator",
    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