Запит служить для отримання даних сертифікату ключа, який знаходиться в ключовому контейнері сесії. Якщо ключ вказаного типу відсутній, будет повернуто порожній JSON обʼєкт.
Note | ||
---|---|---|
| ||
Метод підтримує захищені параметри. |
URL-адреса запиту
https://ccs-dev-api.cipher.kiev.ua/ccs/
Запрос служит для получения данных сертификата ключа, который находится в ключевом контейнере сессии. Если ключ указанного типа отсутствует, будет возвращен пустой JSON объект.
URL-адрес запроса
https://localhost:9094/api/v1/ticket/{uuid}/keyStore/certificate/info/{keyType}
Метод
PUT
...
Параметри запиту
uuid | String | Ідентифікатор сесії | |||||
keyType | String | Тип ключа | Допустимые значенияДопустимі значення: | электронная подписьелектронний підпис | согласование секретного ключа для зашифрования данных
...
шифрування |
Налаштовувані заголовки запиту
Content-Type | application/json |
...
Параметри JSON
...
обʼєкта запиту
ИмяІмʼя | Тип | ОписаниеОпис | Допустимые значенияДопустимі значення |
---|---|---|---|
keyStorePassword | String | Пароль к ключевому до ключового контейнеру сессиисесії | Строка, которая представляет собой пароль для доступа к ключевому контейнеру сессии. Ключевой контейнер сессии должен быть ранее загружен с помощью специального запроса. |
Ответ
Рядок, який являє собою пароль для доступу до ключового контейнеру. Ключовий контейнер сесії має бути раніше завантажений за допомогою спеціального запиту. |
Відповідь
Код відповідіКод ответа | Content-type | Допустимые параметры | Допустимі параметри | Приклад вмістуПример содержимого |
---|---|---|---|---|
200 | application/json | ownerCertificateInfo issuerCertificateInfo publicKeyCertificateInfo certificateSerialNumber notBefore notAfter extensionsCertificateInfo | ||
503 | application/json | message | { | |
500 | application/json | message failureCause | { |
...
Параметри JSON
...
обʼєкта відповіді
Параметр | Тип данныхданих | ОписаниеОпис | ||
---|---|---|---|---|
message | String | Описание результата проведения операцииОпис результату проведення операції | ||
failureCause | String | Описание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭП | Опис причини появи помилки, яка виникнення при відправці запиту на перевірку ЕП | |
ownerCertificateInfoПолучение данных сертификата | Object* | Інформація про власника | ||
issuerCertificateInfo | Информация о владельце | Получение данных сертификата | Object* | Інформація про видавця |
publicKeyCertificateInfo | Информация об издателе | Получение данных сертификата | Object* | Информация об открытом ключеІнформація про відкритий ключ |
certificateSerialNumber | Object* | Серийный Серійний номер сертификатасертифікату | ||
notBefore | Object* | Начало действияПочаток дії | ||
notAfter | Object* | Окончание действия | Завершення строку дії | |
extensionsCertificateInfoПолучение данных сертификата | Object* | РасширенияРозширення |
Поля объекта обʼєкта
Anchor | ||||
---|---|---|---|---|
|
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
ownerSurname | Object* | ФамилияПрізвище |
ownerGivenname | Object* | Имя отчествоІмʼя по батькові |
ownerFullName | Object* | Полное имяПовне імʼя |
ownerCountry | Object* | СтранаКраїна |
ownerRegion | Object* | Область |
ownerCity | Object* | ГородНаселений пункт |
ownerAddress | Object* | Почтовый адресПоштова адреса |
ownerSerialNumber | Object* | Серийный Серійний номер владельцавласника |
ownerPosition | Object* | ДолжностьПосада |
Поля объектаобʼєкта
issuerCertificateInfo.value Anchor issuerCertificateInfo issuerCertificateInfo
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
issuerOrganization | Object* | ОрганизацияОрганізація |
issuerDepartment | Object* | ПодразделениеПідрозділ |
issuerFullName | Object* | Полное имяПовне імʼя |
issuerCountry | Object* | СтранаКраїна |
issuerRegion | Object* | Область |
issuerCity | Object* | ГородНаселений пункт |
issuerAddress | Object* | Почтовый адресПоштова адреса |
issuerSerialNumber | Object* | Серийный Серійний номер издателявласника |
Поля объектаобʼєкта
publicKeyCertificateInfo.value Anchor publicKeyCertificateInfo publicKeyCertificateInfo
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
publicKey | Object* | Открытый Відкритий ключ |
dsAlgorism | Object* | Алгоритм ЭПЕП |
Поля объектаобʼєкта
extensionsCertificateInfo.value Anchor extensionsCertificateInfo extensionsCertificateInfo
Поле | Тип данныхданх | ОписаниеОпис | |
---|---|---|---|
Получение данных сертификатаpersonalData | Object* | Персональные данныеПерсональні дані | |
alternativeOwnerName | Object* | Альтернативное имя владельцаАльтернативне імʼя власника | |
subjectKeyId | Object* | Идентификатор ключа | Ідентифікатор ключа |
subjectOwnerId | Object* | Ідентифікатор власника | |
certificateProfile | Object* | Профіль сертифікату | |
keyUsage | Object* | Призначення сертифікату | |
isTemporary | Object* | Ознака стартового сертифікату | |
isReinforcedsubjectOwnerId | Object* | Идентификатор владельца | Ознака посиленого сертифікату |
isQualifiedcertificateProfile | Object* | Профиль сертификата | Ознака кваліфікованого сертифікату |
isPrivateKeyOnQSCDkeyUsage | Object* | Назначение сертификата | Ознака засобу КЕП |
qscdTypeNameisTemporary | Object* | Признак стартового сертификата | Тип засобу КЕП |
isElectronicStampisReinforced | Object* | Признак усиленного сертификатаОзнака електронної печатки |
Поля объектаобʼєкта
Получение данных сертификата extensionsCertificateInfo.value.personalData.value Anchor personalData personalData
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
customId | Object* | Внешний идентификаторЗовнішній ідентифікатор |
passport | Object* | Паспортные данныеПаспортні дані |
drfou | Object* | Регистрационный номер учетной карточки плательщика налоговРеєстраційний номер облікової картки платників податків |
edrpou | Object* | Код ЕДПРОУЄДРПОУ |
eddrun | Object* | Уникальный Унікальний номер записи запису в ЕГДРЄДДР |
Поля объекта типа обʼєкта типу
Anchor | ||||
---|---|---|---|---|
|
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
description | String | Описание Опис поля на языке, который выбран пользователем в Сервисемові, яку обрано користувачем у Сервісі |
value | [Object, String, Boolean, Number, Array, null] | Значение Значення поля |
Пример данных сертификатаПриклад даних сертифікату
Code Block |
---|
{ "ownerCertificateInfo": { "description": "Власник", "value": { "ownerSurname": {"description": "Прізвище", "value": "ТестовыйТестовий"}, "ownerGivenname": {"description": "Імя по-батькові", "value": "Сертификат6Сертифікат 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 8B B0 4D A1 BF 2F"}, "notAfternotBefore": {"description": "ЗакінченняПочаток дії", "value": "SunSat Nov 19 00:00:00 EET 20172016"}, "extensionsCertificateInfonotAfter": { "description": "РозширенняЗакінчення дії", "value": { "Sun Nov 19 00:00:00 EET 2017"}, "personalDataextensionsCertificateInfo": { "description": "Персональні даніРозширення", "value": { "customId": {"description": "Зовнішній ідентифікатор", "valuepersonalData": "000006"}, { "passport": {"description": "ПаспортніПерсональні дані", "value": "КН000006"},{ "drfoucustomId": {"description": "Реєстраційний номер облікової картки платника податків": "Зовнішній ідентифікатор", "value": null"000006"}, "edrpoupassport": {"description": "КодПаспортні ЕДПРОУдані", "value": null"КН000006"}, "eddrundrfou": {"description": "УнікальнийРеєстраційний номер облікової записукартки вплатника ЄДДРподатків", "value": null}, "edrpou": {"description": "Код ЕДПРОУ", "value": null}, }, "alternativeOwnerNameeddrun": {"description": "Альтернативне ім'я власникаУнікальний номер запису в ЄДДР", "value": "test@cipher.com"null}, } "subjectKeyId": { }, "alternativeOwnerName": {"description": "Ідентифікатор ключаАльтернативне ім'я власника", "value": "test@cipher.com"}, "valuesubjectKeyId": "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" { "description": "Ідентифікатор ключа", "value": "B6 2F }, CE 32 A7 23 48 AB FB 26 F1 5A 4C 04 "subjectOwnerId": {"description": "Ідентифікатор власника", "value": "46 30 07 62 53 88 0D 40"}, F9 1A 5E CF 03 D4 98 3E 86 AC 07 32 75 8D 59 37 4C A0" "certificateProfile": {"description": "Профіль сертифіката", "value": "3"}, "keyUsagesubjectOwnerId": {"description": "ПризначеняІдентифікатор сертифікатавласника", "value": "Електронний46 підпис, Невідрікаємість"}, "isTemporary": {"description": "Стартовий", "value": "false30 07 62 53 88 0D 40"}, "isReinforcedcertificateProfile": {"description": "ПосиленийПрофіль сертифіката", "value": "false"} } } } |
Пример кода на JavaScript + jQuery 2.2.4
Code Block | ||
---|---|---|
| ||
$.ajax({ url: "https://localhost:9094/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) { message = (xhr.responseText == undefined) ? "Ошибка при получении дынныхсертификата." : xhr.responseText;": "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"} } } }) |