Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Zorp GPL
C Python Other

This branch is 19 commits ahead, 12 commits behind kkovaacs:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
archived-changelog/3.3
doc
lib
libproxy
modules
pylib
scripts
tests
zorp
zorpctl
.gitignore
AUTHORS
BUGS
COPYING
INSTALL
Makefile.am
README
VERSION
WHATIS.TXT
autogen.sh
configure.in
dist.conf
module.list
zorp-config.in
zorpconfig.h.in

README

This is Zorp, welcome.
----------------------

Zorp is a new generation proxy firewall suite making it possible to finetune
proxy decisions (with its built in script language), to fully analyze
complex protocols (like SSH with several forwarded TCP connections), and to
utilize outband authentication techniques (unlike common practices where
proxy authentication had to be hacked into the protocol). 

Quickstarting Zorp
------------------

After installing zorp (described in the file INSTALL), you have to
come up with a policy.py file, which may not be the easiest thing to
do at first time. 

A sample policy file is provided named /etc/zorp/policy.py.sample to
be renamed to /etc/zorp/policy.py after local modifications are
applied.

You will need to modify the zone declaration (the beginning of the file),
to fit your network architecture. A zone in Zorp is a IP address range, and
is the basis of access control. Each zone may define the services which is
allowed to go into, and out of the zone.

As your policy file is in place, you'll need to add a new entry to your
$prefix/etc/zorp/instances.conf file, like this:

# excerpt from /etc/zorp/instances.conf
zorp_plug --policy /usr/local/etc/zorp/policy-plug.py

The first word is the instance name to start, and the rest are the
parameters to add to the zorp command line.

If you are done, you can now try to start your first Zorp instance using
zorpctl:

zorpctl start zorp_plug

if you leave the instance name empty, all instances are started. 

Documentation
-------------

You can find the Zorp Tutorial in doc/zorp-tutorial.html which describes the
GPLd version of Zorp, and a more comprehensive documentation for the
commercial version which is available at

http://www.balabit.com/support/documentation/
Something went wrong with that request. Please try again.