Skip to content

Instantly share code, notes, and snippets.

@CMCDragonkai
Last active March 8, 2022 04:16
Show Gist options
  • Save CMCDragonkai/192e4d46c86fe54a9161fd56e4008de9 to your computer and use it in GitHub Desktop.
Save CMCDragonkai/192e4d46c86fe54a9161fd56e4008de9 to your computer and use it in GitHub Desktop.
Local HTTPS Server using Stunnel #network #tls

Local HTTPS Server using Stunnel

You want an HTTPS server bound to localhost running in front of a HTTP server. This is pretty much needed if you're working on things that work only in HTTPS, such as HTTPS-only cookies and front end apps dealing with mixed content.

We can do this with Stunnel.

First create a self-signed certificate or acquire one from Let's Encrypt.

# a certificate for 10 years

openssl req -new -newkey rsa:4096 -days 3650 -nodes -x509 \
  -subj "/CN=localhost.app.com" \
  -keyout localhost.app.com.key -out localhost.app.com.cert

cat ./tls/localhost.app.com.key ./tls/localhost.app.com.cert ./tls/localhost.app.com.pem

We are using localhost subdomain instead of localhost domain because certificate authorities like Let's Encrypt will not grant certificates for localhost. There are security issues with granting certificates to localhost. However granting it to a subdomain like localhost.app.com works perfectly!

Set your local DNS or hosts file to resolve localhost.app.com to 127.0.0.1.

Now we run stunnel. Unfortunately there's no way to pass configuration parameters to stunnel on the command line, so we need to create a temporary configuration file.

If you're using ZSH, you should be able to use =() read/write process redirection however (it uses a temporary file behind the scenes).

SERVER_PORT=8080
TLS_PORT=8081

cat > "./stunnel.conf" <<EOF
foreground = yes
[https]
client = no
accept = $TLS_PORT
connect = $SERVER_PORT
cert = ./tls/localhost.app.com.pem
EOF

stunnel ./stunnel.conf

Test your server with http --verify=./tls/localhost.app.com.cert https://localhost.app.com.au:8081.

@AbinaThomas
Copy link

Hello,
I have set an https proxy server using stunnel as you specified. And I'm trying to connect to the https sever from QT using QT's QNetworkAccessManager class. I'm able to connect to the https server. But I'm not getting any replay or connection status from htttps server. I don't have separate stunnel client. Do I need to do any additional settings?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment