4. Solis: Jaucējvērtības (Hash) parakstīšana

Izsaukums paraksta vienu vai vairākas iepriekš autorizētas dokumentu jaucējvērtības (hash) ar norādīto paraksta identitāti (credential) un paraksta algoritmu.

HTTP pieprasījums

POST {{csc_base_url}}/signatures/signHash
 
Authorization: Bearer {{access_token}}
Accept: application/json
Content-Type: application/json
 
{
"credentialID": "{{credential_id}}",
"hashes": ["{{hash_base64}}"],
"hashAlgorithmOID": "{{hash_algorithm_oid}}",
"signAlgo": "{{signature_algorithm_oid}}"
}

Ieejas parametri

ParametrsAtrašanās vietaObligātsTips/formātsApraksts
AuthorizationGalvene (Header)JāPiekļuves marķieris (Bearer token)Tieši šai parakstīšanai izsniegtaismarķierisaccess_token
credentialIDJSON pamatteksts (body)JāVirkne (String)Tā pati paraksta identitāte (credential), kas tika norādīts parakstīšanas PAR
hashesJSON pamatteksts (body)JāArray of Base64 StringAutorizētās dokumentu jaucējvērtības (hash) tādā pašā secībā
hashAlgorithmOIDJSON pamatteksts (body)JāOID virkne (String)Jaucējvērtības (hash) algoritms; SHA-384: 2.16.840.1.101.3.4.2.2
signAlgoJSON pamatteksts (body)JāOID virkne (String)Paraksta identitātes (credential) atļautais paraksta algoritms; ECDSA/SHA-384: 1.2.840.10045.4.3.3

Atbildes piemērs

{
"signatures": [
"<Base64-encoded-ECDSA-signature>"
]
}

Atbildes parametri un validācija

ParametrsTipsAprakstsIntegratora validācija
signaturesVirknes masīvs (Array of String)Base64 kodēti kriptogrāfiskie parakstiSkaitam jāsakrīt ar hashes skaitu; katrai vērtībai jābūt derīgam Base64. Integratoram saņemtais paraksts kriptogrāfiski jāpārbauda ar credentials/info atgrieztā sertifikāta publisko atslēgu un sākotnējo dokumenta jaucējvērtību (hash). Pēc tam parakstu var ievietot PAdES, XAdES vai CAdES struktūrā
ℹ️

Paraksta pārbaude

Saņemtais paraksts kriptogrāfiski jāpārbauda, izmantojot credentials/info izsaukumā atgrieztā sertifikāta publisko atslēgu un sākotnējo dokumenta jaucējvērtību (hash). Pēc veiksmīgas pārbaudes parakstu var iekļaut PAdES, XAdES vai CAdES paraksta struktūrā.


Did this page help you?