Online Help > Entry Types > Common Settings

Entry Types VPN Settings



A VPN connection can be configured in the session properties, in the VPN section. The connection can be established automatically, manually or when a specific condition is met.


There are multiple natively supported VPN connection types and many more are available through add-ons. Please consult VPN Add-ons for more information.


Many organizations configure their devices to channel ALL traffic through the VPN. This may have a nasty side effect of breaking connectivity to your datasource. When you are subject to this constraint, it is best to enable the Offline Mode in your datasource, then configure your VPN options to automatically Go offline on connection as can be seen in the Advanced section below.


Although you can define your VPN details inside your session, it is a best practice to link it to an already existing VPN session. Please refer to Link To Existing Session for more information.




VPN side menu

VPN side menu


Each VPN type has its own set of properties to configure and you must know them in order to properly configure them.


VPN Opening mode




No VPN will be executed when the session is launched.

Always connect

Opens the VPN each time the session is launched.


The VPN is configured, but it must be opened manually from the session context menu or the dashboard.

Connect if unable to ping/port scan

The application will try to ping the host or a configured address. If unable to reach the host, the VPN will be opened before launching the session.


Will connect using VPN configured in the parent entry.

Ask for confirmation

Ask for a confirmation before opening the VPN.

Connect if network adapter not found

Connect using VPN if the network adapter is not found.

Prompt if unable to ping/scan

If unable to ping the server then prompt to open the VPN.


VPN Closing mode

These options are available if you have chosen Always connect or Connect if unable to ping in the VPN Opening mode.




On session close

Close the VPN as soon as it detects that the session is closed. However, some session type closes event cannot be detected, and as such the VPN must be closed manually.

Manually later

The VPN must be closed manually from either the session context menu or the dashboard.

Confirm disconnect

The application will ask for a confirmation before closing the VPN when it detects that the current session is terminated.


VPN Group

Please consult VPN Group topic for more information.


VPN Type

Select which type of VPN you wish to configure inside your session. There are multiple natively supported VPN connection types and many more are available through add-ons. Please consult VPN Add-ons for more information.






The VPN will use the credentials setup in the VPN tab.

Credential repository

Consult Credentials topic for more information.

My Personal credential

Consult My Personal Credentials topic for more information.


No credentials are defined for the entry, you will be prompted for credentials every time you connect.


Installation Path

You can manually configure your VPN installation path. To use the default installation path, leave the field empty.


Installation Path

Installation Path




Define the VPN settings in this tab. Enter the VPN name and the credentials to properly connect to your VPN.





VPN with Phonebook

You can configure a Phonebook inside a VPN entry. This VPN entry can use the Default Phone book, a specific Phone book, an embedded Phone book or a reference to a type of Phone book document.


This is only supported by the Microsoft VPN.


Please consult Phonebook topic for more information.







The Go Offline on connection and Go Online on disconnect are essential when all traffic is tunneled through the VPN, which has the side effect of loosing connectivity to the datasource. Obviously, the datasource must have been configured to allow for Offline availability.




Go Offline on connection

The session will go offline once connected to the VPN.

Go Online on disconnect

The session will go back online once disconnected from the VPN.

Use adapter to detect connection

Will use the adapter to detect the VPN connection.

Close connection after

Will close the VPN connection after the number of minutes indicated.

Detect reachable host in wait

Automatically close the VPN wait dialog when the host is reachable.


After execute wait

By selecting After execute wait - For IP on adapter, this specifies that RDM will wait until the given adapter has acquired a valid IP. In most cases leave the field next to it blank. Blank specifies that RDM will use the VPN name as the adapter name, works with most VPN's where the VPN is the adapter. The wait maximum of -1sec specifies the time out in seconds that RDM will wait for the adapter. -1 is wait forever, if ever you have specified the wrong adapter name, the -1 option may hang the system.



With custom commands you can execute any command after the VPN connect or/and before VPN disconnect. The possibilities are endless.