Page History

Запрос служит для получения данных сертификата ключа, который находится в ключевом контейнере сессии. Если ключ указанного типа отсутствует, будет возвращен пустой JSON объектЗапит служить для отримання даних сертифікату ключа, який знаходиться в ключовому контейнері сесії. Якщо ключ вказаного типу відсутній, буде повернуто порожній JSON обʼєкт.

URL-

...

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

https://local.cipher.kiev.ua:9090/api/v1/ticket/{uuid}/keyStore/certificate/info/{keyType}

Метод

...

PUT

...

PUT

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

uuid

String

Ідентифікатор сесії

keyType

String

Тип ключа

Допустимые значения

Допустимі значення:
signature -

электронная подпись

електронний підпис
keyAgreement -

согласование секретного ключа для шифрования данных

...

шифрування

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

Content-Type

application/json

...

Параметри JSON

...

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

ИмяІмʼя	Тип	ОписаниеОпис	Допустимые значенияДопустимі значення
keyStorePassword	String	Пароль к ключевому до ключового контейнеру сесиисесії	Строка, которая представляет собой пароль для доступа к ключевому контейнеру сессии. Ключевой контейнер сессии должен быть ранее загружен с помощью специального запроса.

Ответ

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

Відповідь

Код відповідіКод ответа	Content-type	Допустимые параметры	Допустимі параметри
200	application/json	ownerCertificateInfo issuerCertificateInfo publicKeyCertificateInfo certificateSerialNumber notBefore notAfter extensionsCertificateInfo
503	application/json	message	{ "message" : "СервисСервіс хранениязберігання данныхданих не запущензапущено." }
500	application/json	message failureCause	{ "message" : "ОшибкаПомилка при получениеотриманні информацииінформації опро сертификатесертифікат.", "failureCause" : "" }

...

Параметри JSON

...

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

Параметр	Тип данныхданих	ОписаниеОпис
message	String	Описание результата проведения операцииОпис результату проведення операції
failureCause	String	Описание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭП	Опис причини виникнення помилки
ownerCertificateInfo Получение данных сертификата	Object*	Інформація про власника
issuerCertificateInfo	Информация о владельце	Получение данных сертификата	Object*	Інформація про видавця
publicKeyCertificateInfo	Информация об издателе	Получение данных сертификата	Object*	Информация об открытом ключеІнформація про відкритий ключ
certificateSerialNumber	Object*	Серийный Серійний номер сертификатасертифікату
notBefore	Object*	Начало действияПочаток дії
notAfter	Object*	Окончание действия	Завершення строку дії
extensionsCertificateInfo Получение данных сертификата	Object*	РасширенияРозширення

Поля объекта обʼєкта

Anchor

	ownerCertificateInfo
	ownerCertificateInfo

ownerCertificateInfo.value

Поле	Тип данныхданих	ОписаниеОпис
ownerSurname	Object*	ФамилияПрізвище
ownerGivenname	Object*	Имя отчествоІмʼя по батькові
ownerFullName	Object*	Полное имяПовне імʼя
ownerCountry	Object*	СтранаКраїна
ownerRegion	Object*	Область
ownerCity	Object*	ГородНаселений пункт
ownerAddress	Object*	Почтовый адресПоштова адреса
ownerSerialNumber	Object*	Серийный Серійний номер владельцавласника
ownerPosition	Object*	ДолжностьПосада

Поля объектаобʼєкта

Anchor

	issuerCertificateInfo
	issuerCertificateInfo

issuerCertificateInfo.value

Поле	Тип данныхданих	ОписаниеОпис
issuerOrganization	Object*	ОрганизацияОрганізація
issuerDepartment	Object*	ПодразделениеПідрозділ
issuerFullName	Object*	Полное имяПовне імʼя
issuerCountry	Object*	СтранаКраїна
issuerRegion	Object*	Область
issuerCity	Object*	ГородНаселений пункт
issuerAddress	Object*	Почтовый адресПоштова адреса
issuerSerialNumber	Object*	Серийный Серійний номер издателявласника

Поля объектаобʼєкта

Anchor

	publicKeyCertificateInfo
	publicKeyCertificateInfo

publicKeyCertificateInfo.value

Поле	Тип данныхданих	ОписаниеОпис
publicKey	Object*	Открытый Відкритий ключ
dsAlgorism	Object*	Алгоритм ЭПЕП

Поля объектаобʼєкта

Anchor

	extensionsCertificateInfo
	extensionsCertificateInfo

extensionsCertificateInfo.value

Поле	Тип данныхданих	ОписаниеОпис
Получение данных сертификата personalData	Object*	Персональные данныеПерсональні дані
alternativeOwnerName	Object*	Альтернативное имя владельцаАльтернативне імʼя власника
subjectKeyId	Object*	Идентификатор Ідентифікатор ключа
subjectOwnerId	Object*	Идентификатор владельцаІдентифікатор власника
certificateProfile	Object*	Профиль сертификатаПрофіль сертифікату
keyUsage	Object*	Назначение сертификатаПризначення сертифікату
isTemporary	Object*	Признак Ознака стартового сертификатасертифікату
isReinforced	Object*	Признак усиленного сертификатаОзнака посиленого сертифікату
isQualified	Object*	Признак квалифицированного сертификатаОзнака кваліфікованого сертифікату
isPrivateKeyOnQSCD	Object*	Признак средства КЭПОзнака засобу КЕП
qscdTypeName	Object*	Тип средства КЭПзасобу КЕП
isElectronicStamp	Object*	Признак электронной печатиОзнака електронної печатки

Поля объектаобʼєкта

Anchor

	personalData
	personalData

Получение данных сертификата extensionsCertificateInfo.value.personalData.value

Поле	Тип данныхданих	ОписаниеОпис
customId	Object*	Внешний идентификаторЗовнішній ідентифікатор
passport	Object*	Паспортные данныеПаспортні дані
drfou	Object*	Регистрационный номер учетной карточки плательщика налоговРеєстраційний номер облікової картки платників податків
edrpou	Object*	Код ЕДПРОУЄДРПОУ
eddrun	Object*	Уникальный Унікальний номер записи запису в ЕГДРЄДДР

Поля объекта типа обʼєкта типу

Anchor

	CertObject
	CertObject

Object*

Поле	Тип данныхданих	ОписаниеОпис
description	String	Описание Опис поля на языке, который выбран пользователем в Сервисемові, яку обрано користувачем у Сервісі
value	[Object, String, Boolean, Number, Array, null]	Значение Значення поля

Пример данных сертификатаПриклад даних сертифікату

Code Block

{
    "ownerCertificateInfo": {
        "description": "Власник",
        "value": {
            "ownerSurname": {"description": "Прізвище", "value": "Тестовый"},
            "ownerGivenname": {"description": "Імя по-батькові", "value": "Сертификат6 Стартовый"},
            "ownerFullName": {"description": "Повне ім'я", "value": "Тестовый Сертификат 6"},
            "ownerCountry": {"description": "Країна", "value": "ua"},
            "ownerRegion": {"description": "Область", "value": "Харьковская"},
            "ownerCity": {"description": "Місто", "value": "Харьков"},
            "ownerAddress": {"description": "Поштова адреса", "value": "\"пр. Науки"},
            "ownerSerialNumber": {"description": "Серійний номер власника", "value": "46 30 07 62 53 88 0D 40"},
            "ownerPosition": {"description": "Посада", "value": "Розробник"}
        }
    },
    "issuerCertificateInfo": {
        "description": "Видавник",
        "value": {
            "issuerOrganization": {"description": "Організація", "value": "\"ТОВ \\\"Сайфер БІС\\\"\""},
            "issuerDepartment": {"description": "Підрозділ", "value": "Центр сертифікації ключів"},
            "issuerFullName": {"description": "Повне ім'я", "value": "\"ЦСК ТОВ \\\"Сайфер БІС\\\"\""},
            "issuerCountry": {"description": "Країна", "value": "ua"},
            "issuerRegion": {"description": "Область", "value": null},
            "issuerCity": {"description": "Місто", "value": "Київ"},
            "issuerAddress": {"description": "Поштова адреса", "value": null},
            "issuerSerialNumber": {"description": "Серійний номер видавця", "value": "46 30 07 62 53 88 0D 40"}
        }
    },
    "publicKeyCertificateInfo": {
        "description": "Інформація про відкритий ключ",
        "value": {
            "publicKey": {
                "description": "Відкритий ключ",
                "value": "8D 39 4C DA 49 7D 1D A7 46 92 FE 97 A4 1D 0B AD C3 B0 9F 1B 5C 07 8C 79 31 72 36 92 40 08 2E 13 00"
            }, "dsAlgorism": {"description": "Алгоритм ЕП", "value": "ДСТУ 4145-2002, ПБ, little-endian"}
        }
    }, "certificateSerialNumber": {"description": "Серійний номер сертифікату", "value": "E5 69 8B B0 4D A1 BF 2F"},
    "notBefore": {"description": "Початок дії", "value": "Sat Nov 19 00:00:00 EET 2016"},
    "notAfter": {"description": "Закінчення дії", "value": "Sun Nov 19 00:00:00 EET 2017"},
    "extensionsCertificateInfo": {
        "description": "Розширення",
        "value": {
            "personalData": {
                "description": "Персональні дані",
                "value": {
                    "customId": {"description": "Зовнішній ідентифікатор", "value": "000006"},
                    "passport": {"description": "Паспортні дані", "value": "КН000006"},
                    "drfou": {"description": "Реєстраційний номер облікової картки платника податків", "value": null},
                    "edrpou": {"description": "Код ЕДПРОУ", "value": null},
                    "eddrun": {"description": "Унікальний номер запису в ЄДДР", "value": null}
                }
            },
            "alternativeOwnerName": {"description": "Альтернативне ім'я власника", "value": "test@cipher.com"},
            "subjectKeyId": {
                "description": "Ідентифікатор ключа",
                "value": "B6 2F CE 32 A7 23 48 AB FB 26 F1 5A 4C 04 F9 1A 5E CF 03 D4 98 3E 86 AC 07 32 75 8D 59 37 4C A0"
            },
            "subjectOwnerId": {"description": "Ідентифікатор власника", "value": "46 30 07 62 53 88 0D 40"},
            "certificateProfile": {"description": "Профіль сертифіката", "value": "3"},
            "keyUsage": {"description": "ПризначеняПризначення сертифіката", "value": "Цифровий підпис, Невідрікаємість"},
            "isTemporary": {"description": "Стартовий", "value": "false"},
            "isReinforced": {"description": "Посилений", "value": "false"},
			"isQualified": {"description": "Кваліфікований", "value": "false"},
            "isPrivateKeyOnQSCD": {"description": "Засіб КЕП", "value": "false"},
            "qscdTypeName": {"description": "Тип засобу КЕП", "value": null},
            "isElectronicStamp" : {"description": "Електронна печатка", "value": "false"}
        }
    }
}

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

Code Block

language	js

$.ajax({
    url: "https://local.cipher.kiev.ua:9090/api/v1/ticket/{uuid}/keyStore/certificateInfo/signature",
    type: "PUT",
    dataType: "json",
	contentType: "application/json",
    data: JSON.stringify({keyStorePassword : "12345678"})
    cache: false
}).done(function (jsonResponse, textStatus, xhr) {
    certInfo = jsonResponse;
}).fail(function (xhr) {
    try {
        var jsonResponse = JSON.parse(xhr.responseText);
        message = jsonResponse.message;
        failureCause = jsonResponse.failureCause; 
    } catch (e) {
     "isElectronicStamp" :  message = (xhr.responseText == undefined) ? "Ошибка при получении данных сертификата." : xhr.responseText;{"description": "Електронна печатка", "value": "false"}
        }
    }
})

Page tree

Versions Compared

Old Version 10

New Version Current

Key

URL-

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

Метод

PUT

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

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

Параметри JSON

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

Ответ

Відповідь

Параметри JSON

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

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