nixos/tests/common/acme/server/README.md

   1 # Fake Certificate Authority for ACME testing
   2
   3 This will set up a test node running [pebble](https://github.com/letsencrypt/pebble)
   4 to serve ACME certificate requests.
   5
   6 ## "Snake oil" certs
   7
   8 The snake oil certs are hard coded into the repo for reasons explained [here](https://github.com/NixOS/nixpkgs/pull/91121#discussion_r505410235).
   9 The root of the issue is that Nix will hash the derivation based on the arguments
  10 to mkDerivation, not the output. [Minica](https://github.com/jsha/minica) will
  11 always generate a random certificate even if the arguments are unchanged. As a
  12 result, it's possible to end up in a situation where the cached and local
  13 generated certs mismatch and cause issues with testing.
  14
  15 To generate new certificates, run the following commands:
  16
  17 ```bash
  18 nix-build generate-certs.nix
  19 cp result/* .
  20 rm result
  21 ```