????????????? ????????? ???????? ???????? (????????) ?? (???), ??????? ???????????? ? ????????? ???????????? ??????.
???????? ????????? ?????????, ??????? ????????? ? ????????? ?? ? ???:
- ??? ??
- ??????? ????????? ??????????? ????? ??????? ??????
- ??????? ????????? ??????????? ????? ??????? ???????
- ??????? ????????? ???????????? ?????????? ? ?????????
- ????? ???????? ??????????? ????? ??????? ???????
- ????? ???????? ??????????? ????? ??????? ??????
- ??????? ?????????? ?????????????? ???????? ??????????? ????? ???????
- ????????? ??????, ??????? ?????????? ?????????
- ??????? ??????????? ?????????? ????????? ????????? ??? ????? ? ??? ?? ???????????
URL-????? ???????
Устанавливает параметры операций проверки (создания) ЭП (ЭМВ), которые используются в контексте определенной сессии.
Доступны следующие параметры, которые относятся к операциям ЭП и ЭМВ:
- тип ЭП
- признак включения электронной метки времени данных
- признак включения электронной метки времени подписи
- порядок включения сертификатов подписанта и издателей
- режим проверки электронной метки времени подписи
- режим проверки электронной метки времени данных
- признак выполнения дополнительной проверки электронной метки времени
- описатель данных, которые необходимо подписать
- признак возможности подписания документа несколько раз одним и тем же подписантом
...
https://local.cipher.kiev.ua:9090/api/v1/ticket/{uuid}/option
...
?????
PUT
...
????????? ???????
uuid | String |
...
????????????? ?????? |
????????????? ????????? ???????
Content-Type | application/json |
Параметры JSON объекта запроса
????????? JSON ??????? ???????
??? | ??? | ???????? | ?????????? ???????? |
---|
signatureType | String |
??? ?? | attached - |
* detached - открепленная ЭП, ЭП хранится отдельно от подписанных данных
true - встраивать электронную метку времени подписи
* false - не встраивать электронную метку времени подписи
Note |
---|
При установке параметра cadesType в значение, отличное от "undefined", значения параметра embedSignatureTs игнорируется. |
true - встраивать электронную метку времени даных
* false - не встраивать электронную метку времени данных
Note |
---|
При установке параметра cadesType в значение, отличное от "undefined", значения параметра embedDataTs игнорируется. |
signerCert - добавлять только сертификат подписанта
signerAndCaCert - добавлять сертификат подписанта и сертификаты издателей
signerCertAndCaInfo - добавлять сертификат подписанта и информацию про сертификаты издателей (сами сертификаты издателей не добавляются)
* nothing - не добавлять сертификаты
Note |
---|
При установке параметра cadesType в значение, отличное от "undefined", значения параметра embedCertificateType игнорируется. |
* ignore - игнорировать электронную метку времени
verifyIfPresent - проверять электронную метку времени, если она присутствует
verifyOrFailIfNotPresent - проверять электронную метку времени и возвращать ошибку, если она отсутствует
verifyIfPresent - проверять электронную метку времени, если она присутствует
verifyOrFailIfNotPresent - проверять электронную метку времени и возвращать ошибку, если она отсутствует
tsAdditionalVerifying
Признак выполнения дополнительной проверки электронной метки времени
* false - не выполнять дополнительную проверку электронных меток времени при проверке ЭП
dataToSignQualifier
alreadySigned - данные уже содержат подпись, для добавления новой будет использован режим множественной подписи
duplicateSign
true - добавляет новую подпись, даже если документ уже был подписан подписантом
* false - новая подпись не добавляется, если документ уже был подписан подписантом
undefined - параметр cadesType не учитывается при создании электронной подписи
CAdESBES - базовая электронная подпись.
CAdEST - электронная подпись, содержащая электронную метку времени от электронной подписи
* CAdESXLong - электронная подпись, содержащая электронную метку времени от электронной подписи и полный набор данных для проверки.
Note |
---|
При установке параметра cadesType в значение, отличное от "undefined", значения параметров embedSignatureTs, embedDataTs, embedCertificateType игнорируются. |
* false - кодирование подписи соответствует нормативным документам
* - значение по умолчанию
Ответ
?????????? ??, ?? ???????? ?????? ? ???????????? ??????? * detached - ???????????? ??, ?? ???????? ???????? ?? ??????????? ?????? | |||||
embedSignatureTs | String | ??????? ????????? ??????????? ????? ??????? ??????? | true - ?????????? ??????????? ????? ??????? ???????
| ||
embedDataTs | String | ??????? ????????? ??????????? ????? ??????? ?????? | true - ?????????? ??????????? ????? ??????? ?????
| ||
embedCertificateType | String | ??????? ????????? ???????????? ?????????? ? ????????? | signerCert - ????????? ?????? ?????????? ??????????
| ||
signatureTsVerifyOption | String | ????? ???????? ??????????? ????? ??????? ??????? | * ignore - ???????????? ??????????? ????? ??????? | ||
dataTsVerifyOption | String | ????? ???????? ??????????? ????? ??????? ?????? | * ignore - ???????????? ??????????? ????? ??????? verifyIfPresent - ????????? ??????????? ????? ???????, ???? ??? ???????????? verifyOrFailIfNotPresent - ????????? ??????????? ????? ??????? ? ?????????? ??????, ???? ??? ??????????? | ||
tsAdditionalVerifying | String | ??????? ?????????? ?????????????? ???????? ??????????? ????? ??????? | true - ????????? ?????????????? ???????? ??????????? ????? ??????? ??????? ? ?????? ??? ???????? ?? ??? ?????????????? ?????????????? ?????????? ? ?????? * false - ?? ????????? ?????????????? ???????? ??????????? ????? ??????? ??? ???????? ?? | ||
dataToSignQualifier | String | ????????? ??????, ??????? ?????????? ????????? | * notSignedBefore - ?????? ?? ???????? ????? ????????? ??????? alreadySigned - ?????? ??? ???????? ???????, ??? ?????????? ????? ????? ??????????? ????? ????????????? ??????? | ||
duplicateSign | String | ??????? ??????????? ?????????? ????????? ????????? ??? ????? ? ??? ?? ??????????? | true - ????????? ????? ???????, ???? ???? ???????? ??? ??? ???????? ??????????? | ||
caId | String | ????????????? ?????/(?)???, ??????? ????? ?????????? ????? ?? ????????? ??????????. | ?????????????? ?????????????? ???????? ?????/(?)??? ?????????? ?????????????? ???????? ? ??????? ??????? ????????? ?????? ?????????????? ?????/(?)??? | ||
cadesType | String | ?????? ?????????????? ??????????? ??????? ????????? CAdES | undefined - ???????? cadesType ?? ??????????? ??? ???????? ??????????? ???????
| ||
nokkCompatible | String | ??????? ??????????????? ??????????? ???????, ????????? ?????????? ???????? ???? | true - ?????????, ??? ??????? ??????? ?????????? ???? ? ????????????? ???????????? ? ASN.1 OCTET STRING * false - ??????????? ??????? ????????????? ??????????? ?????????? |
* - ???????? ?? ?????????
?????
??? ?????? | Content-type | ?????????? ????????? | ?????? ??????????? |
---|
200 | application/json | message | { |
?????? ?? ????????? ???????? ?????? ????????.", | |||
503 | application/json | message | { |
?????? ???????? ?????? ?? ???????." | |||
400 | application/json | message | { "message" : " |
?????? ???????????." } |
Параметры JSON объекта ответа
????????? JSON ??????? ??????
???????? | ??? ?????? | ???????? |
---|---|---|
message | String | ???????? ?????????? ?????????? ???????? |
settedOptions | Object |
...
????????? ? ?? ????????, ??????? ???? ??????????? ????? ?????????? ??????? |
?????? ???? ?? JavaScript + jQuery 2.2.4
Code Block | ||
---|---|---|
| ||
var selectedOptions = { signatureType: "detached", embedCertificateType: "nothing", embedSignatureTs: "false", embedDataTs: "false", signatureTsVerifyOption: "ignore", dataTsVerifyOption: "ignore" }; $.ajax({ url: "https://local.cipher.kiev.ua:9090/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/option", type: "PUT", dataType: "json", contentType: "application/json", data: JSON.stringify(selectedOptions) }).done(function (jsonResponse, textStatus, xhr) { message = jsonResponse.message; settedOptions = jsonResponse.settedOptions; }).fail(function (xhr) { try { var jsonResponse = JSON.parse(xhr.responseText); message = jsonResponse.message; } catch (e) { message = (xhr.responseText == undefined) ? "Ошибка при установке настроек сессии?????? ??? ????????? ???????? ??????." : xhr.responseText; } }) |
...