https://github.com/syncsynchalt/illustrated-tls13

The Illustrated TLS 1.3 Connection: Every byte explained
https://github.com/syncsynchalt/illustrated-tls13

curve25519 gcm ssl tls tls13 x25519

Last synced: about 2 months ago
JSON representation

The Illustrated TLS 1.3 Connection: Every byte explained

• Host: GitHub
• URL: https://github.com/syncsynchalt/illustrated-tls13
• Owner: syncsynchalt
• License: mit
• Created: 2018-10-30T00:09:49.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-11-04T21:21:56.000Z (11 months ago)
• Last Synced: 2024-04-11T11:36:26.767Z (5 months ago)
• Topics: curve25519, gcm, ssl, tls, tls13, x25519
• Language: HTML
• Homepage: https://tls13.ulfheim.net
• Size: 2.07 MB
• Stars: 768
• Watchers: 14
• Forks: 73
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# The Illustrated TLS Connection

Published at https://tls13.xargs.org

- `site/`: page source for the finished product

- `server/main.c`: server code

- `client/main.c`: client code

- `archive/`: previous version of this site, which was based on a pre-production BoringSSL patch

- `openssl/`: patch of OpenSSL that removes any random aspects of the documented connection

- `captures/`: PCAP and keylog files

See also https://github.com/syncsynchalt/illustrated-tls for a TLS 1.2 version of this project.

### Build instructions

If you'd like a working example that reproduces the exact handshake documented on the site:

```

git clone https://github.com/syncsynchalt/illustrated-tls13.git

cd illustrated-tls13/

cd openssl/

make

cd ../server/

make

cd ../client/

make

```

Then open two terminals and run `./server` in the server/ subdir and `./client` in the client/ subdir.

This has been shown to work on MacOS 10.14 and various Linuxes and only has a few easy-to-find dependencies: gcc or clang, golang, cmake, make, patch.