Перевірка ЕП для даних у запиту

Ініціює процес синхронної перевірки ЕП для даних, які передаються у запиті.

Для перевірки відкріпленого підпису в параметрі signedData мають бути передані дані, для яких було створено електронний підпис.

Для перевірки електронного підпису в параметрі signedData може бути передано значення null. Якщо при перевірці вбудованого електронного підпису Если прив параметрі signedData передати відмінне від null значення, то перевірка буде здійснена не для вбудованих в електронний підпис даних, а для даних, які вказані в параметрі signedData.

Увага

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

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

https://localhost:9094/api/v1/ticket/{uuid}/ds/verifier/data

Метод

PUT

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

uuid

String

Ідентифікатор сесії

Налаштовувані заголовки запиту

Content-Type

application/json

Параметри JSON обʼєкта запиту

Імʼя	Тип	Опис	Допустимі значення
signedData	String	Дані, для яких було створено електронний підпис.	Base64 рядок.
signature	String	Електронний підпис.	Base64 рядок.

Відповідь

Код відповіді	Content-type	Допустимі параметри	Приклад вмісту
200	application/json	message verifyResults	{ "message" : "Електронний підпис дійсний.", "verifyResults" : Array }
503	application/json	message	{ "message" : "Сервіс виконання криптографічних операцій не запущено." }
400	application/json	message	{ "message" : "Сесія відсутня." }
406	application/json	message verifyResults failureCause	{ "message" : "Електронний підпис не дійсний.", "failureCause" : "", "verifyResults" : Array }

Параметри 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 - ЕП не дійсний

Поля обʼєкта contentTimestamp, елемента масиву signatureTimestamps

Поле	Тип даних	Опис
isValid	Boolean	true - ЕПЧ дійсна false - ЕПЧ не дійсна
isFailure	Boolean	true - при перевірці ЕПЧ виникла помилка false - при перевірці ЕПЧ помилок не виникло
dateTime	DateTime	Значення дати та часу у форматі ISO 8601, яке завірено ЕПЧ
tsaCertificateSerialNumber	Object*	Серійний номер сертифікату TSP-серверу

Поля обʼєкта signerInfo

Поле	Тип даних	Опис
Перевірка ЕП для даних у запиту	Object*	Інформація про власника
Перевірка ЕП для даних у запиту	Object*	Інформація про видавця
Перевірка ЕП для даних у запиту	Object*	Інформація про відкритий ключ
certificateSerialNumber	Object*	Серійний номер сертифікату
notBefore	Object*	Початок дії
notAfter	Object*	Кінець дії
Перевірка ЕП для даних у запиту	Object*	Розширення

Поля обʼєкта Перевірка ЕП для даних у запиту.ownerCertificateInfo.value

Поле	Тип даних	Опис
ownerSurname	Object*	Прізвище
ownerGivenname	Object*	Імʼя по батькові
ownerFullName	Object*	Повне імʼя
ownerCountry	Object*	Країна
ownerRegion	Object*	Область
ownerCity	Object*	Населений пункт
ownerAddress	Object*	Поштова адреса
ownerSerialNumber	Object*	Серійний номер власника
ownerPosition	Object*	Посада

Поля обʼєкта Перевірка ЕП для даних у запиту.issuerCertificateInfo.value

Поле	Тип даних	Опис
issuerOrganization	Object*	Організація
issuerDepartment	Object*	Підрозділ
issuerFullName	Object*	Повне імʼя
issuerCountry	Object*	Країна
issuerRegion	Object*	Область
issuerCity	Object*	Населений пункт
issuerAddress	Object*	Поштова адреса
issuerSerialNumber	Object*	Серійний номер власника

Поля обʼєкта Перевірка ЕП для даних у запиту.publicKeyCertificateInfo.value

Поле	Тип даних	Опис
publicKey	Object*	Відкритий ключ
dsAlgorism	Object*	Алгоритм ЕП

Поля обʼєкта Перевірка ЕП для даних у запиту.extensionsCertificateInfo.value

Поле	Тип даних	Опис
Перевірка ЕП для даних у запиту	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*	Ознака електронної печатки

Поля обʼєкта Перевірка ЕП для даних у запиту.Перевірка ЕП для даних у запиту.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"
                        }
                    }
                }
            }
        }
    ]
}

Page tree