Wiki -VoIP Topics

VoIP Tunneling Client


The mvoiptunnel can be integrated with third party softphones.

Download from here.


You will find two version (mvoiptunnel.exe and mvoiptunnel_dbg.exe).
One release version used for prodution.
Another debug version suffixed with _dbg which can be used if you have any issue to check the logs.


Changes needed in your softphone:

  -add the mvoiptunel.exe, mvoiptunelcfg.ini and zlib1.dll to the softphone install package (eventually enabling mvoiptunel.exe on the firewall from install scripts ..if you have such functionality)

  -change the server address configuration as described below

      softphone localport: anything but if possibile use 127.0.0.1:54063

      softphone remoteaddress (sip server address): 127.0.0.1:55063

  -start the mvoiptunel.exe on startup and stop it on exit


Starting / stopping the mvoiptunel application

To start it you can use:

ShellExecute(NULL, "open",”mvoiptunel.exe”, NULL, NULL, SW_HIDE);

or the CreateProcess winapi function (this is better because you can get a handle that can be used for monitoring and to stop the program)

To stop you have several options:

search for the window caption (“mvoiptunel”) using FindWindow and post a WM_CLOSE message with PostMessage

TerminateProcess()  with handle obtained from CreateProcess

kill the process: find it with Process32First- Process32Next and then call TerminateProcess

kill with the taskkill /IM mvoiptunel.exe /F command

 

The application will need around 3 seconds to start and also to stop.




mvoiptunelcfg.ini configuration:

[SipSettings]
VPNSERVERDOMAIN=SERVERDOMAIN:SERVERPORT (address -ip or domain name- and port of the tunneling server)
VPNSERVERADDRESS=SERVERDOMAIN  (address -ip or domain name- of the tunneling server)
VPNSERVERIP=SERVERIP  (used if the server ip cannot be loaded from VPNSERVERADDRESS. for example on dns errors)
alternatelocalports=list of ports (a few alternative base ports. these are only base ports. other ports will be derived from these)
VPNSERVERPORT=SERVERPORT (port of the tunneling server)

Example configuration:
[SipSettings]
VPNSERVERDOMAIN=mydomain.com:11111
VPNSERVERADDRESS=mydomain.com
VPNSERVERIP=1.2.3.4
alternatelocalports=11424,23458,398741
VPNSERVERPORT=11111

 

Service

The mtunnelsrv can be run as a windows NT service to handle the tunneling needs for a local network.

All client devices (softphone's, ATA's, ip phones) must connect to this service on the local network which will forward the transport to the VoIP tunneling server using encryption and tunneling.

The same inifile format have to be used like for the application.

Install it by launching with -install switch.
(In the command prompt type mtunnelsrv.exe -install)

 

VoIP tunneling