Page History

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

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

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

https://signer.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	{ "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 - КЕП ЕП недійсна
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

...

Поле	Тип даних	Опис
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*	Унікальний номер запису в ЄДР

...

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 10

New Version Current

Key

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

Метод

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

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

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

Відповідь

Параметри JSON обʼєкта відповіді