Skip to content
This repository was archived by the owner on Apr 10, 2025. It is now read-only.
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
67 commits
Select commit Hold shift + click to select a range
3fdfe62
QUIC: Add support for BoringSSL QUIC APIs
tmshort Apr 12, 2019
ef699ff
QUIC: New method to get QUIC secret length
tmshort Jun 14, 2019
7b9b88d
QUIC: Make temp secret names less confusing
tmshort Aug 15, 2019
323500d
QUIC: Move QUIC transport params to encrypted extensions
tmshort Aug 15, 2019
4407aa7
QUIC: Use proper secrets for handshake
tmshort Aug 15, 2019
b2666a1
QUIC: Handle partial handshake messages
tmshort Aug 15, 2019
7fec6bb
QUIC: Fix duplicate word in docs
tmshort Aug 26, 2019
6ad64ec
QUIC: Fix quic_transport constructors/parsers
tmshort Aug 26, 2019
14837f9
QUIC: Reset init state in SSL_process_quic_post_handshake()
tmshort Aug 29, 2019
d275332
QUIC: Don't process an incomplete message
tmshort Aug 29, 2019
bed28f4
QUIC: Quick fix: s2c to c2s for early secret
tmshort Aug 30, 2019
ba834f8
QUIC: Add client early traffic secret storage
tmshort Aug 30, 2019
d95d74c
QUIC: Add OPENSSL_NO_QUIC wrapper
tmshort Aug 30, 2019
350ac3c
QUIC: Correctly disable middlebox compat
tmshort Aug 30, 2019
dc7b5a1
QUIC: Move QUIC code out of tls13_change_cipher_state()
tmshort Aug 30, 2019
d04aed5
QUIC: Tweeks to quic_change_cipher_state()
tmshort Aug 30, 2019
7d24771
QUIC: Add support for more secrets
tmshort Sep 24, 2019
67c9294
QUIC: Fix resumption secret
tmshort Nov 12, 2019
f0caa58
QUIC: Handle EndOfEarlyData and MaxEarlyData
tmshort Nov 13, 2019
34cbf28
QUIC: Fall-through for 0RTT
tmshort Jan 7, 2020
83cb5bc
QUIC: Some cleanup for the main QUIC changes
kaduk Apr 22, 2020
fc5c9c8
QUIC: Prevent KeyUpdate for QUIC
kaduk May 11, 2020
24d2ce6
QUIC: Test KeyUpdate rejection
kaduk May 11, 2020
de43120
QUIC: Buffer all provided quic data
kaduk Aug 31, 2020
53834e3
QUIC: Enforce consistent encryption level for handshake messages
kaduk Sep 1, 2020
064a96b
QUIC: add v1 quic_transport_parameters
tmshort Dec 12, 2020
3463713
QUIC: return success when no post-handshake data
tmshort Jan 5, 2021
2aea47c
QUIC: __owur makes no sense for void return values
kaduk Jan 15, 2021
04b258a
QUIC: remove SSL_R_BAD_DATA_LENGTH (unused)
tmshort Feb 19, 2021
3421195
QUIC: Update shared library version
tmshort Mar 3, 2021
ead4b8c
QUIC: Swap around README files
tmshort Mar 3, 2021
c91737d
QUIC: Fix 3.0.0 GitHub CI
tmshort Mar 3, 2021
b930d97
QUIC: SSLerr() -> ERR_raise(ERR_LIB_SSL)
tmshort Mar 3, 2021
c73839c
QUIC: Add compile/run-time checking for QUIC
tmshort Mar 5, 2021
bc09538
QUIC: Add early data support (#11)
tatsuhiro-t Mar 11, 2021
9cddd90
QUIC: Make SSL_provide_quic_data accept 0 length data (#13)
tatsuhiro-t Mar 11, 2021
e0b7675
QUIC: Process multiple post-handshake messages in a single call (#16)
tatsuhiro-t Mar 12, 2021
4635dc4
QUIC: Tighten up some language in SSL_CTX_set_quic_method.pod (#18)
kaduk Mar 12, 2021
7350d97
QUIC: Fix typo in README.md (#19)
NanXiao Mar 15, 2021
b1e6654
QUIC: Fix CI (#20)
tmshort Mar 18, 2021
23b11bf
QUIC: Break up header/body processing
tmshort May 6, 2021
2064b7f
QUIC: Fix make doc-nits
tmshort Jun 24, 2021
3c56150
QUIC: Fix make md-nits
tmshort Jun 24, 2021
13c3f74
QUIC: Don't muck with FIPS checksums
tmshort Jul 9, 2021
3f82794
QUIC: README.md fixups
tmshort Jul 29, 2021
4ec178f
QUIC: Update RFC references
tmshort Sep 7, 2021
c1d0456
QUIC: revert white-space change
tmshort Sep 7, 2021
13d3950
QUIC: update copyrights
tmshort Sep 7, 2021
95d9653
QUIC: update SSL_provide_quic_data() documentation
kaduk Sep 7, 2021
bb1cbd5
QUIC: expound on what DoS attacks QUIC avoids
kaduk Sep 7, 2021
eebacb7
QUIC: remove SSL_get_current_cipher() reference
kaduk Sep 7, 2021
736b540
QUIC: use SSL_IS_QUIC() in more places
kaduk Sep 7, 2021
93c257a
QUIC: Error when non-empty session_id in CH (fixes #29)
tmshort Oct 18, 2021
aa0a8d9
QUIC: Update SSL_clear() to clear quic data
tmshort Oct 19, 2021
4bde87b
QUIC: Better SSL_clear()
tmshort Oct 29, 2021
fdbc223
QUIC: Update README
tmshort Nov 2, 2021
72add3a
QUIC: Update README.md for 3.0.7
tmshort Mar 15, 2022
87890d1
QUIC: Fix extension test
tmshort Nov 1, 2022
2130c58
QUIC: Update README.md for 3.0.8
tmshort Feb 7, 2023
b95fb6b
QUIC: Update README.md for 3.1.0
wbl Mar 20, 2023
1ab22a3
QUIC: Update README.md for 3.1.2
tmshort Aug 1, 2023
8c807be
QUIC: Fix use of create_a_psk
tmshort Aug 1, 2023
544c351
QUIC: Update MD files for 3.1.5
tmshort Oct 6, 2023
63218e7
QUIC: Update readme for 3.1.6
tmshort Aug 12, 2024
0d14369
QUIC: Update README and CHANGES for 3.1.8
wbl Sep 3, 2024
2a1da07
Update README.md
richsalz Feb 16, 2025
99d5964
Update README.md
richsalz Feb 25, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions CHANGES.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,12 @@ OpenSSL Releases
OpenSSL 3.1
-----------

### Changes between 3.1.8 and 3.1.8+quic [27 Feb 2024]

* Added BoringSSL QUIC API support

*Todd Short*

### Changes between 3.1.7 and 3.1.8 [11 Feb 2025]

* Fixed timing side-channel in ECDSA signature computation.
Expand Down
5 changes: 4 additions & 1 deletion Configure
Original file line number Diff line number Diff line change
Expand Up @@ -467,6 +467,7 @@ my @disablables = (
"poly1305",
"posix-io",
"psk",
"quic",
"rc2",
"rc4",
"rc5",
Expand Down Expand Up @@ -577,14 +578,15 @@ my @disable_cascades = (
"sm3", "sm4", "srp",
"srtp", "ssl3-method", "ssl-trace",
"ts", "ui-console", "whirlpool",
"quic",
"fips-securitychecks" ],
sub { $config{processor} eq "386" }
=> [ "sse2" ],
"ssl" => [ "ssl3" ],
"ssl3-method" => [ "ssl3" ],
"zlib" => [ "zlib-dynamic" ],
"des" => [ "mdc2" ],
"ec" => [ "ec2m", "ecdsa", "ecdh", "sm2", "gost" ],
"ec" => [ "ec2m", "ecdsa", "ecdh", "sm2", "gost", "quic" ],
"dgram" => [ "dtls", "sctp" ],
"sock" => [ "dgram" ],
"dtls" => [ @dtls ],
Expand Down Expand Up @@ -635,6 +637,7 @@ my @disable_cascades = (
"legacy" => [ "md2" ],

"cmp" => [ "crmf" ],
"tls1_3" => [ "quic" ],

"fips" => [ "fips-securitychecks", "acvp-tests" ],

Expand Down
4 changes: 4 additions & 0 deletions INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -830,6 +830,10 @@ Don't use POSIX IO capabilities.

Don't build support for Pre-Shared Key based ciphersuites.

### no-quic

Don't build support for QUIC API from BoringSSL.

### no-rdrand

Don't use hardware RDRAND capabilities.
Expand Down
212 changes: 212 additions & 0 deletions README-OpenSSL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,212 @@
Welcome to the OpenSSL Project
==============================

[![openssl logo]][www.openssl.org]

[![github actions ci badge]][github actions ci]
[![appveyor badge]][appveyor jobs]

OpenSSL is a robust, commercial-grade, full-featured Open Source Toolkit
for the Transport Layer Security (TLS) protocol formerly known as the
Secure Sockets Layer (SSL) protocol. The protocol implementation is based
on a full-strength general purpose cryptographic library, which can also
be used stand-alone.

OpenSSL is descended from the SSLeay library developed by Eric A. Young
and Tim J. Hudson.

The official Home Page of the OpenSSL Project is [www.openssl.org].

Table of Contents
=================

- [Overview](#overview)
- [Download](#download)
- [Build and Install](#build-and-install)
- [Documentation](#documentation)
- [License](#license)
- [Support](#support)
- [Contributing](#contributing)
- [Legalities](#legalities)

Overview
========

The OpenSSL toolkit includes:

- **libssl**
an implementation of all TLS protocol versions up to TLSv1.3 ([RFC 8446]).

- **libcrypto**
a full-strength general purpose cryptographic library. It constitutes the
basis of the TLS implementation, but can also be used independently.

- **openssl**
the OpenSSL command line tool, a swiss army knife for cryptographic tasks,
testing and analyzing. It can be used for
- creation of key parameters
- creation of X.509 certificates, CSRs and CRLs
- calculation of message digests
- encryption and decryption
- SSL/TLS client and server tests
- handling of S/MIME signed or encrypted mail
- and more...

Download
========

For Production Use
------------------

Source code tarballs of the official releases can be downloaded from
[openssl-library.org/source/](https://openssl-library.org/source/).
The OpenSSL project does not distribute the toolkit in binary form.

However, for a large variety of operating systems precompiled versions
of the OpenSSL toolkit are available. In particular, on Linux and other
Unix operating systems, it is normally recommended to link against the
precompiled shared libraries provided by the distributor or vendor.

For Testing and Development
---------------------------

Although testing and development could in theory also be done using
the source tarballs, having a local copy of the git repository with
the entire project history gives you much more insight into the
code base.

The main OpenSSL Git repository is private.
There is a public GitHub mirror of it at [github.com/openssl/openssl],
which is updated automatically from the former on every commit.

A local copy of the Git repository can be obtained by cloning it from
the GitHub mirror using

git clone https://github.com/openssl/openssl.git

If you intend to contribute to OpenSSL, either to fix bugs or contribute
new features, you need to fork the GitHub mirror and clone your public fork
instead.

git clone https://github.com/yourname/openssl.git

This is necessary because all development of OpenSSL nowadays is done via
GitHub pull requests. For more details, see [Contributing](#contributing).

Build and Install
=================

After obtaining the Source, have a look at the [INSTALL](INSTALL.md) file for
detailed instructions about building and installing OpenSSL. For some
platforms, the installation instructions are amended by a platform specific
document.

* [Notes for UNIX-like platforms](NOTES-UNIX.md)
* [Notes for Android platforms](NOTES-ANDROID.md)
* [Notes for Windows platforms](NOTES-WINDOWS.md)
* [Notes for the DOS platform with DJGPP](NOTES-DJGPP.md)
* [Notes for the OpenVMS platform](NOTES-VMS.md)
* [Notes on Perl](NOTES-PERL.md)
* [Notes on Valgrind](NOTES-VALGRIND.md)

Specific notes on upgrading to OpenSSL 3.0 from previous versions can be found
in the [migration_guide(7ossl)] manual page.

Documentation
=============

Manual Pages
------------

The manual pages for the master branch and all current stable releases are
available online.

- [OpenSSL master](https://www.openssl.org/docs/manmaster)
- [OpenSSL 3.0](https://www.openssl.org/docs/man3.0)
- [OpenSSL 1.1.1](https://www.openssl.org/docs/man1.1.1)

Wiki
----

There is a Wiki at [wiki.openssl.org] which is currently not very active.
It contains a lot of useful information, not all of which is up-to-date.

License
=======

OpenSSL is licensed under the Apache License 2.0, which means that
you are free to get and use it for commercial and non-commercial
purposes as long as you fulfill its conditions.

See the [LICENSE.txt](LICENSE.txt) file for more details.

Support
=======

There are various ways to get in touch. The correct channel depends on
your requirement. See the [SUPPORT](SUPPORT.md) file for more details.

Contributing
============

If you are interested and willing to contribute to the OpenSSL project,
please take a look at the [CONTRIBUTING](CONTRIBUTING.md) file.

Legalities
==========

A number of nations restrict the use or export of cryptography. If you are
potentially subject to such restrictions, you should seek legal advice before
attempting to develop or distribute cryptographic code.

Copyright
=========

Copyright (c) 1998-2025 The OpenSSL Project

Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson

All rights reserved.

<!-- Links -->

[www.openssl.org]:
<https://www.openssl.org>
"OpenSSL Homepage"

[github.com/openssl/openssl]:
<https://github.com/openssl/openssl>
"OpenSSL GitHub Mirror"

[wiki.openssl.org]:
<https://wiki.openssl.org>
"OpenSSL Wiki"

[migration_guide(7ossl)]:
<https://www.openssl.org/docs/man3.0/man7/migration_guide.html>
"OpenSSL Migration Guide"

[RFC 8446]:
<https://tools.ietf.org/html/rfc8446>

<!-- Logos and Badges -->

[openssl logo]:
doc/images/openssl.svg
"OpenSSL Logo"

[github actions ci badge]:
<https://github.com/openssl/openssl/workflows/GitHub%20CI/badge.svg>
"GitHub Actions CI Status"

[github actions ci]:
<https://github.com/openssl/openssl/actions?query=workflow%3A%22GitHub+CI%22>
"GitHub Actions CI"

[appveyor badge]:
<https://ci.appveyor.com/api/projects/status/8e10o7xfrg73v98f/branch/master?svg=true>
"AppVeyor Build Status"

[appveyor jobs]:
<https://ci.appveyor.com/project/openssl/openssl/branch/master>
"AppVeyor Jobs"
Loading
Loading