WolfSSL

Last updated
wolfSSL
Developer Todd Ouska
Initial releaseFebruary 19, 2006 (2006-02-19) [1]
Stable release
5.8.2  OOjs UI icon edit-ltr-progressive.svg / 17 July 2025
Repository github.com/wolfssl/wolfssl
Written in C
Operating system Multi-platform
Type Cryptography library
License GPL-3.0-or-later or proprietary [2]
Website www.wolfssl.com

wolfSSL is a small, portable, embedded SSL/TLS library targeted for use by embedded systems developers. It is an open source implementation of TLS (SSL 3.0, TLS 1.0, 1.1, 1.2, 1.3, and DTLS 1.0, 1.2, and 1.3) written in the C programming language. It includes SSL/TLS client libraries and an SSL/TLS server implementation as well as support for multiple APIs, including those defined by SSL and TLS. wolfSSL also includes an OpenSSL compatibility interface with the most commonly used OpenSSL functions. [3] [4]

Contents

Platforms

wolfSSL is currently available for Microsoft Windows, Linux, macOS, Solaris, ESP32, ESP8266, ThreadX, VxWorks, FreeBSD, NetBSD, OpenBSD, embedded Linux, Yocto Project, OpenEmbedded, WinCE, Haiku, OpenWrt, iPhone, Android, Wii, and GameCube through DevKitPro support, QNX, MontaVista, Tron variants, NonStop OS, OpenCL, Micrium's MicroC/OS-II, FreeRTOS, SafeRTOS, Freescale MQX, Nucleus, TinyOS, TI-RTOS, HP-UX, uTasker, uT-kernel, embOS, INtime, mbed, RIOT, CMSIS-RTOS, FROSTED, Green Hills INTEGRITY, Keil RTX, TOPPERS, PetaLinux, Apache Mynewt, and PikeOS [5] , Deos, Azure Sphere OS, Zephyr, AIX, and Cesium.

History

The genesis of wolfSSL dates to 2004. OpenSSL was available at the time, and was dual licensed under the OpenSSL License and the SSLeay license. [6] yaSSL, alternatively, was developed and dual-licensed under both a commercial license and the GPL. [7] yaSSL offered a more modern API, commercial style developer support and was complete with an OpenSSL compatibility layer. [3] The first major user of wolfSSL/CyaSSL/yaSSL was MySQL. [8] Through bundling with MySQL, yaSSL has achieved extremely high distribution volumes in the millions.

In February 2019, Daniel Stenberg, the creator of cURL, was hired by the wolfSSL project to work on cURL. [9]

Protocols

The wolfSSL lightweight SSL library implements the following protocols: [10]

Protocol Notes:

Algorithms

wolfSSL uses the following cryptography libraries:

wolfCrypt

By default, wolfSSL uses the cryptographic services provided by wolfCrypt. [12] wolfCrypt Provides RSA, DSA, ECC, DSS, Diffie–Hellman, EDH, ECDH-ECDSA, ECDHE-ECDSA, ECDH-RSA, ECDHE-RSA, NTRU (deprecated and removed), DES, Triple DES, AES (CBC, CTR, CCM, GCM, OFB, XTS, GMAC, CMAC), Camellia, IDEA, ARC4, HC-128, ChaCha20, MD2, MD4, MD5, SHA-1, SHA-2, SHA-3, BLAKE2, RIPEMD-160, Poly1305, SM2, SM3, SM4 Random Number Generation, Large Integer support, base 16/64 encoding/decoding, HMAC, PBKDF2, and post-quantum cryptographic algorithms: ML-KEM (certified under FIPS 203) and ML-DSA (certified under FIPS 204).


wolfCrypt also includes support for the X25519 and Ed25519 algorithms, as well as the X448 and Ed448 algorithms..

wolfCrypt acts as a back-end crypto implementation for several popular software packages and libraries, including MIT Kerberos [13] (where it can be enabled using a build option).

wolfCrypt is FIPS validated and holds two FIPS 140-2 certificates (#2425 [14] and #3389 [15] ) and two FIPS 140-3 certificates (#4718 [16] and #5041 [17] ).

NTRU

CyaSSL+ includes NTRU [18] public key encryption. The addition of NTRU in CyaSSL+ was a result of the partnership between yaSSL and Security Innovation. [18] NTRU works well in mobile and embedded environments due to the reduced bit size needed to provide the same security as other public key systems. In addition, it's not known to be vulnerable to quantum attacks. Several cipher suites utilizing NTRU are available with CyaSSL+ including AES-256, RC4, and HC-128.

Post-Quantum

wolfSSL provides support for a range of post-quantum cryptographic algorithms, including the Kyber Key Encapsulation Mechanism (KEM), hybridized with NIST-recommended ECC curves to maintain FIPS compliance. Supported ML-KEM levels include Level 1 (ML-KEM-512), Level 3 (ML-KEM-768), and Level 5 (ML-KEM-1024). For digital signatures, wolfSSL implements ML-DSA at Levels 2, 3, and 5; FALCON at Levels 1 and 5; and SLH-DSA, LMS/HSS, and XMSS/XMSS^MT. The library also supports hybrid TLS key exchange schemes, combining ECDHE with ML-KEM at corresponding security levels as well as dual-algorithm certificates and TLS 1.3 dual-algorithm authentication.

Hardware Integration

Secure Element Support

wolfSSL supports the following Secure Elements:

Technology Support

wolfSSL supports the following hardware technologies:

Licensing

wolfSSL is dual licensed: under both the GPL-3.0-or-later license and commercial licensing.

See also

References

  1. ↑ "wolfSSL ChangeLog". 10 August 2017.
  2. ↑ "LICENSING". GitHub .
  3. 1 2 wolfSSL – Embedded Communications Products
  4. ↑ "What You Need to Know About the TLS 1.3 Protocol and wolfSSL's SSL/TLS Libraries". www.allaboutcircuits.com. Retrieved 2018-12-28.
  5. ↑ "wolfSSL Embedded SSL/TLS Library | wolfSSL Products". 4 August 2017. Retrieved 2019-01-31.
  6. ↑ OpenSSL: Source, License
  7. ↑ wolfSSL – License
  8. ↑ "MySQL, Building MySQL with Support for Secure Connections". Archived from the original on 2017-07-06. Retrieved 2016-06-12.
  9. ↑ Daniel Stenberg, founder and Chief Architect of cURL, joins wolfSSL
  10. ↑ wolfSSL – Docs | CyaSSL Manual – Chapter 4 (Features)
  11. ↑ "wolfSSL 3.6.6 is Now Available".
  12. ↑ wolfSSL – Docs | wolfSSL Manual – Chapter 10 (wolfCrypt Usage Reference)
  13. ↑ Kerberos: The Network Authentication Protocol
  14. ↑ {{[title=Certificate #2425|url=https://csrc.nist.gov/projects/cryptographic-module-validation-program/Certificate/2425}}
  15. ↑ {{[title=Certificate #3389|url=https://csrc.nist.gov/Projects/cryptographic-module-validation-program/Certificate/3389}}
  16. ↑ {{[title=Certificate #4718|url=https://csrc.nist.gov/projects/cryptographic-module-validation-program/certificate/4718}}
  17. ↑ {{[title=Certificate #5041|url=https://csrc.nist.gov/projects/cryptographic-module-validation-program/certificate/5041}}
  18. 1 2 NTRU CryptoLabs Archived 2013-02-02 at archive.today
  19. ↑ wolfSSL – wolfSSL with Intel® SGX
This page is based on this Wikipedia article
Text is available under the CC BY-SA 4.0 license; additional terms may apply.
Images, videos and audio are available under their respective licenses.