ruben69695/mtls-server repository overview

⁠mTLS Server

Docker image for a Python-based mutual TLS (mTLS) demo server.

This server exposes an HTTPS endpoint protected with client certificate authentication and is intended for local testing, learning, and demo purposes.

⁠Features

• Python mTLS HTTPS server
• Requires a valid client certificate signed by the configured CA
• Exposes:
  • GET /todo
  • POST /todo
• Runs inside Docker for isolated execution

⁠Exposed Port

• 8443

⁠Run

docker run -d --rm --name mtls-server -p 8443:8443 ruben69695/mtls-server:latest

The server will be available at:

https://127.0.0.1:8443/todo

⁠Notes

• This image includes the demo certificates used by the lab
• Client authentication is required, client certificates located here⁠
• TODO items are stored in memory only, so they are lost when the container stops
• You can also build the image from the source here⁠

⁠Example

curl --cert certs/client.crt \
     --key certs/client.key \
     --cacert certs/ca.crt \
     https://127.0.0.1:8443/todo

⁠Source

Author repository: Jordi Martin

Project repository: mTLS-lab⁠