Versions Compared

Key

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

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

URL-

...

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

https://localhost:9094/api/v1/ticket/{uuid}/keyStore/certificate/info/{keyType}

Метод

PUT

...

Параметри запиту
uuidStringИдентификатор сессииІдентифікатор сесії
keyTypeString

Тип ключа

Допустимые значенияДопустимі значення:
signature - электронная подписьелектронний підпис
keyAgreement - согласование секретного ключа для зашифрования данных

...

шифрування

Налаштовувані заголовки запиту
Content-Typeapplication/json

...

Параметри JSON

...

обʼєкта запиту
ИмяІмʼя
Тип
ОписаниеОпис
Допустимые значенияДопустимі значення

keyStorePassword

StringПароль к ключевому до ключового контейнеру сессиисесіїСтрока, которая представляет собой пароль для доступа к ключевому контейнеру сессии. Ключевой контейнер сессии должен быть ранее загружен с помощью специального запроса.
Ответ
Рядок, який являє собою пароль для доступу до ключового контейнеру оль для доступа сесії. Ключовий контейнер сесії має бути раніше завантажений за допомогою спеціального запиту.
Відповідь
Код відповідіКод ответаContent-typeДопустимые параметрыДопустимі параметриПриклад вмістуПример содержимого
200application/jsonownerCertificateInfo
issuerCertificateInfo

publicKeyCertificateInfo
certificateSerialNumber
notBefore
notAfter
extensionsCertificateInfo

503application/jsonmessage
{
       "message" : "СервисСервіс хранениязберігання данныхданих не запущензапущено."
}
500application/jsonmessage
failureCause

{
       "message" : "ОшибкаПомилка при получение отриманні інформації про сертифікатение информации о сертификате.",
"failureCause" : ""
}

...

Параметри JSON

...

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

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

Anchor
ownerCertificateInfo
ownerCertificateInfo
ownerCertificateInfo.value

ПолеТип данныхданихОписаниеОпис
ownerSurnameObject*ФамилияПрізвище
ownerGivennameObject*Имя отчествоІмʼя по батькові
ownerFullNameObject*Полное имяПовне імʼя
ownerCountryObject*СтранаКраїна
ownerRegionObject*Область
ownerCityObject*ГородНаселений пункт
ownerAddressObject*Почтовый адресПоштова адреса
ownerSerialNumberObject*Серийный Серійний номер владельцавласника
ownerPositionObject*ДолжностьПосада

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

Anchor
issuerCertificateInfo
issuerCertificateInfo
issuerCertificateInfo.value

ПолеТип данныхданихОписаниеОпис
issuerOrganizationObject*ОрганизацияОрганізація
issuerDepartmentObject*ПодразделениеПідрозділ
issuerFullNameObject*Полное имяПовне імʼя
issuerCountryObject*СтранаКраїна
issuerRegionObject*Область
issuerCityObject*ГородНаселений пункт
issuerAddressObject*Почтовый адресПоштова адреса
issuerSerialNumberObject*Серийный Серійний номер издателявласника

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

Anchor
publicKeyCertificateInfo
publicKeyCertificateInfo
publicKeyCertificateInfo.value

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

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

Anchor
extensionsCertificateInfo
extensionsCertificateInfo
extensionsCertificateInfo.value

ПолеТип данныхданхОписаниеОпис
Получение данных сертификатаpersonalDataObject*Персональные данныеПерсональні дані
alternativeOwnerNameObject*Альтернативное имя владельцаАльтернативне імʼя власника
subjectKeyIdObject*Идентификатор Ідентифікатор ключа
subjectOwnerIdObject*Идентификатор владельцаІдентифікатор власника
certificateProfileObject*Профиль сертификатаПрофіль сертифікату
keyUsageObject*Назначение сертификатаПризначення сертифікату
isTemporaryObject*Признак Ознака стартового сертификатасертифікату
isReinforcedObject*Признак усиленного сертификатаОзнака посиленого сертифікату
isQualifiedObject*Признак квалифицированного сертификатаОзнака кваліфікованого сертифікату
isPrivateKeyOnQSCDObject*Признак средства КЭПОзнака засобу КЕП
qscdTypeNameObject*Тип средства КЭПзасобу КЕП
isElectronicStampObject*Признак электронной печатиОзнака електронної печатки

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

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

ПолеТип данныхданихОписаниеОпис
customIdObject*Внешний идентификаторЗовнішній ідентифікатор
passportObject*Паспортные данныеПаспортні дані
drfouObject*Регистрационный номер учетной карточки плательщика налоговРеєстраційний номер облікової картки платників податків

edrpou

Object*Код ЕДПРОУЄДРПОУ

eddrun

Object*

Уникальный Унікальний номер записи запису в ЕГДРЄДДР

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

Anchor
CertObject
CertObject
Object* 

ПолеТип данныхданихОписаниеОпис
descriptionStringОписание Опис поля на языке, который выбран пользователем в Сервисемові, яку обрано користувачем у Сервісі
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"},
    "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
languagejs
$.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;
    }
})

...