Une connexion est le pont entre portierX et un système que vous exploitez ou utilisez : un système de contrôle d'accès, Microsoft Entra ID, les fichiers de votre système RH ou un plan de fermeture issu d'un fichier. L'Administrateur de l’organisation et le Gestionnaire d'accès voient toutes les connexions sous Intégrations. L'un comme l'autre connecte un système de contrôle d'accès ; l'Administrateur de l’organisation connecte Microsoft Entra ID, le fichier RH et un plan de fermeture issu d'un fichier.
Également appelé : intégration, liaison, interface.
Intégrations a deux onglets, chacun avec son compteur. Disponible montre une tuile par système que portierX peut connecter ; Connecté montre une tuile par connexion existante, brouillons compris. Les Catégories commencent par Toutes les applications, et Rechercher des applications... trouve une tuile par son nom, sa description ou un mot-clé.
Sur une tuile sous Disponible, Voir les détails ouvre la description du système sur l'onglet Informations ; Configurer ouvre directement l'onglet Connecter. Sur une tuile sous Connecté, Voir les détails ouvre la connexion. Tant qu'aucune connexion n'existe, Ajouter une intégration mène à Disponible.
Un système de contrôle d'accès, c'est-à-dire SALTO, dormakaba MATRIX, ASSA ABLOY eCLIQ ou Interflex IF-6040, est atteint par portierX par l'interface propre du système. portierX lit selon un calendrier ce que le système détient et y écrit ce qui change dans portierX ; quelles données vont dans quel sens figure sur la page de chaque système. Quand Nordwerk Industries connecte son système SALTO, les portes du Werk Nord deviennent des points d'accès, ses personnes des personnes et ses cartes des identifiants d'accès.
Microsoft Entra ID relie portierX à l'annuaire de votre informatique, une fois pour l'authentification (authentification unique par SAML) et une fois pour le provisionnement des personnes et des groupes (SCIM). portierX n'appelle ici aucun système ; le navigateur et Entra ID appellent portierX. Ces connexions n'ont donc ni protection réseau ni test de connexion, et Activate achève la mise en place à lui seul. La connexion SCIM exige une connexion d'authentification unique active avec un domaine vérifié.
Le fichier RH est un dossier que portierX attribue à votre organisation. Votre système RH y dépose ses exports et, chaque matin, portierX lit ce qui est arrivé. Une organisation a une seule source de ce type ; elle n'a ni protection réseau, ni test de connexion, ni brouillon, et seul un Administrateur de l’organisation la crée.
Un plan de fermeture arrive dans portierX comme export XML du fabricant : ABUS, CES, DOM, dormakaba, EVVA, KESO ASSA ABLOY, WILKA, WINKHAUS ou le format XML propre de portier. La connexion se crée en téléversant le fichier avec Create Integration, et seul un Administrateur de l’organisation téléverse.
L'onglet Connecter s'ouvre sur le guide propre au système, ce qu'il demande et ce que portierX échange avec lui, puis vient le formulaire. Les champs viennent du système : un nom pour la connexion, l'adresse de son interface, l'identifiant de connexion et, selon le système, un certificat ou d'autres réglages. Les champs obligatoires sont marqués. Pour un système de contrôle d'accès, Network protection suit le formulaire.
Test connection enregistre la connexion comme brouillon et vérifie que portierX atteint le système avec ces réglages et que le système accepte l'identifiant. Après un test réussi, le bouton devient Activate. portierX vérifie la connexion une seconde fois, l'active, lance la première exécution et ouvre sa page sous Connecté. Save as draft conserve les réglages sans vérification. Annuler ferme l'assistant.
Quand une étape échoue, le formulaire en donne la raison.
L'adresse ne répond pas.
Credentials rejected.
That name is already in use. Choose a different name.
Complete the required fields before saving.
Couldn't secure the secret. Contact support.
Network protection dit à portierX comment il atteint l'interface d'un système de contrôle d'accès. Public : l'interface est joignable en HTTPS, et votre pare-feu laisse passer portierX. Cloudflare Access : l'interface se trouve derrière une application Cloudflare Access, et portierX s'authentifie avec un jeton de service dont les valeurs vont sous CF-Access-Client-Id et CF-Access-Client-Secret. VPN : un VPN site à site ou ExpressRoute entre votre réseau et portierX, sans autre saisie. En-têtes personnalisés : l'interface attend un ou plusieurs en-têtes fixes, saisis avec Add header comme Header name et Header value.
Sur la page de la connexion, le même choix est la carte "Protection Layer" de l'onglet Configuration : "Protection Type", le guide du mode choisi, ses champs et "Save". Un secret Cloudflare laissé vide conserve celui qui est enregistré, tant que l'identifiant client ne change pas. eCLIQ ne propose que Public.
La carte "Security" de l'onglet Configuration affiche l'"URL" et, sous "Last Updated", la dernière modification. "Update Details" ouvre la boîte de dialogue pour l'adresse et le secret, et "Save" applique les deux aussitôt. Une synchronisation en cours peut s'interrompre un instant, et chaque modification est consignée dans le journal d'audit. eCLIQ remplace ici son certificat, et Interflex change l'adresse, le mot de passe et le certificat serveur dans des blocs distincts ; la page de chaque système le décrit.
Un brouillon est une connexion enregistrée et non activée. Il vient de Save as draft ou d'un test de connexion qui n'a pas réussi. Le brouillon compte sous Connecté et y porte le bandeau Draft, not yet active. avec Continue setup. Un brouillon ne synchronise pas. Continue setup ouvre le formulaire avec les réglages enregistrés ; le secret reste vide et le nom est fixe. Qui change l'adresse ou l'identifiant ressaisit le secret : Re-enter the secret to save these changes.
Un Administrateur de l’organisation ou un Gestionnaire d'accès connecte un système de contrôle d'accès. Seul un Administrateur de l’organisation connecte Microsoft Entra ID, le fichier RH et un plan de fermeture issu d'un fichier.
Le nom d'une connexion est unique dans l'organisation et fixe une fois la connexion créée.
Une connexion ne devient active que si sa propre vérification réussit à l'activation.
portierX chiffre les secrets, les mots de passe et les certificats avant de les stocker. Aucun écran ne les réaffiche.
La protection réseau vaut pour les systèmes de contrôle d'accès. Microsoft Entra ID et le fichier RH n'en ont pas ; eCLIQ n'a que Public.
Un brouillon ne synchronise pas et compte sous Connecté.
Une connexion à un système de contrôle d'accès ne se retire pas depuis sa page.
L'exécution planifiée est fixée pour l'installation, pas par connexion. Ce que montre la page d'une connexion figure sous Voir aussi.
