Rappel / Contexte


  • Produit : Vauban / Visor 
  • But : permettre la synchronisation des utilisateurs et la gestion des accès (badges / codes / appli) entre Visor et Cosoft.


⚙️ Pré-requis réseau et accès


Demander l'ouverture du port 8080 et l'autorisation des deux adresses IP Cosoft :

  • 185.11.163.81 — Serveur 3 Cosoft
  • 185.11.161.186 — Bureaux 2 Cosoft


Attention : si le client se trouve derrière un routeur, il faut ouvrir le port 8080 sur le routeur ET sur la machine (ou firewall interne) et autoriser nos IPs.


Demander un accès à distance (AnyDesk ou TeamViewer) sur le PC qui héberge Vauban (avec un compte ayant accès au logiciel Vauban) — nécessaire pour vérifier la configuration et récupérer l'IP locale si besoin.


Message type pour le client :

 

Dans le cadre de l’intégration de votre solution Vauban / Visor avec votre nouveau logiciel Cosoft, certaines actions doivent être réalisées sur votre infrastructure avant notre intervention :

  1. Ouvrir le port 8080 sur votre routeur et/ou firewall, et autoriser les adresses IP Cosoft suivantes :
    • 185.11.163.81 — Serveur 3 Cosoft
    • 185.11.161.186 — Bureaux 2 Cosoft
  2. Nous fournir un accès à distance (AnyDesk ou TeamViewer) sur le poste qui héberge Vauban/Visor, avec un compte utilisateur ayant accès complet au logiciel Vauban.
  3. Nous communiquer l’adresse IP locale du poste hébergeant Vauban Visor.

Ces prérequis sont indispensables pour assurer le bon déroulement du paramétrage et de la liaison entre vos systèmes et Cosoft.



Étape 1 — Vérifications et paramètres dans Visor


Ouvrir Visor et vérifier les éléments suivants :

  • Aller dans Outils > Préférence > connexion externe pour préparer la liaison.
  • Regarder les groupes déjà créés : Horaires et droits d'accès > Groupe d'accès. Voir avec le client quelles locations ouvrent quels groupes / droits d'accès.
  • NE PAS activer l'option VISOR_ACTIVATE_HOOK dans Cosoft si vous suivez cette méthode d'intégration (import CSV/API).
  • Le paramètre VISOR_IP doit être renseigné dans les AppParameters (format : [ip]:8080). Ne pas préfixer par http si la configuration n'est pas en HTTPS.



Étape 2 — Création d'un module d'importation dans Visor (import automatique)


Dans Visor, créez un nouveau module d'importation : Outils > Nouveau module d'importation.

  • Module actif : oui
  • Importer toutes les : 5 minutes
  • Format : CSV (séparateur : point-virgule)
  • HTTP : URL vers l'API Cosoft — https://[API URL].cosoft.fr/api/Visor/ImportVisorUsersCSV?appid=[APPID]&id=[FTELSOCIETYID]&delay=5


Pour récupérer / construire ce lien :

  1. Générer l'API URL (nom de la plateforme puis « -api » si vous suivez la nomenclature interne).
  2. Générer l'API Id depuis Cosoft : Société > Accès à l'API.
  3. Récupérer le FTEL Society ID depuis Cosoft (identifiant société attendu par l'API Visor).


La liaison sera fonctionnelle si l'URL finale renvoie un export CSV exploitable (vérifier depuis votre poste que vous pouvez atteindre l'IP du client). 

Si l'export ne fonctionne pas, la liaison est bloquée côté client (firewall / routeur).


Ne pas cocher : « Suppression d'utilisateurs » (pour ne pas supprimer des comptes côté Visor par erreur).



 Mapping des colonnes CSV (obligatoire)


Configurer les colonnes ainsi :

  1. Clé externe : Colonne 1
  2. Nom : Colonne 2
  3. Prénom : Colonne 3
  4. Email : Colonne 4
  5. Téléphone : Colonne 5
  6. Identifiants : Colonne 6 (⚠️ Colonne 12 si code PIN)
  7. Groupes : Colonne 7
  8. Autoriser : Colonne 8 — (sur certaines anciennes versions de Visor, ce champ n'existe pas ; dans ce cas, ignorer)
  9. Envoyer un VISOR ACCESS : Colonne 9 — permet d'envoyer le SMS / e-mail pour installer l'application Vauban (si version compatible)
  10. À considérer / optionnel : Colonne 10 (User ID), Colonne 11 (Immatriculation)



 Étape 3 — Configuration côté Cosoft


Dans l'application Cosoft :

  • Aller dans Supervision > Options et activer les éléments suivants selon le besoin :
    • Visor
    • Swip Card Auto — utile si vous ne générez pas de codes pendant les tests
    • Visor Access — si vous souhaitez envoyer des accès par SMS
    • Identifiant des badges — si vous utilisez des badges
    • Lecteur de badge
  • Ajouter les lecteurs de badge : Admin > Config > Lecteur de badge

    Important : nommer les lecteurs exactement comme dans Vauban (attention aux espaces en début/fin de nom).

  • Mettre les lecteurs en Accès Location.
  • Lier les lecteurs de badge aux locations associées : Admin > Locations > Symboles de la clé.
  • Ajouter l'AppParameter : VISOR_IP = [ip]:8080 (ex. 193.253.200.172:8080)



 Étape 4 — Tests réseau / disponibilité


  1. Depuis AnyDesk ou Teamviewer, vérifier l'adresse IP du PC Vauban en allant sur internet et sur un site d'IP (ou demander au client).
  2. Depuis VOTRE poste (ou un outil en ligne), tester l'URL suivante (exemple) :http://[ip du client]:8080/Visor/GetDoorList
    Ex. : http://193.253.200.172:8080/Visor/GetDoorList
  3. Si la requête ne répond pas, contacter le client pour vérifier l'ouverture du port 8080 et l'autorisation de nos IPs (étape réseau pré-requise).





Étape 5 — Tests fonctionnels dans Cosoft


Pour vérifier la bonne synchronisation des accès :

  1. Dans Cosoft, aller dans Devis.
  2. Créer un devis pour une location qui ouvre des droits d'accès (assurez-vous que la location est rattachée aux bons groupes / lecteurs).
  3. Valider le devis en indiquant votre adresse e‑mail et numéro de téléphone (pour recevoir les accès si la chaine SMS/mail est activée).
  4. Si tout est correctement configuré, vous devez recevoir les codes / accès.
  5. Si vous ne recevez rien, consulter les logs (voir chapitre de bug ci‑dessous).



 Debug / journalisation


Sur Visor : Administration > Journal — on peut y voir les imports automatiques effectués (success / erreurs). 


Vérifier :

  • Les erreurs d'import (mauvais mapping, encodage CSV, colonne manquante)
  • Les erreurs réseau (timeout, refus de connexion)
  • L'absence d'envoi d'accès (colonne 9 ou service SMS non configuré)