Solavel Documentos
Español

Instalar el conector de Device Connect

Última actualización

El conector es el pequeño programa de Windows que lee sus terminales de asistencia y envía los fichajes a SolaHR. Esta página explica cómo descargarlo, instalarlo, vincularlo, actualizarlo y quitarlo, y qué comprobar cuando algo no funciona. Si prefiere conocer primero la idea, lea el resumen.

Versión preliminar. El conector se ha construido y comprobado con simuladores y un modelo de terminal real. Aún no está firmado, por lo que Windows le avisará al ejecutarlo. Pruébelo primero en un PC y un dispositivo.

#Antes de comenzar

Necesidad Detalle
Un PC o servidor con Windows Windows 10 u 11, o Windows Server 2016 y posteriores, de 64 bits. No se admiten Windows 7/8, Windows de 32 bits ni ARM.
Siempre encendido El PC debe permanecer encendido y activo, y en la misma red (y VLAN) que los terminales. Sirve un PC de oficina pequeño o un servidor.
Derechos de administrador Para instalar y, más adelante, para registrar un SDK del fabricante.
Internet HTTPS saliente hacia la dirección de su SolaHR (por ejemplo https://solavel.com/hr). No se necesita ningún puerto entrante.
Un usuario de SolaHR que pueda gestionar dispositivos El propietario o un responsable de RR. HH.
La dirección IP del terminal Y su clave de comunicación si la tiene. Consulte Añadir un dispositivo.

No se necesita hardware especial; basta un PC de oficina normal (aún no hemos publicado requisitos mínimos medidos).

#Elegir un paquete

En SolaHR abra Tiempo y asistencia → Dispositivos de asistencia → Conectores → Añadir conector. Se ofrecen dos descargas para Windows 10 / 11 · 64 bits, cada una con su versión y tamaño.

Paquete Qué es Úselo cuando
Instalador de Windows .exe (recomendado) Instala el conector como un servicio de Windows: arranca solo al iniciar, se reinicia tras un fallo y conserva sus datos al actualizar. Uso normal.
ZIP portátil Sin instalador. Extráigalo y ejecute install.cmd, que registra una tarea programada que inicia el conector al arrancar. No es un servicio de Windows. Una prueba rápida, o un PC en el que no se puede ejecutar un instalador.

Ambos están marcados como Versión preliminar. Si la página dice «El instalador de Windows estará disponible aquí pronto.», todavía no se ha publicado ningún paquete.

Compruebe su descarga. En Detalles encontrará las notas de la versión y un comando de PowerShell. Ejecútelo y compare: el resultado de Get-FileHash debe ser igual al valor SHA-256 que muestra la página.

#Instalar y vincular, paso a paso

  1. Ejecute el instalador como administrador (clic derecho, Ejecutar como administrador). Con el ZIP: clic derecho en el ZIP, Extraer todo, doble clic en install.cmd y responda Sí.
  2. SmartScreen. Como la versión preliminar no está firmada, Windows puede mostrar «Windows protegió su PC». Tras comprobar el SHA-256, haga clic en Más información y luego en Ejecutar de todas formas. Esta advertencia desaparecerá cuando el programa esté firmado; hasta entonces es esperable y no indica un problema.
  3. Se abre la página del conector en su navegador, en http://127.0.0.1:8790. Esta página solo está disponible en ese PC. El menú Inicio también tiene SolaHR Device Connect.
  4. Obtenga un código de vinculación. En SolaHR pulse Añadir conector y copie el Código de vinculación. Funciona una vez y caduca a los 15 minutos; genere uno nuevo si caduca.
  5. Vincule. En la página del conector escriba la dirección de su SolaHR (por ejemplo https://solavel.com/hr) y el código, y pulse Pair.
  6. En SolaHR el conector aparece como En línea en un minuto. Ahora añada un dispositivo y asígnelo a este conector.

Para equipos de TI, el instalador también se ejecuta en silencio, opcionalmente con la dirección y el código:

SolaHR-Device-Connect-Setup-<version>.exe /S /SERVER=https://solavel.com/hr /CODE=<pairing code>

#Qué instala el instalador en el PC

Artículo Dónde
Programa C:\Program Files\SolaHR Device Connect
Servicio de Windows SolaHRDeviceConnect (inicio automático, se reinicia solo tras un fallo)
Datos: ajustes, secretos cifrados, fichajes aún no enviados, registros C:\ProgramData\SolaHR Device Connect (legible solo por administradores de Windows y el sistema)
Página local http://127.0.0.1:8790 (solo este PC)
Ayudante de línea de comandos solahr-dc (pair, status, diagnostics, run, version)

Compruebe que funciona: en un símbolo del sistema de Windows, sc query SolaHRDeviceConnect debe indicar RUNNING.

#Cortafuegos y red

Dirección Qué Notas
PC del conector hacia SolaHR HTTPS (443) Solo saliente. Si su oficina usa un proxy o filtra sitios web, permita la dirección de su SolaHR.
PC del conector hacia un terminal ZKTeco TCP y UDP 4370 El puerto propio del terminal.
PC del conector hacia un terminal Anviz TCP 5010 Puerto predeterminado de Anviz; compruébelo en el dispositivo.
PC del conector hacia un terminal Hikvision HTTP/HTTPS (el puerto web del dispositivo, 80 por defecto)
PC del conector hacia un servidor Suprema BioStar 2 HTTPS (443 por defecto) Lee a través del servidor BioStar 2, no del terminal.
Otros dispositivos hacia el PC del conector Ninguno Nada se conecta al conector.

El firewall de Windows normalmente permite las conexiones salientes. Si su red separa el PC y los terminales (VLAN distintas), permita estos puertos entre ellos.

#La página del conector

Abra http://127.0.0.1:8790 (o la entrada del menú Inicio). Muestra si el conector está vinculado y en línea, sus dispositivos y cuántos fichajes esperan para enviarse. Funciona en inglés y árabe, en modo claro y oscuro. También ofrece:

  • Buscar dispositivos: una búsqueda de solo lectura en la red local de terminales compatibles. Los resultados aparecen en SolaHR en Encontrados por su conector.
  • Configurar el software necesario: configuración guiada de un SDK de fabricante. Consulte Configurar el SDK del fabricante.
  • Permitir cambios en los dispositivos: desactivado por defecto. Mientras esté desactivado, SolaHR puede leer pero no editar, activar, desactivar, eliminar ni enviar usuarios, y muestra «Los cambios en este dispositivo están desactivados en el PC del conector.»
  • Desvincular.

#Actualizar

Ejecute el instalador más reciente. Sustituye los archivos del programa y reinicia el servicio. La vinculación, los ajustes y los fichajes en espera se conservan, así que no hay que volver a vincular. Pasar del ZIP portátil al instalador funciona igual: se elimina la tarea programada antigua para que nunca haya dos conectores a la vez.

#Mover, revocar y desinstalar

  • Pasar a otro PC. Instale y vincule el conector nuevo y cambie en SolaHR el Conector del dispositivo. Revoque el antiguo en la pestaña Conectores.
  • Revocar. En SolaHR, pulse Revocar en el conector. Sus dispositivos dejan de sincronizar. Los fichajes que esperan en ese PC se quedan allí y no se envían a menos que vuelva a vincularlo.
  • Desinstalar. En Windows, Configuración → Aplicaciones. Se le pregunta «Also delete the connector data?». Por defecto es No: los datos, incluidos los fichajes aún no enviados, se conservan para que una reinstalación continúe. Sí elimina los fichajes sin enviar.

#La seguridad en breve

  • La página del conector escucha solo en 127.0.0.1 y rechaza otras direcciones.
  • El token de vinculación y las claves de comunicación se guardan cifrados. Quien tenga derechos de administrador en ese PC aún puede acceder a ellos: trate el PC como un servidor.
  • En los registros se eliminan los tokens y las claves. solahr-dc diagnostics genera un paquete de soporte sin secretos.
  • Las huellas y los rostros nunca se envían a SolaHR.

#Solución de problemas de instalación

Síntoma Qué comprobar
Windows bloquea el archivo o avisa de él Es esperable con la versión preliminar sin firmar. Compruebe el SHA-256 y luego Más información → Ejecutar de todas formas. Si la política de su empresa bloquea programas sin firmar, pida a TI que lo permita o espere a la versión firmada.
El instalador dice que necesita derechos de administrador Clic derecho, Ejecutar como administrador.
«El código ha caducado» al vincular El código dura 15 minutos y sirve una vez. Genere uno nuevo.
Falla la vinculación ¿Está escrita exactamente la dirección de SolaHR (con https://)? ¿Puede el PC abrirla en un navegador? ¿La bloquea un proxy?
El conector sigue Sin conexión en SolaHR ¿PC encendido y en línea? ¿Servicio en ejecución (sc query SolaHRDeviceConnect)? La página del conector indica si necesita vincularse de nuevo.
127.0.0.1:8790 no se abre Es posible que otro programa use el puerto 8790. El servicio sigue sincronizando sin la página.
«El conector necesita volver a vincularse» / «Se revocó el conector» Genere un nuevo código de vinculación y vincule otra vez. Los fichajes en espera se conservan.
El servicio se detiene nada más iniciarse Ejecute solahr-dc run en un símbolo del sistema de administrador para ver el error en pantalla y envíe la salida de solahr-dc diagnostics a soporte.

Más en Solución de problemas y preguntas frecuentes.