Questa pagina ti accompagna da «ho un terminale al muro» a «SolaHR lo legge»: trovare il dispositivo, sceglierlo nel catalogo dei modelli, raccogliere indirizzo IP, porta e chiave di comunicazione dal menu del dispositivo, provare la connessione e capire lo stato che ottieni. Il riferimento clic per clic delle schermate è in Dispositivi di presenza; questa pagina aggiunge le conoscenze utili attorno.
Prima di iniziare, il connettore deve essere installato e mostrare Online, a meno che tu non intenda usare l'invio o l'importazione di file.
#La versione breve
- Tempo e presenze → Dispositivi di presenza → Aggiungi dispositivo.
- Dagli un nome, scegli la sua sede di presenza e il fuso orario dell'orologio del dispositivo (per esempio
Asia/Amman). - Scegli il tipo di collegamento, il connettore e inserisci l'indirizzo IP del dispositivo, la porta e la chiave di comunicazione (vuota significa 0).
- Prova collegamento. Una buona risposta mostra modello, firmware, utenti e registrazioni sul dispositivo e il suo orologio.
- Associa gli utenti, poi Salva e avvia sincronizzazione.
Puoi uscire a metà: un dispositivo non terminato mostra Configurazione incompleta con Riprendi configurazione.
#Rilevamento: lasciare che il connettore trovi il dispositivo
Sul PC del connettore apri la pagina del connettore (http://127.0.0.1:8790) e premi Trova dispositivi. Esegue una ricerca in sola lettura nella rete locale e non modifica nulla. In SolaHR i risultati compaiono sotto Trovati dal tuo connettore con indirizzo e porta; un clic compila l'indirizzo. I dispositivi che chiedono una chiave di comunicazione sono contrassegnati «chiede l'accesso (Comm Key, spesso 0)».
Il rilevamento vede solo i dispositivi dello stesso segmento di rete del PC e solo i protocolli che il connettore conosce. Se il terminale non viene trovato, potrebbe essere su un'altra VLAN o di un tipo non letto direttamente. Digita tu l'indirizzo.
#Il catalogo dei modelli
Sotto Il tuo dispositivo puoi cercare nel catalogo per marca o modello. In questa versione contiene 147 modelli di ZKTeco, Hikvision, Suprema, Anviz ed EBKN. La scelta di uno mostra:
| Mostrato | Significato |
|---|---|
| Provato su un dispositivo reale | Collegato davvero, con il firmware indicato. Oggi solo lo ZKTeco iFace702. |
| Dovrebbe funzionare · stessa famiglia di protocollo | Documentato come dello stesso protocollo di un modello che funziona; non provato da noi. |
| Sconosciuto: non provato | Nel catalogo, ma senza prove in un senso o nell'altro. |
| Impostazioni consigliate | Un pulsante, Applica impostazioni consigliate, compila porta, trasporto e codifica. |
| Dove trovare le impostazioni su questo dispositivo | Il percorso nel menu (riassunto sotto). |
| Problemi noti e Passi successivi | Per esempio, il firmware ZKTeco Ver 6.60 chiede l'accesso anche con chiave 0; il connettore 0.1.5 e successivi lo gestiscono. |
Il modello è facoltativo. Se il miglior tipo di collegamento per il modello differisce da quello scelto, SolaHR propone Passa a .... L'elenco completo, con manuale ufficiale e link di assistenza, è in Dispositivi supportati. Un dispositivo non presente nel catalogo può comunque funzionare se usa uno degli stessi protocolli; prova Prova collegamento.
#Trovare indirizzo IP, porta e chiave di comunicazione sul dispositivo
Ogni produttore formula i menu in modo un po' diverso, e i menu cambiano con modello e firmware. Usa questi percorsi come guida e conferma nel manuale del tuo dispositivo (link in Dispositivi supportati).
#ZKTeco (diretto, porta 4370)
Sulla maggior parte dei terminali ZKTeco, premi Menu e poi:
| Ti serve | Dove sul dispositivo |
|---|---|
| Indirizzo IP, subnet mask, gateway, DHCP | Menu → Comm. → Ethernet |
| Porta | TCP COMM. Port nella stessa schermata. Il valore di fabbrica è 4370; lascialo salvo modifiche. |
| Chiave di comunicazione | Menu → Comm. → PC Connection → Comm Key. Un numero da 1 a 6 cifre; 0 significa nessuna chiave (valore di fabbrica). |
| ID dispositivo / numero macchina | Stessa schermata PC Connection. Lascia il Numero macchina di SolaHR a 1 a meno che il dispositivo ne usi un altro. |
| Server ADMS (per l'invio, al posto del connettore) | Menu → Comm. → Cloud Server Setting: l'indirizzo del server (o un nome di dominio, se l'opzione dominio è attiva) e la porta del server. |
Un terminale ZKTeco appena uscito di fabbrica è documentato come avviato all'IP 192.168.1.201 con maschera 255.255.255.0, quindi PC e terminale devono essere sullo stesso segmento, oppure cambi prima l'indirizzo del dispositivo. I nomi dei menu sopra provengono dai manuali attuali di ZKTeco (per esempio il manuale utente del SpeedFace-V3L); i terminali più vecchi, come la serie iClock, hanno menu simili. Trasporto: lascia Auto (prima TCP, UDP solo se TCP fallisce). I nomi arabi sembrano illeggibili: mantieni UTF-8, poi prova Windows-1256 (cp1256), poi GBK.
#Hikvision (ISAPI, porta web 80)
I terminali Hikvision si configurano soprattutto dalla loro pagina web integrata.
| Ti serve | Dove |
|---|---|
| Trovare il dispositivo in rete | Lo strumento SADP di Hikvision (in HiTools) elenca i dispositivi Hikvision della rete locale, attiva quelli nuovi e può cambiarne l'IP. Hikvision dichiara che SADP non riceverà più aggiornamenti da aprile 2026 e rimanda al nuovo HiTools Delivery. |
| Indirizzo IP | Pagina web del dispositivo → Configuration → Network → Basic Settings → TCP/IP |
| Un accesso per SolaHR | Pagina web → Configuration → System → User Management. Crea un utente separato per SolaHR; non usare admin. |
| Porta | 80 (HTTP), salvo modifica nelle impostazioni di rete del dispositivo |
Un nuovo dispositivo Hikvision deve essere attivato (imposti la sua password di amministratore) prima di poterlo usare. Hikvision documenta gli indirizzi di fabbrica nei suoi manuali; conferma il tuo lì invece di tirare a indovinare.
#Suprema (tramite un server BioStar 2)
SolaHR non dialoga direttamente con i terminali Suprema. Legge gli eventi dal tuo server BioStar 2.
| Ti serve | Dove |
|---|---|
| Indirizzo del server | L'indirizzo della pagina web di BioStar 2, di solito https://<server>:443 |
| Un accesso | In BioStar 2 crea un operatore in sola lettura; non usare l'amministratore principale |
| Tipi di evento | BioStar 2 etichetta ogni evento con un codice; se importi troppo, imposta i codici evento consentiti nelle impostazioni del dispositivo in SolaHR |
Gli indirizzi IP dei terminali e le impostazioni del server si impostano in BioStar 2 stesso; vedi la BioStar 2 Administrator Guide.
#Anviz (diretto, TCP 5010, o CrossChex Cloud)
| Ti serve | Dove |
|---|---|
| Indirizzo IP e porta | Menu del dispositivo → Communication / Network (su alcuni modelli: la pagina web del dispositivo). La porta predefinita è 5010. |
| Modalità TCP | Impostala su Server, così il PC del connettore può collegarsi al dispositivo. (La modalità Client fa collegare il dispositivo verso un PC, per dispositivi su un'altra rete.) |
| ID dispositivo | Nello stesso menu di comunicazione, se ne usi uno |
| Porta e ID devono coincidere | La porta in SolaHR deve essere uguale a quella impostata sul dispositivo |
Per CrossChex Cloud serve un account cloud Anviz con accesso sviluppatore (chiave API e segreto); non c'è nulla da impostare sul PC del connettore. SolaHR chiede anche come leggere il checktime del cloud (UTC o locale), perché Anviz non lo dichiara chiaramente: scegli in base a ciò che vedi in CrossChex Cloud.
#EBKN / Secureeye (solo invio)
Non c'è collegamento diretto. Nelle impostazioni server/cloud del dispositivo inserisci l'indirizzo di invio mostrato nella pagina del dispositivo in SolaHR.
#Qualsiasi altro terminale
Usa l'importazione file (esportazione dal dispositivo) oppure, se il terminale o il suo software può inviare le timbrature a un indirizzo web, la via di invio generica (SolaHR mostra un indirizzo e un token monouso).
#Prova collegamento
Premi Prova collegamento. SolaHR chiede al connettore di contattare il dispositivo; di solito servono pochi secondi. Una buona risposta mostra Modello, Firmware, Utenti sul dispositivo, Registrazioni sul dispositivo e l'Orologio del dispositivo. Se l'orologio sfasa di oltre due minuti ricevi un avviso, perché gli orari delle timbrature seguono l'orologio del dispositivo. Puoi Salta per ora.
#Che cosa significa lo stato
| Visualizzi | Cosa significa | Cosa fare |
|---|---|---|
| Raggiungibile (verde), con modello e conteggi | Il dispositivo ha risposto e la chiave è stata accettata. | Continua con l'associazione. |
| Raggiungibile · Comm Key rifiutata | Il dispositivo c'è, ma la chiave è sbagliata. | Inserisci la chiave di comunicazione da Menu → Comm. → PC Connection. Un dispositivo senza chiave ha la chiave 0. |
| Raggiungibile · dispositivo occupato | Il dispositivo è occupato (spesso qualcuno si sta registrando o il dispositivo si sta sincronizzando). | Attendi un minuto e ripeti il test. |
| Dispositivo non raggiungibile / "non ha risposto in tempo" | Nessuna risposta a quell'indirizzo e porta. | Alimentazione, cavo, indirizzo, porta, stessa rete, firewall. Vedi Risoluzione dei problemi. |
| "Il connettore non ha preso in carico la richiesta" | Il PC del connettore è spento, in sospensione o offline. | Accendilo. Le timbrature in attesa vengono inviate dopo. |
| Configurazione necessaria | Questo tipo di collegamento richiede il software del produttore sul PC e non è pronto. È uno stato, non un guasto del terminale. | Segui Configurare l'SDK del produttore oppure passa al collegamento diretto integrato. |
| "Numero di serie non corrispondente" | Il dispositivo a quell'indirizzo non è quello registrato. | Controlla l'indirizzo IP; due dispositivi potrebbero aver scambiato gli indirizzi. |
| "Il connettore è stato revocato" / "richiede un nuovo abbinamento" | Il connettore ha perso l'abbinamento. | Abbina di nuovo nella scheda Connettori. |
| Configurazione incompleta | Hai lasciato i passaggi guidati prima della fine. | Riprendi configurazione. |
| Offline / «Il connettore ... è offline» (sulla scheda) | Il PC del connettore è spento o senza rete. | Accendilo; le timbrature in attesa vengono inviate più tardi. |
| «Il dispositivo invia a SolaHR - ultimo contatto ...» (dispositivi a invio) | Quando SolaHR ha avuto notizie dal dispositivo per l'ultima volta. | Se è passato molto tempo, controlla l'impostazione server e la rete del dispositivo. |
#Dispositivi in modalità push (ADMS e simili)
Al posto di un connettore, un terminale può inviare le timbrature a SolaHR. Prima registri il dispositivo in SolaHR (SolaHR ha bisogno del suo numero di serie), poi inserisci l'indirizzo di SolaHR nell'impostazione cloud/ADMS del terminale (Menu → Comm. → Cloud Server Setting su ZKTeco). Il push è semplice ma si fida del numero di serie del dispositivo, quindi tieni la rete consentita la più ristretta possibile e controlla le timbrature. Molti terminali ADMS usano solo HTTP semplice; il tuo amministratore potrebbe doverlo consentire sul server web, cosa che il pannello Idoneità dell'installazione nella pagina dei dispositivi verifica.