Consumir webservices bajo Https en Java

Usualmente cuando desarrollamos aplicaciones en Java que van a hacer uso de recursos seguros (como en este caso, consumir webservices a través de un canal cifrado), debemos asegurarnos de tener instalados los certificados digitales necesarios puesto que al ser Java un lenguaje multiplataforma, no utiliza los certificados alojados en el sistema operativo [1]. Es por esa razón que decidí escribir este artículo dedicado a este tema. Los pasos para realizar esto los voy a detallar a lo largo de este post, en donde así mismo mostraré un ejemplo práctico. Bueno... ¡manos a la obra!

Descargando el certificado digital:

El Keysotre o JKS (Java Key Store) es un repositorio de certificados de seguridad, certificados de autorización o certificados de clave pública, utilizados por ejemplo en el cifrado SSL. Usualmente el JDK contiene un almacén de claves de certificados de autorización (CA) en la ruta jre/lib/security/cacerts. Así mismo el JDK provee una herramienta llamada keytool para manipual el keystore.
Para importar un certificado a nuestro keystore, lo primero que debemos hacer es descargar  dicho certificado desde la dirección url del wsdl. En este caso les mostraré cómo se hace utilizando el navegador Google Chrome por ser uno de los más populares (Y espero que no me condenen por lo último dicho). Bueno, accedemos al wsdl mediante la url tal como se muestra en la siguiente imagen:

Ahora hacemos clic en el candado verde y se desplegará un panel con dos pestañas. Debemos posicionarnos en la pestaña Conexión como muestro a continuación:

Ahora hacemos clic en Datos del certificado y se abrirá la siguiente ventana:

En la ventana anterior debemos hacer clic en el botón Copiar en archivo... para importar el certificado. Esto nos abrirá un asistente (el clásico siguiente-siguiente) tal como se muestra en la imagen siguiente:

Hacemos clic en Siguiente> y vamos a la siguiente imagen:

Seleccionamos X.509 codificado base 64 (.CER) y hacemos clic en Siguiente>. Ahora toca seleccionar la ruta donde queremos guardar nuestro certificado, en el caso de la imagen he seleccionado el escritorio. Elegimos la carpeta que gustemos y hacemos clic en Siguiente>.

Ahora solo nos falta hacer clic en el botón finalizar de la siguiente ventana:

Con esto ya tenemos el certificado, ahora solo hace falta importarlo a nuestro keystore, para lo cual haremos uso del keytool. 

Importando el certificado digital a nuestro keystore:

Para importa el certificado digital descargado a nuestro keystore vamos a usar el keytool (del cual ya les comenté al principio de este post) que se encuentra ubicado en: ..\Java\jdk1.6.0_23\jre\bin tal como se muestra en la siguiente imagen.

Lo que debemos hacer es llamar a la herramienta keytool.exe desde una consola, con el siguiente comando: 

keytool -import -keystore "C:\Archivos de programa\Java\jre1.6.0_05\lib\security\cacerts" -file c:\NuevaEntidadCertificadora.cer -alias CA_SRI -storepass changeit

En donde las partes de color azul son valores relativos de: nuestra instalación de java, la ruta en donde descargamos nuestro certificado y el alias que le asignaremos y que debe ser único.

Lo primero que debemos recordar es que debemos ejecutar la consola de windows como administrador ya que vamos a sobreecribir un archivo en una carpeta con privilegios especiales. Para hacer esto debemos ejecutar la consola tal como se muestra en la siguiente imagen:

Luego ejecutamos el comando que se mencionó anteriormente:

E indicamos que confiamos en el certificado que vamos a agregar con un si.

Descargando el wisdel:

Ahora solo resta descargar el wsdl, para lo cual ejecutamos los tres sencillos pasos que detallo a continuación en imágenes:

Creando el proyecto en netbeans:

Creamos una sencilla aplicación de escritorio y luego agregamos un nuevo cliente para consumir el webservice.

Seleccionamos el wisdel que hemos descargado anteriormente.

Y con eso nos deberá generar una estructura similar a la mostrada en la siguiente imagen:

Luego de eso, debemos agregar la siguiente clase que contiene el método main que nos servirá para poder probar la aplicación.

package com.rolandopalermo.ejemplos.test;

import com.rolandopalermo.ejemplos.RespuestaSolicitud;

/**
 *
 * @author Rolando
 */
public class Main {

    private static RespuestaSolicitud validarComprobante(byte[] xml) {
        com.rolandopalermo.ejemplos.RecepcionComprobantesService service = new com.rolandopalermo.ejemplos.RecepcionComprobantesService();
        com.rolandopalermo.ejemplos.RecepcionComprobantes port = service.getRecepcionComprobantesPort();
        return port.validarComprobante(xml);
    }

    public static void main(String[] args) {
        System.setProperty("javax.net.ssl.keyStore", "C:\Program Files (x86)\Java\jdk1.6.0_23\jre\lib\security\cacerts");
        System.setProperty("javax.net.ssl.keyStorePassword", "changeit");
        System.setProperty("javax.net.ssl.trustStore", "C:\Program Files (x86)\Java\jdk1.6.0_23\jre\lib\security\cacerts");
        System.setProperty("javax.net.ssl.trustStorePassword", "changeit");
        RespuestaSolicitud respuesta = validarComprobante(null);
        System.out.println(respuesta.getEstado());
    }
}

Y con eso ejecutamos la aplicación recibiendo una respuesta lo que nos indica que nuestra aplicación ha funcionado correctamente.

Es muy imporatnte indicar que el método main deberá contener las siguientes líneas de código lo cual le indicará a la aplicación en dónde se encuentra nuestro repositorio de certificados.

System.setProperty("javax.net.ssl.keyStore", "C:\Program Files (x86)\Java\jdk1.6.0_23\jre\lib\security\cacerts");
System.setProperty("javax.net.ssl.keyStorePassword", "changeit");
System.setProperty("javax.net.ssl.trustStore", "C:\Program Files (x86)\Java\jdk1.6.0_23\jre\lib\security\cacerts");
System.setProperty("javax.net.ssl.trustStorePassword", "changeit");

Espero que este artículo les sea de utilidad y cualquier pregunta no duden en comentarla. Saludos y hasta una próxima oportunidad.

Y para los interesados, brindamos asesoría en el tema de facturación electrónica. El temario del taller lo pueden descargar aquí: Temario del Taller.