Difference between revisions of "Transport Layer Security"

From ArchWiki
Jump to navigation Jump to search
(→‎Obtaining a certificate: wording, link articles)
(→‎Trust management: crosslink content addressing the expansion template (I think the blacklist case is good to keep in Security))
Line 27: Line 27:
== Trust management ==
== Trust management ==
{{Expansion|How to distrust a certificate authority?}}
See [[Security#Managing SSL certificates]] on how to distrust/blacklist a certificate authority.
=== Trust a certificate authority system-wide ===
=== Trust a certificate authority system-wide ===

Revision as of 21:59, 29 November 2018

According to Wikipedia:

Transport Layer Security (TLS), and its now-deprecated[1] predecessor, Secure Sockets Layer (SSL), are cryptographic protocols designed to provide communications security over a computer network. Several versions of the protocols find widespread use in applications such as web browsing, email, instant messaging, and voice over IP (VoIP). Websites can use TLS to secure all communications between their servers and web browsers.


Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: Mention that NSS in contrast to the other implementations uses databases. (Discuss in Talk:Transport Layer Security#)

There are four TLS implementations available in the official repositories. OpenSSL is the only one part of the base group (albeit indirectly).

  • OpenSSL — A robust, commercial-grade, and full-featured toolkit for the TLS and SSL protocols; also a general-purpose cryptography library.
https://www.openssl.org/ || openssl
  • GnuTLS — A free software implementation of the TLS, SSL and DTLS protocols. Offers APIs for X.509, PKCS #12, OpenPGP and other structures.
https://www.gnutls.org/ || gnutls
  • Network Security Services (NSS) — Implementation of cryptographic libraries supporting TLS/SSL and S/MIME. Also supports TLS acceleration and smart cards.
https://developer.mozilla.org/NSS || nss
  • mbed TLS — Portable SSL/TLS implementation, aka PolarSSL.
https://tls.mbed.org/ || mbedtls

Certificate authorities

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: What does update-ca-trust do? What is p11-kit? Where are certificates stored? (Discuss in Talk:Transport Layer Security#)

With TLS you trust in a set of certificate authorities (CAs) and when you receive a public key certificate from a server, your client verifies that it is signed by a certificate authority, which you trust. On Arch Linux the certificate authorities are provided by the ca-certificates package, which is indirectly part of the base group, because of the dependency chain (pacman > curl > ca-certificates), and has the following dependency tree (excerpt):

Trust management

See Security#Managing SSL certificates on how to distrust/blacklist a certificate authority.

Trust a certificate authority system-wide

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: Without the anchor you can trust regular certificates. Does it need to be in PEM format? (Discuss in Talk:Transport Layer Security#)
Warning: This allows anyone with access to the private key to intercept all of your TLS traffic.
# trust anchor certificate.crt

This is for example required to allow a HTTPS MITM proxy to intercept traffic.

Obtaining a certificate

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: Recommended key size? (Discuss in Talk:Transport Layer Security#)

The first step is to generate an RSA private key. Before generating the key, set a restrictive file mode creation mask with umask (for example 077).

Note: The openssl package does not properly safeguard the /etc/ssl/private directory like most other distributions do, see FS#43059.

A certificate can be obtained either from a certificate authority with a Certificate Signing Request (CSR) or self-signed. While self-signed certificates can be generated easily, clients will reject them by default, meaning that every client needs to be configured to trust the self-signed certificate.

For the actual generation commands refer to the article of the used implementation:

Tip: You can get free certificates from the Let's Encrypt certificate authority with ACME.

Server-side recommendations

Because there are various attacks against TLS the best practices should be considered:

Checking TLS

Programs to check TLS:

Websites to check TLS:



The Automated Certificate Management Environment (ACME) protocol lets you request valid X.509 certificates from certificate authorities, like Let's Encrypt.

See also List of ACME clients.

  • acme.sh — A pure Unix shell script ACME client.
https://github.com/Neilpang/acme.sh || acme.sh-gitAUR
  • acme-client — Secure Let's Encrypt client, written in C
https://kristaps.bsd.lv/acme-client/ || acme-clientAUR
  • acme-tiny — A 200-line Python script to issue and renew TLS certs from Let's Encrypt.
https://github.com/diafygi/acme-tiny || acme-tiny
  • acmetool — An easy-to-use ACME CLI.
https://github.com/hlandau/acme || acmetoolAUR, acmetool-gitAUR
  • Certbot — ACME client recommended by Let's Encrypt.
https://github.com/certbot/certbot || certbot
  • dehydrated — ACME client, written in Bash.
https://github.com/lukas2511/dehydrated || dehydratedAUR, dehydrated-gitAUR
  • getssl — ACME client, written in Bash.
https://github.com/srvrco/getssl || getsslAUR, getssl-gitAUR
  • lego — Lets Encrypt client and ACME library, written in Go.
https://github.com/xenolf/lego || lego-gitAUR
  • letsencrypt-cli — Yet another Letsencrypt (ACME) client using Ruby.
https://github.com/zealot128/ruby-acme-cli || letsencrypt-cliAUR
  • manuale — A fully manual Let's Encrypt client, written in Python.
https://github.com/veeti/manuale || manualeAUR
  • ruby-acme-client — A Ruby client for the letsencrypt's ACME protocol.
https://github.com/unixcharles/acme-client || ruby-acme-clientAUR
  • simp_le — Simple Let's Encrypt client, written in Python.
https://github.com/zenhack/simp_le || simp_le-gitAUR


The Online Certificate Status Protocol (OCSP) is supported by Firefox, Chromium has its own mechanism[2].

See also ocsptool(1) by GnuTLS and ocsp(1ssl) by OpenSSL.


The HTTP Strict Transport Security (HSTS) mechanism is supported by Firefox, Chromium and wget (~/.wget-hsts).

See also