Sur la page d'une connexion, Statut de synchronisation (Sync Status) affiche une erreur, une ligne du Journal de synchronisation indique Échec ou Succès partiel, ou une exécution s'est terminée et les personnes, portes ou cartes attendues manquent quand même. Cette page couvre SALTO, dormakaba MATRIX, ASSA ABLOY eCLIQ et Interflex IF-6040 et s'adresse à l'Administrateur de l’organisation et au Gestionnaire d'accès, qui voient Intégrations. Elle commence sur la page de la connexion sous Connecté.
Également appelé : synchro, synchronisation, exécution, pull, push.
Ouvrez la connexion et son onglet Journal de synchronisation. Chaque ligne est une exécution. À côté du statut, une mention dit si portierX réessaie : "Attempt 2 of 4, trying again", "This run stopped after attempt 1" ou "Succeeded on attempt 2 of 4". L'entrée sous "Started" ouvre l'exécution avec "What happened", les étapes, et "Errors", les messages du système tels quels. Ce que signifie chaque indication figure sur la page de l'écran de connexion sous Voir aussi.
Une exécution qui échoue sur une panne passagère, par exemple parce que le système n'a pas répondu, est relivrée d'elle-même, autant de fois que "Attempts" de l'onglet Configuration le prévoit, avec des attentes croissantes. La ligne indique "Attempt 2 of 4, trying again" et, après le dernier essai, "This run stopped after attempt 4".
Une exécution s'arrête aussitôt quand un essai de plus ne changerait rien : la connexion est retirée ou incomplète, le système a refusé l'identifiant, ou il a répondu à la modification par une erreur. La ligne indique alors "This run stopped".
Qu'une exécution s'arrête ou non, la prochaine exécution planifiée démarre d'elle-même ; l'onglet Résumé indique le délai. Sur eCLIQ et Interflex, deux exécutions ne se chevauchent jamais : une exécution qui en rencontre une en cours est notée Ignorée et laisse le travail à celle en cours.
Les causes sont dans l'ordre où elles se vérifient.
La page porte le bandeau Draft, not yet active., et le bouton qui lance une synchronisation est verrouillé. Un brouillon ne synchronise pas. Continue setup, Test connection puis Activate libèrent la connexion.
Résumé affiche Échec de la vérification de l’état de la connexion (Health check failed), et "Errors" dans l'exécution nomme l'adresse qui ne répond pas. Vérifiez sur Configuration, sous "Security", l'"URL", si le système fonctionne et si votre pare-feu laisse passer portierX. Corrigez une adresse erronée par "Update Details", puis Tester la connexion (Test Connection).
Une page de connexion Cloudflare Access ou une passerelle répond à la place du système, et la vérification échoue bien que l'adresse soit juste. Vérifiez sur Configuration, sous "Protection Layer", le "Protection Type" et les en-têtes, et dans Cloudflare Zero Trust si le jeton de service de portierX est valide. Ressaisissez l'identifiant client et le secret ou les valeurs des en-têtes, "Save", puis Tester la connexion (Test Connection).
Tester la connexion (Test Connection) renvoie Échec, l'assistant de connexion indique Credentials rejected., et l'exécution se termine par "This run stopped". Le secret, le mot de passe ou le certificat a changé du côté du système ou a expiré. Pour SALTO et dormakaba MATRIX, saisissez le secret modifié sous "Security" par "Update Details" ; pour eCLIQ, collez le certificat de remplacement ; pour Interflex, renouvelez le mot de passe ou le certificat serveur ; la page de chaque système décrit la boîte de dialogue. L'exécution refusée n'est pas répétée ; la prochaine exécution utilise l'identifiant modifié.
Le système accepte la connexion et refuse l'écriture. Sur Interflex IF-6040, le compte de service manque alors d'un droit ou de la licence de lecture-écriture ; "Errors" dans l'exécution nomme le refus, et portierX ne répète pas l'exécution. Accordez au compte de service, dans le système, les droits et licences pour ce que portierX lit et écrit ; la prochaine modification dans portierX repart alors.
Ouvrez l'exécution. "What changed" liste chaque enregistrement écrit, et une entrée "Skipped" nomme un enregistrement avec sa raison. Une personne sans matricule dans Interflex est nommée et non créée ; portierX ne fait jamais correspondre par le nom. Une personne dont l'adresse e-mail est portée par une autre personne reste à résoudre par vous. Une zone venue d'Interflex arrive comme point d'accès sans espace ; vous la placez dans l'espace qu'elle dessert. Corrigez la cause dans le système ou dans portierX, et la prochaine exécution écrit l'enregistrement. Une exécution ne retire rien : ce qu'eCLIQ ou Interflex a cessé de lister est nommé dans le journal de synchronisation, et l'enregistrement reste dans portierX.
Sur Interflex, rien n'est écrit quand une lecture échoue ou renvoie plus de lignes qu'une exécution n'en lit ; la ligne nomme l'étape échouée, et une exécution avec des compteurs indique Succès partiel, une sans compteurs Échec. Sur SALTO et dormakaba MATRIX, un échec sur les portes termine l'exécution (Échec), et un échec sur les personnes laisse les portes en place (Succès partiel). Lisez "Errors" ; si le système est joignable et l'authentification valide, l'exécution est relivrée d'elle-même.
Le message indique Couldn't secure the secret. Contact support., ou la vérification signale le secret enregistré comme illisible. C'est le chiffrement de votre organisation dans portierX qui est touché, pas le système. Écrivez à [email protected].
Sur Résumé, Démarrer la synchronisation (Start Sync) lance une exécution immédiatement. portierX vérifie d'abord la connexion ; si cela échoue, Impossible de démarrer la synchronisation s'affiche et rien ne démarre. Le bouton est verrouillé un moment après chaque clic, pendant qu'une exécution est en cours et tant que la connexion est un brouillon ; l'indication sur le bouton donne la raison et le délai. Une exécution échouée n'est pas répétée ; le bouton en lance une autre. Sur eCLIQ et Interflex, une exécution qui en rencontre une en cours est notée Ignorée.
Remplacez le secret, le mot de passe ou le certificat dans portierX avant qu'il n'expire du côté du système ; sinon le système refuse chaque exécution.
Modifiez le pare-feu, Cloudflare Access ou les en-têtes en même temps que la "Protection Layer" de la connexion.
Laissez au compte de service, dans le système, ses droits et licences.
Après une modification dans le système, lisez la prochaine exécution dans le Journal de synchronisation.
Écrivez à [email protected] quand le secret ne peut être ni sécurisé ni lu, quand la vérification ne donne aucune raison, ou quand une exécution échoue encore après vérification de l'adresse, de la couche de protection et de l'identifiant. Donnez le nom de la connexion, l'heure de début de l'exécution dans le Journal de synchronisation et le texte sous "Errors". Comment joindre le support figure sous Voir aussi.
