DuckCorp » DuckCorp Infrastructure

h1. PKI

h2. Self-Signed CAs

h3. Current Status

These self-signed Cas are in use in DC's infrastruture:

* _duckcorp_ : the main CA, we plan to continue using it for non-user-facing services

* _duckcorp-backup_ : used for our backup software to secure TLS communications

* _duckcorp-monitoring_ : used for our monitoring software to secure TLS communications

The _duckcorp-backup_ and _duckcorp-monitoring_ CAs could have been sub-CAs but our tool does not support it.

h3. Managing Certificates

We use project:mkcert manually to generate and renew certificates. It can be run in place in our infra repository, as described in source:README.md.

h2. Let's Encrypt

h3. Current Status

All user facing services are using Let's Encrypt or soon are (#676).

h3. Managing Certificates

Web certificates are easy to create, as certbot can use the web server for its challenge. The _httpd_ Ansible role automates the creation of Let's Encrypt certificates using this method.

Non-Web certificates are more tricky, as we do not want to install a web server on all machine, thus we rely on the DNS challenge. With this method certbot needs to be able to update the zone but we do not want it to become fully dynamic. Fortunately there is "a patch to follow CNAMEs":https://github.com/certbot/certbot/pull/7244; it is not yet integrated upstream but working very well. With is patch it is possible to delegate the RR to update to another zone. For example __acme-challenge.mx1.duckcorp.org_ is CNAMEd to __acme-challenge.mx1._kage.duckcorp.org_; _duckcorp.org_ remains static and managed as usual while the *shadow zone*, _kage.duckcorp.org_, is dynamic and can receive updates. We created a key for each machine and the DNS master has an extensive ACL list, allowing updates to specific machine and RR couples. The _kage.duckcorp.org_ zone does not need to have slaves for such volatile challenges, but this zone is also used for DANE, so we added the usual set of slaves and reduced the TTL a lot to not hinder propagation.

After the certificate is created, it needs to be deployed. Certain services run as root or are dropping privilege after reading the config and can access the certificate directly in the certbot directory. Other service would lack permissions thus we created a certbot hook _dc_cert_renewal_deploy_ that takes care of copying the files and set the proper permissions.

After deployment the service needs to be notify of the change. Sometimes it can be reloaded (often using SIGHUP or SIGUSR1/2) but sometimes it needs to be restarted (we try to avoid). The certbot hook _dc_cert_renewal_restart_services_ takes care of this task.

h2. DANE

"DANE":https://en.wikipedia.org/wiki/DNS-based_Authentication_of_Named_Entities is a security protocol used to reinforce TLS certificate validation by publishing certain information in the DNS. It requires your DNS zones to be secured using "DNSSEC":https://en.wikipedia.org/wiki/Domain_Name_System_Security_Extensions.

h3. Current Status

Our zones are DNSSEC secured and we publish DANE-EE TLSA DNS records for the leaf certificates.

Services supporting DANE (or WIP):

* Postfix

* Web vhosts do not have a TLSA record yet, but this is coming (#675).

h3. Managing Certificates

For certificates managed with our own main CA we use the _adm_publish_tlsa_ script in our infra repo to scan the certificates in _pki/_ and generate TLSA RRs. In our DC and MP zones we include a TLSA-dedicated file which is filled with the generated records. Finaly the script reloads the zones.

For certificates generated with Let's Encrypt, we created the _srv_cert_tlsa_gen_ script to generate and update a TLSA RR on the shadow zone. We use the same system with CNAMEs to delegate the RR from the main zone. Currently the script needs to be told the name of the shadow zone but there is a plan to make it follow CNAMEs like certbot. The script is called in the _dc_cert_renewal_restart_services_ hook in order to update the RR whenever the certificate is renewed.

h3. Checking DANE

The "danetls":https://github.com/shuque/danetls tool is not packaged but there is a web service called "danecheck":https://www.huque.com/bin/danecheck by the same author.

h3. DANE adoption

These are just notes to check on DANE adoption in various client software.

* HTTPS: "plugins for majors browsers were developed and abandoned":https://www.dnssec-validator.cz/ because necessary API support in the browsers vanished and there is no replacement

* SMTP: seems to have gained traction, suggested by the various checkers, Postfix supports it and we support it (see [[Mail]])

* IMAP/POP3: "Thunderbird integration was refused":https://bugzilla.mozilla.org/show_bug.cgi?id=1479423 because it needs to be integrated in Firefox core first, but the "Firefox integration":https://bugzilla.mozilla.org/show_bug.cgi?id=672600 does not seem to go anywhere

* IRC: "Weechat integration":https://github.com/weechat/weechat/pull/121 is not making much progress despite a patch being available

* XMPP-c2s: ???

* XMPP-s2s: Prodosy has an "experimental module":https://modules.prosody.im/mod_s2s_auth_dane.html but it is unmaintained and supposed to crash sometimes (according to the known issues)