|author||Kazuho Oku <email@example.com>||Sun May 07 09:06:04 2023 +0900|
|committer||Kazuho Oku <firstname.lastname@example.org>||Tue May 09 12:57:28 2023 +0900|
`server_prefer_chacha` indicates a condition to disable server-precedence
Picotls is a TLS 1.3 (RFC 8446) protocol stack written in C, with the following features:
picotls is designed to be fast, tiny, and low-latency, with the primary user being the H2O HTTP/2 server for serving HTTP/1, HTTP/2, and HTTP/3 over QUIC.
The TLS protocol implementation of picotls is licensed under the MIT license.
License and the cryptographic algorithms supported by the crypto bindings are as follows:
|Binding||License||Key Exchange||Certificate||AEAD cipher|
|minicrypto||CC0 / 2-clause BSD||secp256r1, x25519||ECDSA (secp256r1)1||AES-128-GCM, chacha20-poly1305|
|OpenSSL||OpenSSL||secp256r1, secp384r1, secp521r1, x25519||RSA, ECDSA (secp256r1, secp384r1, secp521r1), ed25519||AES-128-GCM, AES-256-GCM, chacha20-poly1305|
Note 1: Minicrypto binding is capable of signing a handshake using the certificate's key, but cannot verify a signature sent by the peer.
If you have cloned picotls from git then ensure that you have initialised the submodules:
% git submodule init % git submodule update
Build using cmake:
% cmake . % make % make check
A dedicated documentation for using picotls with Visual Studio can be found in WindowsPort.md.
Developer documentation should be available on the wiki.
Run the test server (at 127.0.0.1:8443):
% ./cli -c /path/to/certificate.pem -k /path/to/private-key.pem 127.0.0.1 8443
Connect to the test server:
% ./cli 127.0.0.1 8443
% ./cli -s session-file 127.0.0.1 8443
The session-file is read-write. The cli server implements a single-entry session cache. The cli server sends NewSessionTicket when it first sends application data after receiving ClientFinished.
% ./cli -s session-file -e 127.0.0.1 8443
-e option is used, client first waits for user input, and then sends CLIENT_HELLO along with the early-data.
The software is provided under the MIT license. Note that additional licences apply if you use the minicrypto binding (see above).