Page History

Встановлюються параметри операцій перевірки (створення) ЕП (ЕПЧ), які використовуються в контексті конкретної сесії.
Доступні наступні параметри, які відносяться до операцій ЕП та ЕПЧ:

тип ЕП
формат ЕП
ознака включення ЕПЧ даних
ознака включення ЕПЧ підпису
порядок включення сертифікатів підписантів та видавців
режим перевірки ЕПЧ підпису
режим перевірки ЕПЧ даних
ознака виконання додаткової перевірки електронної позначки часу
опис даних, які необхідно підписати
ознака можливості підпису документа кілька разів один і тим же підписантом
ознака застосування окремого потоку для виконання криптографічних операцій, які вимагають доступ до особистого ключа

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

????????????? ????????? ???????? ???????? (????????) ?? (???), ??????? ???????????? ? ????????? ???????????? ??????.
???????? ????????? ?????????, ??????? ????????? ? ????????? ?? ? ???:

??? ??
??????? ????????? ??????????? ????? ??????? ??????
??????? ????????? ??????????? ????? ??????? ???????
??????? ????????? ???????????? ?????????? ? ?????????
????? ???????? ??????????? ????? ??????? ???????
????? ???????? ??????????? ????? ??????? ??????
??????? ?????????? ?????????????? ???????? ??????????? ????? ???????
????????? ??????, ??????? ?????????? ?????????
??????? ??????????? ?????????? ????????? ????????? ??? ????? ? ??? ?? ???????????

...

https://local.cipher.kiev.ua:9090/api/v1/ticket/{uuid}/option
...

Метод

PUT

...

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

uuid

String

????????????? ??????

...

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

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

Content-Type

application/json

????????? JSON ??????? ???????

...

true - ?????????? ??????????? ????? ??????? ???????
* false - ?? ?????????? ??????????? ????? ??????? ???????

Note
??? ????????? ????????? cadesType ? ????????, ???????? ?? "undefined", ???????? ????????? embedSignatureTs ????????????.

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

Ім'я

Тип

Опис

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

asicForm

String

Форма Associated Signature Container

* NONE - не створювати Associated Signature Container
ASIC_S - простий формат (тільки один файл в архіві)
ASIC_E - розширений формат (один та більше файлів архіві)

signatureType

String

Тип КЕП

attached - вбудований, ЕП зберігається разом з підписаними даними
* detached - відкріплений, ЕП зберігається окремо від підписаних даних

Note
Значення параметра ігнорується, якщо для параметра asicForm вказане значення відмінне від "NONE".

embedSignatureTs

String

Ознака включення ЕПЧ підпису

true - додавання ЕПЧ підпису
* false - не додавати ЕПЧ підпису

Note

Значення параметра ігнорується:

Якщо для параметра cadesType вказане значення відмінне від "UNDEFINED".
При створенні електронного підпису формату XAdES.

embedDataTs

String

Ознака включення ЕПЧ даних

true - додавання ЕПЧ даних
* false - не додавати ЕПЧ даних

Note
Значення параметра ігнорується при створенні електронного підпису формату XAdES.

embedCertificateType

String

Порядок включення сертифікатів підписантів та видавців

signerCert - додавати лише сертифікат підписанта
signerAndCaCert - додавати сертифікат підписанта та сертифікати видавців
signerCertAndCaInfo - додавати сертифікат підписанта та інформацію про сертифікати видавців (самі сертифікати видавців не додаються)
* nothing - не додавати сертифікати

Note

Значення параметру ігнорується:

Якщо для параметра cadesType вказане значення "CADES_X_LONG"
При створенні електронного підпису формату XAdES.

signatureTsVerifyOption

String

Режим перевірки ЕПЧ підпису

* ignore - ігнорувати електронну позначку часу
verifyIfPresent - перевіряти електронну позначку часу, якщо вона присутня
verifyOrFailIfNotPresent - перевіряти електронну позначку часу та повертати помилку, якщо вона відсутня

Note
Значення параметру ігнорується при перевірці електронного підпису формату XAdES.

dataTsVerifyOption

String

Режим перевірки ЕПЧ даних

* ignore - ігнорувати електронну позначку часу
verifyIfPresent - перевіряти електронну позначку часу, якщо вона присутня
verifyOrFailIfNotPresent - перевіряти електронну позначку часу та повертати помилку, якщо вона відсутня

Note
Значення параметра ігнорується при перевірці електронного підпису формату XAdES.

dataToSignQualifier

String

Опис даних, які необхідно підписати

* notSignedBefore - дані не містять раніше створений підпис
alreadySigned - дані вже містять підпис, для додавання нової буде використано режим множинного підпису

Note
Значення параметра ігнорується при створенні електронного підпису формату XAdES.

duplicateSign

String

Ознака можливості підпису документа кілька разів один і тим же підписантом

true - додає новий підпис, навіть якщо документ вже був підписаний підписантом
* false - новий підпис не додається, якщо документ вже був підписаний підписантом

Note
Значення параметру ігнорується при створенні електронного підпису формату XAdES.

caId

String

Ідентифікатор КНЕДП, який видав сертифікат ключа з ключового контейнеру

Ідентифікатор підтримуваних Сервісом КНЕДП необхідно попередньо отримати завдяки запиту Отримання списку підтримуваних КНЕДП

cadesType

String

Формат створюваного КЕП стандарту CAdES

UNDEFINED - параметр cadesType не враховується при створенні електронного підпису
NONE - не створювати підпис у форматі CAdES
CADES_BES - базовий електронний підпис
CADES_T - електронний підпис, який містить електронну позначку часу від електронного підпису
CADES_E_T - електронний підпис, який містить електронну позначку часу від електронного підпису та додаткові атрибути
* CADES_X_LONG - електронний підпис, який містить електронну позначку часу підпису від електронного підпису та повний набір даних для перевірки

xadesType

String

Формат створюваного КЕП стандарту XAdES

* NONE - не створювати підпис у форматі XAdES
XADES_B_B - базовий електронний підпис
XADES_B_T - електронний підпис, який містить електронну позначку часу від електронного підпису
XADES_B_LT - електронний підпис, який містить електронну позначку часу підпису від електронного підпису та повний набір даних для перевірки
XADES_B_LTA - електронний підпис для тривалого (архівного) зберігання.

Note
Значення параметра ігнорується, якщо для параметра cadesType вказане значення відмінне від "NONE".

nokkCompatible

String

Ознака додаткового кодування підпису, створюваної засобами компанії НОКК

true - враховувати, що підпис створюється засобами НОКК та додатково закодована в ASN.1 OCTET STRING
* false - кодування підпису відповідає нормативним документам

Note
Значення параметра ігнорується при перевірці електронного підпису формату XAdES.

exclusiveTaskExecutor

String

Ознака застосування окремого потоку для виконання криптографічних операцій, які вимагають доступ до особистого ключа: створення підпису, зашифрування, розшифрування.

true:

для виконання криптографічних операцій, які вимагають доступ до особистого ключа, буде виділено окремий поток;
криптоконтекст створюється одноразово та буде повторно використовуватися в рамках сесії в наступних операціях, які вимагають доступ до особистого ключа;
слід використовувати у випадку необхідності виконати в рамках сесії більше 10 операцій, які вимагають доступ до особистого ключа.

* false:

для виконання криптографічних операцій, які вимагають доступ до особистого ключа, буде використовуватися загальний пул потоків для виконання криптографічних операцій;
криптографічний контекст буде формуватися щоразу за необхідності виконати операцію, яка вимагає доступ до особистого ключа.

* - значення за замовчуванням

Відповідь

Код відповіді	Content-type	Допустимі параметри	Приклад вмісту

...

true - ?????????? ??????????? ????? ??????? ?????
* false - ?? ?????????? ??????????? ????? ??????? ??????

Note
??? ????????? ????????? cadesType ? ????????, ???????? ?? "undefined", ???????? ????????? embedDataTs ????????????.

...

signerCert - ????????? ?????? ?????????? ??????????
signerAndCaCert - ????????? ?????????? ?????????? ? ??????????? ?????????
signerCertAndCaInfo - ????????? ?????????? ?????????? ? ?????????? ??? ??????????? ????????? (???? ??????????? ????????? ?? ???????????)
* nothing - ?? ????????? ???????????

Note
??? ????????? ????????? cadesType ? ????????, ???????? ?? "undefined", ???????? ????????? embedCertificateType ????????????.

...

* ignore - ???????????? ??????????? ????? ???????
verifyIfPresent - ????????? ??????????? ????? ???????, ???? ??? ????????????
verifyOrFailIfNotPresent - ????????? ??????????? ????? ??????? ? ?????????? ??????, ???? ??? ???????????

...

tsAdditionalVerifying

...

??????? ?????????? ?????????????? ???????? ??????????? ????? ???????

...

dataToSignQualifier

...

duplicateSign

...

true - ????????? ????? ???????, ???? ???? ???????? ??? ??? ???????? ???????????
* false - ????? ??????? ?? ???????????, ???? ???????? ??? ??? ???????? ???????????

...

undefined - ???????? cadesType ?? ??????????? ??? ???????? ??????????? ???????
CAdESBES - ??????? ??????????? ???????.
CAdEST - ??????????? ???????, ?????????? ??????????? ????? ??????? ?? ??????????? ???????
* CAdESXLong - ??????????? ???????, ?????????? ??????????? ????? ??????? ?? ??????????? ??????? ? ?????? ????? ?????? ??? ????????.

Note
??? ????????? ????????? cadesType ? ????????, ???????? ?? "undefined", ???????? ?????????? embedSignatureTs, embedDataTs, embedCertificateType ????????????.

...

* - ???????? ?? ?????????

?????

??? ??????

Content-type

?????????? ?????????

?????? ???????????

200

application/json

message
settedOptions : {
    signatureType, 
    signatureTsVerifyOption,
    dataTsVerifyOption,
    embedSignatureTs,
    embedDataTs,
    embedCertificateType,
    dataToSignQualifier,
    duplicateSign
}

{
    "message": "?????? ?? ????????? ???????? ?????? ????????Запит на встановлення налаштувань сесії виконано.",
    "settedOptions": {
       "signatureTsVerifyOption": "IGNORE",
       "embedSignatureTs": "false",
       "embedCertificateType": "NOTHING",
       "signatureType": "DETACHED",
       "dataTsVerifyOption": "IGNORE",
       "embedDataTs": "false",
       "dataToSignQualifier": "ALREADY_SIGNED",
       "duplicateSign": "true"
    }
}

503

application/json

message

{
       "message" : "?????? ???????? ?????? ?? ???????Сервіс зберігання даних не запущено." 
}

400

application/json

message

{
       "message" : "?????? ???????????Сесія відсутня." 
}

????????? JSON ??????? ??????

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

Параметр	Тип даних	Опис
message	String	Опис результату проведення операції
????????	??? ??????	????????
message	String	???????? ?????????? ?????????? ????????
settedOptions	Object	????????? ? ?? ????????, ??????? ???? ??????????? ????? ?????????? ???????

?????? ???? ?? JavaScript + jQuery 2.2.4

...

language	js

...

Параметри та їх значення, які були встановлені після виконання запиту

Page tree

Versions Compared

Old Version 8

New Version Current

Key

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

https://local.cipher.kiev.ua:9090/api/v1/ticket/{uuid}/option
...

Метод

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

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

????????? JSON ??????? ???????

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

Відповідь

?????

????????? JSON ??????? ??????

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

?????? ???? ?? JavaScript + jQuery 2.2.4

Page tree

Page History

Versions Compared

Old Version 8

New Version Current

Key

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

https://local.cipher.kiev.ua:9090/api/v1/ticket/{uuid}/option...

Метод

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

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

????????? JSON ??????? ???????

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

Відповідь

?????

????????? JSON ??????? ??????

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

?????? ???? ?? JavaScript + jQuery 2.2.4

https://local.cipher.kiev.ua:9090/api/v1/ticket/{uuid}/option
...