doc: Import cdn-cert.md documentation

Imported with minor changes, from private infra repo at
<https://github.com/jquery/infrastructure/blob/1f8c332e728b9d150b42cf27de84c122c2631142/modules/jquery/files/cert/README.md>

Author: Krinkle

bin/decrypt_cert_key.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+# SPDX-License-Identifier: MIT
+# Copyright 2022 Timo Tijhof
+#
+# Save the decrypted form of a private key provided by the issuer.
+# This will prompt for an encryption password.
+#
+
+set -eu
+
+if [ "$#" -ne 2 ]; then
+  echo "Usage: ./decrypt_cert_key.sh encrypted_input.key plaintext_output.key"
+  exit
+fi
+
+keyfilesrc=$1
+keyfiledest=$2
+
+openssl pkcs8 -in "$keyfilesrc" -out "$keyfiledest"

bin/verify_cert.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+
+# SPDX-License-Identifier: MIT
+# Copyright 2021 Brian Warner
+# Copyright 2023 Timo Tijhof
+#
+# Very basic utility to run checks on SSL certs prior to deployment.
+#
+# Usage: ./verify_certs.sh <path to star.jquery.com.pem>
+#
+#   certname.pem: This is the PEM file created from concatenating the .crt with the .ca-bundle
+#   certname.key: This is the private key provided by the issuer
+#   certname.ca-bundle: These are the intermediate certs provided by the issuer
+#
+
+if [ "$#" -ne 1 ]; then
+  echo "Usage: ./verify_certs.sh <path to star.jquery.com.pem>"
+  exit
+fi
+
+pemfilename="$1"
+keyfilename="${1%.pem}.key"
+cabundlefilename="${1%.pem}.ca-bundle"
+if [ ! -f "$pemfilename" ]; then
+  echo -e "Error: Could not find $pemfilename"
+  exit 1
+fi
+if [ ! -f "$keyfilename" ]; then
+  echo -e "Error: Could not find $keyfilename"
+  exit 1
+fi
+if [ ! -f "$cabundlefilename" ]; then
+  echo -e "Error: Could not find $cabundlefilename"
+  exit 1
+fi
+
+bold=$(tput bold)
+normal=$(tput sgr0)
+
+echo -e "\n${bold}Dates the cert is valid (expect today to be within this range):${normal}"
+openssl x509 -noout -dates -in "$pemfilename"
+
+echo -e "\n${bold}Verifying validity of the certificate chain (expect \"OK\"):${normal}"
+openssl verify -CAfile "$cabundlefilename" "$pemfilename"
+
+echo -e "\n${bold}Verify the public keys match (expect \"Keys match\"):${normal}"
+pemkey=`openssl x509 -noout -pubkey -in "$pemfilename"`
+pubkey=`openssl rsa -pubout -in "$keyfilename" 2>/dev/null`
+keydiff=`diff <(echo $pemkey) <(echo $pubkey)`
+
+if [ ${#keydiff} -eq 0 ]; then
+  echo -e "Keys match"
+else
+  echo -e "\033[0;31mKeys do not match, check you have the correct .key and .pem files.\033[0;37m"
+fi
+
+echo -e "\n${bold}Verify the PEM file is in the right order (expect issuer to match next subject)${normal}"
+openssl crl2pkcs7 -nocrl -certfile "$pemfilename" | openssl pkcs7 -print_certs -noout
+

doc/cdn-cert.md

@@ -0,0 +1,51 @@
+# jQuery CDN: TLS Certificate
+
+Every year we need to renew the TLS certificate used by the jQuery CDN. Linux Foundation IT provisions these as needed.
+
+## Process to obtain new certificate
+
+1. Create a ticket with LF IT under "Project Support Services" <https://support.linuxfoundation.org>.
+
+   LF IT purchases a 3-year certificate and mints a 1-year certificate for us to use. They share the `.crt` and `.ca-bundle` files via email, and share the private key via 1Password.
+2. The `.crt` and `.ca-bundle` file for each domain needs to be converted to `.pem` format by concatenating them with the `.crt` file first.
+   * `cat __jquery_com.crt __jquery_com.ca-bundle > star.jquery.com.pem`
+   * The `.crt` file may not have an EOL character, so open `star.jquery.com.pem` and make sure that all block terminators look like this (i.e., not on one line, and no blank lines between):
+     ```
+     -----END CERTIFICATE-----
+     -----BEGIN CERTIFICATE-----
+     ```
+3. Copy the contents of the private key (shared via 1Password) into a file called `star.jquery.com.key`
+4. **Test it!** by running `bin/verify_cert.sh path/to/your/star.jquery.com.pem`
+
+   Note that if the `.key` file contains `ENCRYPTED` (that is, if `verify_cert.sh` causes openssl to prompt you for a password), then **convert this to plaintext first** via `bin/decrypt_cert_key.sh`, so that the file can be safely used by a webserver.
+
+## Example ticket
+
+> Project: Open JS Foundation
+> Services: DNS management, Domain ownership
+>
+> The wildcart cert for jquery.com, as used for the jQuery CDN at code.jquery.com is expiring soon on ….
+>
+> We ideally take a few days to test it first, and after that I can upload it to Fastly (at least 48 hours after issuing, which ensures the a majority of browser clients that suffer clockskew, will accept the new certificate).
+>
+> Our current one was issued in … by ….
+>
+> Thanks!
+
+## Process to deploy new certificate
+
+When in doubt, refer to a recent issue that documents what we actually did.
+Renewal in 2023: https://github.com/jquery/infrastructure-puppet/issues/21
+
+1. **Upload**. After obtaining and locally **testing** the new certificate in the above process,
+   upload it to Fastly management as new unused certificate.
+2. Enable for a **secondary service** at Fastly, such as "miscweb" (podcast.jquery.com) or "code2".
+3. **Verify**. In a browser of your choice, verify that when viewing a page on the secondary domain, that the browser is in fact using our new certificate. Check the expiry date to confirm this.
+4. **Test cross-browser**. Once you've confirmed that the new cert is deployed and used, it's time to test it across a wide range of browsers. Especially old browsers that don't support certain kinds of TLS versions or cipher suites. You can use BrowserStack to go through old Windows and IE versions until you encounter a failure. Then confirm that there are no old browsers that fail on the new certificate, unless that same browser also already fails to open https://releases.jquery.com. Confirm that the old/new domain are both browseable over plain HTTP without issue/redirect.
+5. **Wait 48 hours** before deploying the new cert to our primary services. This is to account for clockskew on real devices. Certificates will be considered invalid by browsers if their local system clock says the new certificate's begin date ("Not before") has not yet started. Learn more about why at https://phabricator.wikimedia.org/T196248.
+6. Enable the new cert for all services.
+7. **Delete your unencrypted** star.jquery.com.key file from your workstation.
+
+## Fastly docs
+
+https://docs.fastly.com/en/guides/setting-up-tls-with-your-own-certificates