This document provides basic information on VPN Agent, how to set it up and use it in your integration flow.
The VPN Agent or the Agent is а VPN tunnel specifically configured to access any local resource in your local environment. It could be any local database or CRM to which you would rather restrict access from outside world but still need to query for a data.
When the Agent is configured the platform and your local resource communicate data using the secure VPN tunnel. All the processing is happening on platform side, your resource serves the role of data source or final destination of data depending on your use case.
Please note that you can manage VPN agents using API calls. You can find all the information you need about it here.
To setup the Agent you would need to fulfill the following preconditions:
127.0.0.1
or instead be localhost
. Please consult the documentation of your resource on how to configure it.As an example let us connect the locally running Mongo database with the platform.
Let’s assume our local database is accessible on 192.168.1.7
address and 27017
port (standard MongoDB port).
Navigate to left-hand-side menu, Integrate > Agents and press on Create an Agent button if you don’t have any Agents or press on Create New Agent button to add new one. You can also create a VPN agent using this API endpoint.
You will get a new pop-up form to fill in the details. Note you can extend the form by selecting Create New Endpoint.
Let us fill in the needed values:
MongoDB_local_com
.TCP
or UDP
. We use TCP
because we use MongoDB and it uses TCP protocol.192.168.1.7
and 27017
.Click Save to save all entry values and submit to the system. After this the form will disappear and a new record appear in the page. Click on newly created record to see the details.
Before going further save the address in Endpoint configuration to use in the
credential configuration stage. In our case it is bloody-gate-service.platform:1046
.
In your case you will get the same service with different port number (bloody-gate-service.platform:XXXX
).
Press Download Configuration to get configured OpenVPN configuration file
*.ovpn
which you must install in your local VPN client and start it.
Congratulations, you have established a secure VPN tunnel between your local resource and the platform. Now time to use this in your integration flow configuration.
Since we have used MongoDB for our example we will use the MongoDB component in the configuration of our integration flow. We will jump directly to the step configuration to show how to use the Agent.
Picture above shows the filled form for MongoDB credentials in the step configuration where couple of details should be considered:
MongoDB_local_conn
is online as indicative of the green dot beside the name.mongodb://bloody-gate-service.platform:1046
. You must not use the connection URL available on your local environment. The VPN gateway will take care of port forwarding for you.username/password
pair as you would use locally.And lastly Verify and Save your credential.
Congratulations, you are now ready to query your local database and use the results to process further.
You can always update your agent, get all the information you need about it, or just delete it using the appropriate API endpoints. All the necessary information about this you can find in our API documentation.