Blogramming

Det har irriteret mig længe, at man ikke kan bruge den digitale signatur til andet end signering af mails samt logge på offentlige servere (som skat, eboks etc). Hvorfor ikke give mulighed for at bruge signaturen til flere formål - da det er et X509 certifikat kan det jo bruges til signering og kryptering af filer. Udbuddet som TDC vandt i sin tid burde have indeholdt et krav om at stille applikationer til rådighed, som giver en bruger mulighed for at signere og kryptere filer på ens harddisk.

Desværre var det ikke tilfældet og jeg har ikke kunnet finde nogen open source software, som giver mulighed for at signere/kryptere med et X509 certifikat. Kun en mulighed - at lave min eget!

Derfor har jeg lavet et open source library, som er frigivet under Apache 2 licensen. Library'et stiller følgende funktionalitet til rådighed:

OcesEncrypter klassen benyttes til at kryptere en fil given en pkcs12 fil eller den offentlige del af X509 certifikatet.

Klassen kan instantieres ved:

OcesEncrypter encrypter = OcesEncrypter.newInstance(File x509PublicCertificateFile);

OcesEncrypter encrypter = OcesEncrypter.newInstance(File pkcs12File, String pkcs12password);

Klassen kan benyttes til at kryptere en fil:

encrypter.encryptFile(File fileToBeEncrypted, File encryptedFile);

Krypteringen fungerer ved, at der genereres en symmetrisk AES-128 nøgle som benyttes til at kryptere fil indholdet (fileToBeEncrypted). AES nøglen krypteres med den offentlige nøgle og inkluderes i den krypterede fil (encryptedFile). Derved opnås en hurtig og effektiv kryptering.

OcesDecrypter klassen benyttes til at dekryptere en fil, som er blevet krypteret med OcesEncrypter.

Klassen kan instantieres ved:

OcesDecrypter decrypter = OcesDecrypter newInstance(File pkcs12File, String pkcs12Password, String privateKeyPassword);

Som det kan ses tager OcesDecrypter kun en pkcs12 fil for at få adgang til den private del af certifikatet. Efter instantiering kan objektet dekryptere:

decryptFile(File fileToBeDecrypted, File decryptedFile);

Resultatet gemmes i filen decryptedFile.

OcesSigning klassen benyttes til at signere indholdet af en fil med et OCES certifikat.

OcesSigning signer = OcesSigning.newInstance(File pkcs12File, String pkcs12password, String privateKeyPassword);

Signeringen kan herefter foretages ved:

signer.sign(File fileToSign, File signFile)

Signeringen producerer en fil (signFile) som indeholder signaturen af filen der skal signeres (fileToSign). Signering foregår ved at tage en SHA-1 hash af indholdet i signFile og herefter kryptere dette med den private del af certifikatet. Resultatet gemmes i filen.

OcesSigningVerifier klassen benyttes til at verificere en signatur produceret med OcesSigning. Klassen kan instantieres med:

OcesSigningVerifier verifier = OcesSigningVerifier.newInstance(File pkcs12File, String pkcs12password)

Eller

OcesSigningVerifier verifier = OcesSigningVerifier.newInstance(File x509CertificateFile)

Efter instantiering kan klassen verficere på følgende måde:

boolean verified = verifier.verify(File signedFile, File signFile);

Verificering af signaturen foretages ved at tage et SHA-1 hash af filindholdet i signedFile filen. Herefter tages indholdet af signFile og dekrypteres med certifikatets offentlige nøgle. De to hash værdier sammenlignes og hvis de er ens, er signaturen gyldig.

Library'et indeholder en main klasse, som kan benyttes til at eksekvere de forskellige muligheder i library'et.

Det kan benyttes på følgende måde:

java -jar oces-encryption-signing-lib-0.1-jar-with-dependencies.jar

 -certificate FILE                 : The X509 certificate file that contains the public key
 -destination FILE                 : The destination file to store the result in (mandatory when mode=encrypt|decrypt|sign)
 -mode encrypt|decrypt|sign|verify : Set the mode of the program ie the program will decrypt, encrypt, sign or verify
 -password VAL                     : The password used for accessing the pkcs12 file (mandatory when mode=decrypt|sign, optional when mode=encrypt|verify)
 -pkcs12 FILE                      : The pkcs12 file containing both the public and private key (mandatory when mode=decrypt|sign, optional when mode=encrypt|verify)
 -signature FILE                   : The file containing the signature of a signed file
 -source FILE                      : The file used as a source for processing

  Example: java dk.tiede.oces.OcesMain -certificate FILE -destination FILE -mode encrypt|decrypt|sign|verify -password VAL -pkcs12 FILE -signature FILE -source FILE

Som tidligere skrevet er library'et udgivet som Open Source under Apache 2 licensen og jar filen findes her. Det er mit håb at andre vil benytte det og eventuelt bygge videre på det (muligvis noget GUI-værk :-). Kildekoden vil formentlig komme til at ligge under Google projects, men det har jeg ikke besluttet mig for endnu. Giv mig et skriv hvis du har behov for koden.