Versions Compared

Key

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

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

URL-

...

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

https://local.cipher.kiev.ua:9090/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
Описание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭЦП
Опис причини виникнення помилки
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]
Значение
Значення поля

Пример объекта signerInfoПриклад даних сертифікату

Code Block
{
    "ownerCertificateInfo": {
        "description": "Власник",
        "value": {
            "ownerSurname": {"description": "Прізвище", "value": "Тестовый"},
            "ownerGivenname": {"description": "Імя по-батькові", "value": "Сертификат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"},
        }
     }
}
Пример кода на JavaScript + jQuery 2.2.4
Code Block
languagejs
$.ajax({
    url: "https://local.cipher.kiev.ua:9090/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;
"isPrivateKeyOnQSCD": {"description": "Засіб КЕП", "value": "false"},
            failureCause = jsonResponse.failureCause; 
    } catch (e) {
"qscdTypeName": {"description": "Тип засобу КЕП", "value": null},
         message = (xhr.responseText == undefined) ? "Ошибка при получении дынныхсертификата." : xhr.responseText; "isElectronicStamp" : {"description": "Електронна печатка", "value": "false"}
        }
    }
})

...