Solavel Documents
Français

Installer le connecteur Device Connect

Dernière mise à jour

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

  1. 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.cmd et répondez Oui.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.1 et 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 diagnostics produit 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.