Instalación de la aplicación de Firma Digital de Costa Rica V.2 (Agente Gaudi)

Como mencioné en la primera versión de este artículo, en Costa Rica existe el servicio de Firma Digital, el cual permite acceder a ciertos sitios web del gobierno y firmar documentos de manera electrónica. Este servicio es provisto por el Banco Central de Costa Rica.

Una vez que se adquiere la tarjeta de firma digital, es necesario descargar e instalar los controladores (drivers) correspondientes desde el sitio web del Centro de Soporte Firma Digital.

Sin embargo, para este año 2026, los drivers instalados anteriormente tanto en Microsoft Windows como en GNU/Linux están presentando errores de validación. Estos errores impiden firmar documentos o acceder a los sitios web que requieren autenticación mediante firma digital. Por esta razón, es obligatorio descargar e instalar las versiones más recientes de los controladores para poder seguir utilizando este servicio.

En mi caso particular, al utilizar Linux Mint 22.3 Cinnamon (Zena), descargué la versión correspondiente a Ubuntu 24.04 LTS (Noble Numbat), ya que Linux Mint está basado en Ubuntu y es totalmente compatible.

El archivo descargado tiene el nombre sfd_ClientesLinux_DEB64_Ubuntu24_Rev30.zip.

Como suele suceder, las instrucciones oficiales de instalación son bastante deficientes, por lo que a continuación detallo paso a paso el proceso de instalación.

Primero que todo deben de desinstalar los drivers anteriores y el gaudi instalados en su equipo para luego proceder con la instalación de la nueva versión.

En Linux Mint 22.3 tenemos la aplicación Origenes del Software ubicado en Configuración del Sistema, ahí seleccionamos la opción Mantenimiento y luego Eliminar los paquetes externos, en mi caso seleccione para desinstalar agente-gaudi, idprotectclient y idprotectclientlib

Luego descomprimimos el archivo sfd_ClientesLinux_DEB64_Ubuntu24_Rev30.zip y extraemos el directorio sfd_ClientesLinux_DEB64_Ubuntu24_Rev30 de ese directorio debemos de instalar los siguiente archivos los cuales se muestran en el siguiente diagrama:

El diagrama muestra los directorios que contienen los archivos a instalar, los números entre paréntesis cuadrados muestran la secuencia de instalación:

[1] Directorio Firma Digital ejecutar en la consola de comando:

bash -x lib.sh

[2] Directorio Idopte ejecutar en la consola de comando:

sudo dpkg -i scmiddleware-costa-rica-user_idopte_6.23.44.0_ubun24_amd64.deb

[3] Directorio Agente GAUDI ejecutar en la consola de comando:

sudo dpkg -i agente-gaudi_26.0_amd64.deb;exit

Una vez realizada la instalación, es recomendable reiniciar el equipo y, si es el caso, conectar el lector de Firma Digital.

Al iniciar la sesión en el equipo, aparecerá en la barra de tareas un icono de una "G" en forma de engranaje de color verde. Este es el Agente Gaudi, el cual nos permite, al insertar la firma digital en el lector, validar el ingreso a las páginas web o firmar documentos. Los drives para la tarjeta de Firma Digital aparecen en la barra de tareas como un icono del chip de la Firma Digital.