Конечная точка Signatures

Конечная точка предоставляет доступ к методам обработки подписываемого документа.

Конечная точка / предоставляет следующие методы:

• Метод presign
• Метод создания подписи postsign
• Метод усовершенствования подписи postsign

Метод presign

Метод предназначен для предварительной обработки документа перед созданием подписи.

Параметр	Значение
HTTP-метод	POST
Путь	https://{{hostname}}/{{InstanceName}}/api/signatures/presign
Параметры	PreSignArgs - параметры для предобработки документа
Возвращаемое значение	DSSPreSignResponse - результат предобработки документа

Пример запроса:

POST http://{{hostname}}/{{instanceName}}/api/signatures/presign HTTP/1.1
Content-Type: application/json; charset=utf-8
Content-Length: 146
{
  "Document": "dHJlaGhkZ2V3ZXN4dmN2bnV5aW15cmU=",
  "RawCertificate": "MIIIgDCCCC+gAwIBAgIQEk1FXRUA14DoEXUG4zPd9DAIBgYqhQMCAgMwgesxGDAWBgUq",
  "signatureType": "CAdES",
  "signatureParams": {
          "IsDetached": "true",
          "CADESType": "T",
          "TSPAddress": "http://hostname/tspNew/tsp.srf"
  }

Пример ответа:

HTTP/1.1 200 OK
Content-Length: 90
Content-Type: application/json; charset=utf-8
Date: Tue, 10 May 2024 10:18:47 GMT

{
"HashValue": "t1XEw+NBKjMr07XmAev8KLV+tpdjOwfdHB60HtOKyGM=",
"CacheObjectId": "345-333455-33545-3355"
}

Метод создания подписи postsign

Метод предназначен для добавления RAW-подписи в документ.

Параметр	Значение
HTTP-метод	POST
Путь	https://{{hostname}}/{{InstanceName}}/api/signatures/postsign
Параметры	PostSignArgs - параметры для добавления подписи в документ
Возвращаемое значение	Подписанный документ в виде массива байт, закодированный в Base64.

Пример запроса:

POST http://{{hostname}}/{{instanceName}}/api/signatures/postsign HTTP/1.1
Content-Type: application/json; charset=utf-8
Content-Length: 146
{
  "CacheObjectId": "345-333455-33545-3355",
  "SignatureType": "CAdES",
  "SignatureValue": "pdjOwfdHB60HtOKdwfyGMaf=",
}

Пример ответа:

HTTP/1.1 200 OK
Content-Length: 90
Content-Type: application/json; charset=utf-8
Date: Tue, 10 May 2024 10:18:47 GMT

{
"MIIxZAYJKoZIhvcNAQcCoIIxVTCCMVECAQExDDAKBgYqhQMCAgkFADALBgkqhkiG9w0BBwGgggiEMIIIgDCCCC+gAwIBAgIQEk1FXRUA14DoEXUG4zPd9DAIB...",
}

Метод усовершенствования подписи enhance

Метод предназначен для усовершенствования подписи формата CMS (CAdES-BES, CAdES-T) до CAdES-T и CAdES-X Long Type 1.

Примечание

В целях обеспечения обратной совместимости данный метод может быть вызван спобом PATCH на конечную точку /api/signatures/postsign. Параметры запроса в этом случае аналогичны описанным ниже.

Параметр	Значение
HTTP-метод	POST
Путь	https://{{hostname}}/{{InstanceName}}/api/signatures/enhance
Параметры	EnhanceSignatureArgs - параметры операции усовершенствования подписи
Возвращаемое значение	Подписанный документ в виде массива байт, закодированный в Base64.

Пример запроса:

POST http://{{hostname}}/{{instanceName}}/api/signatures/enhance HTTP/1.1
Content-Type: application/json; charset=utf-8
Content-Length: 146
{
  "MIIxZAYJKoZIhvcNAQcCoIIxVTCCMVECAQExDDAKBgYqhQMCAgkFADALBgkqhkiG9w0BBwGgggiEMIIIgDCCCC+gAwIBAgIQEk1FXRUA14DoEXUG4zPd9DAIB...",
  "SignatureType": "CAdES",
  "SignatureParams": {
        "CADESType": "BES",
        "TSPAddress": "http://testca/tsp/tsp.srf",
        "IsDetached": "true"
}

Пример ответа:

HTTP/1.1 200 OK
Content-Length: 90
Content-Type: application/json; charset=utf-8
Date: Tue, 10 May 2024 10:18:47 GMT

{
"MIIxZAYJKoZIhvcNAQcCoIIxVTCCMVECAQExDDAKBgYqhQMCAgkFADALBgkqhkiG9w0BBwGgggiEMIIIgDCCCC+gAwIBAgIQEk1FXRUA14DoEXUG4zPd9DAIB...",
}