View Source

Examples

Getting certificate and signing

The following example shows how to obtain a signing certificate and sign data with it

window.eparakstshwcrypto.getCertificate({lang: 'en'}).then(
	function(certificate) {
		//prepare the hash to be signed
		var hash = calculateHashAsHexForCertificate(certificate.hex);
		//sign the hash
		window.eparakstshwcrypto.sign(
			certificate, {type: 'SHA-1', hex: hash}, {lang: 'en'}).then(
			function(signature) {
			//do something with the signature
			storeSignature(signature.hex);
		}, function(error) {
			//handle the error
			console.log("Signing failed: " + error.message);
		});
	});

Response

The expected signing result (signature.hex) is the value of the electronic signature in HEX encoding.

B3745A73AC10CDB0F082EBA30A4D12CF7028F969EF7568783A18B628FEC7BC4FC445C8CB09
4F1C9F68D9414C30B510D715925B8F5CC2DE32C98D64AFF539F28684E0147DE91A430EB2E2
D51271A6C1BFECD639AD194867F6ED696C06CCDABFAD7E36C0D03A086FDF3ECA8442600836
C365301882F2A9404F703C63E1B1C90DB4A7BDAFDC0F558180D67DF5AC6B442ADB779D4682
9700148C40104E1E7EF95BB6EAD922B7BDD649EDF9D54D6ED7F52A1EC6EC25C078DFFF20BF
D0E1A1D2B85FB79CECE9326F8BE9D431A551027DC734F81EC6650F64716813102D727F5EAA
7A9ACEB12321959ACF53C73172CC2D3D4E1534286072C75EA2DBBFECCC56B5E4EBC9

JSON structure in batch signing

The example of a JSON object with 2 signable values to be passed as a hex property of a hash object, along with the type property 'JSON' of the hash object.

var json = {"edoc1":"8b7bd2107adc94fb6082847b48357129ddcc39ba",
"edoc2":"b3649be703934cb20655296e879c60270111d6a4"};
...
window.eparakstshwcrypto.sign(certificate, {type: 'JSON',
	hex: json},{lang: 'en'}).then(
		function(signature) {
...

Response example

The expected result of batch signing (signature.hex) is a JSON object with 2 signature values

{
"edoc1":"B3745A73AC10CDB0F082EBA30A4D12CF7028F969EF7568783A18B628FEC7BC4FC
445C8CB094F1C9F68D9414C30B510D715925B8F5CC2DE32C98D64AFF539F28684E0147DE91
A430EB2E2D51271A6C1BFECD639AD194867F6ED696C06CCDABFAD7E36C0D03A086FDF3ECA8
442600836C365301882F2A9404F703C63E1B1C90DB4A7BDAFDC0F558180D67DF5AC6B442AD
B779D46829700148C40104E1E7EF95BB6EAD922B7BDD649EDF9D54D6ED7F52A1EC6EC25C07
8DFFF20BFD0E1A1D2B85FB79CECE9326F8BE9D431A551027DC734F81EC6650F64716813102
D727F5EAA7A9ACEB12321959ACF53C73172CC2D3D4E1534286072C75EA2DBBFECCC56B5E4E
BC9",
"edoc2":"8E2DAB670A01DB5F683D041DDB4B7691818D60E1185940890CAA6E0799055460E
384C6D72D4493023C9F53734376C246204E2909E7177F45F829F2099727BD8301303C3F1CA
5BCE01A73534850879190011BFE3DF9800638C277ABB42D328E85B1643C28F7B7841B6861C
E04AEF62C770E9D06C9D5C6DDA0CCE469D67F427615C5F6BB6B623CED48C7AD4AEC643D1E4
8B1C8F5D20CA350D7CE65F1CE5FFAC88036369489591506E46CF28DA4A92BC7A1182897CC7
0B49B5E3BB6DC60E331BD8D258F2BD036379D70EF4D87C0CFC9CD09BBDB1ADD455F252C7B8
6A9242CE8747A53DDBCADBFAC63533D692A4D6F86133E7EC3F2E32EF7B79BD02B625BB3251
1E8"
}

The document to be signed must be prepared on the server side

The user must select a signing certificate

//plugin request
window.eparakstshwcrypto.getCertificate({lang: lang, operation: 'sign'})

After receiving the certificate, the server side start signing the document

//prepare signature
Map<String, String> props = new HashMap<>();
props.put(EDoc2Signature.KEY_SIGNATURE_METHOD_URI,
EDoc2Signature.SIGNATURE_METHOD_RSA_SHA256);
EDoc2BasicSignature preparedSignature = edoc.addSignature(props);

//cert
preparedSignature.setSigningCertificate(cert);

//getSignableBytes
byte[] signableBytes = preparedSignature.getSignableBytes();
MessageDigest digestCalculator = MessageDigest.getInstance(“SHA-256”);
byte[] digest = digestCalculator.digest(signableBytes);

//complete
preparedSignature.complete();

//save
session.setAttribute("edoc", edoc);

//plugin request
window.eparakstshwcrypto.sign({hex: signCert}, {type: 'SHA-256',
hex: signHash}, {lang: lang, operation: 'sign'})

After receiving the signed HASH value, it is possible to set the signature value in the previously prepared document

EDoc2 edoc = (EDoc2)session.getAttribute("edoc");

//get the last signature
EDoc2Signature signature =
	edoc.getSignature(edoc.getSignatureCount() - 1);

//get basic signature
EDoc2BasicSignature basicSignature = signature.basicSignature();

//setSignatureValue
basicSignature.setSignatureValue(signatureValue);

//complete
basicSignature.complete();

It is important that the signature value must be added to the exact same ASICE (EDOC) document from which the data to be signed is derived, as the content of the data to be signed also includes the time of signing, otherwise the signature will not be valid.

The user must select a signing certificate

window.eparakstshwcrypto.sign(certificate, {type: 'SHA', hex: hash},{lang: 'en', operation: 'jwt'}).then(function(signature) {
...

Expected JWT operation signing result (signature.hex) is JWT object,
for example:

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2Mjc5NDE1NTAsImlhdCI6MTYyN
zkwNTU1MCwiaXNzIjoiZXBhcmFrc3RzLXRva2VuLXNpZ25pbmciLCJqdGkiOiJRVEZBMVVOeSt
icjBnZFRGVGkxY2U4OG9cL1dDSEFBS0E0SGwyRWgzVlN2ST0iLCJvcmlnaW4iOiJodHRwczpcL
1wvd3d3LmV1c28ubHYifQ.bhQLC0SQLyZOrfB3kSjMAaFXagnt_mM3DUEP4aHFHGT8FC_pfSEW
I026MvcaVLY8lgw5TDFA4Cj60jcMBeiyC0eFGT3XAh3bIzn4yiF1e4OPBZ3cOP5tm_
p3qV_ZGWIQqQeE5YQtN1ypOe7wtOAjK2XFPzNjCdano0HYfaQAU3_k7_vEptdurPw
xOgJlQTpmhtHtUfxejikg6w1IDEwOX9TckDGbRko3YFK2MS-Cw-FxTLSgo77eDCpj-
GhZEYRNg_H6hYWmjgyMTTIQnGZW95y10t77EiaPIImMvTb7CNo1Vpy_q-kQsPXctGEC4ku6FaAcT2p3yWy9vCu_
5Jiw