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

...

}

Метод

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
Описание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭППолучение данных сертификата
Опис причини появи помилки, яка виникнення при відправці запиту на перевірку ЕП
ownerCertificateInfoObject*
Информация о владельце
Інформація про власника
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*Ознака стартового сертифікату
isReinforced
subjectOwnerId
Object*
Идентификатор владельца
Ознака посиленого сертифікату
isQualified
certificateProfile
Object*
Профиль сертификата
Ознака кваліфікованого сертифікату
isPrivateKeyOnQSCD
keyUsage
Object*
Назначение сертификата
Ознака засобу КЕП
qscdTypeName
isTemporary
Object*
Признак стартового сертификата
Тип засобу КЕП
isElectronicStamp
isReinforced
Object*
Признак усиленного сертификата
Ознака електронної печатки

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

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);
": "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": "Тип засобу КЕП", "value": null},
    failureCause = jsonResponse.failureCause; 
    } catch (e) {
        message = (xhr.responseText == undefined) ? "Ошибка при получении дынныхсертификата." : xhr.responseText;"isElectronicStamp" : {"description": "Електронна печатка", "value": "false"}         
        }
    }
})

...