Versions Compared

Key

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

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

Note
titleУвага

Метод підтримує захищені параметри. 
Ознайомитись с описом та деталями використання захищених параметрів можливо за посиланням Створення та використання захищених параметрів.
Усі параметри JSON обʼєкту запиту можуть бути передані як захищені параметри. Якщо відкритий параметр та захищений параметр мають однакове ім'я, то буде використане значення захищеного параметра.

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

https://ccs-dev-api.cipher.kiev.ua/ccs/

Запрос служит для получения данных сертификата ключа, который находится в ключевом контейнере сессии.  Если ключ указанного типа  отсутствует, будет возвращен пустой 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*Ознака стартового сертифікату
isReinforcedsubjectOwnerIdObject*Идентификатор владельцаОзнака посиленого сертифікату
isQualifiedcertificateProfileObject*Профиль сертификатаОзнака кваліфікованого сертифікату
isPrivateKeyOnQSCDkeyUsageObject*Назначение сертификатаОзнака засобу КЕП
qscdTypeNameisTemporaryObject*Признак стартового сертификатаТип засобу КЕП
isElectronicStampisReinforcedObject*Признак усиленного сертификатаОзнака електронної печатки

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

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 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
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;": "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"}         
        }
    }
})