Chi per vari motivi abbia avuto a che fare con l’integrazione delle funzionalità di firma digitale all’interno delle proprie applicazioni, si sarà sicuramente scontrato con qualche piccola difficoltà dovuta all’aggiornamento del formato di memorizzazione dei files imposto dalle recenti modifiche normative.

Il 17 agosto 2010 veniva infatti pubblicata in Gazzetta Ufficiale la Determinazione Commissariale n.69/2010 DigitaPA che fissava il 30/06/2011 quale data ultima per l’adeguamento dei formati di firma alle specifiche CAdES.

CMS Advanced Electronic Signatures è un set di estensioni della specifica Cryptographic Message Syntax per la realizzazione di firme digitali avanzate particolarmente sicure e, soprattutto, conformi con la Direttiva Europea 1999/93/EC.

Di fatto il formato è molto simile al “vecchio” PKCS-7 e richiede, per lo meno al fine di soddisfare i requisiti minimi definiti dalle specifiche CAdES Basic Electronic Signature (CAdES-BES), solo l’inserimento di un attributo firmato all’interno del “contenitore” multipart.

Qui di seguito uno snippet di codice Java di esempio che utilizza le librerie Bouncy Castle per la creazione del file p7m CAdES:

/**
* Simula il file di configurazione
* serve principalmente per settare il path della lilbreria pkcs11
*/
String pkcs11config ="name = SmartCard\n library = /path/to/libbit4opki.dylib";
byte[] pkcs11configBytes = pkcs11config.getBytes();
ByteArrayInputStream configStream =new ByteArrayInputStream(pkcs11configBytes);

// Inizializza il security provider pkcs11
Provider pkcs11Provider =new sun.security.pkcs11.SunPKCS11(configStream);
Security.addProvider(pkcs11Provider);
Security.addProvider(new BouncyCastleProvider());

/**
*  Setta la classe che implementa l'handler per l'inserimento
*  del PIN per l'accesso ai dati contenuti nella smartcard
*/
Password ps = new Password(null, true);

/**
* Inizializza il keystore per l'accesso ai certificati contenuti
* nella smartcard
*/
KeyStore.Builder builder = KeyStore.Builder.newInstance("PKCS11", pkcs11Provider, new KeyStore.CallbackHandlerProtection(ps));
KeyStore keyStore = builder.getKeyStore();

/**
* Ottiene la lista degli alias dei certificati memorizzati
* sulla smartcard
*/
Enumeration<String> aliases = keyStore.aliases();

/**
* Cicla gli alias e stampa a video il toString()
* di ogni certificato
*/
while (aliases.hasMoreElements())
 {
 String alias = aliases.nextElement();
 System.out.println("alias: "+alias+"\n----------");
 X509Certificate certTmp=(X509Certificate) keyStore.getCertificate(alias);
 System.out.println("DN: "+certTmp.getSubjectDN().toString()+"\n");
 }

String fileDaFirmarePath = "/path/to/file.txt";
String fileFirmatoPath = fileDaFirmarePath+".p7m";

/**
* Ottengo il certificato e la chiave privata dal keystore (l'inserimento
* del PIN è sempre a carico dell'handler)
*/
Certificate cert = keyStore.getCertificate("DS0");
PrivateKey pKey = (PrivateKey) keyStore.getKey("DS0", null);

/**
* Inizializzo il generatore impostando l'algoritmo di
* hashing desiderato ed aggiungendo un firmatario
*/
CMSSignedDataGenerator gen = new CMSSignedDataGenerator();
ContentSigner sigGen = new JcaContentSignerBuilder("SHA256withRSA").setProvider(pkcs11Provider.getName()).build(pKey);

/**
* -- CADES --
*/
MessageDigest md = MessageDigest.getInstance("SHA-256");
md.update(cert.getEncoded());
byte[] certHash = md.digest();
ESSCertIDv2 essCert1 = new ESSCertIDv2(new AlgorithmIdentifier("2.16.840.1.101.3.4.2.1"),certHash);
ESSCertIDv2[] essCert1Arr = {essCert1};
SigningCertificateV2 scv2 = new SigningCertificateV2(essCert1Arr);
Attribute certHAttribute = new Attribute(PKCSObjectIdentifiers.id_aa_signingCertificateV2,new DERSet(scv2));
ASN1EncodableVector v = new ASN1EncodableVector();
v.add(certHAttribute);
AttributeTable at = new AttributeTable(v);
/**
* -- END CADES --
*/

CMSAttributeTableGenerator attrGen = new DefaultSignedAttributeTableGenerator(at);
SignerInfoGeneratorBuilder genBuild = new SignerInfoGeneratorBuilder(new BcDigestCalculatorProvider());
genBuild.setSignedAttributeGenerator(attrGen);
SignerInfoGenerator sifGen = genBuild.build(sigGen, new X509CertificateHolder(cert.getEncoded()));

gen.addSignerInfoGenerator(sifGen);

/**
* Popolo la "catena di certificazione" (certificate chain)
*/
ArrayList certList = new ArrayList();
certList.add(cert);

X509CollectionStoreParameters x509CollectionStoreParameters = new X509CollectionStoreParameters(certList);
JcaCertStore jcaCertStore = new JcaCertStore(certList);
gen.addCertificates(jcaCertStore);

/**
*  Genera il file p7m e lo salva nel path specificato. Inserendo "false" come secondo parametro di generate() si
*  otterrebbe invece un file p7s, ovvero la sola firma "detached".
*/
CMSProcessableFile content = new CMSProcessableFile(new File(fileDaFirmarePath));
CMSSignedData data = gen.generate(content, true);
byte[] res = data.getEncoded();
FileOutputStream fos = new FileOutputStream(new File(fileFirmatoPath));
fos.write(res);
fos.close();

la classe Password serve a gestire l’inserimento del PIN della smartcard. Deve implementare javax.security.auth.callback.CallbackHandler e quindi il metodo public void handle(Callback[] callbacks) che nel più semplice dei casi si limiterà a fornire il PIN al provider:

public void handle(Callback[] callbacks) {
 for (int i = 0; i < callbacks.length; i++) {
  if (callbacks[i] instanceof PasswordCallback) {
  PasswordCallback pass = (PasswordCallback) callbacks[i];
  pass.setPassword("12345678".toCharArray());
  } else {
    System.out.println("+" + callbacks[i].getClass().getName());
    }
  }
}

Altre letture consigliate:

• Digital Document Signing in Java-Based Web Applications
• How Digital Signatures Work: Digitally Signing Messages
• Using Digital Signatures and Certificates in Java
• Java Applet for Signing with a Smart Card