README

INTRODUCTION

The goal of sslcaudit project is to develop a utility to automate testing SSL/TLS
clients for resistance against MITM attacks. It might be useful for testing a thick
client, a mobile application, an appliance, pretty much anything communicating over
SSL/TLS over TCP.

INSTALLATION

There is no procedure for installation yet. Just grab the code:

* Download ZIP archive at https://github.com/grwl/sslcaudit/zipball/release_1_0_rc1
* Or clone leading edge master GIT repository: git clone git://github.com/grwl/sslcaudit.git
* Find sslcaudit in the top level directory and run it with -h option.

To terminate an instance of sslcaudit running on the console, press Ctrl-\.

PDF user guide is available under doc/ or online at
http://www.gremwell.com/sites/default/files/sslcaudit/doc/sslcaudit-guide-20120501.pdf,
you should consider reading it.

Sslcaudit uses M2Crypto Python library. If you dependencies problem, you might see
following:

	$ ./sslcaudit
	Traceback (most recent call last):
	...
	ImportError: No module named M2Crypto

On Debian system M2Crypto library can be installed with the following command:

	$ sudo apt-get install python-m2crypto

MORE INFORMATION

See doc/ folder for more information or run 'sslcaudit -h'.

LICENSING

GPLv3, see COPYING.TXT