Esta guía le ayudará a comprender el proceso técnico necesario para gestionar la firma digital en archivos XML y CFDI utilizando Java. Estas instrucciones asumen que el Kit de desarrollo de Java (JDK) está instalado en su computadora y que los comandos keytool y jarsigner están incluidos en su RUTA.
Fundamentos de firma digital y certificados
A partir del 1 de junio de 2023, los certificados de firma de código de validación de organización (OV) e individual (IV) de SSL.com se han emitido en tokens USB del estándar federal de procesamiento de información 140-2 (FIPS 140-2) o a través de nuestro servicio de firma de código en la nube eSigner.
Java usa archivos con la extensión .jks (Java KeyStore) para almacenar certificados y claves criptográficas. Si prefiere generar su par de claves y CSR con Java, siga estos pasos:
- Primero, crearemos un almacén de claves y un par de claves pública / privada.
- Ingrese el comando para generar un almacén de claves y un par de claves RSA de 3072 bits.
- Se le presentará una serie de indicaciones para configurar su información de identidad (nombre, organización, ciudad, estado, país).
- Utilice los comandos de keytool para generar un CSR del almacén de claves creado.
- Utilice el comando de importación para integrar el certificado emitido en su archivo de almacén de claves Java.
Implementación técnica para CFDI
El objetivo es explicar cómo crear un sello digital para la facturación electrónica. Lo primero que hay que hacer es generar la cadena original, cuya creación está especificada en el anexo 20 de la Resolución Miscelánea Fiscal. Esta es una cadena formada con los datos de la factura, separados por el carácter pipe ”|”, iniciando y finalizando con un doble pipe “||”.
Proceso de sellado digital
- Digestión y encriptación: Una vez obtenida la cadena original, el siguiente paso es pasarla por un algoritmo de digestión (como MD5 o SHA) y el resultado pasarlo por un algoritmo de encriptación RSA. Estos dos pasos se pueden realizar en uno solo con el API de Java.
- Manejo de claves privadas: Necesitamos la clave privada (archivo .key) proporcionada por el SAT junto con su contraseña. Esta clave está codificada según el estándar PKCS8 en formato DER y encriptada.
- Librerías recomendadas: Para poder desencriptarla, es común utilizar la librería commons-ssl de Apache.
- Generación de firma: Se utiliza el objeto java.security.Signature, inicializándolo con la clave privada para obtener el arreglo de bytes con la cadena original encriptada.
- Codificación: A continuación, se codifica en Base64 la cadena para obtener caracteres imprimibles utilizando el objeto sun.misc.BASE64Encoder.
Validación y estructura del XML
Un servicio que recibe un Comprobante Fiscal Digital por Internet (CFDI) realiza la validación de su integridad, sello digital y estructura conforme al estándar del SAT. Es fundamental prestar atención a la estructura del documento, ya que errores comunes como "Error al leer el documento XML" suelen deberse a estructuras no válidas o codificaciones distintas a UTF-8.
Lea también: RFC en México: ¿Cómo interpretarlo?
Cada elemento Reference identifica la información por medio de una URI, creando la digestión de la información antes de procesar la firma. La información firmada debe ser lógicamente equivalente, utilizando algoritmos como PKCS#1 RSA-SHA1.
| Componente | Descripción |
|---|---|
| Cadena Original | Datos de la factura separados por "|" encerrados en "||". |
| Algoritmo | RSA-SHA1 (RFC 2437) para la encriptación. |
| Formato | Base64 para caracteres imprimibles en el XML. |
Lea también: importar y visualizar CFDI en hojas de cálculo
Lea también: consulta nuestra guía detallada sobre las NIF y el NIF