Инициирует процесс синхронной проверки ЭП для хеша данных, который передается в запросеІніціює процес синхронної перевірки ЕП для гешу даних, які передаються у запиті.
Если Якщо в параметре signature указать встроенную электронную подпись, то проверка будет выполнена не для встроенных в электронную подпись данных, а для хеша данных, который указан в параметре параметрі signature вказати вбудований ЕП, то перевірка буде виконана не для вбудованого в ЕП даних, а для гешу даних, який вказано в параметрі hashToVerify.
URL-
...
адреса запиту
https://localhost:9092signer.cipher.kiev.ua/api/v1/ticket/{uuid}/ds/verifier/hash
Метод
POST
...
Параметри запиту
| uuid | StringИдентификатор | сессииІдентифікатор сесії |
...
Налаштовувані заголовки
...
запиту
| Content-Type | application/json |
...
Параметри JSON
...
обʼєкт запиту
Имя
Описание
Допустимые значения
Хеш данных
которых была выработана электронная подпись
строка
Электронная подпись
строка
Імʼя | Тип |
|---|
Опис |
|---|
Допустимі значення | |
|---|---|
hashToVerify | String |
| Геш даних, для |
| яких було створено ЕП. | Base64 |
| рядок. | |
| signature | String |
| Електронний підпис. | Base64 |
| рядок. |
...
Відповідь
| Код ответавідповіді | Content-type | Допустимые параметры | Допустимі параметри | Приклад вмістуПример содержимого |
|---|---|---|---|---|
| 200 | application/json | message verifyResults | { | |
| 503 | application/json | message | { | |
| 400 | application/json | message | { | |
| 406 | application/json | message verifyResults failureCause | { |
...
Параметри JSON
...
обʼєкта відповіді
| Параметр | Тип данныхданих | ОписаниеОпис | |
|---|---|---|---|
| message | String | Описание результата проведения операцииОпис результату проведення операції | |
| failureCause | String | Описание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭПОпис причини виникнення помилки, яка виникла при виконанні запиту на перевірку ЕП | |
| verifyResults | Array | Результаты проверки отдельно по каждой из ЭП | Результати перевірки окремо щодо кожного ЕП |
Поля елемента масиву Поля элемента массива verifyResults
| Поле | Тип данныхданих | ОписаниеОпис | ||
|---|---|---|---|---|
| status | String | "SUCCESS" - | проверка ЭП произведена без ошибокперевірка ЕП здійснена без помилок "FAILURE" - | в процессе проверки ЭП возникли ошибкиу процесі перевірки ЕП виникли помилки |
| failureCause | String | Описание причины возникновения ошибки, которая возникла при непосредственной проверке ЭПОпис причини виникнення помилки, яка виникла при безпосередній перевірці ЕП | ||
| signerInfo | Object | Информация из сертификата владельца ЭПІнформація з сертифікату власника ЕП | ||
| signingDateTime | String | Время создания ЭПЧас створення ЕП | ||
| isValid | Boolean | true - | ЭП действительнаЕП дійсний false - | ЭП недействительнаЕП недійсний |
| contentTimestamp | Object | Результат | проверки электронной метки (ЭМВ) времени данных, для которых была создана ЭПперевірки електронної позначки часу (ЕПЧ) даних, для яких була створена ЕП | |
| signatureTimestamps | Array | Результаты проверки электронных меток времени электронной подписиРезультати перевірки ЕПЧ електронного підпису | ||
| isUntrustedValid | Boolean | Для | проверки подписи использовалось время создания подписи, которое не заверено электронной меткой времениперевірки підпису, яке не завірено електронною позначкою часу. true - | ЭП действительнаЕП дійсна false - ЕП недійсна |
| signatureType | String | Тип електронного підпису.
| ||
| signatureFormat | String | Формат електронного підпису.
|
Поля обʼєкта contentTimestamp, елемента масиву Поля объекта contentTimestamp, элемента массива signatureTimestamps
| Поле | Тип данныхданих | ОписаниеОпис |
|---|---|---|
| isValid | Boolean | true - ЭМВ действительнаЕПЧ дійсна false - ЭМВ недействительнаЕПЧ недійсна |
| isFailure | Boolean | true - при проверке ЭМВ возникла ошибкаперевірці ЕПЧ виникла помилка false - при проверке ЭМВ ошибок не возникалоперевірці ЕПЧ помилок не виникало |
| dateTime | DateTime | Значение даты и времени в формате Значення дати та часу в форматі ISO 8601, которое заверено ЭМВяке завірено ЕПЧ |
| tsaCertificateSerialNumber | Object* | Серийный Серійний номер сертификата сертифікату TSP-сервера |
Поля объекта обʼєкта
| Anchor | ||||
|---|---|---|---|---|
|
| Поле | Тип данныхданих | Описание | Опис | |
|---|---|---|---|---|
| ownerCertificateInfoПроверка ЭП для хеша в запросе | Object* | Інформація про власника | ||
| issuerCertificateInfo | Информация о владельце | Проверка ЭП для хеша в запросе | Object* | Інформація про видавця |
| publicKeyCertificateInfo | Информация об издателе | Проверка ЭП для хеша в запросе | Object* | Информация об открытом ключеІнформація про відкритий ключ |
| certificateSerialNumber | Object* | Серийный Серійний номер сертификатасертифікату | ||
| notBefore | Object* | Начало действияПочаток дії | ||
| notAfter | Object* | Окончание действия | Завершення дії | |
| extensionsCertificateInfoПроверка ЭП для хеша в запросе | Object* | РасширенияРозширення |
Поля объекта обʼєкта
| Anchor | ||||
|---|---|---|---|---|
|
| Поле | Тип данныхданих | ОписаниеОпис |
|---|---|---|
| ownerSurname | Object* | ФамилияПрізвище |
| ownerGivenname | Object* | Имя отчествоІмʼя по батькові |
| ownerFullName | Object* | Полное имяПовне імʼя |
| ownerCountry | Object* | СтранаКраїна |
| ownerRegion | Object* | Область |
| ownerCity | Object* | ГородНаселений пункт |
| ownerAddress | Object* | Почтовый адресПоштова адреса |
| ownerSerialNumber | Object* | Серийный Серійний номер владельцавласника |
| ownerPosition | Object* | ДолжностьПосада |
Поля объектаобʼєкта
Проверка ЭП для хеша в запросеsignerInfo.issuerCertificateInfo.valueAnchor issuerCertificateInfo issuerCertificateInfo
| Поле | Тип данныхданих | ОписаниеОпис |
|---|---|---|
| issuerOrganization | Object* | ОрганизацияОрганізація |
| issuerDepartment | Object* | ПодразделениеПідрозділ |
| issuerFullName | Object* | Полное имяПовне імʼя |
| issuerCountry | Object* | СтранаКраїна |
| issuerRegion | Object* | Область |
| issuerCity | Object* | ГородНаселений пункт |
| issuerAddress | Object* | Почтовый адресПоштова адреса |
| issuerSerialNumber | Object* | Серийный Серійний номер издателявласника |
Поля объектаобʼєкта
Проверка ЭП для хеша в запросеsignerInfo.publicKeyCertificateInfo.valueAnchor publicKeyCertificateInfo publicKeyCertificateInfo
| Поле | Тип данныхданих | ОписаниеОпис |
|---|---|---|
| publicKey | Object* | Открытый Відкритий ключ |
| dsAlgorism | Object* | Алгоритм ЭПЕП |
Поля объектаобʼєкта
Проверка ЭП для хеша в запросеsignerInfo.extensionsCertificateInfo.valueAnchor extensionsCertificateInfo extensionsCertificateInfo
| Поле | Тип данныхданих | Описание | Опис |
|---|---|---|---|
| personalDataПроверка ЭП для хеша в запросе | Object* | Персональные данныеПерсональні дані | |
| alternativeOwnerName | Object* | Альтернативное имя владельцаАльтернативне імʼя власника | |
| subjectKeyId | Object* | Идентификатор Ідентифікатор ключа | |
| issuerKeyId | Object* | Идентификатор Ідентифікатор ключа издателявидавця | |
| subjectOwnerId | Object* | Идентификатор владельцаІдентифікатор власника | |
| certificateProfile | Object* | Профиль сертификатаПрофіль сертифікату | |
| keyUsage | Object* | Назначение сертификатаПризначення сертифікату | |
| isTemporary | Object* | Признак Ознака стартового сертификатасертифікату | |
| isReinforced | Object* | Признак усиленного сертификатаОзнака посиленого сертифікату | |
| isQualified | Object* | Признак квалифицированного сертификатаОзнака кваліфікованого сертифікату | |
| isPrivateKeyOnQSCD | Object* | Признак средства КЭПОзнака засобу ЕП | |
| qscdTypeName | Object* | Тип средства КЭПзасобу ЕП | |
| isElectronicStamp | Object* | Признак электронной печатиОзнака електронної печатки |
Поля объектаобʼєкта
Проверка ЭП для хеша в запросе.Проверка ЭП для хеша в запросеsignerInfo.extensionsCertificateInfo.value.personalData.value Anchor personalData personalData
| Поле | Тип данныхданих | ОписаниеОпис |
|---|---|---|
| customId | Object* | Внешний идентификаторЗовнішній ідентифікатор |
| passport | Object* | Паспортные данныеПаспортні дані |
| drfou | Object* | Регистрационный номер учетной карточки плательщика налогов Реєстраційний номер облікової картки платника податків |
edrpou | Object* | Код ЕДПРОУЕДРПОУ |
eddrun | Object* | Уникальный Унікальний номер записи запису в ЕГДРЄДР |
Поля объекта типа обʼєкта типу
| Anchor | ||||
|---|---|---|---|---|
|
| Поле | Тип данныхданих | ОписаниеОпис |
|---|---|---|
| description | String | Описание Опис поля на языке, который выбран пользователем в Сервисемові, який обрано користувачем у Сервісі |
| value | [Object, String, Boolean, Number, Array, null] | Значение Значення поля |
Пример объекта Приклад обʼєкта signerInfo
| Code Block |
|---|
{
"message": "Електронний підпис дійсний.",
"verifyResults": [
{
"status": "SUCCESS",
"failureCause": "",
"isValid": true,
"signingDateTime": "2020-03-05T13:25:36Z",
"contentTimestamp": {},
"signatureTimestamps": [
{
"isValid": true,
"isFailure": false,
"dateTime": "2020-03-05T13:25:39Z",
"tsaCertificateSerialNumber": "3DB73E7BF0D575B20200000001000000BB000000"
}
],
"signerInfo": {
"ownerCertificateInfo": {
"description": "Власник",
"value": {
"ownerSurname": {
"description": "Прізвище",
"value": "Боровіков"
},
"ownerGivenname": {
"description": "Імя по-батькові",
"value": "Олександр Михайлович"
},
"ownerFullName": {
"description": "Повне ім'я",
"value": "Боровіков Олександр Михайлович"
},
"ownerCountry": {
"description": "Країна",
"value": "UA"
},
"ownerRegion": {
"description": "Область",
"value": null
},
"ownerCity": {
"description": "Місто",
"value": "Київ"
},
"ownerAddress": {
"description": "Поштова адреса",
"value": null
},
"ownerSerialNumber": {
"description": "Серійний номер власника",
"value": "2423814"
},
"ownerPosition": {
"description": "Посада",
"value": null
},
"ownerOrganization": {
"description": "Організація",
"value": null
},
"ownerOrganizationUnit": {
"description": "Відділ (підрозділ)",
"value": null
}
}
},
"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": "UA-39384476-2018"
}
}
},
"publicKeyCertificateInfo": {
"description": "Інформація про відкритий ключ",
"value": {
"publicKey": {
"description": "Відкритий ключ",
"value": "C4 39 B0 5D 95 8A 6D 95 0E 4D F4 71 2A 62 59 6B A1 55 C9 6A 91 99 21 01 8E D3 7B B4 72 11 E6 F9 00"
},
"dsAlgorism": {
"description": "Алгоритм ЕП",
"value": "ДСТУ 4145-2002, ПБ, little-endian"
}
}
},
"certificateSerialNumber": {
"description": "Серійний номер сертифікату",
"value": "20B4E4ED0D30998C0400000006FC24004DAD7500"
},
"notBefore": {
"description": "Початок дії",
"value": "2019-06-10T21:00:00Z"
},
"notAfter": {
"description": "Закінчення дії",
"value": "2021-06-10T21:00:00Z"
},
"extensionsCertificateInfo": {
"description": "Розширення",
"value": {
"personalData": {
"description": "Персональні дані",
"value": {
"customId": {
"description": "Зовнішній ідентифікатор",
"value": null
},
"passport": {
"description": "Паспортні дані",
"value": null
},
"drfou": {
"description": "Реєстраційний номер облікової картки платника податків",
"value": "2031914098"
},
"edrpou": {
"description": "Код ЕДПРОУ",
"value": null
},
"eddrun": {
"description": "Унікальний номер запису в ЄДДР",
"value": null
}
}
},
"alternativeOwnerName": {
"description": "Альтернативне ім'я власника",
"value": null
},
"subjectKeyId": {
"description": "Ідентифікатор ключа",
"value": "9E 03 BA B2 24 4C 3D 02 09 41 08 8E 7E A3 E8 81 CD C6 90 58 B5 9B 38 1F 90 98 DC 5D F3 EF 61 8E"
},
"issuerKeyId": {
"description": "Ідентифікатор ключа видавця",
"value": "20 B4 E4 ED 0D 30 99 8C BE 30 6A 07 7D 69 9A 32 73 23 8A E9 09 08 71 D6 16 37 0E 18 E5 76 D4 7F"
},
"subjectOwnerId": {
"description": "Ідентифікатор власника",
"value": "00"
},
"certificateProfile": {
"description": "Профіль сертифіката",
"value": null
},
"keyUsage": {
"description": "ПризначеняПризначення сертифіката",
"value": "Електронний підпис, Невідрікаємість"
},
"isTemporary": {
"description": "Стартовий",
"value": "false"
},
"isReinforced": {
"description": "Посилений",
"value": "true"
},
"isQualified": {
"description": "Кваліфікований",
"value": "true"
},
"isPrivateKeyOnQSCD": {
"description": "Засіб КЕПЕП",
"value": "false"
},
"qscdTypeName": {
"description": "Тип засобу КЕПЕП",
"value": null
},
"isElectronicStamp" : {
"description": "Електронна печатка",
"value": "false"
}
}
}
}
}
]
} |