La plupart des terminaux sont lus directement via le réseau et ne demandent rien de plus. Quelques types de connexion utilisent le logiciel Windows propre au fabricant (un « SDK ») sur le PC du connecteur. Aujourd'hui, il s'agit uniquement du SDK ZKTeco. Cette page explique quand vous en avez besoin, comment l'installer pas à pas, ce que signifient les vérifications et quelles sont les règles de licence.
Aperçu et mise au point honnête. Le parcours SDK a été conçu et vérifié uniquement avec des simulations logicielles. Il n'a pas été exécuté avec une véritable installation du SDK sur un PC Windows, ni sur de vrais terminaux de chaque modèle. Des détails peuvent différer sur un vrai PC : l'organisation du registre, le comportement de
regsvr32, les réponses exactes du SDK à certains appels. Essayez d'abord sur un seul terminal. Si cela ne fonctionne pas, la connexion directe intégrée reste toujours disponible.
#En avez-vous besoin ?
Probablement pas. Pour la plupart des terminaux ZKTeco, choisissez ZKTeco (direct) : il lit les pointages et les utilisateurs, règle l'horloge, redémarre le terminal et modifie les utilisateurs, et a été vérifié sur un véritable iFace702. N'utilisez le type SDK que si vous avez besoin de ce que le mode direct ne peut pas faire :
| Caractéristique | ZKTeco direct | SDK ZKTeco |
|---|---|---|
| Lire les pointages, les utilisateurs et l'horloge du terminal | Oui | Oui |
| Modifier, ajouter, supprimer des utilisateurs ; régler l'horloge ; redémarrer | Oui | Oui |
| Activer / désactiver un utilisateur sur le terminal | Non (« non pris en charge ici ») | Oui |
| Copier visages et empreintes entre deux terminaux | Non | Oui |
| Photos des utilisateurs, photos prises lors des pointages | Non | Oui |
| Événements de pointage en direct | Non (interrogation périodique) | Oui, testé uniquement par logiciel (idéalement avec le SDK 64 bits) |
| Nécessite un logiciel sur le PC | Non | Oui : le SDK ZKTeco, enregistré |
| Vérifié sur un vrai terminal | Oui (iFace702, fonctions en lecture seule) | Non (simulé uniquement) |
Les modifications apportées aux terminaux doivent aussi être autorisées sur la page du connecteur (voir Installer) et nécessitent le propriétaire pour les plus avancées.
#Pas à pas : le SDK 64 bits (recommandé)
Le PC du connecteur doit tourner sous Windows (64 bits) et vous devez disposer des droits administrateur.
- Téléchargez vous-même le SDK autonome ZKTeco (Standalone SDK), depuis ZKTeco. SolaHR ne l'inclut ni ne le redistribue jamais. Vous acceptez les conditions de licence de ZKTeco lors du téléchargement. Utilisez la version 6.3.1.37 ou ultérieure : elle contient un dossier nommé
64bitavec un véritablezkemkeeper.dll64 bits correspondant au connecteur 64 bits. Voir la note ci-dessous sur l'endroit où l'obtenir. - Décompressez le paquet quelque part sur le PC (par exemple dans votre dossier Téléchargements).
- Ouvrez le dossier
64bit, faites un clic droit sur Register_SDK_x64.bat et choisissez Exécuter en tant qu'administrateur. Il copie les fichiers du SDK dans le dossier système de Windows et enregistrezkemkeeper.dllpour vous. - Dans SolaHR (page du terminal, Configurer le logiciel requis) ou sur la page du connecteur, cliquez sur Vérifier l'installation.
- Lisez les vérifications. Lorsque toutes sont Prêtes, la fiche du terminal n'affiche plus Configuration requise et Tester la connexion fonctionne.
Où trouver le SDK. ZKTeco publie du matériel SDK dans son Centre de téléchargement (catégorie SDK) et tient un dépôt Standalone-SDK sur son compte GitHub. Au moment de la rédaction, nous avons pu vérifier que le dépôt contient un ancien paquet 32 bits (Communication Protocol SDK 6.2.4.11) et que la liste SDK du Centre de téléchargement présente d'autres SDK (modules d'empreintes et de lumière visible) ; nous n'avons pas pu confirmer de lien public vers la version 6.3.1.37. Certains téléchargements ZKTeco exigent une connexion gratuite de membre. Si vous ne le trouvez pas, demandez à ZKTeco ou à votre distributeur ZKTeco le « Standalone SDK 6.3.1.37 ou ultérieur, 64 bits ». Le lien affiché dans SolaHR n'est pas non plus vérifié de façon indépendante.
#Ce que signifient les vérifications de disponibilité
| Vérifier | Signification | Si l'état est Manquant |
|---|---|---|
| Windows | Le PC fonctionne sous Windows. | Un type SDK ne peut pas fonctionner sur un autre système (« Ce type de connexion ne peut pas fonctionner sur ce PC »). |
| Composant COM Python | Le connecteur peut communiquer avec les composants Windows (pywin32). | Fait partie du connecteur. Réinstallez ou mettez à niveau le connecteur. |
| SDK enregistré | Windows connaît le SDK (zkemkeeper). |
Exécutez Register_SDK_x64.bat en tant qu'administrateur. |
| Fichier DLL | Le zkemkeeper.dll enregistré existe sur le disque. |
Enregistrez à nouveau ; ne déplacez et ne supprimez pas les fichiers ensuite. |
| Architecture (bits) | Le SDK est en 32 bits ou en 64 bits, et le connecteur est en 64 bits. | Un SDK uniquement 32 bits ne convient pas directement : utilisez le SDK 64 bits ou la solution de repli ci-dessous. |
La vérification de disponibilité s'exécute avant chaque test de connexion et chaque interrogation. Un SDK manquant est un statut, « Configuration requise » : SolaHR ne réessaie pas en boucle et ne déclare pas le terminal injoignable.
#Solution de repli : un ancien SDK uniquement 32 bits
Les anciens paquets n'ont qu'un composant 32 bits, que le connecteur 64 bits ne peut pas charger directement. La page du connecteur propose alors Choisir la DLL / Enregistrer (droits administrateur ; Windows vous demandera de confirmer). Cette action fait exactement ceci, et rien de plus :
- vérifie que le fichier choisi est un fichier local nommé exactement
zkemkeeper.dllet qu'il s'agit d'une véritable DLL Windows ; - enregistre ce seul fichier auprès de Windows (
regsvr32) ; - si le fichier est en 32 bits, fait en sorte que Windows l'héberge dans un processus auxiliaire 32 bits distinct.
Elle ne télécharge jamais rien, n'exécute jamais d'autres fichiers et ne modifie jamais un terminal. Par sécurité, lorsque le connecteur s'exécute en tant que service, il n'enregistre une DLL que sous Program Files ou Windows ; pour une DLL située ailleurs, un administrateur exécute solahr-dc sdk-setup --dll <path> depuis une invite de commandes élevée. solahr-dc readiness affiche le rapport actuel et solahr-dc sdk-setup --candidates liste les copies de la DLL qu'il peut trouver. Les événements en direct peuvent être peu fiables par cette voie ; utilisez le SDK 64 bits pour cela. Pour annuler : regsvr32 /u <path to dll>. La désinstallation de Device Connect laisse votre enregistrement du SDK intact.
#Si le SDK ne fonctionne pas : utiliser la connexion intégrée
Dans le panneau Configurer le logiciel requis, cliquez sur Utiliser plutôt la connexion intégrée. Après votre confirmation, SolaHR passe le type de connexion en mode direct, conserve l'adresse IP et le port, supprime les paramètres du SDK et teste à nouveau le terminal. Les pointages et les associations d'employés sont conservés. Rien n'est modifié sans votre confirmation.
#Restrictions de licence des constructeurs et autres constructeurs
| SDK constructeur | Statut dans Device Connect | Restrictions à connaître |
|---|---|---|
ZKTeco Standalone SDK (zkemkeeper) |
Implémenté, testé uniquement par logiciel | Sous licence ZKTeco. Non inclus, et nous ne pouvons pas le redistribuer : vous le téléchargez chez ZKTeco et acceptez ses conditions (le dépôt GitHub que nous avons consulté n'affiche aucun texte de licence ; lisez donc les conditions fournies avec votre téléchargement). Windows uniquement. L'enregistrement s'applique à toute la machine et exige les droits administrateur. |
| Suprema G-SDK | Prévu, non implémenté | Le dépôt G-SDK de Suprema indique que les téléchargements passent au Suprema Download Center (à partir du 2 mars 2026) et aucune licence n'y est mentionnée ; les téléchargements peuvent exiger une connexion partenaire. Aujourd'hui, les terminaux Suprema sont lus via un serveur BioStar 2. |
| Hikvision Device Network SDK | Non prévu | Inutile : les terminaux Hikvision sont lus via ISAPI (protocole web). Les pages SDK de Hikvision existent pour vos propres projets ; ses guides développeur ISAPI sur le portail TPP exigent un accord signé et des informations de partenaire. |
| Anviz CrossChex SDK | Non prévu | Inutile : Anviz est lu via son protocole réseau ou CrossChex Cloud. Anviz propose une page de téléchargement du SDK pour vos propres projets. |
Rien ici ne constitue un avis juridique : lisez toujours la licence fournie avec le téléchargement d'un constructeur.