Ініціює процес синхронної перевірки ЕП для геша даних, які передаються у запиті.
Якщо в параметрі signature вказано вбудований ЕП, то перевірка буде виконана не для вбудованих в ЕП даних, а для геша даних, а для гешу даних, який вказано ув параметрі hashToVerify.
Увага
Метод підтримує захищені параметри.
Ознайомитись с описом та деталями використання захищених параметрів можливо за посиланням Створення та використання захищених параметрів.
Усі параметри JSON обʼєкту запиту можуть бути передані як захищені параметри. Якщо відкритий параметр та захищений параметр мають однакове ім'я, то буде використане значення захищеного параметра.
URL-адреса запиту
https://ccs-dev-api.cipher.kiev.ua/ccs/api/v1/ticket/{uuid}/ds/verifier/hash
Метод
PUT
Параметри запиту
| 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, елемента масиву signatureTimestamps
| Поле | Тип даних | Опис |
|---|---|---|
| isValid | Boolean | true - ЕПЧ дійсна false - ЕПЧ не дійсна |
| isFailure | Boolean | true - при перевірці ЕПЧ виникла помилка false - при перевірці ЕПЧ помилок не виникло |
| dateTime | DateTime | Значення дати та часу у форматі ISO 8601, яке завірено ЕПЧ |
| tsaCertificateSerialNumber | Object* | Серійний номер сертифікату TSP-серверу |
Поля обʼєкта signerInfo
| Поле | Тип даних | Опис |
|---|---|---|
| ownerCertificateInfo | Object* | Інформація про власника |
| issuerCertificateInfo | Object* | Інформація про видавця |
| publicKeyCertificateInfo | Object* | Інформація про відкритий ключ |
| certificateSerialNumber | Object* | Серійний номер сертифікату |
| notBefore | Object* | Початок дії |
| notAfter | Object* | Кінець дії |
| extensionsCertificateInfo | Object* | Розширення |
Поля обʼєкта signerInfo.ownerCertificateInfo.value
| Поле | Тип даних | Опис |
|---|---|---|
| ownerSurname | Object* | Прізвище |
| ownerGivenname | Object* | Імʼя по батькові |
| ownerFullName | Object* | Повне імʼя |
| ownerCountry | Object* | Країна |
| ownerRegion | Object* | Область |
| ownerCity | Object* | Населений пункт |
| ownerAddress | Object* | Поштова адреса |
| ownerSerialNumber | Object* | Серійний номер власника |
| ownerPosition | Object* | Посада |
Поля обʼєкта signerInfo.issuerCertificateInfo.value
| Поле | Тип даних | Опис |
|---|---|---|
| issuerOrganization | Object* | Організація |
| issuerDepartment | Object* | Підрозділ |
| issuerFullName | Object* | Повне імʼя |
| issuerCountry | Object* | Країна |
| issuerRegion | Object* | Область |
| issuerCity | Object* | Населений пункт |
| issuerAddress | Object* | Поштова адреса |
| issuerSerialNumber | Object* | Серійний номер власника |
Поля обʼєкта signerInfo.publicKeyCertificateInfo.value
Поля обʼєкта signerInfo.extensionsCertificateInfo.value
| Поле | Тип даних | Опис |
|---|---|---|
| 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
| Поле | Тип даних | Опис |
|---|---|---|
| customId | Object* | Зовнішній ідентифікатор |
| passport | Object* | Паспортні дані |
| drfou | Object* | Реєстраційний номер облікової картки платника податків |
edrpou | Object* | Код ЄДРПОУ |
eddrun | Object* | Унікальний номер запиту в ЄДДР |
Поля обʼєкта типу Object*
| Поле | Тип даних | Опис |
|---|---|---|
| description | String | Опис поля на мові, який обрано користувачем у Сервісі |
| value | [Object, String, Boolean, Number, Array, null] | Значення поля |
Приклад обʼєкта signerInfo
{
"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"
}
}
}
}
}
]
}