Versions Compared

Old Version 1

changes.mady.by.user Alexandr Stokipny

Saved on

compared with

New Version Current

changes.mady.by.user Svitlana Nimych

Saved on

Key

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

Встановлює параметри операції зашифрування. які використовуються у контексті конкретної сесії.
Доступні наступні параметри, які відносяться до операції зашифрування:

  • порядок включення сертифікатів підписанта та видавців
URL-адреса запиту

Устанавливает параметры операций проверки (создания) ЭЦП (МВ), которые используются в контексте определенной сессии.
Доступны следующие параметры, которые относятся к операциям ЭЦП и МВ:

  • тип ЭЦП
  • признак включения метки времени данных
  • признак включения метки времени ЭЦП
  • порядок включения сертификатов подписанта и издателей
  • режим проверки метки времени цифровой подписи
  • режим проверки метки времени данных
  • описатель данных, которые необходимо подписать
  • признак возможности подписания документа несколько раз одним и тем же подписантом

...

https://localcrypto.cipher.kiev.ua:9091/api/v1/ticket/{uuid}/option

Метод

PUT

...

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

...

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

...

запиту
Content-Typeapplication/json

...

Параметри JSON

...

обʼєкта запиту
Имя
ІмʼяТип
ОписаниеДопустимые значенияsignatureTypeStringТип ЭЦПattached - встроенная ЭЦП, ЭЦП хранится вместе с подписанными данными
* detached - открепленная ЭЦП, ЭЦП хранится отдельно от подписанных данныхembedSignatureTsStringПризнак включения метки времени ЭЦПtrue - встраивать метку времени ЭЦП
* false - встраивать метку времени ЭЦПembedDataTsStringПризнак включения метки времени данныхtrue - встраивать метку времени даных
* false - встраивать метку времени данных
ОписДопустимі значення
embedCertificateTypeStringПорядок
включения сертификатов подписанта и издателей
включення сертифікатів підписанта та видавців

signerCert -

добавлять только сертификат подписанта

додавати лише сертифікат підписанта
signerAndCaCert -

добавлять сертификат подписанта и сертификаты издателей
signerCertAndCaInfo - добавлять сертификат подписанта и информацию про сертификаты издателей (сами сертификаты издателей не добавляются)

додавати сертифікат підписанта та сертифікати видавців
* nothing - не

добавлять сертификатыsignatureTsVerifyOptionStringРежим проверки метки времени цифровой подписи

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

dataTsVerifyOptionStringРежим проверки метки времени данных * ignore - игнорировать метку времени
verifyIfPresent - проверять метку времени, если она присутствует
verifyOrFailIfNotPresent - проверять метку времени и возвращать ошибку, если она отсутствует

dataToSignQualifier

StringОписатель данных, которые необходимо подписать* notSignedBefore - данные не содержат ранее созданную подпись
alreadySigned - данные уже содержат подпись, для добавления новой будет использован режим множественной подписи

duplicateSign

StringПризнак возможности подписания документа несколько раз одним и тем же подписантом

true - добавляет новую подпись, даже если документ уже был подписан подписантом
* false - новая подпись не добавляется, если документ уже был подписан подписантом

* - значение по умолчанию

Ответ

додавати сертифікати

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

Відповідь
Код відповіді
Код ответа
Content-type
Допустимые параметрыПример содержимого
Допустимі параметриПриклад вмісту
200application/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"
}
}
503application/jsonmessage
{
   
    "message" : "
Сервис
Сервіс
хранения
зберігання
данных
даних не
запущен
запущено." 
}
400application/jsonmessage
{
   
    "message" : "
Сессия
Сесія
отсутствует
відсутня." 
}

...

Параметри JSON

...

обʼєкта відповіді
ПараметрТип
данных
даних
Описание
Опис
messageString
Описание результата проведения операции
Опис результату проведення операції

settedOptions

Object
Параметры и их значения, которые были установлены после выполнения запроса
Пример кода на JavaScript + jQuery 2.2.4

...

languagejs

...

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