Vous disposez de votre propre système d'information ou de sources externes de données et vous souhaitez les intégrer dans incwo ?
Installez cette app pour ajouter dans incwo des onglets faisant appel à vos pages externes
L'installation de l'app active de nouveaux onglets "Plus" sur vos objets : une fois ces onglets cliqués, ils affichent une page qui fait appel à l'iframe de votre choix.
1. Configuration
Rendez-vous sur l'onglet réglage de l'app
Commencez par saisir l'url de votre iframe. Celle-ci sera appelée en http ou https en fonction de la page sur laquelle se trouve l'utilisateur.
Choisissez les objets sur lesquels vous souhaitez voir l'onglet "Plus" : contacts, devis, factures, etc. en activant le réglage correspondant.
2. Paramètres
Différents paramètres sont transmis à l'iframe :
business_file_id : l'ID de votre application
user_id : l'ID de l'utilisateur qui visualise la page
object_zname : le type de l'objet visualisé
object_zid : l'ID de l'objet visualisé
token : un token de sécurité, voir plus bas
Activez le réglage "Ajouter les données de l'objet en JSON" si vous souhaitez que votre url comporte un paramètre "data" avec le contenu de l'objet en JSON. Attention, pensez bien aux conséquences, notamment sur la longueur de l'URL ! En cas de doute vérifiez le réglage LimitRequestLine du site appelé (si vous utilisez apache)
3. Sécurité
Si vous ne faites pas attention, votre iframe pourrait être appelée par une personne et afficher du contenu que vous ne souhaitez pas voir circuler. Nous vous recommandons donc :
3.1 Filtrage IP
N'acceptez que les appels provenant des IP incwo : 185.16.44.*
3.2 Vérification du token de sécurité
Vous avez la possibilité de saisir une chaine "salt" dans les réglages de l'app. Ce salt est utilisé dans la composition d'une chaine qui est passé en paramètre "token" à votre iframe. Si votre iframe calcule, avec ce même salt, la même chaine, alors la connexion est autorisée.
Le token est la concaténation de 5 paramètres, a laquelle on applique un MD5.
MD5 (user_id business_file_id object_zname object_zid salt)
