Le connecteur est le petit programme Windows qui lit vos terminaux de pointage et envoie les pointages à SolaHR. Cette page explique comment le télécharger, l'installer, l'associer, le mettre à jour et le supprimer, et ce qu'il faut vérifier en cas de problème. Si vous voulez d'abord comprendre le principe, lisez la présentation.
Aperçu. Le connecteur a été construit et vérifié avec des simulateurs et un modèle de terminal réel. Il n'est pas encore signé : Windows vous avertira à son lancement. Essayez-le d'abord sur un PC et un appareil.
#Avant de commencer
| Besoin | Détail |
|---|---|
| Un PC ou serveur Windows | Windows 10 ou 11, ou Windows Server 2016 et ultérieur, 64 bits. Windows 7/8, Windows 32 bits et ARM ne sont pas pris en charge. |
| Toujours allumé | Le PC doit rester allumé et actif, sur le même réseau (et VLAN) que les terminaux. Un petit PC de bureau ou un serveur convient. |
| Droits d'administrateur | Pour installer, puis pour enregistrer un SDK de fabricant. |
| Internet | HTTPS sortant vers l'adresse de votre SolaHR (par exemple https://solavel.com/hr). Aucun port entrant n'est nécessaire. |
| Un utilisateur SolaHR autorisé à gérer les appareils | Le propriétaire ou un responsable RH. |
| L'adresse IP du terminal | Et sa clé de communication s'il en a une. Voir Ajouter un appareil. |
Aucun matériel spécial n'est nécessaire ; un PC de bureau ordinaire suffit (nous n'avons pas encore publié de minimums mesurés).
#Choisir un paquet
Dans SolaHR, ouvrez Temps et présence → Terminaux de pointage → Connecteurs → Ajouter un connecteur. Deux téléchargements sont proposés pour Windows 10 / 11 · 64 bits, avec leur version et leur taille.
| Forfait | Ce que c'est | Utilisez-le lorsque |
|---|---|---|
Installateur Windows .exe (recommandé) |
Installe le connecteur comme un service Windows : il démarre seul au démarrage, redémarre après une panne et conserve ses données lors d'une mise à jour. | Utilisation normale. |
| ZIP portable | Sans installateur. Extrayez-le et lancez install.cmd, qui enregistre une tâche planifiée démarrant le connecteur au démarrage. Ce n'est pas un service Windows. |
Un test rapide, ou un PC où l'on ne peut pas lancer d'installateur. |
Les deux sont marqués Aperçu. Si la page indique « L'installateur Windows sera bientôt disponible ici. », aucun paquet n'a encore été publié.
Vérifiez votre téléchargement. Sous Détails figurent les notes de version et une commande PowerShell. Exécutez-la et comparez : le résultat de Get-FileHash doit être égal à la valeur SHA-256 affichée sur la page.
#Installer et associer, pas à pas
- Lancez l'installateur en tant qu'administrateur (clic droit, Exécuter en tant qu'administrateur). Pour le ZIP : clic droit sur le ZIP, Extraire tout, double-clic sur
install.cmdet répondez Oui. - SmartScreen. L'aperçu n'étant pas signé, Windows peut afficher « Windows a protégé votre ordinateur ». Après avoir vérifié le SHA-256, cliquez sur Informations complémentaires, puis sur Exécuter quand même. Cet avertissement disparaîtra quand le programme sera signé ; d'ici là il est normal et n'indique pas un problème.
- La page du connecteur s'ouvre dans votre navigateur à l'adresse
http://127.0.0.1:8790. Cette page n'est disponible que sur ce PC. Le menu Démarrer contient aussi SolaHR Device Connect. - Obtenez un code d'association. Dans SolaHR, cliquez sur Ajouter un connecteur et copiez le Code d'association. Il fonctionne une seule fois et expire après 15 minutes ; créez-en un nouveau s'il expire.
- Associez. Sur la page du connecteur, saisissez l'adresse de votre SolaHR (par exemple
https://solavel.com/hr) et le code, puis appuyez sur Pair. - Dans SolaHR, le connecteur apparaît En ligne en moins d'une minute. Ajoutez maintenant un appareil et affectez-le à ce connecteur.
Pour les équipes informatiques, l'installateur s'exécute aussi en silencieux, éventuellement avec l'adresse et le code :
SolaHR-Device-Connect-Setup-<version>.exe /S /SERVER=https://solavel.com/hr /CODE=<pairing code>
#Ce que l'installateur place sur le PC
| Article | Où |
|---|---|
| Programme | C:\Program Files\SolaHR Device Connect |
| Service Windows | SolaHRDeviceConnect (démarrage automatique, redémarre seul après une panne) |
| Données : réglages, secrets chiffrés, pointages pas encore envoyés, journaux | C:\ProgramData\SolaHR Device Connect (lisible uniquement par les administrateurs Windows et le système) |
| Page locale | http://127.0.0.1:8790 (ce PC uniquement) |
| Outil en ligne de commande | solahr-dc (pair, status, diagnostics, run, version) |
Vérifiez qu'il fonctionne : dans une invite de commandes Windows, sc query SolaHRDeviceConnect doit indiquer RUNNING.
#Pare-feu et réseau
| Direction | Quoi | Remarques |
|---|---|---|
| PC du connecteur vers SolaHR | HTTPS (443) | Sortant uniquement. Si votre bureau utilise un proxy ou filtre les sites web, autorisez l'adresse de votre SolaHR. |
| PC du connecteur vers un terminal ZKTeco | TCP et UDP 4370 | Le port propre du terminal. |
| PC du connecteur vers un terminal Anviz | TCP 5010 | Port Anviz par défaut ; vérifiez-le sur l'appareil. |
| PC du connecteur vers un terminal Hikvision | HTTP/HTTPS (le port web de l'appareil, 80 par défaut) | |
| PC du connecteur vers un serveur Suprema BioStar 2 | HTTPS (443 par défaut) | Lit via le serveur BioStar 2, pas le terminal. |
| Autres appareils vers le PC du connecteur | Aucun | Rien ne se connecte au connecteur. |
Le pare-feu Windows autorise normalement les connexions sortantes. Si votre réseau sépare le PC et les terminaux (VLAN différents), autorisez ces ports entre eux.
#La page du connecteur
Ouvrez http://127.0.0.1:8790 (ou l'entrée du menu Démarrer). Elle indique si le connecteur est associé et en ligne, ses appareils et combien de pointages attendent d'être envoyés. Elle fonctionne en anglais et en arabe, en clair et en sombre. Elle propose aussi :
- Rechercher des appareils : une recherche en lecture seule des terminaux pris en charge sur le réseau local. Les résultats apparaissent dans SolaHR sous Trouvés par votre connecteur.
- Configurer le logiciel requis : configuration guidée d'un SDK de fabricant. Voir Configurer le SDK du fabricant.
- Autoriser les modifications des appareils : désactivé par défaut. Tant que c'est désactivé, SolaHR peut lire mais ne peut pas modifier, activer, désactiver, supprimer ni envoyer d'utilisateurs, et affiche « Les modifications de cet appareil sont désactivées sur le PC du connecteur. »
- Dissocier.
#Mise à niveau
Lancez le nouvel installateur. Il remplace les fichiers du programme et redémarre le service. L'association, les réglages et les pointages en attente sont conservés : vous n'avez pas à ré-associer. Passer du ZIP portable à l'installateur fonctionne de la même manière : l'ancienne tâche planifiée est supprimée pour que deux connecteurs ne tournent jamais ensemble.
#Déplacer, révoquer et désinstaller
- Passer à un autre PC. Installez et associez le nouveau connecteur, puis changez dans SolaHR le Connecteur de l'appareil. Révoquez l'ancien dans l'onglet Connecteurs.
- Révoquer. Dans SolaHR, Révoquer sur le connecteur. Ses appareils cessent de se synchroniser. Les pointages en attente sur ce PC y restent et ne sont envoyés que si vous associez à nouveau.
- Désinstaller. Windows Paramètres → Applications. On vous demande « Also delete the connector data? ». Par défaut c'est Non : les données, y compris les pointages pas encore envoyés, sont conservées pour qu'une réinstallation reprenne. Oui supprime les pointages non envoyés.
#La sécurité en bref
- La page du connecteur n'écoute que sur
127.0.0.1et refuse les autres adresses. - Le jeton d'association et les clés de communication sont stockés chiffrés. Toute personne ayant les droits d'administrateur sur ce PC peut néanmoins y accéder : traitez le PC comme un serveur.
- Les journaux sont expurgés des jetons et clés.
solahr-dc diagnosticsproduit un paquet d'assistance sans secrets. - Les empreintes et les visages ne sont jamais envoyés à SolaHR.
#Dépannage de l'installation
| Symptôme | À vérifier |
|---|---|
| Windows bloque le fichier ou l'avertit | Normal pour l'aperçu non signé. Vérifiez le SHA-256, puis Informations complémentaires → Exécuter quand même. Si la politique de votre entreprise bloque les programmes non signés, demandez à l'informatique de l'autoriser ou attendez la version signée. |
| L'installateur indique qu'il faut des droits d'administrateur | Clic droit, Exécuter en tant qu'administrateur. |
| « Code expiré » lors de l'association | Le code dure 15 minutes et ne sert qu'une fois. Créez-en un nouveau. |
| L'association échoue | L'adresse de SolaHR est-elle saisie exactement (avec https://) ? Le PC peut-il l'ouvrir dans un navigateur ? Un proxy la bloque-t-il ? |
| Le connecteur reste Hors ligne dans SolaHR | PC allumé et en ligne ? Service en cours d'exécution (sc query SolaHRDeviceConnect) ? La page du connecteur indique s'il doit être associé de nouveau. |
127.0.0.1:8790 ne s'ouvre pas |
Un autre programme utilise peut-être le port 8790. Le service se synchronise quand même sans la page. |
| « Le connecteur doit être ré-associé » / « Le connecteur a été révoqué » | Créez un nouveau code d'association et associez à nouveau. Les pointages en attente sont conservés. |
| Le service s'arrête juste après son démarrage | Lancez solahr-dc run dans une invite de commandes administrateur pour voir l'erreur à l'écran, et envoyez la sortie de solahr-dc diagnostics au support. |
Plus de détails dans Dépannage et FAQ.