Par SHIP, l'interface de SALTO ProAccess SPACE, portierX reprend les portes et les utilisateurs de votre système SALTO 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 SALTO.
L'adresse de votre point de terminaison SHIP, joignable en HTTPS avec un certificat valide. Un certificat auto-signé ne convient pas.
Le secret SHIP de SALTO ProAccess SPACE. Il se crée là, sous System, General Options, dans l'onglet SHIP : activez le serveur SHIP, choisissez HTTP(S) comme protocole et définissez une authentification personnalisée. Conservez le secret aussitôt, SALTO ne l'affiche pas une seconde fois.
La décision sur le chemin que portierX peut prendre vers ce point de terminaison : 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 SALTO, pas de la gestion du site.
Le catalogue présente chaque système que portierX peut connecter. SALTO se connecte avec des identifiants que vous saisissez, pas avec un fichier.
Ouvrez Intégrations et choisissez la tuile SALTO dans l'onglet "Available".
Passez sur Connecter et remplissez "Locking System Name", "URL Host" et "Secret Key". Les trois sont obligatoires. Le nom est libre et désigne ensuite la connexion dans toutes les listes.
Sous Network protection, indiquez comment portierX atteint le point de terminaison. Les quatre possibilités sont décrites plus bas.
Cliquez sur Test connection. portierX enregistre la connexion comme brouillon et vérifie que le système répond.
Cliquez sur Activate. Une fois le test réussi, ce bouton prend la place de Test connection.
Les quatre modes de protection réseau :
Public : le point de terminaison est joignable depuis Internet. Restreignez-le par des règles de pare-feu aux adresses IP publiques de portierX ; demandez ces adresses à portier.
Cloudflare Access : portierX envoie CF-Access-Client-Id et CF-Access-Client-Secret à chaque appel. Pour cela, créez un jeton de service dans Cloudflare Zero Trust et n'autorisez que ce jeton dans la politique d'accès.
VPN : la liaison passe par votre propre réseau, sans aucun en-tête.
"Custom headers" : une ou plusieurs paires Header name et Header value attendues par votre passerelle. Add header ajoute une paire.
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 reprise, un secret Cloudflare enregistré est conservé si vous laissez le champ vide. Un en-tête personnalisé exige toujours une valeur.
Si le test échoue, le formulaire en donne la raison : le système est injoignable, SALTO refuse les identifiants, ou Cloudflare Access bloque la requête.
La page de la connexion s'ouvre avec les onglets Résumé, Configuration, Journal de synchronisation et État des portes.
portierX récupère les données de SALTO : les portes deviennent des points d'accès, les utilisateurs SALTO des personnes, et la clé d'un utilisateur est tenue comme identifiant d'accès sur cette personne. Identifiant d'accès est le mot de l'application pour une clé, une carte ou un badge.
Ensuite, portierX synchronise de lui-même à intervalles réguliers. Démarrer la synchronisation sur Résumé lance une synchronisation immédiatement, et Tester la connexion vérifie encore la joignabilité. Les deux boutons restent verrouillés une minute après le clic, et la page indique le temps restant.
Chaque exécution a sa propre ligne dans le Journal de synchronisation.
Les modifications faites dans portierX partent vers SALTO comme des tâches à part :
Un point d'accès que vous ajoutez ou renommez dans le système SALTO est créé dans SALTO comme porte, ou y reçoit son nom et sa description depuis portierX.
Une personne qui reçoit un accès à une porte SALTO est créée dans SALTO comme utilisateur si elle n'y existe pas. Le nom et les droits d'accès suivent chaque modification.
Quand vous reprenez une clé, portierX l'annule dans SALTO.
portierX relie un utilisateur SALTO à une personne par son adresse e-mail. Le champ utilisateur SALTO dans lequel portierX prend l'adresse se règle sur Configuration, sous Sécurité, dans le champ Email source : "External User ID (ExtUserID)", ou l'un des champs "General Purpose Field 1 (GPF1)" à "General Purpose Field 5 (GPF5)". La valeur par défaut est GPF1. Un utilisateur sans adresse valide dans ce champ n'est relié à aucune personne. Une modification s'applique à partir de la prochaine récupération.
La couche de protection permet de changer ensuite le type de protection et les en-têtes. La section Sécurité porte l'URL, l'heure de la dernière modification et la source de l'adresse e-mail.
Configuration porte les deux blocs qui tiennent l'accès.
Couche de protection propose sous Type de protection les quatre mêmes possibilités que l'assistant, avec un guide pour le mode choisi et les champs pour Cloudflare Access ou pour En-têtes personnalisés. Enregistrer applique le choix et Annuler rétablit ce qui est enregistré.
Sécurité affiche URL, Dernière mise à jour et Email source. Mettre à jour les détails ouvre Mettre à jour les détails de sécurité, où vous saisissez URL, Nom du secret et la source de l'adresse e-mail. Le secret est ressaisi à chaque fois. Les modifications prennent effet immédiatement et peuvent interrompre brièvement la synchronisation ; chacune est consignée dans le journal d'audit.
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 données matérielles d'une porte, comme le niveau de batterie, le mode d'ouverture et la partition, viennent toujours de SALTO.
portierX n'encode pas de clés, n'ouvre pas de porte à distance et ne commute pas le mode bureau. Cela reste du ressort de SALTO.
Une connexion ne se supprime pas depuis sa page. Pour déconnecter un système, adressez-vous à portier.
