Do you have your own information system or external data sources and would like to integrate them into incwo?
Install this app to add tabs to incwo that call up your external pages
Installing the app activates new "Plus" tabs on your objects: when these tabs are clicked, they display a page that calls up the iframe of your choice.
1. Configuration
Go to the app settings tab
Start by entering the url of your iframe. This will be called up in http or https depending on the page the user is on.
Select the objects on which you wish to see the "More" tab: contacts, quotes, invoices, etc., by activating the corresponding setting.
2. Parameters
Various parameters are passed to the iframe:
business_file_id: the ID of your application
user_id: the ID of the user viewing the page
object_zname: the type of object viewed
object_zid: the ID of the object viewed
token: a security token, see below
Activate the "Add object data in JSON" setting if you want your url to include a "data" parameter with the object content in JSON. Please bear in mind the consequences, particularly on URL length! In case of doubt, check the LimitRequestLine setting of the called site (if you're using apache).
3. Security
If you're not careful, your iframe could be called up by someone and display content you don't want circulating. We therefore recommend :
3.1 IP filtering
Only accept calls from incwo IPs: 185.16.44.*
3.2 Checking the security token
You can enter a "salt" string in the app settings. This salt is used in the composition of a string that is passed as a "token" parameter to your iframe. If your iframe uses the same salt to calculate the same string, the connection is authorized.
The token is the concatenation of 5 parameters, to which an MD5 is applied.
MD5 (user_id business_file_id object_zname object_zid salt)