Solavel Documenti
Italiano

Installare il connettore Device Connect

Ultimo aggiornamento

Il connettore è il piccolo programma Windows che legge i tuoi terminali di presenza e invia le timbrature a SolaHR. Questa pagina spiega come scaricarlo, installarlo, abbinarlo, aggiornarlo e rimuoverlo, e che cosa controllare se qualcosa non funziona. Se vuoi prima l'idea generale, leggi la panoramica.

Anteprima. Il connettore è stato realizzato e verificato con simulatori e un modello di terminale reale. Non è ancora firmato, quindi Windows ti avviserà quando lo esegui. Provalo prima su un PC e un dispositivo.

#Prima di iniziare

Necessario Dettaglio
Un PC o server Windows Windows 10 o 11, oppure Windows Server 2016 e successivi, a 64 bit. Windows 7/8, Windows a 32 bit e ARM non sono supportati.
Sempre acceso Il PC deve restare acceso e attivo, nella stessa rete (e VLAN) dei terminali. Va bene un piccolo PC da ufficio o un server.
Diritti di amministratore Per installare e, in seguito, per registrare un SDK del produttore.
Internet HTTPS in uscita verso l'indirizzo del tuo SolaHR (per esempio https://solavel.com/hr). Non serve nessuna porta in ingresso.
Un utente SolaHR autorizzato a gestire i dispositivi Il proprietario o un responsabile HR.
L'indirizzo IP del terminale E la sua chiave di comunicazione, se ne ha una. Vedi Aggiungere un dispositivo.

Non serve hardware speciale; basta un normale PC da ufficio (non abbiamo ancora pubblicato minimi misurati).

#Scegliere un pacchetto

In SolaHR apri Tempo e presenze → Dispositivi di presenza → Connettori → Aggiungi connettore. Sono offerti due download per Windows 10 / 11 · 64 bit, ciascuno con versione e dimensione.

Pacchetto Cos'è Usalo quando
Programma di installazione Windows .exe (consigliato) Installa il connettore come servizio Windows: si avvia da solo all'accensione, riparte dopo un guasto e conserva i dati negli aggiornamenti. Uso normale.
ZIP portatile Nessun programma di installazione. Estrailo ed esegui install.cmd, che registra una attività pianificata che avvia il connettore all'avvio. Non è un servizio Windows. Una prova rapida, o un PC dove non si può eseguire un programma di installazione.

Entrambi sono contrassegnati Anteprima. Se la pagina dice «Il programma di installazione Windows sarà presto disponibile qui.», non è stato ancora pubblicato nessun pacchetto.

Controlla il download. Sotto Dettagli trovi le note di versione e un comando PowerShell. Eseguilo e confronta: il risultato di Get-FileHash deve coincidere con il valore SHA-256 mostrato nella pagina.

#Installare e abbinare, passo dopo passo

  1. Esegui il programma di installazione come amministratore (clic destro, Esegui come amministratore). Per lo ZIP: clic destro sullo ZIP, Estrai tutto, doppio clic su install.cmd e rispondi Sì.
  2. SmartScreen. Poiché l'anteprima non è firmata, Windows può mostrare «Windows ha protetto il PC». Dopo aver controllato lo SHA-256, fai clic su Ulteriori informazioni e poi su Esegui comunque. L'avviso scomparirà quando il programma sarà firmato; fino ad allora è previsto e non indica un problema.
  3. Si apre la pagina del connettore nel browser all'indirizzo http://127.0.0.1:8790. Questa pagina è disponibile solo su quel PC. Il menu Start contiene anche SolaHR Device Connect.
  4. Ottieni un codice di abbinamento. In SolaHR fai clic su Aggiungi connettore e copia il Codice di abbinamento. Funziona una volta e scade dopo 15 minuti; creane uno nuovo se scade.
  5. Abbina. Nella pagina del connettore inserisci l'indirizzo del tuo SolaHR (per esempio https://solavel.com/hr) e il codice, poi premi Pair.
  6. In SolaHR il connettore compare come Online entro un minuto. Ora aggiungi un dispositivo e assegnalo a questo connettore.

Per i team IT, il programma di installazione funziona anche in modalità silenziosa, facoltativamente con indirizzo e codice:

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

#Che cosa installa il programma sul PC

Articolo Dove
Programma C:\Program Files\SolaHR Device Connect
Servizio Windows SolaHRDeviceConnect (avvio automatico, riparte da solo dopo un guasto)
Dati: impostazioni, segreti cifrati, timbrature non ancora inviate, registri C:\ProgramData\SolaHR Device Connect (leggibile solo dagli amministratori Windows e dal sistema)
Pagina locale http://127.0.0.1:8790 (solo questo PC)
Strumento da riga di comando solahr-dc (pair, status, diagnostics, run, version)

Controlla che funzioni: in un prompt dei comandi di Windows, sc query SolaHRDeviceConnect deve indicare RUNNING.

#Firewall e rete

Direzione Cosa Note
PC del connettore verso SolaHR HTTPS (443) Solo in uscita. Se il tuo ufficio usa un proxy o filtra i siti web, consenti l'indirizzo del tuo SolaHR.
PC del connettore verso un terminale ZKTeco TCP e UDP 4370 La porta propria del terminale.
PC del connettore verso un terminale Anviz TCP 5010 Porta Anviz predefinita; controllala sul dispositivo.
PC del connettore verso un terminale Hikvision HTTP/HTTPS (la porta web del dispositivo, 80 per impostazione predefinita)
PC del connettore verso un server Suprema BioStar 2 HTTPS (443 per impostazione predefinita) Legge tramite il server BioStar 2, non dal terminale.
Altri dispositivi verso il PC del connettore Nessuno Nulla si connette al connettore.

Il firewall di Windows di norma consente le connessioni in uscita. Se la tua rete separa il PC e i terminali (VLAN diverse), consenti queste porte tra loro.

#La pagina del connettore

Apri http://127.0.0.1:8790 (o la voce del menu Start). Mostra se il connettore è abbinato e online, i suoi dispositivi e quante timbrature attendono l'invio. Funziona in inglese e arabo, in chiaro e scuro. Offre anche:

  • Trova dispositivi: una ricerca in sola lettura nella rete locale dei terminali supportati. I risultati compaiono in SolaHR sotto Trovati dal tuo connettore.
  • Configura il software richiesto: configurazione guidata di un SDK del produttore. Vedi Configurare l'SDK del produttore.
  • Consenti modifiche ai dispositivi: disattivato per impostazione predefinita. Finché è disattivato, SolaHR può leggere ma non modificare, attivare, disattivare, eliminare o inviare utenti, e mostra «Le modifiche a questo dispositivo sono disattivate sul PC del connettore.»
  • Annulla abbinamento.

#Aggiornamento

Esegui il programma di installazione più recente. Sostituisce i file del programma e riavvia il servizio. Abbinamento, impostazioni e timbrature in attesa vengono conservati, quindi non devi abbinare di nuovo. Il passaggio dallo ZIP portatile al programma di installazione funziona allo stesso modo: la vecchia attività pianificata viene rimossa perché due connettori non girino mai insieme.

#Spostare, revocare e disinstallare

  • Passare a un altro PC. Installa e abbina il nuovo connettore, poi in SolaHR cambia il Connettore del dispositivo. Revoca il vecchio nella scheda Connettori.
  • Revocare. In SolaHR, Revoca sul connettore. I suoi dispositivi smettono di sincronizzarsi. Le timbrature in attesa su quel PC vi restano e non vengono inviate se non abbini di nuovo.
  • Disinstallare. Windows Impostazioni → App. Viene chiesto «Also delete the connector data?». Il valore predefinito è No: i dati, comprese le timbrature non ancora inviate, vengono conservati così una reinstallazione prosegue. Sì elimina le timbrature non inviate.

#La sicurezza in breve

  • La pagina del connettore è in ascolto solo su 127.0.0.1 e rifiuta altri indirizzi.
  • Il token di abbinamento e le chiavi di comunicazione sono memorizzati cifrati. Chi ha diritti di amministratore su quel PC può comunque raggiungerli: tratta il PC come un server.
  • I registri sono privati di token e chiavi. solahr-dc diagnostics crea un pacchetto di assistenza senza segreti.
  • Impronte e volti non vengono mai inviati a SolaHR.

#Risoluzione dei problemi di installazione

Sintomo Cosa controllare
Windows blocca il file o avvisa Previsto per l'anteprima non firmata. Controlla lo SHA-256, poi Ulteriori informazioni → Esegui comunque. Se la policy aziendale blocca i programmi non firmati, chiedi all'IT di consentirlo o attendi la versione firmata.
Il programma di installazione dice che servono i diritti di amministratore Clic destro, Esegui come amministratore.
«Codice scaduto» durante l'abbinamento Il codice dura 15 minuti e vale una sola volta. Creane uno nuovo.
L'abbinamento non riesce L'indirizzo di SolaHR è digitato esattamente (con https://)? Il PC riesce ad aprirlo in un browser? Un proxy lo blocca?
Il connettore resta Offline in SolaHR PC acceso e online? Servizio in esecuzione (sc query SolaHRDeviceConnect)? La pagina del connettore indica se deve essere abbinato di nuovo.
127.0.0.1:8790 non si apre Un altro programma potrebbe usare la porta 8790. Il servizio continua a sincronizzare anche senza la pagina.
«Il connettore deve essere abbinato di nuovo» / «Il connettore è stato revocato» Crea un nuovo codice di abbinamento e abbina di nuovo. Le timbrature in attesa vengono conservate.
Il servizio si ferma subito dopo l'avvio Esegui solahr-dc run in un prompt dei comandi da amministratore per vedere l'errore a schermo e invia l'output di solahr-dc diagnostics all'assistenza.

Altro in Risoluzione dei problemi e FAQ.