Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Transparent and scalable SSL/TLS interception
C Other
Failed to load latest commit information.
extra Fix glob to be compatible with /bin/dash
xnu Explicitly support Yosemite 10.10.1 with XNU 2782.1.97
.gitattributes Add .gitattributes and cleanup .gitignore
.gitignore Add .gitattributes and cleanup .gitignore
.travis.yml Enable unit tests on Travis CI
BSDmakefile Initial import of sslsplit-0.4.2
GNUmakefile Record the actual XNU version detected
LICENSE Update copyright notices to 2014
NEWS.md SSLsplit 0.4.11 maintenance release
README.md Add local process lookup on FreeBSD using sysctl() API
attrib.h Update copyright notices to 2014
base64.c Lint fix: define some variables in smaller scope
base64.h Always explicitly name the non-null arguments
base64.t.c Update copyright notices to 2014
cache.c Lint fix: define some variables in smaller scope
cache.h Always explicitly name the non-null arguments
cachedsess.c Avoid casting !NULL to ptr types to silence clang
cachedsess.h Always explicitly name the non-null arguments
cachedsess.t.c Update copyright notices to 2014
cachefkcrt.c Avoid casting !NULL to ptr types to silence clang
cachefkcrt.h Always explicitly name the non-null arguments
cachefkcrt.t.c Update copyright notices to 2014
cachemgr.c Don't rely on OpenSSL to pull in string.h
cachemgr.h Update copyright notices to 2014
cachemgr.t.c Update copyright notices to 2014
cachessess.c Avoid casting !NULL to ptr types to silence clang
cachessess.h Always explicitly name the non-null arguments
cachessess.t.c Update copyright notices to 2014
cachetgcrt.c Avoid casting !NULL to ptr types to silence clang
cachetgcrt.h Always explicitly name the non-null arguments
cachetgcrt.t.c Update copyright notices to 2014
cert.c Update copyright notices to 2014
cert.h Always explicitly name the non-null arguments
cert.t.c Update copyright notices to 2014
dynbuf.c Update copyright notices to 2014
dynbuf.h Always explicitly name the non-null arguments
dynbuf.t.c Update copyright notices to 2014
khash.h Update khash.h to latest klib master
log.c Fix segmentation fault for aborted connections
log.h Improve error handling on logging calls
logbuf.c Move open() and mkdir() to logger thread
logbuf.h Move open() and mkdir() to logger thread
logger.c Move open() and mkdir() to logger thread
logger.h Improve error handling on logging calls
main.c Note that -j impacts -S and -F
main.t.c Detect when libevent cannot parse resolv.conf
nat.c Don't allow -u on Mac OS X with pf proxyspecs
nat.h Don't allow -u on Mac OS X with pf proxyspecs
opts.c Refactor SSL/TLS debug code
opts.h Rename flags for clarity
opts.t.c Update copyright notices to 2014
proc.c Add local process lookup on FreeBSD using sysctl() API
proc.h Fix version output on local procinfo availability
proxy.c Detect when libevent cannot parse resolv.conf
proxy.h Always explicitly name the non-null arguments
pxyconn.c Fix segmentation fault for aborted connections
pxyconn.h Always explicitly name the non-null arguments
pxysslshut.c Print status of free'd SSL structs in debug mode
pxysslshut.h Print status of free'd SSL structs in debug mode
pxythrmgr.c Zero allocated elements before initializing them
pxythrmgr.h Update copyright notices to 2014
pxythrmgr.t.c Add libevent2 test for the weirdness that is issue #17
ssl.c Fix loading of certificate chains with OpenSSL 1.0.2
ssl.h Fix SSL_METHOD* const mismatch on OpenSSL < 1.0.0
ssl.t.c Add unit tests for ssl_x509_subject() and ssl_x509_subject_cn()
sslsplit.1 Don't allow -u on Mac OS X with pf proxyspecs
sys.c Fixing error-case memory leaks in uid/gid lookups
sys.h Unify asprintf error handling
sys.t.c Fix compiler warning on type conversion
thrqueue.c Check return values of pthread_mutex_init and friends
thrqueue.h Always explicitly name the non-null arguments
url.c Update copyright notices to 2014
url.h Always explicitly name the non-null arguments
url.t.c Update copyright notices to 2014
util.c Update copyright notices to 2014
util.h Always explicitly name the non-null arguments
util.t.c Update copyright notices to 2014
version.c Rewrite Mac OS X support to use proper XNU headers
version.h Rewrite Mac OS X support to use proper XNU headers

README.md

SSLsplit - transparent and scalable SSL/TLS interception Build Status

Copyright (C) 2009-2014, Daniel Roethlisberger.
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. Depending on the version of OpenSSL, SSLsplit supports SSL 3.0, TLS 1.0, TLS 1.1 and TLS 1.2, and optionally SSL 2.0 as well. 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. For HTTP and HTTPS connections, SSLsplit removes response headers for HPKP in order to prevent public key pinning, for HSTS to allow the user to accept untrusted certificates, and Alternate Protocols to prevent switching to QUIC/SPDY.

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: pf rdr and ipfw fwd

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. For more build options see GNUmakefile.

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.

Contributors

The following individuals have contributed to the SSLsplit codebase by submitting patches or pull requests, in chronological order of first contribution:

  • Daniel Roethlisberger (@droe), main author
  • Steve Wills (@swills)
  • Landon Fuller (@landonf)
  • Wayne Jensen (@wjjensen)

See NEWS.md and git log for details.

Something went wrong with that request. Please try again.