Table of contents

Rotate offsite backup GPG keys

To encrypt our offsite backups, we use GPG keys which are valid for a year. For good security practice we rotate these keys each year.

Generate a new key

  1. Pull the govuk-secrets repo.
  2. cd puppet
  3. gpg2 --batch --gen-key gpg_templates/offsite_backup_gpg_template.txt
  4. Ensure you make a copy of the password you use.
  5. Get the key ID you just generated with gpg2 --list-keys --fingerprint, and make a copy of the full fingerprint ID.
  6. Copy the output of gpg2 --export-secret-key --armor <key id>
  7. Export the public key to a key server by submitting the output of gpg2 --export --armor <key id> to a public key server, for instance

What do I need to update?

The following files need to be updated with the new key details:

Update the govuk-puppet hieradata, updating the _: &offsite_gpg_key key with the new fingerprint value

Update the encrypted govuk-secrets repo hieradata, updating both backup::assets::backup_private_gpg_key and backup::assets::backup_private_gpg_key_passphrase with the relevant values.

This page is owned by #govuk-infrastructure and needs to be reviewed