ucspi-ssl 0.13.03
ucspi-ssl
Loading...
Searching...
No Matches
ucspi-ssl

ucspi-ssl-0.13

ucspi-ssl is a joined project of William Baxter (Copyright 2001 SuperScript Technology, Inc.) and me (FEHCom).

ucspi-ssl home page

Requirements

  • OpenSSL or LibreSSL providing crypto services for TLS 1.3.
  • fehQlibs(>=25) need to be installed (usually located at /usr/local) for network and DNS services.

Installation and Customization

  • Read INSTALL for installation instructions.
  • Read doc/CERTS for the X.509 certificates shipped.
  • Read doc/CHAIN-SSL how to configure X.509 chaining support.

Changelog and Internals

  • Read doc/CHANGES for changes and bug fixes.
  • Read doc/UCSPI-SSL to find some internal information.
  • Read doc/TLS_1_3 how to use an OpenSSL/LibreSSL version providing TLS 1.3 support.
  • Read doc/TLSVERSION_CIPHERSUITES how to tweak TLS version and cipher suites.
  • Read doc/TODO what is missing still.

CDB rules file

  • In order to generate the 'cdb' rules file ucspi-tcp(6) is required, providing the program 'tcprules'.
  • Applying 'tcprules' from ucspi-tcp6 allows recognition of IPv6 addresses and usage in the common CIDR format for both IPv4 and IPv6 addresses.
  • Old 'cdb' formats and their generating rules file are accepted unaltered.
  • sslserver and sslhandle support the 'MAXCONIP' feature.
  • sslserver is enabled to evaluate an early 'cdb' lookup before DNS resolution.

Cryptomaterial and X.509 certs

  • In the directory ./etc you will find some X.509 certificate, key files and other crypto material required for a first setup.
  • All X.509 certificates use now ECC crypto instead of RSA.
  • Read etc/README_CERTS.md.

Regression Testing

  • ucspi-tcp6 has to be installed (under /usr/local/bin, or any accessible path).
  • Run package/rts in ucspi-ssl's directory.
  • The output should show up different SSL session IDs, but nothing else.
  • Read doc/README_RTS.md for more information.

Erwin Hoffmann, September 2024.