Versions Compared

Key

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

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

Для проверки открепленной электронной подписи в параметре signedData должны быть переданы данные, для которых была выработана электронная подпись.

Для проверки встроенной электронной подписи в параметре signedData может быть передано значение null. Если при проверке встроенной электронной подписи в параметре signedData передать отличное от null значение, то проверка будет выполнена не для встроенных в електронную подпись данных, а для данных, которые указаны в параметре signedData.

...

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

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

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

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

Метод

POST

...

Параметри запиту
uuidStringИдентификатор сессииІдентифікатор сесії

...

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

...

запиту
Content-Typeapplication/json

...

Параметри JSON

...

обʼєкта запиту
Имя

Імʼя

Тип

Описание

Опис

Допустимые значения

Допустимі значення

signedData

String
Данные, для которых была выработана электронная подпись
Дані для яких було створено ЕП.Base64
строка
рядок.
signatureString
Электронная подпись
ЕП.Base64
строка
рядок.

...

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

...

Параметри JSON

...

обʼєкта відповіді
ПараметрТип данныхданихОписаниеОпис
messageStringОписание результата проведения операцииОпис результату проведення операції
failureCause StringОписание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭПОпис причини виникнення помилки, яка виникла при виконанні запиту на перевірке ЕП
verifyResultsArrayРезультаты проверки отдельно по каждой из ЭПРезультату перевірки окремо по кожній з ЕП

Поля елемента масиву Поля элемента массива verifyResults

ПолеТип данныхданихОписаниеОпис
statusString"SUCCESS" - проверка ЭП произведена без ошибокперевірка ЕП здійснена без помилок
"FAILURE" - в процессе проверки ЭП возникли ошибкипроцесі перевірки ЕП виникли помилки
failureCauseStringОписание причины возникновения ошибки, которая возникла при непосредственной проверке ЭПОпис причини виникнення помилки, яка виникла при безпосереденій перевірці ЕП
signerInfoObjectИнформация из сертификата владельца ЭПІнформація із сертифіката власника ЕП
signingDateTimeStringВремя создания ЭПЧас створення ЕП
isValidBooleantrue - ЭП действительнаЕП дійсний
false - ЭП недействительнаЕП недійсний
contentTimestampObjectРезультат проверки электронной метки (ЭМВ) времени данных, для которых была создана ЭПперевірки електронної позначки часу (ЕПЧ) часу даних, для яких була створено ЕП
signatureTimestampsArrayРезультаты проверки электронных меток времени электронной подписиРезультати перевірки ЕПЧ підпису
isUntrustedValidBooleanДля проверки подписи использовалось время создания подписи, которое не заверено электронной меткой времениперевірки підпису використовується час створення підпису, який не завірено ЕПЧ.
true - ЭП действительнаЕП діюча
false - ЭП недействительнаЕП недіюча

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

ПолеТип данныхданихОписаниеОпис
isValidBooleantrue - ЭМВ действительнаЕПЧ діюча
false - ЭМВ недействительнаЕПЧ недіюча
isFailureBooleantrue - при проверке ЭМВ возникла ошибкаперевірці ЕПЧ виникла помилка
false - при проверке ЭМВ ошибок не возникалоперевірці ЕПЧ помилок не виникало
dateTimeDateTimeЗначение даты и времени в формате Значення дати та часу в форматі ISO 8601, которое заверено ЭМВяке завірено ЕПЧ
tsaCertificateSerialNumberObject*Серийный Серійний номер сертификата сертифікату TSP-серверасерверу

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

Anchor
signerInfo
signerInfo
signerInfo

ПолеТип данныхданихОписаниеОпис
ownerCertificateInfoПроверка ЭП для данных в запросеObject*Інформація про власника
issuerCertificateInfoИнформация о владельцеПроверка ЭП для данных в запросеObject*Інформація про видавця
publicKeyCertificateInfoИнформация об издателеПроверка ЭП для данных в запросеObject*Информация об открытом ключеІнформація про відкритий ключ
certificateSerialNumberObject*Серийный Серійний номер сертификатасертифікату
notBeforeObject*Начало действияПочаток дії
notAfterObject*Окончание действияЗавершення дії
extensionsCertificateInfoПроверка ЭП для данных в запросеObject*РасширенияРозширення

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

Anchor
ownerCertificateInfo
ownerCertificateInfo
Проверка ЭП для данных в запросеsignerInfo.ownerCertificateInfo.value

ПолеТип данныхданихОписаниеОпис
ownerSurnameObject*ФамилияПрізвище
ownerGivennameObject*Имя отчествоІмʼя по батькові
ownerFullNameObject*Полное имяПовне імʼя
ownerCountryObject*СтранаКраїна
ownerRegionObject*Область
ownerCityObject*ГородНаселений пункт
ownerAddressObject*Почтовый адресПоштова адреса
ownerSerialNumberObject*Серийный Серійний номер владельцавласника
ownerPositionObject*ДолжностьПосада

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

Anchor
issuerCertificateInfo
issuerCertificateInfo
 Проверка ЭП для данных в запросеsignerInfo.issuerCertificateInfo.value

ПолеТип данныхданихОписаниеОпис
issuerOrganizationObject*ОрганизацияОрганізація
issuerDepartmentObject*ПодразделениеПідрозділ
issuerFullNameObject*Полное имяПовне імʼя
issuerCountryObject*СтранаКраїна
issuerRegionObject*Область
issuerCityObject*ГородНаселений пункт
issuerAddressObject*Почтовый адресПоштова адреса
issuerSerialNumberObject*Серийный Серійний номер издателявласника

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

Anchor
publicKeyCertificateInfo
publicKeyCertificateInfo
 Проверка ЭП для данных в запросеsignerInfo.publicKeyCertificateInfo.value

ПолеТип данныхданихОписаниеОпис
publicKeyObject*Открытый Відкритий ключ
dsAlgorismObject*Алгоритм ЭПЕП

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

Anchor
extensionsCertificateInfo
extensionsCertificateInfo
 Проверка ЭП для данных в запросеsignerInfo.extensionsCertificateInfo.value

ПолеТип данныхданихОписаниеОпис
personalDataПроверка ЭП для данных в запросеObject*Персональные данныеПерсональні дані
alternativeOwnerNameObject*Альтернативное имя владельцаАльтернативне імʼя власника
subjectKeyIdObject*Идентификатор Ідентифікатор ключа
issuerKeyIdObject*Идентификатор Ідентифікатор ключа издателявидавця
subjectOwnerIdObject*Идентификатор владельцаІдентифікатор власника
certificateProfileObject*Профиль сертификатаПрофіль сертифікату
keyUsageObject*Назначение сертификатаПризначення сертифікату
isTemporaryObject*Признак Ознака стартового сертификатасертифікату
isReinforcedObject*Признак усиленного сертификатаОзнака посиленого сертифікату
isQualifiedObject*Признак квалифицированного сертификатаОзнака кваліфікованого сертифікату
isPrivateKeyOnQSCDObject*Признак средства КЭПОзнака засобу КЕП
qscdTypeNameObject*Тип средства КЭПзасобу КЕП
isElectronicStampObject*Признак электронной печатиОзнака електронної печатки

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

Anchor
personalData
personalData
 Проверка ЭП для данных в запросе.Проверка ЭП для данных в запросеsignerInfo.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
{
    "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"
                        }
                    }
                }
            }
        }
    ]
}

...