Info | ||
---|---|---|
| ||
On January 27, 2022 we will release an updated version of DataBridge. It will use the latest version of the SuperOffice Web API. If you use SuperOffice Onsite, you have to make sure your environment has installed, publicly exposed and configured authorisation properly according to the information on this page. |
DataBridge is also available for SuperOffice CRM Onsite. There are some requirements the environment must meet and also there are additional configuration steps needed for the SuperOffice environment and DataBridge.
Note: DataBridge will still be running in the cloud but will connect to your local SuperOffice CRM environment via the publicly exposed SuperOffice APIsWeb API.
Requirements
- SuperOffice APIs need to be accessible from the internet through HTTPS;SuperOffice version 8.4 R08 or newer;
- SuperOffice System User.
- SuperOffice Web API needs to be accessible from the internet through HTTPS;
1. Prepare SuperOffice APIs
If you are using SuperOffice Mobile CRM your SuperOffice APIs have probably already been configured to be accessible from the internet. You can move on to the next step.
If not, follow the steps in ‘Prepare Server’ in the SuperOffice documentation on configuring the APIs (NetServer) for Pocket CRM.
Make sure to read the documentation Security and deployment on SuperOffice Community.
2. Verify SuperOffice APIs
Verify the installation by opening a browser and browsing to the web services:
https://<address>/Remote/Services88/person.svc
and
https://<address>/api
Example:
https://servername.yourcompany.com/SuperOffice/Remote/Services88/person.svc
https://servername.yourcompany.com/SuperOffice/api
If the Web Services are exposed correctly you see the following screen:
In the background DataBridge checks which services version for your SuperOffice installation is the newest and it will automatically use that latest version. This way you don't need to re-configure DataBridge when you upgrade your SuperOffice installation.
...
DataBridge connects to your locally hosted SuperOffice installation. To do so, your SuperOffice installation needs to expose its Web API. This needs to be done in a secure way.
Security based on filtering IP addresses is possible; further down this page, you'll find the IP addresses that DataBridge uses to connect to your SuperOffice instance.
If all is set up correctly you should be able to 'contact' the Web API by visiting this URL, where your replace the obvious part with your (sub)domain.
- https://<your_SuperOffice_url>/api
Details on how to expose and verify the Web API can be found here: https://docs.superoffice.com/authentication/webapi/enable-basic-auth.html
It might be a bit technical. If you are not able to perform the configuration and testing yourself, please contact your SuperOffice consultant.
2. Configure DataBridge
You are now ready to configure DataBridge using the following steps:
- Sign up for a new DataBridge account here:
https://my-databridge.infobridgeuniverse.com/Account/Registration; - Confirm your email address;
- Setup the connection to your SuperOffice environment.
If you are not automatically redirected to the 'Setup Connection' page click on 'Account' and then on 'Connection'
or visit the following page directly http://my-databridge.infobridgeuniverse.com/Manage/Connection and fill out the form:- Using a version of SuperOffice equal to or higher than 8.4 R08 - NetServer services URL: http://<address>/Remote/Services88/;SuperOffice Web API URL (https://<your_SuperOffice_url>/api)
- Username of a SuperOffice System User;
- Password of the userSystem User;
- Clicking save will verify Click Save to verify and save the connection ;details.
- New profiles will now automatically copy these default connection settings.
Info |
---|
If you have set up DataBridge with your SuperOffice Onsite installation before January 6, 2022 then you might have used a URL to Netserver Services (i.e. https://<your_SuperOffice_url>/Remote/Services86). You don't need to change the URL to point to the Web API instead of Netserver Services. DataBridge will make sure it finds the Web API. Only if you experience troubles when DataBridge tries to connect to SuperOffice Onsite, please edit the connection details by entering the URL to Web API. |
Other details
DataBridge will use the following IP addresses to connect to your environment:
- 23.97.188.46
- 40.118.68.234
- 40.118.69.16
- 40.118.69.95
- 40.118.64.32
- 213.124.69.170