Table of contents

Renew a TLS certificate for GOV.UK

This document covers how to renew wildcard TLS certificates for *.publishing.service.gov.uk, *.staging.publishing.service.gov.uk and *.integration.publishing.service.gov.uk. It is a task performed by Reliability Engineering.

Credentials for the Fastly dashboard and Zendesk support sites are in the 2nd line password store.

  1. Log into Gandi using the credentials in the infra password store.
  2. Go to the account dashboard and find the list of TLS certificates on the account.
  3. Find the certificate you wish to renew and click Renew. You need to request a wildcard certificate (for example, *.publishing.service.gov.uk).
  4. Go through the steps on the renewal form until you reach a page requesting a Certificate Signing Request.
  5. Generate a Certificate Signing Request (CSR) for a renewal.
  6. Upload the CSR to Gandi by pasting the contents of the .csr file into the text box.
  7. Next, choose DNS validation to validate it and follow the instructions to add the relevant DNS records.
  8. Pay for it - we don’t have a stored payment method, so find the person with the GOV.UK credit card.
  9. Once the certificate has been renewed, paste the contents of the resulting .crt file into Puppet hiera data for the relevant environment in the govuk-secrets repository.
  10. Deploy Puppet to update the certificate in the relevant environment.
  11. For staging and integration only: Use Fastly’s TLS Uploader to upload the newly generated certificate and private key. You need to split the contents of the .crt file into the first certificate (the actual certificate you’ve just renewed) and everything else (the certificate chain) and upload these as separate files.
  12. For staging and integration only: Make a note of the reference ID returned by the TLS Uploader. Open a new ticket with Fastly support quoting the reference ID and the service ID for the Fastly service the certificate is for (such as for “Staging GOV.UK”) and asking them to make the certificate live. This process may take up to a week.
This page was last reviewed . It needs to be reviewed again by the page owner #govuk-2ndline.