Manual de Instalación eToken HYP2003
Guía completa para Ubuntu, Debian, Fedora y otras distribuciones Linux
Antes de Comenzar
- • Necesitarás acceso root o permisos sudo
- • Asegúrate de tener conexión a Internet para descargar dependencias
- • Cierra todas las aplicaciones que puedan usar certificados digitales
- • NO conectes el eToken hasta que se indique en los pasos
- • Familiarízate con el uso básico de la terminal
Distribuciones Compatibles
Este manual cubre las distribuciones más populares:
- • Ubuntu: 20.04 LTS, 22.04 LTS, 24.04 LTS
- • Debian: 10 (Buster), 11 (Bullseye), 12 (Bookworm)
- • Fedora: 36, 37, 38, 39, 40+
- • Otras: Linux Mint, Elementary OS, Pop!_OS (basadas en Ubuntu)
Pasos de Instalación
Descargar el Driver
Descarga el paquete de instalación oficial del driver eToken HYP2003 para Linux.
Descargar Driver Linux
Nombre del archivo: eToken-HYP2003-Linux-Driver.tar.gz
Tamaño aproximado: ~35 MB
También puedes descargarlo desde la terminal:
Instalar Dependencias
Antes de instalar el driver, necesitas instalar algunas dependencias. Selecciona tu distribución:
Ejecuta los siguientes comandos en la terminal:
sudo apt install -y libpcsclite1 pcscd libccid pcsc-tools opensc
Estos paquetes proporcionan el soporte necesario para tarjetas inteligentes y tokens criptográficos.
Iniciar el Servicio pcscd
El servicio pcscd (PC/SC Smart Card Daemon) es necesario para que el sistema reconozca dispositivos de tarjetas inteligentes como el eToken.
sudo systemctl enable pcscd
Verifica que el servicio esté en ejecución:
Deberías ver "active (running)" en verde si todo está correcto.
Extraer e Instalar el Driver
Extrae el archivo descargado e instala el driver:
cd ~/Descargas
# Extrae el archivo
tar -xzf eToken-HYP2003-Linux-Driver.tar.gz
# Navega a la carpeta extraída
cd eToken-HYP2003-Linux-Driver
# Ejecuta el instalador con privilegios de root
sudo ./install.sh
Durante la instalación, se te puede solicitar confirmar la instalación de archivos adicionales. Acepta todas las solicitudes escribiendo "y" o "yes".
Configurar Permisos de Usuario
Para que tu usuario pueda acceder al eToken sin necesidad de ser root cada vez, agrégalo al grupo scard:
También puedes necesitar crear reglas udev para el dispositivo:
Agrega la siguiente línea al archivo:
Guarda el archivo (Ctrl+O, Enter, Ctrl+X) y recarga las reglas:
sudo udevadm trigger
Reiniciar el Sistema
Para que todos los cambios surtan efecto, reinicia tu sistema:
El reinicio es importante para que el sistema cargue correctamente los módulos del driver y las nuevas reglas de permisos.
Conectar el eToken
Después de reiniciar:
- Conecta el eToken HYP2003 a un puerto USB
- El sistema debería reconocerlo automáticamente
- El LED del eToken debería encenderse o parpadear
Verificar la Instalación
Usa los siguientes comandos para verificar que el eToken está correctamente instalado:
Método 1: Verificar con pcsc_scan
Deberías ver información sobre el eToken/ePass2003. Presiona Ctrl+C para salir.
Método 2: Listar lectores con opensc
Deberías ver el eToken listado como un lector de tarjetas.
Método 3: Verificar dispositivo USB
Deberías ver una línea que menciona "Feitian Technologies" o "ePass".
Método 4: Verificar con pkcs11-tool
Si tu eToken ya tiene certificados, deberías ver información sobre ellos.
Configuración de Navegadores
Mozilla Firefox
Firefox requiere configuración adicional para usar el eToken:
- Abre Firefox y ve a Preferencias
- Busca "Dispositivos de Seguridad" en la barra de búsqueda
- Haz clic en "Dispositivos de Seguridad..."
- Haz clic en "Cargar"
- Ingresa un nombre descriptivo, por ejemplo: "eToken"
- Como ruta del módulo, ingresa:
/usr/lib/opensc-pkcs11.so - Haz clic en "Aceptar"
Si la ruta no funciona, intenta con /usr/lib/x86_64-linux-gnu/opensc-pkcs11.so
Google Chrome / Chromium
Chrome y Chromium deberían reconocer automáticamente el eToken a través de NSS (Network Security Services). Si no funciona:
- Instala el paquete libnss3-tools si aún no lo tienes:
sudo apt install libnss3-tools # Ubuntu/Debian
sudo dnf install nss-tools # Fedora - Agrega el módulo PKCS#11:
modutil -dbdir sql:$HOME/.pki/nssdb -add "eToken" -libfile /usr/lib/opensc-pkcs11.so
Solución de Problemas
El dispositivo no es reconocido
Soluciones:
- Verifica que el servicio pcscd esté en ejecución:
sudo systemctl status pcscd - Reinicia el servicio:
sudo systemctl restart pcscd - Verifica que las dependencias estén instaladas correctamente
- Comprueba que las reglas udev estén configuradas correctamente
- Intenta desconectar y reconectar el eToken
Permisos insuficientes
Soluciones:
- Verifica que tu usuario esté en el grupo scard:
groups $USER - Si no aparece, agrégalo:
sudo usermod -a -G scard $USER - Cierra sesión y vuelve a iniciar sesión para que los cambios surtan efecto
- Verifica que las reglas udev tengan MODE="0666"
El navegador no detecta el certificado
Soluciones:
- En Firefox: Verifica que el módulo PKCS#11 esté correctamente cargado
- En Chrome: Reinicia el navegador después de instalar el driver
- Asegúrate de que el eToken esté conectado antes de abrir el navegador
- Verifica que el certificado esté correctamente instalado en el eToken
Error "SCard Error: Service not available"
Soluciones:
- Este error indica que pcscd no está en ejecución
- Inicia el servicio:
sudo systemctl start pcscd - Habilítalo para que inicie automáticamente:
sudo systemctl enable pcscd - Si persiste, reinstala pcsc-lite
Configuración del PIN
La primera vez que uses tu eToken, deberás establecer un PIN de seguridad. Puedes hacerlo usando pkcs11-tool:
Recomendaciones para el PIN:
- • Usa entre 6 y 16 caracteres
- • Combina números y letras para mayor seguridad
- • No uses fechas de nacimiento o secuencias obvias
- • Guarda tu PIN en un lugar seguro
¡Importante! Después de 3 intentos fallidos de PIN, el eToken se bloqueará y necesitarás el código PUK para desbloquearlo.
¡Instalación Completada!
Ahora estás listo para usar tu eToken HYP2003 en Linux con tu certificado de firma electrónica.
Instala tu Certificado
Si aún no has instalado tu certificado digital, visítanos o solicita asistencia para completar el proceso.
Comienza a Firmar
Consulta nuestros manuales de uso para aprender a firmar documentos con tu nuevo certificado.