Page History

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

Если Якщо в параметре signature указать встроенную электронную подпись, то проверка будет выполнена не для встроенных в электронную подпись данных, а для хеша данных, который указан в параметре hashToVerify.

URL-адрес запроса

параметрі signature вказано вбудований ЕП, то перевірка буде виконана не для вбудованих в ЕП даних, а для геша даних, а для гешу даних, який вказано ув параметрі hashToVerify.

Note

title	Увага

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

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

https://ccs-dev-api.cipher.kiev.ua/ccs/api/v1/https://localhost:9094/api/v1/ticket/{uuid}/ds/verifier/hash

Метод

POSTPUT

...

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

uuid

StringИдентификатор

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

...

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

...

запиту

Content-Type

application/json

...

Параметри JSON

...

обʼєкта запиту

Имя

Імʼя	Тип

Описание

Опис

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

Допустимі значення
hashToVerify	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

перевірки електронної позначки часу (ЕПЧ) даних для яких було створено ЕП
signatureTimestamps	Array	Результати перевірки ЕПЧ електронного підпису
isUntrustedValid	Boolean	Для перевірки ЕП використовується час створення ЕП, яке не завірено ЕПЧ. true - ЕП дійсна false - ЕП не дійсний
signatureType	String	Тип електронного підпису. Можливі значення: DETACHED ATTACHED ASIC_S ASIC_E
signatureFormat	String	Формат електронного підпису. Можливі значення: CADES_BES CADES_C CADES_T CADES_X_LONG XADES_B_B XADES_B_T XADES_B_LT XADES_B_LTA

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

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

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

Anchor

	signerInfo
	signerInfo

signerInfo

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

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

Anchor

	ownerCertificateInfo
	ownerCertificateInfo

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

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

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

Anchor

	issuerCertificateInfo
	issuerCertificateInfo

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

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

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

Anchor

	publicKeyCertificateInfo
	publicKeyCertificateInfo

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

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

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

Anchor

	extensionsCertificateInfo
	extensionsCertificateInfo

Проверка ЭП для хеша в запросе 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*	Признак электронной печатиОзнака електронної печатки

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

Anchor

	personalData
	personalData

Проверка ЭП для хеша в запросе.Проверка ЭП для хеша в запросеsignerInfo.extensionsCertificateInfo.value.personalData.value

Поле	Тип данныхданих	ОписаниеОпис
customId	Object*	Внешний идентификаторЗовнішній ідентифікатор
passport	Object*	Паспортные данныеПаспортні дані
drfou	Object*	Регистрационный номер учетной карточки плательщика налоговРеєстраційний номер облікової картки платника податків
edrpou	Object*	Код ЕДПРОУ ЄДРПОУ
eddrun	Object*	Уникальный Унікальний номер записи запиту в ЕГДРЄДДР

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

Anchor

	CertObject
	CertObject

Object*

Поле	Тип данныхданих	ОписаниеОпис
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"
                        }
                    }
                }
            }
        }
    ]
}

Page tree

Versions Compared

Old Version 1

New Version Current

Key

URL-адрес запроса

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

Метод

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

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

запиту

Параметри JSON

обʼєкта запиту

Відповідь

Параметри JSON

обʼєкта відповіді