README 1.2 KB

123456789101112131415161718192021222324252627282930
  1. The keyring/ directory contains some gpg keyring files that we use
  2. during the build to verify gpg signatures on downloaded files, or git
  3. tags. In order to be able to continue to use a git tag even after the
  4. key or sub-key that signed it expired (which is common when one is
  5. rotating sub-keys frequently), we configured gpg to ignore key expirations
  6. when verifying git tag signatures. However this also means that we should
  7. make sure that our keyring files do not contain expired keys or subkeys
  8. that are not supposed to be used anymore.
  9. This directory contains some scripts that can help clean the keyring
  10. files.
  11. The complete process for cleaning keyring files starts with:
  12. - Run `list-all-keyrings` to see if we include any expired key or sub-key.
  13. Then for each expired key or sub-key:
  14. - Check if the expiration is expected, and do nothing in that case.
  15. - Check if the owner of that key or sub-key extended it, and in that
  16. case add the updated key or sub-key.
  17. - If a key is not needed anymore (but other keys in the keyring are
  18. still needed), remove it with `gpg --delete-keys <key>`.
  19. - If a sub-key is not needed anymore, but the main key still contains
  20. at least one other valid sub-key, use `drop-expired-sub-keys` to
  21. remove the expired sub-key.