| WarpGate Encrypted Tunnelling Service for Linux and Windows |
1.0 Introduction
WarpGate is a TCP/IP tunnelling service implementing a strong 256 bit encryption to create super secure Internet connections. It works with Linux and Windows and it can run as a normal application or as service/daemon. WarpGate is useful to create FTP, HTTP and TELNET encrypted connections in easy and transparent way.
1.1 How it works
WarpGate is able to manage more than one tunnels and each tunnel support more than one connection at the same time. It's substantially a port forwarder with an embedded encryption algorithm that can be enabled or disabled by the user. It can accept local and remote connection or local connection only.
Two WarpGates installed in the local host
and in the remote host encrypt the connection and decrypt locally the packets.
The server application must be accessible by local connection only and if it
doesn't have the direct support for the warp encryption protocol, it must be
protected by a firewall.
2.0 Installation & usage
WarpGate is included in the VEGA ZZ package and it's not installed using the standard setup settings. If you need it and the other Internet utilities, you must choose Warp utilities for secure Internet connection during the VEGA ZZ setup. Some versions are available:
All Linux executables are linked with libc 6.0.
2.1 Tunnelling configuration
When WarpGate starts, the warpgate.ini
file is read. This file must placed in the warpdata\cfg directory for all
versions with the exception of the Linux service daemons that require the file
in the /etc directory.
This is an example of a configuration file:
; WarpGate Configuration file ; Copyright 2006-2007, Alessandro Pedretti ; ; Local port Local conn. Remote host Remote port Type Key ; ======================================================================================================================================== 8000 Y myhost.mydomain.mycountry 7000 TCP E7A9E51B6A99E4F0B691A8DE7EC79F6ABF92D547F5CFC2D48E8367E59FC299C6
The lines starting with the semicolon are remarks. Each uncommented line defines a tunnelling rule and the syntax is:
LocalPort Flag RemoteHost RemotePort Type Key
where:
| LocalPort | This is the listening port: all connection to this port are forwarded to the RemotePort of the RemoteHost. If Flag is set to Y, the local connection are accepted only. | |
| Flag | Enable/disable (Y/N) the local
connections. Warning: If you set to N this flag, all remote clients can enter in the tunnel without restrictions ! |
|
| RemoteHost | Remote host address. It cold be in a numeric IP address or an alphanumeric DNS entry. | |
| RemotePort | It's the remote port to which the connection is forwarded. | |
| Type | It must be: TCP for generic TCP/IP port redirections (e.g. HTTP, TELNET, etc) or FTP for FTP client port redirection. | |
| Key | It's the encryption key. It must be randomly generated with the WarpKeyGen software and it must the same for the client and the host. If this parameter is omitted, WarpGate works as port forwarder without encryption. |
2.2 Running the Windows standard version
To run this version, select VEGA ZZ -> WarpProject -> WarpGate in the Start menu. The program starts in background without graphic interface, installing a small icon in the Windows try bar. Clicking on it with the right mouse button, the context menu is shown: the Exit menu item stops the WarpGate service closing it without a warning message.
2.3 Running the Windows service version
A Windows service (used to be called NT
service) is a console application, which does not have a message pump. A Windws
service can be started without the user having to login to the computer and it
won't die after the user logs off. The WarpGate service version works in
background and it doesn't have the graphic interface. Before running it, it must
be installed selecting VEGA ZZ -> WarpProject -> WarpGate Service -> Install
in the Start menu. To start the service, choose VEGA ZZ -> WarpProject
-> WarpGate Service -> Start. Restarting the system, the WarpGate is
automatically executed as the other services.
If you want stop the service, select VEGA ZZ -> WarpProject -> WarpTel
Service -> Stop. Please remember that when you reboot the system, the WarpGate
service is restarted.
The service version uses the same settings of the standard one, but if you change them, you
must stop (VEGA ZZ -> WarpProject -> WarpTel Service ->
Stop) and restart it (VEGA ZZ -> WarpProject
-> WarpGate Service -> Start).
To uninstall the service, choose VEGA ZZ -> WarpProject -> WarpGate Service ->
Uninstall.
2.4 Running the Linux standard version
This version can be executed as a normal Linux command typing warpgate in the command prompt. No command options are available.
2.5 Running the Linux daemon version
A daemon (or service) is a background process that is designed to run autonomously, with little or not user intervention. WarpGate (warpgated) can be started as Linux daemon when the system cam up, running in background. To configure the WarpGate daemon, you must follow these steps:
Assume the root rights.
Copy the warpgated executable in a system accessible directory (e.g. /usr/local/bin).
Copy the waprgate.ini file in the /etc directory.
Check the current runlevel, opening the /etc/inittab file and looking the id:X:initdefault line. X indicates the default runlevel (usually 5).
Change the current directory to /etc/rc.d/rcX.d, where X is the runlevel.
Create a soft link to warpgated:
ln -s /usr/local/bin/warpgated
S98warpgated
To start the service reboot the system or type /usr/local/bin/warpgated
3.0 History
4.0 Copyright and disclaimers
All trademarks and software directly or indirectly referred in this document, are copyrighted from legal owners. WarpGate is a freeware program and can be spread through Internet, BBS, CD-ROM and other electronic formats. The Authors of this program accept no responsibility for hardware/software damages resulting from the use of this package. No warranty is made about the software or its performance.
Use and copying of this software and the preparation of derivative works based on this software are permitted, so long as the following conditions are met:
The copyright notice and this entire notice are included intact and prominently carried on all copies and supporting documentation.
No fees or compensation are charged for use, copies, or access to this software. You may charge a nominal distribution fee for the physical act of transferring a copy, but you may not charge for the program itself.
If you want include the WarpGate package into a commercial file collection, you must send a written request. The Authors can accept or deny the request on their own decision.
If you change the source code to improve the WarpGate performances, please contact the authors to add your modifications in the official package.
Any work distributed or published that in whole or in part contains or is a derivative of this software or any part thereof is subject to the terms of this agreement. The aggregation of another unrelated program with this software or its derivative on a volume of storage or distribution medium does not bring the other program under the scope of these terms.
WarpGate
is an encrypted tunnelling service for Linux and Windows
Copyright 2006-2007, Alessandro Pedretti & Giulio Vistoli
All rights reserved.
Alessandro Pedretti
Istituto di Chimica Farmaceutica e Tossicologica "Pietro Pratesi"
Università degli Studi di Milano
Viale Abruzzi, 42
I-20131 Milano - Italy
Tel. +39 02 503 17522
Fax. +39 02 503 17565
E-Mail: alessandro.pedretti@unimi.it
WWW: http://www.ddl.unimi.it