Ejemplo de petición de sello de tiempo

El objetivo de este ejemplo es mostrar los pasos necesarios para realizar una petición de sellado de tiempo. El código completo del ejemplo se puede ver aquí. También se puede ver el Javadoc asociado al ejemplo aquí.

Los pasos principales para realizar una petición de sellado de tiempo contra una TSA (TimeStamp Authority) son los siguientes:

1. Crear la instancia del cliente TSCliente:

   TSCliente cliente = new TSCliente(TSA_URL, ALGORITHM);
   

   Como se puede observar, para la instanciación de un cliente de sellado de tiempo son necesarios dos parámetros:

   • TSA_URL: Se corresponde con la URL a la que se harán las peticiones.
   • ALGORITHM: Se corresponde con el algoritmo del hash de los sellos de tiempo.
2. Realización de la petición y obtención de resultado como un array de bytes:

   byte[] result;
   try {
       result = cliente.generarSelloTiempo(DATA);
   } catch (TSClienteError e) {
       (... Error generando el sello de tiempo ...)
   }
   

3. En este momento se dispone del sello de tiempo como un array de bytes. Sin embargo, es habitual querer convertirlos a un objeto de alto nivel. En el ejemplo, que utiliza la librería criptográfica Bouncy Castle, se convierten los bytes a un objeto de la clase TimeStampToken:

   TimeStampToken timeStampToken;
   try {
       timeStampToken = new TimeStampToken(new CMSSignedData(result));
   } catch (TSPException e) {
       (... Error parseando el sello de tiempo ...)
   } catch (IOException e) {
       (... Error parseando el sello de tiempo ...)
   } catch (CMSException e) {
       (... Error parseando el sello de tiempo ...)
   }
   

4. Mediante el objeto TimeStampToken anterior ya se podrían consultar las propiedades del token. Algunas propiedades que pueden resultar interesantes son las siguientes:
   • Número de serie del token:

     timeStampToken.getTimeStampInfo().getSerialNumber()
     

   • Fecha de generación del token:

     timeStampToken.getTimeStampInfo().getGenTime()
     

   • OID de la política del token:

     timeStampToken.getTimeStampInfo().getPolicy()
     

   • OID del algoritmo del hash:

     timeStampToken.getTimeStampInfo().getMessageImprintAlgOID()
     

Además de los pasos indicados anteriormente, puede ser necesario realizar alguna configuración extra si se está ante uno de los casos mostrados a continuación.

KeyStore ks = null;
try {
    ks = KeyStore.getInstance("PKCS12");
    ks.load(this.getClass().getResourceAsStream(PKCS12_RESOURCE), PKCS12_PASSWORD.toCharArray());
    KeyManagerFactory kmf = KeyManagerFactory.getInstance("SunX509");
    kmf.init(ks, PKCS12_PASSWORD.toCharArray());
    TSCliente.setSSLManager(new SimpleSSLManager(new AllTrustedManager(), kmf.getKeyManagers()[0]));
} catch (CertificateException e) {
    (... Error configurando el cliente por SSL ...)
} catch (KeyStoreException e) {
    (... Error configurando el cliente por SSL ...)
} catch (NoSuchAlgorithmException e) {
    (... Error configurando el cliente por SSL ...)
} catch (IOException e) {
    (... Error configurando el cliente por SSL ...)
} catch (UnrecoverableKeyException e) {
    (... Error configurando el cliente por SSL ...)
}

System.setProperty("http.proxyHost", PROXY_SERVER);
System.setProperty("http.proxyPort", Integer.toString(PROXY_PORT));
if (IS_PROXY_AUTH) {
    Authenticator.setDefault(new Authenticator() {
        @Override
        protected PasswordAuthentication getPasswordAuthentication() {
            return new PasswordAuthentication(PROXY_USER, PROXY_PASSWORD.toCharArray());
        }
    });
} else {
    Authenticator.setDefault(null);
}