portierX se connecte à un Interflex IF-6040 par l'interface OpenAPI REST que votre informatique publie. La mise en place demande le rôle Administrateur de l’organisation ou Gestionnaire d'accès dans portierX et un compte de service sur l'IF-6040, elle se fait donc avec l'informatique. Elle commence sous Intégrations, sur l'onglet Disponible, avec la tuile INTERFLEX.
Également appelé : Interflex, IF-6040, INTERFLEX, badge, zone, profil d'accès.
Votre informatique publie l'interface OpenAPI de l'IF-6040 de sorte que portierX l'atteigne en HTTPS, le plus souvent derrière une couche de protection (Cloudflare Access, VPN ou en-têtes fixes).
L'adresse de base de l'interface, par exemple https://if6040.example.de/api, et le chemin de connexion qui y délivre le jeton, par exemple /Login. L'informatique nomme les deux ; portierX ne devine pas le chemin.
Un compte de service sur l'IF-6040 avec nom d'utilisateur et mot de passe, doté des droits et licences pour ce que portierX lit et écrit.
Au besoin, la langue de connexion, par exemple en-US, et le certificat serveur au format PEM quand le certificat de l'IF-6040 n'est pas de confiance publique.
Les en-têtes qu'exige la couche de protection devant l'interface.
Le rôle Administrateur de l’organisation ou Gestionnaire d'accès dans portierX.
Ouvrez Intégrations et restez sur Disponible.
Sur la tuile INTERFLEX, cliquez sur Configurer.
Saisissez un nom sous "Connection name".
Saisissez l'adresse de base sous "OpenAPI base URL" et le chemin de connexion sous "Sign-in path".
Saisissez le compte de service sous "Service account username" et "Service account password".
Au besoin, saisissez la langue sous "Sign-in language" et collez le certificat PEM sous "Server certificate (CA)". Sinon, laissez les deux champs vides.
Sous Network protection, choisissez comment portierX atteint l'interface et saisissez ses en-têtes.
Cliquez sur Test connection. portierX se connecte, rejette le jeton et n'écrit rien.
Une fois le test réussi, cliquez sur Activate.
portierX chiffre le nom d'utilisateur et le mot de passe avant de les stocker. Après l'activation, la première exécution démarre et la page de la connexion s'ouvre sous Connecté avec les onglets Résumé, Configuration, Journal de synchronisation et Notifications. La lecture du Résumé est décrite dans Ce que vous indique l’écran d’une intégration.
À chaque exécution, portierX lit dans l'IF-6040 les personnes, les badges, les zones, les profils d'accès et les noms des profils horaires. Une personne est reconnue par son matricule et reliée à une personne existante de portierX par son adresse e-mail quand cette adresse est unique. Un badge devient un identifiant d'accès détenu par sa personne. Une zone devient un point d'accès sans espace ; vous le placez dans l'espace qu'il dessert, par exemple le Serverraum du Werk Nord. Chaque badge est relié aux points d'accès des zones qu'il ouvre, par les profils de sa personne et par les droits directs.
Un profil d'accès devient un groupe de personnes à sa première lecture, avec toutes celles qui le détiennent. Dès lors, le groupe appartient à portierX : une modification de son nom ou de ses membres faite dans l'IF-6040 est consignée comme écart et n'est pas appliquée. Chaque zone enregistre les profils qui l'atteignent. Les événements de porte, le pointage et les données des visiteurs ne sont jamais lus.
portierX écrit dans l'IF-6040 ce qui change sur une personne et ses badges dans portierX : le prénom, le nom et l'adresse e-mail d'une personne ; un badge remis à une personne reçoit dans l'IF-6040 le lien avec cette personne ; un badge repris voit ce lien clôturé là-bas, et un badge signalé perdu y est en plus bloqué ; un badge relié à un point d'accès qui est une zone de l'IF-6040, ou détaché de lui, reçoit ou perd dans l'IF-6040 le droit personnel de sa personne sur cette zone. Chaque envoi figure dans le Journal de synchronisation sous "Push".
Ne sont pas écrits en retour le nom d'une zone, le libellé d'un badge, les zones d'un profil et les membres d'un groupe de personnes repris d'un profil. L'interrupteur "Auto push" de l'onglet Configuration commande ces envois ; sa signification figure sur la page de l'écran de connexion.
La carte "Security" de l'onglet Configuration a trois blocs, chacun s'enregistrant seul ; un champ laissé vide conserve la valeur enregistrée.
Sous "Base URL" et "Sign-in path", changez l'adresse ; "Save address" l'applique.
Sous "Username", le compte de service est affiché masqué. Un mot de passe sous "New password" s'applique par "Rotate password" ; "Test connection" se connecte pour vérifier.
"Server certificate" affiche "Set" ou "None". Un certificat sous "Paste the new PEM certificate" s'applique par "Replace certificate".
Après chaque enregistrement, portierX se connecte pour vérifier et dit si cela a réussi. Seuls l'Administrateur de l’organisation et le Gestionnaire d'accès modifient les champs.
L'onglet Notifications porte le seul rappel de cette connexion, Une demande Interflex n'est pas activée : une demande approuvée dans portierX que le groupe responsable n'a pas activée dans l'IF-6040. Sous Quand, saisissez à Toujours pas activée après les jours après l'approbation ; sous Qui reçoit un e-mail, choisissez à E-mail toutes les personnes ayant un rôle, le responsable du lieu ou le responsable de l'entreprise. Par défaut, sept jours et toutes les personnes ayant le rôle Moniteur de sécurité. Enregistrer applique le réglage ; sans le droit de configurer les intégrations, le formulaire est en lecture seule.
Après l'activation, la première exécution démarre aussitôt ; ensuite portierX s'exécute selon son calendrier et sur le bouton du Résumé.
Chaque exécution figure dans le Journal de synchronisation comme Succès, Succès partiel, Échec ou Ignorée. Ignorée veut dire qu'une autre exécution de la même connexion était en cours.
Le Résumé compte les personnes, espaces, identifiants d'accès, points d'accès et groupes de personnes de cette connexion.
Le journal nomme, à chaque exécution, qui a été ignoré : les personnes sans matricule (les 25 premières par leur nom, le reste en nombre), les personnes qui n'ont pas pu être reliées par e-mail, les doublons possibles, les zones sans espace, les badges sans détenteur connu et les enregistrements que l'IF-6040 a cessé de lister.
Quand une exécution s'interrompt, la ligne nomme l'étape ; ce qui a été écrit avant reste.
L'adresse commence par https. portierX refuse une adresse sans https.
Le chemin de connexion est obligatoire ; portierX n'en suppose aucun.
Une personne sans matricule dans l'IF-6040 est ignorée et nommée. portierX ne fait jamais correspondre par le nom.
Une zone arrive comme point d'accès sans espace. L'espace, c'est vous qui l'attribuez.
Un groupe de personnes repris d'un profil appartient à portierX. Les modifications du profil dans l'IF-6040 sont consignées, pas appliquées ; les modifications des membres dans portierX ne sont pas écrites dans l'IF-6040.
Une exécution ne retire rien. Ce que l'IF-6040 a cessé de lister est nommé dans le journal de synchronisation.
Un envoi que l'IF-6040 refuse faute d'un droit ou d'une licence est consigné et n'est pas répété.
Les événements de porte, le pointage et les données des visiteurs ne sont jamais lus.
La connexion ne se retire pas depuis sa page.
L'Administrateur de l’organisation et le Gestionnaire d'accès lisent les réglages de la connexion ; les deux mêmes les modifient.
Les systèmes connectés en un coup d'œil
