Page History

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

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

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

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

https://signer.cipher.kiev.ua/api/v1/ticket/{uuid}/ds/verifier/data

Метод

POST

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

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	Результату перевірки окремо по кожній з ЕП

...

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

New Version Current

Key

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

Метод

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

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

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

Відповідь

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