More TLS software
-
Rebex TLS library
TLS client and server .NET library
-
Rebex FTP/SSL library
FTP and FTP/SSL client library
-
Rebex HTTPS library
for modern and legacy platorms
Rebex TLS Proxy is a simple yet powerful TLS server with rich command-line interface. It makes it possible to easily add TLS 1.3/1.2 encryption to existing servers (using HTTP and other protocols), or operate as a TLS 1.0/1.1 proxy for legacy client applications or operating systems with no TLS 1.3/1.2 support.
It's free for commercial and non-commercial use.
Rebex TLS Proxy is built on top of our Rebex TLS library, which is based on our tried-and-tested TLS core that has been powering Rebex FTP/SSL since 2004.
Download
Checksums of RebexTlsProxy-v1.6.1.zip file:
SHA-1: f9bef0391171512a7236ef1c9a3716c5dfb9fb29
SHA-256: 23bf7f0ed904a0e05431f9491e0d097b9c205db2f811adcd1ae33db22d85c3f9
See here how to verify checksums of the installation package.
Getting started
- Download the ZIP package.
- Unzip it into the directory of your choice.
- Run
tlsproxy install
to install and configure the service. - Run
tlsproxy
to show a list of supported commands, or check out an example below. - Configure logging by editing
Config/config.yaml
file. -
Add some tunnels using
tlsproxy tunnel add
command.
Runtlsproxy tunnel add --help
to display possible options. - After each change, restart the service by running
tlsproxy svc restart
. - To run TLS Proxy in interactive mode, execute
tlsproxy run
(make sure to stop the service first).
Features
Rebex TLS Proxy features include:
- TLS encryption wrapper mode - adding TLS layer to non-TLS services
- TLS decryption wrapper mode - acting as non-TLS endpoint for TLS services
- TLS adapter wrapper mode - adding TLS layer to TLS services that run a different version of TLS
- TLS 1.3, 1.2, 1.1 and 1.0 on all supported platforms
- Fully asynchronous TLS core
- Unlimited number of connections
- Rich and easy-to-use command line interface
- Self-signed certificate issuer
- Elliptic Curve DSA and Elliptic Curve Diffie-Hellman key exchange
- AES/GCM AEAD symmetric encryption
- SHA-256, SHA-384 and SHA-512 hashing algorithms
- Dozens of modern and legacy TLS ciphers (see Rebex TLS for a list)
- Renegotiation Indication extension (TLS 1.2)
- PSK resumption (all modes) (
pre_shared_key
TLS 1.3 extension) - HelloRetryRequest support (TLS 1.3)
key_share
extension (TLS 1.3)- Middlebox Compatibility Mode support (TLS 1.3)
secp256r1
(NIST P-256),secp384r1
(NIST P-384),secp521r1
(NIST P-521),X25519
and Brainpool elliptic curves- RSASSA-PKCS1-v1_5, RSASSA-PSS and ECDSA signature schemes
- Support for deprecated SSL 3.0 protocol (disabled by default)
- Support for SNI (Server Name Indication)
- HTTP communication parser (insert/modify
Host
,X-Real-IP
,X-Forwarded-For
request headers)
Example #1 - Add HTTPS encryption (with TLS 1.3/1.2) to an HTTP server
This is the most common usage scenario. Let's say you have a legacy HTTP server running in your DMZ that only supports plain HTTP and HTTPS with TLS 1.0, and that your router is configured to make the HTTPS service accessible to the Internet on port 443.
But TLS 1.0 is rapidly getting deprecated (along with TLS 1.1) by major browsers, and unless you provide TLS 1.3 or TLS 1.2 support, clients will soon be unable to access the legacy HTTP server. Rebex TLS Proxy can help here - install it either alongside the old server, or onto a separate server in your DMZ, and configure it to provide a TLS tunnel with TLS 1.3/1.2 support to your old HTTP server (running at 192.168.1.2, for example):
tlsproxy tunnel add --in 0.0.0.0:443 --in-protocol TLS --out 192.168.1.2:80 --certificate-path c:\data\my-server-cert.pfx
This will make Rebex TLS Proxy accept TLS connections using TLS 1.3 and 1.2 on port 443. Once each connection has been accepted and a secure TLS session negotiated, the proxy will connect to port 80 of 192.168.1.2 (the old HTTP server) and pass all traffic between the client and the server. Once you configure your router to pass HTTPS connections to Rebex TLS Proxy instead of your old server, clients that no longer support TLS 1.0 or 1.1 will be able to connect again.
Note: Since TLS encryption is now provided by Rebex TLS Proxy, you also need to make an appropriate certificate available to it. In the sample above, we used a certificate stored in a .PFX file. In practice, using Windows Certificate Store might be a better option.
Example #2 - Virtual hosting for HTTPS websites
On HTTP servers, several websites can be hosted on the same IP address. The proper "virtual web" is chosen according to Host
header in the HTTP request.
A similar technology is also available for TLS (and HTTPS) protocol.
It is provided via Server Name Indication extension (SNI).
If your TLS Proxy runs on one specific IP address, you can easily configure it to provide HTTPS access to several HTTP websites:
tlsproxy tunnel add -i :443 --in-protocol TLS -o 192.168.1.1:80 -c example1.com --server-names example1.com,www.example1.com
tlsproxy tunnel add -i :443 --in-protocol TLS -o 192.168.1.2:80 -c example2.com --server-names example2.com,www.example2.com
tlsproxy tunnel add -i :443 --in-protocol TLS -o 192.168.1.3:80 -c test.myorg.com --server-names test.myorg.com
tlsproxy tunnel add -i :443 --in-protocol TLS -o 192.168.1.3:80 -c help.myorg.com --server-names help.myorg.com
tlsproxy tunnel add -i :443 --in-protocol TLS -o 192.168.1.3:80 -c myorg.com --server-names *
This is what these commands do:
- Requests for
example1.com
andwww.example1.com
will be routed to a website on IP address192.168.1.1
. - Similarly, requests for
example2.com
andwww.example2.com
will be routed to a website on IP address192.168.1.2
. -
Requests for
test.myorg.com
andhelp.myorg.com
will be provided with appropriate certificates
and routed to a website on IP address192.168.1.3
(where they are going to be handled by separate virtually hosted websites). -
Requests to all other domains will also be routed to a website on IP address
192.168.1.3
and provided with a single certificate.
Example #3 - Act as 'modern TLS to legacy TLS' adapter
TLS 1.0 and 1.1 are currently being deprecated by major browser vendors, and using them on the Internet is strongly discouraged. However, many existing legacy systems only support these legacy versions and often cannot be easily upgraded. And as long as those systems are operated within safe private networks or DMZs, they don't pose a security hazard. But these systems usually need to communicate with the outside world as well, which will become problematic once Internet-facing endpoints disable support for TLS 1.0 and 1.1.
Rebex TLS Proxy can address these situations as well by serving as an adapter that 'converts' TLS 1.3/1.2 (used by the servers on the Internet) to TLS 1.0/1.1 (used by legacy systems running on your private network):
tlsproxy tunnel add
--in 0.0.0.0:443 --in-protocol TLS --in-tls-versions TLS10
--out test.rebex.net:443 --out-protocol TLS --out-tls-versions TLS13
--certificate-path c:\data\my-server-cert.pfx
This will make Rebex TLS Proxy accept TLS 1.0 connections on port 443, and tunnel them to port 443 of test.rebex.net via TLS 1.3.
Note: In order for this to work properly, make sure you are using appropriate host names and certificates. For example, when providing a private 'HTTPS with TLS 1.0' endpoint for a third-party 'HTTPS with TLS 1.3' service, you might have to provide your own replacement certificate signed by a custom certification authority and configure all your legacy HTTPS clients accordingly.
Supported platforms
Rebex TLS proxy runs on all recent and some not-so-recent Windows platforms:
- Windows 11
- Windows 10 (1607+)
- Windows 8.1
- Windows 7 SP1
- Windows Server 2019
- Windows Server 2016
- Windows Server 2012 R2
Both 32-bit and 64-bit platforms are supported.
For older platforms (such as Windows XP or Windows Server 2003), try Rebex Tiny TLS Proxy ( download binaries / source code on GitHub ).
License
Rebex TLS Proxy is free for commercial and non-commercial use. See the End User License Agreement (EULA) for details.
Version history
1.6.1 (2022-11-21)
- Added
--http-host-override
option to fully control value of theHost
HTTP request header sent on the outbound tunnel.
1.6.0 (2022-11-01)
- Upgraded TLS library.
- Improved HTTP parser: request and response parsers are better synchronized.
- Improved tunnel closure routine: waiting for remote end to close the connection politely.
- Improved logging: common errors moved to Warning level, errors during closure moved to Debug level, and more.
1.5.0 (2022-08-17)
- Upgraded software framework to
.NET 6.0
. - Upgraded TLS library.
- Fixed key usage in certificates generated using the
certgen
command: the issued certificate cannot be used as a Certificate Authority to issue other certificates now. - Added HTTP capability:
- Added
HTTP
andHTTPS
protocols to instruct the TLS Proxy to monitor HTTP traffic. - Added
--http-x-real-ip
and--http-x-forwarded-for
options to insert corresponding HTTP headers into the communication. - The 'HTTP request' (method line) and 'HTTP response' (status line) are logged into Access log in
Debug
level.
- Added
- Added
intermediateCertificates
configuration value to fully control certificate chain construction on the inbound tunnel. - Added
--certificate-key-path
option as an alternative to.pfx
files: certificate can now be specified by.cer
file +.key
file. - Added
--sni-override
option to fully control SNI used on the outbound tunnel. - Added
--debug
option and changed behavior of--verbose
option: the options determine verbosity of the console logging. File logging verbosity is now determined by the values specified in theconfig.yaml
file only (file logging is now unrelated to--verbose
and--debug
options). - Minor improvements in logging:
location of the executable and the
config.yaml
file is printed to console upon start, details about loaded certificates is logged upon start, better tunnel error reporting, and more.
1.4.0 (2021-07-27)
- Upgraded software framework to
.NET Core 3.1
. - Upgraded TLS library.
1.3.0 (2020-07-07)
- Improved tunnel closure routine to use less resources.
- Certificate chain sent to the client during TLS negotiation does not include Root certificate now.
- Changed behavior of
certificate
config value to: Thumbprint or Subject Alternative Name (SAN) or Common Name (CN).
1.2.0 (2020-05-25)
- Fixed bug causing infinite loop when a TLS error occurred.
- Fixed bug causing tunnel closure when client attempted to resume TLS 1.3 session on inbound channel.
- Using Rebex components 2020 R2.
1.1.0 (2020-04-15)
- Added support for TLS virtual hosting via Server Name Indication extension (SNI).
- Improved configuration file validation.
- Improved logging.
1.0.0 (2020-03-17)
- Initial public release.
Contact
Have a feature request or a question? Contact us or ask at Rebex Q&A Forum.