El sistema https://tramiteya.go.cr/ usado en los trámites de CrearEmpresa, Cámara Costarricense de Empresas de Factoreo (CCEF) y en la Dirección General de Migración y Extranjería (DGME), así como las plataformas https://registrelo.go.cr/ y https://recetadigital.go.cr/ del Ministerio de Salud hacen uso de un componente firmador de escritorio multiplataforma creado en Java que en la actualidad funciona en GNU/Linux pero requiere un pequeño ajuste para funcionar.
Este firmador depende de Java, debe instalarse algún JRE de OpenJDK (completo, no solo headless), preferiblemente versión superior a la 8 para que no falle al lanzarse (ver unos párrafos más abajo una nota al respecto). El fichero descargado se puede abrir desde una terminal en la carpeta de descargas y ejecutando el comando java -jar FirmaDigitalInstaller.jar
Sin embargo, una vez solicite el PIN de la tarjeta, puede aparecer el siguiente mensaje:
ERROR: No se pudo inicializar la firma digital
– Confirme que el driver ya esté instalado
– Revise que su dispositivo de lectura de la firma digital esté bien conectado al puerto USB
(SmartCard Exception. No se pudo Instanciar el Provider SunPKCS11)
Para prevenir este error, ejecute este comando desde una terminal:
ln -s /usr/lib/SCMiddleware/libidop11.so $HOME/FirmaDigital/lib/libASEP11.so
Y ya debería funcionar cuando reintente y le solicite el PIN.
Este servicio local del firmador espera que esté instalado un Java posterior a la versión 8. Si por algún requerimiento el java predeterminado del sistema se requiriera el 8 para otros casos de uso, habría que quitar el parámetro y valor de add-opens del fichero $HOME/.profile (utilizado para arrancar el servicio al iniciar la sesión de escritorio) o editar la ruta a java de ese fichero para que apunte a un java diferente, que es preferible. Se sugiere utilizar el comando alternatives o update-alternatives existente en varias distribuciones para ajustar el java predeterminado según convenga.
Arreglar el puerto cuando deja de funcionar tras limpiar la configuración del navegador
El firmador puede dejar de funcionar en la comunicación con el sitio web. Cuando esto sucede, al tratar de iniciar sesión en el sitio web, el navegador hace que se descargue de nuevo el FirmaDigitalInstaller.jar en lugar de aparecer la ventana para ingresar de PIN. Esto puede suceder cuando se limpia la información del sitio web o cuando se intenta acceder desde otro navegador web, así como cuando se accede desde sesión privada/incógnito. Al descargarse e instalarse por primera vez, se genera en la configuración un número de puerto elegido dentro de un intervalo y se guarda en una configuración local tanto en la configuración del firmador como en la configuración del sitio web dentro del navegador (localStorage). Sin embargo, por lo mencionado anteriormente, esta configuración puede no estar disponible en modo incógnito/privado, o porque se haya borrado, o porque se acceda desde otro sitio web diferente que usa el mismo firmador, o usando otro navegador, haciendo que no coincida con el puerto configurado en el firmador local. En cualquier caso, cuando en el navegador no está configurado este valor, lo que hace el sitio web es intentar conectar por un puerto predeterminado (52900), por lo que se puede configurar este mismo localmente de manera manual para restaurar el acceso. Para ello, hay que editar el fichero $HOME/.java/.userPrefs/com/soin/firmaDigital/prefs.xml y cambiar el valor del FirmaDigitalServer.SSLport, por ejemplo si está en value="50123" (puede ser otro número) debe cambiarse a value="52900". Después de aplicar este cambio hay que reiniciar el servicio. La manera más práctica es reiniciando la sesión o el sistema.
Esta guía se había publicado inicialmente en 2021 pero con actualizaciones posteriores había dejado de funcionar. Se ha actualizado esta guía en 2025 para que funcione con los nuevos controladores de Idopte para tarjetas JCOP3 y JCOP4.
Al pasar ejecutarlo sale este mensaje y no funciona:ln: /Users/edo/FirmaDigital/lib//libASEP11.so: File exists
edo@Eduardos-MacBook-Air ~ %
Hola Eduardo, si está usando macOS no lo he probado y parece que no requiere el enlace simbólico hoy en día, parece que SOIN hizo una actualización al FirmaDigitalInstaller.jar. De todos modos hoy día no me está funcionando, aunque sí aparece la ventana de solicitud de PIN, al ingresarlo no continúa ni para registrarse ni para acceder en la mayoría de ocasiones. Desactivando extensiones como ublock origin tampoco parece funcionar. Probado en Chrome y Firefox sin éxito, por lo que esta guía está obsoleta por ahora hasta que se encuentre una solución, si es que todavía está funcionando este sistema.
Hola de nuevo Eduardo, creo que encontré la manera de hacer funcionar el firmador actualizado en macOS, por si puede entrar en sesión privada/incógnito de navegador y aplicar este comando en la aplicación Terminal de macOS:
/usr/libexec/PlistBuddy -c "set :/com/soin/firmaDigital/:FirmaDigitalServer.SSLport 52900" ~/Library/Preferences/com.soin.firmadigital.plistRequiere reiniciar tras ejecutar el comando para aplicar los cambios.
Saludos.
Hola, tengo el mismo error en macOS, estoy seguro que estamos cerca de la solución pero todavía no le llegamos
Yo logré eliminar el error instalando OPEN JDK desde esta página: https://adoptium.net/es/
Pero ahora el PIN no se envía en la solicitud http a receta digital, es decir, revisando, aunque el usuario coloque el PIN y le de click en “firmar” la solicitud inicializa pero el dato del PIN no va en los parámetros, alguna línea de código se queda “enciclada”
Gracias Ariel, [información editada por obsoleta]
También puede probar UTM para macOS y virtualizar otro sistema operativo mientras se resuelve ese problema: https://mac.getutm.app/
Saudos.
Gracias a usted por estos aportes, sigo investigando sobre otros temas de firma en macOS, hice un video sobre su investigación para entrar a la CCSS usando el firmador en mac, con sus respectivos créditos: https://www.youtube.com/watch?v=vA4mpMHxkY8&t=139s
Muchas gracias Ariel por la mención. Creo que encontré la manera de hacer funcionar el firmador actualizado en macOS para los casos en los que falla con la actualización más reciente del FirmaDigitalInstaller.jar, por si tras instalarlo puede entrar en sesión privada/incógnito de navegador y aplicar este comando en la aplicación Terminal de macOS:
/usr/libexec/PlistBuddy -c "set :/com/soin/firmaDigital/:FirmaDigitalServer.SSLport 52900" ~/Library/Preferences/com.soin.firmadigital.plistAgradecería si tras ejecutar el comando el cambio y reiniciar puede confirmar si se resolvió en su caso. Saludos.
En mi caso, me da ese mismo error pero en Windows 10, alguna solución?
Hola, no logro reproducir el problema en Windows, aunque sugiero verificar lo siguiente:
Intente actualizar el instalador de firma digital desde el sitio web https://soportefirmadigital.com/sfdj/dl.aspx?lang=es de su tarjeta, en caso de que sea nueva especialmente (modelo de tarjeta con número de serie en el frente JCOP4). Otra posibilidad es que que cuando instaló Java desde java.com y lanzó el jar por primera vez hubiera rechazado a nivel cortafuegos la comunicación de Java SE cuando Windows lo solicita, o si usa un cortafuegos o solución de seguridad de terceros (“antivirus”) que estuviera bloqueando esta comunicación. Saludos.
Tengo exactamente el mismo problema desde que tuve que renovar mi firma digital con creaempresa. Es un completo atropello a los usuarios que esta gente de racsa no brinde ningun tutorial y la solucion de ellos sea llamar al centro de servicio en donde cobran por minuto. Desconozco si otros colegas Notarios tengan el mismo problema
Algunas herramientas de firma y autenticación no funcionan muy bien o no son claras los mensaje de error. Algunos firmadores se actualizaron para ser compatibles con tarjetas nuevas JCOP4 (las que tienen el número de serie en la parte del frente) y otros (como el de la CCSS) todavía no. En las pruebas con Windows no tuve problemas, ¿le funcionan otros firmadores en Windows con esa tarjeta nueva que no sean el FirmaDigitalInstaller.jar de SOIN/RACSA?
Como instalarlo en linux mediante un fork de ubuntu?
Hola Sergio, dependerá de la versión en la que se basa el fork, pero en general ocupará instalar el paquete de Java “default-jre” y el servicio del lector de tarjetas “pcscd”, puede instalarlos mediante los comandos:
sudo apt -y install default-jre pcscd
sudo systemctl enable pcscd
sudo systemctl start pcscd
También debe instalar el paquete .deb que lleva el nombre SCMiddleware que se descarga para Ubuntu desde el sitio web soportefirmadigital.com.
Ese instalador de SCMiddleware puede dañar el fichero openssl.cnf y afectar a múltiples aplicaciones, puede restaurarlo así:
sudo rm /etc/ssl/openssl.cnf
sudo apt reinstall -o Dpkg::Options::=”–force-confmiss”
Tras ello puede seguir los pasos de este artículo de blog y lanzar el jar desce la carpeta Descargas:
cd $(xdg-user-dir DOWNLOAD)
java -jar FirmaDigitalInstaller.jar
Y si le aparece el error mencionado, crear el enlace simbólico como se indica en esta guía.
Cualquier consulta adicional con mucho gusto.
Saludos,
¿como instalo el firmador.jar en crear empresa?
Hola Sergio, el FirmaDigitalInstaller.jar (no el firmador.jar) es el explicado en esta guía, son dos firmadores diferentes. Esta guía suele funcionar si tiene instalado el instalador de SCMiddleware como se explicó en un comentario anterior. Si hay algún detalle que no logre seguir me puede contactar directamente por correo y lo podemos analizar paso por paso.
Saludos,
El error que me sale es el siguiente: Error: no se pudo inicializar la firma digital – confirme que el driver ya esté instalado – revise que su dispositivo de lectura de la firma digital esté bien conectado al puerto usb (smartcard exception. no se pudo instanciar el provider sunpkcs11). Mi sistema operativo es Windows 11
Hola Francisco, ¿desde qué sitio web y aplicación de firma digital le muestra el mensaje? Saludos.
Buenos días, en el momento que pongo: “ln -s /usr/lib/SCMiddleware/libidop11.so $HOME/FirmaDigital/lib/libASEP11.so” me aparece este problema en Win10:
“ln” no se reconoce como un comando interno o externo,
programa o archivo por lotes ejecutable.
Buenas tardes Alfredo, ese comando solamente funciona en Linux, para Windows no he logrado hacer que funcionen enlaces simbólicos desde unas librerías a las otras. El problema es que las nuevas tarjetas JCOP4 aparentemente no están funcionando con ese componente de firmado de RACSA, a pesar de que deberían haberlo actualizado hace aproximadamente un año. Hace unas semanas que no lo pruebo, pero en las últimas pruebas todavía no funcionaba con las nuevas tarjetas. Alternativamente, puede intentarlo desde una máquina física o virtual con un sistema operativo GNU/Linux como alternativa funcional a Windows, utilizando esa técnica. Si prefiere utilizar Windows, deberá presionar a RACSA que resuelva la situación si todavía no funciona. Saludos.
Buenos días Fernando, gracias por la respuesta, y si, resulta que escribí un correo a Racsa para explicar del problema, y en el momento de enviarlo me sale un error de que no se pudo enviar, y ya ves, más problemas jaja
Gracias Alfredo, cierto, a veces escribir por correo a algunas instituciones es imposible porque tienen mal configurado el correo e impide la entrega externa (o es sin querer queriendo, o no se dieron cuenta realmente de que falla).
Tal vez valore la posibilidad de parchear estos firmadores como hice con el firmador del BAC para que funcionara en Linux. Es un procedimiento de ingeniería inversa, que es algo controvertido, pero la ley de propiedad intelectual tiene una excepción para temas de interoperabilidad y sin que haya lucro, así que me la podría jugar sin meterme en enredos legales.
Si encuentro algo de tiempo parchearé varios firmadores conocidos que tienen ese problema. Es un poco mañoso el proceso aplicar el parche, pero es viable crear documentación sobre cómo aplicarlo fácilmente.
Hola Francisco, le comento que encontré la solución al problema para ingresar a CrearEmpresa, es nada más actualizar Java, lo que hice fue primero desinstalar la vieja versión y luego descargar e instalar la: “Version 8 Update 471
Fecha de publicación: October 21, 2025” desde la misma página de Java. Tal vez algunos les pueda servir esta solución de Win10. Saludos!
Hola Alfredo, muchísimas gracias por confirmar cómo resolverlo en ese caso. Se sabe por ejemplo que algunas actualizaciones desde Java antiguo para Windows rompen la apertura de archivos .jar y solo desinstalando y volviendo a instalar se resuelve. Saludos.