How header-only/bearssl works
BearSSL is a header-only cryptography and SSL/TLS library. An application includes its umbrella header, configures an SSL client or server, and exchanges records through the SSL engine; certificate validation and cryptographic algorithms provide supporting capabilities. The graph also preserves the library’s standalone crypto, PEM, and X.509 functionality. Some implementation files are unsampled, so uncertain internal links are omitted rather than inferred.
Main entry points: bearssl.h Public APIs · x509_minimal.hpp X.509 validation · ssl_engine.hpp TLS record engine · ssl_engine_default_aesgcm.hpp Record defaults
Components 18
API and TLS
- Umbrella API
include/bearssl/bearssl.hpp - Public APIs
include/bearssl.h - TLS record engine
include/bearssl/impl/ssl/ssl_engine.hpp - TLS handshake
include/bearssl/impl/ssl/ssl_hs_client.hpp - TLS client
include/bearssl/impl/ssl/ssl_client_full.hpp - TLS server
include/bearssl/impl/ssl/ssl_server_full_rsa.hpp - Record defaults
include/bearssl/impl/ssl/ssl_engine_default_aesgcm.hpp
Cryptography
- Hash functions
include/bearssl/impl/hash/sha2small.hpp - HMAC
include/bearssl/impl/mac/hmac.hpp - HMAC DRBG
include/bearssl/impl/rand/hmac_drbg.hpp - Symmetric ciphers
include/bearssl_block.h - RSA
include/bearssl/impl/rsa/rsa_i15_priv.hpp - Elliptic curves
include/bearssl/impl/ec/ec_p256_m15.hpp
Certificates and keys
- PEM decoding
include/bearssl/impl/codec/pemdec.hpp - Certificate decoding
include/bearssl/impl/x509/x509_decoder.hpp - X.509 validation
include/bearssl/impl/x509/x509_minimal.hpp - Private-key decoding
include/bearssl/impl/x509/skey_decoder.hpp
Other components
- Application
Connections 23
- Application → Umbrella API: includes
- Umbrella API → Public APIs: exposes
include/bearssl/bearssl.hpp - Public APIs → TLS record engine: declares TLS API
include/bearssl.h - Public APIs → Hash functions: declares hashes
include/bearssl.h - Public APIs → HMAC: declares HMAC
include/bearssl.h - Public APIs → HMAC DRBG: declares PRNG
include/bearssl.h - Public APIs → Symmetric ciphers: declares ciphers
include/bearssl.h - Public APIs → RSA: declares RSA
include/bearssl.h - Public APIs → Elliptic curves: declares curves
include/bearssl.h - Public APIs → PEM decoding: declares PEM
include/bearssl.h - Public APIs → X.509 validation: declares X.509
include/bearssl.h - TLS client → TLS handshake: uses handshake
- TLS server → TLS handshake: uses handshake
- TLS record engine → TLS handshake: delegates handshake
- TLS record engine → Record defaults: configures records
include/bearssl/impl/ssl/ssl_engine_default_aesgcm.hpp - Record defaults → Symmetric ciphers: selects AES
include/bearssl/impl/ssl/ssl_engine_default_aesgcm.hpp - Record defaults → Hash functions: selects GHASH
include/bearssl/impl/ssl/ssl_engine_default_aesgcm.hpp - X.509 validation → Elliptic curves: uses ECDSA support
- X.509 validation → RSA: validates signatures
- TLS record engine → X.509 validation: matches certificate name
- PEM decoding → Certificate decoding: decodes PEM input
- Certificate decoding → X.509 validation: provides certificates
- Private-key decoding → RSA: decodes keys