Versions Compared

Key

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

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

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

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

Метод

PUT

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

...

Тип ключа

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

Note
titleУвага

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

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

https://ccs-dev-api.cipher.kiev.ua/ccs/api/v1/ticket/{uuid}/keyStore/certificate/info/{keyType}

Метод

PUT

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

Тип ключа

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

Налаштовувані заголовки запиту
Content-Typeapplication/json
Параметри JSON обʼєкта запиту
Імʼя
Тип
Налаштовувані заголовки запиту

...

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

keyStorePassword

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

...

ПараметрТип данихОпис
messageStringОпис результату проведення операції
failureCause StringОпис причини появи помилки, яка виникнення при відправці запиту на перевірке перевірку ЕП
ownerCertificateInfoObject*Інформація про власника
issuerCertificateInfoObject*Інформація про видавця
publicKeyCertificateInfoObject*Інформація про відкритий ключ
certificateSerialNumberObject*Серійний номер сертифікату
notBeforeObject*Початок дії
notAfterObject*Завершення строку дії
extensionsCertificateInfoObject*Розширення

...

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

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

, Array, null]Значення поля

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

Code Block
{
    "ownerCertificateInfo": {
Code Block
{
    "ownerCertificateInfo": {
        "description": "Власник",
        "value": {
            "ownerSurname": {"description": "Прізвище", "value": "Тестовий"},
            "ownerGivenname": {"description": "Імя по-батькові", "value": "Сертифікат 6 Стартовий"},
            "ownerFullName": {"description": "Повне ім'я", "value": "Тестовий Сертифікат 6"},
            "ownerCountry": {"description": "Країна", "value": "ua"},
            "ownerRegion": {"description": "ОбластьВласник",
        "value": "Харківська"},{
            "ownerCityownerSurname": {"description": "МістоПрізвище", "value": "ХарківТестовий"},
            "ownerAddressownerGivenname": {"description": "ПоштоваІмя адресапо-батькові", "value": "\"пр. НаукиСертифікат 6 Стартовий"},
            "ownerSerialNumberownerFullName": {"description": "Серійний номер власникаПовне ім'я", "value": "46 30 07 62 53 88 0D 40 "Тестовий Сертифікат 6"},
            "ownerPositionownerCountry": {"description": "ПосадаКраїна", "value": "Розробникua"},
        }
    },
    "issuerCertificateInfo": {
"ownerRegion": {"description": "Область", "value": "Харківська"},
            "descriptionownerCity": {"Видавець",
       description": "Місто", "value": {"Харків"},
            "issuerOrganizationownerAddress": {"description": "ОрганізаціяПоштова адреса", "value": "\"ТОВ \\\"Сайфер БІС\\\"\""пр. Науки"},
            "issuerDepartmentownerSerialNumber": {"description": "ПідрозділСерійний номер власника", "value": "Центр сертифікації ключів46 30 07 62 53 88 0D 40"},
            "issuerFullNameownerPosition": {"description": "Повне ім'яПосада", "value": "\"ЦСК ТОВ \\\"Сайфер БІС\\\"\""},Розробник"}
            "issuerCountry": {"description": "Країна", "value": "ua"}
    },
    "issuerCertificateInfo": {
       "issuerRegion": {"description": "ОбластьВидавець",
        "value": null},{
            "issuerCityissuerOrganization": {"description": "МістоОрганізація", "value": "Київ"},
            "issuerAddress": {"description": "Поштова адреса", "value": null\"ТОВ \\\"Сайфер БІС\\\"\""},
            "issuerSerialNumberissuerDepartment": {"description": "Серійний номер видавцяПідрозділ", "value": "46Центр 30 07 62 53 88 0D 40"}
        }
    сертифікації ключів"},
    "publicKeyCertificateInfo": {
       "issuerFullName": {"description": "Інформація про відкритий ключПовне ім'я",
        "value": {
            "publicKey": {"\"ЦСК ТОВ \\\"Сайфер БІС\\\"\""},
            "issuerCountry": {"description": "Країна",  "descriptionvalue": "Відкритий ключua"},
            "issuerRegion": {"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"
 null},
            "issuerCity": {"description": "Місто", "value": "Київ"},
            "issuerAddress": {"description": "Поштова адреса", "value": null},
           }, "dsAlgorismissuerSerialNumber": {"description": "АлгоритмСерійний номер ЕПвидавця", "value": "ДСТУ 4145-2002, ПБ, little-endian46 30 07 62 53 88 0D 40"}
        }
    }, 
,
    "publicKeyCertificateInfo": {
       "certificateSerialNumber": {"description": "СерійнийІнформація про номервідкритий сертифікатуключ",
        "value": {
 "E5 69 8B B0 4D A1 BF 2F"},
    "notBeforepublicKey": {"description": "Початок дії", "value": "Sat Nov 19 00:00:00 EET 2016"},

               "notAfter": {"description": "ЗакінченняВідкритий діїключ", "value": "Sun Nov 19 00:00:00 EET 2017"},

                "value"extensionsCertificateInfo": {
        "description": "Розширення",
        "value": {
            "personalData": {
: "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": "Алгоритм ЕП", "descriptionvalue": "Персональні дані",ДСТУ 4145-2002, ПБ, little-endian"}
        }
    }, 
    "valuecertificateSerialNumber": {
               "description": "Серійний номер сертифікату", "value": "E5 69 8B B0 4D A1 BF 2F"},
     "customIdnotBefore": {"description": "ЗовнішнійПочаток ідентифікатордії", "value": "000006"},
Sat Nov 19 00:00:00             EET 2016"},
    "passportnotAfter": {"description": "ПаспортніЗакінчення данідії", "value": "КН000006Sun Nov 19 00:00:00 EET 2017"},
    "extensionsCertificateInfo": {
        "description": "Розширення",
        "drfouvalue": {"description": "Реєстраційний номер облікової картки платника податків", "value": null},

            "personalData": {
               "edrpou": {"description": "КодПерсональні ЕДПРОУдані", "value": null},
                "value": {
   "eddrun": {"description": "Унікальний номер запису в ЄДДР", "value": null}
         "customId": {"description": "Зовнішній ідентифікатор",    }
  "value": "000006"},
          },
            "alternativeOwnerNamepassport": {"description": "Альтернативне ім'я власникаПаспортні дані", "value": "test@cipher.comКН000006"},
            "subjectKeyId": {
       "drfou": {"description": "Реєстраційний номер облікової картки платника  податків", "descriptionvalue": "Ідентифікатор ключа"null},
                    "valueedrpou": {"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": null},
                    "eddrun": {"description": "Унікальний номер запису в ЄДДР", "value": null}
                "subjectOwnerId": {"description": "Ідентифікатор власника", "value": "46 30 07 62 53 88 0D 40"}
            },
            "certificateProfilealternativeOwnerName": {"description": "Профіль сертифікатаАльтернативне ім'я власника", "value": "3test@cipher.com"},
            "keyUsagesubjectKeyId": {"description": "Призначеня сертифіката", "value
                "description": "Електронний підпис, Невідрікаємість"}Ідентифікатор ключа",
             "isTemporary": {"description": "Стартовий", "value": "false"},
            "isReinforced": {"description": "Посилений", "value": "false"},
			"isQualified": {"description": "Кваліфікований", "value": "false"},
     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"
       "isPrivateKeyOnQSCD": {"description": "Засіб КЕП", "value": "false"},
            "qscdTypeNamesubjectOwnerId": {"description": "ТипІдентифікатор засобу КЕПвласника", "value": null "46 30 07 62 53 88 0D 40"},
            "isElectronicStampcertificateProfile" : {"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);": "3"},
            "keyUsage": {"description": "Призначення сертифіката", "value": "Електронний підпис, Невідрікаємість"},
            "isTemporary": {"description": "Стартовий", "value": "false"},
            "isReinforced": {"description": "Посилений", "value": "false"},
			"isQualified": {"description": "Кваліфікований", "value": "false"},
            "isPrivateKeyOnQSCD": {"description": "Засіб КЕП", "value": "false"},
        message = jsonResponse.message;
  "qscdTypeName": {"description": "Тип засобу КЕП",  failureCause = jsonResponse.failureCause; 
"value": null},
       } catch (e) {
  "isElectronicStamp" : {"description": "Електронна печатка", "value": "false"} message  = (xhr.responseText == undefined) ? "Помилка при отриманні даних сертифікату." : xhr.responseText;      
        }
    }
})