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
- 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.cmde rispondi Sì. - 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.
- 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. - 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.
- Abbina. Nella pagina del connettore inserisci l'indirizzo del tuo SolaHR (per esempio
https://solavel.com/hr) e il codice, poi premi Pair. - 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.1e 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 diagnosticscrea 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.