La base de connaissance ARD
FAQ - ARD Access - Erreur WebSocket Gateway (Enrôleur/Imprimante de badges)
Contexte
Cette page décrit comment remédier au message d’erreur apparaissant sur ARD Access dans le cadre de l’utilisation de lecteur de table et/ou d’imprimantes à badges.
Consécutivement à une mise à jour Windows de votre poste de gestion, l’erreur peut survenir.
Présentation du problème
Cette procédure est valable pour les versions d’ARD Access ≥ 2.9.3.
Contactez le support si vous avez une version antérieure.
Le problème :
Le lecteur de table ou l’imprimante à badge ne fonctionne pas (ou plus), ARD Access affiche l’erreur suivante :
La solution :
Il faut installer la passerelle (gateway). Cette dernière fait le lien entre le logiciel (dans le navigateur) et le matériel physique.
Quelle en est la cause ?
Si les lecteurs/imprimantes fonctionnaient lors de la dernière utilisation, il est possible qu’une mise à jour Windows ait bloqué le bon fonctionnement de la passerelle. Il faut alors la réinstaller.
Identifier si la connexion est sécurisée
Les dernières versions d’ARD Access sont normalement sécurisées (HTTPS).
Contactez le support si toutefois votre connexion n’est pas sécurisée.
Méthode rapide
Vous pouvez regarder directement si l’adresse web dans votre navigateur commence par http ou https
Si le https est barré en rouge, votre connexion est bien sécurisée mais les certificats ne sont pas installés. Continuez cette procédure à l'étape 2 - Télécharger le fichier d’installation de la passerelle ArdSetup.exe
En cas de doute
Faites un clic-droit dans le bureau d’ARD Access et cliquer sur “Extensions ARD Access”
Allez dans le volet “afe_gateway” et noter le port websocket :
8080 = connexion NON sécurisée (HTTP, contactez le support)
8181 = connexion sécurisée (HTTPS, passez à l'étape 2)
Les ports 8080 et 8181 sont des ports par défaut, il est possible que votre DSI ait paramétré un autre n° de port. Si tel est le cas ce n° doit apparaître ici.
Télécharger le fichier d’installation de la passerelle ArdSetup.exe
Dans ARD Access, allez dans Démarrer > Outils avancés > Téléchargement Drivers Poste Client
Le téléchargement se lance dans le navigateur.
Installation de la passerelle
Exécuter ArdSetup.exe
Cocher les options “Lecteur PCSC”, “Passerelle vers le matériel” et “Autorités de certification”
Suivez la 1e étape qui consiste à installer les pilotes du lecteur
Cliquer sur suivant pour passer à l’installation de la passerelle (Ard Gateway) et des certificats (Ard TLS)
Choisir Connexion sécurisée, laissé le host (127.0.0.1) et le port (8181) par défaut dans la configuration de la passerelle (sauf contre-indication de votre DSI)
Renseigner l’adresse IP ou le nom de domaine de votre ARD Access (copier-coller depuis votre navigateur) dans la configuration de la connexion au serveur ARD Access, en laissant les ports HTTPS et websocket par défaut (sauf contre-indication de votre DSI
Répéter cette étape pour le TLS
Si le pop-up n’apparaît pas immédiatement, essayez de relancer votre navigateur web
Passer un badge sur votre enrôleur pour vérifier son bon fonctionnement :
Incompatibilité Windows 11
Pour les version d’ARD Access < v2.17.4 il se peut que la passerelle ARD Websocket Gateway ne fonctionne pas sur un nouveau poste en Windows 11.
La fonctionnalité WMIC n’est pas activée par défaut sur ces postes, il faut l’installer depuis les fonctionnalités facultatives Windows.
L’incompatibilité n’est pas présente dans le cas d’une mise à jour d’un poste en Widnows 10 vers Windows 11 (la fonctionnalité est activée dans ce cas).
Ouvrir les fonctionnalités facultatives (faites une recherche depuis la barre des tâches Windows)
Cliquer sur le bouton Afficher les fonctionnalités
Rechercher “WMIC”
Cocher la fonctionnalité et l’installer.
Relancer l’installation de la passerelle si celle-ci est toujours en défaut.