Встановлення параметрів операції перевірки (створення) ЕП КЕП (ЕПЧ), які використовуються в контексті конкретної сесії.
Доступні наступні параметри, які відносяться до операцій ЕП КЕП та ЕПЧ:
- тип ЕПКЕП
- формат ЕПКЕП
- ознака включення електронної позначки часу даних
- ознака включення електронної позначки часу підпису
- порядок включення сертифіката підписанта та видавців
- режим перевірки електронного позначки часу даних
- режим перевірки електронного позначки часу підпису
- ознака виконання додаткової перевірки електронної позначки часу
- описувач даних, які необхідно підписати
- ознака можливості підписання документів одним і тим же підписантом
...
Параметри 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. |
|
cadesType | String | Формат створюваного КЕП стандарту CAdES | UNDEFINED - параметр cadesType не враховується при створенні електронного підпису NONE - не створювати підпис у форматі CAdES CADES_BES - базовий електронний підпис CADES_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. |
|
Відповідь
Код відповіді | 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" : "Сесія відсутня." } |
...