|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| .github/ | H | 30-Aug-2019 | - | 27 | 21 |
| Mk/ | H | 30-Aug-2019 | - | 405 | 319 |
| docker/sslsplit/ | H | 30-Aug-2019 | - | 20 | 17 |
| extra/ | H | 30-Aug-2019 | - | 738 | 483 |
| xnu/ | H | 30-Aug-2019 | - | 203,992 | 167,195 |
| AUTHORS.md | H A D | 30-Aug-2019 | 1.8 KiB | 40 | 32 |
| BSDmakefile | H A D | 30-Aug-2019 | 56 | 7 | 4 |
| GNUmakefile | H A D | 30-Aug-2019 | 19 KiB | 633 | 417 |
| HASHES | H A D | 30-Aug-2019 | 3.7 KiB | 74 | 73 |
| LICENSE | H A D | 30-Aug-2019 | 1.3 KiB | 25 | 21 |
| LICENSE.contrib | H A D | 30-Aug-2019 | 627 | 11 | 9 |
| LICENSE.third | H A D | 30-Aug-2019 | 727 | 28 | 18 |
| NEWS.md | H A D | 30-Aug-2019 | 13.3 KiB | 274 | 223 |
| README.md | H A D | 30-Aug-2019 | 5.2 KiB | 122 | 87 |
| SECURITY.md | H A D | 30-Aug-2019 | 510 | 13 | 9 |
| VERSION | H A D | 30-Aug-2019 | 6 | 2 | 1 |
| attrib.h | H A D | 30-Aug-2019 | 2.7 KiB | 74 | 21 |
| base64.c | H A D | 30-Aug-2019 | 6.1 KiB | 190 | 132 |
| base64.h | H A D | 30-Aug-2019 | 1.7 KiB | 42 | 7 |
| base64.t.c | H A D | 30-Aug-2019 | 8.5 KiB | 354 | 269 |
| build.c | H A D | 30-Aug-2019 | 1.8 KiB | 42 | 6 |
| build.h | H A D | 30-Aug-2019 | 1.7 KiB | 41 | 8 |
| cache.c | H A D | 30-Aug-2019 | 4 KiB | 170 | 106 |
| cache.h | H A D | 30-Aug-2019 | 3.2 KiB | 85 | 45 |
| cachedsess.c | H A D | 30-Aug-2019 | 5.8 KiB | 235 | 167 |
| cachedsess.h | H A D | 30-Aug-2019 | 1.9 KiB | 49 | 12 |
| cachedsess.t.c | H A D | 30-Aug-2019 | 5.4 KiB | 181 | 125 |
| cachefkcrt.c | H A D | 30-Aug-2019 | 4.4 KiB | 184 | 121 |
| cachefkcrt.h | H A D | 30-Aug-2019 | 1.8 KiB | 45 | 9 |
| cachefkcrt.t.c | H A D | 30-Aug-2019 | 4.1 KiB | 148 | 99 |
| cachemgr.c | H A D | 30-Aug-2019 | 4.6 KiB | 170 | 101 |
| cachemgr.h | H A D | 30-Aug-2019 | 3.6 KiB | 90 | 52 |
| cachemgr.t.c | H A D | 30-Aug-2019 | 1.9 KiB | 60 | 22 |
| cachessess.c | H A D | 30-Aug-2019 | 4.9 KiB | 205 | 140 |
| cachessess.h | H A D | 30-Aug-2019 | 1.8 KiB | 46 | 10 |
| cachessess.t.c | H A D | 30-Aug-2019 | 5.2 KiB | 186 | 130 |
| cachetgcrt.c | H A D | 30-Aug-2019 | 4 KiB | 162 | 103 |
| cachetgcrt.h | H A D | 30-Aug-2019 | 1.8 KiB | 44 | 9 |
| cachetgcrt.t.c | H A D | 30-Aug-2019 | 4 KiB | 142 | 93 |
| cert.c | H A D | 30-Aug-2019 | 4.8 KiB | 222 | 153 |
| cert.h | H A D | 30-Aug-2019 | 2.2 KiB | 58 | 22 |
| cert.t.c | H A D | 30-Aug-2019 | 2.7 KiB | 92 | 48 |
| defaults.h | H A D | 30-Aug-2019 | 3.8 KiB | 98 | 10 |
| defaults.t.c | H A D | 30-Aug-2019 | 3 KiB | 94 | 48 |
| dynbuf.c | H A D | 30-Aug-2019 | 3.3 KiB | 139 | 75 |
| dynbuf.h | H A D | 30-Aug-2019 | 1.9 KiB | 50 | 14 |
| dynbuf.t.c | H A D | 30-Aug-2019 | 4 KiB | 146 | 95 |
| khash.h | H A D | 30-Aug-2019 | 21 KiB | 628 | 290 |
| log.c | H A D | 30-Aug-2019 | 45 KiB | 1,845 | 1,502 |
| log.h | H A D | 30-Aug-2019 | 4.1 KiB | 105 | 65 |
| logbuf.c | H A D | 30-Aug-2019 | 5.8 KiB | 276 | 192 |
| logbuf.h | H A D | 30-Aug-2019 | 2.8 KiB | 71 | 32 |
| logbuf.t.c | H A D | 30-Aug-2019 | 2.2 KiB | 67 | 28 |
| logger.c | H A D | 30-Aug-2019 | 9 KiB | 365 | 220 |
| logger.h | H A D | 30-Aug-2019 | 3.3 KiB | 75 | 39 |
| logpkt.c | H A D | 30-Aug-2019 | 26.2 KiB | 844 | 650 |
| logpkt.h | H A D | 30-Aug-2019 | 2.6 KiB | 71 | 35 |
| main.c | H A D | 30-Aug-2019 | 28.2 KiB | 918 | 784 |
| main.t.c | H A D | 30-Aug-2019 | 3.4 KiB | 117 | 75 |
| nat.c | H A D | 30-Aug-2019 | 16.5 KiB | 678 | 482 |
| nat.h | H A D | 30-Aug-2019 | 2.2 KiB | 60 | 22 |
| opts.c | H A D | 30-Aug-2019 | 41.2 KiB | 1,708 | 1,496 |
| opts.h | H A D | 30-Aug-2019 | 7.6 KiB | 204 | 162 |
| opts.t.c | H A D | 30-Aug-2019 | 18 KiB | 591 | 514 |
| privsep.c | H A D | 30-Aug-2019 | 27.3 KiB | 1,059 | 856 |
| privsep.h | H A D | 30-Aug-2019 | 1.8 KiB | 45 | 10 |
| proc.c | H A D | 30-Aug-2019 | 10.8 KiB | 463 | 325 |
| proc.h | H A D | 30-Aug-2019 | 2.6 KiB | 66 | 28 |
| proxy.c | H A D | 30-Aug-2019 | 11.1 KiB | 440 | 320 |
| proxy.h | H A D | 30-Aug-2019 | 1.8 KiB | 45 | 10 |
| pxyconn.c | H A D | 30-Aug-2019 | 75.4 KiB | 2,625 | 2,079 |
| pxyconn.h | H A D | 30-Aug-2019 | 1.9 KiB | 49 | 13 |
| pxythrmgr.c | H A D | 30-Aug-2019 | 7.4 KiB | 291 | 190 |
| pxythrmgr.h | H A D | 30-Aug-2019 | 2 KiB | 54 | 16 |
| pxythrmgr.t.c | H A D | 30-Aug-2019 | 3.6 KiB | 130 | 82 |
| ssl.c | H A D | 30-Aug-2019 | 65.4 KiB | 2,365 | 1,757 |
| ssl.h | H A D | 30-Aug-2019 | 9.3 KiB | 271 | 179 |
| ssl.t.c | H A D | 30-Aug-2019 | 26.9 KiB | 892 | 749 |
| sslsplit.1.in | H A D | 30-Aug-2019 | 37.4 KiB | 859 | 827 |
| sslsplit.conf.5.in | H A D | 30-Aug-2019 | 7.9 KiB | 210 | 183 |
| sslsplit.conf.in | H A D | 30-Aug-2019 | 6 KiB | 191 | 149 |
| sys.c | H A D | 30-Aug-2019 | 23 KiB | 1,046 | 781 |
| sys.h | H A D | 30-Aug-2019 | 3.1 KiB | 80 | 36 |
| sys.t.c | H A D | 30-Aug-2019 | 8.4 KiB | 377 | 293 |
| thrqueue.c | H A D | 30-Aug-2019 | 6 KiB | 230 | 137 |
| thrqueue.h | H A D | 30-Aug-2019 | 2.1 KiB | 51 | 14 |
| url.c | H A D | 30-Aug-2019 | 4.2 KiB | 123 | 77 |
| url.h | H A D | 30-Aug-2019 | 1.6 KiB | 41 | 6 |
| url.t.c | H A D | 30-Aug-2019 | 3.4 KiB | 136 | 83 |
| util.c | H A D | 30-Aug-2019 | 1.7 KiB | 46 | 6 |
| util.h | H A D | 30-Aug-2019 | 1.6 KiB | 41 | 6 |
| util.t.c | H A D | 30-Aug-2019 | 3.1 KiB | 122 | 72 |
README.md
1# SSLsplit - transparent SSL/TLS interception
2https://www.roe.ch/SSLsplit
3
4[![Build Status](https://travis-ci.org/droe/sslsplit.svg)](https://travis-ci.org/droe/sslsplit)
5[![Gitter chat](https://badges.gitter.im/droe/sslsplit.png)](https://gitter.im/droe/sslsplit)
6
7## Overview
8
9SSLsplit is a tool for man-in-the-middle attacks against SSL/TLS encrypted
10network connections. It is intended to be useful for network forensics,
11application security analysis and penetration testing.
12
13SSLsplit is designed to transparently terminate connections that are redirected
14to it using a network address translation engine. SSLsplit then terminates
15SSL/TLS and initiates a new SSL/TLS connection to the original destination
16address, while logging all data transmitted. Besides NAT based operation,
17SSLsplit also supports static destinations and using the server name indicated
18by SNI as upstream destination. SSLsplit is purely a transparent proxy and
19cannot act as a HTTP or SOCKS proxy configured in a browser.
20
21SSLsplit supports plain TCP, plain SSL, HTTP and HTTPS connections over both
22IPv4 and IPv6. It also has the ability to dynamically upgrade plain TCP to SSL
23in order to generically support SMTP STARTTLS and similar upgrade mechanisms.
24SSLsplit fully supports Server Name Indication (SNI) and is able to work with
25RSA, DSA and ECDSA keys and DHE and ECDHE cipher suites. Depending on the
26version of OpenSSL built against, SSLsplit supports SSL 3.0, TLS 1.0, TLS 1.1
27and TLS 1.2, and optionally SSL 2.0 as well.
28
29For SSL and HTTPS connections, SSLsplit generates and signs forged X509v3
30certificates on-the-fly, mimicking the original server certificate's subject
31DN, subjectAltName extension and other characteristics. SSLsplit has the
32ability to use existing certificates of which the private key is available,
33instead of generating forged ones. SSLsplit supports NULL-prefix CN
34certificates but otherwise does not implement exploits against specific
35certificate verification vulnerabilities in SSL/TLS stacks.
36
37SSLsplit implements a number of defences against mechanisms which would
38normally prevent MitM attacks or make them more difficult. SSLsplit can deny
39OCSP requests in a generic way. For HTTP and HTTPS connections, SSLsplit
40mangles headers to prevent server-instructed public key pinning (HPKP), avoid
41strict transport security restrictions (HSTS), avoid Certificate Transparency
42enforcement (Expect-CT) and prevent switching to QUIC/SPDY, HTTP/2 or
43WebSockets (Upgrade, Alternate Protocols). HTTP compression, encodings and
44keep-alive are disabled to make the logs more readable.
45
46Logging options include traditional SSLsplit connect and content log files as
47well as PCAP files and mirroring decrypted traffic to a network interface.
48Additionally, certificates, master secrets and local process information can be
49logged.
50
51See the manual page sslsplit(1) for details on using SSLsplit and setting up
52the various NAT engines.
53
54
55## Requirements
56
57SSLsplit depends on the OpenSSL, libevent 2.x, libpcap and libnet 1.1.x
58libraries by default; libpcap and libnet are not needed if the mirroring
59feature is omitted. The build depends on GNU make and a POSIX.2 environment in
60`PATH`. If available, pkg-config is used to locate and configure the
61dependencies. The optional unit tests depend on the check library.
62
63SSLsplit currently supports the following operating systems and NAT mechanisms:
64
65- FreeBSD: pf rdr and divert-to, ipfw fwd, ipfilter rdr
66- OpenBSD: pf rdr-to and divert-to
67- Linux: netfilter REDIRECT and TPROXY
68- Mac OS X: pf rdr and ipfw fwd
69
70Support for local process information (`-i`) is currently available on Mac OS X
71and FreeBSD.
72
73SSL/TLS features and compatibility greatly depend on the version of OpenSSL
74linked against. For optimal results, use a recent release of OpenSSL or
75LibreSSL.
76
77
78## Installation
79
80With the requirements above available, run:
81
82 make
83 make test # optional unit tests
84 make sudotest # optional unit tests requiring privileges
85 make install # optional install
86
87Dependencies are autoconfigured using pkg-config. If dependencies are not
88picked up and fixing `PKG_CONFIG_PATH` does not help, you can specify their
89respective locations manually by setting `OPENSSL_BASE`, `LIBEVENT_BASE`,
90`LIBPCAP_BASE`, `LIBNET_BASE` and/or `CHECK_BASE` to the respective prefixes.
91
92You can override the default install prefix (`/usr/local`) by setting `PREFIX`.
93For more build options and build-time defaults see [`GNUmakefile`](GNUmakefile)
94and [`defaults.h`](defaults.h).
95
96
97## Documentation
98
99See the manual pages `sslsplit(1)` and `sslsplit.conf(5)` for user
100documentation. See [`NEWS.md`](NEWS.md) for release notes listing significant
101changes between releases and [`SECURITY.md`](SECURITY.md) for information on
102security vulnerability disclosure.
103
104
105## License
106
107SSLsplit is provided under a 2-clause BSD license.
108SSLsplit contains components licensed under the MIT and APSL licenses.
109See [`LICENSE`](LICENSE), [`LICENSE.contrib`](LICENSE.contrib) and
110[`LICENSE.third`](LICENSE.third) as well as the respective source file headers
111for details.
112
113
114## Credits
115
116See [`AUTHORS.md`](AUTHORS.md) for the list of contributors.
117
118SSLsplit was inspired by `mitm-ssl` by Claes M. Nyberg and `sslsniff` by Moxie
119Marlinspike, but shares no source code with them.
120
121
122