turscar/dkim2
Watch
1
0
Fork
You've already forked dkim2
 0
Code Issues Pull requests Projects Releases 5 Packages Wiki Activity Actions
DKIM2 library and tools
77 commits 1 branch 28 tags 910 KiB
  • Go 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Steve Atkins b5742089e4
All checks were successful
/ release (push) Successful in 9s
Details
Remove unused header parsing wrapper.
2026-09-14 18:33:21 +01:00
.forgejo/workflows Add test to workflow. 2026-09-05 13:04:59 +01:00
.github/workflows Convert remaining non-test panic()s, to error return. 2026-05-10 13:36:24 +01:00
internal/generate Add "one signature passes, one doesn't" case. 2026-09-11 16:13:31 +01:00
spec Update to spec-02, removing z= recipe and not hashing Authentication-Results headers. 2026-05-19 10:47:16 +01:00
testdata Update imported turscar/dkim2test tests, fixing whitespace. 2026-09-11 16:09:53 +01:00
tools/base64bytes Most everything works. 2026-05-05 12:21:11 +01:00
.gitattributes Most everything works. 2026-05-05 12:21:11 +01:00
.gitignore Update to spec-02, removing z= recipe and not hashing Authentication-Results headers. 2026-05-19 10:47:16 +01:00
.goreleaser.yaml Add ability to extract 2026-05-08 17:19:25 +01:00
base64.go Strip whitespace from base64 encoded values before decoding. Closes #5. 2026-09-08 12:56:32 +01:00
cf_python_test.go Remove error value from VerifyAll() response. 2026-09-09 16:39:25 +01:00
chain_test.go Tidy up error usage, removing embedded errors except when they come from third party code and may be useful for diagnostics. 2026-09-14 15:36:53 +01:00
chaos_test.go Update imported turscar/dkim2test tests, fixing whitespace. 2026-09-11 16:09:53 +01:00
dkim2signature.go Return better (?) errors in face of badly malformed Dkim2-Signature or Message-Instance headers. 2026-09-14 16:51:47 +01:00
dkim2signature_test.go Trivial changes. Removes a pointless error check and some test logging. 2026-09-11 16:14:59 +01:00
dns.go Replace KeyResolver interface with one that is implemented by [net.Resolver]. Removes non-stdlib DNS dependencies. Closes #3. 2026-09-05 16:03:45 +01:00
dns_test.go Really parallelize DNS live tests. 2026-09-08 12:55:26 +01:00
edit_message.go Add missing doc comments. 2026-09-05 12:27:39 +01:00
error_names.txt Return better (?) errors in face of badly malformed Dkim2-Signature or Message-Instance headers. 2026-09-14 16:51:47 +01:00
errors.go Removing unused or unneeded custom errors. 2026-09-14 18:02:04 +01:00
go.mod Pull CLI tools to their own repo. 2026-09-09 14:57:58 +01:00
go.sum Pull CLI tools to their own repo. 2026-09-09 14:57:58 +01:00
hash.go Add support for different hashes, including sha512. 2026-09-08 12:35:25 +01:00
hash_test.go Add result type ErrMessageInstanceSyntaxErrorTag, removing overly complex uses of ErrMessageInstanceSyntaxError. 2026-09-11 18:05:16 +01:00
header_order_test.go Test that we don't care about the order of Dkim2-Signature and Message-Instance headers. 2026-09-14 18:30:19 +01:00
headers.go Remove unused header parsing wrapper. 2026-09-14 18:33:21 +01:00
history.go Add missing doc comments. 2026-09-05 12:27:39 +01:00
LICENSE Initial commit 2025-11-03 09:58:44 +00:00
messageinstance.go Removing unused or unneeded custom errors. 2026-09-14 18:02:04 +01:00
messageinstance_test.go Most everything works. 2026-05-05 12:21:11 +01:00
NOTES.md Most everything works. 2026-05-05 12:21:11 +01:00
README.md Pull CLI tools to their own repo. 2026-09-09 14:57:58 +01:00
recipe.go Add missing doc comments. 2026-09-05 12:27:39 +01:00
recipe_body_test.go Added goreleaser and version flag. Updated some dependencies. Fixed some warnings. 2026-05-07 12:27:02 +01:00
recipe_diff.go Add missing doc comments. 2026-09-05 12:27:39 +01:00
recipe_header_test.go Most everything works. 2026-05-05 12:21:11 +01:00
recipe_headerdiff_test.go Add generated chaos tests, remove old tests. 2026-06-23 09:06:38 +01:00
recipes.schema.json Most everything works. 2026-05-05 12:21:11 +01:00
roundtrip_test.go Add "one signature passes, one doesn't" case. 2026-09-11 16:13:31 +01:00
sign.go Add remaining errors in draft-06. 2026-09-09 13:48:44 +01:00
sign_test.go Add remaining errors in draft-06. 2026-09-09 13:48:44 +01:00
signature_tags_test.go Add nd= and chain of custody checks. 2026-09-07 09:42:02 +01:00
tag.go Return better (?) errors in face of badly malformed Dkim2-Signature or Message-Instance headers. 2026-09-14 16:51:47 +01:00
testhelpers_test.go Add nd= and chain of custody checks. 2026-09-07 09:42:02 +01:00
time.go Most everything works. 2026-05-05 12:21:11 +01:00
verify.go Check whether donotmodify and donotexplode requests were honored. 2026-09-14 17:21:07 +01:00
verify_errors.go Return better (?) errors in face of badly malformed Dkim2-Signature or Message-Instance headers. 2026-09-14 16:51:47 +01:00
verify_test.go Trivial changes. Removes a pointless error check and some test logging. 2026-09-11 16:14:59 +01:00
version.go Update to draft-06; update README. 2026-09-09 14:06:27 +01:00

README.md

dkim2

DKIM2 library and tools

Go Reference

This library implements signing and validation of DKIM2 signed email, as specified by draft-ietf-dkim-dkim2-spec-06.

CLI tools

CLI tools using this library can be found at https://forge.turscar.ie/turscar/dkim2utils

Status

The library generates and parse messages correctly, tests are passing, and sees

Missing

Message-instance recipes that return a "we can't reconstruct this" result aren't returned to the caller in any useful way. I'm waiting to see how the requirements change there before firming up the API.