eparaksts Java bibliotēkas

Size: px

Start display at page:

Download "eparaksts Java bibliotēkas"

Wilfred Bradley
6 years ago
Views:

1 Sagatavots LVRTC Versija Sagatavoja SIA EUSO

2 Saturs 1. Ievads Lietojamība Dokumenta nolūks Paraksta jaucējfunkcijas algoritms EDOC EDOC PDF Laika zīmoga jaucējfunkcijas algoritms EDOC EDOC PDF Dokumentu validēšana pirms parakstīšanas EDOC 1.02 validēšana EDOC 1.02 validēšanas rezultāta apstrāde EDOC 2.0 validēšana PDF validēšana EDOC 2.0 un PDF validēšanas rezultāta apstrāde... 9 SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 2 (10)

3 1. Ievads 1.1. Lietojamība Dokuments paredzēts risinājumam eparaksts Java bibliotēkas Dokumenta nolūks Dokuments ir rokasgrāmata izstrādātājiem, kas savos risinājumos ir integrējuši EDOC un PDF dokumentu parakstīšanas un validēšanas funkcionalitāti. Dokumentā ir aprakstītas vadlīnijas SHA-1 jaucējfunkcijas algoritma aizstāšanai ar SHA-256 vai citu jaucējfunkcijas algoritmu. SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 3 (10)

4 2. Paraksta jaucējfunkcijas algoritms 2.1. EDOC 1.02 EDOC 1.02 dokumentu formāts paraksta veidošanā nodrošina tikai SHA-1 jaucējfunkcijas algoritmu, tādēļ šajā dokumentu formātā jaunu parakstu veidošana nav vēlama EDOC 2.0 EDOC 2.0 dokumentu formāts paraksta veidošanā nodrošina SHA-256 jaucējfunkcijas algoritmu, kuru iespējams norādīt paraksta veidošanas brīdī. EDOC 2.0 API satur funkciju lv.eparaksts.edoc.edoc2#addsignature(map<string,string> properties), kuras izsaukumā iespējams norādīt vēlamo paraksta jaucējfunkcijas algoritmu, izmantojot parametru EDoc2Signature.KEY_SIGNATURE_METHOD_URI. Parametru nenorādot, pēc noklusējuma tiek lietots SHA-256 paraksta jaucējfunkcijas algoritms. Lai izmantotu citu paraksta jaucējfunkcijas algoritmu, kā parametra vērtība jānorāda atbilstošais jaucējfunkcijas algoritms, piemēram, SHA-1 paraksta jaucējfunkcijas algoritma izmantošanai jānorāda EDoc2Signature.SIGNATURE_METHOD_RSA_SHA1. Sekojošā piemērā ir norādīts atbilstošās API funkcijas izsaukums. //prepare edoc EDoc2 edoc =... //prepare certificate X509Certificate signcertificate =... //prepare basic signature Map<String, String> signatureproperties = new HashMap<>(); signatureproperties.put(edoc2signature.key_signature_method_uri, EDoc2Signature.SIGNATURE_METHOD_RSA_SHA256); EDoc2BasicSignature basicsignature = edoc.addsignature(signatureproperties); basicsignature.setsigningcertificate(signcertificate); //get signable data byte[] signable = basicsignature.getsignablebytes(); String signaturemethodalgorithm = basicsignature.getsignaturemethodalgorithm(); 2.3. PDF PDF dokumentu formāts paraksta veidošanā nodrošina SHA-256 jaucējfunkcijas algoritmu, kuru iespējams norādīt paraksta veidošanas brīdī. PDF API satur funkciju lv.eparaksts.pdf.pdfdocument#addsignature(map<string,string> properties), kuras izsaukumā iespējams norādīt vēlamo paraksta jaucējfunkcijas algoritmu, izmantojot parametru PdfSignature.KEY_SIGNATURE_METHOD_OID. Parametru nenorādot, pēc noklusējuma tiek lietots SHA-256 paraksta jaucējfunkcijas algoritms. Lai izmantotu citu paraksta jaucējfunkcijas algoritmu, kā parametra vērtība jānorāda atbilstošais jaucējfunkcijas algoritms, piemēram, SHA-256 paraksta jaucējfunkcijas algoritma izmantošanai jānorāda PdfSignature.SIGNATURE_METHOD_RSA_SHA256. SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 4 (10)

5 Sekojošā piemērā ir norādīts atbilstošā API izsaukums. //prepare pdf PdfDocument pdf =... //prepare certificate X509Certificate signcertificate =... //prepare signature Map<String, String> signatureproperties = new HashMap<>(); signatureproperties.put(pdfsignature.key_signature_method_oid, PdfSignature.SIGNATURE_METHOD_RSA_SHA256); PdfBasicSignature basicsignature = pdf.addsignature(signatureproperties); basicsignature.setsigningcertificate(certificate); //get signable data byte[] signable = basicsignature.getsignablebytes(); String signaturemethodalgorithm = basicsignature.getsignaturemethodalgorithm(); SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 5 (10)

6 3. Laika zīmoga jaucējfunkcijas algoritms 3.1. EDOC 1.02 EDOC 1.02 dokumentu formāts laika zīmoga veidošanā nodrošina tikai SHA-1 jaucējfunkcijas algoritmu, tādēļ šajā dokumentu formātā jaunu parakstu veidošana nav vēlama EDOC 2.0 EDOC 2.0 dokumentu formāts laika zīmoga veidošanā nodrošina SHA-256 jaucējfunkcijas algoritmu, kuru iespējams norādīt laika zīmoga veidošanas brīdī. EDOC 2.0 API satur funkciju lv.eparaksts.edoc.edoc2qualifiedsignature #getsignaturevaluedigest(string messagedigestalgorithm), kuras izsaukumā iespējams norādīt laika zīmoga satura vērtības aprēķinā izmantojamo jaucējfunkcijas algoritmu. Parametra vērtība ir jānorāda obligāti, piemēram, SHA-256. Laika zīmoga pieprasījumā jāizmanto funkcija lv.pasts.eme.tsp.timestampgenerator #requesttimestamp(string digestalgorithmoid,..., kuras izsaukumā jānorāda izmantotais jaucējfunkcijas algoritms, izmantojot parametru digestalgorithmoid. Kā parametra vērtība jānorāda atbilstošais jaucējfunkcijas algoritms, piemēram, SHA-256 jaucējfunkcijas algoritma izmantošanai jānorāda TimeStampGenerator.DIGEST_ALGORITHM_SHA256. Sekojošā piemērā ir norādīts atbilstošās API funkcijas izsaukums. //prepare basic signature EDoc2BasicSignature basicsignature =... //set timestamp EDoc2QualifiedSignature qualifiedsignature = basicsignature.qualifiedsignature(); byte[] valuedigest = qualifiedsignature.getsignaturevaluedigest("sha-256"); TimeStamp ts = TimeStampGenerator.requestTimeStamp( TimeStampGenerator.DIGEST_ALGORITHM_SHA256, valuedigest, keyaccessor); List<byte[]> tslist = Collections.singletonList(ts.getEncoded()); qualifiedsignature.setsignaturetimestamps(tslist); 3.3. PDF PDF dokumentu formāts laika zīmoga veidošanā nodrošina SHA-256 jaucējfunkcijas algoritmu, kuru iespējams norādīt laika zīmoga veidošanas brīdī. PDF API satur funkciju lv.eparaksts.pdf.pdfsignature#getsignaturevaluedigest(string messagedigestalgorithm), kuras izsaukumā iespējams norādīt laika zīmoga satura vērtības aprēķinā izmantojamo jaucējfunkcijas algoritmu. Parametra vērtība ir jānorāda obligāti, piemēram, SHA-256. Laika zīmoga pieprasījumā jāizmanto funkcija lv.pasts.eme.tsp.timestampgenerator #requesttimestamp(string digestalgorithmoid,..., kuras izsaukumā jānorāda izmantotais jaucējfunkcijas algoritms, izmantojot parametru digestalgorithmoid. Kā parametra vērtība jānorāda atbilstošais jaucējfunkcijas algoritms, piemēram, SHA-256 jaucējfunkcijas algoritma izmantošanai jānorāda TimeStampGenerator.DIGEST_ALGORITHM_SHA256. Sekojošā piemērā ir norādīts atbilstošās API funkcijas izsaukums. //prepare signature PdfBasicSignature basicsignature =... //set timestamp SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 6 (10)

7 PdfQualifiedSignature qualifiedsignature = basicsignature.qualifiedsignature(); byte[] valuedigest = qualifiedsignature.getsignaturevaluedigest("sha-256"); TimeStamp timestamp = TimeStampGenerator.requestTimeStamp( TimeStampGenerator.DIGEST_ALGORITHM_SHA256, valuedigest, keyaccessor); qualifiedsignature.setsignaturetimestamp(timestamp.getencoded()); SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 7 (10)

8 4. Dokumentu validēšana pirms parakstīšanas Sakarā ar SHA1 kolīzijas atklāšanu, situācijās, kad tiek parakstīti dokumenti ar jau esošiem parakstiem, pirms parakstīšanas ir vēlams veikt šo dokumentu validēšanu, jo iepriekš pievienotie paraksti var nebūt derīgi EDOC 1.02 validēšana EDOC 1.02 formāta dokumentu validēšana iespējama, izmantojot funkciju lv.pasts.eme.edoc.edoc#validate(edocvalidatorlistener listener). //validate the EDOC EDOCValidatorResult result = edoc.validate(listener); //check the result EDOCValidatorResult criticalresult = result.getcriticalresult(); if (criticalresult == EDOCValidatorResult.) { //valid, add signature } else { //invalid } 4.2. EDOC 1.02 validēšanas rezultāta apstrāde EDOC 1.02 formāta dokumentu validēšanas rezultāta apstrādes pamatprincipi: Pārbaudes statuss Pārbaudes tips Piezīmes PASSED (1) Visi tipi Derīgs (2) SIGNATURE_VALUE (23) SIGNATURE_REFERENCE (231) (2) NOT_CHECKED (3) Visi tipi, izņemot augstākminētos ar statusu Visi tipi Parakstāmais fails nav derīgs. Tas var būt bojāts vai saturēt SHA-1 kolīziju. LVRTC iesaka neļaut turpmāku dokumentu parakstīšanu pie šīm kļūdām. Vismaz viens paraksts ir nederīgs. Dokumenta parakstīšana ir pieļaujama atkarībā no pasūtītāja vēlmēm. Paraksta statuss nav pārbaudāms. Dokumenta parakstīšana ir pieļaujama atkarībā no pasūtītāja vēlmēm EDOC 2.0 validēšana EDOC 2.0 formāta dokumentu validēšana iespējama, izmantojot funkciju lv.eparaksts.edoc.edoc2#validate(). //validate the EDOC ValidationResult result = edoc.validate(); //check the result Status status = result.getstatus(); if (status == ValidationStatus.PASSED) { //valid, add signature } else { //invalid SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 8 (10)

9 } 4.4. PDF validēšana PDF formāta dokumentu validēšana iespējama, izmantojot funkciju lv.eparaksts.pdf.pdfdocument#validate(). //validate the PDF ValidationResult result = pdf.validate(); //check the result Status status = result.getstatus(); if (status == ValidationStatus.PASSED) { //valid, add signature } else { //invalid } 4.5. EDOC 2.0 un PDF validēšanas rezultāta apstrāde EDOC 2.0 un PDF formāta dokumentu validēšanas rezultāta apstrādes pamatprincipi: Pārbaudes statuss Pārbaudes tips Piezīmes PASSED Visi tipi Derīgs STRUCTURE SIGNATURE_VALUE SIGNATURE_EDOC_DATA _OBJECT_REFERENCES Visi tipi, izņemot augstākminētos ar statusu Parakstāmais fails nav derīgs. Tas var būt bojāts vai saturēt SHA-1 kolīziju. LVRTC iesaka neļaut turpmāku dokumentu parakstīšanu pie šīm kļūdām. Vismaz viens paraksts ir nederīgs. Dokumenta parakstīšana ir pieļaujama atkarībā no pasūtītāja vēlmēm. ROOT SIGNATURE SIGNATURE_EDOC_DATA_OBJE CT_REFERENCES SIGNATURE_EDOC_SIGNING_C ERTIFICATE_REFERENCES SIGNATURE_METHOD SIGNATURE_PDF_ADBE_PKCS7_ DETACHED_SIGNED_ATTRIBUT ES SIGNATURE_PDF_ETSI_CADES_ DETACHED_SIGNED_ATTRIBUT ES SIGNATURE_PROFILE SIGNATURE_SIGNING_CERTIFIC ATE SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 9 (10)

10 UNCHECKED SIGNATURE_SIGNING_CERTIFIC ATE_CHAIN SIGNATURE_SIGNING_CERTIFIC ATE_STATUS SIGNATURE_TIMESTAMP SIGNATURE_TIMESTAMP_CERTI FICATE SIGNATURE_TIMESTAMP_SIGN ATURE SIGNATURE_TYPE SIGNATURE_VALUE STRUCTURE STRUCTURE_EDOC_DATA_OBJE CT_COUNT STRUCTURE_PDF_PAGE_COUNT STRUCTURE_SIGNATURE_COU NT SIGNATURE_TIMESTAMP Paraksta statuss nav pārbaudāms. Dokumenta parakstīšana ir pieļaujama atkarībā no pasūtītāja vēlmēm. SIA EUSO, A.Briāna iela 9A-2, Rīga LV-1001, Latvija, Lapa 10 (10)

Ievads darbā ar Mendeley

Ievads darbā ar Mendeley Kas ir Mendeley? Informācijas organizēšanas rīks Akadēmiskais sociālais tīkls Bez maksas 4 miljoni lietotāju Mendeley iespējas Veidot bibliogrāfisko sarakstu Noformēt atsauces