Skip to content

Commit

Permalink
dkim_sign: improve single key signing instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
msimerson committed Aug 29, 2019
1 parent 241d8e7 commit 078c95a
Showing 1 changed file with 15 additions and 5 deletions.
20 changes: 15 additions & 5 deletions docs/plugins/dkim_sign.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,8 +70,7 @@ This plugin is configured in `dkim_sign.ini`.

## Single Domain Configuration

To sign all messages with a single DKIM key, these config settings
are required.
To sign all messages with a single DKIM key, you must set the selector and domain in dkim_sign.ini. You must also save your DKIM private key in the file `dkim.private.key` in the Haraka config directory.

- selector = name

Expand All @@ -85,7 +84,18 @@ are required.

<selector>._domainkey.<domain>

- dkim.private.key = filename
Test that your DKIM key is published properly with a DNS request like this:

Create a file `dkim.private.key` in the config folder with
your private key in it.
```sh
drill TXT $SELECTOR._domainkey.$DOMAIN
dig TXT $SELECTOR._domainkey.$DOMAIN +short
```

### Example DNS query

```sh
export SELECTOR=mar2013
export DOMAIN=simerson.net
$ dig TXT $SELECTOR._domainkey.$DOMAIN +short
"v=DKIM1;p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoyUzGOTSOmakY8BcxXgi0mN/nFegLBPs7aaGQUtjHfa8yUrt9T2j6GSXgdjLuG3R43WjePQv3RHzc+bwwOkdw0XDOXiztn5mhrlaflbVr5PMSTrv64/cpFQKLtgQx8Vgqp7Dh3jw13rLomRTqJFgMrMHdhIibZEa69gtuAfDqoeXo6QDSGk5JuBAeRHEH27FriHulg5ob" "4F4lmh7fMFVsDGkQEF6jaIVYqvRjDyyQed3R3aTJX3fpb3QrtRqvfn/LAf+3kzW58AjsERpsNCSTD2RquxbnyoR/1wdGKb8cUlD/EXvqtvpVnOzHeSeMEqex3kQI8HOGsEehWZlKd+GqwIDAQAB"
```

0 comments on commit 078c95a

Please sign in to comment.