Par l'interface REST de dormakaba MATRIX, portierX reprend les personnes, les badges, les portes et les droits d'accès de votre système et y écrit les modifications. La connexion est mise en place par l'Administrateur de l’organisation, et elle commence sous Intégrations, avec la tuile dormakaba MATRIX.
L'adresse de votre serveur MATRIX. portierX doit pouvoir l'atteindre.
Le jeton secret de l'interface REST. Il se crée dans MATRIX sous Settings, API & Integrations. Conservez-le aussitôt, MATRIX peut ne pas l'afficher une seconde fois.
Le numéro de l'interface REST configurée sur le serveur, et le mandant si votre système en gère plusieurs.
La décision sur le chemin que portierX peut prendre vers le serveur : ouvertement sur Internet, via Cloudflare Access, par votre VPN, ou derrière un en-tête que votre passerelle vérifie.
Réunir ces valeurs relève de l'informatique ou de votre partenaire dormakaba, pas de la gestion du site.
Ouvrez Intégrations et choisissez la tuile dormakaba MATRIX dans l'onglet "Available".
Passez sur Connecter et remplissez "Locking System Name", "URL", "REST Interface Number" et "Secret Token". Les quatre sont obligatoires ; le nom est libre et désigne ensuite la connexion dans toutes les listes. "Mandator" reste vide si votre système utilise le mandant 1 ; portierX retient alors 1.
Sous Network protection, indiquez comment portierX atteint le serveur : Public, Cloudflare Access, VPN ou "Custom headers". Ce que signifient les quatre modes figure dans l'article sur SALTO, et cela vaut pour MATRIX sans changement.
Cliquez sur Test connection. portierX enregistre la connexion comme brouillon et vérifie que MATRIX répond.
Cliquez sur Activate. Une fois le test réussi, ce bouton prend la place de Test connection.
Save as draft interrompt la mise en place. Le brouillon figure dans l'onglet "Connected" avec la mention "Draft, not yet active.", et Continue setup rouvre le formulaire.
La page de la connexion s'ouvre avec les onglets Résumé, Configuration et Journal de synchronisation.
portierX récupère les données de MATRIX : les personnes et les employés d'entreprises externes deviennent des personnes, les badges des identifiants d'accès sur la personne concernée, les portes des points d'accès. Les droits d'accès d'une personne sont repris comme lien entre son badge et les portes. Identifiant d'accès est le mot de l'application pour un badge, une carte ou un transpondeur.
portierX relie une personne MATRIX à une personne de portierX par l'adresse e-mail. Quand deux personnes MATRIX partagent une adresse, portierX ne relie personne par cette adresse.
Ensuite, portierX synchronise de lui-même toutes les dix minutes. "Start Sync" sur Résumé lance une synchronisation immédiatement, et "Test Connection" vérifie encore la joignabilité. Les deux boutons restent verrouillés une minute après le clic.
Chaque exécution a sa propre ligne dans le Journal de synchronisation, avec le statut Success, Partial Success ou Failed.
Les modifications faites dans portierX partent vers MATRIX comme des tâches à part :
Renommez un point d'accès du système MATRIX et la porte dans MATRIX reçoit le nom de portierX.
Modifiez les données d'une personne ou ses droits d'accès et portierX met la personne à jour dans MATRIX, en la créant si MATRIX ne la connaît pas.
Modifiez le libellé d'un badge et le badge dans MATRIX reçoit le même.
Reprenez un badge numérique et portierX le supprime dans MATRIX.
Le résumé d'une connexion MATRIX : Sync Health, Sync Status et Last Sync, avec Start Sync et Test Connection.
Sur Résumé, "Sync Health" indique si portierX atteint MATRIX : "Connected", "Error" ou "Health check is in progress". "Test Connection" répète la vérification ; en dessous figurent "Last test on" avec la date et "Returned" avec "OK" ou "Failed". Si la vérification échoue, "Review Configuration" ouvre l'onglet Configuration.
Sur Configuration se trouvent "Protection Layer" avec le type de protection et "Security" avec "URL" et "Last Updated". "Update Details" ouvre "Update Security Details", où vous ressaisissez l'adresse et le jeton secret. Les modifications prennent effet immédiatement, peuvent interrompre brièvement la synchronisation et sont consignées dans le journal d'audit. Ce que la page montre d'autre figure dans l'article sur l'écran d'une intégration.
Seul l'Administrateur de l’organisation crée, active et modifie la connexion.
Le nom d'une connexion est unique dans l'organisation.
Un prénom, un nom, une adresse e-mail ou un numéro de mobile que vous modifiez dans portierX garde votre valeur ; la récupération ne l'écrase pas.
Les droits accordés dans MATRIX par un profil d'accès ou par le plan de fermeture ne sont pas fournis par l'interface ; ils n'apparaissent pas dans portierX comme liens. Les droits sur des lecteurs isolés et sur des zones de pièces passent.
Une personne que MATRIX tient comme employé d'entreprise externe est reprise de MATRIX ; les modifications la concernant ne sont pas réécrites.
La page a trois onglets. Il n'y a pas d'état des portes pour MATRIX comme pour SALTO.
Une connexion ne se supprime pas depuis sa page. Pour déconnecter un système, adressez-vous à portier.
