Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Transparent and scalable SSL/TLS interception

branch: master

No longer chroot() by default when run as root

No longer implicitly use -j /var/empty by default and document clearly
the implications of using -j with -S and/or sni proxyspecs.

Issue:		#21
latest commit 3226d9bfcf
Daniel Roethlisberger authored
Octocat-spinner-32 extra Fix glob to be compatible with /bin/dash January 29, 2014
Octocat-spinner-32 xnu Add experimental support for pf on Mac OS X January 10, 2014
Octocat-spinner-32 .gitattributes Add .gitattributes and cleanup .gitignore January 14, 2014
Octocat-spinner-32 .gitignore Add .gitattributes and cleanup .gitignore January 14, 2014
Octocat-spinner-32 .travis.yml Enable unit tests on Travis CI July 03, 2013
Octocat-spinner-32 BSDmakefile Initial import of sslsplit-0.4.2 April 13, 2012
Octocat-spinner-32 GNUmakefile Remove duplicates from FEATURES January 14, 2014
Octocat-spinner-32 LICENSE Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 NEWS No longer chroot() by default when run as root January 30, 2014
Octocat-spinner-32 README Update README for the APSL components January 14, 2014
Octocat-spinner-32 TODO Also build ipfw if pf is detected December 23, 2013
Octocat-spinner-32 attrib.h Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 base64.c Lint fix: define some variables in smaller scope January 14, 2014
Octocat-spinner-32 base64.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 base64.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cache.c Lint fix: define some variables in smaller scope January 14, 2014
Octocat-spinner-32 cache.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 cachedsess.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachedsess.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 cachedsess.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachefkcrt.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachefkcrt.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 cachefkcrt.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachemgr.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachemgr.h Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachemgr.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachessess.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachessess.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 cachessess.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachetgcrt.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cachetgcrt.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 cachetgcrt.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cert.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 cert.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 cert.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 dynbuf.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 dynbuf.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 dynbuf.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 khash.h Update khash to 0.2.8 January 10, 2014
Octocat-spinner-32 log.c Lint fix: define some variables in smaller scope January 14, 2014
Octocat-spinner-32 log.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 logbuf.c Lint fix: define some variables in smaller scope January 14, 2014
Octocat-spinner-32 logbuf.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 logger.c Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 logger.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 main.c No longer chroot() by default when run as root January 30, 2014
Octocat-spinner-32 main.t.c Detect when libevent cannot parse resolv.conf January 15, 2014
Octocat-spinner-32 nat.c Also undefine rdport in Mac pf support hack January 10, 2014
Octocat-spinner-32 nat.h Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 opts.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 opts.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 opts.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 proxy.c Detect when libevent cannot parse resolv.conf January 15, 2014
Octocat-spinner-32 proxy.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 pxyconn.c Fix segmentation fault when using -t without a CA January 30, 2014
Octocat-spinner-32 pxyconn.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 pxysslshut.c Print status of free'd SSL structs in debug mode January 11, 2014
Octocat-spinner-32 pxysslshut.h Print status of free'd SSL structs in debug mode January 11, 2014
Octocat-spinner-32 pxythrmgr.c Add some error-case debug messages to pxy_thrmgr_run() January 15, 2014
Octocat-spinner-32 pxythrmgr.h Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 pxythrmgr.t.c Add libevent2 test for the weirdness that is issue #17 January 15, 2014
Octocat-spinner-32 ssl.c Fix memory leak in fake cert generation code January 13, 2014
Octocat-spinner-32 ssl.h Print status of free'd SSL structs in debug mode January 11, 2014
Octocat-spinner-32 ssl.t.c Lint fix: define some variables in smaller scope January 14, 2014
Octocat-spinner-32 sslsplit.1 No longer chroot() by default when run as root January 30, 2014
Octocat-spinner-32 sys.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 sys.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 sys.t.c Add unit test for sys_dir_eachfile() January 29, 2014
Octocat-spinner-32 thrqueue.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 thrqueue.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 url.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 url.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 url.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 util.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 util.h Always explicitly name the non-null arguments January 06, 2014
Octocat-spinner-32 util.t.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 version.c Update copyright notices to 2014 January 06, 2014
Octocat-spinner-32 version.h Update copyright notices to 2014 January 06, 2014
README
SSLsplit - transparent and scalable SSL/TLS interception
Copyright (C) 2009-2014, Daniel Roethlisberger <daniel@roe.ch>
http://www.roe.ch/SSLsplit


## Overview

SSLsplit is a tool for man-in-the-middle attacks against SSL/TLS encrypted
network connections.  Connections are transparently intercepted through a
network address translation engine and redirected to SSLsplit.  SSLsplit
terminates SSL/TLS and initiates a new SSL/TLS connection to the original
destination address, while logging all data transmitted.  SSLsplit is intended
to be useful for network forensics and penetration testing.

SSLsplit supports plain TCP, plain SSL, HTTP and HTTPS connections over both
IPv4 and IPv6.  For SSL and HTTPS connections, SSLsplit generates and signs
forged X509v3 certificates on-the-fly, based on the original server certificate
subject DN and subjectAltName extension.  SSLsplit fully supports Server Name
Indication (SNI) and is able to work with RSA, DSA and ECDSA keys and DHE and
ECDHE cipher suites.  SSLsplit can also use existing certificates of which the
private key is available, instead of generating forged ones.  SSLsplit supports
NULL-prefix CN certificates and can deny OCSP requests in a generic way.
SSLsplit removes HPKP response headers in order to prevent public key pinning.

See the manual page sslsplit(1) for details on using SSLsplit and setting up
the various NAT engines.


## Requirements

SSLsplit depends on the OpenSSL and libevent 2.x libraries.
The build depends on GNU make and a POSIX.2 environment in `PATH`.
The optional unit tests depend on the check library.

SSLsplit currently supports the following operating systems and NAT mechanisms:
-   FreeBSD: pf rdr and divert-to, ipfw fwd, ipfilter rdr
-   OpenBSD: pf rdr-to and divert-to
-   Linux: netfilter REDIRECT and TPROXY
-   Mac OS X: ipfw fwd and pf rdr (experimental)


## Installation

    make
    make test       # optional unit tests
    make install    # optional install

Dependencies are autoconfigured using pkg-config.  If dependencies are not
picked up and fixing `PKG_CONFIG_PATH` does not help, you can specify their
respective locations manually by setting `OPENSSL_BASE`, `LIBEVENT_BASE` and/or
`CHECK_BASE` to the respective prefixes.

You can override the default install prefix (`/usr/local`) by setting `PREFIX`.


## Development

SSLsplit is being developed on Github.  For bug reports, please use the Github
issue tracker.  For patch submissions, please send me pull requests.

https://github.com/droe/sslsplit


## License

SSLsplit is provided under the simplified BSD license.
SSLsplit contains components licensed under the MIT and APSL licenses.
See the respective source file headers for details.


## Credits

SSLsplit was inspired by mitm-ssl by Claes M. Nyberg and sslsniff by Moxie
Marlinspike, but shares no source code with them.

SSLsplit includes khash.h by Attractive Chaos.


Something went wrong with that request. Please try again.