Versions Compared

Key

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

Запрос служит для получения результата проверки ЭЦП. Запрос является блокирующим, то есть результат будет получен только после завершения процесса проверки ЭЦП, если такой был ранее запущен. Если ЭЦП действительна, будет возвращен Запит служить для отримання результату перевірки ЕП. Запит є блокуючим, тобто результат буде отримано лише після завершення процесу перевірки ЕП, якщо такий був раніше запущений. Якщо ЕП дійсний, то буде повернуто HTTP статус код 200. Если в ЭЦП не действительна или в процессе ее непосредственной проверки возникли ошибки, будет возвращен HTTP Якщо ЕП недійсний чи в процессі безпосередньої перевірки виникли помилки, буде повернуто HTTP статус код 406. При возникновении других типов ошибок, возвращаются HTTP статус коды 503 или виникненні інших типів помилок, повертається HTTP статус код 503 чи 400.

URL-

...

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

https://local.cipher.kiev.ua:9091/api/v1/ticket/{uuid}/ds/verifier

Метод

GET

...

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

...

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

...

запиту

ОтсутствуетВідсутні

...

Відповідь
Код
ответа
відповідіContent-type
Допустимые параметрыПример содержимого
Допустимі параметриПриклад вмісту
200application/jsonmessage
verifyResults 
{
"message" : "
Цифровая
Електронний 
подпись
підпис 
действительна
дійсний."

}503
,
"verifyResults" : Array
}
503application/jsonmessage
{
   
    "message" : "
Сервис
Сервіс 
выполнения
виконання 
криптографических
криптографічних 
операций
операцій не 
запущен
запущено." 
}
400application/jsonmessage
{
   
    "message" : "
Сессия
Сесія 
отсутствует
відсутня." 
}
406application/jsonmessage
verifyResults
failureCause
{
   
    "message" : "
Цифровая
Електронний 
подпись
підпис не 
действительна
дійсний.",
"failureCause" : "",
"verifyResults" :
Object
Array
}

...

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

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

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

...

ЕП недійсна
contentTimestampObjectРезультат перевірки ЕПЧ даних, для яких було створено ЕП
signatureTimestampsArrayРезультат перевірки ЕПЧ ЕП, для яких було створено ЕП
isUntrustedValidBoolean

Для перевірки підпису використовується час створення ЕП, яке не завірено ЕПЧ
true - ЕП дійсна
false - ЕП недійсна

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

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

Поля об'єкта

Anchor
signerInfo
signerInfo
signerInfo

ПолеТип данихОпис
ownerCertificateInfoObject*Інформація про власника
issuerCertificateInfoObject*Інформація про видавця
publicKeyCertificateInfoObject*Інформація про відкритий ключ
certificateSerialNumberObject*Серійний номер сертифікату
notBeforeObject*Початок дії
notAfterObject*Завершення дії
extensionsCertificateInfoObject*Розширення

Поля об'єкта

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

ПолеТип данхОпис
personalDataObject*Персональні дані
alternativeOwnerNameObject*Альтернативне ім'я власника
subjectKeyIdObject*Ідентифікатор ключа
issuerKeyIdObject*Ідентифікатор ключа власника
subjectOwnerIdObject*Ідентифікатор власника
certificateProfileObject*Профіль сертифікату
keyUsageObject*Призначення сертифікату
isTemporaryObject*Ознака стартового сертифікату
isReinforcedObject*Ознака посиленого сертифікату

Поля об'єкта

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
ПолеТип данныхОписание
Получение результата проверки ЭЦПObject*Информация о владельце
Получение результата проверки ЭЦПObject*Информация об издателе
Получение результата проверки ЭЦПObject*Информация об открытом ключе
certificateSerialNumberObject*Серийный номер сертификата
notBeforeObject*Начало действия
notAfterObject*Окончание действия
Получение результата проверки ЭЦПObject*Расширения

...

ПолеТип данныхОписание
ownerSurnameObject*Фамилия
ownerGivennameObject*Имя отчество
ownerFullNameObject*Полное имя
ownerCountryObject*Страна
ownerRegionObject*Область
ownerCityObject*Город
ownerAddressObject*Почтовый адрес
ownerSerialNumberObject*Серийный номер владельца
ownerPositionObject*Должность

...

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

...

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

...

ПолеТип данныхОписание
Получение результата проверки ЭЦПObject*Персональные данные
alternativeOwnerNameObject*Альтернативное имя владельца
subjectKeyIdObject*Идентификатор ключа
subjectOwnerIdObject*Идентификатор владельца
certificateProfileObject*Профиль сертификата
keyUsageObject*Назначение сертификата
isTemporaryObject*Признак стартового сертификата
isReinforcedObject*Признак усиленного сертификата

...

ПолеТип данныхОписание
customIdObject*Внешний идентификатор
passportObject*Паспортные данные
drfouObject*Индивидуальный налоговый номер

...

ПолеТип данныхОписание
descriptionStringОписание поля на языке, который выбран пользователем в Сервисе
value[Object, String, Boolean, Number, Array]Значение поля

Пример объекта signerInfo

Code Block
"message": "Цифровая подпись недействительна.",
"verifyResults": [{
    "status": "SUCCESS",
    "signerInfo": {
        "ownerCertificateInfo": {
               "description": "Владелец",
            "valuedescription": {"Паспортні дані",
                "ownerSurname": {"description": "Фамилия", "value": "Стокипный"},
                "ownerGivennamevalue": {"description": "Имя отчество", "value": "Александр Леонидович"},
 null
                         "ownerFullName": {"description": "Полное имя", "value": "Стокипный Александр Леонидович"},
                    "ownerCountry": {"description": "Страна", "value": "ua"},
             "drfou": {
               "ownerRegion": {"description": "Область", "value": "Харьковская"},
                "ownerCity": {"description": "Город", "value": "Харьков"}Реєстраційний номер облікової картки платника податків",
                "ownerAddress": {"description": "Почтовый адрес", "value": "вул.Харьковская 17"},
                "ownerSerialNumbervalue": {"2031914098"
                    "description": "Серийный номер владельца",
            },
                      "value": "E7 49 6E 9F 33 07 6E 5B"          "edrpou": {
                },
                 "ownerPosition": {"description": "Должность", "valuedescription": "Разработчик"}
   "Код ЕДПРОУ",
          }
        },
        "issuerCertificateInfo": {
            "descriptionvalue": "Издатель",null
             "value": {
                "issuerOrganization": {"description": "Организация", "value": "\"ТОВ \\\"Сайфер БІС\\\"\""},
 },
                                "issuerDepartmenteddrun": {"description": "Подразделение", "value": "Центр сертифікації ключів"},

                            "issuerFullName": {"description": "Полное имя", "value": "\"ЦСК ТОВ \\\"Сайфер БІС\\\"\description": "},
Унікальний номер запису в ЄДДР",
            "issuerCountry": {"description": "Страна", "value": "ua"},
                     "issuerRegion": {"description": "Область", "value": null},
                "issuerCity": {"description": "Город", "value": "Київ"},                }
                "issuerAddress": {"description": "Почтовый адрес", "value": null},
            }
                    "issuerSerialNumber": {"description": "Серийный номер издателя"}, "value": "E7 49 6E 9F 33 07 6E 5B"}

                        "alternativeOwnerName": }{
        },
        "publicKeyCertificateInfo": {
            "description": "ИнформацияАльтернативне об открытом ключеім'я власника",
            "value": {
                "publicKeyvalue": {null
                      "description": "Открытый ключ"},
                        "valuesubjectKeyId": "01 BE 1F B1 6B 6E 82 9C 05 AF 2F EC 04 87 E2 3F 0E 35 A3 3C 3D D3 B5 D2 CF 07 CC 84 6F 2F AD 7C 29"
 {
                            "description": "Ідентифікатор ключа",
                           }, "dsAlgorismvalue": {"description": "Алгоритм ЭЦП", "value": "ДСТУ 4145-2002, ПБ, little-endian"}
            }
        },"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"
        "certificateSerialNumber": {
            "description": "Серийный номер сертификата"},
            "value": "8F 94 8F B8 95 EE 29 95"
     "issuerKeyId": {
  },
        "notBefore": {"description": "Начало действия", "value": "Tue Jan 05 00:00:00 EET 2016"},
        "notAfter": {"description": "ОкончаниеІдентифікатор ключа действиявидавця",
 "value": "Wed Jan 04 00:00:00 EET 2017"},
        "extensionsCertificateInfo": {
            "descriptionvalue": "Расширения",
20 B4 E4 ED 0D 30 99 8C BE 30 6A  "value": {
                "personalData": {
07 7D 69 9A 32 73 23 8A E9 09 08 71 D6 16 37 0E 18 E5 76 D4 7F"
                      "description": "Персональные данные"},
                        "valuesubjectOwnerId": {
                           "customId": {"description": "ВнешнийІдентифікатор идентификаторвласника", "value": "014"},
                        "passport": {"description": "Паспортные данные", "value": "СФ00001400"},
                        },
   "drfou": {"description": "Индивидуальный налоговый номер", "value": "0000000014"}
               "certificateProfile": {
    }
                },
        "description": "Профіль сертифіката",
      "alternativeOwnerName": {"description": "Альтернативное имя владельца", "value": "test@cipher.com"},
                "subjectKeyIdvalue": {null
                    "description": "Идентификатор ключа"    },
                    "value": "DE 69 69 50 3F 86 37 68 C8 58 13 94 DA F8 DF 1A B7 84 B8 12 55 2B AD A6 15 8E 00 F4 3A 31 19 A1"
     "keyUsage": {
                            "description": "Призначеня сертифіката",
           },
                "subjectOwnerId": {"descriptionvalue": "ИдентификаторЕлектронний владельца"підпис, "value": "E7 49 6E 9F 33 07 6E 5B"Невідрікаємість"
                        },
                "certificateProfile        "isTemporary": {"description": "Профиль сертификата", "value": "3"},

                           "keyUsage": {"description": "Назначение сертификатаСтартовий", "value": "Цифровая подпись, Неотрекаемость"},

                         "isTemporary": {"description": "Стартовый", "value": "false"},
                "isReinforced": {"description": "Усиленный", "value": "false"}        },
            }
         }
    },"isReinforced": {
    "signingDateTime": "Tue Nov 29 12:30:38 EET 2016",
              "isValid": false
}]
Пример кода на JavaScript + jQuery 2.2.4
Code Block
languagejs
$.ajax({
    url: "https://local.cipher.kiev.ua:9091/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/ts/verifier",
    type"description": "GETПосилений",
    dataType                        "value": "jsontrue",
    cache: false
}).done(function (jsonResponse, textStatus, xhr) {
           message = jsonResponse.message;
}).fail(function (xhr) {
    try {}
        var jsonResponse = JSON.parse(xhr.responseText);
        message = jsonResponse.message; }
        failureCause = jsonResponse.failureCause;
    } catch (e) {}
        message = (xhr.responseText == undefined)}
 ? "Ошибка при получении результата проверки МВ." : xhr.responseText; }
    }]
})