citadel/tests/dkimtester/README.md

   1 # dkimtester
   2
   3 This is a test harness for Citadel's DKIM signing code.  It is not likely
   4 that you will use this program unless you're hacking on the DKIM signer
   5 itself.  The private key embedded in the test program matches the DKIM record
   6 for `dev.citadel.org` at the time this is being written.  That record looks
   7 like this:
   8
   9 ```
  10 foo._domainkey.dev.citadel.org IN TXT "v=DKIM1;k=rsa;p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA37nn3HqaJEa56Ukg7MbvkA6ng/Bi/UJ2c/zeiMU3Qb+lnNdBMQXtiI0uXSiOwL4UkhCtMxhPB5KZsHnHG4nqUKnrnrXlswDGdbk+N2w95O3snu71qG4jj/ULaGBkerBtuYdluU23PdVuH3b2J8WFSY8fMCFRdH96Nub/q0LnqKNB5bxsgPf8YvRgGiS9OTpitcZzCYEr1v0PEM6u2qX9Q+lz1x7ob+bXrxJZGeY5bzNsNHE1cgMzK1IekZHJ/cTOPzT1mIIQXN4zuE6z50q6G0Bq19H3IsxPxTeiNIp9CnvGfoDDPDXhXLI7y2XvTKWPYtKcP8oCyIebdzuKqcAtSQIDAQAB"
  11 ```
  12 If you intend to work with this program, that key will be long gone by the
  13 time you read this, and *you* don't control `dev.citadel.org` anyway, so you
  14 will have to create your own host name and set your own DKIM record.  You can
  15 use this private key if you want to, though.
  16
  17 To run this test, you also must have the `Mail::DKIM::Verifier` perl module
  18 installed, which can be found on CPAN.
  19
  20 Again -- this is not intended to be part of a regression test suite.