PDF Widgets

En este tutorial, se verá el uso de widgets para firmar un documento PDF.

  • PDF.- Es un formato de almacenamiento para documentos digitales independiente de plataformas de software o hardware.
  • Widget.- Los widgets en documentos PDF son componentes que se pueden agregar al documento, estos pueden ser campos de texto, botones, o firmas entre otros.
  • Firma Digital.- La firma digital es un mecanismo criptográfico que permite garantizar los principios de autenticidad, no repudio e integridad.
  • itext.- Librería para la manipulación de archivos PDF desde java.

Uno de los problemas al momento de firmar un documento digitalmente es tener que transferir ese documento por internet, ya que si es grande puede demorar mucho tiempo.

A contiunación se detalla un ejemplo de código que agrega un widget para poder realizr la firma del documento PDF de forma aislada, haciendo uso de la librería itext.

Para poder lograr esto se requiere crear una clase que será la encargada de firmar el documento.

  1. public class ServerSignature implements IExternalSignature {
  2.     protected String pin;
  3.     protected String alias;
  4.     protected Provider sunPKCS11;
  5.     protected KeyStore keyStore;
  7.     public ServerSignature(String pin, String alias) {
  8.         this.pin = pin;
  9.         this.alias = alias;
  11.         sunPKCS11 = Security.getProvider("SunPKCS11");
  12.         sunPKCS11 = sunPKCS11.configure("token.cfg");
  13.         try {
  14.             keyStore = KeyStore.getInstance("PKCS11", sunPKCS11);
  15.             keyStore.load(null, pin.toCharArray());
  16.         } catch (KeyStoreException | IOException | NoSuchAlgorithmException | CertificateException ex) {
  17.             throw new RuntimeException(ex.getMessage());
  18.         }
  19.     }
  21.     @Override
  22.     public String getHashAlgorithm() {
  23.         return DigestAlgorithms.getDigest(DigestAlgorithms.getAllowedDigest("SHA256"));
  24.     }
  26.     @Override
  27.     public String getEncryptionAlgorithm() {
  28.         try {
  29.             PrivateKey pk = (PrivateKey)keyStore.getKey(alias, pin.toCharArray());
  30.             return pk.getAlgorithm();
  31.         } catch (KeyStoreException | NoSuchAlgorithmException | UnrecoverableKeyException ex) {
  32.             throw new RuntimeException(ex.getMessage());
  33.         }
  34.     }
  36.     public Certificate[] getChain() {
  37.         try {
  38.             return keyStore.getCertificateChain(alias);
  39.         } catch (KeyStoreException ex) {
  40.             throw new RuntimeException(ex.getMessage());
  41.         }
  42.     }
  44.     @Override
  45.     public byte[] sign(byte[] sh) throws GeneralSecurityException {
  46.         PrivateKey pk = (PrivateKey)keyStore.getKey(alias, pin.toCharArray());
  47.         String signMode = getHashAlgorithm();
  48.         signMode += "with" + pk.getAlgorithm();
  49.         Signature signature = Signature.getInstance(signMode, sunPKCS11);
  50.         signature.initSign(pk);
  51.         signature.update(sh);
  52.         return signature.sign();
  53.     }
  54. }

La clase anterior lo que permite es firmar un documento a través del token criptográfico y recibe de la ingeniería de iText el hash que debe ser firmado.

Para utilizar la clase anterior, simplemente se necesitaría las siguientes instrucciones:

  1. try {
  2.     PdfReader reader = new PdfReader(new FileInputStream("prueba.pdf"));
  3.     PdfSigner signer = new PdfSigner(reader, new FileOutputStream("prueba.signed.pdf"), new StampingProperties());
  5.     Rectangle rect = new Rectangle(0, 0, 0, 0);
  6.     PdfSignatureAppearance appearance = signer.getSignatureAppearance();
  7.     appearance.setPageRect(rect);
  8.     signer.setFieldName("sig");
  10.     IExternalDigest digest = new BouncyCastleDigest();
  11.     IExternalSignature signature = new ServerSignature("12345678", "355409121073");
  13.     signer.signDetached(digest, signature, ((ServerSignature)signature).getChain(), null, null, null, 0, PdfSigner.CryptoStandard.CADES);
  14. } catch (FileNotFoundException ex) {
  15.     Logger.getLogger(Main.class.getName()).log(Level.SEVERE, null, ex);
  16. } catch (IOException | GeneralSecurityException ex) {
  17.     Logger.getLogger(Main.class.getName()).log(Level.SEVERE, null, ex);
  18. }

El documento prueba.pdf se firmará con el certificado asociado al alias 355409121073 disponible en el token criptográfico y accesible a través del pin de seguridad 12345678.

El documento firmado será guardado con el nombre prueba.signed.pdf

Si desea descargar el ejemplo puede hacerlo a través del siguiente link: Código de ejemplo

© ADSIB 2019 Bolivia